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 menyambungkan perangkat ke komputer menggunakan kode penghubung. Komputer dan perangkat Anda harus terhubung ke jaringan nirkabel yang sama. Untuk menghubungkan perangkat, ikuti langkah-langkah berikut:

dialog penyambungan adb nirkabel
  1. Di komputer Anda, update SDK Platform-Tools ke versi terbaru.
  2. Aktifkan opsi Proses debug nirkabel di bagian Opsi developer.
  3. Pada dialog yang menanyakan Izinkan proses debug nirkabel di jaringan ini?, klik Izinkan.
  4. Pilih Sambungkan perangkat dengan kode penghubung. Catat kode penghubung, alamat IP, dan nomor port yang ditampilkan di perangkat (lihat gambar).
  5. Di komputer, buka terminal dan buka android_sdk/platform-tools.
  6. Jalankan adb pair ipaddr:port. Gunakan alamat IP dan nomor port dari langkah 3.
  7. Saat diminta, masukkan kode penghubung yang Anda terima pada langkah 4. Akan muncul pesan yang menunjukkan bahwa perangkat Anda berhasil disambungkan.

    Enter pairing code: 482924
    Successfully paired to 192.168.1.130:37099 [guid=adb-235XY]
    
  8. Jalankan adb connect ipaddr:port. Gunakan alamat IP dan port pada Proses debug nirkabel (lihat gambar di bawah).

    nomor IP dan port adb nirkabel

Memecahkan masalah koneksi perangkat 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 > Connection Assistant.

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.

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.