Menjalankan aplikasi di perangkat hardware

Ketika membuat aplikasi Android, Anda harus menguji aplikasi tersebut pada perangkat sebenarnya sebelum merilisnya ke pengguna. Halaman ini menjelaskan cara menyiapkan lingkungan pengembangan dan perangkat Android untuk menjalankan pengujian dan proses debug melalui koneksi Android Debug Bridge (ADB).

Menyiapkan perangkat untuk pengembangan

Sebelum dapat memulai proses debug di perangkat, tentukan apakah Anda ingin terhubung ke perangkat menggunakan kabel USB atau Wi-Fi. Lalu, lakukan langkah berikut:

  1. Di perangkat, buka aplikasi Setelan, pilih Opsi developer, lalu aktifkan Proses debug USB (jika ada).

  2. Siapkan sistem agar mendeteksi perangkat Anda.

    • Chrome OS: Konfigurasi tambahan tidak diperlukan.
    • macOS: Konfigurasi tambahan tidak diperlukan.
    • Ubuntu Linux: Ada dua hal yang harus disiapkan dengan benar: setiap pengguna yang ingin menggunakan adb harus termasuk dalam grup plugdev, dan sistem harus menginstal aturan udev yang mencakup perangkat.

      grup plugdev: Jika melihat pesan error yang menyatakan bahwa Anda tidak termasuk dalam grup plugdev, Anda harus menambahkan diri ke grup plugdev:

      sudo usermod -aG plugdev $LOGNAME
      

      Perlu diketahui bahwa grup hanya diupdate saat login, sehingga Anda harus logout agar perubahan ini diterapkan. Saat login kembali, Anda dapat menggunakan id untuk memeriksa apakah Anda kini termasuk dalam grup plugdev.

      aturan udev: Paket android-sdk-platform-tools-common berisi kumpulan aturan udev default yang dikelola komunitas untuk perangkat Android. Untuk menginstal:

      apt-get install android-sdk-platform-tools-common
      
    • Windows: Instal driver USB untuk ADB (jika ada). Untuk panduan penginstalan dan link ke driver OEM, lihat dokumen Menginstal driver USB OEM.

Menghubungkan ke perangkat menggunakan USB

Setelah perangkat Anda siap dan terhubung melalui USB, klik Run pada Android Studio untuk membuat dan menjalankan aplikasi Anda di perangkat.

Anda juga dapat menggunakan adb untuk menjalankan perintah, sebagai berikut:

  • Pastikan bahwa perangkat Anda terhubung dengan menjalankan perintah adb devices dari direktori android_sdk/platform-tools/ Anda. Jika sudah terhubung, perangkat Anda akan tercantum pada daftar.
  • Jalankan perintah adb dengan flag -d untuk menargetkan perangkat Anda.

Menghubungkan ke perangkat menggunakan Wi-Fi

Android 11 (dan yang lebih baru) mendukung deployment dan proses debug aplikasi secara nirkabel dari komputer melalui Android Debug Bridge (adb). Misalnya, Anda dapat men-deploy aplikasi yang dapat di-debug ke beberapa perangkat jarak jauh, tanpa harus menghubungkan perangkat secara langsung melalui USB dan mengalami masalah koneksi USB umum, seperti penginstalan driver.

Untuk menggunakan proses debug nirkabel, Anda harus menghubungkan perangkat ke workstation menggunakan kode penghubung. Untuk memulai, selesaikan langkah-langkah berikut:

  1. Pastikan workstation dan perangkat Anda terhubung ke jaringan nirkabel yang sama.
  2. Pastikan perangkat Anda menjalankan Android 11 atau lebih baru. Untuk mengetahui informasi selengkapnya, lihat Memeriksa & mengupdate versi Android.
  3. Pastikan Anda memiliki Android Studio Bumblebee Canary. Anda dapat mendownloadnya di sini
  4. Di workstation Anda, update SDK Platform-Tools ke versi terbaru.

Untuk menghubungkan perangkat, ikuti langkah-langkah berikut:

  1. Buka Android Studio, lalu pilih Sambungkan Perangkat Menggunakan Wi-Fi dari menu dropdown jalankan konfigurasi.
    Menu dropdown jalankan konfigurasi
    Gambar 1. Menu dropdown jalankan konfigurasi.

    Jendela Sambungkan perangkat melalui Wi-Fi akan muncul, seperti yang ditunjukkan di bawah.
    Screenshot jendela pop-up perangkat yang disambungkan melalui Wi-Fi
    Gambar 2. Jendela pop-up untuk menyambungkan perangkat menggunakan kode QR atau kode penghubung.
  2. Aktifkan opsi developer di perangkat.
  3. Aktifkan proses debug melalui Wi-Fi di perangkat.
    Screenshot
      ponsel piksel yang menampilkan setelan sistem Proses debug nirkabel.
    Gambar 3. Screenshot setelan Proses debug nirkabel di ponsel Google Pixel.
  4. Ketuk Proses debug nirkabel, lalu sambungkan perangkat Anda:
    1. Untuk menyambungkan perangkat dengan kode QR, pilih Sambungkan perangkat dengan kode QR dan pindai kode QR yang diperoleh.
    2. Untuk menyambungkan perangkat dengan kode penghubung, pilih Sambungkan perangkat dengan kode penghubung dari jendela Sambungkan perangkat melalui Wi-Fi di atas. Di perangkat, pilih Sambungkan menggunakan kode penghubung dan catat kode pin enam digit. Setelah perangkat muncul di jendela Sambungkan perangkat melalui Wi-Fi, Anda dapat memilih Sambungkan dan masukkan kode pin enam digit yang ditampilkan di perangkat.
      Screenshot contoh entri kode pin
      Gambar 4. Contoh entri kode pin enam digit.
  5. Setelah disambungkan, Anda dapat mencoba men-deploy aplikasi ke perangkat.

    Untuk menyambungkan perangkat lain atau melupakan perangkat ini di workstation Anda, buka Wireless debugging di perangkat, ketuk nama workstation di bagian Paired devices, lalu pilih Forget.

Memecahkan masalah koneksi perangkat

Jika perangkat tidak terhubung ke Android Studio, coba langkah berikut untuk mengatasi masalah ini.

Memecahkan masalah dengan Connection Assistant

Connection Assistant menyediakan petunjuk langkah demi langkah untuk membantu Anda menyiapkan dan menggunakan perangkat melalui koneksi ADB.

Untuk memulai asisten ini, pilih Tools > Troubleshoot Device Connections.

Connection Assistant menyediakan petunjuk, kontrol sesuai konteks, dan daftar perangkat yang terhubung dalam serangkaian halaman di panel Assistant. Gunakan tombol Next dan Previous di bagian bawah panel Assistant untuk mengerjakan halaman yang diperlukan:

  • Hubungkan perangkat Anda melalui USB: Connection Assistant memulai dengan meminta Anda menghubungkan perangkat melalui USB, dan menyediakan tombol Rescan USB devices untuk memulai pemindaian baru dan menemukan perangkat yang terhubung.
  • Aktifkan proses debug USB: Selanjutnya, Connection Assistant memberi tahu Anda cara mengaktifkan proses debug USB pada opsi developer di perangkat.
  • Mulai ulang server ADB: Terakhir, jika perangkat Anda tetap tidak tercantum pada daftar perangkat yang tersedia, Anda dapat menggunakan tombol Restart ADB server di halaman terakhir Connection Assistant. Memulai ulang server ADB juga menyebabkan ADB menjalankan pemindaian untuk menemukan perangkat lagi. Jika perangkat Anda tetap tidak tercantum pada daftar perangkat yang tersedia, coba langkah pemecahan masalah di bagian selanjutnya halaman ini.

Mengatasi masalah koneksi USB

Jika Connection Assistant tidak mendeteksi perangkat Anda melalui USB, Anda dapat mencoba langkah pemecahan masalah berikut untuk menyelesaikan masalah:

Pastikan Android Studio dapat terhubung ke Android Emulator

Untuk memeriksa apakah masalahnya disebabkan oleh koneksi antara Android Studio dan Android Emulator, ikuti langkah-langkah berikut:

  1. Buka AVD Manager.
  2. Buat AVD baru jika Anda belum melakukannya.
  3. Jalankan emulator menggunakan AVD Anda.
  4. Lakukan salah satu langkah berikut:

Periksa kabel USB

Untuk memeriksa apakah masalahnya disebabkan oleh kabel USB yang rusak, ikuti langkah-langkah di bagian ini.

Jika Anda memiliki kabel USB lain:

  1. Hubungkan perangkat menggunakan kabel sekunder.
  2. Periksa apakah Connection Assistant sekarang dapat mendeteksi perangkat.
  3. Jika perangkat tidak terdeteksi, cobalah kabel utama lagi.
  4. Jika perangkat tetap tidak terdeteksi, asumsikan bahwa masalahnya terletak pada perangkat dan periksa apakah perangkat sudah disiapkan untuk pengembangan.

Jika Anda tidak memiliki kabel USB lain tetapi memiliki perangkat Android lain:

  1. Hubungkan perangkat sekunder ke komputer Anda.
  2. Jika Connection Assistant dapat mendeteksi perangkat sekunder, asumsikan bahwa masalahnya terletak pada perangkat utama dan periksa apakah perangkat sudah disiapkan untuk pengembangan.

    Jika perangkat sekunder tidak terdeteksi, masalahnya mungkin terkait dengan kabel USB.

Periksa apakah perangkat sudah disiapkan untuk pengembangan

Untuk memeriksa apakah masalahnya disebabkan oleh setelan perangkat, ikuti langkah-langkah ini:

  1. Ikuti langkah-langkah di bagian Menyiapkan perangkat untuk pengembangan.
  2. Jika itu tidak menyelesaikan masalah, hubungi staf dukungan pelanggan OEM perangkat untuk meminta bantuan. Sampaikan kepada perwakilan dukungan pelanggan bahwa perangkat tidak dapat terhubung ke Android Studio menggunakan ADB.

Menyelesaikan masalah koneksi nirkabel

Jika mengalami masalah saat menghubungkan ke perangkat secara nirkabel, Anda dapat mencoba langkah-langkah pemecahan masalah berikut untuk menyelesaikan masalah tersebut.

Memeriksa apakah workstation dan perangkat Anda memenuhi prasyarat

Untuk memenuhi prasyarat proses debug nirkabel, pastikan bahwa:

  1. Workstation dan perangkat Anda terhubung ke jaringan nirkabel yang sama.
  2. Perangkat Anda menjalankan Android 11 atau yang lebih baru. Untuk informasi selengkapnya, lihat Memeriksa & mengupdate versi Android.
  3. Anda memiliki Android Studio Bumblebee. Anda dapat mendownloadnya di sini.
  4. Anda memiliki SDK Platform Tools versi terbaru di workstation Anda.

Memeriksa masalah umum lainnya

Berikut adalah daftar masalah umum saat ini terkait proses debug nirkabel di Android Studio dan cara menyelesaikannya.

  1. Wi-Fi tidak terhubung: Beberapa jaringan Wi-Fi, seperti jaringan Wi-Fi perusahaan, mungkin memblokir koneksi p2p dan tidak memungkinkan Anda terhubung melalui Wi-Fi. Coba hubungkan dengan kabel atau jaringan Wi-Fi lain.
  2. ADB melalui Wi-Fi terkadang dinonaktifkan secara otomatis: Hal ini dapat terjadi jika perangkat beralih jaringan Wi-Fi atau terputus dari jaringan.

Kunci keamanan RSA

Jika Anda menghubungkan perangkat yang menjalankan Android 4.2.2 (API level 17) atau yang lebih baru ke komputer, sistem akan menampilkan dialog yang menanyakan apakah Anda bersedia menerima kunci RSA yang memungkinkan proses debug melalui komputer ini. Mekanisme keamanan ini melindungi perangkat pengguna karena memastikan bahwa proses debug USB dan perintah adb lainnya tidak dapat dijalankan kecuali jika Anda dapat membuka kunci perangkat dan mengonfirmasi dialog.