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 bekerja secara independen 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

Menginstal 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 Project Baru di Android Studio.

Memulai project Wear OS

Untuk membuat project di Android Studio:

  1. Klik File > Baru > Project Baru.
  2. Di jendela Template Project, klik tab Wear OS, pilih Aktivitas Kosong, lalu klik Berikutnya.
  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, konfirmasikan bahwa compileSdkVersion ditetapkan ke 28.
    • Di bagian android, konfirmasikan bahwa targetSdkVersion ditetapkan ke 28.
    • 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 image dengan Nama Rilis Pie, API Level 28, dan Target "Android 9.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.

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 penguncian layar perangkat dan sandi Akun Google untuk memulai sinkronisasi akun.

Catatan: Anda juga dapat menggunakan asisten penyambungan emulator Wear OS untuk menyambungkan ponsel fisik atau virtual dengan AVD smartwatch. Ponsel harus menjalankan Android 11 atau versi yang lebih tinggi dan sudah menginstal Google Play Store. Selain itu, alat ini hanya tersedia di Android Studio Arctic Fox (2021.3.1) beta dan yang lebih tinggi. Lihat Menggunakan asisten penyambungan emulator Wear OS.

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 berdiri sendiri, dan berfungsi secara independen 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 spesifik" pada Mengupdate aplikasi yang didownload). Ketuk Buka untuk memulai aplikasi.

Menyambungkan ponsel Android ke smartwatch

Setelah Anda memasang aplikasi pendamping di ponsel, lepaskan sambungan untuk penyandingan 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, kunjungi 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.

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 > Baru > Modul Baru.
  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 Mengonfigurasi Aktivitas, masukkan atau terima nilai default untuk Nama Aktivitas, Nama Tata Letak, dan Bahasa Sumber. 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.

Library UI Wear OS

Komponen di Library UI Wear OS direkomendasikan karena mencontohkan praktik terbaik untuk aplikasi smartwatch. Oleh karena itu, sebaiknya Anda menambahkan dependensi pada Library UI Wear OS. Untuk informasi lebih lanjut, lihat halaman berikut:

Library Jetpack lainnya

Wear OS telah bermigrasi dari support library ke Jetpack. Daftar lengkap semua class baru dapat dilihat di catatan rilis. Berikut ini beberapa sorotan penting:

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.

Perbedaan antara aplikasi ponsel dan smartwatch

Berikut adalah beberapa perbedaan antara aplikasi ponsel dan smartwatch:

  • Aplikasi smartwatch menggunakan API khusus smartwatch, jika memungkinkan (misalnya, untuk tata letak melingkar, panel samping wearable, mode standby, dll.).
  • Aplikasi smartwatch memiliki model UX yang berbeda.
  • Aplikasi smartwatch berisi fungsionalitas yang sesuai untuk smartwatch.
  • Aplikasi smartwatch dapat mengakses banyak API Android standar, tetapi tidak mendukung API berikut:

    Anda dapat memeriksa apakah smartwatch mendukung suatu fitur dengan memanggil hasSystemFeature() sebelum menggunakan API.

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.

Menggunakan asisten penyambungan emulator Wear OS

Catatan: Ponsel Anda harus menjalankan Android 11 atau lebih tinggi dan menginstal Google Play Store untuk menggunakan asisten penyambungan emulator Wear OS.

  1. Dari menu drop-down perangkat di Android Studio, klik asisten penyambungan emulator Wear OS.
  2. Pilih ponsel dan AVD Wear untuk menyambungkan satu sama lain. Jika tidak ada yang tersedia, klik Lihat AVD Manager untuk menyiapkan ponsel atau AVD smartwatch. Lalu klik Berikutnya.

    Android Studio mencoba meluncurkan dan menyiapkan jembatan di antara kedua perangkat. Jika belum menginstal aplikasi Wear OS di ponsel, Anda akan diminta untuk mendownload aplikasi Pendamping dari Play Store.

  3. Jika diminta, buka aplikasi Pendamping setelah didownload.
  4. 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.
  5. Di ponsel, pada aplikasi Wear OS, ketuk tombol Overflow, lalu ketuk Sambungkan dengan Emulator.