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

Agar dapat mulai menjalankan proses debug di perangkat, ada beberapa hal yang harus Anda lakukan terlebih dahulu:

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

  2. Siapkan sistem agar mendeteksi perangkat Anda.

    • macOS: Konfigurasi tambahan tidak diperlukan.
    • Ubuntu Linux: Gunakan apt-get install untuk menginstal paket adb. Ini memberi Anda seperangkat aturan udev yang dikelola komunitas untuk semua perangkat Android.

      Pastikan Anda berada di grup plugdev. Jika pesan error berikut ditampilkan, berarti adb tidak dapat menemukan Anda di grup plugdev:

      error: insufficient permissions for device: udev requires plugdev group membership
          

      Gunakan id untuk melihat grup tempat Anda berada. Gunakan sudo usermod -aG plugdev $LOGNAME untuk menambahkan perangkat Anda ke grup plugdev.

      Contoh berikut menunjukkan cara menginstal paket fitur adb Android.

      apt-get install adb
          
    • Windows: Instal driver USB untuk ADB. Untuk panduan penginstalan dan link ke driver OEM, lihat dokumen Menginstal driver USB OEM.

Menghubungkan ke perangkat Anda

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:

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

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 memilikinya.
  3. Jalankan emulator menggunakan AVD Anda.
  4. Lakukan salah satu hal 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.