Catatan rilis Wear OS

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

21-November-2024 Wearable SDK 19.0.0

Wearable SDK versi 19.0.0 menyertakan update SDK minor. Update meliputi:

  • Memperbarui dependensi library ke versi terbaru.
  • Menghapus varian sendMessage() API yang tidak didukung yang menyertakan parameter MessageOptions.

31-Agustus-2023 Wearable SDK 18.1.0

Wearable SDK versi 18.1.0 menyertakan update API minor 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 API minor 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

Versi 2.9.0 Wearable Support Library menghentikan penggunaan class yang lain. 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.

Penonaktifan izin Jetifier saat menggunakan template Tampilan Jam

Template Tampilan Jam Android Studio kini menggunakan dependensi AndroidX untuk mengizinkan penonaktifan Jetifier. 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 pada Support Library yang tidak digunakan lagi telah dihapus.

Perubahan ini juga memungkinkan Anda menggunakan library Dukungan Wearable di Android Studio 4.0 dan lebih tinggi, 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 tanda NEW_TASK yang memastikan bahwa panggilan startActivity() yang berasal dari WatchFaceService mencakup FLAG_ACTIVITY_NEW_TASK untuk menghindari android.util.AndroidRuntimeException.

Perubahan ini memungkinkan TYPE_NO_PERMISSION jenis detail meluncurkan aktivitas permintaan izin dengan benar dan tidak menyebabkan error pada tampilan jam.

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.

Meski perubahan kebijakan ini mendukung peningkatan fleksibilitas dalam pengembangan aplikasi, tugas dan alarm latar belakang tetap tunduk pada pembatasan Android P lainnya, termasuk yang berkaitan dengan Bucket Aplikasi Standby. Ikuti praktik terbaik guna memastikan aplikasi Anda berfungsi dengan baik, di bucket mana pun aplikasi tersebut 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 secara 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 apa pun menggunakan issue tracker Wear OS by Google. Semakin awal Anda mengirimkannya, semakin tinggi kemungkinan perbaikan 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 berkelanjutan mungkin tidak ditampilkan dengan benar. Misalnya, jika timer dan stopwatch disetel bersamaan, notifikasi tidak akan ditampilkan. Sebaiknya uji aplikasi dengan hanya satu notifikasi berkelanjutan, bukan beberapa notifikasi.
  • 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 untuk pengujian.

Masalah emulator Wear

  • Panggilan masuk ke ponsel pendamping tidak ditampilkan, atau _dicerminkan_, sebagai panggilan masuk di emulator yang disambungkan.
  • Saat Anda menggunakan SDK manager untuk menginstal atau mengonfirmasi bahwa Anda sudah menginstal Android P atau versi China terbaru, kotak centang di sebelah pilihan tersebut dapat dibatalkan pilihannya setelah Anda memilihnya. Jika pilihan dibatalkan, pilih untuk kedua kalinya.
  • Jika emulator melakukan cold boot, error berikut mungkin akan ditampilkan: "There's an internal problem with your device. Contact the manufacturer for details." Hal 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 pada emulator Wear dan Anda mencoba membalas pesan tersebut dengan suara, pesan error "Google keeps stopping" akan muncul dan Anda tidak dapat membalas dengan suara.
  • Instant Run mungkin tidak kompatibel dengan emulator Wear.
  • Pengambilan screenshot lewat program, seperti menggunakan `adb` atau melalui laporan bug, mungkin tidak berfungsi. Sebagai solusi, klik tombol kamera di toolbar emulator untuk mengambil screenshot.

Masalah emulator Wear versi China

  • Panggilan masuk ke ponsel pendamping mungkin tidak ditampilkan, atau _dicerminkan_, 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, sehingga panggilan terus berdering.
  • Saat Anda menggunakan SDK manager untuk menginstal atau mengonfirmasi bahwa Anda sudah menginstal Android P atau versi China terbaru, kotak centang di sebelah pilihan tersebut dapat dibatalkan pilihannya setelah Anda memilihnya. Jika pilihan dibatalkan, pilih untuk kedua kalinya.
  • Jika emulator melakukan cold boot, error berikut mungkin menampilkan: "There's an internal problem with your device. Contact the manufacturer for details." Hal ini tidak memengaruhi fungsi. Scroll ke bawah dan klik OK untuk mulai menguji aplikasi Anda.
  • Instant Run mungkin tidak kompatibel dengan emulator Wear.
  • Pengambilan screenshot lewat program, seperti menggunakan `adb` atau melalui 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 yang didukung perangkat wearable tanpa perlu menulis kode Android. Khususnya, Anda dapat membangun 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. Chip saran 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 spesifik 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 membangun 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 dalam bagian Pratinjau Developer 2 ini menggantikan informasi terkait daya untuk Pratinjau Developer 1.

Mode baru: Penghemat baterai yang ditingkatkan

Saat 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 beralih kembali ke mode operasional penuh dan melakukan tugas, seperti membayar dengan NFC atau membalas pesan. Asumsikan bahwa aplikasi, tampilan jam, dan penyedia data detail tidak tersedia dalam mode penghemat baterai yang ditingkatkan.

Aktivitas latar belakang terbatas

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

Catatan: Jika aplikasi harus selalu dijalankan, seperti 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

Agar meningkatkan kompatibilitas aplikasi, Android P mulai mengimplementasikan pembatasan tertentu pada penggunaan antarmuka non-SDK. Buat rencana untuk migrasi 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 tampilan aplikasi; periksa aksesibilitas aplikasi dengan tema UI yang baru ini.

Codelab yang diperbarui tersedia

Guna membantu Anda mempelajari berbagai cara penting untuk melakukan pengembangan dengan Wear OS, tersedia codelab yang telah diperbarui. Misalnya, coba codelab tampilan jam berbasis Kotlin 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 untuk pratinjau ini diperkirakan sebelum rilis produksi final. Kirimkan bug apa pun 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, mengetuk Laporkan bug wearable akan tampak berfungsi, tetapi tidak ada laporan bug yang dibuat. Gunakan adb bugreport sebagai solusi.
  • Menerima panggilan telepon menggunakan smartwatch tidak selalu berhasil. Jika tidak berhasil, pengguna harus menerima panggilan dari ponsel secara langsung.
  • Error "Detected problems with API compatibility" terkadang muncul setelah menyambungkan atau meluncurkan aplikasi yang dipramuat. Pesan error tersebut menghilang setelah beberapa saat dan tidak memengaruhi kegunaan.
  • Di menu Setelan smartwatch dan emulator, opsi Buat laporan bug ditampilkan dua kali. Untuk membuat laporan bug, coba gunakan kedua opsi satu per satu, karena hanya satu yang berfungsi. Jika Anda mengetuk opsi yang berfungsi, toast akan ditampilkan, yang menunjukkan bahwa laporan bug sedang dibuat.
  • Dalam versi China, input suara menyebabkan aplikasi tidak bekerja. Misalnya, hal ini terjadi saat menggunakan 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 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. Pengecualian 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 menjadi layanan latar depan menggunakan metode startForegroundService(). Lihat Pembatasan layanan latar belakang untuk mengetahui detail lebih lanjut.

  • Pembatasan penggunaan aplikasi antarmuka non-SDK: Untuk meningkatkan kompatibilitas aplikasi, Android P mulai mengimplementasikan batasan tertentu pada penggunaan antarmuka non-SDK. Buat rencana untuk migrasi 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 tampilan aplikasi; periksa aksesibilitas aplikasi dengan tema UI yang baru ini.
  • Radio dinonaktifkan 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` dengan menggunakan perintah berikut:
    adb shell settings put global off_body_radios_off_for_small_battery_enabled 0
  • Wi-Fi dinonaktifkan saat Bluetooth tidak terhubung: Untuk meningkatkan pengelolaan daya, smartwatch tidak lagi otomatis terhubung ke Wi-Fi jika smartwatch terputus dari Bluetooth. Pengecualian mencakup kasus aplikasi yang meminta jaringan bandwidth tinggi, dan jika smartwatch terpasang 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, v2.3.0 library mencakup update yang terkait dengan ComplicationDrawable dan TextRenderer untuk teks yang memiliki objek markup yang dilampirkan ke rentang teks. Semua class ini telah meningkatkan penanganan teks spanned. Hanya subset span tertentu yang dapat dirender—lihat metode setText untuk jenis span yang dapat digambar—sehingga span tidak terlihat berantakan jika 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.

Android Emulator: 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, maka disediakan indikator baru: titik yang dilingkari di bagian bawah tampilan jam. Jika Anda memilih untuk mengelola notifikasi sendiri, Anda dapat menggunakan setHideNotificationIndicator untuk menyembunyikan indikator default dan menampilkan indikator Anda sendiri atau setShowUnreadCountIndicator untuk menampilkan jumlah notifikasi di status bar.

Sesuaikan warna luar cincin indikator notifikasi 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 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—misalnya untuk menggambar ulang tampilan jam—tambahkan Drawable.Callback.

Masalah umum

  • Jika Anda mengaktifkan mode Redup di emulator, seperti yang dijelaskan di Mengubah setelan layar & kecerahan, emulator dapat terhenti pada mode Redup. Perbaikan masalah mengharuskan pengosongan data emulator; lihat Menjalankan dan menghentikan emulator, serta menghapus data.
  • Dalam jendela emulator untuk level API 25 atau 26, tombol daya tidak berfungsi. Sebagai gantinya, gunakan tombol selain tombol daya. Khususnya, untuk beralih ke mode standby—misalnya, seolah-olah pengguna menutupi layar dengan telapak tangan—gunakan tombol daya di toolbar emulator di sebelah kanan tampilan. Untuk memulai peluncur aplikasi di mode interaktif, gunakan tombol Beranda di 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 versi 11.8.0 layanan Google Play, migrasikan aplikasi Wear dari class GoogleApiClient dan gunakan objek klien API yang berdasarkan 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.