Men-debug aplikasi Wear OS

Untuk men-debug aplikasi Wear OS di smartwatch fisik, hubungkan mesin pengembangan Anda ke smartwatch menggunakan Wi-Fi atau Bluetooth. Atau, jika smartwatch memiliki port USB, hubungkan menggunakan USB.

Anda juga dapat menguji alur kerja yang mencakup beberapa perangkat, seperti smartwatch dan ponsel jika aplikasi Anda memerlukan dukungan ini. Untuk mempelajari lebih lanjut cara menyiapkan koneksi untuk pengujian, buka menghubungkan smartwatch ke ponsel.

Catatan: Jika tidak memiliki smartwatch fisik, Anda juga dapat menguji dan menjalankan aplikasi di emulator di Android Studio.

Mengupdate ke Wear OS versi terbaru

Untuk membantu memastikan aplikasi Anda berperilaku seperti yang diharapkan pada software terbaru, pastikan perangkat pengujian Anda menjalankan Wear OS versi terbaru yang didukung perangkat.

Untuk memeriksa update sistem di perangkat pengujian, selesaikan langkah-langkah berikut:

  1. Hubungkan perangkat ke jaringan Wi-Fi.
  2. Mulai isi daya perangkat.
  3. Tunggu sampai baterai perangkat terisi hingga 50% atau lebih tinggi.
  4. Pada perangkat pengujian, buka Setelan > Sistem > Update sistem.

    Jika update sistem tersedia, update akan didownload dan diinstal ke perangkat pengujian Anda.

Menginstal versi Wear OS tertentu (opsional)

Jika kasus pengujian aplikasi bergantung pada versi Wear OS tertentu, Anda dapat mem-flash image software ke smartwatch yang mendukung koneksi data USB. Misalnya, Anda dapat mem-flash setelan pabrik atau image OTA lengkap ke Google Pixel Watch 2.

Mengaktifkan opsi developer di smartwatch

Agar dapat men-debug smartwatch, aktifkan opsi developer. Anda hanya perlu melakukannya satu kali. Opsi developer tetap aktif sampai Anda menonaktifkannya. Untuk mengaktifkan opsi developer, lakukan langkah berikut:

  1. Di smartwatch, buka Setelan.
  2. Ketuk Sistem > Tentang > Versi.
  3. Ketuk item nomor Build tujuh kali.
  4. Pesan akan muncul untuk mengonfirmasi bahwa Anda kini adalah developer.

Men-debug melalui Wi-Fi

Sebelum memulai, aktifkan opsi developer di smartwatch seperti dijelaskan sebelumnya.

Menghubungkan smartwatch ke jaringan Wi-Fi

  1. Di smartwatch, buka Setelan.
  2. Ketuk Konektivitas > Wi-Fi.
  3. Pilih jaringan dan masukkan sandinya jika perlu.

    Catatan: Smartwatch dan mesin pengembangan harus terhubung ke jaringan yang sama. Tidak semua titik akses cocok. Anda mungkin perlu menggunakan titik akses yang firewall-nya telah dikonfigurasi dengan benar untuk mendukung adb.

Mengaktifkan proses debug melalui Wi-Fi

  1. Di smartwatch, buka Setelan.
  2. Ketuk Opsi developer > Debug melalui Wi-Fi.
  3. Setelah beberapa saat, layar akan menampilkan alamat IP smartwatch, seperti 192.168.1.100. Anda membutuhkan data ini untuk langkah berikutnya, jadi catatlah.

Menyambungkan debugger ke smartwatch

  1. Di perangkat Wear OS, temukan opsi proses debug nirkabel di setelan sistem. Pilih Sambungkan perangkat baru.
  2. Catat kode penyambungan Wi-Fi serta port & alamat IP.
  3. Di jendela terminal pada mesin pengembangan, ketik perintah berikut:
    adb pair IP_ADDRESS:PORT
    
  4. Jika diminta, masukkan kode penyambungan Wi-Fi dari langkah 2. Terminal akan menghasilkan output apakah penyambungan berhasil. Sebagai contoh:
    Enter pairing code: 123456
    Successfully paired to 192.168.1.100:5555
    
Setelah penyambungan, komputer host akan muncul dalam daftar Perangkat yang disambungkan di layar Proses Debug Nirkabel perangkat Wear OS.

Menghubungkan debugger ke smartwatch

  1. Hubungkan smartwatch dan mesin pengembangan ke jaringan yang sama.
  2. Hubungkan debugger ke smartwatch menggunakan alamat IP smartwatch dan nomor port. Misalnya, jika alamat IP adalah 192.168.1.100 dan nomor port adalah 5555, perintah adb connect dan responsnya akan terlihat seperti ini:

    adb connect 192.168.1.100:5555
    connected to 192.168.1.100:5555
    

Smartwatch sekarang terhubung ke debugger dan Anda siap memulai proses debug. Kirim perintah adb ke smartwatch menggunakan flag -s, yang menentukan alamat IP dan nomor port smartwatch:

adb -s 192.168.1.100:5555 <command>

Jika tidak menggunakan emulator dan hanya memiliki satu perangkat yang terhubung untuk proses debug, Anda tidak perlu menentukan alamat:

adb <command>

Men-debug melalui Bluetooth

Catatan: Proses debug melalui Bluetooth hanya berfungsi untuk smartwatch yang tersambung ke Android dan menjalankan Wear OS 2.

Sebelum memulai, sambungkan smartwatch dan ponsel, lalu aktifkan opsi developer di smartwatch seperti dijelaskan sebelumnya. Pastikan opsi developer diaktifkan di ponsel dengan membuka menu Setelan di ponsel dan mencari Opsi Developer. Jika perlu, aktifkan opsi developer di ponsel.

Mengaktifkan proses debug USB di ponsel

  1. Di ponsel, buka menu Setelan.
  2. Pilih Opsi Developer dan aktifkan Proses debug USB.

Mengaktifkan proses debug ADB atau Bluetooth di smartwatch

  1. Di smartwatch, buka menu Setelan.
  2. Scroll ke Opsi Developer.
  3. Pastikan bahwa Proses debug ADB diaktifkan.
  4. Aktifkan Debug melalui Bluetooth.

Mengaktifkan proses debug Bluetooth di ponsel

  1. Di ponsel, buka aplikasi pendamping Wear OS.
  2. Scroll ke Setelan Lanjutan dan ketuk untuk melihat opsi Setelan Lanjutan.
  3. Aktifkan Proses debug melalui Bluetooth. Pesan status berikut akan muncul di bawah opsi:
    Host: disconnected
    Target: connected
    

Pada tahap ini, mesin pengembangan—host—tidak berkomunikasi dengan smartwatch—target. Anda perlu menyelesaikan hubungan ini.

Catatan: Anda hanya dapat men-debug dengan satu perangkat pada satu waktu. Jika ada beberapa smartwatch yang tersambung, proses debug melalui Bluetooth hanya akan diaktifkan dengan perangkat yang dipilih di layar utama.

Menghubungkan debugger ke smartwatch

Pada langkah terakhir ini, Anda akan menggunakan semuanya: debugger, ponsel, dan smartwatch.

  1. Hubungkan ponsel ke komputer pengembangan melalui kabel USB.
  2. Jalankan kedua perintah ini di debugger:
    adb forward tcp:4444 localabstract:/adb-hub
    adb connect 127.0.0.1:4444
    

    Catatan: Anda harus menggunakan alamat IP 127.0.0.1. Gunakan port apa pun yang tersedia di mesin pengembangan Anda, dan gunakan port yang sama di kedua perintah. Dalam contoh ini, port-nya adalah 4444.

  3. Setelah Anda memasukkan perintah koneksi, smartwatch akan meminta Anda mengonfirmasi bahwa Anda mengizinkan Proses Debug ADB.
  4. Di ponsel, periksa tampilan status di aplikasi pendamping Wear OS untuk hal berikut:
    Host: connected
    Target: connected
    
  5. Smartwatch sekarang terhubung ke debugger, dan Anda siap memulai proses debug.

Saat Anda menjalankan debug pada smartwatch menggunakan Bluetooth, adb selalu menggunakan alamat IP 127.0.0.1 ditambah port yang Anda tetapkan. Dalam contoh ini, port-nya adalah 4444. Semua perintah adbmenggunakan format berikut:

adb -s 127.0.0.1:4444 <command> 

Jika tidak menggunakan emulator dan hanya memiliki satu perangkat yang terhubung untuk proses debug, Anda tidak perlu menentukan alamat:

adb <command>

Menggunakan perekam layar untuk Wear OS

Jika mengembangkan aplikasi di macOS, Anda dapat menggunakan project GitHub, alat Android untuk Mac, untuk merekam video dari perangkat Wear OS Anda.

Atau, rekam video dari perangkat Wear OS Anda menggunakan langkah-langkah berikut:

  1. Rekam frame mentah di smartwatch:
    adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw
  2. Salin file mentah tersebut ke mesin pengembangan:
    adb pull /sdcard/video.raw video.raw
  3. Gunakan ffmpeg untuk mengonversi file mentah menjadi MP4:
    ffmpeg -f rawvideo -vcodec rawvideo -s 400x400 -pix_fmt rgb24 -r 10 -i video.raw -an -c:v libx264 -pix_fmt yuv420p video.mp4

    Catatan: Lihat situs FFmpeg untuk petunjuk mendownload dan menginstal.