Membuat dan menjalankan aplikasi wearable

Aplikasi Wear OS berjalan langsung di smartwatch, yang memberi Anda akses ke hardware seperti sensor dan GPU. Aplikasi wearable mirip dengan aplikasi lainnya yang menggunakan Software Development Kit (SDK) Android, tetapi memiliki desain dan fungsi yang berbeda.

Aplikasi Wear OS berfungsi secara terpisah dari aplikasi ponsel, sehingga pengguna memiliki fleksibilitas dalam memilih ponsel. Untuk mengetahui informasi selengkapnya, lihat Aplikasi Wear OS mandiri versus non-mandiri.

Catatan: Anda dapat menguji aplikasi di smartwatch sebenarnya menggunakan USB, Wi-Fi, atau Bluetooth seperti yang dijelaskan dalam Men-debug aplikasi Wear OS. Proses debug aplikasi pada smartwatch sebenarnya memungkinkan Anda mengevaluasi total pengalaman pengguna dengan lebih baik. Anda dapat menggunakan emulator smartwatch di Android Studio untuk menguji aplikasi Anda dengan berbagai bentuk dan ukuran layar.

Menyiapkan lingkungan Anda

Instal Android Studio versi terbaru. Untuk mengetahui informasi tentang membuat aplikasi di Android Studio, lihat Ringkasan project.

Gunakan SDK manager untuk mengonfirmasi bahwa Anda memiliki versi terbaru platform Android yang mendukung Wear OS, Android 11 (API level 30).

Jika Anda berencana untuk menyediakan aplikasi Wear OS untuk pasar China, lihat Membuat aplikasi Wear OS untuk China.

Membuat aplikasi Wear OS

Anda dapat membuat aplikasi Wear OS menggunakan wizard New Project di Android Studio.

Memulai project Wear OS

Untuk membuat project di Android Studio, selesaikan langkah-langkah berikut:

Klik File > Baru > Project Baru.
Di jendela Project Template, klik tab Wear OS, pilih Empty Compose Activity, lalu klik Next.
Di jendela Project Baru, beri nama project Anda, isi informasi project standar, lalu klik Selesai.

Android Studio akan membuat project dengan modul aplikasi untuk penyedia data Anda.
Dalam file build.gradle untuk modul aplikasi, lakukan hal berikut:
- Di bagian android, konfirmasi bahwa compileSdkVersion disetel ke 33.
- Di bagian android, konfirmasi bahwa targetSdkVersion disetel ke 30.
- Ganti bagian dependencies dengan dependensi khusus Wear OS.
Dalam file Manifes Android, pastikan tag <uses-feature> ditentukan. Tentukan android:name="android.hardware.type.watch" seperti yang ditunjukkan pada contoh berikut:
```
<manifest>
...
  <uses-feature android:name="android.hardware.type.watch" />
...
</manifest>
```
Sinkronkan project Android Studio Anda. Untuk menjalankan kode di modul baru, lihat langkah-langkah di bagian berikut ini.

Meluncurkan emulator dan menjalankan aplikasi Wear OS

Untuk menggunakan emulator, konfigurasikan Perangkat Virtual Android (AVD). Pastikan Anda memiliki Android SDK Platform-Tools versi terbaru dari SDK Manager.

Konfigurasikan AVD dan jalankan aplikasi Anda sebagai berikut:

Di Android Studio, buka Android Virtual Device Manager dengan memilih Fitur > AVD Manager.
Klik Create Virtual Device.
Di panel Kategori, pilih Wear OS dan pilih profil hardware. Klik Berikutnya.
Pilih image sistem yang akan didownload. Misalnya, pilih gambar dengan API Level 30, dan Target "Android 11.0 (Wear OS)". Klik Berikutnya, lalu klik Selesai.
Tutup Android Virtual Device Manager.
Di toolbar Android Studio, pilih AVD yang baru Anda buat dari menu perangkat target, lalu klik Jalankan .
AVD dimulai dan, setelah beberapa saat, menjalankan aplikasi Anda. Pesan "Halo ..." akan muncul.

Untuk mengetahui informasi lebih lanjut tentang menggunakan AVD, lihat Menjalankan aplikasi di emulator Android.

Mengupdate project Wear OS

Jika sudah memiliki project, Anda mungkin perlu mengupdate file settings.gradle. Pastikan Anda menggunakan google() untuk menunjukkan repositori Maven Google. Untuk informasi terkait, lihat Repositori Maven pada Google.

Sertakan baris berikut dalam file settings.gradle untuk project Android Studio Anda:

  dependencyResolutionManagement {
      ...
      repositories {
          google()
          jcenter()
      }
  }

Peringatan: Repositori JCenter menjadi hanya baca pada tanggal 31 Maret 2021. Untuk mengetahui informasi selengkapnya, lihat pembaruan layanan JCenter.

Menyiapkan smartwatch

Proses penerapan aplikasi ke jam tangan dan ke ponsel itu mirip.

Bagian ini mengasumsikan bahwa smartwatch Anda dilengkapi port USB. Jika tidak, lihat petunjuk menghubungkan smartwatch menggunakan Wi-Fi atau Bluetooth.

Aktifkan proses debug adb di smartwatch sebagai berikut:

Buka menu Setelan di smartwatch.
Scroll hingga ke item menu terbawah. Jika Opsi developer tidak ada, ketuk Sistem, lalu Tentang.
Ketuk nomor build tujuh kali.
Dari menu Setelan, ketuk Opsi developer.
Aktifkan Proses debug ADB.

Hubungkan smartwatch menggunakan langkah-langkah berikut:

Hubungkan smartwatch ke komputer menggunakan USB agar Anda dapat menginstal aplikasi langsung ke smartwatch.
Pada smartwatch, ketuk Selalu izinkan dari komputer ini, lalu ketuk Oke.

Setelah smartwatch terhubung, jalankan aplikasi dengan memilih target deployment seperti yang dijelaskan dalam Membuat dan menjalankan aplikasi.

Menyiapkan ponsel

Bagian ini berisi informasi tentang menyiapkan ponsel pendamping dengan aplikasi pendamping Wear OS.

Catatan: Sebaiknya aplikasi Wear OS mandiri dan berfungsi secara independen dari ponsel. Namun, jika aplikasi Wear OS Anda bergantung pada aplikasi seluler, lihat informasi berikut tentang mengupdate ponsel dengan aplikasi pendamping Wear OS terbaru.

Menggunakan aplikasi pendamping versi Android

Di ponsel Android, buka listingan aplikasi Smartwatch Wear OS by Google. Ketuk Update untuk mendownload dan menginstal aplikasi. Setelah penginstalan, pastikan Update otomatis dipilih untuk aplikasi tersebut. Lihat bagian "Cara mengupdate aplikasi Android satu per satu secara otomatis" dari Mengupdate aplikasi yang didownload. Ketuk Buka untuk memulai aplikasi.

Menyambungkan ponsel Android ke smartwatch

Setelah Anda menginstal aplikasi pendamping di ponsel, lepaskan sambungan smartwatch yang sudah tidak digunakan, jika perlu. Kemudian, sambungkan ponsel ke smartwatch yang baru diisi image: Untuk melakukannya, selesaikan langkah-langkah berikut:

Pada ponsel, pilih nama perangkat Anda dari daftar perangkat. Kode penyambungan akan ditampilkan pada ponsel dan smartwatch. Periksa apakah kode tersebut cocok.
Ketuk Sambungkan untuk melanjutkan proses penyambungan. Setelah smartwatch terhubung ke ponsel, pesan konfirmasi akan ditampilkan. Pada ponsel, akan muncul layar yang mencantumkan akun di ponsel tersebut.
Pilih Akun Google yang akan ditambahkan dan disinkronkan ke smartwatch Anda.
Konfirmasi kunci layar dan masukkan sandi untuk memulai penyalinan akun dari ponsel ke smartwatch.
Ikuti petunjuk di wizard untuk menyelesaikan proses penyambungan.

Aplikasi pendamping untuk iPhone

Aplikasi pendamping iOS tersedia untuk ponsel yang menjalankan iOS 8.2 atau yang lebih tinggi. Untuk menginstalnya, lakukan hal berikut:

Di iPhone, kunjungi App Store dan download lalu instal aplikasi pendamping Wear OS by Google.
Ikuti petunjuk di smartwatch dan ponsel untuk memulai proses penyambungan. Untuk informasi tambahan, lihat halaman tentang memperbaiki masalah penyiapan smartwatch.

Menyambungkan perangkat dengan emulator smartwatch

Anda dapat menyambungkan perangkat ke Perangkat Virtual Android (AVD) smartwatch atau emulator, secara manual atau dengan menggunakan asisten penyambungan emulator Wear OS.

Menggunakan asisten penyambungan emulator Wear OS

Catatan: Ponsel Anda harus menjalankan Android 11 (API level 30) atau yang lebih baru dan menginstal Google Play Store agar dapat menggunakan asisten penyambungan emulator Wear OS. Selain itu, pastikan emulator Wear Anda menjalankan API level 28 atau yang lebih baru untuk menggunakan fitur asisten terbaru. Untuk mengupgrade image sistem perangkat yang diemulasi, gunakan SDK Manager.

Asisten penyambungan emulator Wear OS memudahkan pengelolaan dan koneksi ke emulator Wear. Anda dapat menyambungkan beberapa perangkat Wear dengan satu ponsel virtual atau fisik. Android Studio juga mengingat dan menyambungkan ulang perangkat yang disambungkan sebelumnya saat diluncurkan.

Untuk menyambungkan dua perangkat, ikuti langkah-langkah berikut:

Buat emulator Wear, jika belum melakukannya.
Di Pengelola Perangkat, klik ikon menu tambahan di samping perangkat yang ingin disambungkan, lalu pilih Sambungkan Wearable.

Gambar 1. Menu tambahan perangkat yang dapat disambungkan dengan emulator Wear.
Tindakan ini akan meluncurkan asisten penyambungan emulator Wear OS. Jika memilih Sambungkan Wearable pada entri untuk ponsel, Anda akan melihat daftar perangkat Wear yang tersedia. Jika memulai dengan perangkat Wear, Anda akan melihat daftar ponsel yang tersedia. Pilih perangkat yang ingin disambungkan, lalu klik Next.
Mungkin perlu waktu beberapa menit bagi Android Studio untuk meluncurkan dan menyiapkan perangkat. Jika aplikasi pendamping Wear OS belum terinstal di ponsel Anda, ikuti petunjuk untuk login ke Play Store, instal, dan siapkan.
Untuk menyambungkan perangkat di aplikasi Wear OS di ponsel Anda, klik menu tiga titik, lalu pilih Pair with emulator.

Setelah perangkat berhasil disambungkan, Pengelola Perangkat akan menampilkan ikon kecil di samping perangkat yang disambungkan. Anda juga dapat mengklik menu dropdown tambahan dan memilih View Details untuk melihat daftar perangkat yang disambungkan.

**Gambar 2.** Jendela alat **Paired Devices** menampilkan perangkat yang disambungkan dengan perangkat yang dipilih.

Menyambungkan ponsel dengan AVD smartwatch

Jika menginginkan Akun Google pada AVD smartwatch untuk keperluan pengembangan, Anda dapat menyambungkan ponsel dengan AVD smartwatch dan menyinkronkan Akun Google dengan melakukan hal berikut:

Ikuti langkah-langkah untuk menyiapkan ponsel.
Di ponsel, aktifkan Opsi Developer dan Proses Debug USB.
Hubungkan ponsel ke komputer Anda melalui USB.
Teruskan port komunikasi AVD ke ponsel yang terhubung setiap kali ponsel terhubung menggunakan perintah ini:
adb -d forward tcp:5601 tcp:5601
Di aplikasi pendamping Wear OS di ponsel, mulailah proses penyambungan standar. Misalnya, pada layar Selamat Datang, ketuk tombol Siapkan. Atau, jika smartwatch yang ada sudah disambungkan, ketuk Tambahkan Smartwatch Baru di menu kiri atas.
Di aplikasi pendamping Wear OS di ponsel, ketuk menu tambahan, lalu ketuk Sambungkan dengan Emulator.
Ketuk ikon Setelan.
Di bagian Setelan Perangkat, ketuk Emulator.
Ketuk Akun dan pilih Akun Google. Ikuti langkah-langkah dalam wizard untuk menyinkronkan akun dengan emulator. Jika perlu, ketikkan sandi kunci layar perangkat dan sandi akun Google untuk memulai sinkronisasi akun.

Menghubungkan ponsel ke beberapa perangkat Wear

Untuk menghubungkan perangkat Wear kedua ke ponsel virtual atau fisik, ikuti langkah yang sama seperti yang Anda lakukan untuk penyambungan awal: temukan ponsel atau perangkat Wear yang ingin disambungkan di Pengelola Perangkat, klik ikon menu tambahan, lalu klik Pair Wearable.

Menambahkan modul Wear OS ke project Anda

Anda dapat menambahkan modul untuk perangkat Wear OS ke project yang ada di Android Studio agar dapat menggunakan kembali kode dari aplikasi seluler.

Membuat modul Wear OS ke dalam project yang ada

Untuk membuat modul Wear OS, buka project Android Studio yang ada dan lakukan langkah berikut:

Klik File > New > New Module.
Di jendela Modul Baru, pilih Modul Wear OS, lalu klik Berikutnya.
Di bagian Konfigurasi modul baru, masukkan kode berikut:
- Application/Library Name: judul ikon peluncur aplikasi untuk modul baru
- Module Name: nama folder untuk kode sumber dan file resource Anda
- Nama Paket: namespace Java untuk kode dalam modul Anda. String ini ditambahkan sebagai atribut package dalam file manifes Android modul tersebut.
- SDK Minimum: versi platform terendah yang didukung modul aplikasi. Misalnya, pilih API 26: Android 8.0. Nilai ini menetapkan atribut minSdkVersion dalam file build.gradle, yang dapat diedit nanti.
Klik Berikutnya. Anda akan melihat beberapa opsi template kode. Pilih Aktivitas Wear OS Kosong, lalu klik Berikutnya.
Pada jendela Configure Activity, masukkan atau terima nilai default untuk Activity Name, Layout Name, dan Source Language. Klik Selesai.

Android Studio membuat dan menyinkronkan file untuk modul baru. Android Studio juga menambahkan dependensi yang diperlukan untuk Wear OS ke file build modul baru. Modul baru ini ditampilkan di jendela Project di sisi kiri layar. Jika folder modul baru tidak terlihat, pastikan jendela menampilkan tampilan Android.

Sertakan baris berikut dalam file build.gradle untuk modul Wear OS baru:

Di bagian android, tetapkan nilai untuk compileSdkVersion ke 33 dan targetSdkVersion ke 30.
Tambahkan dependensi yang diperlukan. Untuk informasi selengkapnya, lihat Mendeklarasikan dependensi.
Sinkronkan project Android Studio Anda. Untuk menjalankan kode di modul baru, lihat Meluncurkan emulator dan menjalankan aplikasi Wear OS.

Menyertakan library

Catatan: Gunakan Android Studio untuk pengembangan Wear OS, karena Android Studio menyediakan penyiapan project, penyertaan library, dan pembuatan paket.

Jika Anda menggunakan Wizard Project Android Studio, wizard akan mengimpor dependensi dalam file build.gradle modul yang sesuai. Namun, dependensi tidak diperlukan untuk semua aplikasi. Tinjau informasi di bawah tentang dependensi.

Untuk mengupdate project Wear OS yang ada ke versi SDK terbaru, gunakan setelan yang tercantum di bagian Memulai project Wear OS.

Notifikasi

Untuk mengetahui informasi tentang dependensi untuk notifikasi, lihat Membuat notifikasi di Wear.

Mem-build UI untuk Wear OS

Compose adalah pendekatan yang direkomendasikan untuk membuat antarmuka pengguna bagi aplikasi Wear OS. Compose untuk Wear OS menawarkan lebih dari 20 komponen yang didesain untuk faktor bentuk Wear OS—jauh lebih banyak daripada jumlah komponen yang tersedia untuk tata letak berbasis tampilan. Komponen ini dirancang untuk membantu Anda menciptakan pengalaman pengguna yang sesuai dengan panduan Desain Material terbaru untuk Wear OS.

Namun, jika Anda lebih memilih untuk membuat dengan tampilan, tambahkan dependensi pada Library UI Wear OS. Untuk informasi selengkapnya, lihat Membuat UI berbasis View di Wear OS.

Layanan Play dan Data Layer API Wearable

Jika aplikasi Anda bergantung pada Layanan Google Play, entah untuk menyinkronkan dan mengirim data menggunakan Data Layer API atau untuk alasan lainnya, Anda perlu Layanan Google Play versi terbaru. Jika tidak menggunakan API ini, hapus depedensi tersebut.

Menghemat daya pada smartwatch

Smartwatch beralih dari mode interaktif ke mode standby ketika tidak ada aktivitas pada smartwatch atau ketika pengguna menutupi layar dengan telapak tangannya.

Untuk menghemat daya smartwatch, hindari penggunaan mode standby. Jika smartwatch berada dalam mode standby sistem saat aplikasi Anda aktif dan pengguna berinteraksi lagi dengan smartwatch dalam jangka waktu tertentu, aplikasi Anda ditampilkan sebagai hal pertama yang mereka lihat.

Anda dapat mengganti mode standby di aplikasi Anda untuk kasus penggunaan tertentu. Misalnya, ganti mode standby jika pengguna melacak lari dan perlu melihat waktu secara terus-menerus.

Aplikasi smartwatch yang dapat beralih ke mode standby disebut aplikasi selalu aktif. Berikut ini penjelasan tentang dua mode operasi untuk aplikasi selalu aktif:

Interaktif: Dalam mode ini, gunakan warna penuh dengan animasi yang lancar. Aplikasi ini juga responsif terhadap input.
Ambien: Dalam mode ini, isi layar dengan grafis hitam putih dan jangan sediakan gestur input apa pun. Mode tampilan ini hanya didukung pada perangkat yang menjalankan Android 5.1 atau yang lebih baru.

Untuk mengetahui informasi selengkapnya dan praktik terbaik, tinjau Menjaga aplikasi Anda tetap terlihat di Wear OS.