Membuat dan menjalankan aplikasi wearable

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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 Android SDK, 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:

  1. Klik File > Baru > Project Baru.
  2. Di jendela Project Template, klik tab Wear OS, pilih Empty Compose Activity, lalu klik Next.
  3. 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.

  4. Di file build.gradle untuk modul aplikasi:
    • 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.
  5. 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>
    
  6. Sinkronkan project Android Studio Anda. Untuk menjalankan kode di modul baru, lihat Meluncurkan emulator dan menjalankan aplikasi Wear OS.

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:

  1. Di Android Studio, buka Android Virtual Device Manager dengan memilih Fitur > AVD Manager.
  2. Klik Buat Perangkat Virtual.
  3. Di panel Kategori, pilih Wear OS dan pilih profil hardware. Klik Berikutnya.
  4. 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.
  5. Tutup Android Virtual Device Manager.
  6. Di toolbar Android Studio, pilih AVD yang baru Anda buat dari menu drop-down 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.

File settings.gradle untuk project Android Studio Anda harus menyertakan ini:

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

Peringatan: Repositori JCenter menjadi hanya baca pada tanggal 31 Maret 2021. Untuk 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:

  1. Buka menu Setelan di jam tangan.
  2. Scroll hingga ke item menu terbawah. Jika Opsi developer tidak ada, ketuk Sistem, lalu Tentang.
  3. Ketuk nomor build 7 kali.
  4. Dari menu Setelan, ketuk Opsi developer.
  5. Aktifkan Proses debug ADB.

Menghubungkan smartwatch:

  1. Hubungkan smartwatch ke komputer melalui USB agar Anda dapat menginstal aplikasi langsung ke smartwatch.
  2. 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: Aplikasi Wear OS harus bersifat mandiri, dan berfungsi secara terpisah dari ponsel. Namun, jika aplikasi Anda bergantung pada aplikasi ponsel, lihat informasi di bawah tentang mengupdate ponsel dengan aplikasi pendamping Wear OS terbaru.

Menggunakan aplikasi pendamping versi Android

Di ponsel Android, buka listing aplikasi Wear OS. Ketuk Update untuk mendownload dan menginstal aplikasi. Setelah penginstalan, pastikan Update otomatis dipilih untuk aplikasi tersebut (lihat bagian "Menyiapkan update otomatis untuk aplikasi tertentu" pada 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:

  1. Pada ponsel, pilih nama perangkat Anda dari daftar perangkat. Kode penyambungan akan ditampilkan pada ponsel dan smartwatch. Pastikan kedua kode sama.
  2. Ketuk Sambungkan untuk melanjutkan proses penyambungan. Setelah smartwatch terhubung ke ponsel, pesan konfirmasi akan ditampilkan. Pada ponsel, akan muncul layar yang berisi daftar akun di ponsel tersebut.
  3. Pilih Akun Google yang akan ditambahkan dan disinkronkan ke smartwatch Anda.
  4. Konfirmasi kunci layar dan masukkan sandi untuk memulai penyalinan akun dari ponsel ke smartwatch.
  5. Ikuti petunjuk di wizard untuk menyelesaikan proses penyambungan.

Aplikasi pendamping untuk iPhone

Aplikasi pendamping iOS tersedia, tetapi ponsel yang digunakan untuk menginstal aplikasi tersebut harus menjalankan iOS versi 8.2 atau yang lebih baru:

  1. Di iPhone, buka App Store dan download, lalu instal aplikasi pendamping Wear OS.
  2. Ikuti petunjuk di smartwatch dan ponsel untuk memulai proses penyambungan. Untuk informasi tambahan, lihat halaman Bantuan yang terkait.

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 sebelumnya disambungkan saat diluncurkan.

Untuk menyambungkan dua perangkat, ikuti langkah-langkah berikut:

  1. Buat emulator Wear, jika belum melakukannya.
  2. Di Pengelola Perangkat, tekan ikon menu dropdown "overflow" di salah satu perangkat yang ingin Anda sambungkan, lalu pilih Pair Wearable.

    Gambar 1. Menu dropdown perangkat yang dapat disambungkan dengan emulator Wear.

  3. Tindakan ini akan meluncurkan asisten penyambungan emulator Wear OS. Jika mengklik Pair Wearable di ponsel, Anda akan melihat daftar perangkat Wear yang tersedia. Jika Anda memulai dengan perangkat Wear, Anda akan melihat daftar ponsel yang tersedia. Pilih perangkat yang ingin disambungkan, lalu klik Next.
  4. Mungkin perlu waktu beberapa menit bagi Android Studio untuk meluncurkan dan menyiapkan perangkat. Jika ponsel Anda belum menginstal aplikasi pendamping Wear OS, ikuti petunjuk untuk login ke Play Store, menginstalnya, lalu menyiapkannya.
  5. 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:

  1. Ikuti langkah-langkah untuk menyiapkan ponsel.
  2. Di ponsel, aktifkan Opsi Developer dan Proses Debug USB.
  3. Hubungkan ponsel ke komputer Anda melalui USB.
  4. Teruskan port komunikasi AVD ke ponsel yang terhubung (setiap kali ponsel terhubung):
    adb -d forward tcp:5601 tcp:5601
  5. Di ponsel, pada aplikasi Wear OS, mulailah proses penyambungan standar. Misalnya, pada layar Selamat Datang, ketuk tombol Siapkan. Atau, jika smartwatch yang ada sudah disambungkan, di bagian kiri atas menu drop-down, ketuk Tambahkan Smartwatch Baru.
  6. Di ponsel, pada aplikasi Wear OS, ketuk tombol Overflow, lalu ketuk Sambungkan dengan Emulator.
  7. Ketuk ikon Setelan.
  8. Di bagian Setelan Perangkat, ketuk Emulator.
  9. Ketuk Akun dan pilih Akun Google, lalu 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 menu dropdown 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, sehingga Anda dapat menggunakan kembali kode dari aplikasi seluler (ponsel).

Memasukkan modul Wear OS ke dalam project yang ada

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

  1. Klik File > New > New Module.
  2. Di jendela Modul Baru, pilih Modul Wear OS, lalu klik Berikutnya.
  3. Di bagian Konfigurasi modul baru, masukkan:
    • Nama Aplikasi/Library: String ini adalah judul ikon peluncur aplikasi Anda untuk modul baru.
    • Nama Modul: String ini adalah nama folder untuk kode sumber dan file resource Anda.
    • Nama Paket: String ini adalah namespace Java untuk kode dalam modul Anda. String ini ditambahkan sebagai atribut package dalam file manifes Android modul tersebut.
    • SDK Minimum: Pilih 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.
  4. Klik Berikutnya. Anda akan melihat beberapa opsi template kode. Klik Aktivitas Wear OS Kosong, lalu klik Berikutnya.
  5. 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:

Menyertakan library

Catatan: Sebaiknya 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; harap pelajari informasi tentang dependensi di bawah.

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.

Membuat UI untuk Wear OS

Compose adalah pendekatan yang kami rekomendasikan untuk membuat antarmuka pengguna bagi aplikasi Wear OS. Compose untuk Wear OS menawarkan lebih dari 20 komponen yang dirancang untuk faktor bentuk Wear OS, yang jauh lebih banyak daripada jumlah komponen yang tersedia untuk tata letak berbasis tampilan Anda. 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 akan 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 sedang melacak latihan lari dan perlu melihat waktu setiap saat.

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 informasi selengkapnya dan praktik terbaik, tinjau halaman Memastikan aplikasi Anda tetap terlihat di Wear OS.