Note di rilascio di Wear OS

Questa pagina contiene informazioni sulle release per Wear OS, come l'SDK Wearable e la libreria di assistenza Wearable.

SDK per dispositivi indossabili 18.1.0 del 31 agosto 2023

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

  • Assistenza per il cambio di telefono, visita la pagina NodeClient.OnNodeMigratedListener per ulteriori dettagli.
  • Documentazione aggiuntiva per i messaggi di invio e risposta di MessageClient.
  • Link aggiornati nelle descrizioni delle API.

SDK per dispositivi indossabili 18.0.0 del 20 settembre 2022

La versione 18.0.0 dell'SDK Wearable include aggiornamenti secondari dell'API per supportare la prossima release della libreria di supporto Wearable. Gli aggiornamenti includono:

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

Libreria di supporto indossabile v2.9.0 del 16 febbraio 2022

La versione 2.9.0 della Wearable Support Library ritira tutte le classi rimanenti. Utilizza invece le librerie Wear OS Jetpack.

Raccolta Jetpack Wear OS 29 ottobre 2021

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

SDK per dispositivi indossabili 17.1.0 27-aprile 2021

La versione 17.1.0 dell'SDK Wearable include aggiornamenti secondari dell'API per supportare la prossima release della libreria di supporto Wearable.

28 settembre 2020 libreria di supporto indossabile v2.8.1

La versione 2.8.1 di Wearable Support Library include la seguente modifica.

Autorizza la disattivazione di Jetifier quando utilizzi il modello del quadrante

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

Libreria di supporto per dispositivi indossabili v2.8.0-24-settembre 2020

La versione 2.8.0 di Wearable Support Library include le seguenti modifiche.

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

I quadranti ora possono usare setDefaultComplicationProviderWithFallbacks per specificare uno o più provider di complicazioni non di sistema da utilizzare per impostazione predefinita. Se nessuno dei provider non di sistema specificati è installato, il sistema utilizza il provider di sistema predefinito.

WearableActivity deprecato

WearableActivity è deprecato. Utilizza AmbientModeSupport.

SKIP_CONFIRMATION_UI deprecata

ActionConfirmationActivity.SKIP_CONFIRMATION_UI è deprecato. Questo extra non è stato utilizzato dal rilascio di Wear 2.0.

Libreria di supporto indossabile v2.7.0 del 15 maggio 2020

La versione 2.7.0 della libreria di supporto indossabile include la seguente funzionalità.

Accelerazione hardware per i quadranti

Ora puoi richiedere un canvas con accelerazione hardware quando utilizzi la classe CanvasWatchFaceService. Sfrutta l'accelerazione hardware per migliorare le prestazioni del quadrante e accedere a una maggiore quantità di dati sulle prestazioni dell'interfaccia utente.

Per ulteriori informazioni, vedi Migliorare le prestazioni del quadrante con l'accelerazione hardware.

21 aprile 2020 Libreria di supporto indossabile versione 2.6.0

La versione 2.6.0 della libreria di supporto indossabile include i seguenti miglioramenti.

Migrazione ad Android Jetpack

È stata eseguita la migrazione della libreria di supporto per dispositivi indossabili ad Android Jetpack. Le librerie esistenti sono ora mappate e accessibili in AndroidX utilizzando lo spazio dei nomi androidx e tutte le dipendenze nella libreria di supporto ritirata sono state rimosse.

Questa modifica consente inoltre di utilizzare le librerie di supporto per dispositivi indossabili in Android Studio 4.0 e versioni successive, in modo da risolvere problemi come il problema n. 147972079.

Libreria di supporto indossabile v2.5.0 del 28 agosto 2019

La versione 2.5.0 della libreria di supporto indossabile include i seguenti miglioramenti.

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

ComplicationDrawable ora include un flag NEW_TASK che garantisce che le chiamate startActivity() provenienti da un WatchFaceService includano FLAG_ACTIVITY_NEW_TASK per evitare un android.util.AndroidRuntimeException.

Questa modifica consente al tipo di complicazione TYPE_NO_PERMISSION di avviare correttamente l'attività di richiesta di autorizzazione anziché eseguire l'arresto anomalo del quadrante orologio.

SDK per dispositivi indossabili 16.0.0 del 25 settembre 2018

La versione 16.0.0 dell'SDK per dispositivi indossabili riduce la versione richiesta di Google Play Services dalla versione 12.4 alla versione 8.6. Questa modifica consente alle app esistenti di eseguire l'aggiornamento all'ultima versione dell'SDK Wearable senza dover aggiornare l'APK di Google Play Services.

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

Un recente aggiornamento over-the-air di Wear OS Developer Preview 2 ha riattivato sveglie e processi per le app in background.

Sebbene questa modifica ai criteri supporti una maggiore flessibilità nello sviluppo delle app, gli allarmi e i job in background continuano a essere soggetti ad altre limitazioni di Android P, incluse quelle relative ai bucket di standby delle app. Segui le best practice per assicurarti che le app funzionino correttamente, indipendentemente dal bucket in cui si trovano.

Questo aggiornamento rafforza inoltre l' input utente e la privacy dei dati limitando l'accesso di un'app in background ai dati dei sensori e degli input utente. A seconda dei requisiti di un'app, potrebbe essere necessario utilizzare un servizio in primo piano per consentire l'accesso continuo ai dati dei sensori.

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

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 tracker dei problemi Wear OS by Google. Prima le invii, maggiori sono le probabilità che le correzioni vengano incluse nella release finale.

Problemi noti

Questa sezione contiene i problemi noti relativi alla release di Anteprima 2.

Problemi per l'immagine Wear OS

  • Quando sei in un'app e premi il tasto di accensione sul lato dello smartwatch, potresti tornare alla schermata precedente anziché al quadrante orologio.

Problemi con l'immagine Wear OS per la Cina

  • Quando sei in un'app e premi il tasto di accensione sul lato dello smartwatch, potresti tornare alla schermata precedente anziché al quadrante orologio.
  • Le impostazioni audio relative al volume non vengono salvate in modo permanente. Ad esempio, quando ricevi una chiamata in arrivo, l'orologio emette uno squillo udibile anche se il suono dell'orologio è disattivato. Inoltre, se regoli il volume della sveglia, la modifica non ha 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 la tua app con una sola notifica continua anziché con più di una.
  • Lo store Wear nella versione Cina non funziona. Gli sviluppatori non potranno aggiornare o installare nuove app utilizzando questo canale. Ti consigliamo di utilizzare "adb" come soluzione alternativa per eseguire il sideload della tua applicazione per i test.

Problemi relativi all'emulatore Wear

  • Una telefonata in arrivo a un telefono associato non viene mostrata, o _mirrored_, come chiamata in arrivo nell'emulatore accoppiato.
  • Quando utilizzi il gestore SDK per installare o confermare di avere l'ultima installazione di Android P o della versione cinese, le caselle di controllo accanto a queste selezioni potrebbero non essere selezionate dopo averle selezionate. Se non sono selezionate, selezionale una seconda volta.
  • Quando l'emulatore esegue un avvio a freddo, potrebbe essere visualizzato il seguente messaggio di errore: "Si è verificato un problema interno con il dispositivo. Per informazioni dettagliate, contatta il produttore." Questo non influisce sulla funzionalità. Scorri verso il basso e fai clic su OK per iniziare a testare l'app.
  • La risposta vocale potrebbe non funzionare con l'emulatore. Ad esempio, se ricevi una notifica per un messaggio di Google Hangouts nell'emulatore Wear e provi a rispondere al messaggio con la voce, viene visualizzato il messaggio di errore "Google continua a interrompersi" e non puoi rispondere a voce.
  • Instant Run potrebbe non essere compatibile con l'emulatore Wear.
  • L'acquisizione di uno screenshot in modo programmatico, ad esempio utilizzando "adb" o facendo una segnalazione di bug, potrebbe non funzionare. Per risolvere il problema, fai clic sul pulsante della fotocamera nella barra degli strumenti dell'emulatore per acquisire uno screenshot.

Problemi relativi alla versione cinese dell'emulatore Wear

  • Una telefonata in arrivo a un telefono accoppiato potrebbe non essere visualizzata, o _mirrored_, come chiamata in arrivo nell'emulatore accoppiato. Di conseguenza, le notifiche delle chiamate senza risposta potrebbero non essere visualizzate nell'emulatore. Inoltre, potresti non riuscire a rispondere a una chiamata dall'emulatore, nel qual caso la chiamata continuerà a squillare.
  • Quando utilizzi il gestore SDK per installare o confermare di avere l'ultima installazione di Android P o della versione cinese, le caselle di controllo accanto a queste selezioni potrebbero non essere selezionate dopo averle selezionate. Se non sono selezionate, selezionale una seconda volta.
  • Quando l'emulatore esegue un avvio a freddo, potrebbe essere visualizzato il seguente errore: "Si è verificato un problema interno con il dispositivo. Per informazioni dettagliate, contatta il produttore." Questo non influisce sulla funzionalità. Scorri verso il basso e fai clic su OK per iniziare a testare l'app.
  • Instant Run potrebbe non essere compatibile con l'emulatore Wear.
  • L'acquisizione di uno screenshot in modo programmatico, ad esempio utilizzando "adb" o facendo una segnalazione di bug, potrebbe non funzionare. Per risolvere il problema, fai clic sul pulsante della fotocamera nella barra degli strumenti dell'emulatore per acquisire uno screenshot.

Assistente Google su Wear

Il supporto avanzato dell'assistente su Wear OS ti consente di creare un'esperienza indossabile senza scrivere codice Android. In particolare, puoi creare contenuti per la piattaforma Actions on Google, aiutando gli utenti a portare a termine le 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. Per farlo:

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

Inoltre, Wear OS ora supporta più schede visive, nonché elenchi e caroselli.

Di conseguenza, puoi utilizzare DialogFlow, modelli o l'SDK Actions per creare Actions on Google per Wear OS. Puoi inoltre sfruttare i nuovi modelli di risposta specifici per un orologio. Le best practice per Actions on Google includono:

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

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

Risparmio energetico nell'Anteprima per gli sviluppatori 2

Come descritto nella sezione che segue, sono disponibili funzionalità relative all'alimentazione per aumentare la durata della batteria. Le informazioni contenute in questa sezione dell'Anteprima per sviluppatori 2 sostituiscono le informazioni relative all'alimentazione per l'Anteprima per gli sviluppatori 1.

Nuova modalità: Risparmio energetico avanzato

Mentre sullo smartwatch è attiva la modalità di risparmio energetico avanzato, viene visualizzato un quadrante predefinito ottimizzato per il consumo energetico. Tutte le seguenti opzioni sono disattivate:

  • Radio
  • Il touchscreen
  • Funzione Inclina per riattivare

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

Attività in background limitata

Per migliorare la gestione dell'alimentazione, le app in background non possono più avviare sveglie e job a meno che lo smartwatch non sia collegato al caricabatteria. Fanno eccezione i quadranti e le complicazioni attive.

Nota: se l'app deve essere sempre eseguita, ad esempio per il monitoraggio in background, ti consigliamo di utilizzare un servizio in primo piano utilizzando il metodo startForegroundService(). Per ulteriori dettagli, consulta Limitazioni dei servizi in background. L'uso di un servizio in primo piano è appropriato per casi d'uso eccezionali come il monitoraggio dello stato di integrità.

Migliore compatibilità delle app

Per migliorare la compatibilità delle app, Android P ha iniziato a implementare alcune limitazioni relative 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, contattaci.

Tema scuro del sistema UI

Dall'inizio del 2018, Wear OS è passato a un tema predefinito dell'interfaccia utente con uno sfondo più scuro per lo stream delle notifiche e l'Avvio app di sistema. Lo scopo di questa modifica è migliorare la visibilità delle app; controlla l'accessibilità della tua app con questo nuovo tema dell'interfaccia utente.

Sono disponibili codelab aggiornati

Per aiutarti a scoprire modi importanti per sviluppare con Wear OS, sono disponibili codelab aggiornati. Ad esempio, prova il nuovo codelab per i quadranti basato su Kotlin per sperimentare il linguaggio specifico per il dominio Kotlin, o DSL.

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

Questa sezione contiene informazioni sull'Anteprima per sviluppatori 1 di Wear OS by Google. Sono previsti diversi aggiornamenti a questa anteprima prima della release di produzione finale. Invia gli eventuali bug riscontrati utilizzando l' Issue Tracker di Wear OS by Google. Prima le invii, maggiori sono le probabilità di poter includere le correzioni nella release finale.

Problemi noti

  • Nell'app complementare Wear OS, toccare Segnala bug indossabile sembra funzionare, ma di fatto non viene generata alcuna segnalazione di bug. Utilizza adb bugreport come soluzione alternativa.
  • Non sempre si accetta una chiamata utilizzando lo smartwatch. Se l'operazione non va a buon fine, l'utente deve accettare la chiamata direttamente dallo smartphone.
  • A volte viene visualizzato l'errore "Problemi rilevati con la compatibilità dell'API" dopo l'associazione o l'avvio di un'app precaricata. Questo messaggio di errore scompare dopo un breve periodo di tempo e non influisce sull'usabilità.
  • Nel menu Impostazioni dello smartwatch e nell'emulatore, l'opzione Crea segnalazione di bug viene visualizzata due volte. Per creare una segnalazione di bug, prova a utilizzare ciascuna delle due opzioni, perché è funzionante solo una. Quando tocchi l'opzione per il funzionamento, viene visualizzato un avviso popup che indica che è in corso la generazione di una segnalazione di bug.
  • Nella versione per la Cina, l'input vocale causa l'arresto anomalo di un'app. Ad esempio, ciò si verifica con la ricerca vocale o quando si utilizza la voce per aggiungere un promemoria perché questa funzionalità utilizza API di input vocale. Per i test, utilizza la tastiera o l'input tramite scrittura a mano libera anziché l'input vocale.
  • Lo store di app Wear nella versione Cina non funziona. Gli sviluppatori non potranno aggiornare o installare nuove app utilizzando questo canale. Ti consigliamo di utilizzare "adb" come soluzione alternativa per eseguire il sideload della tua applicazione per i test.

Punti salienti in questa anteprima per sviluppatori

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

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

    Nota: se la tua app deve essere sempre eseguita, modificala per renderla un servizio in primo piano utilizzando il metodo startForegroundService(). Per ulteriori dettagli, consulta Limitazioni dei servizi in background.

  • Limitazioni relative all'uso di interfacce non SDK da parte delle app: per migliorare la compatibilità delle app, Android P ha iniziato a implementare alcune limitazioni relative 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, comunicacelo.
  • Tema scuro del sistema UI: dall'inizio del 2018, Wear OS è passato a un tema UI predefinito con uno sfondo più scuro per lo stream delle notifiche e l'Avvio app di sistema. Lo scopo di questa modifica è migliorare la visibilità delle app; controlla l'accessibilità della tua app con questo nuovo tema dell'interfaccia utente.
  • Le radio sono disattivate quando lo smartwatch non è a contatto con il corpo: per migliorare la gestione dell'alimentazione, la radio Bluetooth, la radio Wi-Fi e la radio cellulare sono spente quando lo smartwatch viene rilevato come fuori dal corpo per un periodo prolungato. Questa funzionalità verrà implementata gradualmente nelle anteprime degli sviluppatori, quindi inizialmente potresti non vederla sul tuo smartwatch. Se questa funzionalità causa problemi nel processo di sviluppo, puoi disattivarla utilizzando "adb" utilizzando il seguente comando:
    adb shell settings put global off_body_radios_off_for_small_battery_enabled 0
  • Il Wi-Fi è disattivato quando il Bluetooth è disconnesso. Per migliorare la gestione dell'alimentazione, l'orologio non si connette più automaticamente alla rete Wi-Fi quando si disconnette dal Bluetooth. Le eccezioni includono il caso di un'app che richiede una rete a larghezza di banda elevata e la cassa dello smartwatch collegato a un caricabatteria. Questa funzionalità verrà implementata gradualmente nelle anteprime degli sviluppatori, quindi inizialmente potresti non vederla sul tuo smartwatch.

Aggiornamenti alla libreria di supporto indossabile, v2.3.0

L' aggiornamento della documentazione della versione 2.3.0 della libreria di assistenza per i dispositivi indossabili include aggiornamenti del rebranding.

Inoltre, la versione 2.3.0 della libreria include aggiornamenti relativi a ComplicationDrawable e TextRenderer per il testo con oggetti di markup allegati a intervalli di testo. Queste classi hanno migliorato la gestione dei testi internati. È possibile visualizzare solo un determinato sottoinsieme di intervalli. Per i tipi di intervalli che è possibile tracciare, consulta il metodo setText; in questo modo, gli intervalli non sembreranno spostati 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 è rinominato Wear OS by Google.

Aggiornamento della modalità Ambient del 27 febbraio 2018

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

Nuova classe per il supporto della modalità Ambient

La versione 27.1.0 di Android Support Library contiene una nuova classe, AmbientModeSupport, che sostituisce la classe AmbientMode, ormai deprecata. Gli aggiornamenti ai campioni sono pianificati nelle prossime settimane.

2018-gen-25 emulatore finale e altro

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

Emulatore Android: aggiornamento per Wear

L'aggiornamento finale relativo a Wear dell'emulatore Android è disponibile per testare le app basate sulla versione 26 dell'API.

Miglioramenti nella libreria di supporto indossabile, v2.2.0

La versione 2.2.0 della libreria di supporto indossabile include gli aggiornamenti descritti di seguito.

Un nuovo indicatore di notifica da leggere

Poiché gli utenti vogliono essere informati delle notifiche non lette, viene fornito un nuovo indicatore: un pallino cerchiato nella parte inferiore del quadrante orologio. Se preferisci gestire autonomamente le notifiche, puoi usare setHideNotificationIndicator per nascondere l'indicatore predefinito e mostrarne uno personalizzato oppure setShowUnreadCountIndicator per visualizzare il conteggio delle notifiche nella barra di stato.

Personalizza il colore dell'anello esterno dell'indicatore delle notifiche non lette con il metodo setAccentColor.

Nota: l'indicatore delle notifiche da leggere non è abilitato nella versione di produzione di Wear 2.8.0. Testa la tua implementazione utilizzando l'emulatore di Wear più recente. A partire dalla prossima release consumer di Wear (versione 2.9.0), per impostazione predefinita verrà visualizzato l'indicatore delle notifiche non lette.

Miglioramenti alla classe ComplicationDrawable

La classe ComplicationDrawable avvia una richiesta di autorizzazione per un quadrante che viene toccato quando il sistema indica un valore TYPE_NO_PERMISSION, a indicare che il quadrante non ha l'autorizzazione per ottenere i dati della complicazione.

Inoltre, la classe ComplicationDrawable non è valida al termine del caricamento delle immagini o allo scadere di un'evidenziazione di tocco. Per rispondere a questa annullamento della validità, ad esempio per riprogettare il quadrante, aggiungi un Drawable.Callback.

Problemi noti

  • Se attivi la modalità Cinema nell'emulatore, come descritto nella sezione Modificare le impostazioni dello schermo e la luminosità, l'emulatore potrebbe rimanere bloccato sulla modalità Cinema. Per risolvere il problema è necessario cancellare i dati dell'emulatore; consulta la pagina Esegui e interrompi 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 coprisse lo schermo con il palmo, utilizza il tasto di accensione nella barra degli strumenti dell'emulatore a destra del display. Per avviare Avvio applicazioni in modalità interattiva, utilizza il pulsante Home nella barra degli strumenti dell'emulatore.
  • Nella versione per la Cina dell'emulatore, se utilizzi il metodo di inserimento della scrittura a mano libera, lo schermo può iniziare a lampeggiare. Dopodiché, quando fai clic sul pulsante della tastiera sullo schermo, quest'ultima blocca metà dello schermo.

18 dicembre 2017 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 tue app Wear dalla classe GoogleApiClient e utilizza invece oggetti client API basati sulla classe GoogleApi e sull'API Tasks.

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

Per ulteriori informazioni, consulta le seguenti risorse:

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.