Fondasi

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.

HalExpoReact Native CLI
Waktu setupmenitjam, tergantung toolchain native
Folder nativedibuat saat dibutuhkanada sejak awal
Perangkat ujiaplikasi Expo Go atau development buildbuild sendiri ke perangkat
Modul native khususlewat config plugin atau development buildlangsung di android dan ios
Build produksiEAS Build, tanpa mesin macOS untuk iOSbutuh Xcode, artinya butuh macOS
Cocok untukproyek baru, tim kecil, pembelajaranintegrasi 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.

AlatVersi yang dipakaiWajib
Node.js20 LTS atau 22 LTSya
npm atau pnpmnpm 10 ke atasya
Gitversi terbaruya
Java JDK17ya, untuk build Android
Android Studioversi stabil terbaruya, untuk emulator Android
Xcode16 ke atashanya macOS, untuk iOS
Watchmanversi terbarudisarankan 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:

BashBASH
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:

BashBASH
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:

BashBASH
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.

  1. Pasang Android Studio, lalu buka SDK Manager.
  2. Pada tab SDK Platforms, pilih Android 15 atau versi API terbaru yang stabil.
  3. Pada tab SDK Tools, pastikan Android SDK Build-Tools, Android SDK Platform-Tools, dan Android Emulator terpasang.
  4. Buka Device Manager, pilih Create Virtual Device, lalu ambil profil Pixel dengan sistem Android terbaru.
  5. Jalankan emulator sebelum npx expo start, atau tekan a setelah Metro berjalan.

Untuk memastikan perangkat terdeteksi:

BashBASH
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:

BashBASH
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.

BashBASH
# .env
EXPO_PUBLIC_API_URL=https://api.contoh.com
TypeScriptTS
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:

EkstensiFungsi
ESLintmenandai kesalahan pola kode sebelum dijalankan
Prettiermerapikan format berkas
React Native Toolsmenjalankan debugger dan perintah React Native
TypeScript Importermenyisipkan import secara otomatis

Alias import memperpendek jalur relatif yang panjang:

{}JSON
{
  "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.

PesanPenyebabTindakan
Unable to resolve module ...jalur salah, paket belum terpasang, atau cache Metro basiperiksa jalur, jalankan npm install, lalu npx expo start -c
Port 8081 is being usedMetro lain masih hidup, atau proses lama belum matihentikan proses lama, atau jalankan npx expo start --port 8082
Unsupported class file major versionJDK tidak sesuaipasang JDK 17 dan arahkan JAVA_HOME
Failed to install the appperangkat penuh, tanda tangan build lama, atau kabel bermasalahhapus 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:

BashBASH
npx expo start -c            # bersihkan cache Metro
cd android && ./gradlew clean   # bersihkan hasil build Android

Checklist sebelum mulai menulis kode

  1. node --version menunjukkan versi LTS.
  2. java -version menunjukkan JDK 17.
  3. adb devices menampilkan perangkat atau emulator.
  4. npx expo start menampilkan kode QR tanpa error.
  5. Aplikasi terbuka di perangkat dan menampilkan layar bawaan.
  6. Berkas .env ada 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

  1. Jalankan proyek di emulator Android dan di Expo Go pada perangkat fisik. Catat perbedaan waktu muat pertama.
  2. Ubah teks di layar bawaan, simpan, dan perhatikan apakah Metro memuat ulang otomatis atau perlu refresh manual.
  3. 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.