BAB 3: Setup Lingkungan Pengembangan
Menyiapkan Node, Java, Android Studio, dan Xcode, membuat proyek Expo, lalu menjalankannya di emulator dan perangkat nyata, termasuk membaca error yang paling sering muncul.
Bab ini mengubah lingkungan kosong menjadi proyek yang bisa dijalankan. Ada 4 hal yang harus siap sebelum kode pertama bisa dilihat di layar: runtime JavaScript, alat build native, perangkat tujuan, dan editor.
Urutan pemasangannya penting. Memasang Android Studio sebelum Java, atau menjalankan proyek sebelum Metro bundler siap, adalah 2 penyebab kegagalan paling sering pada hari pertama.
2 jalur: Expo atau React Native CLI
Ada 2 cara memulai proyek React Native, dan keputusan ini memengaruhi sisa ebook.
| Hal | Expo | React Native CLI |
|---|---|---|
| Waktu setup | menit | jam, tergantung toolchain native |
| Folder native | dibuat saat dibutuhkan | ada sejak awal |
| Perangkat uji | aplikasi Expo Go atau development build | build sendiri ke perangkat |
| Modul native khusus | lewat config plugin atau development build | langsung di android dan ios |
| Build produksi | EAS Build, tanpa mesin macOS untuk iOS | butuh Xcode, artinya butuh macOS |
| Cocok untuk | proyek baru, tim kecil, pembelajaran | integrasi dengan aplikasi native yang sudah ada |
Ebook ini memakai Expo. Alasannya bukan karena Expo lebih unggul secara umum, tapi karena hambatan masuknya rendah untuk pembaca yang baru mulai. Ketika proyek membutuhkan modul native di luar dukungan Expo, jalur keluarnya tersedia dan dibahas di Bab 13.
Prasyarat
4 alat wajib, 1 opsional, dan 1 hanya untuk macOS.
| Alat | Versi yang dipakai | Wajib |
|---|---|---|
| Node.js | 20 LTS atau 22 LTS | ya |
| npm atau pnpm | npm 10 ke atas | ya |
| Git | versi terbaru | ya |
| Java JDK | 17 | ya, untuk build Android |
| Android Studio | versi stabil terbaru | ya, untuk emulator Android |
| Xcode | 16 ke atas | hanya macOS, untuk iOS |
| Watchman | versi terbaru | disarankan di macOS dan Linux |
JDK 17 bukan pilihan bebas. Versi Android Gradle Plugin yang dipakai React Native 0.83 tidak berjalan dengan JDK 11 atau JDK 21 tanpa penyesuaian, dan pesan errornya tidak selalu menyebut versi.
Periksa semuanya lebih dulu:
node --version # v20.x atau v22.x
npm --version # 10.x atau lebih
java -version # openjdk 17
git --version
npx expo --version # hanya jika Expo sudah pernah dipasang global
Kalau java -version menunjukkan versi lain, pasang JDK 17 dan arahkan JAVA_HOME ke folder itu. Di macOS dengan beberapa JDK, perintah /usr/libexec/java_home -v 17 membantu menemukan lokasinya.
Membuat proyek
Satu perintah membuat proyek baru dengan TypeScript, Expo Router, dan konfigurasi bawaan yang sudah benar:
npx create-expo-app@latest catatan-harian
cd catatan-harian
Nama proyek sebaiknya huruf kecil dengan tanda hubung, karena nama itu dipakai sebagai nama paket dan folder. Setelah selesai, jalankan:
npx expo start
Metro bundler akan berjalan di port 8081 dan menampilkan pilihan: tekan a untuk Android, i untuk iOS di macOS, atau pindai kode QR dengan aplikasi Expo Go di perangkat.
Menyiapkan emulator Android
Emulator adalah pilihan pertama untuk pengembangan sehari-hari karena cepat diulang dan tidak menguras baterai perangkat.
- Pasang Android Studio, lalu buka SDK Manager.
- Pada tab SDK Platforms, pilih Android 15 atau versi API terbaru yang stabil.
- Pada tab SDK Tools, pastikan Android SDK Build-Tools, Android SDK Platform-Tools, dan Android Emulator terpasang.
- Buka Device Manager, pilih Create Virtual Device, lalu ambil profil Pixel dengan sistem Android terbaru.
- Jalankan emulator sebelum
npx expo start, atau tekanasetelah Metro berjalan.
Untuk memastikan perangkat terdeteksi:
adb devices
# List of devices attached
# emulator-5554 device
Kalau adb tidak dikenali, tambahkan $ANDROID_HOME/platform-tools ke PATH. Di macOS, folder umumnya ~/Library/Android/sdk. Di Linux, biasanya ~/Android/Sdk.
Menjalankan di perangkat fisik
Emulator tidak mewakili performa sebenarnya. Uji di perangkat fisik sebelum menyimpulkan aplikasi berjalan lancar.
Android. Aktifkan Opsi Pengembang, nyalakan USB debugging, sambungkan kabel, lalu izinkan komputer saat dialog muncul. Perintah adb devices harus menampilkan nomor perangkat, bukan unauthorized.
iPhone. Untuk build langsung di perangkat dibutuhkan akun Apple Developer dan Xcode. Untuk mencoba cepat, aplikasi Expo Go dari App Store sudah cukup, dengan batasan hanya menjalankan JavaScript dan modul yang didukung Expo Go.
Ada satu jebakan di sini: Expo Go mengikuti versi SDK. Kalau proyek memakai SDK yang lebih baru dari aplikasi Expo Go di perangkat, proyek tidak akan terbuka. Solusinya membuat development build:
npx expo run:android
npx expo run:ios
Perintah itu membuat folder android dan ios di proyek, lalu memasang aplikasi sendiri di perangkat. Setelah itu, perubahan kode tetap dimuat ulang lewat Metro tanpa build ulang.
Variabel lingkungan
Kunci API dan alamat server tidak boleh ditulis langsung di kode. Expo membaca variabel dari berkas .env, dan hanya variabel berawalan EXPO_PUBLIC_ yang boleh dipakai di sisi aplikasi.
# .env
EXPO_PUBLIC_API_URL=https://api.contoh.com
const alamat = process.env.EXPO_PUBLIC_API_URL;
if (!alamat) {
throw new Error("EXPO_PUBLIC_API_URL belum diisi di .env");
}
Aturan yang perlu diingat: variabel EXPO_PUBLIC_ ikut masuk ke bundel aplikasi, sehingga siapa pun yang membongkar APK bisa membacanya. Kunci rahasia, seperti kunci server atau kunci pembayaran, tidak boleh diletakkan di sana.
Editor dan alat bantu
Visual Studio Code dengan tambahan berikut sudah cukup untuk seluruh ebook ini:
| Ekstensi | Fungsi |
|---|---|
| ESLint | menandai kesalahan pola kode sebelum dijalankan |
| Prettier | merapikan format berkas |
| React Native Tools | menjalankan debugger dan perintah React Native |
| TypeScript Importer | menyisipkan import secara otomatis |
Alias import memperpendek jalur relatif yang panjang:
{
"compilerOptions": {
"strict": true,
"baseUrl": ".",
"paths": {
"@/*": ["./*"]
}
}
}
Dengan begitu import { Tombol } from "@/components/Tombol" bisa dipakai dari folder mana pun, tanpa ../../../.
Membaca error yang muncul
4 error berikut menangani sebagian besar kegagalan hari pertama.
| Pesan | Penyebab | Tindakan |
|---|---|---|
Unable to resolve module ... | jalur salah, paket belum terpasang, atau cache Metro basi | periksa jalur, jalankan npm install, lalu npx expo start -c |
Port 8081 is being used | Metro lain masih hidup, atau proses lama belum mati | hentikan proses lama, atau jalankan npx expo start --port 8082 |
Unsupported class file major version | JDK tidak sesuai | pasang JDK 17 dan arahkan JAVA_HOME |
Failed to install the app | perangkat penuh, tanda tangan build lama, atau kabel bermasalah | hapus aplikasi dari perangkat, coba kabel lain, jalankan npx expo run:android --no-build-cache |
Satu kebiasaan yang menghemat waktu: baca pesan error dari baris paling atas, bukan yang paling bawah. Baris teratas biasanya menyebut berkas dan nomor baris yang menjadi sumber masalah, sedangkan bagian bawah hanya kumpulan jejak pemanggilan.
Untuk cache yang mencurigakan, 2 perintah ini menyelesaikan banyak hal aneh:
npx expo start -c # bersihkan cache Metro
cd android && ./gradlew clean # bersihkan hasil build Android
Checklist sebelum mulai menulis kode
node --versionmenunjukkan versi LTS.java -versionmenunjukkan JDK 17.adb devicesmenampilkan perangkat atau emulator.npx expo startmenampilkan kode QR tanpa error.- Aplikasi terbuka di perangkat dan menampilkan layar bawaan.
- Berkas
.envada dan berisi variabel yang dibutuhkan.
Kalau satu nomor belum terpenuhi, selesaikan dulu. Melanjutkan dengan lingkungan yang setengah siap akan membuat error berikutnya sulit dibedakan antara salah kode dan salah setup.
Latihan singkat
- Jalankan proyek di emulator Android dan di Expo Go pada perangkat fisik. Catat perbedaan waktu muat pertama.
- Ubah teks di layar bawaan, simpan, dan perhatikan apakah Metro memuat ulang otomatis atau perlu refresh manual.
- Hentikan Metro saat aplikasi masih terbuka, lalu ubah satu berkas dan jalankan ulang. Perhatikan pesan yang muncul.
Ringkasan
Lingkungan React Native terdiri dari Node sebagai runtime, JDK dan Android Studio untuk build Android, Xcode untuk iOS, dan Metro sebagai bundler. Expo menyederhanakan semuanya menjadi 2 perintah, dengan jalur keluar ke build native saat dibutuhkan.
Bab berikutnya memakai lingkungan ini untuk membangun aplikasi pertama: layar daftar catatan dengan formulir tambah, penyimpanan lokal, dan navigasi dasar.