Note di rilascio di Wear OS

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

SDK Wearable 18.1.0 del 31 agosto 2023

La versione 18.1.0 dell'SDK Wearable include aggiornamenti dell'API di minore entità per supportare la prossima release della libreria di assistenza Wearable. Gli aggiornamenti includono:

  • Assistenza per il passaggio da uno smartphone all'altro, visita NodeClient.OnNodeMigratedListener per ulteriori dettagli.
  • Documentazione aggiuntiva per MessageClient invio e risposta ai messaggi.
  • Link aggiornati nelle descrizioni delle API.

SDK Wearable 18.0.0 del 20 settembre 2022

La versione 18.0.0 dell'SDK Wearable include aggiornamenti dell'API minori per supportare la prossima release della libreria di assistenza 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.

Libreria Jetpack per Wear OS del 29 ottobre 2021

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

SDK indossabile 17.1.0 del 27 aprile 2021

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

2020-settembre-28 Wearable Support Library v2.8.1

La versione 2.8.1 della Wearable Support Library include la modifica riportata di seguito.

Consenti la disattivazione di Jetifier quando utilizzi il modello del quadrante

Il modello del quadrante orologio 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.

2020-settembre-24 Wearable Support Library v2.8.0

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

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

Ora i quadranti possono utilizzare setDefaultComplicationProviderWithFallbacks per specificare uno o più fornitori 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 deprecata

WearableActivity è deprecato. Usa invece AmbientModeSupport.

SKIP_CONFIRMATION_UI deprecato

ActionConfirmationActivity.SKIP_CONFIRMATION_UI è deprecato. Questo extra è inutilizzato dal rilascio di Wear 2.0.

15 maggio 2020 Libreria di supporto indossabile v2.7.0

La versione 2.7.0 della Wearable Support Library include la seguente funzionalità.

Accesso 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 più dati sulle prestazioni dell'UI.

Per ulteriori informazioni, consulta la pagina Migliorare le prestazioni del quadrante con l'accelerazione hardware.

2020-aprile-21 Wearable Support Library v2.6.0

La versione 2.6.0 della Wearable Support Library 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 assistenza deprecata sono state rimosse.

Questa modifica consente anche di utilizzare le librerie di supporto per dispositivi indossabili in Android Studio 4.0 e versioni successive, che risolve problemi come il problema n. 147972079.

2019-Agosto-28 Wearable Support Library v2.5.0

La versione 2.5.0 della Wearable Support Library 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é arrestare il quadrante.

SDK indossabile 16.0.0 del 25 settembre 2018

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 all'ultima versione dell'SDK Wearable senza richiedere un aggiornamento dell'APK di Google Play Services.

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

Un recente aggiornamento over-the-air all'Anteprima per gli sviluppatori di Wear OS 2 ha riattivato le sveglie e i processi per le app in background.

Sebbene questa modifica ai criteri supporti una maggiore flessibilità nello sviluppo delle app, gli allarmi in background e i job 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 tue app funzionino correttamente, indipendentemente dal bucket in cui si trovano.

Questo aggiornamento rafforza anche 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 2-8 maggio 2018

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 lo strumento di monitoraggio 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 Anteprima 2.

Problemi per l'immagine Wear OS

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

Immagine di problemi con Wear OS per la Cina

  • Quando sei in un'app e premi il tasto di accensione sulla parte laterale dello smartwatch, potresti tornare alla schermata precedente anziché al quadrante.
  • Le impostazioni audio relative al volume non sono salvate in modo permanente. Ad esempio, quando 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.
  • La presenza di più notifiche in corso potrebbe non essere visualizzata correttamente. Ad esempio, se sono impostati sia un timer sia un cronometro, le notifiche non vengono visualizzate. Ti consigliamo di testare l'app con una sola notifica continua anziché con più di una.
  • Lo store Wear nella versione cinese 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 complementare 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 Cina, le caselle di controllo accanto a queste selezioni possono essere deselezionate dopo le selezioni. Se risultano deselezionati, selezionali 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." Ciò 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 nell'emulatore. Ad esempio, se ricevi una notifica relativa a un messaggio di Google Hangouts nell'emulatore Wear e provi a rispondere al messaggio a 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 di 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 Cina, le caselle di controllo accanto a queste selezioni possono essere deselezionate dopo le selezioni. Se risultano deselezionati, selezionali 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." Ciò 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 di 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. Effettuano le seguenti operazioni:

  • Aiuta gli utenti a completare le interazioni rapidamente
  • Fornisci agli utenti suggerimenti sulle funzionalità 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 anche usufruire di nuovi modelli di risposta specifici per uno smartwatch. Le best practice per Actions on Google includono:

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

Questi miglioramenti per l'assistente su Wear OS non dipendono da Android P e vengono 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 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 gli sviluppatori 2 sostituiscono le informazioni relative all'alimentazione per l'Anteprima per gli sviluppatori 1.

Nuova modalità: Risparmio energetico avanzato

Quando su un orologio è attiva la modalità di risparmio energetico avanzato, viene visualizzato un quadrante predefinito a ottimizzazione energetica. Tutte le seguenti opzioni sono disattivate:

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

Gli utenti possono vedere l'ora premendo brevemente il pulsante laterale. Una pressione prolungata consente all'utente di tornare a una 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 processi, a meno che l'orologio non sia collegato al caricabatterie. 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 con il metodo startForegroundService(). Per ulteriori dettagli, consulta Limitazioni dei servizi in background. L'utilizzo di un servizio in primo piano è appropriato per casi d'uso eccezionali come il monitoraggio dello stato di integrità.

Compatibilità delle app migliorata

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 di sistema con interfaccia utente scura

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 per l'Avvio app del sistema. Questa modifica ha lo scopo di migliorare la visibilità delle app; verifica 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 il quadrante basato su Kotlin per sperimentare il linguaggio specifico per il dominio Kotlin o DSL.

Anteprima per gli sviluppatori di Wear OS 1-marzo 2018

Questa sezione contiene informazioni sull'Anteprima per gli sviluppatori 1 di Wear OS by Google. Sono previsti diversi aggiornamenti a questa anteprima prima della release di produzione finale. Invia eventuali bug rilevati usando lo strumento di monitoraggio dei problemi di Wear OS by Google. Prima le invii, maggiori sono le probabilità che le correzioni vengano incluse nella release finale.

Problemi noti

  • Nell'app complementare Wear OS, toccando Segnala bug indossabile sembra funzionare, ma in realtà non viene generata alcuna segnalazione di bug. Utilizza adb bugreport come soluzione alternativa.
  • Non sempre si accetta una telefonata utilizzando lo smartwatch. Se l'operazione non va a buon fine, l'utente deve accettare la chiamata direttamente dal telefono.
  • A volte viene visualizzato l'errore "Sono stati rilevati problemi di compatibilità dell'API" dopo l'accoppiamento 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 generare una segnalazione di bug, prova a utilizzare ciascuna delle due opzioni, perché solo una funziona. Quando tocchi questa opzione, viene visualizzato un avviso popup che indica che è in corso la generazione di una segnalazione di bug.
  • Nella versione cinese, 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 la scrittura a mano libera anziché l'input vocale.
  • Lo store Wear nella versione cinese 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.

Momenti salienti in questa anteprima per 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 in background non possono più utilizzare sveglie e lavori. Le eccezioni includono quadranti e complicazioni selezionate dall'utente. Questa funzionalità verrà implementata gradualmente nelle anteprime per sviluppatori, perciò potresti non vederla immediatamente sul tuo 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'utilizzo di interfacce non SDK da parte delle app: per migliorare la compatibilità delle app, Android P ha iniziato a implementare alcune limitazioni sull'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 di sistema con interfaccia utente scura: 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 leggibilità delle app; controlla l'accessibilità della tua app con questo nuovo tema dell'interfaccia utente.
  • I radio sono spenti quando l'orologio è scollegato dal corpo: per migliorare la gestione dell'alimentazione, la radio Bluetooth, la radio Wi-Fi e la radio cellulare sono disattivate quando l'orologio viene rilevato come fuori dal corpo per un periodo prolungato. Questa funzionalità verrà implementata gradualmente nelle anteprime per sviluppatori, pertanto inizialmente potresti non vederla sul tuo smartwatch. Se questa funzionalità causa problemi durante il processo di sviluppo, puoi disabilitarla utilizzando "adb" utilizzando il seguente 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 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 caricabatterie. Questa funzionalità verrà implementata gradualmente nelle anteprime per sviluppatori, pertanto inizialmente potresti non vederla sul tuo smartwatch.

Aggiornamenti alla libreria di supporto per indossabili, v2.3.0

L' aggiornamento della documentazione alla versione 2.3.0 per la libreria di assistenza per i dispositivi indossabili include aggiornamenti relativi al rebranding.

Inoltre, la versione 2.3.0 della libreria include aggiornamenti relativi a ComplicationDrawable e TextRenderer per il testo con oggetti di markup associati a intervalli di testo. Queste classi hanno migliorato la gestione dei testi con span. È possibile visualizzare solo un determinato sottoinsieme di intervalli. Consulta il metodo setText per conoscere i tipi di intervalli che è possibile tracciare, in modo che gli intervalli non sembrino fuori luogo quando vengono visualizzati in un quadrante.

15 marzo 2018: rebranding di Wear

Questa sezione contiene informazioni sulle funzionalità di Wear OS.

Nuovo nome per Android Wear

Android Wear è stato rinominato Wear OS by Google.

Aggiornamento della modalità Ambient del 27-feb-2018

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

Nuova classe per il supporto della modalità Ambient

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

Emulatore finale 25 gennaio 2018 e altro

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

Android Emulator: aggiornamento per Wear

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

Miglioramenti nella libreria di supporto per indossabili, v2.2.0

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

Un nuovo indicatore delle notifiche da leggere

Poiché gli utenti vogliono essere a conoscenza delle notifiche non lette, viene fornito un nuovo indicatore: un pallino cerchiato nella parte inferiore del quadrante. 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 di notifica da leggere 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), l'indicatore delle notifiche da leggere verrà visualizzato per impostazione predefinita.

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 recuperare i dati della complicazione.

Inoltre, la classe ComplicationDrawable viene invalidata al termine del caricamento delle immagini o alla scadenza dell'evidenziazione di un tocco. Per rispondere a questa annullamento, ad esempio per richiamare nuovamente il quadrante, aggiungi Drawable.Callback.

Problemi noti

  • Se attivi la modalità Cinema nell'emulatore, come descritto nella sezione Modificare le impostazioni dello schermo e della luminosità, l'emulatore può rimanere bloccato sulla modalità Cinema. Per risolvere il problema è necessario cancellare i dati dell'emulatore; vedi Eseguire e interrompere un emulatore e cancellare i dati.
  • All'interno della 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 della mano, utilizza il tasto di accensione disponibile 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 cinese dell'emulatore, se utilizzi il metodo di immissione Scrittura a mano libera, lo schermo può iniziare a lampeggiare. Quindi, quando fai clic sul pulsante della tastiera sullo schermo, la tastiera 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 lontano 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 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.