Wear

In dieser Tabelle sind alle Artefakte in der Gruppe androidx.wear aufgeführt.

Abhängigkeiten deklarieren

Wenn Sie eine Abhängigkeit von Wear hinzufügen möchten, müssen Sie Ihrem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie im Maven-Repository von Google.

Fügen Sie der Datei build.gradle für Ihre App oder Ihr Modul die Abhängigkeiten für die erforderlichen Artefakte hinzu:

dependencies {
    implementation "androidx.wear:wear:1.3.0"

    // Add support for wearable specific inputs
    implementation "androidx.wear:wear-input:1.1.0"
    implementation "androidx.wear:wear-input-testing:1.1.0"

    // Use to implement wear ongoing activities
    implementation "androidx.wear:wear-ongoing:1.0.0"

    // Use to implement support for interactions from the Wearables to Phones
    implementation "androidx.wear:wear-phone-interactions:1.0.1"
    // Use to implement support for interactions between the Wearables and Phones
    implementation "androidx.wear:wear-remote-interactions:1.0.0"
}

dependencies {
    implementation("androidx.wear:wear:1.3.0")

    // Add support for wearable specific inputs
    implementation("androidx.wear:wear-input:1.1.0")
    implementation("androidx.wear:wear-input-testing:1.1.0")

    // Use to implement wear ongoing activities
    implementation("androidx.wear:wear-ongoing:1.0.0")

    // Use to implement support for interactions from the Wearables to Phones
    implementation("androidx.wear:wear-phone-interactions:1.0.1")
    // Use to implement support for interactions between the Wearables and Phones
    implementation("androidx.wear:wear-remote-interactions:1.0.0")
}

Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.

Feedback

Ihr Feedback hilft uns, Jetpack zu verbessern. Bitte teilen Sie uns mit, wenn Sie neue Probleme feststellen oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie ein neues erstellen. Sie können einem vorhandenen Problem Ihre Stimme geben, indem Sie auf die Schaltfläche mit dem Stern klicken.

Neues Problem erstellen

Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.

Wear Core-Version 1.0

Version 1.0.0-alpha01

29. Mai 2024

androidx.wear:wear-core:1.0.0-alpha01 wird veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.

API-Änderungen

• Es wurde eine neue Klasse WearApiVersionhelper hinzugefügt, die bei der Laufzeitprüfung der API-Kompatibilität auf Wear hilft. Clients können diese statische Hilfsklasse und die bereitgestellte Methode (#isApiVersionAtLeast(VERSION)) verwenden, um die Kompatibilität zu prüfen.

Wear Tooling Preview Version 1.0

Version 1.0.0

29. November 2023

androidx.wear:wear-tooling-preview:1.0.0 wird veröffentlicht. Version 1.0.0 enthält diese Commits.

Funktionen in 1.0.0

• Fügen Sie WearDevices hinzu, um gültige Wear-Geräte aufzulisten, die für UI-Vorschauen verwendet werden können.

Version 1.0.0-rc01

15. November 2023

androidx.wear:wear-tooling-preview:1.0.0-rc01 wird ohne Änderungen veröffentlicht. Version 1.0.0-rc01 enthält diese Commits.

Version 1.0.0-beta01

18. Oktober 2023

androidx.wear:wear-tooling-preview:1.0.0-beta01 wird ohne Änderungen veröffentlicht. Version 1.0.0-beta01 enthält diese Commits.

Version 1.0.0-alpha01

23. August 2023

androidx.wear:wear-tooling-preview:1.0.0-alpha01 wird veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.

API-Änderungen

• Fügen Sie WearDevices zur Liste der Wear-Geräte hinzu, die für UI-Vorschauen verwendet werden können (Ib036e)

Wear-Version 1.4

Version 1.4.0-alpha01

15. November 2023

androidx.wear:wear:1.4.0-alpha01 wird veröffentlicht. Version 1.4.0-alpha01 enthält diese Commits.

Fehlerkorrekturen

• Zentrieren Sie das Symbol ConfirmationOverlay vertikal, wenn keine Nachricht vorhanden ist. (I496d8)

Wear-Version 1.3

Version 1.3.0

9. August 2023

androidx.wear:wear:1.3.0 wird seit 1.3.0-rc01 unverändert veröffentlicht. Version 1.3.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.2.0

• Migrieren Sie AmbientModeSupport zu LifecycleObserver. AmbientModeSupport wird zugunsten der neuen sitzungsspezifischen Klassen eingestellt.
• ConfirmationOverlay mit neuen Symbolen/Layout, Schriftarten und Schriftmetriken aktualisieren
• SwipeDismissTransitionHelper wurde aktualisiert, um ein Hintergrund-Drawable anstelle eines zweiten View zu verwenden, um Fehler bei der Verwendung der FragmentContainerView zu beheben.
• Die SwipeDismissFrameLayout-Animation wurde aktualisiert, damit sie mit der Wear-Plattform und den Wear Compose-Implementierungen übereinstimmt.
• SwipeDismissFrameLayout Fehlerbehebung, um das versehentliche Schließen von Fragmenten durch vertikales Wischen zu verhindern
• ArcLayout unterstützt jetzt Erweiterungsgewichte, die ähnlich wie normale Layoutgewichte funktionieren.
• layoutDirection auf ArcLayout unterstützen

Version 1.3.0-rc01

21. Juni 2023

androidx.wear:wear:1.3.0-rc01 wird seit 1.3.0-beta01 unverändert veröffentlicht. Version 1.3.0-rc01 enthält diese Commits.

Version 1.3.0-beta01

7. Juni 2023

androidx.wear:wear:1.3.0-beta01 wird veröffentlicht. Version 1.3.0-beta01 enthält diese Commits.

API-Änderungen

• AmbientLifecycleObserver wurde nach Feedback aktualisiert. AmbientLifecycleObserverInterface wurde in AmbientLifecycleObserver umbenannt. Eine Instanz kann durch Aufrufen von AmbientLifecycleObserver(...) abgerufen werden. isAmbient ist jetzt ein Feld und keine Methode mehr. (I84b4f)

Fehlerkorrekturen

• Es wurden Null-Prüfungen hinzugefügt, um Fälle zu behandeln, in denen die übergeordnete Ansicht null ist, während Alpha und Übersetzung in SwipeToDismiss zurückgesetzt werden. (Ib0ec7)

Version 1.3.0-alpha05

19. April 2023

androidx.wear:wear:1.3.0-alpha05 wird veröffentlicht. Version 1.3.0-alpha05 enthält diese Commits.

API-Änderungen

• Migrieren Sie AmbientModeSupport zu LifecycleObserver. AmbientModeSupport wird zugunsten der neuen sitzungsspezifischen Klassen eingestellt. (I1593b)

Fehlerkorrekturen

• Aktualisieren Sie den Ansatz für den SwipeDismissTransitionHelper-Hintergrund-Scrim, um Drawables zu verwenden, anstatt eine Ansicht hinzuzufügen, um Fehler bei der Verwendung von FragmentContainerView zu beheben. (I851cd)

Version 1.3.0-alpha04

25. Januar 2023

androidx.wear:wear:1.3.0-alpha04 wird veröffentlicht. Version 1.3.0-alpha04 enthält diese Commits.

Fehlerkorrekturen

• Wir haben die Animation in SwipeDismissFrameLayout aktualisiert, damit sie mit der Wear-Plattform und den Wear Compose-Implementierungen übereinstimmt. (I7261b)

Version 1.3.0-alpha03

24. August 2022

androidx.wear:wear:1.3.0-alpha03 wird veröffentlicht. Version 1.3.0-alpha03 enthält diese Commits.

Neue Funktionen

• ArcLayout unterstützt jetzt Erweiterungsgewichte, die ähnlich wie normale Layoutgewichte funktionieren. So können Sie die relative Größe von untergeordneten Elementen angeben, ohne ihre Winkel direkt berechnen zu müssen. Außerdem haben wir die Option „Bestes Ergebnis“ MaxAngleDegrees hinzugefügt, die beim Maximieren von untergeordneten Elementen mit Gewichten berücksichtigt wird. Sie können den Bogen beispielsweise mit mehreren untergeordneten Elementen mit Gewichten auf 90 Grad festklemmen. Dabei wird auch der Platz berücksichtigt, den nicht maximierte Elemente einnehmen.

API-Änderungen

• Wir haben ArcLayout.LayoutParams ein Gewicht hinzugefügt, damit sich ein Widget maximieren und den verfügbaren Platz ausfüllen kann. Wenn es mehrere Widgets gibt, ist ihr Anteil am verfügbaren Platz proportional zu ihrem Gewicht. Außerdem haben wir ArcLayout.setMaxAngleDegrees hinzugefügt, damit Sie die Ausweitung beispielsweise auf 90 Grad begrenzen können. Hinweis: Das Layout von untergeordneten Widgets mit fester Größe wird dadurch nicht beeinflusst. Schließlich gibt es jetzt ArcLayout.Widget mit setSweepAngleDegrees, mit dem ArcLayout ein Widget über seine Größe informieren kann, wenn das Gewicht nicht null ist. (I75f24)
• Aktualisierte Nullbarkeit von setColorFilter(I99ddf, b/236498063)

Version 1.3.0-alpha02

23. Februar 2022

androidx.wear:wear:1.3.0-alpha02 wird veröffentlicht. Version 1.3.0-alpha02 enthält diese Commits.

Neue Funktionen

• Unterstützung von layoutDirection auf ArcLayout (I14d49)
• Verbesserte Beschreibung für ConfirmationOverlay (I0fdf8)
• Aktualisieren Sie ConfirmationOverlay mit neuen Symbolen/Layout. (If5b54)

Fehlerkorrekturen

• ProGuard-Regeln hinzugefügt, damit der Code für den Bildschirmschoner beibehalten wird (Idaa10)
• Verhindern, dass Fragmente im SwipeDismissFrameLayout durch ein vertikales Wischen versehentlich geschlossen werden (Idb6d8)
• Fehler im ConfirmationOverlay beheben, wenn keine Nachricht vorhanden ist (I63e6f)

Externer Beitrag

• Dae Gyu LEE (Samsung) – Vermeidung des versehentlichen Schließens von Fragmenten im SwipeDismissFrameLayout durch eine vertikale Wischbewegung (Idb6d8)

Version 1.3.0-alpha01

29. September 2021

androidx.wear:wear:1.3.0-alpha01 wird veröffentlicht. Version 1.3.0-alpha01 enthält diese Commits.

Fehlerkorrekturen

• ConfirmationOverlay schiebt das Symbol jetzt nach oben, um längere Nachrichten unterzubringen, ohne dass die Nachricht in den Rahmen des Geräts ragt oder außerhalb des Displays angezeigt wird. (I54bff)

Wear-Version „Ongoing & Interactions“ 1.1.0

Version 1.1.0-alpha05

11. Dezember 2024

androidx.wear:wear-phone-interactions:1.1.0-alpha05 wird veröffentlicht. Version 1.1.0-alpha05 enthält diese Commits.

Fehlerkorrekturen

• Behebung eines Absturzfehlers bei der Ausführung unter Wear OS 5.1 (API-Version 34) und Ausrichtung auf neuere Versionen des SDK. Apps sollten auf diese Version der Bibliothek aktualisiert werden, bevor die targetSdkVersion auf 35 oder höher aktualisiert wird.

Version 1.1.0

11. Dezember 2024

androidx.wear:wear-remote-interactions:1.1.0 wird veröffentlicht. Version 1.1.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.0.0

• Wir haben RemoteActivityHelper.isRemoteActivityHelperAvailable hinzugefügt, mit dem Sie prüfen können, ob die Funktion zum Starten einer Remote-Aktivität verfügbar ist. (I107a9)

Version 1.1.0-rc01

16. Oktober 2024

androidx.wear:wear-remote-interactions:1.1.0-rc01 wird seit 1.1.0-beta01 unverändert veröffentlicht. Version 1.1.0-rc01 enthält diese Commits.

Version 1.1.0-beta01

24. Juli 2024

androidx.wear:wear-remote-interactions:1.1.0-beta01 wird veröffentlicht. Version 1.1.0-beta01 enthält diese Commits. Die Version 1.3.0-beta01 von Wear Remote Interactions gibt an, dass diese Version der Bibliothek funktionsfähig ist und die API gesperrt ist (außer wenn sie als experimentell gekennzeichnet ist).

Version 1.1.0-alpha04

10. Januar 2024

androidx.wear:wear-phone-interactions:1.1.0-alpha04 wird veröffentlicht. Version 1.1.0-alpha04 enthält diese Commits.

API-Änderungen

• Wir haben RemoteAuthClient.isRemoteAuthAvailable hinzugefügt, mit dem geprüft wird, ob die Remote-Authentifizierung verfügbar ist. (Ibc10c)

Version 1.1.0-alpha02

10. Januar 2024

androidx.wear:wear-remote-interactions:1.1.0-alpha02 wird veröffentlicht. Version 1.1.0-alpha02 enthält diese Commits.

API-Änderungen

• Wir haben RemoteActivityHelper.isRemoteActivityHelperAvailable hinzugefügt, mit dem Sie prüfen können, ob die Funktion zum Starten einer Remote-Aktivität verfügbar ist. (I107a9)
• Wir haben den Konstruktor von RemoteActivityHelper aktualisiert, damit er einen optionalen Parameter enthält, der mit Java kompatibel ist. (I75554)

Version 1.1.0-alpha01

21. Juni 2023

androidx.wear:wear-remote-interactions:1.1.0-alpha01 wird veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.

Fehlerkorrekturen

• Die Fertigstellung und Fehlerbehandlung in RemoteActivityHelper wurde verbessert. (I60d60)

Externer Beitrag

• Entfernen Sie die Guava-Abhängigkeit aus wear-remote-interactions und verwenden Sie kleinere Alternativen.

Wear-Phone-Interactions Version 1.1.0-alpha03

9. März 2022

androidx.wear:wear-phone-interactions:1.1.0-alpha03 wird veröffentlicht. Version 1.1.0-alpha03 enthält diese Commits.

Fehlerkorrekturen

• redirectUrl von OAuthRequest gibt jetzt einen leeren String zurück, wenn die Weiterleitungs-URL nicht in der angegebenen Anfrage-URL festgelegt ist. (I44242)

Wear-Phone-Interactions Version 1.1.0-alpha02

15. Dezember 2021

androidx.wear:wear-phone-interactions:1.1.0-alpha02 wird veröffentlicht. Version 1.1.0-alpha02 enthält diese Commits.

Fehlerkorrekturen

• Beheben Sie die Fehler in der RemoteAuthClient-Dokumentation, einschließlich des Fehlers im Codebeispiel-Snippet und des defekten Links zu ErrorCode (I260e8).

Wear-Phone-Interactions Version 1.1.0-alpha01

15. September 2021

androidx.wear:wear-phone-interactions:1.1.0-alpha01 wird veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.

API-Änderungen

• Property redirectUrl wurde OAuthRequest hinzugefügt. (I98840, Ie684d)

Wear-Version „Ongoing & Interactions“ 1.0.0

Wear-Phone-Interactions Version 1.0.1

15. Dezember 2021

androidx.wear:wear-phone-interactions:1.0.1 wird veröffentlicht. Version 1.0.1 enthält diese Commits.

Fehlerkorrekturen

• Es wurde eine behobene Ausnahme von der BridgingManager geworfen, wenn versucht wurde, Bridging-Benachrichtigungen ohne excludedTags zu deaktivieren.

Wear-Phone-Interactions Wear-Remote-Interactions Version 1.0.0

15. September 2021

androidx.wear:wear-phone-interactions:1.0.0 und androidx.wear:wear-remote-interactions:1.0.0 werden freigegeben. Version 1.0.0 enthält diese Commits.

Wichtige Funktionen von 1.0.0

Die Phone Interaction Library enthält APIs für Interaktionen zwischen Wearables und Smartphones. Sie enthält Folgendes:

• PhoneDeviceType, mithilfe derer sich der Typ des Smartphones ermitteln lässt, mit dem die aktuelle Smartwatch gekoppelt ist. Diese Methoden sind nur auf Wearables verfügbar.
• BridgingManager-, BridgingManagerService- und BridgingConfig-APIs, um Benachrichtigungen zur Laufzeit zu aktivieren/deaktivieren und optional Tags für Benachrichtigungen festzulegen, die vom Bridging-Modus ausgenommen sind.
• RemoteAuthClient, die die Remote-Authentifizierung auf Wearables und die OAuth PKCE-Erweiterung unterstützt. Es werden zusätzliche Handler und Hilfsklassen für die Kommunikation bereitgestellt.

Die Remote Interaction Library enthält APIs für Interaktionen zwischen Wearables und Smartphones. Sie enthält Folgendes:

• WatchFaceConfigIntentHelper, mit Hilfsfunktionen zur Angabe der ID und des Komponentennamens in den Aktivitäten zur Zifferblattkonfiguration für den Companion auf dem Smartphone.
• RemoteActivityHelper-Klasse, die zum Öffnen von Intents auf anderen Geräten verwendet werden kann (z.B. von der Smartwatch zum Smartphone).

Wear-Phone-Interactions Wear-Remote-Interactions Version 1.0.0-rc01

1. September 2021

androidx.wear:wear-phone-interactions:1.0.0-rc01 und androidx.wear:wear-remote-interactions:1.0.0-rc01 werden freigegeben. Version 1.0.0-rc01 enthält diese Commits.

Fehlerkorrekturen

• Fehler behoben, der verhinderte, dass bei Verwendung von RemoteActivityHelper Fehler, die in Google Play-Diensten auftreten, an den Aufrufer weitergegeben wurden (I60d60)
• Fehler behoben, durch den RemoteActivityHelper seine Future nie erfüllte, wenn keine verbundenen Knoten vorhanden waren oder die angeforderte Knoten-ID nicht gefunden wurde (I60d60)

Wear-Ongoing Version 1.1

Version 1.1.0-alpha01

23. August 2023

androidx.wear:wear-ongoing:1.1.0-alpha01 wird veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.

API-Änderungen

• Fügen Sie der laufenden Aktivität ein Feld für die Inhaltsbeschreibung hinzu. Dieser Wert wird von Bedienungshilfen verwendet, um die laufende Aktivität zu beschreiben. (I79fc6)

Fehlerkorrekturen

• @RequiresPermission wurde APIs hinzugefügt, für die die Berechtigung POST_NOTIFICATIONS in SDK 33 und höher gewährt werden muss. (Ie542e, b/238790278)

Wear-Ongoing-Version 1.0.0

1. September 2021

androidx.wear:wear-ongoing:1.0.0 wird veröffentlicht. Version 1.0.0 enthält diese Commits.

Wichtige Funktionen von 1.0.0

• Die Wear Ongoing Activities API ist eine API für Entwickler, einschließlich Drittanbietern, mit der sie ihre Aktivität als „Aktuelle Aktivität“ kennzeichnen und die erforderlichen Informationen zur Verfügung stellen können.
• „Laufende Aktivitäten“ bezieht sich auf Aktivitäten, die im Hintergrund der Smartwatch ausgeführt werden können (z.B. Trainings, Anrufe und Medien). Unter Wear 3 wird eine als aktiv deklarierte Aktivität durch ein spezielles Overlay-Symbol auf dem Zifferblatt und ein anderes Rendering im App Launcher hervorgehoben.
• Weitere Informationen finden Sie im Leitfaden zu laufenden Aktivitäten in Wear.

Wear-Phone-Interactions Wear-Remote-Interactions Version 1.0.0-beta01

18. August 2021

androidx.wear:wear-phone-interactions:1.0.0-beta01 und androidx.wear:wear-remote-interactions:1.0.0-beta01 werden freigegeben. Version 1.0.0-beta01 enthält diese Commits.

API-Änderungen

• Die Klasse RemoteIntentHelper wurde in RemoteActivityHelper umbenannt. Die Funktionen RemoteIntentHelper#getRemoteIntentExtraIntent und RemoteIntentHelper#getRemoteIntentNodeId wurden in RemoteActivityHelper#getTargetIntent und RemoteActivityHelper#getTargetNodeId umbenannt. (Id2042)

Wear-Ongoing Version 1.0.0-rc01

18. August 2021

androidx.wear:wear-ongoing:1.0.0-rc01 wird seit 1.0.0-beta01 unverändert veröffentlicht. Version 1.0.0-rc01 enthält diese Commits.

Wear-Ongoing-Version 1.0.0-beta01

4. August 2021

androidx.wear:wear-ongoing:1.0.0-beta01 wird veröffentlicht. Version 1.0.0-beta01 enthält diese Commits.

API-Änderungen

• Einige Setter für OngoingActivity.Builder akzeptieren jetzt ein Nullargument, um Setter und Getter symmetrisch und konsistent zu gestalten (I17ee5)

Wear-Phone-Interactions Version 1.0.0-alpha07

4. August 2021

androidx.wear:wear-phone-interactions:1.0.0-alpha07 wird veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.

API-Änderungen

• WearTypeHelper.isChinaDevice wurde in WearTypeHelper.isChinaBuild umbenannt. (I47302)
• Wir haben die RemoteAuthClient-Bibliothek aktualisiert, damit die redirect_uri automatisch basierend auf dem Gerätetyp (RoW/China) ausgewählt wird. (I38866)
• Ein Fehler wurde behoben, durch den die Umwandlung von BridgingConfig in/aus Bundle mit ClassCastException fehlgeschlagen ist. Es wurden Unit-Tests für die Klasse „BridgingManagerService“ hinzugefügt. (I68ecb)

Wear-Remote-Interactions Version 1.0.0-alpha06

4. August 2021

androidx.wear:wear-remote-interactions:1.0.0-alpha06 wird veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.

Wear-Phone-Interactions Version 1.0.0-alpha06

21. Juli 2021

androidx.wear:wear-phone-interactions:1.0.0-alpha06 wird veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.

API-Änderungen

• Die Klasse BridgingManagerSeviceBinder ist jetzt eine Unterklasse von „Service“ und wurde in „BridgingManagerService“ umbenannt. (I9fca2)
• Die Methode RemoteAuthClient.Callback.onAuthorizationError wurde geändert, um den Parameter „OAuthRequest“ einzubinden. Für Methoden, die einen Callback erfordern, ist jetzt auch ein Executor erforderlich, auf dem der Callback ausgeführt werden soll. (I35e11)

Fehlerkorrekturen

• Wir haben die Authentifizierungs-API klarer gestaltet, indem wir mehr dokumentierte Parameter verwendet und nach Möglichkeit Properties verwendet haben. (I12287)

Wear-Phone-Interactions Version 1.0.0-alpha05

30. Juni 2021

androidx.wear:wear-phone-interactions:1.0.0-alpha05 wird veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.

Fehlerkorrekturen

• Dokumentierte Parameter, die im Konstruktor für BridgingConfig.Builder übergeben werden sollten.

Wear-Ongoing-Version 1.0.0-alpha06

2. Juni 2021

androidx.wear:wear-ongoing:1.0.0-alpha06 wird veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.

API-Änderungen

• Fügen Sie der laufenden Aktivität ein Titelfeld hinzu. (I7a405)

Fehlerkorrekturen

• SerializationHelper.copy() erstellt jetzt eine defensive Kopie der Informationen (I8b276)
• Verbesserte Dokumentation für „setCategory“ (Iff01f)

Wear-Ongoing Version 1.0.0-alpha05

18. Mai 2021

androidx.wear:wear-ongoing:1.0.0-alpha05 wird veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.

API-Änderungen

• OngoingActivity hat jetzt Getter, mit denen alle Werte abgerufen werden können, die direkt über den Builder festgelegt wurden (oder die Standardwerte aus der zugehörigen Benachrichtigung). (Id8ac8)

  • Die neue Klasse Status wird jetzt verwendet, um den Status der OngoingActivity zu erstellen.
  • OngoingActivityData und OngoingActivityStatus sind nicht mehr Teil der öffentlichen API.

• Die Klassen TextStatusPart und TimerStatusPart sind nicht mehr Teil der öffentlichen API. (I57fb6)

  • Wenn Sie eine Part mit statischem Text erstellen möchten, verwenden Sie Status.TextPart.
  • Wenn Sie eine Part mit einer Stoppuhr (aufwärts zählend) erstellen möchten, verwenden Sie Status.Stopwatch.
  • Wenn du eine Part mit einem Timer erstellen möchtest, verwende Status.Timer.

Wear-Ongoing Version 1.0.0-alpha04

5. Mai 2021

androidx.wear:wear-ongoing:1.0.0-alpha04 wird veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.

API-Änderungen

• Bei „OngoingActivity“ werden die Methoden von „fromExistingOngoingActivity“ jetzt „recoverOngoingActivity“ genannt.
• Für „OngoingActivity“ gibt es jetzt eine vollständige Reihe von Gettern, die zuvor nur unter „OngoingActivityData“ verfügbar waren. (I0ee4d)

Wear-Remote-Interactions Version 1.0.0-alpha05

21. Juli 2021

androidx.wear:wear-remote-interactions:1.0.0-alpha05 wird veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.

API-Änderungen

• Wir haben die Klasse RemoteIntentHelper hinzugefügt (früher RemoteIntent in der Wearable Support Library), die zum Öffnen von Intents auf anderen Geräten verwendet werden kann (z.B. von der Smartwatch auf dem Smartphone). (I1d7e0)

• Die Klasse „PlayStoreAvailability“ wurde aus der AndroidX-Bibliothek entfernt. Wenn Sie feststellen möchten, ob der Play Store auf einem verbundenen Smartphone verfügbar ist, verwenden Sie die Methode androidx.phone.interactions.PhoneTypeHelper.getPhoneDeviceType, um festzustellen, ob es sich um ein Android-Smartphone handelt. Verwenden Sie dann die androidx.wear.utils.WearTypeHelper.isChinaDevice-Methode, um festzustellen, ob es sich bei dem verbundenen Smartphone um ein chinesisches Gerät handelt. Wenn es sich um ein Android-Smartphone handelt und nicht um ein chinesisches Gerät, ist der Play Store verfügbar. (Ie7dec)

Wear-Phone-Interactions Version 1.0.0-alpha04

7. April 2021

androidx.wear:wear-phone-interactions:1.0.0-alpha04 wird veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.

API-Änderungen

• Die ErrorCode-Konstanten wurden aktualisiert, damit die neue Bibliothek abwärtskompatibel mit der Implementierung in der Wearable Support Library ist.

Fehlerkorrekturen

• Behobene Ausnahme, die durch die neue OAuth API beim Starten einer OAuth-Sitzung verursacht wurde.

Wear-Remote-Interactions Version 1.0.0-alpha03

7. April 2021

androidx.wear:wear-remote-interactions:1.0.0-alpha03 wird veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.

API-Änderungen

• PlayStoreAvailability in eine Klasse geändert, die ein zugehöriges Objekt mit statischen Methoden enthält Die Nutzung bleibt gleich.

Fehlerkorrekturen

• Im Zusammenfassungsdokument für WatchFaceConfigIntentHelper wurde der Beispielcode mit den tatsächlichen HTML-Zeichen korrigiert.

Wear-Ongoing Wear-Phone-Interactions Version 1.0.0-alpha03

10. März 2021

androidx.wear:wear-ongoing:1.0.0-alpha03 und androidx.wear:wear-phone-interactions:1.0.0-alpha03 werden freigegeben. Version 1.0.0-alpha03 enthält diese Commits.

Neue Funktionen

• OAuthClient von der Wearable-Supportbibliothek zu AndroidX migrieren Diese migrierte Klasse wurde in „RemoteAuthClient“ umbenannt und unterstützt die Remote-Authentifizierung auf Wearables sowie die OAuth PKCE-Erweiterung. Es werden zusätzliche Handler und Hilfsklassen für die Kommunikation bereitgestellt.
• Mit dem neuen Konstruktor „OngoingActivity.Builder“ können laufende Aktivitäten jetzt einer Benachrichtigung mit einem Tag zugeordnet werden.

API-Änderungen

• Unterstützung für Benachrichtigungs-Tags in der Bibliothek für laufende Aktivitäten hinzugefügt (I653b4)
• OAuthClient von der Wear-Supportbibliothek zu AndroidX migrieren und Unterstützung für die OAuth-PKCE-Erweiterung hinzufügen (I3eaaa)

Wear-Remote-Interactions Version 1.0.0-alpha02

10. März 2021

androidx.wear:wear-remote-interactions:1.0.0-alpha02 wird veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.

Neue Funktionen

• Die Klasse „PlayStoreAvailability“ wird von der Wearable Support Library zu AndroidX migriert. AndroidX bietet eine API, mit der geprüft werden kann, ob der Play Store auf dem Smartphone verfügbar ist.

Fehlerkorrekturen

• Migration der Klasse „PlayStoreAvailability“ aus der Wearable Support Library zu AndroidX (I69bfe)

Version 1.0.0-alpha02

10. Februar 2021

androidx.wear:wear-ongoing:1.0.0-alpha02 und androidx.wear:wear-phone-interactions:1.0.0-alpha02 werden freigegeben. Version 1.0.0-alpha02 enthält diese Commits.

API-Änderungen

• Unterstützung für komplexere Status hinzugefügt. Sie bestehen aus einer oder mehreren Vorlagen und einer Reihe von Teilen, mit denen die Platzhalter der Vorlage ausgefüllt werden. OngoingActivityStatus hat jetzt eine statische Methode zum Erstellen einfacher Status mit nur einem Teil (Text oder Timer) und einen Builder zum Erstellen komplexerer Status. (I1fe81)
• Die Klassen „BridgingManager“ und „BridgingConfig“ wurden aus der Wear-Supportbibliothek in AndroidX verschoben. Dort gibt es APIs, mit denen Benachrichtigungen zur Laufzeit aktiviert oder deaktiviert werden können und optional Tags für Benachrichtigungen festgelegt werden können, die vom Bridging-Modus ausgenommen sind. (I3a17e)

Version 1.0.0-alpha01

27. Januar 2021

androidx.wear:wear-ongoing:1.0.0-alpha01, androidx.wear:wear-phone-interactions:1.0.0-alpha01 und androidx.wear:wear-remote-interactions:1.0.0-alpha01 werden losgelassen. Version 1.0.0-alpha01 enthält diese Commits.

API-Änderungen

• Migrieren Sie die Bibliothek „Ongoing Activities“ (Laufende Aktivitäten) in eine neue untergeordnete Bibliothek: „wear-ongoing“. Klassen befinden sich jetzt im Paket „androidx.wear.ongoing“ (früher „androidx.wear.ongoingactivities“) (I7c029)

• Erstellen Sie eine neue Supportbibliothek mit Klassen, die Interaktionen zwischen Wearables und Smartphones unterstützen. Sie wird anfangs mit Klassen aus der Wearable Support Library gefüllt. (Id5180)

• Die Klasse „PhoneDeviceType“ aus der Wearable-Supportbibliothek zu AndroidX migrieren Die migrierte Klasse wird in PhoneTypeHelper umbenannt. Sie bietet Hilfsmethoden zum Ermitteln des Typs des Smartphones, mit dem die aktuelle Smartwatch gekoppelt ist. Sie kann nur auf Wearables verwendet werden. (Ibd947)

• Erstellen Sie eine neue Supportbibliothek mit Klassen, die Interaktionen zwischen Wearables und Smartphones unterstützen. Sie wird anfangs mit Klassen aus der Wearable Support Library gefüllt. (I9deb4)

• Migrieren Sie die Klasse „WatchFaceCompanion“ von der Wearable Support Library zu AndroidX. Die migrierte Klasse wird in „WatchFaceConfigIntentHelper“ umbenannt. Sie bietet Hilfsfunktionen zum Angeben der ID und des Komponentennamens in den Aktivitäten zur Zifferblattkonfiguration im Companion auf dem Smartphone. Sie kann auch lokal verwendet werden, um das Zifferblatt auf dem Wearable zu konfigurieren. (Ia455f)

Wear-Zusatzfunktionen und -Zifferblatt 1.0.0

Version 1.0.0-alpha22

15. September 2021

androidx.wear:wear-*:1.0.0-alpha22 wird veröffentlicht. Version 1.0.0-alpha22 enthält diese Commits.

Neue Funktionen

• Die EditorSession abonniert jetzt Lebenszyklusbeobachter, sodass Sie sie nicht mehr explizit schließen müssen, wenn Ihre Aktivität endet.

API-Änderungen

• Für EditorSession und ListenableEditorSession werden jetzt Kotlin-StateFlows für complicationSlotsState, ComplicationsPreviewData und ComplicationsDataSourceInfo verwendet. (I761d9)
• EditorSession#userStyle ist jetzt ein MutableStateFlow<UserStyle> (I32ca9)
• Für EditorSession.createOnWatchEditorSession wird jetzt ein Lebenszyklus-Beobachter verwendet. Er wird automatisch geschlossen, wenn onDestroy beobachtet wird. Außerdem muss für createOnWatchEditorSession nur noch die Aktivität übergeben werden. Dieselben Änderungen wurden auch auf ListenableEditorSession angewendet. (Ic6b7f)
• Der Konstruktor von „CustomValueUserStyleSetting“ wurde als Teil der öffentlichen API reaktiviert. (I2e69a)
• UserStyle wird jetzt von Map<UserStyleSetting, UserStyleSetting.Option> abgeleitet und MutableUserStyleSetting#put wirft eine IllegalArgumentException, wenn die Einstellung nicht im Schema enthalten ist oder die Option nicht mit der Einstellung übereinstimmt. (Iba40f)

Version 1.0.0-alpha21

1. September 2021

androidx.wear:wear-*:1.0.0-alpha21 wird veröffentlicht. Version 1.0.0-alpha21 enthält diese Commits.

API-Änderungen

• Alle öffentlichen APIs für Zifferblätter, Clients, Editoren und Zusatzfunktionen verwenden jetzt java.time.Instant für Uhrzeiten anstelle von Long. Daher wurde die Mindest-API-Ebene auf 26 erhöht. (I3cd48)
• Die APIs für Zifferblätter und Zusatzfunktionen verwenden jetzt die unveränderliche ZonedDateTime anstelle von Calendar. (I25cf8)
• Zusatzfunktionen werden jetzt mit NoDataComplicationData initialisiert. „ComplicationSlot.complicationData“ hat jetzt immer einen Wert und „CanvasComplicationDrawable.complicationData“ ist nicht mehr nullable. (I4dfd6) Dadurch wird das Flimmern von Zusatzfunktionen beim Wechseln zwischen Zifferblättern reduziert, aber nicht vollständig verhindert.

Version 1.0.0-alpha20

18. August 2021

androidx.wear:wear-*:1.0.0-alpha20 wird veröffentlicht. Version 1.0.0-alpha20 enthält diese Commits.

API-Änderungen

• Wir haben der ComplicationDataSourceInfo die Funktion „createFallbackPreviewData“ hinzugefügt, die verwendet werden kann, wenn „ComplicationDataSourceInfoRetriever.retrievePreviewComplicationData“ null zurückgibt. (I38c4d)
• „ComplicationDataSourceUpdateRequester“ wurde in eine Schnittstelle umgewandelt, um das Mocking in Unit-Tests zu ermöglichen. Sie können einen konkreten ComplicationDataSourceUpdateRequester mit ComplicationDataSourceUpdateRequester.create() erstellen. (I7da22)
• „RenderParameters.pressedComplicationSlotIds“ wurde durch „RenderParameters.lastComplicationTapDownEvents“ ersetzt, das die neue TapEvent-Klasse enthält. Diese enthält ein Dreifach-Array mit den X- und Y-Koordinaten des Tippens in Pixeln und einem Zeitstempel. WatchFace.TapListener.onTap wurde durch onTapEvent(@TapType tapType: Int, tapEvent: TapEvent) ersetzt. Außerdem wurde InteractiveWatchFaceClient.displayPressedAnimation entfernt. (Id87d2)
• Explizite Thread-Anmerkung für setImportantForAccessibility hinzugefügt (I990fa)
• „ComplicationSlotBoundsType“ wurde zu „androidx-wear-watchface.ComplicationSlotBoundsType“ in „wear/wear-watchface“ verschoben. (I09420)
• Wir haben die Unterstützung für das Übergeben von String-Ressourcen-IDs an „UserStyleSetting“ und „Options“ hinzugefügt. Dies ist jetzt die empfohlene Methode zum Erstellen dieser Objekte. (I03d5f)
• Die maximale Drahtgröße eines UserStyle-Schemas wurde begrenzt. Außerdem dürfen Symbole im Schema nicht größer als 400 × 400 Pixel sein. (I3b65b)
• Wir haben die Klasse „MutableUserStyle“ hinzugefügt, um Änderungen an UserStyle-Instanzen zu unterstützen (I95a40).
• ListenableWatchFaceMetadataClient.Companion#listenableCreateWatchFaceMetadataClient wurde in ListenableWatchFaceMetadataClient.Companion#createListenableWatchFaceMetadataClient umbenannt. (I64ce2)
• Wir haben EditorState.previewComplicationsData so geändert, dass es nur Daten für aktivierte Zusatzfunktionen enthält. Außerdem haben wir EditorSession.DEFAULT_PREVIEW_TIME_MILLIS hinzugefügt, das bei Weitergabe an renderWatchFaceToBitmap oder PreviewScreenshotParams das Rendern mit der Standardvorschauzeit des Zifferblatts anfordert. (If7b3c)
• Die Konstruktoren für UserStyleSetting, die CharSequence als Argument annehmen, wurden aus der öffentlichen API entfernt. Wir empfehlen stattdessen die Konstruktoren zu verwenden, für die StringResource-IDs erforderlich sind. (I8537b)
• CurrentUserStyleRepository.UserStyleChangeListener unterstützt jetzt die SAM-Conversion. (I85989)

Version 1.0.0-alpha19

4. August 2021

androidx.wear:wear-*:1.0.0-alpha19 wird veröffentlicht. Version 1.0.0-alpha19 enthält diese Commits.

API-Änderungen

• Wir haben ListenableWatchFaceMetadataClient.listenableCreateWatchFaceMetadataClient hinzugefügt, das einen ListenableFuture-Wrapper für WatchFaceMetadataClient.createWatchFaceMetadataClient bereitstellt. (I5fa37)
• Für UserStyleOption.getOptionForId wird jetzt UserStyleOption.Id anstelle eines Byte-Arrays akzeptiert. (I469be)
• Konstanten BooleanOption.TRUE und BooleanOption.FALSE angeben und das Erstellen von Instanzen unterbinden (I46e09)
• Methoden im Wear-Watchface-Client, die eine RemoteException auslösen können, wurden jetzt entsprechend gekennzeichnet. (Ib8438)
• Aus Gründen der Einheitlichkeit haben wir EditorSession.createOnWatchEditingSession in createOnWatchEditorSession umbenannt. createHeadlessEditingSession heißt jetzt createHeadlessEditorSession. Auch die Guava-Wrapper wurden umbenannt. (I1526b)
• EditorSession ist jetzt eine Schnittstelle und ListenableEditorSession.commitChangesOnClose ist jetzt richtig delegiert. (I7dc3e)
• Schemas für Nutzerstile mit Einstellungen oder Optionen mit sich überschneidenden IDs werden jetzt abgelehnt (Ic2715)
• Wir haben eine überladene UserStyle.get hinzugefügt, die UserStyleSetting.Id akzeptiert. (I2aa0f)

Version 1.0.0-alpha18

21. Juli 2021

androidx.wear:wear-*:1.0.0-alpha18 wird veröffentlicht. Version 1.0.0-alpha18 enthält diese Commits.

API-Änderungen

• Wir haben ComplicationHelperActivity in die Mediathek von androidx.wear:wear-watchface verschoben. (I39e76)
• Aus Gründen der Einheitlichkeit und Klarheit wurde ComplicationProvider in ComplicationDataSource umbenannt. Alle Klassen mit dem Namen „Anbieter“ wurden ebenfalls umbenannt. (Iaef0b)
• CanvasComplication.isHighlighted wurde in RenderParameters.pressedComplicationSlotIds verschoben. Dies ist ein Schritt in Richtung zustandsloser CanvasComplication. Um diese Änderung zu unterstützen, wird CanvasComplication.render jetzt auch slotId als Parameter übergeben und ComplicationSlot wird an GlesTextureComplication übergeben. (I50e6e)
• Wir haben headlessDeviceConfig zu EditorRequest hinzugefügt. Wenn dieser Parameter nicht null ist, wird damit eine headless-Instanz erstellt, um die EditorSession zu unterstützen, anstatt auf die interaktive Instanz zuzugreifen. So kann der Editor für ein anderes Zifferblatt als das aktuelle aufgerufen werden. (I0a820)
• Wir haben eine experimentelle WatchFaceMetadataClient hinzugefügt, mit der sich statische Zifferblattmetadaten wie der UserStyleSchema und feste Details zu ComplicationSlots effizient abrufen lassen. (I6bfdf)
• Wir haben CanvasRenderer.uiThreadInit in „init“ umbenannt. (I6fff9)
• Wir haben den optionalen neuen Parameter „PreviewScreenshotParams“ für „EditorRequest“ hinzugefügt, der die EditorSession anweist, beim Commit einen Vorschau-Screenshot aufzunehmen. Das Vorschaubild wird auf EditorState.previewImage angezeigt. (Ic2c16)

Fehlerkorrekturen

• Entwickler müssen ihrem eigenen Manifest nicht mehr ComplicationHelperActivity hinzufügen. (I6f0c2)

Version 1.0.0-alpha17

30. Juni 2021

androidx.wear:wear-*:1.0.0-alpha17 wird veröffentlicht. Version 1.0.0-alpha17 enthält diese Commits.

Neue Funktionen

• In GlesRenderer wurden makeUiThreadContextCurrent und makeBackgroundThreadContextCurrent durch runUiThreadGlCommands und runBackgroundThreadGlCommands ersetzt, die beide ein Runnable akzeptieren. Die Bibliothek sorgt dafür, dass immer nur ein ausführbarer GL-Befehl ausgeführt wird.

• Um die Initialisierung des Ui-Threads zu vereinfachen, haben wir CanvasRenderer.uiThreadInit hinzugefügt, das einmal im Ui-Thread aufgerufen wird, bevor Rendering-Aufrufe erfolgen. Außerdem haben wir onRendererCreated zu CanvasComplication hinzugefügt, damit Renderer und CanvasComplication den Status leichter teilen können.

• Zur besseren Verständlichkeit haben wir Complication in ComplicationSlot und complicationId je nach Verwendung in complicationSlotId oder complicationInstanceId umbenannt.

API-Änderungen

• Zur besseren Verständlichkeit haben wir Complication in ComplicationSlot und complicationId je nach Verwendung in complicationSlotId oder complicationInstanceId umbenannt. Klassen, die „Complication“ verwenden, wurden ebenfalls umbenannt, z.B. heißt „ComplicationsManager“ jetzt „ComplicationSlotsManager“. (I4da44)
• In GlesRenderer wurden makeUiThreadContextCurrent und makeBackgroundThreadContextCurrent durch runUiThreadGlCommands und runBackgroundThreadGlCommands ersetzt, die beide eine Runnable akzeptieren. Diese Funktionen sind nur erforderlich, wenn Sie GL-Aufrufe außerhalb von „render“, runBackgroundThreadGlCommands und onUiThreadGlSurfaceCreated ausführen müssen. Das ist erforderlich, da es mehrere GlesRenderer mit jeweils eigenen Kontexten im selben Prozess geben kann, möglicherweise von verschiedenen Zifferblättern. Außerdem wird der Zugriff auf den freigegebenen aktuellen GL-Kontext jetzt synchronisiert. (I04d59)
• Wir haben CanvasRenderer.uiThreadInit hinzugefügt, das einmal im UiThread aufgerufen wird, bevor Rendering-Aufrufe erfolgen. Außerdem haben wir onGlContextCreated in GlesRenderer in onBackgroundThreadGlContextCreated und onGlSurfaceCreated in onUiThreadGlSurfaceCreated umbenannt, um für mehr Klarheit zu sorgen. (If86d0)
• HeadlessWatchFaceClient und InteractiveWatchFaceClient getComplicationsSlotState wurde in getComplicationSlotsState umbenannt. In ComplicationSlot: createRoundRectComplicationBuilder, createBackgroundComplicationBuilder und createEdgeComplicationBuilder wurden in createRoundRectComplicationSlotBuilder, createBackgroundComplicationSlotBuilder und createEdgeComplicationSlotBuilder umbenannt. (Ib9adc)
• Wir haben „onRendererCreated“ zu „CanvasComplication“ hinzugefügt, damit Renderer und CanvasComplication den Status leichter teilen können. (I5e1ac)

Version 1.0.0-alpha16

16. Juni 2021

androidx.wear:wear-*:1.0.0-alpha16 wird veröffentlicht. Version 1.0.0-alpha16 enthält diese Commits.

Neue Funktionen

• Wir haben einige Fehler im Zusammenhang mit den kürzlichen Änderungen am Thread-Modell behoben und andere Probleme mit dem Editor für Zifferblätter behoben.

Fehlerkorrekturen

• NPE in onComplicationProviderChooserResult verhindern (b/189594557)
• Probleme mit veralteten Oberflächen und drawBlack beheben (b/189452267)
• Behebung eines Race-Conditions beim Zugriff auf complicationsManager.watchState (b/189457893)
• Fehler beim Zeitlimit für Hintergrundthreads behoben (b/189445428)
• Probleme mit dem Zifferblatteditor vor R beheben (b/189126313)
• Direkte Boot-Parameter nicht für Änderungen am Editorstil aktualisieren (b/187177307)

Version 1.0.0-alpha15

2. Juni 2021

androidx.wear:wear-*:1.0.0-alpha15 wird veröffentlicht. Version 1.0.0-alpha15 enthält diese Commits.

Neue Funktionen

Der Großteil der Smartwatch-Oberfläche wird jetzt in einem Hintergrund-Thread initialisiert. Nach dem Laden wird das gesamte Rendering usw. jedoch im UiThread ausgeführt. Zwischen dem Laden und dem Rendern gibt es eine Speicherbarriere, sodass bei den meisten Zifferblättern nichts Besonderes erforderlich ist. Zifferblätter, die GLES verwenden, sind möglicherweise eine Ausnahme, da der Kontext threadspezifisch ist und wir zwei verknüpfte Kontexte erstellen. So ist es möglich, GL-Ressourcen (z. B. Texturen und Shader) in den Hintergrund-Thread hochzuladen und im UiThread zu verwenden.

Wir haben die Erstellung von Zifferblättern in drei Funktionen unterteilt: „createUserStyleSchema“, „createComplicationsManager“ und „createWatchFace“. Wir gehen davon aus, dass „createUserStyleSchema“ und „createComplicationsManager“ schnell sind und dass es beim Laden von Assets für „createWatchFace“ etwas dauern kann. Aus diesem Grund haben wir WatchFaceControlClient.getDefaultProviderPoliciesAndType eingeführt, das eine Zuordnung von Zusatzfunktionen-IDs zu DefaultComplicationProviderPolicies und dem Standard-Zusatzfunktionentyp zurückgibt. Das ist schneller als das Erstellen einer headless-Instanz, da das Zifferblatt nicht vollständig initialisiert werden muss, um die Abfrage auszuführen.

Schließlich werden Zusatzfunktionen jetzt mit einer CanvasComplicationFactory erstellt, die eine Lazy-Construction der CanvasComplication-Renderer ermöglicht.

API-Änderungen

• @TargetApi wurde durch @RequiresApi ersetzt. (I0184a, b/187447093, b/187447094)
• Wir haben WatchFaceControlClient.getDefaultProviderPoliciesAndType eingeführt, das eine Zuordnung von Zusatzfunktionen-IDs zu DefaultComplicationProviderPolicies und dem Standard-Zusatzfunktionentyp zurückgibt. Nach Möglichkeit wird ein schneller Pfad verwendet, der das vollständige Erstellen eines Zifferblatts verhindert. Dazu musste die WatchFaceService API geändert werden. Es wurden zwei neue Methoden hinzugefügt: „createUserStyleSchema“ und „createComplicationsManager“. Die Ergebnisse dieser Methoden werden an „createWatchFace“ übergeben. Außerdem werden Zusatzfunktionen jetzt mit einer CanvasComplicationFactory erstellt, die eine Lazy-Construction der CanvasComplication-Renderer ermöglicht. (Iad6c1)
• Wir haben „MOST_RECENT_APP“ aus „SystemProviders“ entfernt. (I3df00)
• ObservableWatchData ist jetzt eine versiegelte Klasse. (Ic940d)
• CanvasComplicationFactory.create (normalerweise io-gebunden) wird jetzt für jede Zusatzfunktion in einem Hintergrund-Thread aufgerufen, bevor das Rendern des UI-Threads beginnt. Zwischen Konstruktion und Rendering gibt es eine Speicherbarriere, sodass keine speziellen Threading-Primitiven erforderlich sind. (Ia18f2)
• Die Erstellung des Zifferblatts erfolgt jetzt in einem Hintergrund-Thread, obwohl das gesamte Rendering im UI-Thread erfolgt. GlesRenderer unterstützt zwei verknüpfte Kontexte, um dies zu ermöglichen. Die Rückgabe von WatchFaceControlClient.createHeadlessWatchFaceClient und WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient kann erfolgen, bevor WatchFaceService.createWatchFace abgeschlossen ist. Nachfolgende API-Aufrufe werden blockiert, bis die Initialisierung des Zifferblatts abgeschlossen ist. (Id9f41)
• EXPANSION_DP und STROKE_WIDTH_DP sind nicht mehr in api.txt zu sehen. (I54801)
• Bei EditorSession.createOnWatchEditingSession wird jetzt eine TimeoutCancellationException geworfen, wenn ein Fehler auftritt, anstatt eine Nullsitzung zu senden. Außerdem ist der Rückgabewert von EditorRequest.createFromIntent und EditorSession.createOnWatchEditingSession jetzt NonNull. (I41eb4)

Version 1.0.0-alpha14

18. Mai 2021

androidx.wear:wear-*:1.0.0-alpha14 wird veröffentlicht. Version 1.0.0-alpha14 enthält diese Commits.

Neue Funktionen

• EditorSession.openComplicationProviderChooser gibt jetzt „ChosenComplicationProvider“ zurück, das die Zusatzfunktions-ID ComplicationProviderInfo und ein Bundle mit allen zusätzlichen Extras enthält, die von der Anbieterauswahl zurückgegeben wurden.
• Außerdem migrieren wir kontinuierlich Code zu Kotlin. Der Großteil der Zifferblatt-API ist jetzt in Kotlin definiert.

API-Änderungen

• Die GlesRenderer-Properties eglContext und eglDisplay dürfen jetzt nicht mehr null sein. Alle GL-Fehler werden jetzt über GlesRenderer.GlesException und nicht über RuntimeExceptions gemeldet. (Ib1005)
• Wir haben androidx.wear.watchface.complications.rendering.ComplicationDrawable von Java zu Kotlin migriert (Ibc3eb).
• Wir haben androidx.wear.watchface.complications.rendering.ComplicationStyle von Java zu Kotlin migriert (I3375e)
• Wir haben für jede Zusatzfunktion in EditorSession Informationen zum Anbieter hinzugefügt. (I37f14)
• Wir haben das Ergebnis von EditorSession.openComplicationProviderChooser um Informationen erweitert, die von der ausgewählten Funktion zurückgegeben wurden. (Iead6d)

Wear-Zusatzfunktionen und -Zifferblatt Version 1.0.0-alpha13

5. Mai 2021

androidx.wear:wear-*:1.0.0-alpha13 wird veröffentlicht. Version 1.0.0-alpha13 enthält diese Commits.

Neue Funktionen

• Zifferblätter können neben der Uhrzeit und Zusatzfunktionen auch wichtige visuelle Elemente enthalten. Um Screenreader-Unterstützung dafür bereitzustellen, können im Zifferblatt jetzt ContentDescriptionLabels für Bedienungshilfen über die Eigenschaft „additionalContentDescriptionLabels“ des Renderers angegeben werden. Außerdem wurde der „accessibilityTraversalIndex“ zu Zusatzfunktionen hinzugefügt, um die Reihenfolge von ContentDescriptionLabels zu steuern. Dies kann durch eine ComplicationsUserStyleSetting geändert werden.

• Um Entwickler dazu anzuregen, Screenreader sorgfältig zu berücksichtigen, müssen das contentDescription-Feld von ShortTextComplicationData.Builder, LongTextComplicationData.Builder und RangedValueComplicationData.Builder an ihre Konstruktoren übergeben werden. Wenn ComplicationText.EMPTY für contentDescription übergeben wird, wird contentDescription automatisch aus dem Text und dem Titel generiert.

• WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient gibt jetzt ServiceStartFailureException zurück, wenn das Zifferblatt beim Initialisieren eine Ausnahme auslöst. Dadurch lassen sich Probleme beim Starten des Zifferblatts viel einfacher diagnostizieren.

API-Änderungen

• Wir haben die Unterstützung für einen Null-Komponentennamen in „ComplicationProviderInfo“ hinzugefügt, was für die Unterstützung älterer Wear OS-Versionen erforderlich ist. (I744d2)
• Wir haben androidx.wear.complications.SystemProviders von Java auf Kotlin migriert. (Ia1f8b)
• Wir haben alle Klassen aus der öffentlichen API ausgeblendet, die sich in android.support.wearable.complications befinden, und bei Bedarf entsprechende Wrapper in AndroidX erstellt. (I7bd50)
• Die Methode in TimeDifferenceComplicationText.Builder wurde von setMinimumUnit in setMinimalTimeUnit umbenannt. (I20c64)
• Das Feld contentDescription von ShortTextComplicationData.Builder, LongTextComplicationData.Builder und RangedValueComplicationData.Builder muss jetzt im Konstruktor übergeben werden. (I8cb69)
• Wir haben „ComplicationProviderService.onComplicationUpdate“ in „onComplicationRequest“ umbenannt und die ID und den Typparameter dieser Methode in „ComplicationRequest“ gekapselt. Der entsprechende Listener wurde in „ComplicationRequestListener“ und seine Methode in „ComplicationRequestListener.onComplicationData“ umbenannt. (Iaf146)
• Wir haben die Methode isActiveAt aus ComplicationData entfernt und stattdessen das Feld validTimeRange freigegeben. Dieser Methodenaufruf kann durch validTimeRange.contains ersetzt werden. (I65936)
• Wir haben die Beschreibung der Methode „ComplicationProviderService.onComplicationActivated“ geändert, sodass jetzt ein „ComplicationType“ anstelle eines „int“ empfangen wird. (Idb5ff)
• ProviderUpdateRequester von Java nach Kotlin migriert. (Ibce13)
• GlesRender.makeContextCurrent ist jetzt öffentlich. Im Zifferblattcode müssen möglicherweise GL-Aufrufe außerhalb von „render“ und „onGlContextCreated“ erfolgen. Da es sowohl einen interaktiven als auch einen headless-Kontext geben kann, ist dies erforderlich. (I8a43c)
• Bei WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient wird jetzt eine ServiceStartFailureException geworfen, wenn das Zifferblatt während der Initialisierung eine Ausnahme auslöst. Außerdem löst WatchFaceService jetzt eine Ausnahme aus, wenn „createWatchFace“ länger als 6 Sekunden dauert. (I59b2f)
• Wir haben die nicht verwendete ID-Eigenschaft von GlesTextureComplication entfernt. (I28958)
• Für das Zifferblatt können jetzt ContentDescriptionLabels für Barrierefreiheit über die Eigenschaft „additionalContentDescriptionLabels“ von Renderer angegeben werden. Zusätzlich zur Steuerung der Reihenfolge von ContentDescriptionLabels wurde der „accessibilityTraversalIndex“ zu Zusatzfunktionen hinzugefügt. Dies kann durch eine ComplicationsUserStyleSetting geändert werden. (Ib7362)
• Dokumentation zur Verarbeitung von Touch-Ereignissen auf dem Zifferblatt erweitern (Iaf31e)

Fehlerkorrekturen

• EditorSession.getComplicationsPreviewData() gibt jetzt eine Karte für alle, nicht nur für nicht leere Zusatzfunktionen zurück. Für leere Zusatzfunktionen wird eine Instanz von „EmptyComplicationData“ verwendet. (I1ef7e)

Wear-Zusatzfunktionen und -Zifferblattversion 1.0.0-alpha12

21. April 2021

androidx.wear:wear-*:1.0.0-alpha12 wird veröffentlicht. Version 1.0.0-alpha12 enthält diese Commits.

Neue Funktionen

Die Editoren von Zifferblättern müssen Teile des Zifferblatts hervorheben, um zu verdeutlichen, welcher Aspekt einer Smartwatch konfiguriert wird. Wir haben die RenderParameters erweitert, damit sowohl Stile als auch Zusatzfunktionen hervorgehoben werden können. Es gibt eine neue optionale HighlightLayer, die mit Alphatransparenz über dem Zifferblatt gelegt werden soll. Die Screenshot-APIs können diese Mattierung für Sie übernehmen oder die HighlightLayer für maximale Flexibilität separat bereitstellen. Angenommen, Sie haben einen Stil, mit dem Sie das Aussehen der Zeiger konfigurieren können. Der Renderer kann dann in seiner renderHighlightLayer einen Umriss um sie herum zeichnen.

Um die Unterstützung für Barrierefreiheit durch Anbieter von Zusatzfunktionen zu fördern, haben wir das Feld „contentDescription“ in den Klassen „PhotoImageComplicationData.Builder“, „MonochromaticImageComplicationData.Builder“ und „SmallImageComplicationData.Builder“ zu einem obligatorischen Konstruktorarugment gemacht. Die Funktionen „ComplicationTapFilter“ und „Complication.createEdgeComplicationBuilder“ wurden hinzugefügt, um Zusatzfunktionen am Rand zu unterstützen (die am Rand des Displays gezeichnet werden). Das Rendern und der Treffertest von Zusatzfunktionen am Rand werden dem Zifferblatt überlassen. Edge-Treffertests werden im Companion Editor nicht unterstützt.

API-Änderungen

• Konstanten in SystemProviders wurden das Präfix PROVIDER_ hinzugefügt. (I1e773)
• Das Feld contentDescription von PhotoImageComplicationData.Builder, MonochromaticImageComplicationData.Builder und SmallImageComplicationData.Builder muss jetzt im Konstruktor übergeben werden. (I9643a)
• ProviderInfoRetriever.requestPreviewComplicationData wurde in retrievePreviewComplicationData umbenannt. (I911ee)
• ComplicationProviderService wurde von Java zu Kotlin migriert. (I849f2)
• Methode ComplicationProviderService.onBind ist jetzt endgültig (I39af5)
• Wir haben die Benutzeroberfläche CanvasComplication reaktiviert und CanvasComplicaitonDrawable, GlesTextureComplication und ComplicationHighlightRenderer zu wear-watchface-complications-rendering verschoben. (I84670)
• RenderParameters wurde umgestaltet, um das erweiterte Rendern von Highlights zu unterstützen. Es ist jetzt möglich, das Rendern von Highlights für Stile sowie für alle oder eine einzelne Zusatzfunktion anzufordern. Außerdem haben CanvasRenderer und GlesRenderer eine neue abstrakte renderHighlightLayer-Methode zum Rendern aller vom Editor angeforderten Hervorhebungen. „Layer“ wurde in „WatchFaceLayer“ umbenannt. (Ic2444)
• ComplicationTapFilter und Complication.createEdgeComplicationBuilder wurden hinzugefügt, um Zusatzfunktionen für Smartwatch-Grenzen zu unterstützen. Das Rendern und der Treffertest von Zusatzfunktionen am Rand werden dem Zifferblatt überlassen. Treffertests werden in Editoren nicht unterstützt. (Ia6604)
• Für DoubleRangeUserStyleSetting und LongRangeUserStyleSetting: defaultValue, maximumValue und minimumValue sind jetzt Kotlin-Properties. Außerdem wurden UserStyleSetting.Option-Funktionen wie toBooleanOption, toCoplicationOptions, toListOption und ähnliche entfernt. (I52899)
• Fügen Sie den Eigenschaften des für das Zifferblatt verfügbaren Geräts die Kinngröße hinzu. (I76e1e)
• Der Konstruktor von ComplicationHighlightRenderer akzeptiert jetzt outlineExpansion- und outlineStrokeWidth-Parameter. (I87009)
• ComplicationDrawable.getNoDataText ist jetzt Teil der öffentlichen API. (I00598)

Version 1.0.0-alpha11

7. April 2021

androidx.wear:wear-*:1.0.0-alpha11 wird veröffentlicht. Version 1.0.0-alpha11 enthält diese Commits.

Neue Funktionen

• Die APIs für Zifferblätter wurden optimiert. Die meisten Änderungen sind einfache Umbenennungen. InteractiveWatchFaceWcsClient und InteractiveWatchFaceSysUiClient wurden jedoch zu InteractiveWatchFaceClient zusammengeführt.

API-Änderungen

• ContentDescriptionLabel.text ist jetzt ein ComplicationText und nicht mehr die alte Wearables-Supportbibliothek TimeDependentText. (I80c03)
• SystemProviders.GOOGLE_PAY ist nicht auf allen Android R-Geräten verfügbar. Daher wurde es aus der Liste entfernt. Sie können diesen Anbieter weiterhin über DefaultComplicationProviderPolicy (If01b5) verwenden.
• Wir haben ComplicationUpdateCallback aus Gründen der Einheitlichkeit in ComplicationUpdateListener umbenannt. (I61ec7)
• Die UserStyle-Leiterformatzuordnung wurde in Map<String, byte[]> geändert. Außerdem wurde der öffentlichen API zur besseren Übersicht die Klasse UserStyleData hinzugefügt, die jetzt von wear-watchface-client und wear-watchface-editor verwendet wird. Außerdem ist der Wert von „CustomValueUserStyleSetting.CustomValueOption.value“ jetzt „byte[]“ statt „String“. (Iaa103)
• UserStyleSetting und UserStyleSetting.Option verwenden jetzt UserStyleSetting.Id und UserStyleSetting.Option.Id, um ihre IDs zu speichern, anstatt einen String. (I63f72)
• InteractiveWatchFaceClient.SystemState wurde in WatchUiState umbenannt. (I6a4e0)
• InteractiveWatchFaceWcsClient und InteractiveWatchFaceSysUiClient wurden zusammengeführt, da die Zuständigkeitsverteilung schwer zu erklären war (Iff3fa)
• Die Enumerationswerte für Ebenen wurden zur besseren Verständlichkeit umbenannt. Layer#TOP_LAYER heißt jetzt Layer#COMPLICATIONS_OVERLAY und Layer#BASE_LAYER heißt jetzt Layer#BASE (Ia144e)
• UserStyleListener wurde in UserStyleChangeListener umbenannt (I18524)
• UserStyleRepository wurde in CurrentUserStyleRepository (I6ea53) umbenannt.
• InteractiveWatchFaceWcsClient.updateInstance wurde in updateWatchfaceInstance umbenannt. (I321dc)
• Die Ereignisse vom Typ „Zifferblatt – Tippen“ wurden umbenannt, um sie an „Bewegungsereignisse“/„Compose“ anzupassen. (I0dfd0)
• „takeWatchfaceScreenshot“ wurde in „renderWatchFaceToBitmap“ und „takeComplicationScreenshot“ in „renderComplicationToBitmap“ umbenannt (Ie0697)
• Die CanvasComplication-Schnittstelle wurde zugunsten der offenen Klasse CanvasComplicationDrawable entfernt. (I1f81f)
• WatcfaceControlServiceFactory wurde aus der öffentlichen API entfernt. (I1f8d3)
• CanvasComplication.setData wurde in CanvasComplication.loadData umbenannt. (If1239)
• ComplicationsManager.bringAttentionToComplication wurde in displayPressedAnimation umbenannt. (Ic4297)
• WatchFaceService.createWatchFace hat jetzt die Anmerkung @UiThread. (Ib54c2)
• Der Name eines CanvasComplicationDrawable-Parameters wurde geändert, um einen Fehler zu beheben. (I50dac)
• Wir haben HeadlessWatchFaceClient.toBundle() und HeadlessWatchFaceClient.createFromBundle hinzugefügt, um das Senden von HeadlessWatchFaceClient über AIDL zu unterstützen. (I07c35)
• HeadlessWatchFaceClient und InteractiveWatchFaceClient haben jetzt ClientDisconnectListener und isConnectionAlive(), mit denen Sie feststellen können, ob die Verbindung aus irgendeinem Grund unterbrochen ist (z.B. wenn das Zifferblatt beendet wird). (Ie446d)
• WatchFaceControlClient#getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClientAsync ist jetzt eine Pausierfunktion und wurde in getOrCreateInteractiveWatchFaceClient umbenannt. (Ib745d)
• EditorState.commitChanges und hasCommitChanges() wurden in shouldCommitChanges() umbenannt. (I06e04)
• previewComplicationData wurde in previewComplicationsData umbenannt, um anzugeben, dass sich auf der Karte (in der Regel) mehr als eine Zusatzfunktion befindet. (I56c06)
• InteractiveWatchFaceWcsClient.bringAttentionToComplication wurde in displayPressedAnimation umbenannt, um für Einheitlichkeit mit ComplicationsManager.displayPressedAnimation zu sorgen. (Ic9999)
• Alle Instanzen der Zifferblatt-Instanz-ID wurden in einer neuen Klasse „WatchFaceId“ (I45fdf) gekapselt.
• Die Property complicationState wurde in complicationsState umbenannt, um die Mehrzahl anzuzeigen. (Ided07)
• Wir haben die verschiedenen Binder-Conversions für Wear-Watchface-Clients entfernt, da sie nicht erforderlich sind. (Icc4c0)
• Aus Gründen der Einheitlichkeit wurde EditorServiceClient so umgestaltet, dass statt Beobachtern jetzt Listener verwendet werden. (Iec3a4)
• InteractiveWatchFaceSysUiClient und WatchFaceControlClient wurden einige fehlende @Px-Anmerkungen hinzugefügt. (I3277a)
• EditorObserverCallback wurde aus Gründen der Einheitlichkeit in EditorObserverListener umbenannt. (Ie572d)
• EditorState.watchFaceInstanceId ist auf das API-Level von Android R und höher beschränkt und kann nicht mehr null sein. (Id52bb)
• EditorSession.launchComplicationProviderChooser wurde in openComplicationProviderChooser umbenannt. (I9d441)
• EditorSession.createOnWatchEditingSessionAsync wurde in createOnWatchEditingSession umbenannt und ist jetzt eine Funktion zum Pausieren. (Id257b)
• Am EditorSession wurden mehrere fehlende @UiThread-Hinweise hinzugefügt. (I6935c)
• UserStyleSetting.affectsLayers wurde in affectedLayers umbenannt. (I6e22b)

Version 1.0.0-alpha10

24. März 2021

androidx.wear:wear-*:1.0.0-alpha10 wird veröffentlicht. Version 1.0.0-alpha10 enthält diese Commits.

Neue Funktionen

• Es ist jetzt möglich, Open GL-Objekte (z.B. Texturen) während „WatchFaceService.createWatchFace“ zu erstellen, da GlesRenderer jetzt einen expliziten Aufruf von „initOpenGLContext“ erfordert, der in „createWatchFace“ erfolgen kann.

API-Änderungen

• IdAndComplicationData war etwas ungünstig und wurde aus der öffentlichen API entfernt. Klassen und Schnittstellen, die sie verwendet haben, wurden neu strukturiert. (I4c928)
• Wir haben ReferenceTime durch CountUpTimeReference und CountDownTimeReference ersetzt, da diese Symbole selbsterklärender sind. (Ib66c6)
• Fehlende @Px- und @ColorInt-Hinweise hinzugefügt. (I9bbc3)
• Complication.complicationConfigExtras ist jetzt nicht mehr optional und hat standardmäßig den Wert Bundle.EMPTY. (Iad04f)
• Für GlesRenderer müssen Sie jetzt nach dem Erstellen initOpenGLContext aufrufen. Diese Funktion war ein internes Detail, ist aber jetzt in der öffentlichen API verfügbar, um GL-Aufrufe früher in createWatchFace zu ermöglichen. (I726c2)
• Wir haben Complication.setRenderer entfernt, da es nicht erforderlich sein sollte. (Ie992f)
• Complicaiton.setComplicationBounds ist nicht mehr Teil der öffentlichen API. Wenn Sie die Position einer Zusatzfunktion anpassen möchten, können Sie dies über ComplicationsUserStyleSetting tun. (Ibd9e5)
• ComplicationsManager.TapCallback.onComplicationSingleTapped wurde in onComplicationTapped umbenannt. (I3a55c)
• ComplicationOutlineRenderer.drawComplicationSelectOutline wurde in drawComplicationOutline umbenannt. (I14b88)

Version 1.0.0-alpha09

10. März 2021

androidx.wear:wear-complications-*:1.0.0-alpha09 und androidx.wear:wear-watchface-*:1.0.0-alpha09 werden freigegeben. Version 1.0.0-alpha09 enthält diese Commits.

Neue Funktionen

• Die Schnittstelle zwischen WCS/SysUI-Host und dem Zifferblatt auf der Smartwatch hat sich weiterentwickelt. Es ist jetzt möglich, dass ein Editor festlegt, ob eine Stiländerung eine Zusatzfunktion aktiviert oder deaktiviert (enabled = initiallyEnabled plus any override from ComplicationsUserStyleSetting). Außerdem kann SysUI mit EditorService.closeEditor bei Bedarf einen Zifferblatt-Editor aus der Ferne schließen.
• Außerdem gibt es für InteractiveWatchFaceWcsClient.setUserStyle einen leistungsstärkeren Befehl updateInstance, mit dem sich die Instanz-ID ändern, der Stil festlegen und die Zusatzfunktionen auf einmal löschen lassen.

API-Änderungen

• Den Zifferblattbibliotheken wurden TraceEvents hinzugefügt. (I1a141)
• ComplicationState hat jetzt eine neue Eigenschaft initiallyEnabled, mit der sich die Auswirkungen eines Stilwechsels vorhersagen lassen. (I8c905)
• Wir haben InteractiveWatchFaceWcsClient.setUserStyle durch den leistungsfähigeren Befehl updateInstance ersetzt. Mit diesem Befehl können Sie die Instanz-ID ändern, den Stil festlegen und Zusatzfunktionen löschen. (Ife6f6)
• Die Screenshot-APIs von WatchFaceClient komprimieren die Screenshots nicht mehr, da dies zu langsam war. Stattdessen wird die Nachbearbeitung dem Aufrufer überlassen. (Id35af)
• Es ist jetzt möglich, einen Zifferblatteditor über EditorService.closeEditor aus der Ferne zu schließen. (Ic5aa4)
• Anmerkungen zur Null-Zulässigkeit hinzugefügt (Ic16ed)

Version 1.0.0-alpha08

24. Februar 2021

androidx.wear:wear-*:1.0.0-alpha08 wird veröffentlicht. Version 1.0.0-alpha08 enthält diese Commits.

Neue Funktionen

• Einige Zifferblätter sind auf eine oder mehrere bestimmte Zusatzfunktionen ausgelegt. Dazu haben wir die Funktion „Complication.Builder#setFixedComplicationProvider“ hinzugefügt. Wenn diese auf „true“ gesetzt ist, kann der Nutzer die Zusatzfunktion in diesem Slot nicht ändern.
• Die Zifferblattbibliotheken sind in erster Linie in Kotlin geschrieben und verwenden Koroutinen (z.B. suspend-Funktionen). Für Java-Nutzer haben wir ListenableFuture-Wrapper zur Verbesserung der Interoperabilität in den folgenden Bibliotheken bereitgestellt: wear/wear-watchface-guava, wear/wear-watchface-client-guava und wear/wear-watchface-editor-guava.

API-Änderungen

• Wir haben die Unterstützung für das Doppeltippen auf Zusatzfunktionen entfernt, über das die Auswahl des Anbieters geöffnet wurde. Diese Funktion war bei Zifferblättern nicht üblich und hat die Implementierung der System-UI erschwert. (I3ef24)
• ProviderInfoRetriever-Methoden können eine ServiceDisconnectedException auslösen, wenn der Binder unerwartet geschlossen wird. (Ib2cc4)
• Ab Android 11 gibt es Einschränkungen bei der Ausführung der ProviderChooser. Außerdem möchten wir, dass Editoren mit der neuen wear-watchface-editor erstellt werden. Daher wird ComplicationHelperActivity aus der öffentlichen API entfernt. (Ib19c1)
• Statische Methoden von „ComplicationText“ werden durch Builder ersetzt. (Ibe399)
• Wir haben guava ListenableFuture-Wrapper für die verschiedenen pausierten Methoden der Zifferblattbibliothek eingeführt. (I16b2c)
• Für mehr Klarheit bei der API haben wir den RenderParameters einen sekundären Konstruktor hinzugefügt, der keine Färbung erfordert. Dieser kann mit anderen LayerModes als LayerMode.DRAW_OUTLINED verwendet werden. (I497ea)
• Bisher unterschied sich „ListUserStyleSetting“ von den anderen, da es ein Standardargument hatte. Jetzt wird der Standardwert bei allen Konstruktoren der StyleSetting-Unterklasse als letzter Wert verwendet. (I9dbfd)
• CanvasComplication wurde so umstrukturiert, dass eine ausgeblendete Methode verwendet wird, was die Implementierung einer Unterklasse erleichtert (I5b321)
• Wir haben EditorResult zugunsten eines neuen EditorService und EditorSession.broadcastState() umgestellt, um Updates an einen Beobachter (in der Regel die SysUI) zu streamen. (Ic4370)
• Einige Zifferblätter sind um eine bestimmte Zusatzfunktion herum aufgebaut, die ein wesentlicher Bestandteil des Zifferblatts ist und deren Anbieter nicht vom Nutzer konfiguriert werden kann. Dazu haben wir Complication.Builder#setFixedComplicationProvider hinzugefügt. (I4509e)
• In EditorRequest wird jetzt der Paketname anstelle des Komponentennamens angegeben, da es für die SysUI unpraktisch war, den Klassennamen des Editors abzurufen. Wir benötigen eigentlich nur den Paketnamen. (Ib6814)

Version 1.0.0-alpha07

10. Februar 2021

androidx.wear:wear-*:1.0.0-alpha07 wird veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.

Neue Funktionen

• „WatchFaceService.createWatchFace“ ist jetzt eine Suspend-Funktion. Das bedeutet, dass das Zifferblatt den UI-Thread nicht mehr blockieren muss, während auf I/O gewartet wird. Ähnliche Daten: wear-watchface-editor und wear-complications-data

API-Änderungen

• Entfernen Sie die Klasse „PhotoImage“ und verwenden Sie das Symbol direkt. (I8a70b)
• Stellen Sie den gültigen Zeitraum von „ComplicationData“ bereit. (I91366)
• Machen Sie bildähnliche Attribute deutlicher. (I81700)
• wear-watchface-editor und wear-complications-data wurden umgestellt, sodass jetzt statt coroutines suspend-Funktionen verwendet werden. RxJava- und Future-kompatible Wrapper folgen. (If3c5f)
• ProviderInfoRetriever wirft jetzt eine PreviewNotAvailableException, wenn requestPreviewComplicationData aufgrund von Verbindungsproblemen oder fehlender API-Unterstützung keine Vorschaudaten zurückgeben kann. (I4964d)
• Die Funktion „WatchFaceControlService::createWatchFaceControlClient“ ist jetzt eine ausgesetzte Funktion und „getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient“ wird jetzt als „getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClientAsync“ aufgerufen und gibt Deferred<InteractiveWatchFaceWcsClient> zurück. RX Java- und Future-kompatible Wrapper folgen. (I5d461)
• Benennen Sie CATEGORY_PROVIDER_CONFIG_ACTION in CATEGORY_PROVIDER_CONFIG um. (I7c068)
• Die Funktion „createOnWatchEditingSession“ ist jetzt deaktiviert, da das Zifferblatt manchmal erst kurz nach Beginn der Editoraktivität verfügbar ist. (Ida9aa)
• „WatchFaceService.createWatchFace“ ist jetzt eine Suspend-Funktion, die eine asynchrone Initialisierung ermöglicht. Bisher mussten Sie den Hauptthread blockieren. (If076a)
• UserStyle hat jetzt einen Arrayoperator und wir haben UserStyle.Option Casting-Hilfsfunktionen hinzugefügt. (I35036)
• Wir haben einen Marshalling-Fehler bei UserStyle-Netzwerkformaten behoben, der einige der instabilen versteckten APIs verändert hat. (I8be09)
• Wir haben die Einstellung „CustomValueUserStyleSetting“ hinzugefügt, mit der Sie einen einzelnen anwendungsspezifischen String in einem UserStyle speichern können. Die Standard-Editoren für Zifferblätter ignorieren diesen Wert. (Ic04d2)
• Die InstanceID wird nicht in den Intent-Extras für R und ältere Versionen von Android WearOS übergeben, die nicht aktualisiert werden können. Daher ist die InstancID jetzt auch null zulässig. (Id8b78)
• „EditorRequest“ enthält jetzt den „ComponentName“ des Editors, der in „WatchFaceEditorContract.createIntent“ (I3cd06) als Komponente festgelegt ist.
• Die EditorResult-Funktion für Zifferblätter enthält jetzt eine Vorschau der Zusatzfunktionsdaten, damit der Aufrufer nach der Bearbeitung einen Screenshot des Zifferblatts aufnehmen kann. (I2c561)

Fehlerkorrekturen

• UserStyle, UserStyleSetting und UserStyleSchema haben jetzt toString()-Überschreibungen, was die Arbeit mit diesen Klassen etwas angenehmer macht. (I9f5ec)

Version 1.0.0-alpha06

27. Januar 2021

androidx.wear:wear-*:1.0.0-alpha06 wird veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.

Neue Funktionen

• Wir haben die neue Bibliothek „wear/wear-watchface-editor“ eingeführt, mit der Zifferblattentwickler und möglicherweise OEMs einen Stil- und Zusatzfunktionseditor erstellen können. Die SysUI sendet eine Intent an das Zifferblatt, die über die neue EditorSession-Klasse auf die Zifferblattdetails zugreift und das Ergebnis über Activity.setWatchRequestResult aufzeichnet. Dazu haben wir die Funktion „ProviderInfoRetriever.requestPreviewComplicationData“ hinzugefügt, mit der Zifferblatt-Designer Vorschaudaten für Zusatzfunktionen anfordern können. Der Vorteil von Vorschau-ComplicationData besteht darin, dass Sie im Gegensatz zu Live-Daten beim Rendern des Editors keine Berechtigungsdialoge anzeigen müssen. Hinweis: Wenn ein Nutzer einen Anbieter mit einer Berechtigung auswählt, wird er trotzdem aufgefordert, die Berechtigung zu gewähren.

API-Änderungen

• „ComplicationProviderInfo“ enthält jetzt ein Feld für den „ComponentName“ des Anbieters. Die Unterstützung für dieses Feld wird WearOS zu einem späteren Zeitpunkt hinzugefügt. Bis dahin ist es null. (Id8fc4)
• Wir haben ProviderInfoRetriever.requestPreviewComplicationData hinzugefügt, mit dem Zifferblattbearbeiter eine Vorschau der Zusatzfunktionen anfordern können. Das ist nützlich, da für Live-Komplikationen möglicherweise Berechtigungen erforderlich sind. Außerdem können Sie jetzt Vorschaudaten für nicht aktive Komplikationen anzeigen. (I2e1df)
• „ComplicationManager“ ist jetzt ein optionaler Parameter des Konstruktors von „WatchFace“ und die Argumente wurden neu angeordnet, um dies zu ermöglichen. (I66c76)
• Wir haben den Zusatz „Bundle“ zu Zusatzfunktionen hinzugefügt. Wenn er festgelegt ist, wird er mit der Intent-Nachricht zusammengeführt, die zum Starten der Auswahlaktivität des Anbieters gesendet wird. (Ifd4ad)
• Wir haben eine neue wear-watchface-editor-Bibliothek hinzugefügt, die von Zifferblatt- und SysUi-Editoren unterstützt wird. SysUI startet diese Editoren, indem ein Intent gesendet wird. Der Dienst für Zifferblattaktivitäten kann die neue Klasse „EditorSession“ verwenden, um auf Zifferblattdetails zuzugreifen und das Ergebnis über „Activity.setWatchRequestResult“ zu erfassen. (I2110d)
• LayerMode.DRAW_HIGHLIGHTED heißt jetzt LayerMode.DRAW_OUTLINED und RenderParameters.highlightComplicationId heißt jetzt RenderParameters.selectedComplicationId. Damit wird zusätzlich zu einem Umriss ein Highlight auf der angegebenen Zusatzfunktion gezeichnet. (I90a40)
• Die Zukunft von WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient kann jetzt mit einer ServiceStartFailureException aufgelöst werden, wenn der Dienst während des Wartens auf die Erstellung des Zifferblatts beendet wird. (I0f509)
• EditorSession.complicationPreviewData ist jetzt ein ListenableFuture, da das Abrufen dieser Daten ein asynchroner Vorgang ist. (Iead9d)

Fehlerkorrekturen

• Wir entfernen nicht verwendete Felder aus „ComplicationOverlay“ und lassen „enabled“ und „complicationBounds“ unverändert. (I17b71)

Version 1.0.0-alpha05

13. Januar 2021

androidx.wear:wear-*:1.0.0-alpha05 wird veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.

Neue Funktionen

Zifferblätter unterstützen oft eine Reihe von Zusatzfunktionen mit unterschiedlicher Anzahl angezeigter Zusatzfunktionen. Zur Vereinfachung der Einrichtung unterstützen wir jetzt auch zu Beginn deaktivierte Zusatzfunktionen. Dazu wird setEnabled(false) auf den Builder angewendet. Sie können sie später über „ComplicationsUserStyleSetting“ aktivieren.

API-Änderungen

• Für ComplicationHelperActivity wird jetzt Collection<ComplicationType> statt ein Int-Array akzeptiert, was die Verwendung vereinfacht. (I1f13d)
• ProviderInfoRetriever.retrieveProviderInfo gibt jetzt korrekt ListenableFuture<ProviderInfo[]> zurück. (If2710)
• Sie können jetzt eine anfänglich deaktivierte Zusatzfunktion erstellen, indem Sie setEnabled(false) auf den Builder aufrufen. (Idaa53)
• „WatchFaceState“ hat jetzt die Eigenschaft „isHeadless“, die nur für headless-Instanzen wahr ist. (Ifa900)
• „ComplicationDrawable“ unterstützt jetzt optional das synchrone Laden von Drawables. Dieser wird von den Screenshot-APIs verwendet. (I34d4a)

Version 1.0.0-alpha04

16. Dezember 2020

androidx.wear:wear-*:1.0.0-alpha04 wird veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.

Neue Funktionen

• Die Wear OS-Bibliothek für Zifferblätter unterstützt jetzt die Festlegung von Grenzwerten pro Typ. Sie können beispielsweise für ComplicationType.LONG_TEXT zu einem breiten Begrenzungsrahmen wechseln und für andere Typen einen kleineren Begrenzungsrahmen verwenden.

API-Änderungen

• Für Zusatzfunktionen wird jetzt „ComplicationBounds“ verwendet, das ein Map<ComplicationType, RectF> umschließt, um die Größe je nach Zusatzfunktionstyp zu unterstützen. (I1ebe7)
• Mit „RenderParameters“ können Sie jetzt die Farbe der Highlights für Screenshots festlegen. (Iff42b)
• Mit Ausnahme von Begrenzungen müssen Sie jetzt „ComplicationsUserStyleSetting“ verwenden, um Zusatzfunktionen zu ändern. So wird sichergestellt, dass das Betriebssystem synchronisiert bleibt. (I8dc5d)
• Renderer ist jetzt eine versiegelte Klasse. Das bedeutet, dass CanvasRenderer und GlesRenderer jetzt innere Klassen von Renderer sind. (Iab5d4, b/173803230)
• CanvasComplicationDrawable.drawHighlight in drawOutline umbenannt ObservableWatchData enthält jetzt einige fehlende UiThread-Anmerkungen. „ScreenState“ wurde jetzt vollständig aus „WatchState“ entfernt. (If1393)
• Das Mindest-API-Level für Wear-Smartwatch-Zifferblätter ist jetzt 25. Hinweis: Für die Hardware-Canvas-Unterstützung ist API-Level 26 oder höher erforderlich. (Ic9bbd)
• InteractiveWatchFaceWcsClient hat jetzt die Hilfsfunktion „getComplicationIdAt“. (I05811)
• Die API-Ebene für den Wear-Watchface-Client wurde auf 25 reduziert. Für die Screenshot-APIs ist jedoch API-Ebene 27 erforderlich. (Id31c2)

Fehlerkorrekturen

• Der ComplicationType der aktuellen ComplicationData der Zusatzfunktion wird jetzt in „ComplicationState“ bereitgestellt. (I9b390)
• InteractiveWatchFaceWcs hat jetzt die Methode „bringAttentionToComplication“, mit der die angegebene Zusatzfunktion kurz hervorgehoben wird. (I6d31c)
• InteractiveWatchFaceWcsClient#setUserStyle hat jetzt eine Überladung, die Map<string, string=""> akzeptiert. Dadurch kann möglicherweise ein zusätzlicher IPC-Rückgabevorgang vermieden werden, der zum Erstellen von UserStyle erforderlich ist. (I24eec)</string,>

Version 1.0.0-alpha03

2. Dezember 2020

androidx.wear:wear-*:1.0.0-alpha03 wird veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.

Neue Funktionen

Die Klasse „Complication“ hat jetzt eine Eigenschaft „complicationData“, mit der Zifferblätter Änderungen an „ComplicationData“ beobachten können. So können Sie die Größe der Zusatzfunktion je nach Art der Zusatzfunktion ändern.

Variable Frameraten werden jetzt unterstützt, indem Renderer.interactiveDrawModeUpdateDelayMillis zugewiesen wird. Bei Zifferblättern, auf denen jede Sekunde kurze Animationen laufen, kann dies zu einer erheblichen Energieeinsparung führen, da das Display in den Ruhemodus versetzt wird, wenn keine Animationen laufen.

API-Änderungen

• BACKGROUND_IMAGE wurde zusammen mit den zugehörigen Klassen in PHOTO_IMAGE umbenannt. Diese Art von Zusatzfunktion wird nicht ausschließlich für Hintergründe verwendet, daher die Namensänderung. (I995c6)
• „DefaultComplicationProviderPolicy“ ist korrekt mit IntDefs gekennzeichnet. (I3b431)
• Die ausgeblendete Klasse „TimeDependentText“ wird nicht mehr über „ContentDescriptionLabel“ bereitgestellt. Stattdessen fügen wir einen Zugriffsmethode hinzu, um den Text zu einer bestimmten Zeit abzurufen. (Ica692)
• Der Konstruktor von ObservableWatchData ist jetzt intern. (I30121, b/173802666)
• Die Zusatzfunktion hat jetzt „complicationData“, mit der sich Änderungen an „complicationData“ auf dem Zifferblatt beobachten lassen. Die Zusatzfunktion hat außerdem einen neuen Aufruf „isActiveAt“, mit dem ermittelt werden kann, ob etwas zum angegebenen Datum und Uhrzeit gerendert werden soll. (Ic0e2a)
• Die leere SharedMemoryImage ist nicht mehr in der öffentlichen API enthalten. (I7ee17)
• WatchFace.overridePreviewReferenceTimeMillis hat jetzt eine IntRange-Anmerkung und der Getter und Setter haben einheitliche Namen. (Ia5f78)
• Complication.Builder wird jetzt zur besseren Verständlichkeit über Complication.createRoundRectComplicationBuilder oder Complication.createBackgroundComplicationBuilder erstellt (I54063)
• Es wurde „WatchFace.TapListener“ hinzugefügt, mit dem das Zifferblatt Tippen erfassen kann, die nicht von Zusatzfunktionen genutzt werden. (Ic2fe1, b/172721168)
• Das Zifferblatt unterstützt jetzt variable Frameraten, indem Sie Renderer.interactiveDrawModeUpdateDelayMillis zuweisen. So lässt sich die Akkulaufzeit verlängern, da das Gerät in den Ruhemodus versetzt wird, wenn keine Animationen laufen. (I707c9)
• „WatchFace.Builder“ ist nicht mehr erforderlich und „invalidate()“ und „interactiveUpdateRateMillis“ wurden in „Renderer“ verschoben. (I329ea)
• Die Getter für boolesche Eigenschaften in WatchState wurden umbenannt, um die Java-Interoperabilität zu verbessern (I6d2f1).
• Aus Gründen der Einheitlichkeit wurden „TapListener“ in „TapCallback“ und „InvalidateCallback“ in „InvalidateListener“ umbenannt. (I9414e)
• Die Optionen für den Stil von Wear 2.0-Zifferblättern wurden aus Gründen der Übersichtlichkeit in eine eigene Klasse verschoben. Die Setter von WatchFace.Builder haben jetzt symmetrische Getter der WatchFace-Klasse. (Iefdfc)
• Es wurden InteractiveWatchFaceWcsClient und WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient hinzugefügt, die entweder eine vorhandene Instanz abrufen oder erstellen, sobald der Hintergrunddienst eine Verbindung hergestellt und die Engine erstellt hat. (Id666e)
• WatchFaceControlClient ist jetzt eine Schnittstelle, die es ermöglicht, sie in Tests zu simulieren. (I875d9)
• HeadlessWatchFaceClient, InteractiveWatchFaceSysUiClientImpl und InteractiveWatchFaceWcsClient sind jetzt Schnittstellen, die das Testen erleichtern. (I7cdc3)
• Methoden in wear-watchface-complications-rendering (I0d65c) wurden Anmerkungen hinzugefügt.

Fehlerkorrekturen

• Displayform aus DeviceConfig entfernen, die android.content.res.Configuration#isScreenRound() dupliziert hat (Ifadf4)
• Bei WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient wird jetzt ein Map<String, String> statt ein UserStyle akzeptiert, da es schwierig ist, ein UserStyle zu erstellen, ohne das Schema zu kennen, das erst nach der Erstellung des Clients verfügbar ist. (Iea02a)
• Korrigieren Sie InteractiveWatchFaceWcsClient, damit ComplicationState anstelle des Wire-Formats verwendet wird. (Icb8a4)
• UserStyleSettings ist jetzt eine versiegelte Klasse, da die Zifferblatteditoren nur die vordefinierten Klassen verstehen. (I2d797)

Version 1.0.0-alpha02

11. November 2020

androidx.wear:wear-*:1.0.0-alpha02 wird veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.

API-Änderungen

• ComplicationDetails heißt jetzt ComplicationState, ist korrekt gewickelt und die Verwendung der Wearables-Unterstützung @ComplicationData.ComplicationType wurde zu androidx ComplicationType migriert. (I4dd36)
• Fügen Sie den RenderParameters einen optionalen highlightedComplicationId-Parameter hinzu, mit dem Sie das Hervorheben einer einzelnen Zusatzfunktion in Screenshots anfordern können. (I66ce9)
• ComplicationProviderService für Konsistenz die neue Zusatzfunktions-API verwenden (Id5aea)
• getPreviewReferenceTimeMillis ruft jetzt Referenzzeiten von DeviceConfig ab. (I779fe)
• Die Renderer API wird vereinfacht. Stattdessen kann SurfaceHolder.Callback verwendet werden, um Änderungen zu beobachten. (I210db)
• CanvasComplicationRenderer ist nicht eine Erweiterung von Renderer und wird umbenannt, um dies zu verdeutlichen. (Ibe880)

Fehlerkorrekturen

• Erste Version von androidx.wear:wear-watchface-client (I1e35e)
• Der Name von GlesTextureComplication#renderer wurde zugunsten der Verständlichkeit geändert (Ib78f7)
• StyleCategory in StyleSetting umbenennen (I488c7)
• Hinzufügen von UserStyleSchema für eine übersichtlichere API (If36f8)

Version 1.0.0-alpha01

28. Oktober 2020

androidx.wear:wear-complications-*:1.0.0-alpha01 und androidx.wear:wear-watchface-*:1.0.0-alpha01 werden freigegeben. Version 1.0.0-alpha01 enthält diese Commits.

API-Änderungen

• Einige Elemente wurden entfernt, die nicht für die öffentliche API vorgesehen waren. (I41669)
• androidx.wear:wear-complications-provider-Bibliothek erstellen (I77f1f)
• ComplicationsUserStyleCategory ist die neue empfohlene Kategorie für die Konfiguration von Zusatzfunktionen (I96909)
• Wear OS-Komplikationsdaten-API hinzufügen (I7c268)
• Funktionen mit booleschen Rückgabewerten müssen mit „is“ und nicht mit „get“ beginnen (If36ff)
• Gemäß den API-Richtlinien sollte der Parameter „protected“ nicht verwendet werden. Daher wurde diese Klasse so umgestaltet, dass Parameter über den Konstruktor übergeben werden. (I61644)
• setBackgroundComplication wurde umbenannt, um Verwechslungen zu vermeiden. (I96fe3)
• Kotlin-Properties für „isHighlighted“ und „data“ von „ComplicationDrawable“ verwenden (I4dcc8)
• Anstelle von „ComplicationRenderer.InvalidateCallback“ wird „Complication#invalidate()“ hinzugefügt (I4f4c6).
• Diese APIs werden in WearableSupport eingestellt und hier entfernt. (Ib425c)
• Einige Methoden für den WatchFace-Builder wurden umbenannt, um ihre Zugehörigkeit zu Wear 2.0 hervorzuheben. (Idb775)
• Erster Beta-API-Kandidat für Wear/Wear-Zifferblatt (Id3981)
• Erste erfasste Version der API. (Ie9fe6)
• ComplicationDrawable.BorderStyle IntDef richtig ausblenden und aus Gründen der Einheitlichkeit zu ComplicationStyle wechseln (I27f7a)
• Fehlende Anmerkungen für ComplicationStyle-Methoden hinzugefügt (I838fd)
• Diese Bibliothek hat keine öffentliche API-Oberfläche (I88e2b)
• Alle Optionenklassen für Stilkategorien sind jetzt endgültig. (Ib8323)
• Erste erfasste Version der API. (I27c85)

Fehlerkorrekturen

• Der ComplicationProviderService wurde um eine explizite Methode „getComplicationPreviewData“ ergänzt. (I4905f)
• API-Lint-Prüfung für fehlende Getter-Matching-Builder ist für androidx aktiviert (I4bbea, b/138602561)
• Benennen Sie „wear-complications-rendering“ um. (Ifea02)
• Anzeigenamen von Stilkategorien sind jetzt CharSequences (I28990)
• „Override“ (Überschreiben) wird durch „Overlay“ ersetzt, um den aktuellen Benennungskonventionen für Themen und Stile zu entsprechen. (I4fde9)
• UserStyle#getOptions wurde umbenannt, um für mehr Klarheit zu sorgen. (I695b6)

Version 1.2.0

Version 1.2.0

15. September 2021

androidx.wear:wear:1.2.0 wird veröffentlicht. Version 1.2.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.1.0

• Die Komponente „CurvedText“ wurde hinzugefügt, um leicht gekrümmten Text zu schreiben, der der Krümmung des größten Kreises folgt, der in die Ansicht eingeschrieben werden kann. Anwendungsbeispiel:

  <androidx.wear.widget.CurvedText
          android:layout_width="wrap_content"
          android:layout_height="wrap_content"
          android:text="example curved text"
          app:anchorAngleDegrees="180"
          app:anchorPosition="center"
          app:clockwise="false"
          style="@android:style/TextAppearance.Large"
  />
  

  

• Der ArcLayout-Container wurde hinzugefügt, um seine untergeordneten Elemente einzeln in einem Bogen entweder im oder gegen den Uhrzeigersinn anzuordnen. Seine untergeordneten Elemente können sowohl Standard-Android-Widgets als auch „gekurvte“ Widgets sein, die die ArcLayout.Widget-Benutzeroberfläche implementieren. (I536da) Anwendungsbeispiel:

  <androidx.wear.widget.ArcLayout
          android:layout_width="match_parent"
          android:layout_height="match_parent"
          app:anchorPosition="center">
        <ImageView
                android:layout_width="20dp"
                android:layout_height="20dp"
                android:src="@drawable/ic_launcher"
        />
        <androidx.wear.widget.CurvedText
                android:layout_width="match_parent"
                android:layout_height="match_parent"
                android:text="Curved Text"
                style="@android:style/TextAppearance.Small"
                android:padding="2dp"
         />
    </androidx.wear.widget.WearArcLayout>
  

  

• Es wurde ein neuer Layout-Container namens „DismissibleFrameLayout“ hinzugefügt, der das Schließen per Rückwärtstaste und/oder Wischen für eine Aktivität übernimmt. Es muss mindestens ein Listener hinzugefügt werden, der auf eine Schließungsaktion reagiert. Ein Listener entfernt normalerweise eine enthaltene Ansicht oder ein Fragment aus der aktuellen Aktivität. Mit den Funktionen „setSwipeDismissible(boolean)“ und „setBackButtonDismissible(boolean)“ können Sie die Funktionen direkt steuern. Dieses neue Layout soll das vorhandene SwipeDismissFrameLayout ersetzen.

• In der Klasse „AmbientModeSupport“ wurde die Unterstützung hinzugefügt, dass eine Aktivität automatisch fortgesetzt werden kann, wenn das Gerät den Inaktivmodus verlässt. Diese Funktion war zuvor in der eingestellten WearableActivity-Klasse der WearableSupportLibrary verfügbar. (I336ab)

• Die WearableCalendarContract-Klasse wurde aus der Wearable Support Library migriert. Diese API stellt einen Teil der Daten bereit, die über CalendarContract verfügbar sind, wird aber automatisch mit Wearables synchronisiert. (I6f2d7)

• In androidx.wear.utils wurde die neue API WearTypeHelper hinzugefügt, um zu ermitteln, ob das angegebene Wear-Gerät für China bestimmt ist. (Ib01a9)

• androidx.wear.widget.ConfirmationOverlay bietet jetzt Bedienungshilfen, mit denen Nachrichten vorgelesen werden, wenn sie festgelegt sind, gefolgt von einer Beschreibung der Animation. (I524dd)

• Fehler behoben, der dazu führte, dass ConfirmationActivity abstürzte, wenn keine Nachricht angegeben wurde. (Ie6055)

• Ein Fehler wurde behoben, durch den bei horizontal scrollenden RecyclerViews alle Interaktionen von WearableDrawerLayout erfasst wurden. (I24c7f)

Version 1.2.0-rc01

1. September 2021

androidx.wear:wear:1.2.0-rc01 wird ohne Änderungen seit der letzten Betaversion veröffentlicht. Version 1.2.0-rc01 enthält diese Commits.

Version 1.2.0-beta01

18. August 2021

androidx.wear:wear:1.2.0-beta01 wird veröffentlicht. Version 1.2.0-beta01 enthält diese Commits.

Fehlerkorrekturen

• Fehler behoben, der dazu führte, dass ConfirmationActivity abstürzte, wenn keine Nachricht angegeben wurde. (Ie6055)

Version 1.2.0-alpha13

4. August 2021

androidx.wear:wear:1.2.0-alpha13 wird veröffentlicht. Version 1.2.0-alpha13 enthält diese Commits.

API-Änderungen

• WearTypeHelper.isChinaDevice wurde in WearTypeHelper.isChinaBuild umbenannt. (I47302)

Fehlerkorrekturen

• Wir haben androidx.wear.widget.ConfirmationOverlay um Funktionen zur Barrierefreiheit erweitert, mit denen Nachrichten vorgelesen werden, wenn sie festgelegt sind, gefolgt von einer Beschreibung der Animation. (I524dd)

Version 1.2.0-alpha12

21. Juli 2021

androidx.wear:wear:1.2.0-alpha12 wird veröffentlicht. Version 1.2.0-alpha12 enthält diese Commits.

API-Änderungen

• Wir haben in androidx.wear.utils die neue API WearTypeHelper hinzugefügt, mit der ermittelt werden kann, ob das betreffende Wear-Gerät für China bestimmt ist. (Ib01a9)

Version 1.2.0-alpha11

30. Juni 2021

androidx.wear:wear:1.2.0-alpha11 wird veröffentlicht. Version 1.2.0-alpha11 enthält diese Commits.

Fehlerkorrekturen

• Ein Fehler wurde behoben, durch den bei horizontal scrollenden RecyclerViews alle Interaktionen von WearableDrawerLayout erfasst wurden. (I24c7f)

Version 1.2.0-alpha10

2. Juni 2021

androidx.wear:wear:1.2.0-alpha10 wird veröffentlicht. Version 1.2.0-alpha10 enthält diese Commits.

Neue Funktionen

• In Alpha 10 wurde die Barrierefreiheit bei gekrümmtem Text und ArcLayouts verbessert. Außerdem wurden einige kleinere Umbenennungen im DismissibleFrameLayout vorgenommen, um die API zu verdeutlichen.

API-Änderungen

• Die folgenden Methoden in DismissibleFrameLayout (Ib195e) wurden umbenannt:
  • Callback#onDismissed -> Callback#onDismissedFinished
  • isSwipeDismissible -> isDismissableBySwipe
  • isBackButtonDismissible -> isDismissableByBackButton
• Die folgenden Methoden wurden endgültig festgelegt (Ib195e):
  • setBackButtonDismissible
  • setSwipeDismissible
  • registerCallback
  • unregisterCallback

Fehlerkorrekturen

• Verwenden Sie den Inhalt der CurvedTextView in TalkBack. (I05798)
• Bessere Barrierefreiheit für normale Ansichten in einem ArcLayout. (I4418d)

Version 1.2.0-alpha09

18. Mai 2021

androidx.wear:wear:1.2.0-alpha09 wird veröffentlicht. Version 1.2.0-alpha09 enthält diese Commits.

API-Änderungen

• Neue Funktion CurvedTextView.setTypeface() (ähnlich wie TextView) zum Festlegen der Schriftart und des Stils (Fettdruck/Kursivschrift) hinzugefügt. (I4653c)
• WearArcLayout wurde in ArcLayout, WearCurvedText in CurvedText und WearArcLayout.ArcLayoutWidget in ArcLayout.Widget umbenannt. (I6e5ce)
  • Am ArcLayout.Widget wurde getThicknessPx in getThickness umbenannt.
  • Konstanten für die vertikale Ausrichtung in ArcLayout.LayoutParams beginnen jetzt mit VERTICAL_ALIGN_ (anstelle des vorherigen VALIGN_)
• Unter CurvedTextView wurden die Methoden setMinSweepDegrees und setMaxSweepDegrees durch setSweepRangeDegrees (I7a9d9) ersetzt.

Version 1.2.0-alpha08

5. Mai 2021

androidx.wear:wear:1.2.0-alpha08 wird veröffentlicht. Version 1.2.0-alpha08 enthält diese Commits.

API-Änderungen

• Um den Code verständlicher zu machen, haben wir einigen Winkelparametern und Rückgabetypen @FloatRange-Anmerkungen hinzugefügt. (I430dd)
• In der Benutzeroberfläche WearArcLayout.ArcLayoutWidget heißt die Methode insideClickArea jetzt „isPointInsideClickArea“. (Ia7307)

Version 1.2.0-alpha07

24. März 2021

androidx.wear:wear:1.2.0-alpha07 wird veröffentlicht. Version 1.2.0-alpha07 enthält diese Commits.

Fehlerkorrekturen

• Fehlerbehebung bei nicht gebogenen untergeordneten Elementen in WearArcLayout, die durch die Verwendung einer Bildschirmgröße mit einer Höhe größer als die Breite verursacht wurden. Diese nicht gebogenen untergeordneten Elemente werden jetzt auf allen Bildschirmtypen korrekt innerhalb eines Bogens platziert.

Version 1.2.0-alpha06

27. Januar 2021

androidx.wear:wear:1.2.0-alpha06 wird veröffentlicht. Version 1.2.0-alpha06 enthält diese Commits.

API-Änderungen

• Migrieren Sie die Bibliothek „Ongoing Activities“ (Laufende Aktivitäten) in eine neue untergeordnete Bibliothek: „wear-ongoing“. Klassen befinden sich jetzt im Paket „androidx.wear.ongoing“ (früher „androidx.wear.ongoingactivities“) (I7c029)
• Migrieren Sie die WearableCalendarContract-Klasse von der Wearable Support Library zu AndroidX. Diese API stellt einen Teil der Daten bereit, die über CalendarContract verfügbar sind, wird aber automatisch mit Wearables synchronisiert. (I6f2d7)

Fehlerkorrekturen

• Deaktivieren Sie standardmäßig die Funktion zum Schließen über die Schaltfläche „Zurück“ im FrameLayout, da das Wischen zum Schließen weiterhin die Hauptmethode zum Zurückkehren zu einem Vollbild auf Wearables ist (Ic24e3)
• Einige Probleme mit der Sichtbarkeit von untergeordneten Elementen in WearArcLayout wurden behoben (Icf912)

Version 1.2.0-alpha05

13. Januar 2021

androidx.wear:wear:1.2.0-alpha05 wird veröffentlicht. Version 1.2.0-alpha05 enthält diese Commits.

Fehlerkorrekturen

• Aktualisieren Sie die Javadoc-Datei der Klasse „AmbientModeSupport“, um Beispiel-Snippets zur besseren Veranschaulichung der allgemeinen Verwendung dieser Klasse bereitzustellen.

Version 1.2.0-alpha04

16. Dezember 2020

androidx.wear:wear:1.2.0-alpha04 wird veröffentlicht. Version 1.2.0-alpha04 enthält diese Commits.

API-Änderungen

• In der Klasse „AmbientModeSupport“ wurde die Unterstützung hinzugefügt, dass eine Aktivität automatisch fortgesetzt werden kann, wenn das Gerät den Inaktivmodus verlässt. Diese Funktion war zuvor in der eingestellten WearableActivity-Klasse der WearableSupportLibrary verfügbar. (I336ab)
• OngoingActivity
  • Die Kategorie kann jetzt beim Erstellen einer laufenden Aktivität festgelegt werden, z. B. OngoingActivitiy.Builder.getCategory(String).
  • „OngoingActivityData“ enthält jetzt einen Zeitstempel für die Erstellung der „OngoingActivity“ – OngoingActivityData.getTimestamp().
  • (I91cb4)
• Es wurde die Möglichkeit hinzugefügt, Ränder für untergeordnete Elemente von WearArcLayout festzulegen.Dazu wurden die Layoutparameter so geändert, dass sie MarginLayoutParams erweitern. Das bedeutet, dass WearArcLayout.LayoutParams android.view.ViewGroup.MarginLayoutParams erweitert. (I2cd88)
• Der Standardwert für den Ankertyp von WearCurvedTextView wurde von WearArcLayout.ANCHOR_START auf WearArcLayout.ANCHOR_CENTER geändert. Dadurch wird die Koordination zwischen dem Bogenlayout und dem gekrümmten Text vereinfacht, da der gekrümmte Text standardmäßig oben mittig ausgerichtet wird und das übergeordnete Bogenlayout ihn an die gewünschte Stelle drehen kann. (I105ff)

Version 1.2.0-alpha03

2. Dezember 2020

androidx.wear:wear:1.2.0-alpha03 wird veröffentlicht. Version 1.2.0-alpha03 enthält diese Commits.

Neue Funktionen

Ein neuer Layout-Container „DismissibleFrameLayout“, der das Schließen über die Rückwärtstaste und/oder Wischen zum Schließen verarbeitet und für die Verwendung in einer Aktivität vorgesehen ist. Es muss mindestens ein Listener hinzugefügt werden, der auf eine Schließungsaktion reagiert. Ein Listener entfernt normalerweise eine enthaltene Ansicht oder ein Fragment aus der aktuellen Aktivität. Mit den Funktionen „setSwipeDismissible(boolean)“ und „setBackButtonDismissible(boolean)“ können Sie die Funktionen direkt steuern. Dieses neue Layout soll das vorhandene SwipeDismissFrameLayout ersetzen.

Bei gekrümmten Widgets werden jetzt Touch-Ereignisse verarbeitet. Normale Widgets in einem WearArcLayout erhalten alle Touch-Ereignisse, die ihrem Koordinatenraum zugeordnet sind. Für WearCurvedTextView (innerhalb oder außerhalb eines WearArcLayout) können onClick- und onLongClick-Handler festgelegt werden.

Für Klassen mit laufenden Aktivitäten werden jetzt VersionedParcelables verwendet, anstatt benutzerdefinierte Serialization/Deserialization zu verwenden. Das statische Symbol und die Touch-Intention sind jetzt erforderlich.

API-Änderungen

• Das Attribut „sweepDegrees“ für WearCurvedTextView wird in „minSweepDegrees“ und „maxSweepDegrees“ unterteilt, um ein flexibleres Layout dieses Widgets zu ermöglichen.

Version 1.2.0-alpha02

11. November 2020

androidx.wear:wear:1.2.0-alpha02 wird veröffentlicht. Version 1.2.0-alpha02 enthält diese Commits.

Mit dieser Version wird erstmals die neue „Ongoing Activities API“ eingeführt. Mit dieser API können Entwickler signalisieren, dass eine lang andauernde Aktivität wie ein Fitnesstraining oder eine Medienwiedergabesitzung gerade läuft. So können Entwickler regelmäßige Statusaktualisierungen wie „Gelaufene Strecke und Zeit“ oder „Aktuell wiedergegebener Titel“ auf dem Zifferblatt oder im App Launcher anzeigen lassen. Diese Funktion ist auf zukünftige Geräte mit aktivierter Funktion für laufende Aktivitäten ausgerichtet.

API-Änderungen

• Neue API für laufende Aktivitäten. Auf nicht unterstützten Geräten wird keine Aktion ausgeführt. (I69a31)

Version 1.2.0-alpha01

28. Oktober 2020

androidx.wear:wear:1.2.0-alpha01 wird veröffentlicht. Version 1.2.0-alpha01 enthält diese Commits.

Neue Funktionen

• Die Komponente „WearCurvedTextView“ wurde hinzugefügt, um leicht gekrümmten Text zu schreiben, der der Krümmung des größten Kreises folgt, der in die Ansicht eingeschrieben werden kann. Anwendungsbeispiel:

<androidx.wear.widget.WearCurvedTextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="example curved text"
        app:anchorAngleDegrees="180"
        app:anchorPosition="center"
        app:clockwise="false"
        style="@android:style/TextAppearance.Large"
/>

• Der WearArcLayout-Container wurde hinzugefügt, um seine untergeordneten Elemente einzeln in einem Bogen entweder im oder gegen den Uhrzeigersinn anzuordnen. Seine untergeordneten Elemente können sowohl Standard-Android-Widgets als auch „gebogene“ Widgets sein, die die ArcLayoutWidget-Schnittstelle implementieren. Anwendungsbeispiel:

<androidx.wear.widget.WearArcLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:anchorPosition="center">
      <ImageView
              android:layout_width="20dp"
              android:layout_height="20dp"
              android:src="@drawable/ic_launcher"
      />
      <androidx.wear.widget.WearCurvedTextView
              android:layout_width="match_parent"
              android:layout_height="match_parent"
              android:text="Curved Text"
              style="@android:style/TextAppearance.Small"
              android:padding="2dp"
       />
  </androidx.wear.widget.WearArcLayout>

(I536da)

Wear-Input 1.2

Version 1.2.0-alpha02

29. September 2021

androidx.wear:wear-input:1.2.0-alpha02 und androidx.wear:wear-input-testing:1.2.0-alpha02 werden freigegeben. Version 1.2.0-alpha02 enthält diese Commits.

API-Änderungen

• disallowEmoji in WearableRemoteInputExtender in setEmojisAllowed umbenannt, um festzulegen, ob die Option zum Zeichnen von Emojis angezeigt wird. (I28393)

Version 1.2.0-alpha01

15. September 2021

androidx.wear:wear-input:1.2.0-alpha01 und androidx.wear:wear-input-testing:1.2.0-alpha01 werden freigegeben. Version 1.2.0-alpha01 enthält diese Commits.

API-Änderungen

• Alle Konstanten für die Schaltflächenposition von WearableButtons wurden freigegeben. (Ibb12c)
• Die Klasse WearableRemoteInputExtender wurde hinzugefügt, mit der der android.app.RemoteInput Wear-spezifische Extras hinzugefügt werden können. (I01903)

Wear-Input 1.1.0

Version 1.1.0

18. August 2021

androidx.wear:wear-input:1.1.0 und androidx.wear:wear-input-testing:1.1.0 werden freigegeben. Version 1.1.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.0.0

• RemoteInputIntentHelper wurde hinzugefügt.
  • Mit dieser Klasse können Sie einen RemoteInput-Intent erstellen. So können Sie in einer anpassbaren Aktivität Input von Ihren Nutzern anfordern.

Version 1.1.0-rc01

4. August 2021

androidx.wear:wear-input:1.1.0-rc01 und androidx.wear:wear-input-testing:1.1.0-rc01 werden freigegeben. Version 1.1.0-rc01 enthält diese Commits.

Keine API-Änderungen seit dem androidx.wear:wear-input:1.1.0-beta01 und dem androidx.wear:wear-input-testing:1.1.0-beta01

Version 1.1.0-beta01

21. Juli 2021

androidx.wear:wear-input:1.1.0-beta01 und androidx.wear:wear-input-testing:1.1.0-beta01 werden seit 1.1.0-alpha03 unverändert veröffentlicht. Version 1.1.0-beta01 enthält diese Commits.

Version 1.1.0-alpha03

30. Juni 2021

androidx.wear:wear-input:1.1.0-alpha03 und androidx.wear:wear-input-testing:1.1.0-alpha03 werden freigegeben. Version 1.1.0-alpha03 enthält diese Commits.

Fehlerkorrekturen

• Ein Fehler wurde behoben, durch den RemoteInput-Intents, denen über RemoteInputHelper.putRemoteInputsExtra RemoteInputs hinzugefügt wurden, abgelehnt wurden.

Version 1.1.0-alpha02

18. Mai 2021

androidx.wear:wear-input:1.1.0-alpha02 und androidx.wear:wear-input-testing:1.1.0-alpha02 werden freigegeben. Version 1.1.0-alpha02 enthält diese Commits.

API-Änderungen

• Bei den Methoden von RemoteInputIntentHelper, die zum Abrufen oder Setzen von Extras verwendet werden, die die Labels „Titel“, „Abbrechen“, „Bestätigen“ und „In Bearbeitung“ darstellen, wird jetzt CharSequence anstelle von String für diese Labels verwendet. (I0e71f)

Version 1.1.0-alpha01

27. Januar 2021

androidx.wear:wear-input:1.1.0-alpha01 und androidx.wear:wear-input-testing:1.1.0-alpha01 werden freigegeben. Version 1.1.0-alpha01 enthält diese Commits.

API-Änderungen

• Die Klasse „RemoteInputIntent“ aus der Wearable-Supportbibliothek zu AndroidX migrieren Die migrierte Klasse wird in „RemoteInputIntentHelper“ umbenannt. Sie bietet Hilfsfunktionen zur Unterstützung von Remote-Eingängen durch Starten eines Intents. (I47cee)

Wear-Input 1.0.0

Version 1.0.0

2. Dezember 2020

androidx.wear:wear-input:1.0.0 und androidx.wear:wear-input-testing:1.0.0 werden freigegeben. Version 1.0.0 enthält diese Commits.

Dieser Release ist mit 1.0.0-rc01 identisch.

Wichtige Funktionen von 1.0.0

• Migration der WearableButtons-Funktionen von der Wearable-Supportbibliothek zu Jetpack.

• androidx.wear.input.test.TestWearableButtonsProvider wurde hinzugefügt, in der androidx.wear.input.WearableButtonsProvider implementiert ist, um das Testen von Anwendungen zu unterstützen, die mit der androidx.wear:wear-input-Bibliothek entwickelt wurden.

Version 1.0.0-rc01

11. November 2020

androidx.wear:wear-input:1.0.0-rc01 und androidx.wear:wear-input-testing:1.0.0-rc01 werden freigegeben. Version 1.0.0-rc01 enthält diese Commits.

Dieser Release ist mit 1.0.0-beta01 identisch.

Version 1.0.0-beta01

28. Oktober 2020

androidx.wear:wear-input:1.0.0-beta01 und androidx.wear:wear-input-testing:1.0.0-beta01 werden seit 1.1.0-alpha01 unverändert veröffentlicht. Version 1.0.0-beta01 enthält diese Commits.

Wear-Input-Testing Version 1.0.0-alpha01

14. Oktober 2020

androidx.wear:wear-input-testing:1.0.0-alpha01 wird veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.

API-Änderungen

• androidx.wear.input.test.TestWearableButtonsProvider wurde hinzugefügt, in dem androidx.wear.input.WearableButtonsProvider implementiert ist, um das Testen von Anwendungen zu unterstützen, die mit der androidx.wear:wear-input-Bibliothek entwickelt wurden. (I0ed0c)

Wear-Input-Version 1.0.0-alpha01

2. September 2020

androidx.wear:wear-input:1.0.0-alpha01 wird veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.

Neue Funktionen

Migration der WearableButtons-Funktionen von der Wearable-Supportbibliothek zu Jetpack. Zusätzliche Testfunktionen werden in der androidx.wear:wear-input-testing-Bibliothek in der nächsten Jetpack-Version verfügbar sein.

Version 1.1.0

Version 1.1.0

14. Oktober 2020

androidx.wear:wear:1.1.0 wird veröffentlicht. Version 1.1.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.0.0

• Dem Attribut „boxedEdges“ (jetzt „layout_BoxedEdges“) für BoxInsetLayout wurde das Präfix „layout_“ hinzugefügt, um der Android-Namenskonvention zu entsprechen. Dadurch wird der Linterfehler in Android Studio für diese Attribute entfernt. (I4272f)
• Optionales EXTRA_ANIMATION_DURATION_MILLIS zu ConfirmationActivity hinzugefügt, um die Dauer festzulegen, während der das Bestätigungsdialogfeld angezeigt wird. (adb83ce, b/143356547)
• WearableActionDrawView wurde aktualisiert, um das Maximieren des Aktionsmenüs zu verzögern, bis es zum ersten Mal geöffnet wird. (I01026, b/163870541)

Version 1.1.0-rc03

2. September 2020

androidx.wear:wear:1.1.0-rc03 wird veröffentlicht. Version 1.1.0-rc03 enthält diese Commits.

Fehlerkorrekturen

• Das Problem, dass im geöffneten Aktionsmenü keine Inhalte angezeigt wurden, wurde behoben. (I01026, b/163870541)

Version 1.1.0-rc02

24. Juni 2020

androidx.wear:wear:1.1.0-rc02 wird veröffentlicht. Version 1.1.0-rc02 enthält diese Commits.

Fehlerkorrekturen

• Dem Attribut „boxedEdges“ (jetzt „layout_boxedEdges“) für BoxInsetLayout wurde das Präfix „layout_“ hinzugefügt, um der Android-Namenskonvention zu entsprechen. Dadurch wird der Linterfehler in Android Studio für diese Attribute entfernt.

Version 1.1.0-rc01

14. Mai 2020

androidx.wear:wear:1.1.0-rc01 wird seit .1.0-beta01 unverändert veröffentlicht. Version 1.1.0-rc01 enthält diese Commits.

Version 1.1.0-beta01

29. April 2020

androidx.wear:wear:1.1.0-beta01 wird seit androidx.wear:wear:1.1.0-alpha01 unverändert veröffentlicht. Version 1.3.0-beta01 enthält diese Commits.

Version 1.1.0-alpha01

15. April 2020

androidx.wear:wear:1.1.0-alpha01 wird veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.

API-Änderungen

• Optionales EXTRA_ANIMATION_DURATION_MILLIS zu ConfirmationActivity hinzugefügt, um die Dauer festzulegen, während der das Bestätigungsdialogfeld angezeigt wird. (adb83ce, 134523c, b/143356547)

Fehlerkorrekturen

• WearableActionDrawView wurde aktualisiert, um das Maximieren des Aktionsmenüs zu verzögern, bis es zum ersten Mal geöffnet wird. (5cd32f7)