Wear OS-Versionshinweise

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

21. November 2024 – Wearable SDK 19.0.0

Die Wearable SDK-Version 19.0.0 enthält kleinere SDK-Updates. Folgende Updates sind jetzt verfügbar:

  • Bibliotheksabhängigkeiten auf die neuesten Versionen aktualisiert.
  • Eine nicht unterstützte sendMessage() API-Variante mit einem MessageOptions-Parameter wurde entfernt.

31. August 2023: Wearable SDK 18.1.0

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

20. September 2022 – Wearable SDK 18.0.0

Die Wearable SDK-Version 18.0.0 enthält kleinere API-Änderungen zur Unterstützung der nächsten Version 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 – Wearable Support Library Version 2.9.0

In Version 2.9.0 der Wearable Support Library 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 sind ein Ersatz für die Wearable-Supportbibliotheken und nicht für die gemeinsame Verwendung vorgesehen. Die Wearable Support Library funktioniert nicht unter Wear OS 3.

27. April 2021 – Wearable SDK 17.1.0

Die Wearable SDK-Version 17.1.0 enthält kleinere API-Änderungen zur Unterstützung der nächsten Version der Wearable Support Library.

28. September 2020: Wearable Support Library Version 2.8.1

Version 2.8.1 der Wearable Support Library enthält die folgende Änderung.

Jetifier bei Verwendung der Smartwatch-Vorlage deaktivieren

Die Android Studio-Zifferblattvorlage verwendet jetzt AndroidX-Abhängigkeiten, damit Jetifier deaktiviert werden kann. Diese Fehlerkorrekturen gelten für die Verwendung der Zifferblattvorlage mit Android Studio 4.2 oder höher.

24. September 2020: Wearable Support Library Version 2.8.0

Version 2.8.0 der Wearable Support Library enthält die folgenden Änderungen.

Fallback-Funktion zum Angeben von Standardanbietern für Zusatzfunktionen, die nicht zum System gehören

Bei Zifferblättern kann jetzt mit setDefaultComplicationProviderWithFallbacks ein oder mehrere Drittanbieter von Zusatzfunktionen angegeben werden, die standardmäßig verwendet werden sollen. Wenn keiner der angegebenen nicht systemeigenen Anbieter installiert ist, verwendet das System den standardmäßigen Systemanbieter.

WearableActivity eingestellt

WearableActivity wurde eingestellt. Verwenden Sie stattdessen AmbientModeSupport.

SKIP_CONFIRMATION_UI eingestellt

ActionConfirmationActivity.SKIP_CONFIRMATION_UI wurde eingestellt. Dieses Extra wird seit der Veröffentlichung von Wear 2.0 nicht mehr verwendet.

15. Mai 2020: Wearable Support Library Version 2.7.0

Version 2.7.0 der Wearable Support Library enthält die folgende Funktion.

Hardwarebeschleunigung für Zifferblätter

Wenn Sie die Klasse CanvasWatchFaceService verwenden, können Sie jetzt einen hardwarebeschleunigten Canvas anfordern. Mit der Hardwarebeschleunigung können Sie die Leistung Ihres Zifferblatts verbessern und auf mehr Daten zur UI-Leistung zugreifen.

Weitere Informationen finden Sie unter Leistung des Zifferblatts mit Hardwarebeschleunigung verbessern.

21. April 2020 – Wearable Support Library Version 2.6.0

Version 2.6.0 der Wearable Support Library enthält die folgende Verbesserung.

Migration zu Android Jetpack

Die Wearable Support Library wurde zu Android Jetpack migriert. Vorhandene Bibliotheken werden jetzt in AndroidX über den Namespace androidx zugeordnet und sind dort zugänglich. Alle Abhängigkeiten von der eingestellten Supportbibliothek wurden entfernt.

Durch diese Änderung können Sie die Wearable-Supportbibliotheken auch in Android Studio 4.0 und höher verwenden. Dadurch werden Probleme wie Problem 147972079 behoben.

28. August 2019 – Wearable Support Library Version 2.5.0

Version 2.5.0 der Wearable Support Library enthält die folgende Verbesserung.

Fehlerbehebung für ComplicationDrawable, wenn startActivity() mit dem Zusatz 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 eine android.util.AndroidRuntimeException zu vermeiden.

Durch diese Änderung wird beim Zusatztyp TYPE_NO_PERMISSION die Aktivität zur Berechtigungsanfrage korrekt gestartet, anstatt dass das Zifferblatt abstürzt.

25. September 2018 – Wearable SDK 16.0.0

Mit der Version 16.0.0 des Wearable SDK wird die erforderliche Version der Google Play-Dienste von Version 12.4 auf Version 8.6 gesenkt. Durch diese Änderung können vorhandene Apps auf die neueste Version des Wearable SDK aktualisiert werden, ohne dass das APK der Google Play-Dienste aktualisiert werden muss.

11. Juni 2018: Update auf die Wear OS-Entwicklervorschau 2

Durch ein kürzlich durchgeführtes Over-the-air-Update auf die Wear OS-Entwicklervorschau 2 wurden Wecker und Jobs für Hintergrund-Apps wieder aktiviert.

Diese Richtlinienänderung trägt zwar zu mehr Flexibilität bei der App-Entwicklung bei, Hintergrundalarme und ‑jobs unterliegen jedoch weiterhin anderen Einschränkungen von Android P, einschließlich derjenigen, die sich auf App-Standby-Buckets beziehen. Befolgen Sie die Best Practices, damit Ihre Apps ordnungsgemäß funktionieren, unabhängig davon, in welchem Bucket sie sich befinden.

Außerdem wird durch diese Aktualisierung der Datenschutz bei Nutzereingaben und Daten verbessert, da der Zugriff einer App im Hintergrund auf Nutzereingaben 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

Die Wear OS-Entwicklervorschau 2 bietet unter anderem eine verbesserte Google Assistant-Funktion.

Melden Sie Fehler oder geben Sie Feedback über die Wear OS by Google-Problemverfolgung. Je früher Sie sie einreichen, desto höher ist die Wahrscheinlichkeit, dass die Fehlerkorrekturen in der finalen Version enthalten sind.

Bekannte Probleme

In diesem Abschnitt werden bekannte Probleme für die Preview 2-Version aufgeführt.

Probleme mit dem Wear OS-Image

  • Wenn Sie sich in einer App befinden und die Ein-/Aus-Taste an der Seite der Smartwatch drücken, werden Sie möglicherweise nicht zum Zifferblatt, sondern zum vorherigen Bildschirm zurückgeleitet.

Probleme mit dem Wear OS-Image für China

  • Wenn Sie sich in einer App befinden und die Ein-/Aus-Taste an der Seite der Smartwatch drücken, werden Sie möglicherweise nicht zum Zifferblatt, sondern zum vorherigen Bildschirm zurückgeleitet.
  • Lautstärkebezogene Toneinstellungen werden nicht beibehalten. Ein eingehender Anruf führt beispielsweise dazu, dass die Smartwatch klingelt, auch wenn der Ton auf der Smartwatch deaktiviert ist. Wenn Sie die Weckerlautstärke anpassen, 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, Ihre App mit einer laufenden Benachrichtigung zu testen, anstatt mit mehreren.
  • Der Wear App Store in der China-Version funktioniert nicht. Entwickler können über diesen Kanal keine Apps aktualisieren oder neue Apps installieren. Wir empfehlen, „adb“ als Problemumgehung zu verwenden, um Ihre Anwendung zum Testen per Sideload zu installieren.

Probleme mit dem Wear-Emulator

  • Ein eingehender Anruf auf einem Companion-Smartphone wird nicht als eingehender Anruf im gekoppelten Emulator angezeigt oder gespiegelt.
  • Wenn Sie über den SDK-Manager die neueste Installation von Android P oder die China-Version installieren oder bestätigen, werden die Kästchen neben diesen Auswahlen möglicherweise wieder deaktiviert, nachdem Sie sie ausgewählt haben. Wenn die Auswahl aufgehoben wird, wählen Sie die Elemente noch einmal aus.
  • Wenn der Emulator einen Kaltstart ausführt, wird möglicherweise der folgende Fehler angezeigt: „Es gibt ein internes Problem mit Ihrem Gerät. Weitere Informationen erhalten Sie vom Hersteller.“ Die Funktionalität bleibt davon unberührt. Scrollen Sie nach unten und klicken Sie auf OK, um mit dem Testen Ihrer App zu beginnen.
  • Die Funktion „Sprachantwort“ funktioniert möglicherweise nicht auf dem Emulator. Wenn Sie beispielsweise eine Benachrichtigung für eine Google Hangouts-Nachricht im Wear-Emulator erhalten und versuchen, per Sprachbefehl darauf zu antworten, wird die Fehlermeldung „Google wird immer wieder angehalten“ angezeigt und Sie können nicht per Sprachbefehl antworten.
  • Instant Run ist möglicherweise nicht mit dem Wear-Emulator kompatibel.
  • Programmatische Screenshots, z. B. mit „adb“ oder über einen Fehlerbericht, funktionieren möglicherweise nicht. Als Problemumgehung können Sie in der Symbolleiste des Emulators auf die Kamerataste klicken, um einen Screenshot aufzunehmen.

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 gespiegelt. Benachrichtigungen zu verpassten Anrufen werden daher möglicherweise nicht im Emulator angezeigt. Außerdem können Sie einen Anruf möglicherweise nicht über den Emulator annehmen. In diesem Fall klingelt der Anruf weiter.
  • Wenn Sie über den SDK-Manager die neueste Installation von Android P oder die China-Version installieren oder bestätigen, werden die Kästchen neben diesen Auswahlen möglicherweise wieder deaktiviert, nachdem Sie sie ausgewählt haben. Wenn die Auswahl aufgehoben wird, wählen Sie die Elemente noch einmal aus.
  • Wenn der Emulator einen Kaltstart ausführt, wird möglicherweise der folgende Fehler angezeigt: „Es gibt ein internes Problem mit Ihrem Gerät. Weitere Informationen erhalten Sie vom Hersteller.“ Die Funktionalität bleibt davon unberührt. 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 Erstellen eines Screenshots programmatisch, z. B. mit „adb“ oder durch Erstellen eines Fehlerberichts, funktioniert möglicherweise nicht. Als Problemumgehung können Sie in der Symbolleiste des Emulators auf die Kamerataste klicken, um einen Screenshot aufzunehmen.

Google Assistant auf Wear

Dank der erweiterten Unterstützung für Assistant auf Wear OS können Sie eine Wearables-kompatible App entwickeln, ohne Android-Code schreiben zu müssen. Insbesondere können Sie für die Actions on Google-Plattform entwickeln und Nutzern so dabei helfen, mit Ihren Produkten und Diensten Aufgaben zu erledigen.

Außerdem unterstützt Wear OS jetzt schnellere Interaktionen per Sprachbefehl und Touchbedienung. Vorschlags-Chips werden ebenfalls unterstützt. Sie haben folgende Funktionen:

  • Nutzern helfen, Interaktionen schnell abzuschließen
  • Nutzern Hinweise zur Funktion Ihrer Aktion geben

Außerdem werden jetzt mehr visuelle Karten sowie Listen und Karussells unterstützt.

Sie können also DialogFlow, Vorlagen oder das Actions SDK verwenden, um Actions on Google für Wear OS zu erstellen. Außerdem stehen Ihnen neue, für Smartwatches optimierte Antwortvorlagen zur Verfügung. Best Practices für Actions on Google:

  • Kurzer, prägnanter Dialog
  • So aktivieren Sie sowohl visuelles als auch Sprachfeedback

Diese Verbesserungen für Assistant unter Wear OS sind unabhängig von Android P und werden für alle Wear 2.0-Nutzer eingeführt. Eine Einführung in die Erstellung von Actions on Google finden Sie unter In Google Assistant einbinden.

Energiesparmodus in der Entwicklervorschau 2

Wie im folgenden Abschnitt beschrieben, gibt es energiebezogene Funktionen, mit denen sich die Akkulaufzeit verlängern lässt. Die Informationen in diesem Abschnitt zur Entwicklervorschau 2 ersetzen die leistungsbezogenen Informationen zur Entwicklervorschau 1.

Neuer Modus: Erweiterter Energiesparmodus

Wenn sich eine Smartwatch im erweiterten Energiesparmodus befindet, wird ein standardmäßiges, energieoptimiertes Zifferblatt angezeigt. Folgende Funktionen sind deaktiviert:

  • Radios
  • Touchscreen
  • Die Funktion „Zum Aktivieren neigen“

Nutzer können die Uhrzeit aufrufen, indem sie kurz auf die seitliche Taste drücken. Durch langes Drücken kann der Nutzer zum vollständigen Betriebsmodus zurückkehren und Aufgaben wie das Bezahlen per NFC oder das Beantworten einer Nachricht ausführen. Angenommen, Apps, Zifferblätter und Datenanbieter für Zusatzfunktionen sind im erweiterten Energiesparmodus nicht verfügbar.

Begrenzte Hintergrundaktivität

Um die Energieverwaltung zu verbessern, können Apps im Hintergrund keine Wecker und Jobs mehr starten, es sei denn, die Smartwatch ist aufgeladen. Ausnahmen sind Zifferblätter und aktive Zusatzfunktionen.

Hinweis: Wenn Ihre App immer ausgeführt werden muss, z. B. für die Hintergrundüberwachung, empfehlen wir, einen Dienst im Vordergrund mit der Methode startForegroundService() zu verwenden. Weitere Informationen finden Sie unter Einschränkungen für Dienste im Hintergrund. Die Verwendung eines Dienstes im Vordergrund ist für außergewöhnliche Anwendungsfälle wie das Gesundheitsmonitoring geeignet.

Verbesserte App-Kompatibilität

Um die App-Kompatibilität zu verbessern, wurden in Android P Einschränkungen für die Verwendung von Nicht-SDK-Schnittstellen eingeführt. Planen Sie die Migration von Methoden und Feldern ohne SDK. Wenn für Ihren Anwendungsfall kein öffentliches Äquivalent verfügbar ist, teilen Sie uns dies bitte mit.

Dunkles Systemdesign

Seit Anfang 2018 verwendet Wear OS ein standardmäßiges UI-Design mit einem dunkleren Hintergrund für den Benachrichtigungsstream und den System-Launcher. Diese Änderung soll die Übersichtlichkeit Ihrer Apps verbessern. Prüfen Sie mit diesem neuen UI-Design die Barrierefreiheit Ihrer App.

Aktualisierte Codelabs verfügbar

Um Ihnen die Entwicklung mit Wear OS näher zu bringen, stehen aktualisierte Codelabs zur Verfügung. Im neuen Kotlin-basierten Codelab für Zifferblätter können Sie beispielsweise mit der Kotlin-spezifischen Sprache (DSL) experimentieren.

2018-March-27 Wear OS Developer Preview 1

Dieser Abschnitt enthält Informationen zur Entwicklervorschau 1 von Wear OS von Google. Vor der endgültigen Produktionsversion werden noch mehrere Updates für diese Vorabversion erwartet. Melden Sie gefundene Fehler über den Wear OS by Google-Problem-Tracker. Je früher Sie sie einreichen, desto höher ist die Wahrscheinlichkeit, dass wir die Fehlerkorrekturen in die endgültige Version aufnehmen können.

Bekannte Probleme

  • In der Wear OS-Companion App funktioniert das Tippen auf Wearable-Fehler melden anscheinend, aber es wird kein Fehlerbericht generiert. Verwenden Sie als Behelfslösung adb bugreport.
  • Es gelingt nicht immer, einen Anruf über die Smartwatch anzunehmen. Andernfalls muss der Nutzer den Anruf direkt auf dem Smartphone annehmen.
  • Nach dem Koppeln oder Starten einer vorinstallierten App wird manchmal die Fehlermeldung „Probleme mit der API-Kompatibilität erkannt“ angezeigt. Diese Fehlermeldung verschwindet nach kurzer Zeit und hat keine Auswirkungen auf die Nutzerfreundlichkeit.
  • Im Menü „Einstellungen“ auf der Smartwatch und im Emulator wird die Option Fehlerbericht abrufen zweimal angezeigt. Wenn Sie einen Fehlerbericht senden möchten, versuchen Sie es mit beiden Optionen, da nur eine funktioniert. Wenn Sie auf die funktionale Option tippen, wird eine Benachrichtigung angezeigt, dass ein Fehlerbericht generiert wird.
  • In der chinesischen Version führt die Spracheingabe zum Absturz einer App. Das ist beispielsweise bei der Sprachsuche oder wenn Sie per Sprachbefehl eine Erinnerung hinzufügen, der Fall, da für diese Funktionen APIs für die Spracheingabe verwendet werden. Verwenden Sie zum Testen die Tastatur- oder Handschrifteingabe anstelle der Spracheingabe.
  • Der Wear App Store in der China-Version funktioniert nicht. Entwickler können über diesen Kanal keine Apps aktualisieren oder neue Apps installieren. Wir empfehlen, „adb“ als Problemumgehung zu verwenden, um Ihre Anwendung zum Testen per Sideload zu installieren.

Highlights dieser Entwicklervorschau

Die Entwicklervorschau 1 umfasst die folgenden Funktionen für App-Tests:

  • Eingeschränkte Hintergrundaktivität:Um die Energieverwaltung zu verbessern, können Apps im Hintergrund keine Wecker und Jobs mehr verwenden. Ausnahmen sind Zifferblätter und Zusatzfunktionen, die der Nutzer ausgewählt hat. Diese Funktion wird nach und nach in den Entwicklervorschauen eingeführt. Sie ist daher möglicherweise nicht sofort auf Ihrer Smartwatch verfügbar.

    Hinweis:Wenn Ihre App immer ausgeführt werden muss, ändern Sie sie mit der Methode startForegroundService() in einen Dienst im Vordergrund. Weitere Informationen finden Sie unter Einschränkungen für Dienste im Hintergrund.

  • Einschränkungen für die Verwendung von Nicht-SDK-Schnittstellen in Apps:Um die App-Kompatibilität zu verbessern, wurden in Android P bestimmte Einschränkungen für die Verwendung von Nicht-SDK-Schnittstellen eingeführt. Planen Sie die Migration von Methoden und Feldern ohne SDK. Wenn für Ihren Anwendungsfall kein öffentliches Äquivalent verfügbar ist, teilen Sie uns dies bitte mit.
  • Dunkles Systemdesign:Seit Anfang 2018 verwendet Wear OS ein Standarddesign für die Benutzeroberfläche mit einem dunkleren Hintergrund für den Benachrichtigungsstream und den System-Launcher. Mit dieser Änderung soll die Übersichtlichkeit Ihrer Apps verbessert werden. Prüfen Sie mit diesem neuen UI-Design die Barrierefreiheit Ihrer App.
  • Funkschnittstellen werden deaktiviert, wenn die Smartwatch nicht am Körper getragen wird: Um die Energieverwaltung zu verbessern, werden die Bluetooth-, WLAN- und Mobilfunkschnittstellen deaktiviert, wenn die Smartwatch über einen längeren Zeitraum nicht am Körper getragen wird. Diese Funktion wird nach und nach in den Entwicklervorschauen eingeführt. Sie ist daher möglicherweise nicht sofort auf Ihrer Smartwatch zu sehen. Wenn diese Funktion Probleme in Ihrem Entwicklungsablauf verursacht, können Sie sie mit dem folgenden Befehl über „adb“ deaktivieren:
    adb shell settings put global off_body_radios_off_for_small_battery_enabled 0
  • WLAN ist deaktiviert, wenn die Bluetooth-Verbindung getrennt wird:Um die Energieverwaltung zu verbessern, stellt die Smartwatch nicht mehr automatisch eine Verbindung zum WLAN her, wenn die Bluetooth-Verbindung getrennt wird. Ausnahmen sind der Fall, dass eine App ein Netzwerk mit hoher Bandbreite anfordert, und der Fall, dass die Smartwatch an ein Ladegerät angeschlossen ist. Diese Funktion wird nach und nach in den Entwicklervorschauen eingeführt. Sie ist daher möglicherweise nicht sofort auf Ihrer Smartwatch zu sehen.

Aktualisierungen der Wearable Support Library, Version 2.3.0

Das Update der Version 2.3.0 der Dokumentation für die Wearable Support Library enthält Änderungen im Zusammenhang mit dem Rebranding.

Außerdem enthält Version 2.3.0 der Bibliothek Aktualisierungen im Zusammenhang mit ComplicationDrawable und TextRenderer für Text, an den Textbereiche mit Markup-Objekten angehängt sind. Bei diesen Klassen wurde die Verarbeitung von Texten mit mehreren Zeilen verbessert. Es kann nur ein bestimmter Teil der Spans gerendert werden. Die setText-Methode gibt Aufschluss über die Span-Typen, die gezeichnet werden können. So wirken die Spans nicht fehl am Platz, wenn sie in einem Zifferblatt gerendert werden.

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 Bildschirmschoners

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

Neue Klasse zur Unterstützung des Inaktivmodus

Die Version 27.1.0 der Android-Supportbibliothek enthält die neue Klasse AmbientModeSupport, die die jetzt eingestellte Klasse AmbientMode ersetzt. Aktualisierungen der Samples sind in den kommenden Wochen 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 letzte Wear-bezogene Update für den Android-Emulator ist verfügbar, um Apps auf Grundlage der API-Version 26 zu testen.

Verbesserungen in der Wearable Library, Version 2.2.0

Die Version 2.2.0 der Wearable Support Library enthält die unten beschriebenen Updates.

Eine neue Anzeige für ungelesene Benachrichtigungen

Da Nutzer über ungelesene Benachrichtigungen informiert werden möchten, gibt es einen neuen Indikator: einen Punkt in einem Kreis am unteren Rand des Zifferblatts. Wenn Sie Benachrichtigungen lieber selbst verwalten möchten, können Sie mit setHideNotificationIndicator die Standardanzeige ausblenden und Ihre eigene anzeigen lassen oder mit setShowUnreadCountIndicator eine Benachrichtigungszahl in der Statusleiste anzeigen lassen.

Mit der Methode setAccentColor können Sie die Farbe des äußeren Rings der Anzeige für ungelesene Benachrichtigungen anpassen.

Hinweis:In der Produktionsversion von Wear 2.8.0 ist die Anzeige für ungelesene Benachrichtigungen nicht aktiviert. Testen Sie Ihre Implementierung stattdessen mit dem neuesten Wear-Emulator. Ab der nächsten Wear-Version für Verbraucher (Version 2.9.0) wird der Indikator für ungelesene Benachrichtigungen standardmäßig angezeigt.

Verbesserungen an der Klasse „ComplicationDrawable“

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

Außerdem wird die ComplicationDrawable-Klasse ungültig, wenn das Laden von Bildern abgeschlossen ist oder ein Tipp-Highlight abläuft. Wenn Sie auf diese Ungültigkeit reagieren möchten, z. B. Ihr Zifferblatt neu zeichnen, fügen Sie ein Drawable.Callback hinzu.

Bekannte Probleme

  • Wenn Sie den Kinomodus im Emulator aktivieren, wie unter Einstellungen für Display und Helligkeit ändern beschrieben, bleibt der Emulator möglicherweise im Kinomodus. Um das Problem zu beheben, müssen Sie die Emulatordaten löschen. Weitere Informationen finden Sie unter Emulator ausführen und beenden und Daten löschen.
  • Im Fenster eines Emulators für API-Ebene 25 oder 26 funktioniert die Ein‑/Aus-Taste nicht. Verwenden Sie stattdessen andere Tasten als die Ein-/Aus-Taste. Wenn Sie zum Beispiel den Bildschirmschoner aktivieren möchten, als würde ein Nutzer das Display mit der Hand bedecken, verwenden Sie die Ein‑/Aus-Taste in der Symbolleiste des Emulators rechts neben dem Display. Wenn Sie den App Launcher im interaktiven Modus starten möchten, verwenden Sie die Schaltfläche „Startseite“ in der Emulator-Symbolleiste.
  • Wenn Sie in der chinesischen Version des Emulators die Eingabemethode für die Handschrift verwenden, kann das Display flackern. Wenn Sie dann auf die Schaltfläche für die Bildschirmtastatur klicken, blockiert die Tastatur die Hälfte des Displays.

18. Dezember 2017: Neuer Zugriff auf Google Play-Dienste

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

Migration von der GoogleApiClient-Klasse

Ab der Version 11.8.0 der Google Play-Dienste müssen Sie Ihre Wear-Apps 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, für die in der Regel Version 10.2.0 der Google Play-Dienste verwendet wird.

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:

implementation 'com.android.support:wear:27.0.0'
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.