Wear OS-Versionshinweise

Diese Seite enthält Informationen zu Wear OS-Releases, z. B. das Wearable SDK und die Wearable Support Library.

31. August 2023 Wearable SDK 18.1.0

Version 18.1.0 des Wearable SDK enthält kleinere API-Updates zur Unterstützung des nächsten Release der Wearable Support Library. Folgende Updates sind jetzt verfügbar:

  • Weitere Informationen zur Unterstützung beim Wechsel des Smartphones findest du unter NodeClient.OnNodeMigratedListener.
  • Zusätzliche Dokumentation für das Senden und Antworten von MessageClient-Nachrichten.
  • Links in API-Beschreibungen wurden aktualisiert.

20. September 2022 Wearable SDK 18.0.0

Version 18.0.0 des Wearable SDK enthält kleinere API-Updates zur Unterstützung des nächsten Release der Wearable Support Library. Folgende Updates sind jetzt verfügbar:

  • WearableListenerService-Unterstützung für Apps, die auf Android 13 ausgerichtet sind – Problem 235538840.
  • Neue MessageClient.sendRequest()-Methode.

16. Februar 2022 Support Library für Wearables, Version 2.9.0

In Version 2.9.0 der Wearable-Supportbibliothek werden alle verbleibenden Klassen eingestellt. Verwenden Sie stattdessen die Wear OS Jetpack-Bibliotheken.

29. Oktober 2021 Wear OS Jetpack Library

Die Wear OS Jetpack-Bibliotheken ersetzen die Wearable-Supportbibliotheken und sind nicht für die gemeinsame Verwendung in Kombination vorgesehen. Die Wearable-Supportbibliothek funktioniert nicht unter Wear OS 3.

27. April 2021 Wearable SDK 17.1.0

Version 17.1.0 des Wearable SDK enthält kleinere API-Updates zur Unterstützung des nächsten Release der Wearable Support Library.

28. September 2020 Wearable-Supportbibliothek, Version 2.8.1

Version 2.8.1 der Wearable-Supportbibliothek enthält die folgenden Änderungen.

Deaktivierung von Jetifier bei Verwendung der Zifferblatt-Vorlage zulassen

In der Zifferblatt-Vorlage von Android Studio werden jetzt AndroidX-Abhängigkeiten verwendet, um die Deaktivierung von Jetifier zu ermöglichen. Diese Fehlerkorrekturen gelten für die Verwendung der Zifferblatt-Vorlage mit Android Studio 4.2 oder höher.

24. September 2020 Wearable-Supportbibliothek, Version 2.8.0

Version 2.8.0 der Wearable-Supportbibliothek enthält die folgenden Änderungen.

Fallback-Funktion zum Festlegen von Standardanbietern für systemfremde Zusatzfunktionen

Zifferblätter können jetzt mit setDefaultComplicationProviderWithFallbacks einen oder mehrere systemfremde Zusatzfunktionen angeben, die standardmäßig verwendet werden sollen. Wenn keiner der angegebenen Systemanbieter installiert ist, verwendet das System wieder den Standardsystemanbieter.

WearableActivity eingestellt

WearableActivity wurde eingestellt. Verwenden Sie stattdessen AmbientModeSupport.

SKIP_confirmATION_UI eingestellt

ActionConfirmationActivity.SKIP_CONFIRMATION_UI wurde eingestellt. Diese Extras wurden seit der Veröffentlichung von Wear 2.0 nicht verwendet.

15. Mai 2020 Wearable Support Library, Version 2.7.0

Version 2.7.0 der Wearable-Supportbibliothek enthält die folgende Funktion.

Hardwarebeschleunigung für Zifferblätter

Bei Verwendung der Klasse CanvasWatchFaceService können Sie jetzt ein hardwarebeschleunigtes Canvas anfordern. Nutze die Hardwarebeschleunigung, um die Leistung deines Zifferblatts zu verbessern und auf mehr UI-Leistungsdaten zuzugreifen.

Weitere Informationen findest du unter Leistung des Zifferblatts durch Hardwarebeschleunigung verbessern.

21. April 2020 Wearable Support Library Version 2.6.0

Version 2.6.0 der Wearable-Supportbibliothek umfasst die folgende Verbesserung.

Migration zu Android Jetpack

Die Wearable-Supportbibliothek wurde zu Android Jetpack migriert. Vorhandene Bibliotheken werden jetzt über den androidx-Namespace in AndroidX zugeordnet und können dort aufgerufen werden. Alle Abhängigkeiten in der eingestellten Support Library wurden entfernt.

Durch diese Änderung kannst du auch die Wearable-Supportbibliotheken in Android Studio 4.0 und höher verwenden, wodurch Probleme wie Problem #147972079 behoben werden.

28. August 2019: Wearable-Supportbibliothek, Version 2.5.0

Version 2.5.0 der Wearable-Supportbibliothek enthält die folgende Verbesserung.

Fehlerkorrektur für ComplicationDrawable, wenn startActivity() mit dem Zusatztyp TYPE_NO_PERMISSION aufgerufen wird

ComplicationDrawable enthält jetzt ein NEW_TASK-Flag, das dafür sorgt, dass startActivity()-Aufrufe, die von einem WatchFaceService stammen, FLAG_ACTIVITY_NEW_TASK enthalten, um android.util.AndroidRuntimeException zu vermeiden.

Durch diese Änderung kann der Komplikationstyp TYPE_NO_PERMISSION die Aktivität für Berechtigungsanfragen ordnungsgemäß starten, anstatt das Zifferblatt abzustürzen.

25. September 2018 Wearable SDK 16.0.0

Version 16.0.0 des Wearable SDK verringert die erforderliche Version der Google Play-Dienste von Version 12.4 auf Version 8.6. Durch diese Änderung können vorhandene Apps auf die neueste Version des Wearable SDK aktualisiert werden, ohne dass ein Update auf das Google Play-Dienste-APK erforderlich ist.

11. Juni 2018: Aktualisierung der Wear OS-Entwicklervorschau 2

Durch ein kürzlich erfolgtes Over The Air-Update für die Wear OS Developer Preview 2 wurden Alarme und Jobs für Hintergrund-Apps wieder aktiviert.

Diese Richtlinienänderung ermöglicht zwar mehr Flexibilität bei der App-Entwicklung, Hintergrundalarme und -Jobs unterliegen aber weiterhin anderen Android P-Einschränkungen, einschließlich denen für App-Standby-Buckets. Halten Sie sich an die Best Practices, damit Ihre Anwendungen einwandfrei funktionieren – unabhängig davon, in welchem Bucket sie sich befinden.

Dieses Update verbessert auch den Datenschutz für Nutzereingaben und Datenschutz, da der Zugriff einer Hintergrund-App auf Nutzereingabe- und Sensordaten eingeschränkt wird. Je nach den Anforderungen einer App müssen Sie möglicherweise einen Dienst im Vordergrund verwenden, um einen kontinuierlichen Zugriff auf Sensordaten zu ermöglichen.

8. Mai 2018: Wear OS-Entwicklervorschau 2

Wear OS-Entwicklervorschau 2 bietet Funktionen wie eine verbesserte Nutzung von Google Assistant.

Fehler und Feedback können Sie über die Problemverfolgung zu Wear OS by Google melden. Je früher Sie sie einreichen, desto höher ist die Wahrscheinlichkeit, dass die Korrekturen im endgültigen Release enthalten sind.

Bekannte Probleme

In diesem Abschnitt werden bekannte Probleme für die Vorabversion 2 beschrieben.

Probleme mit dem Wear OS-Image

  • Wenn Sie während einer beliebigen App die Ein/Aus-Taste an der Seite der Smartwatch drücken, gelangen Sie möglicherweise zum vorherigen Bildschirm und nicht zum Zifferblatt zurück.

Probleme mit dem Bild von Wear OS für China

  • Wenn Sie während einer beliebigen App die Ein/Aus-Taste an der Seite der Smartwatch drücken, gelangen Sie möglicherweise zum vorherigen Bildschirm und nicht zum Zifferblatt zurück.
  • Lautstärkebezogene Toneinstellungen werden nicht beibehalten. Bei einem eingehenden Anruf klingelt beispielsweise die Uhr, selbst wenn der Ton auf der Uhr ausgeschaltet ist. Wenn du die Alarmlautstärke anpasst, hat die Änderung keine Auswirkungen.
  • Mehrere laufende Benachrichtigungen werden möglicherweise nicht richtig angezeigt. Wenn beispielsweise sowohl ein Timer als auch eine Stoppuhr eingestellt sind, werden keine Benachrichtigungen angezeigt. Wir empfehlen dir, deine App mit einer einzigen Benachrichtigung statt mit mehreren zu testen.
  • Der Wear App-Shop in der chinesischen Version funktioniert nicht. Entwickler können über diesen Kanal keine neuen Apps aktualisieren oder installieren. Wir empfehlen die Verwendung von "adb" als Behelfslösung, damit die Anwendung zum Testen per Sideload übertragen werden kann.

Probleme mit dem Wear-Emulator

  • Ein eingehender Anruf auf einem Companion-Smartphone wird im gekoppelten Emulator nicht angezeigt oder _mirrored_.
  • Wenn du den SDK-Manager verwendest, um Android P oder die chinesische Version zu installieren oder zu bestätigen, dass du die neueste Version von Android P oder China installiert hast, kann die Auswahl der Kästchen neben dieser Auswahl aufgehoben werden. Wenn die Auswahl aufgehoben wird, wählen Sie sie ein zweites Mal aus.
  • Wenn der Emulator einen Kaltstart ausführt, wird möglicherweise der folgende Fehler angezeigt: „Es liegt ein internes Problem mit Ihrem Gerät vor. Wende dich für weitere Informationen an den Hersteller.“ Dies wirkt sich nicht auf die Funktionalität aus. Scrollen Sie nach unten und klicken Sie auf OK, um mit dem Testen Ihrer App zu beginnen.
  • Die Sprachantworten funktionieren im Emulator möglicherweise nicht. Wenn Sie beispielsweise eine Benachrichtigung für eine Google Hangouts-Nachricht im Wear-Emulator erhalten und versuchen, die Nachricht per Spracheingabe zu beantworten, wird die Fehlermeldung „Google wird ständig beendet“ angezeigt und Sie können nicht mehr per Spracheingabe antworten.
  • Instant Run ist möglicherweise nicht mit dem Wear-Emulator kompatibel.
  • Das programmatische Erstellen eines Screenshots, z. B. mit „ADB“ oder durch Erstellen eines Fehlerberichts, funktioniert möglicherweise nicht. Sie können das Problem umgehen, indem Sie in der Symbolleiste des Emulators auf die Kameraschaltfläche klicken, um einen Screenshot zu erstellen.

Probleme mit der chinesischen Version des Wear-Emulators

  • Ein eingehender Anruf auf einem Companion-Smartphone wird möglicherweise nicht als eingehender Anruf im gekoppelten Emulator angezeigt oder _mirrored_. Daher werden Benachrichtigungen über verpasste Anrufe möglicherweise nicht im Emulator angezeigt. Außerdem kannst du möglicherweise einen Anruf vom Emulator nicht annehmen. In diesem Fall klingelt der Anruf weiter.
  • Wenn du den SDK-Manager verwendest, um Android P oder die chinesische Version zu installieren oder zu bestätigen, dass du die neueste Version von Android P oder China installiert hast, kann die Auswahl der Kästchen neben dieser Auswahl aufgehoben werden. Wenn die Auswahl aufgehoben wird, wählen Sie sie ein zweites Mal aus.
  • Wenn der Emulator einen Kaltstart durchführt, wird möglicherweise der folgende Fehler angezeigt: „Es gibt ein internes Problem mit Ihrem Gerät. Wende dich für weitere Informationen an den Hersteller.“ Dies wirkt sich nicht auf die Funktionalität aus. Scrollen Sie nach unten und klicken Sie auf OK, um mit dem Testen Ihrer App zu beginnen.
  • Instant Run ist möglicherweise nicht mit dem Wear-Emulator kompatibel.
  • Das programmatische Erstellen eines Screenshots wie z. B. mit „ADB“ oder durch Erstellen eines Fehlerberichts funktioniert möglicherweise nicht. Sie können das Problem umgehen, indem Sie in der Symbolleiste des Emulators auf die Kameraschaltfläche klicken, um einen Screenshot zu erstellen.

Google Assistant auf Wear OS

Mit der erweiterten Unterstützung für Assistant unter Wear OS kannst du eine Wearable-fähige App entwickeln, ohne Android-Code schreiben zu müssen. Insbesondere kannst du Apps für die Actions on Google-Plattform entwickeln und deinen Nutzern dabei helfen, Aufgaben mit deinen Produkten und Diensten zu erledigen.

Außerdem unterstützt Wear OS jetzt schnellere Interaktionen per Sprachbefehl und Berührung. Vorschlags-Chips werden ebenfalls unterstützt. Das Team führt folgende Schritte aus:

  • Nutzenden helfen, Interaktionen schnell abzuschließen
  • Gib den Nutzern Hinweise auf die Fähigkeiten deiner Aktion

Außerdem unterstützt Wear OS jetzt mehr visuelle Karten, Listen und Karussells.

Daher kannst du DialogFlow, Vorlagen oder das Actions SDK verwenden, um Actions on Google für Wear OS zu erstellen. Sie können auch neue, uhrspezifische Antwortvorlagen nutzen. Zu den Best Practices für Actions on Google gehören:

  • Kurzer, prägnanter Dialog
  • Ermöglichen von visuellem und mündlichem Feedback

Diese Verbesserungen für Assistant unter Wear OS hängen nicht von Android P ab und werden für alle Wear 2.0-Nutzer eingeführt. Eine Einführung in das Erstellen von Actions on Google finden Sie unter In Google Assistant einbinden.

Akkueinsparungen in Entwicklervorschau 2

Wie im folgenden Abschnitt beschrieben, sind strombezogene Funktionen verfügbar, um die Akkulaufzeit zu verlängern. Die Informationen in diesem Abschnitt der Entwicklervorschau 2 ersetzen die Informationen zur Leistung der Entwicklervorschau 1.

Neuer Modus: Verbesserter Energiesparmodus

Während sich eine Smartwatch im erweiterten Energiesparmodus befindet, wird ein standardmäßig optimiertes Zifferblatt angezeigt. Folgendes ist deaktiviert:

  • Funkgeräte
  • Touchscreen
  • Die Funktion „Zum Aktivieren neigen“

Die Nutzer können kurz auf die seitliche Taste drücken, um die Uhrzeit zu sehen. Durch langes Drücken kann der Nutzer in einen voll funktionsfähigen Modus zurückwechseln und Aufgaben ausführen, z. B. Zahlungen mit NFC oder Antworten auf eine Nachricht. Angenommen, Datenanbieter für Apps, Zifferblätter und Zusatzfunktionen sind im erweiterten Energiesparmodus nicht verfügbar.

Eingeschränkte Hintergrundaktivität

Zur Verbesserung der Energieverwaltung können Apps im Hintergrund nur dann Alarme und Jobs starten, wenn die Uhr aufgeladen wird. Ausnahmen sind Zifferblätter und aktive Zusatzfunktionen.

Hinweis: Wenn Ihre App immer ausgeführt werden muss, z. B. für das Hintergrundmonitoring, empfehlen wir die Verwendung eines Diensts im Vordergrund mithilfe der Methode startForegroundService(). Weitere Informationen finden Sie unter Einschränkungen von Hintergrunddiensten. Die Verwendung eines Diensts im Vordergrund eignet sich für außergewöhnliche Anwendungsfälle wie die Gesundheitsüberwachung.

Verbesserte App-Kompatibilität

Um die App-Kompatibilität zu verbessern, hat Android P damit begonnen, bestimmte Einschränkungen für die Verwendung von Nicht-SDK-Schnittstellen zu implementieren. Planen Sie die Migration weg von Nicht-SDK-Methoden und -Feldern. Wenn für Ihren Anwendungsfall kein öffentliches Äquivalent verfügbar ist, informieren Sie uns.

Dunkles UI-Systemdesign

Seit Anfang 2018 wurde Wear OS zu einem Standard-UI-Design mit einem dunkleren Hintergrund für den Benachrichtigungsstream und den System Launcher gewechselt. Diese Änderung soll die Übersichtlichkeit deiner Apps verbessern. Mit diesem neuen UI-Design kannst du die Barrierefreiheit deiner App prüfen.

Aktualisierte Codelabs verfügbar

Damit du wichtige Möglichkeiten zur Entwicklung mit Wear OS entdecken kannst, sind aktualisierte Codelabs verfügbar. Probieren Sie beispielsweise das neue Kotlin-basierte Zifferblatt-Codelab aus, um mit der domainspezifischen Kotlin-Sprache DSL zu experimentieren.

27. März 2018 – Wear OS-Entwicklervorschau 1

Dieser Abschnitt enthält Informationen zur Entwicklervorschau 1 von Wear OS by Google. Für diese Vorschau werden vor dem endgültigen Produktionsrelease mehrere Updates erwartet. Melde alle gefundenen Fehler über die Wear OS by Google-Problemverfolgung. Je früher du sie einreichst, desto höher ist die Wahrscheinlichkeit, dass wir die Korrekturen in den endgültigen Release aufnehmen können.

Bekannte Probleme

  • Wenn du in der Wear OS-Companion-App auf Wearable-Fehler melden tippst, scheint es zu funktionieren, es wird aber kein Fehlerbericht generiert. Verwenden Sie als Behelfslösung adb bugreport.
  • Das Annehmen eines Anrufs über die Smartwatch ist nicht immer erfolgreich. Ist dies nicht der Fall, muss der Nutzer den Anruf direkt über das Telefon annehmen.
  • Manchmal wird nach dem Koppeln oder Starten einer vorab geladenen App der Fehler „Probleme mit der API-Kompatibilität erkannt“ angezeigt. Diese Fehlermeldung verschwindet nach kurzer Zeit und wirkt sich nicht auf die Nutzerfreundlichkeit aus.
  • Im Menü „Einstellungen“ auf der Uhr und im Emulator wird die Option Fehlerbericht erstellen zweimal angezeigt. Wenn Sie einen Fehlerbericht erstellen möchten, nutzen Sie jede der beiden Optionen, da nur eine funktioniert. Wenn Sie auf die Option „Funktion“ tippen, wird ein Hinweis angezeigt, dass ein Fehlerbericht erstellt wird.
  • In der chinesischen Version führt die Spracheingabe zum Absturz einer App. Dies tritt beispielsweise bei der Sprachsuche auf oder wenn Sie Erinnerungen per Spracheingabe hinzufügen, da diese Funktion APIs für die Spracheingabe verwendet. Verwenden Sie zum Testen statt Spracheingabe die Tastatur- oder Handschrifteingabe.
  • Der Wear App Store in der chinesischen Version funktioniert nicht. Entwickler können über diesen Kanal keine neuen Apps aktualisieren oder installieren. Wir empfehlen die Verwendung von „adb“ als Behelfslösung, um Ihre Anwendung zum Testen per Sideload zu übertragen.

Wichtige Informationen in dieser Entwicklervorschau

Entwicklervorschau 1 enthält die folgenden Funktionen für App-Tests:

  • Eingeschränkte Hintergrundaktivität: Zur Verbesserung der Energieverwaltung können Apps im Hintergrund keine Wecker und Jobs mehr verwenden. Ausgenommen sind Zifferblätter und Zusatzfunktionen, die der Nutzer ausgewählt hat. Diese Funktion wird nach und nach in den Entwicklervorschauen eingeführt. Es kann also sein, dass du sie nicht sofort auf deiner Uhr siehst.

    Hinweis: Wenn Ihre App immer ausgeführt werden muss, ändern Sie sie mithilfe der Methode startForegroundService() so, dass sie zu einem Dienst im Vordergrund wird. Weitere Informationen finden Sie unter Einschränkungen von Hintergrunddiensten.

  • Einschränkungen für die Verwendung von Nicht-SDK-Schnittstellen in Apps:Um die App-Kompatibilität zu verbessern, hat Android P damit begonnen, bestimmte Einschränkungen für die Verwendung von Nicht-SDK-Schnittstellen zu implementieren. Planen Sie die Migration weg von Nicht-SDK-Methoden und -Feldern. Wenn für Ihren Anwendungsfall kein öffentliches Äquivalent verfügbar ist, informieren Sie uns.
  • Dunkles UI-Systemdesign:Seit Anfang 2018 wird Wear OS zu einem UI-Standarddesign mit einem dunkleren Hintergrund für den Benachrichtigungsstream und den System Launcher gewechselt. Diese Änderung soll die Übersichtlichkeit deiner Apps verbessern. Mit diesem neuen UI-Design kannst du die Barrierefreiheit deiner App prüfen.
  • Das Radio ist ausgeschaltet, wenn die Uhr ausgeschaltet ist: Zur Verbesserung der Energieverwaltung sind Bluetooth-, WLAN- und Mobilfunkempfang deaktiviert, wenn die Uhr über einen längeren Zeitraum außerhalb des Körpers erkannt wird. Diese Funktion wird nach und nach in den Entwicklervorschauen eingeführt. Es kann also sein, dass du sie anfangs nicht auf deiner Uhr siehst. Wenn dieses Feature im Entwicklungsprozess Probleme verursacht, können Sie es mithilfe von „adb“ mit dem folgenden Befehl deaktivieren:
    adb shell settings put global off_body_radios_off_for_small_battery_enabled 0
  • WLAN ist deaktiviert, wenn Bluetooth nicht verbunden ist: Zur Verbesserung der Energieverwaltung stellt die Smartwatch nicht mehr automatisch eine Verbindung zum WLAN her, wenn die Bluetooth-Verbindung der Smartwatch getrennt wird. Ausnahmen sind Fälle, in denen eine App ein Netzwerk mit hoher Bandbreite anfordert, und das Gehäuse der Uhr, das an ein Ladegerät angeschlossen ist. Diese Funktion wird nach und nach in den Entwicklervorschauen eingeführt. Es kann also sein, dass du sie anfangs nicht auf deiner Uhr siehst.

Updates für die Wearable-Supportbibliothek, Version 2.3.0

Das Dokumentationsupdate 2.3.0 für die Wearable-Supportbibliothek enthält Updates zum Rebranding.

Außerdem enthält Version 2.3.0 der Bibliothek Aktualisierungen in Bezug auf ComplicationDrawable und TextRenderer für Text, bei dem Markup-Objekte an Textbereiche angehängt sind. Diese Klassen haben die Verarbeitung von spanned-Texten verbessert. Es kann nur ein bestimmter Teil der Spans gerendert werden. Informationen zu den Span-Typen, die gezeichnet werden können, finden Sie in der setText-Methode.

15. März 2018: Rebranding von Wear

Dieser Abschnitt enthält Informationen zu Wear OS-Funktionen.

Neuer Name für Android Wear

Android Wear wird in Wear OS by Google umbenannt.

27. Februar 2018: Aktualisierung des Ambient-Modus

Dieser Abschnitt enthält Informationen zu neuen Android Wear-Funktionen.

Neue Klasse zur Unterstützung des Inaktivmodus

Die Version 27.1.0 der Android Support Library enthält die neue Klasse AmbientModeSupport, die die mittlerweile eingestellte AmbientMode-Klasse ersetzt. In den kommenden Wochen sind Aktualisierungen für Beispiele geplant.

25. Januar 2018: Endgültiger Emulator und mehr

Dieser Abschnitt enthält Informationen zu neuen Android Wear-Funktionen.

Android-Emulator: Update für Wear

Das endgültige Update für Wear OS für den Android-Emulator ist zum Testen von Apps verfügbar, die auf API-Version 26 basieren.

Verbesserungen in der Wearable-Supportbibliothek, Version 2.2.0

Die Version 2.2.0 der Wearable-Supportbibliothek enthält die unten beschriebenen Updates.

Eine neue Anzeige für ungelesene Benachrichtigungen

Da Nutzer über ungelesene Benachrichtigungen informiert werden möchten, wird ein neuer Indikator angezeigt: ein eingekreister Punkt unten auf dem Zifferblatt. Wenn Sie die Benachrichtigungen selbst verwalten möchten, können Sie setHideNotificationIndicator verwenden, um die Standardanzeige auszublenden und eigene einzublenden, oder setShowUnreadCountIndicator, um die Anzahl der Benachrichtigungen in der Statusleiste anzuzeigen.

Passen Sie die Farbe des äußeren Rings der Anzeige für ungelesene Benachrichtigungen mit der Methode setAccentColor an.

Hinweis:Die Anzeige für ungelesene Benachrichtigungen ist in der Produktionsversion von Wear 2.8.0 nicht aktiviert. Teste deine Implementierung stattdessen mit dem neuesten Wear-Emulator. Ab dem nächsten Nutzerrelease von Wear (Version 2.9.0) wird die Anzeige für ungelesene Benachrichtigungen standardmäßig angezeigt.

Verbesserungen an der Klasse „ComplicationDrawable“

Die Klasse ComplicationDrawable startet eine Berechtigungsanfrage für ein Zifferblatt, auf das getippt wird, wenn das System den Wert TYPE_NO_PERMISSION anzeigt. Das bedeutet, dass das Zifferblatt keine Berechtigung zum Abrufen der Zusatzfunktionen hat.

Außerdem wird die Klasse ComplicationDrawable ungültig, wenn sie mit dem Laden von Bildern fertig ist oder wenn eine Hervorhebung durch Tippen abläuft. Wenn du auf die Entwertung reagieren möchtest und beispielsweise dein Zifferblatt neu zeichnen möchtest, füge eine Drawable.Callback hinzu.

Bekannte Probleme

  • Wenn Sie den Kinomodus im Emulator aktivieren, wie unter Einstellungen für Bildschirm und Helligkeit ändern beschrieben, bleibt der Emulator im Kinomodus hängen. Um das Problem zu beheben, müssen die Emulatordaten gelöscht werden. Weitere Informationen finden Sie unter Emulator ausführen und beenden und Daten löschen.
  • Im Emulatorfenster für API-Level 25 oder 26 funktioniert die Ein/Aus-Taste nicht. Verwenden Sie stattdessen eine andere als die Ein/Aus-Taste. Um in den Inaktivmodus zu wechseln, z. B. so, als ob ein Nutzer das Display mit der Handfläche bedeckt, drücke die Ein/Aus-Taste in der Symbolleiste des Emulators rechts neben dem Bildschirm. Wenn du den App Launcher im interaktiven Modus starten möchtest, verwende die Home-Schaltfläche in der Symbolleiste des Emulators.
  • Wenn Sie in der chinesischen Version des Emulators die handschriftliche Eingabemethode verwenden, kann der Bildschirm blinken. Wenn Sie dann auf die Schaltfläche für die Bildschirmtastatur klicken, blockiert die Tastatur den halben Bildschirm.

18.12.2017 Neuer Zugriff auf Google Play-Dienste

Dieser Abschnitt enthält Informationen zu neuen Android Wear-Funktionen.

Von der GoogleApiClient-Klasse migrieren

Ab Version 11.8.0 der Google Play-Dienste solltest du deine Wear-Apps weg von der Klasse GoogleApiClient migrieren und stattdessen API-Clientobjekte verwenden, die auf der Klasse GoogleApi und der Tasks API basieren.

Hinweis:Dieses Update gilt nicht für Android Wear-Apps für China, die im Allgemeinen Version 10.2.0 der Google Play-Dienste verwenden.

Weitere Informationen finden Sie hier:

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.