Catatan rilis Wear OS

Halaman ini berisi informasi tentang rilis Wear OS, seperti Wearable SDK dan Wearable Support Library.

31-Agustus-2023 Wearable SDK 18.1.0

Wearable SDK versi 18.1.0 menyertakan update minor API untuk mendukung rilis Wearable Support Library berikutnya. Update meliputi:

20-September-2022 Wearable SDK 18.0.0

Wearable SDK versi 18.0.0 menyertakan update minor API untuk mendukung rilis Wearable Support Library berikutnya. Update meliputi:

  • Dukungan WearableListenerService untuk aplikasi yang menargetkan Android 13—masalah 235538840.
  • Metode MessageClient.sendRequest() baru.

16-Februari-2022 Wearable Support Library v2.9.0

Wearable Support Library versi 2.9.0 menghentikan semua class yang tersisa. Gunakan library Jetpack Wear OS sebagai gantinya.

29-Oktober-2021 Library Jetpack Wear OS

Library Jetpack Wear OS adalah pengganti Wearable Support Library, dan tidak didesain untuk digunakan bersama. Wearable Support Library tidak berfungsi di Wear OS 3.

27-April-2021 Wearable SDK 17.1.0

Wearable SDK versi 17.1.0 menyertakan update API minor untuk mendukung rilis Wearable Support Library berikutnya.

28-September-2020 Wearable Support Library v2.8.1

Versi 2.8.1 Wearable Support Library menyertakan perubahan berikut.

Mengizinkan penonaktifan Jetifier saat menggunakan template Tampilan Jam

Template Tampilan Jam Android Studio kini menggunakan dependensi AndroidX untuk mengizinkan Jetifier dinonaktifkan. Perbaikan ini berlaku saat menggunakan template Tampilan Jam dengan Android Studio 4.2 atau yang lebih tinggi.

24-September-2020 Wearable Support Library v2.8.0

Versi 2.8.0 Wearable Support Library menyertakan perubahan berikut.

Kemampuan penggantian untuk menentukan penyedia detail non-sistem default

Tampilan jam kini dapat menggunakan setDefaultComplicationProviderWithFallbacks untuk menentukan satu atau beberapa penyedia detail non-sistem yang digunakan secara default. Jika tidak menginstal penyedia non-sistem yang ditentukan, sistem akan menggunakan kembali penyedia sistem default.

WearableActivity tidak digunakan lagi

WearableActivity tidak digunakan lagi. Sebagai gantinya, gunakan AmbientModeSupport.

SKIP_CONFIRMATION_UI tidak digunakan lagi

ActionConfirmationActivity.SKIP_CONFIRMATION_UI tidak digunakan lagi. Tambahan ini tidak digunakan sejak rilis Wear 2.0.

15-Mei-2020 Wearable Support Library v2.7.0

Versi 2.7.0 Wearable Support Library menyertakan fitur berikut.

Akselerasi hardware untuk tampilan jam

Anda kini dapat meminta kanvas dengan akselerasi hardware saat menggunakan class CanvasWatchFaceService. Manfaatkan akselerasi hardware untuk meningkatkan performa tampilan jam Anda dan untuk mengakses data performa UI.

Untuk informasi lebih lanjut, lihat Meningkatkan performa tampilan jam dengan akselerasi hardware.

21-April-2020 Wearable Support Library v2.6.0

Versi 2.6.0 Wearable Support Library menyertakan peningkatan berikut.

Migrasi ke Android Jetpack

Wearable Support Library telah dimigrasikan ke Android Jetpack. Library yang ada kini dipetakan dan dapat diakses di AndroidX menggunakan namespace androidx, dan semua dependensi di Support Library yang tidak digunakan lagi telah dihapus.

Perubahan ini juga memungkinkan Anda menggunakan Wearable Support Library di Android Studio 4.0 dan yang lebih baru, yang menyelesaikan masalah seperti masalah #147972079.

28-Agustus-2019 Wearable Support Library v2.5.0

Versi 2.5.0 Wearable Support Library menyertakan peningkatan berikut.

Perbaikan untuk ComplicationDrawable saat startActivity() dipanggil dengan jenis detail TYPE_NO_PERMISSION

ComplicationDrawable kini menyertakan flag NEW_TASK yang memastikan bahwa panggilan startActivity() yang berasal dari WatchFaceService mencakup FLAG_ACTIVITY_NEW_TASK untuk menghindari android.util.AndroidRuntimeException.

Perubahan ini memungkinkan jenis detail TYPE_NO_PERMISSION meluncurkan aktivitas permintaan izin dengan benar, bukan membuat tampilan jam mengalami error.

25-September-2018 Wearable SDK 16.0.0

Wearable SDK versi 16.0.0 menurunkan versi layanan Google Play yang diperlukan dari versi 12.4 ke versi 8.6. Perubahan ini memungkinkan aplikasi yang ada diupdate ke versi terbaru Wearable SDK tanpa memerlukan update pada APK layanan Google Play.

11-Juni-2018 Update ke Pratinjau Developer 2 Wear OS

Update over-the-air terbaru ke Pratinjau Developer 2 Wear OS telah mengaktifkan kembali alarm dan tugas untuk aplikasi latar belakang.

Meskipun perubahan kebijakan ini mendukung peningkatan fleksibilitas dalam pengembangan aplikasi, alarm dan tugas latar belakang tetap tunduk pada pembatasan Android P lainnya, termasuk yang berkaitan dengan Bucket Aplikasi Standby. Ikuti praktik terbaik untuk memastikan aplikasi Anda berperilaku dengan baik, di bucket mana pun tempat aplikasi berada.

Update ini juga memperkuat input pengguna dan privasi data dengan membatasi akses aplikasi latar belakang ke input pengguna dan data sensor. Bergantung pada persyaratan aplikasi, Anda mungkin perlu menggunakan layanan latar depan untuk mengaktifkan akses terus-menerus ke data sensor.

8-Mei-2018 Pratinjau Developer 2 Wear OS

Pratinjau Developer 2 Wear OS memiliki fitur seperti pengalaman Asisten Google yang ditingkatkan.

Kirimkan bug atau masukan menggunakan Issue Tracker Wear OS by Google. Semakin awal Anda mengirimkannya, semakin tinggi kemungkinan perbaikan tersebut disertakan dalam rilis final.

Masalah umum

Bagian ini memuat masalah umum untuk rilis Pratinjau 2.

Masalah Wear OS image

  • Jika Anda sedang membuka aplikasi apa pun dan menekan tombol daya pada sisi smartwatch, Anda mungkin akan kembali ke layar sebelumnya, bukan ke tampilan jam.

Masalah Wear OS for China image

  • Jika Anda sedang membuka aplikasi apa pun dan menekan tombol daya pada sisi smartwatch, Anda mungkin akan kembali ke layar sebelumnya, bukan ke tampilan jam.
  • Setelan suara terkait volume akan berubah. Misalnya, panggilan masuk mengakibatkan dering berbunyi pada smartwatch, meski suara pada smartwatch dinonaktifkan. Dan jika Anda menyesuaikan Volume Alarm, perubahan tersebut tidak akan berpengaruh.
  • Beberapa notifikasi yang sedang berlangsung mungkin tidak ditampilkan dengan benar. Misalnya, jika timer dan stopwatch disetel, notifikasi tidak akan ditampilkan. Sebaiknya Anda menguji aplikasi dengan satu notifikasi yang sedang berlangsung, bukan dengan lebih dari satu.
  • App store Wear dalam versi China tidak berfungsi. Developer tidak dapat mengupdate atau menginstal aplikasi baru menggunakan saluran tersebut. Sebaiknya gunakan `adb` sebagai solusi untuk melakukan sideload pada aplikasi Anda untuk pengujian.

Masalah emulator Wear

  • Panggilan telepon yang masuk ke ponsel pendamping tidak ditampilkan, atau _mirrored_, sebagai panggilan masuk di emulator yang disambungkan.
  • Jika Anda menggunakan SDK Manager untuk menginstal atau mengonfirmasi bahwa Anda memiliki penginstalan Android P atau versi China terbaru, kotak centang di samping pilihan tersebut dapat menjadi tidak dipilih setelah Anda memilihnya. Jika menjadi tidak dipilih, pilih untuk kedua kalinya.
  • Jika emulator melakukan cold boot, error berikut mungkin akan ditampilkan: "Ada masalah internal pada perangkat Anda. Hubungi produsen untuk mengetahui detailnya". Ini tidak memengaruhi fungsi. Scroll ke bawah dan klik OK untuk mulai menguji aplikasi Anda.
  • Balasan suara mungkin tidak berfungsi di emulator. Misalnya, jika Anda menerima notifikasi untuk pesan Google Hangouts di emulator Wear dan Anda mencoba membalas pesan dengan suara, pesan error "Google terus berhenti" akan muncul dan Anda tidak dapat membalas dengan suara.
  • Instant Run mungkin tidak kompatibel dengan emulator Wear.
  • Mengambil screenshot secara terprogram, seperti menggunakan `adb` atau dengan mengambil laporan bug, mungkin tidak berfungsi. Sebagai solusi, klik tombol kamera di toolbar emulator untuk mengambil screenshot.

Masalah emulator Wear versi China

  • Panggilan telepon yang masuk ke ponsel pendamping mungkin tidak ditampilkan, atau _mirrored_, sebagai panggilan masuk di emulator yang disambungkan. Oleh karena itu, notifikasi panggilan tak terjawab mungkin tidak ditampilkan di emulator. Selain itu, Anda mungkin tidak dapat menjawab panggilan dari emulator karena panggilan akan terus berdering.
  • Jika Anda menggunakan SDK Manager untuk menginstal atau mengonfirmasi bahwa Anda memiliki penginstalan Android P atau versi China terbaru, kotak centang di samping pilihan tersebut dapat menjadi tidak dipilih setelah Anda memilihnya. Jika menjadi tidak dipilih, pilih untuk kedua kalinya.
  • Jika emulator melakukan cold boot, error berikut mungkin muncul: "Ada masalah internal pada perangkat Anda. Hubungi produsen untuk mengetahui detailnya". Ini tidak memengaruhi fungsi. Scroll ke bawah dan klik OK untuk mulai menguji aplikasi Anda.
  • Instant Run mungkin tidak kompatibel dengan emulator Wear.
  • Mengambil screenshot secara terprogram, seperti menggunakan `adb` atau dengan mengambil laporan bug, mungkin tidak berfungsi. Sebagai solusi, klik tombol kamera di toolbar emulator untuk mengambil screenshot.

Asisten Google di Wear

Dukungan yang ditingkatkan untuk Asisten di Wear OS memungkinkan Anda membangun pengalaman wearable tanpa perlu menulis kode Android. Khususnya, Anda dapat mem-build untuk platform Actions on Google, yang membantu pengguna menyelesaikan berbagai hal dengan produk dan layanan Anda.

Selain itu, Wear OS kini mendukung interaksi yang lebih cepat dengan suara dan sentuhan. Chip saran juga didukung. Mereka melakukan hal berikut:

  • Membantu pengguna melakukan interaksi dengan cepat
  • Memberikan petunjuk tentang kemampuan Actions Anda kepada pengguna

Selain itu, Wear OS kini mendukung lebih banyak kartu visual, serta daftar dan carousel.

Dengan demikian, Anda dapat menggunakan DialogFlow, template, atau Actions SDK guna membuat Actions on Google untuk Wear OS. Anda juga dapat memanfaatkan template respons baru yang khusus untuk smartwatch. Praktik terbaik untuk Actions on Google mencakup:

  • Dialog pendek dan ringkas
  • Memungkinkan masukan visual dan suara

Peningkatan untuk Asisten di Wear OS tidak bergantung pada Android P dan akan diluncurkan untuk semua pengguna Wear 2.0. Untuk pengantar dalam mem-build Actions on Google, lihat Mengintegrasikan dengan Asisten Google.

Hemat Baterai di Pratinjau Developer 2

Seperti yang dijelaskan di bagian berikut, fitur terkait daya tersedia untuk meningkatkan masa pakai baterai. Informasi di bagian Pratinjau Developer 2 ini akan menggantikan informasi terkait daya untuk Pratinjau Developer 1.

Mode baru: Penghemat baterai yang ditingkatkan

Selagi smartwatch berada dalam mode penghemat baterai yang ditingkatkan, tampilan jam dengan pengoptimalan daya default akan ditampilkan. Semua hal berikut dinonaktifkan:

  • Radio
  • Layar sentuh
  • Fitur miringkan untuk mengaktifkan

Pengguna dapat melihat waktu dengan menekan singkat tombol samping. Menekan lama akan memungkinkan pengguna kembali ke mode operasional penuh dan melakukan berbagai tugas, seperti membayar dengan NFC atau membalas pesan. Asumsikan bahwa aplikasi, tampilan jam, dan penyedia data detail tidak tersedia di mode penghemat baterai yang ditingkatkan.

Aktivitas latar belakang terbatas

Untuk meningkatkan pengelolaan daya, aplikasi di latar belakang tidak dapat lagi memulai alarm dan tugas kecuali jika smartwatch sedang mengisi daya. Pengecualiannya antara lain tampilan jam dan detail aktif.

Catatan: Jika aplikasi Anda harus selalu berjalan, misalnya untuk pemantauan latar belakang, sebaiknya gunakan layanan latar depan dengan menggunakan metode startForegroundService(). Lihat Batasan layanan latar belakang untuk mengetahui detail selengkapnya. Penggunaan layanan latar depan sesuai untuk kasus penggunaan pengecualian seperti pemantauan kesehatan.

Kompatibilitas aplikasi yang ditingkatkan

Untuk meningkatkan kompatibilitas aplikasi, Android P mulai mengimplementasikan pembatasan tertentu pada penggunaan antarmuka non-SDK. Membuat rencana untuk bermigrasi dari metode dan kolom non-SDK. Jika tidak ada padanan publik yang tersedia untuk kasus penggunaan Anda, beri tahu kami.

Tema sistem UI gelap

Sejak awal 2018, Wear OS telah beralih ke tema UI default yang memiliki latar belakang lebih gelap untuk deretan notifikasi dan peluncur sistem. Perubahan ini dimaksudkan untuk meningkatkan keterlihatan aplikasi; periksa aksesibilitas aplikasi dengan tema UI yang baru.

Codelab yang diperbarui tersedia

Guna membantu Anda mempelajari berbagai cara penting untuk melakukan pengembangan dengan Wear OS, tersedia codelab yang telah diupdate. Misalnya, coba codelab tampilan jam berbasis Kotlin yang baru untuk bereksperimen dengan bahasa khusus domain Kotlin, atau DSL.

27-Maret-2018 Pratinjau Developer 1 Wear OS

Bagian ini berisi informasi tentang Pratinjau Developer 1 dari Wear OS by Google. Beberapa update pada pratinjau ini diharapkan sebelum rilis produksi final. Kirimkan bug yang Anda temukan menggunakan Issue Tracker Wear OS by Google. Semakin awal Anda mengirimkannya, semakin tinggi kemungkinan kami dapat menyertakan perbaikan dalam rilis final.

Masalah umum

  • Di aplikasi pendamping Wear OS, fitur mengetuk Laporkan bug wearable tampaknya akan berfungsi, tetapi tidak ada laporan bug yang akan benar-benar dibuat. Gunakan adb bugreport sebagai solusi.
  • Menerima panggilan telepon dengan menggunakan jam tangan tidak selalu berhasil. Jika tidak berhasil, pengguna perlu menerima panggilan dari ponsel secara langsung.
  • Error "Masalah yang terdeteksi dengan kompatibilitas API" terkadang muncul setelah menyambungkan atau meluncurkan aplikasi yang dimuat sebelumnya. Pesan error tersebut menghilang setelah beberapa saat dan tidak memengaruhi kegunaan.
  • Di menu Setelan pada smartwatch dan di emulator, opsi Ambil laporan bug akan ditampilkan dua kali. Untuk mengambil laporan bug, coba gunakan kedua opsi satu per satu, karena hanya satu yang berfungsi. Saat Anda mengetuk opsi yang berfungsi, toast akan ditampilkan, yang menunjukkan bahwa laporan bug sedang dibuat.
  • Dalam versi China, input suara menyebabkan aplikasi menjadi tidak bekerja. Misalnya, hal ini terjadi pada penelusuran suara atau saat Anda menggunakan suara untuk menambahkan pengingat karena fungsi ini menggunakan API input suara. Untuk pengujian, gunakan input keyboard atau tulisan tangan, bukan input suara.
  • App store Wear dalam versi China tidak berfungsi. Developer tidak dapat mengupdate atau menginstal aplikasi baru menggunakan saluran tersebut. Sebaiknya gunakan `adb` sebagai solusi untuk melakukan sideload aplikasi Anda untuk pengujian.

Fitur unggulan dalam pratinjau developer ini

Pratinjau Developer 1 menyertakan fitur berikut untuk pengujian aplikasi:

  • Aktivitas latar belakang terbatas: Untuk meningkatkan pengelolaan daya, aplikasi di latar belakang tidak dapat lagi menggunakan alarm dan tugas. Pengecualiannya mencakup tampilan jam dan detail yang dipilih pengguna. Fitur ini akan diluncurkan secara bertahap dalam pratinjau developer, jadi Anda mungkin tidak langsung melihatnya di smartwatch.

    Catatan: Jika aplikasi Anda harus selalu berjalan, ubah aplikasi tersebut untuk menjadikannya layanan latar depan menggunakan metode startForegroundService(). Lihat Pembatasan layanan latar belakang untuk mengetahui detail lebih lanjut.

  • Pembatasan penggunaan antarmuka non-SDK oleh aplikasi: Untuk meningkatkan kompatibilitas aplikasi, Android P mulai mengimplementasikan pembatasan tertentu pada penggunaan antarmuka non-SDK. Membuat rencana untuk bermigrasi dari metode dan kolom non-SDK. Jika tidak ada padanan publik yang tersedia untuk kasus penggunaan Anda, beri tahu kami.
  • Tema sistem UI gelap: Sejak awal tahun 2018, Wear OS telah beralih ke tema UI default yang memiliki latar belakang lebih gelap untuk aliran notifikasi dan peluncur sistem. Perubahan ini dimaksudkan untuk meningkatkan keterlihatan aplikasi; periksa aksesibilitas aplikasi Anda dengan tema UI yang baru ini.
  • Radio nonaktif saat smartwatch tidak digunakan: Untuk meningkatkan pengelolaan daya, radio Bluetooth, radio Wi-Fi, dan radio seluler dinonaktifkan jika smartwatch terdeteksi dilepaskan dari tubuh dalam waktu yang lama. Fitur ini akan diluncurkan secara bertahap dalam pratinjau developer, jadi Anda mungkin tidak langsung melihatnya di smartwatch. Jika fitur ini menyebabkan kendala dalam proses pengembangan, Anda dapat menonaktifkan fitur menggunakan `adb` menggunakan perintah berikut:
    adb shell settings put global off_body_radios_off_for_small_battery_enabled 0
  • Wi-Fi dinonaktifkan saat Bluetooth terputus: Untuk meningkatkan pengelolaan daya, smartwatch tidak lagi otomatis terhubung ke Wi-Fi jika koneksi smartwatch terputus dari Bluetooth. Pengecualiannya mencakup kasus aplikasi yang meminta jaringan bandwidth tinggi, dan kasus smartwatch yang dipasang ke pengisi daya. Fitur ini akan diluncurkan secara bertahap dalam pratinjau developer, jadi Anda mungkin tidak langsung melihatnya di smartwatch.

Update untuk Wearable Support Library, v2.3.0

Update dokumentasi v2.3.0 untuk Wearable Support Library mencakup update rebranding.

Selain itu, library v2.3.0 menyertakan update yang terkait dengan ComplicationDrawable dan TextRenderer untuk teks yang memiliki objek markup yang dilampirkan ke rentang teks. Class ini telah meningkatkan penanganan teks dibentangkan. Hanya subset span tertentu yang dapat dirender—lihat metode setText untuk jenis span yang dapat digambar—sehingga span tidak terlihat tidak pada tempatnya saat dirender dalam tampilan jam.

15-Maret-2018 Rebranding Wear

Bagian ini berisi informasi tentang fitur Wear OS.

Nama baru untuk Android Wear

Android Wear diganti namanya menjadi Wear OS by Google.

27-Feb-2018 Update mode standby

Bagian ini berisi informasi tentang fitur baru Android Wear.

Class baru untuk mendukung mode standby

Versi 27.1.0 Android Support Library berisi class baru, AmbientModeSupport, yang menggantikan class AmbientMode yang kini tidak digunakan lagi. Update untuk sampel direncanakan dalam beberapa minggu mendatang.

25-Jan-2018 Emulator final dan lainnya

Bagian ini berisi informasi tentang fitur baru Android Wear.

Emulator Android: Update untuk Wear

Update final terkait Wear untuk Android Emulator tersedia untuk pengujian aplikasi berbasis API versi 26.

Peningkatan di Wearable Support Library, v2.2.0

Versi 2.2.0 Wearable Support Library menyertakan update yang dijelaskan di bawah ini.

Indikator notifikasi belum dibaca yang baru

Karena pengguna ingin mengetahui notifikasi yang belum dibaca, indikator baru disediakan: titik lingkaran di bagian bawah tampilan jam. Jika memilih untuk mengelola notifikasi sendiri, Anda dapat menggunakan setHideNotificationIndicator untuk menyembunyikan indikator default dan menampilkan indikator Anda sendiri atau setShowUnreadCountIndicator untuk menampilkan jumlah notifikasi dalam status bar.

Sesuaikan warna cincin luar indikator notifikasi yang belum dibaca dengan metode setAccentColor.

Catatan: Indikator notifikasi belum dibaca tidak diaktifkan pada versi produksi Wear 2.8.0. Uji implementasi Anda menggunakan emulator Wear terbaru. Dimulai dengan rilis konsumen berikutnya untuk Wear (versi 2.9.0), indikator notifikasi yang belum dibaca akan ditampilkan secara default.

Peningkatan untuk class ComplicationDrawable

Class ComplicationDrawable memulai permintaan izin untuk tampilan jam yang diketuk saat sistem menunjukkan nilai TYPE_NO_PERMISSION, yang menunjukkan bahwa tampilan jam tidak memiliki izin untuk mendapatkan data detail.

Selain itu, class ComplicationDrawable membatalkan validasinya sendiri setelah selesai memuat gambar atau saat tanda ketuk telah habis masa berlakunya. Untuk merespons pembatalan validasi ini—seperti untuk menggambar ulang tampilan jam—tambahkan Drawable.Callback.

Masalah umum

  • Jika Anda mengaktifkan Mode redup di emulator, seperti dijelaskan dalam Mengubah setelan layar & kecerahan, emulator dapat tetap macet dalam Mode redup. Perbaikan masalah mengharuskan pengosongan data emulator; lihat Menjalankan dan menghentikan emulator serta menghapus data.
  • Dalam jendela emulator untuk API level 25 atau 26, tombol daya tidak berfungsi. Gunakan tombol selain tombol daya. Khususnya, untuk beralih ke mode standby—misalnya, seolah-olah pengguna menutupi layar dengan telapak tangan—gunakan tombol daya pada toolbar emulator di sebelah kanan tampilan. Untuk memulai peluncur aplikasi dalam mode interaktif, gunakan tombol Layar utama pada toolbar emulator.
  • Di emulator versi China, jika Anda menggunakan metode input tulisan tangan, layar dapat mulai berkedip. Kemudian, jika Anda mengklik tombol untuk keyboard di layar, keyboard akan memblokir separuh layar.

18-Des-2017 Akses baru ke layanan Google Play

Bagian ini berisi informasi tentang fitur baru Android Wear.

Migrasi dari class GoogleApiClient

Mulai layanan Google Play versi 11.8.0, migrasikan aplikasi Wear Anda dari class GoogleApiClient dan gunakan objek klien API yang didasarkan pada class GoogleApi dan Tasks API.

Catatan: Update ini tidak berlaku untuk aplikasi Android Wear versi China, yang umumnya menggunakan layanan Google Play versi 10.2.0.

Untuk informasi selengkapnya, lihat referensi berikut:

New components for connecting with Google Play services

When you use classes that extend the GoogleApi class, such as DataClient and MessageClient, the Google Play services SDK manages connections to Google Play services for you. Apps that use these classes no longer need to create and manage GoogleApiClient objects. See the blog post Moving Past GoogleApiClient for more information.

For the replacements of Wear-related components for connecting to Google Play services, see Replacements for deprecated components. For releases and known issues related to Google Play services, see the Release Notes for Google Play services.

Note: If you compile your app with the latest version of Google Play services, users are prompted to update their devices to that latest version. However, a known issue for apps that target API version 26 might prevent users from being prompted to update their devices. This issue is described in the Release Notes for Google Play services.

2017-Oct-25 Ambient mode and more

This section contains information about new Android Wear features.

Android Support Library, v27.0.0: Features and bugfixes

The 27.0.0 version of the Android Support Library contains new features for Wear. Review the following section.

New, preferred way to support ambient mode

Ambient mode lets a Wear app remain visible to a user when the device goes idle. The Android Support Library has a new, preferred way for your apps to use ambient mode. The Wear team seeks developer feedback about this significant change.

Specifically, using the AmbientMode class offers the following benefits:

Manifest metadata constants in the Android Support Library

Constants for Android Wear apps, used in the meta-data tag in the Android Manifest file, are now available in the Android Support Library. To use the constants—for standalone apps, notification bridging mode, and watch face preview images—add a reference to the following in the dependencies section of the app module's build.gradle file, which requires the latest version of the Google Repository:

Groovy

implementation 'com.android.support:wear:27.0.0'

Kotlin

implementation("com.android.support:wear:27.0.0")

Action drawer updates

Updates are available to the WearableActionDrawerView class, which is used for creating a wearable action drawer. In the latest version:

  • When menu items are modified, the action drawer properly updates.
  • If set for an action drawer, the title displays correctly.

Inflation of the RoundedDrawable class

Assuming an API level of at least 24, the RoundedDrawable class can now be inflated from a drawable XML file; see Custom drawables.

Wearable Support Library, v2.1.0: Enhancements and more

The 2.1.0 version of the Wearable Support Library includes the updates described in the following section, and requires Android Support Library version 26.0.2 or higher.

Supply burn-in-safe images for ambient mode

The ComplicationDrawable class lets you supply burn-in-safe images for ambient mode. Specifically, a ComplicationData object's burn-in protection small image field lets a watch face display a small image in the SMALL_IMAGE complication type, in ambient mode, when burn-in protection is enabled.

Tap event updates for complications

The ComplicationDrawable class has a new onTap method that lets your watch face pass tap events to complications. The new method builds on the existing functionality in which a tap on the watch face triggers the WatchFaceService.Engine.onTapCommand method.

You can pass the coordinates to a ComplicationDrawable with an onTap call to launch the action associated with the ComplicationDrawable that contains the tap coordinates. When the new onTap method is called, you can use a return value of true to see whether a ComplicationDrawable launched the action associated with it.

Additionally, the setHighlightDuration method sets the duration for a complication to remain highlighted after the onTap method is called.

Progress bar for ranged value complications

If you prefer to draw your own progress bar for ranged value complications in your watch face, use the setRangedValueProgressHidden method of the ComplicationDrawable class to hide the ranged value progress that's drawn by the ComplicationDrawable.

2017-Oct-02 Android Wear beta

Date: 2017-Oct-02
Build: OWP4.170828.008
Supported device: LG Watch Sport

This section contains known issues for an Android Wear beta release. For information about the beta program or to enroll, see the Android beta page.

Known issues

  • Google Pay and its cards do not function with this Android Wear beta release.
  • Even if cellular connectivity is on, it is turned off after the beta is installed. As a workaround, turn on cellular connectivity after the beta is installed by navigating to Settings > Connectivity > Cellular.
  • If notifications are erratic or missing after a beta update, or contacts were not synced, factory-reset your watch.
  • In the Wear tutorial, which starts after a watch is set up, some cards behave erratically, but they can be dismissed normally with a swipe.
  • On Android 6.0 phones, phone call notifications are not received on the watch.
  • Heart rate monitoring sometimes fails after an update. As a workaround, reboot the watch.
  • The OTA card in the stream sometimes fails to enable an installation. As a workaround, navigate to Settings > System > About > System Updates.