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:
- Migrazione delle app Wear a GoogleApi
- Accedi alle API di Google
-
Wearable
class documentation
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:
- The
Activity
subclasses in the Android Support Library, such as
FragmentActivity
. Functionality for
support library fragments is available.
-
Architecture components, which are
lifecycle aware.
- Better support for Google
Sign-In.
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.