Untuk mengaktifkan mode developer di Android, buka Pengaturan > Tentang ponsel dan ketuk Nomor build tujuh kali, lalu masukkan PIN Anda. Menu Opsi pengembang akan muncul, di mana Anda bisa mengaktifkan debugging USB atau debugging nirkabel agar Android Studio adb atau bunx cap run android bisa menginstal dan men-debug aplikasi Anda. Letak persis Nomor build bergantung pada pabrikan, jadi langkah untuk setiap merek ada di bawah.
Apa yang dilakukan opsi pengembang (dan yang tidak)
Developer options adalah menu pengaturan tersembunyi untuk pengembang aplikasi. Mengaktifkannya tidak akan mengubah apa pun secara langsung. Menu ini hanya menampilkan opsi seperti:
- debugging USB: mengizinkan komputer tepercaya menjalankan
adbperintah, menginstal build, dan membaca logs. - debugging nirkabel: melakukan hal yang sama via Wi-Fi (Android 11+).
- Tetap aktif: layar tetap menyala saat diisi daya, sangat berguna saat testing.
- Skala animasi: mempercepat atau mematikan animasi sistem, berguna untuk UI tests.
- Jangan simpan aktivitas: menghancurkan activity saat Anda meninggalkannya, cara yang bagus untuk menguji restorasi state pada aplikasi Capacitor.
- Tampilkan ketukan / Lokasi pointer: berguna untuk merekam demo dan mengecek touch target.
Anda tidak perlu developer options untuk menginstal APK dari browser atau file manager, untuk menggunakan sebagian besar aplikasi, atau untuk menerima update over-the-air.
Cara mengaktifkan developer options per merek
| Merek | Di mana ketuk 7 kali | Di mana menu muncul setelahnya |
|---|---|---|
| Google Pixel / Android murni | Setelan > Tentang ponsel > Nomor build | Pengaturan > Sistem > Opsi pengembang |
| Samsung (One UI) | Pengaturan > Tentang ponsel > Informasi perangkat lunak > Nomor build | Pengaturan > Opsi pengembang (di bagian bawah daftar) |
| Xiaomi, Redmi, POCO (HyperOS) | Setelan > Tentang ponsel > Versi OS | Pengaturan > Setelan tambahan > Opsi pengembang |
| Xiaomi (MIUI lama) | Setelan > Tentang ponsel > Versi MIUI | Pengaturan > Pengaturan tambahan > Opsi pengembang |
| OnePlus (OxygenOS) | Pengaturan > Tentang perangkat > Versi > Nomor build | Pengaturan > Pengaturan sistem > Opsi pengembang |
| OPPO / realme (ColorOS / realme UI) | Pengaturan > Tentang perangkat > Versi > Nomor build | Pengaturan > Pengaturan tambahan > Opsi pengembang |
| Motorola | Setelan > Tentang ponsel > Nomor build | Pengaturan > Sistem > Opsi pengembang |
| Huawei / Honor (EMUI / MagicOS) | Setelan > Tentang ponsel > Nomor build | Pengaturan > Sistem & pembaruan > Opsi pengembang |
Menu bisa berbeda tiap versi OS. Jika tidak menemukan Nomor build, buka Pengaturan dan gunakan kolom pencarian: ketik “build number”. Di hampir semua perangkat Android, pencarian akan langsung menemukannya.
Google Pixel (Android 14, 15, 16)
- Buka Pengaturan dan scroll ke Tentang ponsel.
- Scroll ke bawah dan ketuk Nomor build tujuh kali. Setelah beberapa ketukan, toast hitung mundur akan muncul.
- Masukkan PIN, pola, atau kata sandi Anda.
- Kembali ke Setelan > Sistem > Opsi pengembang.
Samsung Galaxy
- Buka Setelan > Tentang ponsel > Informasi perangkat lunak.
- Ketuk Nomor build tujuh kali dan konfirmasi dengan PIN Anda.
- Opsi pengembang sekarang muncul di bagian paling bawah daftar Setelan utama, di bawah Tentang ponsel.
Xiaomi, Redmi, dan POCO
- Buka Setelan > Tentang ponsel.
- Ketuk Versi OS (HyperOS) atau Versi MIUI (perangkat lama) sebanyak tujuh kali.
- Buka Setelan > Setelan tambahan > Opsi pengembang.
Xiaomi menambahkan dua switch tambahan yang biasanya Anda butuhkan untuk development: Instal via USB dan USB debugging (Pengaturan keamanan). Tanpa “Instal via USB”, adb install gagal dengan INSTALL_FAILED_USER_RESTRICTED. Mengaktifkan ini mungkin memerlukan login ke akun Xiaomi dan pemasangan kartu SIM.
OnePlus, OPPO dan realme
- Buka Pengaturan > Tentang perangkat > Versi.
- Ketuk Nomor build tujuh kali.
- Buka Pengaturan > Pengaturan sistem > Opsi pengembang (OnePlus) atau Setelan > Setelan tambahan > Opsi pengembang (OPPO, realme).
Huawei dan Honor
- Buka Setelan > Tentang ponsel.
- Ketuk Nomor build tujuh kali.
- Buka Pengaturan > Sistem & pembaruan > Opsi pengembang.
Pada perangkat Huawei, atur juga mode koneksi USB ke Transfer file saat dicolokkan, jika tidak, adb mungkin tidak mendeteksi perangkat. Jika Anda berencana merilis ke ponsel ini, baca cara memublikasikan aplikasi Capacitor di Huawei AppGallery, karena banyak di antaranya tidak memiliki layanan Google Play.
Profil kerja dan perangkat terkelola
Jika perusahaan Anda mengelola ponsel tersebut, admin dapat memblokir opsi pengembang. Anda akan melihat pesan “Opsi pengembang tidak tersedia untuk pengguna ini”. Mintalah perangkat uji ke tim IT daripada mencoba mengakali kebijakan tersebut.
Aktifkan debugging USB
- Buka Opsi pengembang dan aktifkan debugging USB.
- Hubungkan ponsel dengan kabel USB yang mendukung transfer data (banyak kabel murah hanya untuk pengisian daya).
- Pada ponsel, terima dialog Izinkan USB debugging? dialog. Centang Selalu izinkan dari komputer ini pada perangkat Anda.
- Di komputer, cek koneksinya:
adb devices
Anda seharusnya melihat:
List of devices attached
R5CT1234ABC device
unauthorized berarti Anda tidak menyetujui prompt tersebut. offline biasanya berarti kabel atau port bermasalah, atau adb server dari SDK lama.
adb sudah termasuk Android SDK Platform-Tools. Jika Android Studio terinstal, lokasinya ada di ~/Library/Android/sdk/platform-tools di macOS atau %LOCALAPPDATA%\Android\Sdk\platform-tools di Windows. Tambahkan folder tersebut ke PATH. New to the Android toolchain? Our setup Android untuk aplikasi Capacitor akan membahasnya.
Aktifkan wireless debugging (Android 11 ke atas)
Wireless debugging menghilangkan kebutuhan kabel. Komputer dan ponsel harus berada di jaringan Wi-Fi yang sama, dan beberapa jaringan kantor atau hotel memblokir trafik antar perangkat.
- Di Opsi pengembang, aktifkan debugging nirkabel dan terima prompt jaringan.
- Ketuk debugging nirkabel untuk membukanya, lalu Pasangkan perangkat dengan pairing code. Biarkan layar ini tetap terbuka.
- Di komputer, lakukan pairing menggunakan alamat IP dan port yang muncul di dialog pairing:
adb pair 192.168.1.42:37145
# Enter pairing code: 482913
- Hubungkan menggunakan IP dan port yang tertera di layar utama Wireless debugging (port yang berbeda dari port pairing):
adb connect 192.168.1.42:41827
adb devices
Android Studio juga punya fitur Pair perangkat via Wi-Fi di device manager, yang menampilkan QR code untuk Anda scan dari layar Wireless debugging.
Port akan berubah setiap kali wireless debugging dimulai ulang, jadi Anda harus mengulang adb connect setelah reboot. Proses pairing akan tetap tersimpan.
Pada Android 10 ke bawah, gunakan metode lama: hubungkan sekali via USB, jalankan adb tcpip 5555, cabut, lalu adb connect <phone-ip>:5555.
Jalankan aplikasi Capacitor Anda di perangkat
Dengan perangkat yang terdaftar di adb devices, Capacitor CLI dapat melakukan build dan install secara langsung:
bun run build
bunx cap sync android
bunx cap run android --list # show connected devices and emulators
bunx cap run android --target R5CT1234ABC
Untuk loop yang lebih cepat, gunakan live reload agar aplikasi memuat dev server Anda melalui jaringan:
bunx cap run android -l --external
Ponsel harus bisa mengakses IP mesin Anda agar ini berhasil. Jika ingin tester di luar jaringan melihat perubahan tanpa install ulang, coba live updates Capgo sebagai pengganti dev server.
Untuk membaca native logs saat aplikasi berjalan:
adb logcat | grep -i -E "capacitor|chromium"
Dan untuk debug WebView, buka chrome://inspect di Chrome desktop saat debug build sedang berjalan. Debug build dari aplikasi Capacitor sudah mengaktifkan debugging WebView secara default.
Troubleshooting
Mengetuk nomor Build tidak bereaksi. Anda mungkin mengetuk field yang salah (misalnya Android version, bukan Build number), atau perangkat dikelola oleh organisasi. Beberapa perangkat Xiaomi mengharuskan Anda mengetuk OS version, bukan Build number.
Perangkat tidak muncul di adb devices.
adb kill-server
adb start-server
adb devices
Coba gunakan kabel lain dan colokkan langsung ke port komputer, jangan melalui hub. Ubah notifikasi mode USB ke Transfer file.
Windows tidak mendeteksi ponsel. Instal driver USB OEM (Samsung, Xiaomi, dan lainnya merilis driver sendiri) atau Google USB Driver dari SDK Manager untuk perangkat Pixel.
INSTALL_FAILED_UPDATE_INCOMPATIBLE. Aplikasi yang terinstal ditandatangani dengan key yang berbeda (misalnya build Play Store vs build debug Anda). Uninstall terlebih dahulu: adb uninstall com.example.app.
INSTALL_FAILED_USER_RESTRICTED di Xiaomi. Aktifkan Instal via USB di Developer options.
Wireless debugging sering mati sendiri. Android mematikannya saat Anda ganti jaringan Wi-Fi. Beberapa penghemat baterai juga bisa mematikannya. Pastikan ponsel tetap di jaringan yang sama dan sedang diisi daya saat sesi panjang.
Unauthorized setelah update Android Studio. adb key di ~/.android/adbkey berubah. Di Developer options, ketuk Cabut otorisasi debugging USB, hubungkan kembali dan terima prompt lagi.
Cara mematikan developer options
- Buka Opsi pengembang.
- Geser Gunakan opsi pengembang (atau Opsi pengembang pada Samsung) di bagian atas ke posisi off.
Menu tetap terlihat di beberapa perangkat, tetapi semua switch di dalamnya akan reset ke default. Untuk menyembunyikan menu sepenuhnya, buka Pengaturan > Aplikasi > Pengaturan > Penyimpanan dan hapus storage untuk aplikasi Settings. Ini juga akan mereset preferensi pengaturan lainnya, jadi jarang disarankan.
Sebelum memberikan ponsel uji ke orang lain, ketuk juga Cabut otorisasi debugging USB agar komputer lama tidak bisa terhubung lagi.
Catatan keamanan
- USB debugging memungkinkan komputer yang diotorisasi menginstal aplikasi dan membaca data aplikasi dari build yang dapat di-debug. Jangan setujui prompt RSA di stasiun pengisian daya umum atau komputer yang tidak Anda percayai.
- Beberapa aplikasi perbankan dan pembayaran menolak berjalan saat developer options atau USB debugging aktif. Matikan keduanya di ponsel pribadi Anda setelah selesai.
- Jangan pernah merilis release build dengan
android:debuggable="true". Capacitor release builds secara default tidak dapat di-debug.
Padanan untuk iOS
iPhone punya cara tersendiri Mode Pengembang switch sendiri yang perlu diaktifkan sebelum menjalankan build development atau ad hoc. Lihat cara mengaktifkan Developer Mode di iOS. Untuk memasang build ke ponsel tester tanpa kabel, baca cara mendistribusikan aplikasi iOS dan Android ke tester.