Halaman ini menyediakan panduan untuk membangun aplikasi pertama Anda untuk Wear OS, menggunakan template dari Android Studio. Aplikasi ini menunjukkan berbagai cara untuk melihat informasi secara sekilas di perangkat Wear OS, dan memperkenalkan beberapa praktik terbaik untuk mengembangkan aplikasi di platform.
Panduan ini dibuat berdasarkan pengetahuan sebelumnya tentang platform Android dan Android Studio IDE. Jika Anda baru mengenal Android, buat aplikasi menggunakan codelab ini. Untuk mempelajari kemampuan Android Studio lebih lanjut, buka halaman Mengenal Android Studio.
Membuat aplikasi Wear OS
Setelah mendownload dan menginstal Android Studio versi terbaru, selesaikan wizard Project Baru:
- Buka Android Studio, lalu buka File > New > New Project. Jendela New Project akan muncul.
 - Di panel Templates, pilih Wear OS. Kemudian, di panel utama, pilih Empty Wear App.
 - Beri nama project Anda, lalu klik Finish. Android Studio akan mendownload dependensi yang diperlukan dan membangun project Anda.
 
Anda kini siap menjalankan aplikasi pertama Anda di Wear OS.
Menjalankan aplikasi di emulator
Cara mudah untuk menjalankan aplikasi Wear OS Anda adalah di emulator.
Mengonfigurasi emulator
Untuk mengonfigurasi emulator di Android Studio, selesaikan langkah-langkah berikut:
- Di SDK Manager, buka tab SDK Tools. Pastikan Anda memiliki Android SDK Platform-Tools versi terbaru. Tutup SDK Manager.
 - Buka Tools > Device Manager.
 - Pilih Create (+). Wizard Virtual Device Configuration akan muncul.
 - Di panel Category, pilih Wear OS lalu pilih profil hardware, seperti Wear OS Small Round. Klik Next.
 - Kecuali jika Anda memerlukan penyesuaian tertentu, pertahankan setelan default di layar ini. Android Studio memilih API dan image sistem terbaru secara default. Klik Finish.
 
Untuk mengetahui informasi selengkapnya tentang penggunaan emulator, lihat panduan cara menjalankan aplikasi di Android Emulator.
Membuka aplikasi di emulator
- Di toolbar utama, temukan Jalankan Widget. Dari menu drop-down
perangkat, pilih emulator yang Anda buat, lalu klik tombol Run 
 untuk
meluncurkan aplikasi. - Setelah beberapa saat, pesan "Hello..." akan muncul di emulator.
 
Menjalankan aplikasi di smartwatch fisik (opsional)
Dengan menjalankan dan melakukan proses debug aplikasi di smartwatch fisik, Anda dapat mengevaluasi seluruh pengalaman pengguna dengan lebih baik. Hal ini sangat penting jika aplikasi Anda mengandalkan hardware tertentu, seperti sensor atau GPU.
Untuk menjalankan aplikasi di smartwatch fisik, siapkan perangkat untuk pengujian, lalu hubungkan ke mesin pengembangan Anda.
Menyiapkan smartwatch untuk pengujian
Guna menyiapkan smartwatch untuk pengujian, aktifkan proses debug ADB dengan menyelesaikan langkah-langkah berikut:
- Di smartwatch, buka menu Setting.
 - Buka bagian bawah menu. Jika tidak ada item Developer options yang muncul,
selesaikan sub-langkah berikut. Atau, lanjutkan ke langkah berikutnya.
- Ketuk System > About atau System > About > Versions.
 - Cari item Build number lalu ketuk item tersebut tujuh kali. Jika smartwatch dilindungi dengan PIN atau pola, masukkan saat diminta.
 
 - Dari menu Setelan, ketuk Opsi developer.
 - Aktifkan opsi ADB debugging.
 
Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi opsi developer di perangkat.
Menghubungkan smartwatch ke mesin pengembangan
Beberapa smartwatch memungkinkan Anda menghubungkan melalui USB. Lainnya memerlukan koneksi nirkabel.
Menyiapkan koneksi kabel melalui USB
Hubungkan smartwatch menggunakan langkah-langkah berikut:
- Menggunakan kabel USB, hubungkan smartwatch ke mesin pengembangan.
 - Di smartwatch, aktifkan Always allow from this computer, lalu ketuk OK.
 
Menyiapkan koneksi nirkabel
Jika tidak memungkinkan untuk men-debug smartwatch melalui port USB, lihat Menghubungkan ke perangkat menggunakan Wi-Fi.
Membuka aplikasi di smartwatch
- Di Run Widget (bagian dari toolbar utama), gunakan drop-down perangkat untuk memilih perangkat fisik Anda.
 - Klik tombol Run 
 di
Run Widget. - Setelah beberapa saat, pesan "Hello..." akan muncul di perangkat Anda.
 
Merencanakan arsitektur aplikasi Anda
Setelah aplikasi dasar berjalan, Anda siap untuk melampaui template. Sebelum mulai menambahkan fitur baru, sebaiknya pikirkan keputusan arsitektur utama yang akan membentuk aplikasi Anda. Bagian berikut membahas beberapa pertanyaan penting yang perlu dipertimbangkan.
Model aplikasi: Mandiri, non-mandiri, atau hybrid
Pertimbangkan seberapa besar aplikasi Anda mengandalkan ponsel yang disambungkan:
- Hybrid (direkomendasikan untuk sebagian besar aplikasi): Ini adalah pendekatan yang paling umum dan fleksibel. Fitur inti aplikasi berfungsi tanpa ponsel (seperti melacak latihan fisik), tetapi aplikasi menawarkan fungsi yang ditingkatkan saat ponsel terhubung, seperti menyinkronkan data atau menawarkan konfigurasi yang lebih mudah.
 - Mandiri: Aplikasi Anda berfungsi sepenuhnya dengan sendirinya, tanpa memerlukan ponsel untuk fitur inti. Opsi ini sangat cocok untuk aplikasi yang dapat berfungsi secara offline atau menggunakan koneksi internetnya sendiri. Template "Empty Wear App" membuat aplikasi mandiri secara default.
 - Non-mandiri: Aplikasi Anda memerlukan ponsel untuk fungsi intinya.
 
Untuk mengetahui informasi dan panduan selengkapnya tentang pilihan ini, lihat Aplikasi Wear OS mandiri versus non-mandiri.
Membangun antarmuka pengguna
Compose untuk Wear OS adalah framework deklaratif modern yang merupakan cara yang direkomendasikan untuk membangun UI aplikasi Wear OS. Template yang Anda gunakan dibuat dengan Compose, sehingga memberi Anda titik awal yang bagus.
Saat membangun dengan Compose, gunakan library yang didesain khusus untuk Wear OS. Komponen ini menyediakan komponen yang dioptimalkan untuk smartwatch yang penting untuk pengalaman pengguna yang luar biasa.
Misalnya, alih-alih LazyColumn standar, gunakan
TransformingLazyColumn, yang secara otomatis menerapkan efek penskalaan dan
transparansi ke item di tepi layar bulat.
Demikian pula, untuk navigasi, gunakan SwipeDismissableNavHost dari
library Navigasi Wear OS untuk berintegrasi dengan gestur geser untuk menutup
sistem.
Penyimpanan dan sinkronisasi data
Cara Anda mengelola data adalah pilihan arsitektur inti. Untuk persistensi di perangkat, opsi Anda sama seperti di perangkat seluler, dengan DataStore untuk data nilai kunci atau objek yang diketik, dan Room untuk data terstruktur yang lebih kompleks sebagai pilihan modern yang direkomendasikan.
- Simpan data di perangkat terlebih dahulu: Desain aplikasi Anda agar offline-first, menyimpan data yang diperlukan langsung di smartwatch sehingga tetap berfungsi tanpa koneksi ponsel.
 - Menyinkronkan data dengan ponsel: Jika Anda perlu menyinkronkan atau melakukan streaming data (seperti setelan pengguna atau data latihan fisik) dengan aplikasi pendamping ponsel, gunakan Data Layer API. API ini menyediakan saluran komunikasi yang berfungsi melalui Bluetooth dan Wi-Fi.
 
Mengelola pekerjaan yang berjalan lama
Banyak pengalaman inti Wear OS, seperti latihan fisik atau pemutaran media, berjalan lama. Penting untuk mengelola pekerjaan ini dengan benar untuk membantu menjaga keandalan dan menghemat baterai.
- Untuk tugas yang berjalan lama dan dimulai oleh pengguna: Saat pengguna memulai tugas yang perlu dilanjutkan meskipun mereka keluar (seperti melacak lari), Anda harus menggunakan layanan latar depan. Di Wear OS, pasangkan layanan ini dengan Ongoing Activity API. Tindakan ini akan membuat notifikasi persisten dan ikon yang dapat diketuk di tampilan jam, yang memungkinkan pengguna kembali ke aplikasi Anda.
 - Untuk tugas latar belakang yang dapat ditangguhkan: Untuk pekerjaan yang tidak perlu terjadi segera (seperti menyinkronkan data secara berkala), gunakan WorkManager. API ini memperhatikan baterai dan mematuhi pengoptimalan sistem seperti mode Istirahatkan, sehingga menjadi pilihan yang baik untuk pemrosesan latar belakang yang tidak mendesak.
 
Berpikir di luar aplikasi: Platform dan kemampuan
Terakhir, ingatlah bahwa pengalaman Wear OS lebih dari sekadar aplikasi utama.
- Mendukung platform lain: Untuk membuat aplikasi yang menarik dan berkualitas tinggi, rencanakan untuk mendukung platform lain yang dioptimalkan untuk perangkat wearable. Pertimbangkan untuk membuat kartu untuk tindakan dan informasi cepat, serta detail untuk menampilkan data penting langsung di tampilan jam pengguna.
 - Rencanakan efisiensi daya: Daya tahan baterai sangat penting di perangkat wearable. Sejak awal, desain aplikasi Anda agar hemat daya. Artinya, Anda harus berhati-hati dalam mengambil data, menggunakan sensor, dan menjalankan tugas di latar belakang. Menunda pekerjaan hingga smartwatch sedang mengisi daya sering kali merupakan strategi yang baik. Anda dapat mempelajari lebih lanjut dalam panduan untuk menghemat daya.
 
Direkomendasikan untuk Anda
- Catatan: teks link ditampilkan saat JavaScript nonaktif
 - Menghubungkan smartwatch ke ponsel
 - Menggunakan Jetpack Compose di Wear OS
 - Catatan rilis