Note di rilascio di Wear OS

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

21 novembre 2024 SDK per dispositivi indossabili 19.0.0

La versione 19.0.0 dell'SDK per dispositivi indossabili include aggiornamenti minori dell'SDK. Gli aggiornamenti includono:

  • Le dipendenze delle librerie sono state aggiornate alle versioni più recenti.
  • È stata rimossa una variante dell'API sendMessage() non supportata che includeva un parametro MessageOptions.

31 agosto 2023 SDK per dispositivi indossabili 18.1.0

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 trasferimento dello smartphone, consulta NodeClient.OnNodeMigratedListener per ulteriori dettagli.
  • Documentazione aggiuntiva per la messaggistica di invio e risposta di MessageClient.
  • Link aggiornati nelle descrizioni delle API.

20 settembre 2022 SDK per dispositivi indossabili 18.0.0

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

  • WearableListenerService Supporto per le app che hanno come target Android 13: problema 235538840.
  • Nuovo metodo MessageClient.sendRequest().

16 febbraio 2022, versione 2.9.0 della raccolta di assistenza per i dispositivi indossabili

La versione 2.9.0 della libreria di assistenza per i dispositivi indossabili ritira tutte le classi rimanenti. Utilizza le librerie Jetpack di Wear OS.

29 ottobre 2021 - Libreria Jetpack Wear OS

Le librerie Jetpack per Wear OS sono un'alternativa alle librerie di supporto per dispositivi indossabili e non sono progettate per essere utilizzate insieme. La libreria di assistenza per i dispositivi indossabili non funziona su Wear OS 3.

27 aprile 2021 SDK per dispositivi indossabili 17.1.0

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

28 settembre 2020 - Wearable Support Library versione 2.8.1

La versione 2.8.1 della libreria di assistenza per i dispositivi indossabili include la seguente modifica.

Consenti la disattivazione di Jetifier quando utilizzi il modello del quadrante

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

24 settembre 2020 - Wearable Support Library versione 2.8.0

La versione 2.8.0 della libreria di assistenza per i dispositivi indossabili include le seguenti modifiche.

Funzionalità di riserva per la specifica di 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 non è installato nessuno dei provider non di sistema specificati, il sistema utilizza di nuovo il provider di sistema predefinito.

WearableActivity non più supportato

WearableActivity è deprecato. Utilizza invece AmbientModeSupport.

SKIP_CONFIRMATION_UI non più supportato

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

15 maggio 2020 - Libreria di supporto per dispositivi indossabili 2.7.0

La versione 2.7.0 della libreria di assistenza per dispositivi indossabili include la seguente funzionalità.

Accelerazione hardware per i quadranti

Ora puoi richiedere una tela con accelerazione hardware quando utilizzi la classe CanvasWatchFaceService. Sfrutta l'accelerazione hardware per migliorare le prestazioni del quadrante e accedere a più dati sul rendimento dell'interfaccia utente.

Per ulteriori informazioni, consulta Migliorare il rendimento del quadrante con l'accelerazione hardware.

21 aprile 2020 - Wearable Support Library versione 2.6.0

La versione 2.6.0 della raccolta di assistenza per i dispositivi indossabili include il seguente miglioramento.

Migrazione ad Android Jetpack

È stata eseguita la migrazione della raccolta di supporto per i 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 dalla libreria di supporto ritirata sono state rimosse.

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

28 agosto 2019, versione 2.5.0 della libreria di assistenza per i dispositivi indossabili

La versione 2.5.0 della libreria di assistenza per i dispositivi indossabili include il seguente miglioramento.

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

ComplicationDrawable ora include un indicatore NEW_TASK che garantisce che le chiamate startActivity() che originano 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é far arrestare in modo anomalo il quadrante.

25 settembre 2018 - SDK per dispositivi indossabili 16.0.0

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

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

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

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

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

8 maggio 2018 - Anteprima per gli sviluppatori Wear OS 2

L'Anteprima per gli sviluppatori di Wear OS 2 include funzionalità come un'esperienza dell'Assistente Google migliorata.

Invia eventuali bug o feedback utilizzando il tracker dei problemi di Wear OS by Google. Prima le invii, maggiore è la probabilità che le correzioni vengano incluse nella release finale.

Problemi noti

Questa sezione contiene i problemi noti della release Preview 2.

Problemi relativi all'immagine per Wear OS

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

Problemi relativi all'immagine di Wear OS per la Cina

  • Quando sei in un'app e premi il pulsante di accensione sul lato dello smartwatch, potresti tornare alla schermata precedente anziché al quadrante.
  • Le impostazioni audio relative al volume non vengono memorizzate. Ad esempio, una chiamata in arrivo provoca suoni sullo smartwatch, anche se il suono sullo smartwatch è impostato su off. 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 sia un cronometro, le notifiche non vengono visualizzate. Ti consigliamo di testare la tua app con una notifica in corso anziché con più di una.
  • Lo store Wear nella versione per la Cina non funziona. Gli sviluppatori non possono aggiornare o installare nuove app utilizzando questo canale. Ti consigliamo di utilizzare "adb" come soluzione alternativa per eseguire il sideload dell'applicazione per i test.

Problemi per l'emulatore Wear

  • Una chiamata in arrivo su uno smartphone accoppiato non viene mostrata o _eseguita il mirroring_ come chiamata in arrivo nell'emulatore accoppiato.
  • Quando utilizzi Gestione SDK per installare o verificare di avere l'installazione più recente di Android P o la versione per la Cina, le caselle di controllo accanto a queste selezioni possono essere deselezionate dopo la selezione. Se vengono deselezionate, selezionale di nuovo.
  • Quando l'emulatore esegue un avvio a freddo, potrebbe essere visualizzato il seguente errore: "Si è verificato un problema interno con il tuo dispositivo. Contatta il produttore per maggiori dettagli". 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 notification per un messaggio di Google Hangouts sull'emulatore Wear e provi a rispondere al messaggio tramite comandi vocali, viene visualizzato il messaggio di errore "Google si arresta continuamente" e non puoi rispondere tramite comandi vocali.
  • La funzionalità di esecuzione immediata potrebbe non essere compatibile con l'emulatore Wear.
  • L'acquisizione di uno screenshot tramite programmazione, ad esempio utilizzando "adb" o tramite una segnalazione di bug, potrebbe non funzionare. Come soluzione alternativa, 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 chiamata in arrivo a uno smartphone compagno potrebbe non essere mostrata o _eseguire il mirroring_ come chiamata in arrivo nell'emulatore accoppiato. Di conseguenza, le notifiche delle chiamate perse potrebbero non essere visualizzate nell'emulatore. Inoltre, potresti non essere in grado di rispondere a una chiamata dall'emulatore, nel qual caso la chiamata continuerà a squillare.
  • Quando utilizzi Gestione SDK per installare o verificare di avere l'installazione più recente di Android P o la versione per la Cina, le caselle di controllo accanto a queste selezioni possono essere deselezionate dopo la selezione. Se vengono deselezionate, selezionale di nuovo.
  • Quando l'emulatore esegue un avvio a freddo, potrebbe essere visualizzato il seguente errore: "Si è verificato un problema interno con il tuo dispositivo. Contatta il produttore per maggiori dettagli". Ciò non influisce sulla funzionalità. Scorri verso il basso e fai clic su OK per iniziare a testare l'app.
  • La funzionalità di esecuzione immediata potrebbe non essere compatibile con l'emulatore Wear.
  • L'acquisizione di uno screenshot tramite programmazione, ad esempio utilizzando "adb" o tramite una segnalazione di bug, potrebbe non funzionare. Come soluzione alternativa, fai clic sul pulsante della fotocamera nella barra degli strumenti dell'emulatore per acquisire uno screenshot.

Assistente Google su Wear

Il supporto migliorato dell'assistente su Wear OS ti consente di creare un'esperienza pronta per i dispositivi indossabili senza scrivere codice Android. In particolare, puoi sviluppare per la piattaforma Actions on Google, aiutando 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 suggerimento. esegue le seguenti operazioni:

  • Aiutare gli utenti a completare rapidamente le interazioni
  • Fornire agli utenti suggerimenti sulle funzionalità dell'azione

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

Di conseguenza, puoi utilizzare DialogFlow, modelli o l'SDK Actions per creare Azioni su Google per Wear OS. Puoi anche usufruire di nuovi modelli di risposta specifici per uno smartwatch. Le best practice per le azioni su Google includono:

  • Dialoghi brevi e concisi
  • Attivazione 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 azioni su Google, consulta Eseguire l'integrazione con l'Assistente Google.

Risparmio energetico nella versione Developer Preview 2

Come descritto nella sezione seguente, sono disponibili funzionalità relative all'alimentazione per aumentare la durata della batteria. Le informazioni riportate in questa sezione di Developer Preview 2 superano le informazioni relative all'alimentazione per Developer Preview 1.

Nuova modalità: Risparmio energetico avanzato

Quando uno smartwatch è in modalità Risparmio energetico avanzato, viene visualizzato un quadrante predefinito ottimizzato per il risparmio energetico. Tutti i seguenti elementi vengono disattivati:

  • 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à, ad esempio pagare con NFC o rispondere a un messaggio. Supponiamo che gli app, i quadranti e i fornitori di dati delle complicazioni non siano disponibili in modalità 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 in carica. Le eccezioni includono i quadranti e le complicazioni attive.

Nota: se la tua app deve essere sempre in esecuzione, ad esempio per il monitoraggio in background, ti consigliamo di utilizzare un servizio in primo piano tramite 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 della salute.

Compatibilità con le app migliorata

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, fatecelo sapere.

Tema di sistema dell'interfaccia utente scuro

Dall'inizio del 2018, Wear OS è passato a un tema dell'interfaccia utente predefinito che ha un sfondo più scuro per lo stream di notifiche e il programma di avvio del sistema. Questa variazione ha lo scopo di migliorare la leggibilità delle tue app. Verifica l'accessibilità della tua app con questo nuovo tema dell'interfaccia utente.

Sono disponibili codelab aggiornati

Per aiutarti a esplorare modi importanti per sviluppare con Wear OS, sono disponibili codelab aggiornati. Ad esempio, prova il nuovo codelab sul quadrante basato su Kotlin per fare esperimenti con il linguaggio specifico per il dominio Kotlin o DSL.

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

Questa sezione contiene informazioni sulla versione Developer Preview 1 di Wear OS by Google. Prima della release finale in produzione, sono previsti diversi aggiornamenti a questa anteprima. Invia eventuali bug rilevati utilizzando il tracker dei problemi di Wear OS by Google. Prima le invii, maggiori sono le probabilità che possiamo includere le correzioni nella release finale.

Problemi noti

  • Nell'app complementare Wear OS, sembra che toccare Segnala bug del wearable funzioni, ma in realtà non viene generata alcuna segnalazione di bug. Utilizza adb bugreport come soluzione alternativa.
  • L'accettazione di una chiamata utilizzando lo smartwatch non sempre va a buon fine. In caso contrario, l'utente deve accettare la chiamata direttamente dal telefono.
  • A volte viene visualizzato un errore "Sono stati rilevati problemi di compatibilità con l'API" dopo l'accoppiamento o l'avvio di un'app precaricata. Questo messaggio di errore scompare dopo poco tempo e non influisce sull'usabilità.
  • Nel menu Impostazioni sullo smartwatch e nell'emulatore, l'opzione Crea segnalazione di bug viene visualizzata due volte. Per inviare una segnalazione di bug, prova a utilizzare ciascuna delle due opzioni, perché solo una è funzionale. Quando tocchi l'opzione funzionale, viene visualizzato un messaggio 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, questo accade con la ricerca vocale o quando usi i comandi vocali per aggiungere un promemoria perché questa funzionalità utilizza le API di input vocale. Per i test, utilizza l'input da tastiera o la scrittura a mano libera anziché l'input vocale.
  • L'app store Wear nella versione per la Cina non funziona. Gli sviluppatori non possono aggiornare o installare nuove app utilizzando questo canale. Ti consigliamo di utilizzare `adb` come soluzione alternativa per eseguire il sideload dell'applicazione per i test.

Punti salienti di questa anteprima per sviluppatori

La versione Developer Preview 1 include le seguenti funzionalità per il 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 i quadranti e le complicazioni selezionati dall'utente. Questa funzionalità verrà implementata gradualmente nelle anteprime per gli sviluppatori, pertanto potresti non visualizzarla immediatamente sul tuo smartwatch.

    Nota: se l'app deve essere sempre in esecuzione, modificala in modo da renderla un servizio in primo piano utilizzando il metodo startForegroundService(). Per ulteriori dettagli, consulta Limitazioni dei servizi in background.

  • Limitazioni all'utilizzo delle interfacce non SDK da parte delle app: per migliorare la compatibilità delle app, Android P ha iniziato a implementare alcune limitazioni all'utilizzo delle interfacce non SDK. Pianifica la migrazione dai metodi e dai campi non SDK. Se non è disponibile un equivalente pubblico per il tuo caso d'uso, comunicacelo.
  • Tema di sistema dell'interfaccia utente scuro:dall'inizio del 2018, su Wear OS è stato attivato un tema di interfaccia utente predefinito con uno sfondo più scuro per lo stream di notifiche e il programma di avvio del sistema. Lo scopo di questa modifica è migliorare la leggibilità delle tue app. Verifica l'accessibilità della tua app con questo nuovo tema dell'interfaccia utente.
  • I segnali radio sono disattivati quando lo smartwatch è lontano dal corpo: per migliorare la gestione dell'alimentazione, il segnale radio Bluetooth, il segnale radio Wi-Fi e il segnale radio cellulare sono disattivati quando lo smartwatch viene rilevato come lontano dal corpo per un periodo prolungato. Questa funzionalità verrà implementata gradualmente nelle anteprime per gli sviluppatori, quindi inizialmente potresti non vederla sul tuo smartwatch. Se questa funzionalità causa problemi nel processo di sviluppo, puoi disattivarla utilizzando "adb" con 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 della batteria, lo smartwatch non si connette più automaticamente al Wi-Fi quando si disconnette dal Bluetooth. Sono escluse le app che richiedono una rete ad alta larghezza di banda e lo smartwatch collegato a un caricabatterie. Questa funzionalità verrà implementata gradualmente nelle anteprime per gli sviluppatori, quindi inizialmente potresti non vederla sul tuo smartwatch.

Aggiornamenti alla libreria di assistenza per dispositivi indossabili, versione 2.3.0

L' aggiornamento della documentazione della versione 2.3.0 della Wearable Support Library 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 allegati agli intervalli di testo. Questi tipi di testo sono ora gestiti meglio. È possibile visualizzare solo un determinato sottoinsieme di span (consulta il metodo setText per i tipi di span che possono essere disegnati) in modo che non risultino 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 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 della raccolta Android Support Library contiene una nuova classe, AmbientModeSupport, che sostituisce la classe AmbientMode ora ritirata. Gli aggiornamenti dei sample sono previsti nelle prossime settimane.

25 gennaio 2018 - 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 per l'emulatore Android è disponibile per il test delle app basate sulla versione 26 dell'API.

Miglioramenti alla libreria di supporto per dispositivi indossabili, versione 2.2.0

La versione 2.2.0 della libreria di assistenza per i dispositivi indossabili include gli aggiornamenti descritti di seguito.

Un nuovo indicatore delle notifiche non lette

Poiché gli utenti vogliono essere a conoscenza delle notifiche non lette, viene fornito un nuovo indicatore: un punto cerchiato nella parte inferiore del quadrante. Se preferisci gestire autonomamente le notifiche, puoi utilizzare setHideNotificationIndicator per nascondere l'indicatore predefinito e visualizzare il tuo oppure setShowUnreadCountIndicator per visualizzare un 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 non lette non è abilitato nella versione di produzione di Wear 2.8.0. Testa l'implementazione utilizzando l'emulatore Wear più recente. A partire dalla prossima release per consumatori di Wear (versione 2.9.0), l'indicatore delle notifiche non lette 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 di TYPE_NO_PERMISSION, a indicare che al quadrante manca l'autorizzazione per recuperare i dati della complicazione.

Inoltre, la classe ComplicationDrawable si invalida al termine del caricamento delle immagini o quando un momento saliente del tocco scade. Per rispondere a questa invalidazione, ad esempio per ridisegnare il quadrante, aggiungi un Drawable.Callback.

Problemi noti

  • Se attivi la modalità Cinema nell'emulatore, come descritto in Modificare le impostazioni di schermo e luminosità, l'emulatore può rimanere bloccato in questa modalità. Per risolvere il problema, è necessario cancellare i dati dell'emulatore. Consulta Eseguire e arrestare un emulatore e cancellare i dati.
  • Nella finestra di un emulatore per il livello API 25 o 26, il tasto di accensione non funziona. Usa altri pulsanti oltre al tasto di accensione. Nello specifico, per passare alla modalità Ambient, ad esempio come se un utente avesse coperto lo schermo con il palmo, utilizza il pulsante di accensione nella barra degli strumenti dell'emulatore a destra del display. Per avviare il programma di avvio delle applicazioni in modalità interattiva, utilizza il pulsante Home sulla barra degli strumenti dell'emulatore.
  • Nella versione cinese dell'emulatore, se utilizzi il metodo di inserimento con scrittura a mano libera, lo schermo può iniziare a lampeggiare. Quando fai clic sul pulsante della tastiera sullo schermo, la tastiera blocca metà dello schermo.

18/12/2017 Nuovo accesso a Google Play Services

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

Eseguire la migrazione dal client GoogleApiClient

A partire dalla versione 11.8.0 di Google Play Services, esegui la migrazione delle app per Wear OS dalla classe GoogleApiClient e utilizza invece oggetti client API basati sulla classe GoogleApi e sull'API Tasks.

Nota: questo aggiornamento non si applica alle app per 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.