Note di rilascio di Wear OS

Questa pagina contiene informazioni sulle release per Wear OS, ad esempio l'SDK Wearable e Wearable Support Library.

SDK Wearable 18.1.0 2023-agosto-31

La versione 18.1.0 dell'SDK Wearable include aggiornamenti API minori per supportare le Release della libreria di supporto Wearable. Gli aggiornamenti includono:

  • Assistenza per il passaggio allo smartphone, vedi NodeClient.OnNodeMigratedListener per ulteriori informazioni.
  • Documentazione aggiuntiva per MessageClient inviare messaggi e rispondere.
  • Link aggiornati nelle descrizioni delle API.

SDK Wearable 18.0.0 2022-settembre-20

La versione 18.0.0 dell'SDK Wearable include aggiornamenti API minori per supportare le Release della libreria di supporto Wearable. Gli aggiornamenti includono:

  • Supporto di WearableListenerService per le app destinate ad Android 13; problema 235538840.
  • Nuovo metodo MessageClient.sendRequest().

Libreria di supporto per Wearable v2.9.0 del 16 febbraio 2022

La versione 2.9.0 di Wearable Support Library ritira tutte le classi rimanenti. Utilizzare le librerie Jetpack di Wear OS .

Libreria Wear OS Jetpack del 29 ottobre 2021

Le librerie Jetpack di Wear OS sono sostituzioni per le librerie di assistenza Wearable e non sono progettate per essere utilizzate in sinergia. La libreria di supporto per dispositivi indossabili non funziona su Wear OS 3.

SDK Wearable 17.1.0 2021-aprile-27

La versione 17.1.0 dell'SDK Wearable include aggiornamenti API minori per supportare le Release della libreria di supporto Wearable.

2020-settembre-28 Wearable Support Library v2.8.1

La versione 2.8.1 della libreria di supporto Wearable include la seguente modifica.

Consenti la disattivazione di Jetifier quando viene usato il modello per il quadrante

Il modello del quadrante di Android Studio ora utilizza le dipendenze di AndroidX per consentire Jetifier da disattivare. Queste correzioni si applicano quando si utilizza il modello del quadrante con Android Studio 4.2 o versioni successive.

Libreria di supporto per Wearable 2020-settembre-24 settembre v2.8.0

La versione 2.8.0 della libreria di supporto Wearable include le seguenti modifiche.

Funzionalità di riserva per specificare fornitori di complicazioni non di sistema predefiniti

I quadranti ora possono utilizzare setDefaultComplicationProviderWithFallbacks per specificare uno o più fornitori di complicazioni non di sistema da utilizzare per impostazione predefinita. Se nessuno di sono installati i provider non di sistema specificati, il sistema torna utilizzando il fornitore di sistema predefinito.

WearableActivity deprecato

WearableActivity è deprecato. Utilizza AmbientModeSupport .

SKIP_CONFIRMATION_UI deprecata

ActionConfirmationActivity.SKIP_CONFIRMATION_UI è deprecato. Questo extra non è più utilizzato dalla release di Wear 2.0.

Libreria di supporto per Wearable v2.7.0 del 15 maggio 2020

La versione 2.7.0 di Wearable Support Library include quanto segue: funzionalità.

Accuratezza hardware per i quadranti

Ora puoi richiedere un canvas con accelerazione hardware quando utilizzi il metodo CanvasWatchFaceService corso. Sfrutta l'accelerazione hardware per migliorare le prestazioni del quadrante e accedere a ulteriori prestazioni dell'interfaccia utente e i dati di Google Cloud.

Per ulteriori informazioni, consulta Migliorare le prestazioni del quadrante con l'hardware. dell'audiodescrizione.

Libreria di supporto per indossabili 2020-aprile-21 v2.6.0

La versione 2.6.0 di Wearable Support Library include quanto segue: miglioramento.

Migrazione ad Android Jetpack

È stata eseguita la migrazione della libreria di supporto Wearable ad Android Jetpack. Le librerie esistenti sono ora mappate e accessibili su AndroidX utilizzando lo spazio dei nomi androidx e tutte le dipendenze dall'assistenza deprecata La libreria ha rimosso.

Questa modifica ti consente anche di utilizzare le librerie di supporto degli indossabili in Android Studio 4.0 e versioni successive, che risolve problemi quali problema n. 147972079.

Libreria di supporto per Wearable v2.5.0 2019-agosto-28

La versione 2.5.0 di Wearable Support Library include quanto segue: miglioramento.

Correzione per ComplicationDrawable quando startActivity() viene chiamato con il tipo di complicazione TYPE_NO_PERMISSION

ComplicationDrawable ora include un flag NEW_TASK che garantisce che startActivity() chiami che provengono da una WatchFaceService includi FLAG_ACTIVITY_NEW_TASK per evitare android.util.AndroidRuntimeException.

Questa modifica consente a TYPE_NO_PERMISSION il tipo di complicazione avvia correttamente l'attività di richiesta di autorizzazione anziché l'arresto anomalo del quadrante.

SDK Wearable 16.0.0 2018-settembre-25

La versione 16.0.0 dell'SDK Wearable riduce la versione richiesta di Google Play Services dalla versione 12.4 alla versione 8.6. Questa modifica consente alle app esistenti di aggiornarsi alla versione più recente dell'app indossabile SDK senza richiedere un aggiornamento dell'APK Google Play Services.

Aggiornamento 2018-giugno-11 all'Anteprima per gli sviluppatori di Wear OS 2

Un recente over-the-air dell'Anteprima per gli sviluppatori di Wear OS 2. riattivati allarmi e job per le app in background.

Questa modifica alle norme supporta una maggiore flessibilità per lo sviluppo di app, per gli allarmi in background e le offerte di lavoro continuano a essere soggette ad altre limitazioni di Android P, incluse quelle relative alle Bucket standby dell'app. Segui per assicurarti che le tue app funzionino correttamente, indipendentemente dal bucket in cui si trovano le app.

Questo aggiornamento rafforza anche input degli utenti e privacy dei dati limitando l'accesso di un'app in background all'input degli utenti e dati dei sensori. A seconda dei requisiti di un'app, potresti dover usare un servizio in primo piano per consentire l'accesso continuo ai dati dei sensori.

Anteprima per gli sviluppatori di Wear OS 2018-8 maggio 2

L'Anteprima per gli sviluppatori di Wear OS 2 offre funzionalità quali un'esperienza con l'Assistente Google migliorata.

Invia eventuali bug o feedback utilizzando il Issue Tracker di Wear OS by Google. Prima le invii, più la probabilità che le correzioni siano incluse nella release finale.

Problemi noti

Questa sezione contiene i problemi noti per la versione di Anteprima 2.

Problemi con l'immagine Wear OS

  • Quando sei in un'app e premi il tasto di accensione sul lato dello smartwatch, potresti tornare alla precedente piuttosto che sul quadrante.

Problemi con l'immagine di Wear OS per la Cina

  • Quando sei in un'app e premi il tasto di accensione sul lato dello smartwatch, potresti tornare alla precedente piuttosto che sul quadrante.
  • Le impostazioni audio relative al volume non sono persistenti. Ad esempio, una chiamata in arrivo genera squilli udibili sullo smartwatch, se il suono dell'orologio è disattivato. Se regoli il volume della sveglia, la modifica non ha alcun effetto.
  • Più notifiche in corso potrebbero non essere visualizzate correttamente. Ad esempio, se sono impostati sia un timer che un cronometro, le notifiche non vengono visualizzate. Ti consigliamo di testare con una sola notifica attiva anziché con più notifiche.
  • Lo store Wear nella versione cinese non funzionano. Gli sviluppatori non possono aggiornare o installare nuove app che utilizzano questi elementi canale. Ti consigliamo di usare "adb" come soluzione alternativa per eseguire il sideload della tua applicazione per i test.

Problemi con l'emulatore Wear

  • Chiamata in arrivo a uno smartphone accoppiato non viene mostrato, o _mirrored_, come chiamata in arrivo nell'emulatore accoppiato.
  • Quando utilizzi Gestore SDK per installare o confermare di avere l'ultima versione l'installazione di Android P o della versione cinese, le caselle di controllo accanto le selezioni possono essere deselezionate dopo averle selezionate. Se deselezionato, seleziona una seconda volta.
  • Quando l'emulatore esegue un avvio a freddo, Potrebbe essere visualizzato il seguente messaggio di errore: "Si è verificato un problema interno dispositivo. Per informazioni dettagliate, contatta il produttore." Ciò non influisce funzionalità. Scorri verso il basso e fai clic su OK per iniziare a testare l'app.
  • La risposta vocale potrebbe non funzionare sull'emulatore. Ad esempio, se ricevi un per ricevere un messaggio di Google Hangouts sull'emulatore Wear e di rispondere al messaggio tramite comandi vocali, "Google continua a interrompersi" messaggio di errore e non ti è permesso rispondere tramite comandi vocali.
  • Instant Run potrebbe non essere compatibile con emulatore Wear.
  • L'acquisizione programmatica di uno screenshot, ad esempio l'uso di "adb" o la segnalazione di bug, potrebbe non funzionare. Come soluzione alternativa, fai clic sul pulsante della fotocamera sull'emulatore barra degli strumenti per acquisire uno screenshot.

Problemi con la versione cinese dell'emulatore Wear

  • Una telefonata in arrivo a uno smartphone accoppiato potrebbe non essere visualizzata oppure _mirrored_, come chiamata in arrivo nell'emulatore accoppiato. Di conseguenza, le notifiche delle chiamate senza risposta potrebbero non verrà mostrata nell'emulatore. Inoltre, potresti non essere in grado di rispondere a una dall'emulatore, nel qual caso la chiamata continua a squillare.
  • Quando utilizzi Gestore SDK per installare o confermare di avere l'ultima versione l'installazione di Android P o della versione cinese, le caselle di controllo accanto le selezioni possono essere deselezionate dopo averle selezionate. Se deselezionato, seleziona una seconda volta.
  • Quando l'emulatore esegue un avvio a freddo, potrebbe essere visualizzato il seguente messaggio di errore: "Si è verificato un problema interno dispositivo. Per informazioni dettagliate, contatta il produttore." Ciò non influisce funzionalità. Scorri verso il basso e fai clic su OK per iniziare a testare l'app.
  • Instant Run potrebbe non essere compatibile con emulatore Wear.
  • Acquisire uno screenshot in modo programmatico, ad esempio utilizzando "adb" o acquisire un segnalazione di bug, potrebbe non funzionare. Come soluzione alternativa, fai clic sul pulsante della fotocamera sull'emulatore barra degli strumenti per acquisire uno screenshot.

Assistente Google su Wear

Il supporto migliorato per l'assistente su Wear OS ti consente di creare compatibile con gli indossabili senza scrivere codice Android. In particolare, puoi sviluppare per la piattaforma Actions on Google, per aiutare i tuoi utenti a svolgere attività con i tuoi prodotti e servizi.

Inoltre, Wear OS ora supporta interazioni più rapide tramite comandi vocali e tocco. Sono supportati anche i chip di suggerimenti. Procedi nel seguente modo:

  • Aiuta gli utenti a completare rapidamente le interazioni
  • Fornisci agli utenti suggerimenti sulla capacità dell'azione

Inoltre, Wear OS ora supporta più schede visive, oltre a elenchi e caroselli.

Pertanto, puoi utilizzare DialogFlow, modelli o l'SDK Actions per creare Actions on Google per Wear OS. Puoi anche sfruttare le nuove modelli di risposta specifici per un orologio. Best practice per Azioni su Google include:

  • Finestra di dialogo breve e concisa
  • Attivazione del feedback visivo e vocale

Questi miglioramenti per l'assistente su Wear OS non dipendono da Android P. e verranno implementate per tutti gli utenti Wear 2.0. Per un'introduzione alla creazione Actions on Google, vedi Integrazione con l'Assistente Google.

Risparmio della batteria nello sviluppatore Anteprima 2

Come descritto nella sezione che segue, le funzionalità relative all'alimentazione sono disponibili per aumentare vita privata. Le informazioni contenute in questa sezione Anteprima per gli sviluppatori 2 sostituisce le informazioni relative all'alimentazione dell'Anteprima per gli sviluppatori 1.

Nuova modalità: Risparmio energetico avanzato

Quando un orologio è in modalità di risparmio energetico avanzato, per impostazione predefinita quadranti con ottimizzazione dell'alimentazione. Tutte le seguenti opzioni vengono disattivate Spento:

  • Radio
  • Il touchscreen
  • La funzionalità Inclina per riattivare

Gli utenti possono vedere l'ora premendo brevemente il pulsante laterale. Pressione prolungata consente all'utente di tornare a una modalità completamente operativa ed eseguire attività, ad esempio pagare con NFC o rispondere a un messaggio. Supponiamo che le app, i quadranti e i fornitori di dati relativi alle complicazioni non sono disponibili in modalità di risparmio energetico avanzato.

Attività in background limitata

Per migliorare la gestione dell'alimentazione, non è più possibile avviare le app in background sveglie e job a meno che lo smartwatch non sia sul caricabatterie. Le eccezioni includono smartwatch volti e complicazioni attive.

Nota: se la tua app deve essere sempre in esecuzione, ad esempio in background per il monitoraggio, ti consigliamo di utilizzare un servizio in primo piano startForegroundService(). Vedi Sfondo sulle limitazioni del servizio per ulteriori dettagli. Utilizzo di un servizio in primo piano è appropriata in casi d'uso eccezionali, come il monitoraggio dello stato di salute.

Compatibilità delle app migliorata

Per migliorare la compatibilità delle app, Android P ha iniziato a implementare alcune limitazioni sull'utilizzo di interfacce non SDK. Pianifica la tua migrazione da metodi e campi non SDK. Se non è disponibile un equivalente pubblico per i tuoi caso d'uso, faccelo sapere.

Tema scuro di sistema UI

Dall'inizio del 2018, Wear OS è passato a un tema UI predefinito che ha uno sfondo più scuro per lo stream di notifiche e per l'Avvio app del sistema. Questo modifica ha lo scopo di migliorare la visibilità delle app. verifica l'accessibilità della tua app con questo nuovo tema UI.

Sono disponibili codelab aggiornati

Per aiutarti a esplorare modi importanti per sviluppare con Wear OS, sono disponibili codelab aggiornati. Per esempio, prova il nuovo codelab sul quadrante basato su Kotlin per fare esperimenti con DSL (lingua specifica del dominio Kotlin).

Anteprima per gli sviluppatori di Wear OS 2018-marzo-27 1

Questa sezione contiene informazioni sull'Anteprima per gli sviluppatori 1 di Wear OS by Google. Diversi aggiornamenti a questa anteprima sono previsti prima del rilascio di produzione finale. Invia eventuali bug riscontrati utilizzando l' Issue Tracker di Wear OS by Google. Prima li invii, più alta è la probabilità che possiamo includere le correzioni nella release finale.

Problemi noti

  • Nell'app complementare Wear OS, toccare Segnala bug indossabile sembra funzionare. ma non viene generata effettivamente alcuna segnalazione di bug. Come soluzione alternativa puoi usare adb bugreport.
  • Non sempre accetta una chiamata utilizzando lo smartwatch. In caso contrario, l'utente dovrà accettare la chiamata direttamente dallo smartphone.
  • Un messaggio "Sono stati rilevati problemi di compatibilità delle API" errore appare a volte dopo l'accoppiamento o l'avvio di un'app precaricata. Il messaggio di errore scompare dopo un breve lasso di tempo e non influisce sull'usabilità.
  • Nel menu Impostazioni sullo smartwatch e nell'emulatore, il L'opzione Crea segnalazione bug viene visualizzata due volte. Per inviare una segnalazione di bug, prova a usare ciascuna delle due opzioni, perché solo una è funzionante. Quando tocchi l'opzione funzionale, viene visualizzato un avviso popup che mostra che è stata generata una segnalazione di bug.
  • Nella versione per la Cina, l'input vocale provoca l'arresto anomalo di un'app. Ad esempio, ciò si verifica con la ricerca vocale o quando utilizzi i comandi vocali per aggiungere un promemoria, perché questa funzionalità utilizza le API di input vocale. Per i test, usa la tastiera o la scrittura a mano libera anziché l'input vocale.
  • Lo store Wear nella versione cinese non funziona. Sviluppatori non potrà aggiornare o installare nuove app utilizzando quel canale. È consigliabile utilizzare "adb" come soluzione alternativa per eseguire il sideload della tua applicazione per i test.

Punti salienti in questa anteprima per gli sviluppatori

L'Anteprima per gli sviluppatori 1 include le seguenti funzionalità per i test delle app:

  • Attività in background limitata. Per migliorare la gestione dell'alimentazione, le app nella in background non possono più utilizzare sveglie e job. Le eccezioni includono smartwatch volti e complicazioni selezionati dall'utente. Questa funzionalità verrà implementata gradualmente nelle anteprime per sviluppatori, quindi potresti non vederla immediatamente smartwatch.

    Nota: Se la tua app deve essere sempre eseguita, modificala in modo che sia in primo piano utilizzando . startForegroundService(). Consulta Limitazioni del servizio in background per ulteriori dettagli.

  • Restrizioni relative alle app Utilizzo di interfacce non SDK: per migliorare l'app compatibilità, Android P ha iniziato a implementare . limitazioni all'utilizzo di interfacce non SDK. Pianifica la migrazione da metodi e campi non SDK. Se non è disponibile un equivalente pubblico per il tuo caso d'uso, faccelo sapere.
  • Tema scuro del sistema UI: dall'inizio del 2018, Wear OS ha è passato a un tema UI predefinito con uno sfondo più scuro per le notifiche stream e utilità di avvio del sistema. Lo scopo di questa modifica è migliorare la visibilità per i tuoi app; per controllare l'accessibilità della tua app con questo nuovo tema UI.
  • Le radio sono spente quando lo smartwatch non è collegato al corpo: per migliorare la gestione dell'alimentazione, il I segnali radio Bluetooth, radio Wi-Fi e radio cellulare sono disattivati quando lo smartwatch viene rilevato come fuori dal corpo per un periodo prolungato. Questa funzionalità verrà implementata gradualmente nel per gli sviluppatori, quindi inizialmente potresti non vederla sul tuo smartwatch. Se questa funzionalità che causino problemi nel processo di sviluppo, puoi disabilitare la funzionalità utilizzando "adb" utilizzando questo comando:
    adb shell settings put global off_body_radios_off_for_small_battery_enabled 0
  • Il Wi-Fi non è attivo quando il Bluetooth è disconnesso. Per migliorare la gestione dell'alimentazione, l'orologio non si connette più automaticamente alla rete Wi-Fi quando lo smartwatch si disconnette dal Bluetooth. Fanno eccezione i casi in cui un'app richiede una rete con larghezza di banda elevata e dello smartwatch collegato a un caricabatteria. Questa funzionalità verrà implementata gradualmente nel per gli sviluppatori, quindi inizialmente potresti non vederla sul tuo smartwatch.

Aggiornamenti alla libreria di supporto Wearable, v2.3.0

Lo L'aggiornamento della documentazione v2.3.0 per Wearable Support Library include Aggiornamenti di rebranding.

Inoltre, la versione 2.3.0 della libreria include aggiornamenti relativi a ComplicationDrawable e TextRenderer per il testo con oggetti di markup collegati a intervalli di testo. Queste classi hanno migliorato la gestione spanned. È possibile eseguire il rendering solo di un determinato sottoinsieme di intervalli (vedi il metodo setText per conoscere i tipi di intervalli che possono essere tracciati), quindi gli intervalli non vengono visualizzati fuori luogo quando vengono visualizzati in un quadrante.

Rebranding di Wear 2018-marzo-15

Questa sezione contiene informazioni sulle funzionalità di Wear OS.

Nuovo nome per Android Wear

Android Wear è stato rinominato Wear OS by Google.

Aggiornamento alla modalità Ambient del 27 febbraio 2018

Questa sezione contiene informazioni sulle nuove funzionalità di Android Wear.

Nuovo corso per il supporto della modalità Ambient

Lo La versione 27.1.0 di Android Support Library contiene una nuova corso, AmbientModeSupport, che sostituisce l'ormai deprecato AmbientMode. Gli aggiornamenti degli esempi sono in programma nei prossimi settimane.

2018-gennaio-25: emulatore finale e altro ancora

Questa sezione contiene informazioni sulle nuove funzionalità di Android Wear.

Emulatore Android: aggiornamento per Wear

L'ultimo aggiornamento relativo ad Wear ad Android è disponibile per testare le app in base alla versione 26 dell'API.

Miglioramenti nella libreria di supporto Wearable, v2.2.0

Lo La versione 2.2.0 di Wearable Support Library include gli aggiornamenti descritti di seguito.

Un nuovo indicatore di notifica da leggere

Poiché gli utenti vogliono essere a conoscenza delle notifiche da leggere, viene visualizzato un nuovo indicatore viene fornito: un puntino cerchiato nella parte inferiore del quadrante. Se preferisci gestire le notifiche autonomamente, puoi usa setHideNotificationIndicator per nascondere l'indicatore predefinito e visualizza le tue o setShowUnreadCountIndicator per visualizzare il numero di notifiche nel barra di stato.

Personalizza il colore dell'anello esterno della notifica da leggere con il metodo setAccentColor.

Nota:l'indicatore delle notifiche da leggere non è attivo. nella versione di produzione di Wear 2.8.0. Testa la tua implementazione con l'emulatore Wear più recente. A partire dalla prossima release per consumatori di Wear (versione 2.9.0), per impostazione predefinita viene visualizzato l'indicatore delle notifiche da leggere.

Miglioramenti alla classe ComplicationDrawable

Il corso ComplicationDrawable avvia una richiesta di autorizzazione per un quadrante che viene toccato quando il sistema indica il valore TYPE_NO_PERMISSION, che indica che il quadrante non è presente per ottenere i dati sulla complicazione.

Inoltre, la classe ComplicationDrawable si autoconvalida al termine dell'operazione. caricare immagini o quando scade l'evidenziazione di un tocco. Per rispondere per un'annullamento convalida, ad esempio per ridisegnare il quadrante, aggiungi un Drawable.Callback.

Problemi noti

  • Se attivi la modalità Cinema nell'emulatore, come descritto in Cambia schermo e impostazioni di luminosità, l'emulatore può rimanere bloccato in modalità Cinema. Per risolvere il problema è necessario cancellare i dati dell'emulatore; vedi Esegui e arresta un emulatore e cancella i dati.
  • Nella finestra di un emulatore per il livello API 25 o 26, il tasto di accensione non funziona. Usa pulsanti diversi dal tasto di accensione. In particolare, per passare alla modalità Ambient, ad esempio, come se un utente avesse sullo schermo con il palmo della mano, usa il tasto di accensione dell'emulatore a destra del display. Per avviare Avvio applicazioni in modalità interattiva: usa il pulsante Home sulla barra degli strumenti dell'emulatore.
  • Nella versione per la Cina dell'emulatore, se usi la scrittura a mano libera metodo di immissione, lo schermo può iniziare a lampeggiare. Quindi, quando fai clic sul per la tastiera sullo schermo, la tastiera blocca metà dello schermo.

2017-dicembre-18 Nuovo accesso a Google Play Services

Questa sezione contiene informazioni sulle nuove funzionalità di Android Wear.

Esegui la migrazione dalla classe GoogleApiClient

A partire dalla versione 11.8.0 di Google Play Services, esegui la migrazione delle app Wear da GoogleApiClient e utilizzare invece oggetti client API basati su la classe GoogleApi e l'API Tasks.

Nota: questo aggiornamento non riguarda App Android Wear per la Cina, che in genere utilizzano la versione 10.2.0 di Google Play Services.

Per ulteriori informazioni, consulta quanto segue:

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.