Wear
androidx.wear.activity
androidx.wear.ambient
androidx.wear.input
androidx.wear.utils
androidx.wear.widget
androidx.wear.widget.drawer
(Siehe Refdocs zu allen Wear-Paketen)
In dieser Tabelle sind alle Artefakte in der Gruppe androidx.wear
aufgeführt.
Artefakt | Stabile Version | Releasekandidat | Beta-Ausgabe | Alpha-Release |
---|---|---|---|---|
Wear | 1.3.0 | - | - | 1.4.0-alpha01 |
Wear-Eingabe | 1.1.0 | - | - | 1.2.0-alpha02 |
Wear-Eingabetest | 1.1.0 | - | - | 1.2.0-alpha02 |
Fortlaufend | 1.0.0 | - | - | 1.1.0-alpha01 |
Wear-Phone-Interaktionen | 1.0.1 | - | - | 1.1.0-alpha04 |
Wear-Remote-Interaktionen | 1.0.0 | - | 1.1.0-beta01 | - |
Abhängigkeiten deklarieren
Um eine Wear-Abhängigkeit hinzuzufügen, musst du das Maven-Repository von Google zu deinem Projekt arbeiten. Maven-Repository von Google lesen .
Fügen Sie der Datei build.gradle
die Abhängigkeiten für die Artefakte hinzu, die Sie benötigen
Ihre App oder Ihr Modul:
Cool
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" }
Kotlin
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
Dein Feedback hilft uns, Jetpack zu verbessern. Teilen Sie uns mit, wenn Sie neue Ausgaben entdecken oder zur Verbesserung dieser Bibliothek. In der bestehende Probleme in dieser Bibliothek, bevor Sie eine neue erstellen. So können Sie für ein vorhandenes Problem abstimmen: indem Sie auf die Sternschaltfläche klicken.
Weitere Informationen finden Sie in der Dokumentation zur Problemverfolgung. .
Wear Core Version 1.0
Version 1.0.0-alpha01
29. Mai 2024
androidx.wear:wear-core:1.0.0-alpha01
wurde veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
API-Änderungen
- Die neue Klasse
WearApiVersionhelper
wurde hinzugefügt, um die Prüfung der Laufzeit-API-Kompatibilität auf Wear OS zu erleichtern. Clients können diese statische Hilfsklasse und die bereitgestellte Methode (#isApiVersionAtLeast(VERSION)
) verwenden, um die Kompatibilität zu prüfen.
Wear-Tooling-Vorschau Version 1.0
Version 1.0.0
29. November 2023
androidx.wear:wear-tooling-preview:1.0.0
wurde veröffentlicht. Version 1.0.0 enthält diese Commits.
Funktionen in Version 1.0.0
- Füge
WearDevices
zur Liste gültiger Wear-Geräte hinzu, 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
wurde ohne Änderungen freigegeben. 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
wurde ohne Änderungen freigegeben. 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
wurde veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
API-Änderungen
WearDevices
zur Liste gültiger Wear-Geräte hinzufügen, 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
wurde veröffentlicht. Version 1.4.0-alpha01 enthält diese Commits.
Fehlerkorrekturen
ConfirmationOverlay
-Symbol vertikal zentrieren, wenn keine Nachricht vorhanden ist. (I496d8)
Wear-Version 1.3
Version 1.3.0
9. August 2023
androidx.wear:wear:1.3.0
wurde ohne Änderungen seit dem 1.3.0-rc01
freigegeben. Version 1.3.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.2.0
- Migrieren Sie
AmbientModeSupport
, umLifecycleObserver
zu verwenden.AmbientModeSupport
zugunsten der neuen lebenszyklusbezogenen Klassen einstellen. - Aktualisiere
ConfirmationOverlay
mit neuen Symbolen, Layouts, Schriftarten und Messwerten für Schriftarten SwipeDismissTransitionHelper
wurde aktualisiert, um ein Hintergrund-Drawable anstelle eines zweitenView
zu verwenden, um Fehler bei der Verwendung desFragmentContainerView
zu korrigieren- Die
SwipeDismissFrameLayout
-Animation wurde aktualisiert, um sie an die Wear-Plattform und Wear Compose-Implementierungen anzupassen. - Fehlerkorrektur für
SwipeDismissFrameLayout
, um das versehentliche Schließen von Fragmenten mit vertikaler Ausrichtung zu vermeiden ArcLayout
unterstützt jetzt Expansionsstärken, die ähnlich wie normale Layoutstärken funktionieren.layoutDirection
aufArcLayout
unterstützen
Version 1.3.0-rc01
21. Juni 2023
androidx.wear:wear:1.3.0-rc01
wurde ohne Änderungen seit dem 1.3.0-beta01
freigegeben. Version 1.3.0-rc01 enthält diese Commits.
Version 1.3.0-beta01
7. Juni 2023
androidx.wear:wear:1.3.0-beta01
wurde veröffentlicht. Version 1.3.0-beta01 enthält diese Commits.
API-Änderungen
AmbientLifecycleObserver
nach Feedback aktualisiert.AmbientLifecycleObserverInterface
wurde inAmbientLifecycleObserver
umbenannt. Durch Aufrufen vonAmbientLifecycleObserver(...)
kann eine Instanz abgerufen werden.isAmbient
ist jetzt ein Feld und keine Methode. (I84b4f)
Fehlerkorrekturen
- Nullprüfungen für Fälle hinzufügen, 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
wurde veröffentlicht. Version 1.3.0-alpha05 enthält diese Commits.
API-Änderungen
- Migrieren Sie
AmbientModeSupport
, umLifecycleObserver
zu verwenden.AmbientModeSupport
zugunsten der neuen lebenszyklusbezogenen Klassen einstellen. (I1593b)
Fehlerkorrekturen
- Aktualisiert den Hintergrund-Scrum-Ansatz von
SwipeDismissTransitionHelper
, um Drawables zu verwenden, anstatt eine Ansicht hinzuzufügen, um Fehler bei der Verwendung vonFragmentContainerView
zu beheben. (I851cd)
Version 1.3.0-alpha04
25. Januar 2023
androidx.wear:wear:1.3.0-alpha04
wurde veröffentlicht. Version 1.3.0-alpha04 enthält diese Commits.
Fehlerkorrekturen
- Wir haben die Animation in
SwipeDismissFrameLayout
aktualisiert, um sie an die Wear-Plattform und Wear Compose-Implementierungen anzupassen. (I7261b)
Version 1.3.0-alpha03
24. August 2022
androidx.wear:wear:1.3.0-alpha03
wurde veröffentlicht. Version 1.3.0-alpha03 enthält diese Commits.
Neue Funktionen
ArcLayout
unterstützt jetzt Vergrößerungsstärken, die ähnlich wie normale Layoutstärken funktionieren. Das bedeutet, dass Sie die relative Größe untergeordneter Elemente angeben können, ohne ihre Winkel direkt berechnen zu müssen. Außerdem haben wir eineMaxAngleDegrees
-Best-Effort-Funktion hinzugefügt, die beim Maximieren untergeordneter Elemente mit Gewichtungen berücksichtigt wird. Beispiel: können Sie den Bogen bei mehreren untergeordneten Elementen mit einer Gewichtung auf 90 Grad fixieren, so würde auch der Raum berücksichtigt, der von nicht-maximierten Elementen eingenommen wird.
API-Änderungen
- Wir haben die Gewichtung zu
ArcLayout.LayoutParams
hinzugefügt, wodurch ein Widget erweitert werden kann, um den verfügbaren Bereich auszufüllen. Wenn mehr als ein Widget vorhanden ist, ist der Anteil des verfügbaren Platzes proportional zu seiner Gewichtung. Außerdem haben wirArcLayout.setMaxAngleDegrees
hinzugefügt, sodass Sie die Expansion beispielsweise auf 90 Grad beschränken können. Hinweis: Dies wirkt sich nicht auf das Layout von untergeordneten Widgets mit fester Größe aus. Schließlich verfügtArcLayout.Widget
nun übersetSweepAngleDegrees
, was es demArcLayout
ermöglicht, ein Widget mit einer Gewichtung ungleich null zu kennzeichnen. (I75f24) - Null-Zulässigkeit von
setColorFilter
(I99ddf, b/236498063) aktualisiert
Version 1.3.0-alpha02
23. Februar 2022
androidx.wear:wear:1.3.0-alpha02
wurde veröffentlicht. Version 1.3.0-alpha02 enthält diese Commits.
Neue Funktionen
layoutDirection
aufArcLayout
unterstützen (I14d49)- Verbesserte Meldung der Inhaltsbeschreibung für ConfirmationOverlay (I0fdf8)
- Aktualisiere
ConfirmationOverlay
mit neuen Symbolen bzw. neuem Layout. (If5b54)
Fehlerkorrekturen
- ProGuard-Regeln wurden hinzugefügt, um sicherzustellen, dass umgebungsbezogener Code beibehalten wird (Idaa10).
- Vermeiden Sie das versehentliche Schließen von Fragmenten in SwipeDismissFrameLayout mit einem vertikalen Fling (Idb6d8)
- Bestätigungs-Overlay korrigieren, wenn keine Meldung angezeigt wird (I63e6f)
Externer Beitrag
- Dae Gyu LEE (Samsung) – Vermeiden Sie das versehentliche Schließen von Fragmenten in SwipeDismissFrameLayout durch vertikales Ziehen (Idb6d8)
Version 1.3.0-alpha01
29. September 2021
androidx.wear:wear:1.3.0-alpha01
wurde veröffentlicht. Version 1.3.0-alpha01 enthält diese Commits.
Fehlerkorrekturen
ConfirmationOverlay
schiebt das Symbol jetzt nach oben, um längere Nachrichten angezeigt, ohne dass die Nachricht in den Glasrand des Geräts eindringt (oder außerhalb des Bildschirms). (I54bff)
Tragbare fortlaufende und Interactions Version 1.1.0
Version 1.1.0-beta01
24. Juli 2024
androidx.wear:wear-remote-interactions:1.1.0-beta01
wurde veröffentlicht. Version 1.1.0-beta01 enthält diese Commits. Der Release 1.3.0-beta01 von Wear Remote Interactions gibt an, dass dieser Release der Bibliothek vollständig ist und die API gesperrt ist (sofern nicht als experimentell gekennzeichnet).
Version 1.1.0-alpha04
10. Januar 2024
androidx.wear:wear-phone-interactions:1.1.0-alpha04
wurde 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 Remoteauthentifizierung verfügbar ist. (Ibc10c)
Version 1.1.0-alpha02
10. Januar 2024
androidx.wear:wear-remote-interactions:1.1.0-alpha02
wurde veröffentlicht. Version 1.1.0-alpha02 enthält diese Commits.
API-Änderungen
- Wir haben
RemoteActivityHelper.isRemoteActivityHelperAvailable
hinzugefügt. Damit können Sie prüfen, ob die Funktion zum Starten einer Remote-Aktivität verfügbar ist. (I107a9) - Der Konstruktor von
RemoteActivityHelper
wurde so aktualisiert, dass er mit optionalen Parametern in Java kompatibel ist. (I75554)
Version 1.1.0-alpha01
21. Juni 2023
androidx.wear:wear-remote-interactions:1.1.0-alpha01
wurde veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.
Fehlerkorrekturen
- Vervollständigungen und Fehlerbehandlung in
RemoteActivityHelper
wurden 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
wurde veröffentlicht. Version 1.1.0-alpha03 enthält diese Commits.
Fehlerkorrekturen
redirectUrl
vonOAuthRequest
gibt jetzt einen leeren String zurück, wenn die Weiterleitungs-URL nicht in der gegebenen 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
wurde 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 nicht funktionierenden Links zuErrorCode
(I260e8)
Wear-Phone-Interactions Version 1.1.0-alpha01
15. September 2021
androidx.wear:wear-phone-interactions:1.1.0-alpha01
wurde veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.
API-Änderungen
Tragbare fortlaufende und Interactions Version 1.0.0
Wear-Phone-Interactions Version 1.0.1
15. Dezember 2021
androidx.wear:wear-phone-interactions:1.0.1
wurde veröffentlicht. Version 1.0.1 enthält diese Commits.
Fehlerkorrekturen
- Ein Fehler wurde behoben, der vom
BridgingManager
ausgelöst wurde, wenn versucht wurde, Bridging-Benachrichtigungen ohneexcludedTags
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
wurden veröffentlicht. Version 1.0.0 enthält diese Commits.
Hauptfunktionen von Version 1.0.0
Die Telefon-Interaktionsbibliothek enthält APIs für Interaktionen zwischen Wearables und Smartphones. Es enthält Folgendes:
PhoneDeviceType
. Diese Methode bietet Hilfsmethoden, mit denen der Typ des Smartphones bestimmt werden kann, mit dem die aktuelle Smartwatch gekoppelt ist. Diese Funktion ist nur auf Wearables verfügbar.- Mit den APIs
BridgingManager
,BridgingManagerService
undBridgingConfig
können Sie Benachrichtigungen zur Laufzeit aktivieren oder deaktivieren und optional Tags für Benachrichtigungen festlegen, die vom Bridging-Modus ausgenommen sind. RemoteAuthClient
bietet Unterstützung für die Remote-Authentifizierung auf Wearables sowie Unterstützung für das Hinzufügen der OAuth PKCE-Erweiterung. Zusätzliche Handler und Hilfsklassen für die Kommunikation werden bereitgestellt.
Die Remote Interaction Library enthält APIs für Interaktionen zwischen Wearables und Smartphones. Es enthält Folgendes:
WatchFaceConfigIntentHelper
mit Hilfsfunktionen zum Angeben der ID und des Komponentennamens in den Zifferblatt-Konfigurationsaktivitäten für den Companion auf dem Smartphone.RemoteActivityHelper
-Klasse, die zum Öffnen von Intents auf anderen Geräten verwendet werden kann (z.B. von Smartwatch zu Smartphone).
Wear-Smartphone-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
wurden veröffentlicht. Version 1.0.0-rc01 enthält diese Commits.
Fehlerkorrekturen
- Fehlerkorrektur, die verhindert, dass in den Google Play-Diensten gemeldete Fehler an den Aufrufer weitergegeben werden, wenn RemoteActivityHelper verwendet wird (I60d60)
- Es wurde ein Fehler behoben, bei dem RemoteActivityHelper sein Future nie erfüllt, wenn keine verbundenen Knoten vorhanden waren oder die angeforderte nodeId nicht gefunden wurde (I60d60).
Fortlaufende Wear OS-Version 1.1
Version 1.1.0-alpha01
23. August 2023
androidx.wear:wear-ongoing:1.1.0-alpha01
wurde veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.
API-Änderungen
- Füge der laufenden Aktivität ein Feld für die Inhaltsbeschreibung hinzu. Sie wird von Bedienungshilfen verwendet, um die laufenden Aktivitäten zu beschreiben. (I79fc6)
Fehlerkorrekturen
@RequiresPermission
wurde APIs hinzugefügt, für die die BerechtigungPOST_NOTIFICATIONS
ab SDK 33 erforderlich ist. (Ie542e, b/238790278)
Wear-Ongoing Version 1.0.0
1. September 2021
androidx.wear:wear-ongoing:1.0.0
wurde veröffentlicht. Version 1.0.0 enthält diese Commits.
Hauptfunktionen von Version 1.0.0
- Die Wear Ongoing Activity API ist eine API für Entwickler, einschließlich Drittentwickler, die ihre Aktivitäten als „Laufende Aktivitäten“ kennzeichnen und die erforderlichen Informationen zur Verfügung stellen können.
- Laufende Aktivitäten sind Aktivitäten, die im Hintergrund der Uhr ausgeführt werden könnten (z.B. Trainingseinheiten, Anrufe und Medien). Unter Wear 3 wird eine als laufende Aktivität deklarierte Aktivität durch ein spezielles Overlay-Symbol auf dem Zifferblatt und ein anderes Rendering im App Launcher stärker hervorgehoben.
- Weitere Informationen findest du im Leitfaden zu laufenden Wear-Aktivitäten.
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
wurden veröffentlicht. Version 1.0.0-beta01 enthält diese Commits.
API-Änderungen
- Klasse
RemoteIntentHelper
wurde inRemoteActivityHelper
umbenannt. Die FunktionenRemoteIntentHelper#getRemoteIntentExtraIntent
undRemoteIntentHelper#getRemoteIntentNodeId
wurden inRemoteActivityHelper#getTargetIntent
bzw.RemoteActivityHelper#getTargetNodeId
umbenannt. (ID2042)
Fortlaufende Wear OS-Version 1.0.0-rc01
18. August 2021
androidx.wear:wear-ongoing:1.0.0-rc01
wurde ohne Änderungen seit dem 1.0.0-beta01
freigegeben. 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
wurde veröffentlicht. Version 1.0.0-beta01 enthält diese Commits.
API-Änderungen
- Einige Setter in OngoingActivity.Builder akzeptieren jetzt ein Null-Arguments, um dem Ereignis Symmetrie und Konsistenz Setter und Getter (I17ee5)
Wear-Phone-Interactions Version 1.0.0-alpha07
4. August 2021
androidx.wear:wear-phone-interactions:1.0.0-alpha07
wurde veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.
API-Änderungen
WearTypeHelper.isChinaDevice
wurde inWearTypeHelper.isChinaBuild
umbenannt. (I47302)- Wir haben die RemoteAuthClient-Bibliothek so aktualisiert, dass "redirect_uri" automatisch auf Grundlage des Gerätetyps (RoW/China) ausgewählt wird. (I38866)
- Es wurde ein Fehler behoben, durch den das Konvertieren von BridgingConfig in/von Bundle mit ClassCastException fehlschlug. Einheitentests für die Klasse BridgingManagerService wurden hinzugefügt. (I68ecb)
Wear-Remote-Interactions Version 1.0.0-alpha06
4. August 2021
androidx.wear:wear-remote-interactions:1.0.0-alpha06
wurde 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
wurde veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.
API-Änderungen
- Die Klasse
BridgingManagerSeviceBinder
ist jetzt eine abgeleitete Klasse von Service und wurde in BridgingManagerSevice umbenannt. (I9fca2) - Die Methode
RemoteAuthClient.Callback.onAuthorizationError
wird geändert, um den OAuthRequest-Parameter einzubeziehen. Methoden, die ein Callback erfordern, erfordern jetzt auch einen Executor, damit der Callback ausgeführt werden kann. (I35e11)
Fehlerkorrekturen
- Wir haben das Authentifizierungs-API durch mehr dokumentierte Parameter und durch die Verwendung von Eigenschaften, wo möglich, deutlicher gemacht. (I12287)
Wear-Phone-Interactions Version 1.0.0-alpha05
30. Juni 2021
androidx.wear:wear-phone-interactions:1.0.0-alpha05
wurde veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.
Fehlerkorrekturen
- Parameter, die im Konstruktor für
BridgingConfig.Builder
übergeben werden müssen, sind dokumentiert.
Wear-Ongoing Version 1.0.0-alpha06
2. Juni 2021
androidx.wear:wear-ongoing:1.0.0-alpha06
wurde veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.
API-Änderungen
- Fügen Sie den laufenden Aktivitäten das Feld „Titel“ hinzu. (I7a405)
Fehlerkorrekturen
SerializationHelper.copy()
erstellt jetzt eine Verteidigungskopie des Informationen (I8b276)- Verbesserte Dokumentation zu setCategory (Iff01f)
Wear-Ongoing Version 1.0.0-alpha05
18. Mai 2021
androidx.wear:wear-ongoing:1.0.0-alpha05
wurde veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.
API-Änderungen
OngoingActivity
verfügt jetzt über Getter, um alle Werte abzurufen, die direkt über den Builder festgelegt wurden (oder die Standardwerte aus der zugehörigen Benachrichtigung). (Id8ac8)- Mit der neuen Klasse
Status
wird jetzt der Status derOngoingActivity
erstellt. OngoingActivityData
undOngoingActivityStatus
sind nicht mehr Teil der öffentlichen API.
- Mit der neuen Klasse
Die Klassen
TextStatusPart
undTimerStatusPart
sind nicht mehr Teil der öffentlichen API. (I57fb6)- Verwenden Sie
Status.TextPart
, um einPart
mit statischem Text zu erstellen. - Um eine
Part
mit einer Stoppuhr (zählt vorwärts) zu erstellen, verwendeStatus.Stopwatch
- Um einen
Part
mit einem Timer (Countdown) zu erstellen, verwenden SieStatus.Timer
- Verwenden Sie
Wear-Ongoing Version 1.0.0-alpha04
5. Mai 2021
androidx.wear:wear-ongoing:1.0.0-alpha04
wurde veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.
API-Änderungen
- Bei „OngoingActivity“ heißen die Methoden „fromExistingOngoingActivity“ jetzt „recoveryOngoingActivity“.
- OngoingActivity hat jetzt eine ganze Reihe von Getters, die zuvor nur unter OngoingActivityData. (I0ee4d)
Wear-Remote-Interactions Version 1.0.0-alpha05
21. Juli 2021
androidx.wear:wear-remote-interactions:1.0.0-alpha05
wurde 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), mit der Intents auf anderen Geräten geöffnet werden können (z.B. von Smartwatch zu Smartphone). (I1d7e0)Die PlayStoreAvailability-Klasse wurde aus der AndroidX-Bibliothek entfernt. Wenn Sie herausfinden 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 das verbundene Smartphone ein Android-Smartphone ist. Verwenden Sie dann die Methodeandroidx.wear.utils.WearTypeHelper.isChinaDevice
, um festzustellen, ob das verbundene Smartphone ein chinesisches Gerät ist. Wenn es sich um ein Android-Smartphone handelt und es sich nicht um ein chinesisches Gerät handelt, 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
wurde veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.
API-Änderungen
- Die
ErrorCode
-Konstanten wurden aktualisiert, um die neue Bibliothek abwärtskompatibel mit der Implementierung in der Wearable-Supportbibliothek zu machen.
Fehlerkorrekturen
- Ein Fehler wurde behoben, der 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
wurde veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.
API-Änderungen
PlayStoreAvailability
wurde zu einer Klasse geändert, die ein Companion-Objekt mit statischen Methoden enthält. Die Nutzung bleibt gleich.
Fehlerkorrekturen
- Das Zusammenfassungsdokument für
WatchFaceConfigIntentHelper
wurde korrigiert, sodass der Beispielcode mit tatsächlichen HTML-Zeichen korrekt angezeigt wird.
Laufende Wear-Smartphone-Interaktionen, 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
wurden veröffentlicht. 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 bietet Unterstützung für die Remote-Authentifizierung auf Wearables sowie das Hinzufügen der OAuth PKCE-Erweiterung. Zusätzliche Handler und Hilfsklassen für die Kommunikation werden bereitgestellt.
- Laufende Aktivitäten können jetzt mithilfe des neuen OngoingActivity.Builder-Konstruktors mit einer Benachrichtigung verknüpft werden, die ein -Tag enthält.
API-Änderungen
- Unterstützung für Benachrichtigungs-Tags für laufende Aktivitäten hinzugefügt Bibliothek (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
wurde veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.
Neue Funktionen
- Die PlayStoreAvailability-Klasse wird von der Wearable-Supportbibliothek zu AndroidX migriert. Diese bietet eine API, mit der geprüft werden kann, ob der Play Store auf dem Smartphone verfügbar ist.
Fehlerkorrekturen
- PlayStoreAvailability-Klasse wird migriert von Wearable-Supportbibliothek für 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
wurden veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.
API-Änderungen
- Komplexere Status werden jetzt unterstützt. Sie bestehen aus einer Vorlage (oder mehrere) und eine Reihe von Teilen, die zum Füllen der die Platzhalter der Vorlage. OngoingActivityStatus verfügt jetzt über eine statische Methode zum Erstellen einfacher Status mit nur einem Teil (einem Text oder Timer) und einem Builder zur Erstellung komplexerer Status. (I1fe81)
- Verschieben der BridgingManager- und BridgingConfig-Klassen aus der Wear-Supportbibliothek zu AndroidX. Diese API bietet APIs zum Aktivieren/Deaktivieren von Benachrichtigungen zur Laufzeit und optional zum Festlegen von Tags für Benachrichtigungen, 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
wurden veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
API-Änderungen
Migrieren Sie die Bibliothek „Laufende Aktivitäten“ in eine neue Unterbibliothek: „Wear-ongoing“. Kurse sind jetzt im Paket „androidx.wear.ongoing“ verfügbar (bisher androidx.wear.ongoingactivities) (I7c029).
Erstellen Sie eine neue Supportbibliothek mit Klassen, die Interaktionen zwischen Wearables und Smartphones unterstützen. Sie enthält zuerst Klassen, die aus der Wearable-Supportbibliothek migriert wurden. (ID5180)
Migrieren Sie die PhoneDeviceType-Klasse von der Wearable-Supportbibliothek zu AndroidX. Die migrierte Klasse wird in PhoneTypeHelper umbenannt. Sie bietet Hilfsmethoden, mit denen sich der Typ des Smartphones bestimmen lässt, mit dem die aktuelle Smartwatch gekoppelt ist. Die Klasse kann nur auf Wearable-Geräten verwendet werden. (Ibd947)
Erstelle eine neue Supportbibliothek mit Klassen, die Interaktionen zwischen Wearables und Smartphones unterstützen. Sie enthält zuerst Klassen, die aus der Wearable-Supportbibliothek migriert wurden. (I9deb4)
WatchFaceCompanion-Klasse von der Wearable-Supportbibliothek zu AndroidX migrieren Die migrierte Klasse wird in „WatchFaceConfigIntentHelper“ umbenannt. Sie bietet Hilfsfunktionen zum Angeben der ID und des Komponentennamens in den Zifferblatt-Konfigurationsaktivitäten im Companion-Modus auf dem Smartphone. Sie kann auch lokal verwendet werden, um das Zifferblatt auf dem Wearable-Gerät zu konfigurieren. (Ia455f)
Zusatzfunktionen und Zifferblatt 1.0.0 tragen
Version 1.0.0-alpha22
15. September 2021
androidx.wear:wear-*:1.0.0-alpha22
wurde veröffentlicht. Version 1.0.0-alpha22 enthält diese Commits.
Neue Funktionen
- EditorSession abonniert jetzt Lebenszyklus-Beobachter, sodass Sie sie nicht mehr explizit schließen müssen, wenn Ihre Aktivitäten verschwinden.
API-Änderungen
- EditorSession und ListenableEditorSession verwenden jetzt kötlin StateFlows für complicationSlotsState, ComplicationsPreviewData und ComplicationsDataSourceInfo. (I761d9)
- EditorSession#userStyle ist jetzt ein
MutableStateFlow<UserStyle>
(I32ca9) - EditorSession.createOnWatchEditorSession verwendet jetzt einen Lebenszyklus-Beobachter und wird automatisch geschlossen, wenn onDestroy beobachtet wird. Außerdem muss für
createOnWatchEditorSession
jetzt nur noch die Aktivität übergeben werden. Identische Änderungen wurden auch auf ListenableEditorSession angewendet. (IC6b7f) - Der Konstruktor von CustomValueUserStyleSetting wurde als Teil der öffentlichen API wiederhergestellt. (I2e69a)
UserStyle
übernimmt jetzt die Einstellungen vonMap<UserStyleSetting, UserStyleSetting.Option>
undMutableUserStyleSetting#put
gibt die Ausnahme „domain“ aus, wenn die Einstellung nicht im Schema enthalten ist oder wenn die Option nicht mit der Einstellung übereinstimmt. (Iba40f)
Version 1.0.0-alpha21
1. September 2021
androidx.wear:wear-*:1.0.0-alpha21
wurde veröffentlicht. Version 1.0.0-alpha21 enthält diese Commits.
API-Änderungen
- Alle öffentlichen Zifferblatt-, Client-, Editor- und Zusatzfunktionen-APIs verwenden jetzt zeitweise java.time.Instant anstelle von Long. Daher wurde das Mindest-API-Level auf 26 erhöht. (I3cd48)
- Die Zifferblatt- und Zusatzfunktionen-APIs verwenden jetzt die unveränderliche ZonedDateTime anstelle von Google Kalender. (I25cf8)
- „ComplicationSlots“ wird jetzt mit „NoDataComplicationData“ initialisiert, „ComplicationSlot.complicationData“ hat jetzt immer einen Wert und „CanvasComplicationDrawable.complicationData“ kann keine Nullwerte mehr enthalten. (I4dfd6) Dadurch wird das Flimmern beim Wechseln zwischen Zifferblättern verringert, aber nicht vermieden.
Version 1.0.0-alpha20
18. August 2021
androidx.wear:wear-*:1.0.0-alpha20
wurde veröffentlicht. Version 1.0.0-alpha20 enthält diese Commits.
API-Änderungen
- Es wurde createFallbackPreviewData zu ComplicationDataSourceInfo hinzugefügt. Dieses kann verwendet werden, wenn ComplicationDataSourceInfoRetriever.retrievePreviewComplicationData den Wert null zurückgibt. (I38c4d)
- ComplicationDataSourceUpdateRequester wurde in eine Schnittstelle umgewandelt, die Mocking in Einheitentests ermöglicht. Mit ComplicationDataSourceUpdateRequester.create() können Sie einen konkreten ComplicationDataSourceUpdateRequester erstellen. (I7da22)
- „RenderParameters.usedComplicationSlotIds“ wurde durch „RenderParameters.lastComplicationTapDownEvents“ ersetzt. Diese Klasse stellt die neue TapEvent-Klasse bereit, die ein Dreifache von x- und y-Koordinaten des Tippens in Pixeln sowie einen Zeitstempel enthält.
WatchFace.TapListener.onTap
wurde durchonTapEvent(@TapType tapType: Int, tapEvent: TapEvent)
ersetzt. Außerdem wurde „InteractiveWatchFaceClient.displayPressedAnimation
“ entfernt. (Id87d2) - Explizites Threading-Anmerkung für setImportantForAccessibility (I990fa) hinzugefügt
- „ComplicationSlotBoundsType“ wurde zu „androidx-wear-watchface.ComplicationSlotBoundsType“ in „wear/wear-watchface“ verschoben. (I09420)
- Die Übergabe von Zeichenfolgenressourcen-IDs an UserStyleSetting und Optionen wird jetzt unterstützt. Dies ist jetzt die empfohlene Methode zum Erstellen dieser Objekte. (I03d5f)
- Für die maximale Wire-Größe eines UserStyle-Schemas wurden Beschränkungen festgelegt. Außerdem dürfen Symbole im Schema nicht größer als 400 x 400 Pixel sein. (I3b65b)
- Wir haben eine MutableUserStyle-Klasse hinzugefügt, um Änderungen an UserStyle-Instanzen zu unterstützen (I95a40).
- Wir haben
ListenableWatchFaceMetadataClient.Companion#listenableCreateWatchFaceMetadataClient
inListenableWatchFaceMetadataClient.Companion#createListenableWatchFaceMetadataClient
umbenannt. (I64ce2) - Wir haben „EditorState.previewComplicationsData“ so geändert, dass nur Daten für aktivierte Zusatzfunktionen enthalten sind. Außerdem haben wir
EditorSession.DEFAULT_PREVIEW_TIME_MILLIS
hinzugefügt, die bei Übergabe anrenderWatchFaceToBitmap
oderPreviewScreenshotParams
das Rendering mit der Standardvorschauzeit des Zifferblatts anfordert. (If7b3c) - Wir haben die UserStyleSetting-Konstruktoren entfernt, die CharSequence aus dem öffentlichen API übernehmen. Es wird empfohlen, die Konstruktoren zu verwenden, die stattdessen StringResource-IDs benötigen. (I8537b)
- In
CurrentUserStyleRepository.UserStyleChangeListener
wird jetzt die Umwandlung von Conversion-Daten in die Analysedaten unterstützt. (I85989)
Version 1.0.0-alpha19
4. August 2021
androidx.wear:wear-*:1.0.0-alpha19
wurde veröffentlicht. Version 1.0.0-alpha19 enthält diese Commits.
API-Änderungen
- Wir haben
ListenableWatchFaceMetadataClient.listenableCreateWatchFaceMetadataClient
hinzugefügt, das einenListenableFuture
-Wrapper fürWatchFaceMetadataClient.createWatchFaceMetadataClient
bereitstellt. (I5fa37) UserStyleOption.getOptionForId
akzeptiert jetztUserStyleOption.Id
anstelle eines Byte-Arrays. (I469be)- Die Konstanten
BooleanOption.TRUE
undBooleanOption.FALSE
angeben und das Erstellen von Instanzen nicht zulassen (I46e09) - Methoden in „wear-watchface-client“, die RemoteException auslösen können, wurden entsprechend annotiert. (Ib8438)
- Aus Konsistenzgründen haben wir
EditorSession.createOnWatchEditingSession
increateOnWatchEditorSession
umbenannt.createHeadlessEditingSession
ist jetzt ebenfallscreateHeadlessEditorSession
. Ihre Guava-Wrapper wurden ebenfalls umbenannt. (I1526b) EditorSession
ist jetzt eine Schnittstelle undListenableEditorSession.commitChangesOnClose
ist jetzt ordnungsgemäß delegiert. (I7dc3e)- Alle Nutzerstilschemas mit Einstellungen oder Optionen mit widersprüchlichen IDs werden jetzt abgelehnt (Ic2715).
- Wir haben eine überlastete
UserStyle.get
hinzugefügt, dieUserStyleSetting.Id
akzeptiert. (I2aa0f)
Version 1.0.0-alpha18
21. Juli 2021
androidx.wear:wear-*:1.0.0-alpha18
wurde veröffentlicht. Version 1.0.0-alpha18 enthält diese Commits.
API-Änderungen
- „
ComplicationHelperActivity
“ wurde in die Bibliothek „androidx.wear:wear-watchface
“ verschoben. (I39e76) - Aus Konsistenzgründen und zur Verdeutlichung wurde
ComplicationProvider
inComplicationDataSource
umbenannt. Alle Klassen mit „Provider“ in ihrem Namen wurden in ähnlicher Weise umbenannt. (Iaef0b) CanvasComplication.isHighlighted
wurde inRenderParameters.pressedComplicationSlotIds
verschoben. Dies ist ein Schritt auf dem Weg,CanvasComplication
zustandslos zu machen. Um diese Änderung zu unterstützen, verwendetCanvasComplication.render
jetzt auchslotId
als Parameter und übergebenComplicationSlot
anGlesTextureComplication
. (I50e6e)- Wir haben
headlessDeviceConfig
zuEditorRequest
hinzugefügt. Wenn dieser Parameter ungleich null ist, wird mit diesem Parameter eine monitorlose Instanz erstellt, um die EditorSession zu unterstützen, anstatt auf die interaktive Instanz zu reagieren. Dadurch kann der Editor für ein Zifferblatt aufgerufen werden, das nicht das aktuelle ist. (I0a820) - Wir haben eine experimentelle
WatchFaceMetadataClient
hinzugefügt, mit der statische Zifferblattmetadaten wie dieUserStyleSchema
und feste Details zuComplicationSlots
effizient abgerufen werden können. (I6bfdf) - Wir haben
CanvasRenderer.uiThreadInit
in „init“ umbenannt. (I6fff9) - Wir haben PreviewScreenshotParams einen optionalen neuen Parameter für EditorRequest hinzugefügt, der EditorSession anweist, beim Commit mit diesem Parameter einen Vorschau-Screenshot zu erstellen. Das Vorschaubild wird am
EditorState.previewImage
eingeblendet. (IC2c16)
Fehlerkorrekturen
- Entwickler müssen ihrem eigenen Manifest keine ComplicationHelperActivity mehr hinzufügen. (I6f0c2)
Version 1.0.0-alpha17
30. Juni 2021
androidx.wear:wear-*:1.0.0-alpha17
wurde veröffentlicht. Version 1.0.0-alpha17 enthält diese Commits.
Neue Funktionen
In
GlesRenderer
wurdenmakeUiThreadContextCurrent
undmakeBackgroundThreadContextCurrent
durchrunUiThreadGlCommands
undrunBackgroundThreadGlCommands
ersetzt, die beide eineRunnable
akzeptieren. Die Bibliothek sorgt dafür, dass immer nur ein ausführbarer GL-Befehl gleichzeitig ausgeführt wird.Um die Initialisierung von UiThread zu vereinfachen, haben wir
CanvasRenderer.uiThreadInit
hinzugefügt, die einmal auf dem UiThread aufgerufen wird, bevor Aufrufe zum Rendern erfolgen. Außerdem haben wironRendererCreated
zuCanvasComplication
hinzugefügt, damitRenderer
undCanvasComplication
ihren Status leichter teilen können.Zur Verdeutlichung haben wir
Complication
inComplicationSlot
undcomplicationId
je nach Nutzung incomplicationSlotId
odercomplicationInstanceId
umbenannt.
API-Änderungen
- Zur Verdeutlichung haben wir
Complication
inComplicationSlot
undcomplicationId
je nach Nutzung incomplicationSlotId
odercomplicationInstanceId
umbenannt. Klassen, die die Zusatzfunktion nutzen, wurden in ähnlicher Weise umbenannt, z.B. ComplicationsManager heißt jetzt ComplicationSlotsManager. (I4da44) - In GlesRenderer wurden
makeUiThreadContextCurrent
undmakeBackgroundThreadContextCurrent
durchrunUiThreadGlCommands
undrunBackgroundThreadGlCommands
ersetzt, die beide einRunnable
akzeptieren. Diese Funktionen sind nur erforderlich, wenn Sie GL-Aufrufe außerhalb des Renderings sowie vonrunBackgroundThreadGlCommands
undonUiThreadGlSurfaceCreated
ausführen müssen. Dies ist erforderlich, da es mehrere GlesRenderer mit jeweils eigenem Kontext im selben Prozess geben kann, möglicherweise von verschiedenen Zifferblättern. Zusätzlich wird der Zugriff auf den gemeinsamen aktuellen GL-Kontext jetzt synchronisiert. (I04d59) - Wir haben
CanvasRenderer.uiThreadInit
hinzugefügt, das einmal auf dem UiThread aufgerufen wird, bevor gerenderte Aufrufe erfolgen. Außerdem haben wironGlContextCreated
in GlesRenderer inonBackgroundThreadGlContextCreated
undonGlSurfaceCreated
inonUiThreadGlSurfaceCreated
umbenannt. (If86d0) HeadlessWatchFaceClient
&InteractiveWatchFaceClient
getComplicationsSlotState
wurde ingetComplicationSlotsState
umbenannt. InComplicationSlot
wurdencreateRoundRectComplicationBuilder
,createBackgroundComplicationBuilder
undcreateEdgeComplicationBuilder
increateRoundRectComplicationSlotBuilder
,createBackgroundComplicationSlotBuilder
undcreateEdgeComplicationSlotBuilder
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
wurde veröffentlicht. Version 1.0.0-alpha16 enthält diese Commits.
Neue Funktionen
- Wir haben eine Reihe von Fehlern im Zusammenhang mit den neuesten Änderungen am Threading-Modell sowie anderen Problemen mit dem Zifferblatt-Editor behoben.
Fehlerkorrekturen
- NPE in
onComplicationProviderChooserResult
verhindern (b/189594557) - Probleme mit veralteten Oberflächen unddrawBlack (b/189452267) beheben
- Fehler beim Zugriff auf
complicationsManager.watchState
(b/189457893) - Fehler bei der Lebensdauer von Hintergrundthreads beheben (b/189445428)
- Probleme mit dem Zifferblatt-Editor der Pre-R-Version beheben (b/189126313)
- Parameter für den direkten Start bei Stiländerungen im Editor nicht aktualisieren (b/187177307)
Version 1.0.0-alpha15
2. Juni 2021
androidx.wear:wear-*:1.0.0-alpha15
wurde veröffentlicht. Version 1.0.0-alpha15 enthält diese Commits.
Neue Funktionen
Der Großteil der Initialisierung des Zifferblatts erfolgt jetzt auf einem Hintergrundthread. Nach dem Laden des gesamten Zifferblatt-Renderings usw. erfolgt dies jedoch über den UiThread. Es gibt eine Speicherbarriere zwischen Laden und Rendern, sodass die meisten Zifferblätter für Nutzer keine speziellen Schritte ausführen müssen. Zifferblätter mit GLES sind möglicherweise eine Ausnahme, da der Kontext threadspezifisch ist und wir zwei verknüpfte Kontexte erstellen, sodass es möglich ist, GL-Ressourcen (z.B. Texturen und Shader) auf den Hintergrundthread hochzuladen und sie auf dem UiThread zu verwenden.
Wir haben die Konstruktion von Zifferblättern in drei Funktionen unterteilt: createUserStyleSchema, createComplicationsManager und createWatchFace. Wir gehen davon aus, dass createUserStyleSchema und createComplicationsManager schnell sind und createWatchFace das Laden von Assets einige Zeit in Anspruch nehmen kann. Dazu haben wir WatchFaceControlClient.getDefaultProviderPoliciesAndType
eingeführt, mit dem eine Zuordnung von ComplicationProvider-IDs zu DefaultComplicationProviderPolicies und dem standardmäßigen ComplicationType zurückgegeben wird. Dies ist schneller als das Erstellen einer monitorlosen Instanz, da das Zifferblatt nicht vollständig initialisiert werden muss, um die Abfrage durchzuführen.
Zu guter Letzt werden Zusatzfunktionen nun mit einer CanvasComplicationFactory erstellt, die eine Lazy-Konstruktion der CanvasComplication-Renderer ermöglicht.
API-Änderungen
- „
@TargetApi
“ wurde durch „@RequiresApi
“ ersetzt. (I0184a, b/187447093, b/187447094) - Wir haben
WatchFaceControlClient.getDefaultProviderPoliciesAndType
eingeführt, mit dem eine Zuordnung von Complication-IDs zu DefaultComplicationProviderPolicies und dem standardmäßigen ComplicationType zurückgegeben wird. Wenn möglich, wird ein schneller Pfad verwendet, bei dem kein Zifferblatt vollständig erstellt werden muss. Um dies zu vereinfachen, musste die WatchFaceService API durch zwei neue Methoden geändert werden: createUserStyleSchema und createComplicationsManager, deren Ergebnisse an createWatchFace übergeben werden. Darüber hinaus werden Zusatzfunktionen jetzt mit einer CanvasComplicationFactory erstellt, was das faszinierende Erstellen der CanvasComplication-Renderer ermöglicht. (Iad6c1) - Wir haben most_neuere_APP aus SystemProviders entfernt. (I3df00)
- ObservableWatchData ist jetzt eine versiegelte Klasse. (IC940d)
- CanvasComplicationFactory.create (die normalerweise io-gebunden ist) wird jetzt für jede Zusatzfunktion in einem Hintergrundthread aufgerufen, bevor das UI-Thread-Rendering beginnt. Es gibt eine Speicherbarriere zwischen Erstellung und Rendering, sodass keine speziellen Threading-Primitive erforderlich sind. (Ia18f2)
- Das Zifferblatt wird jetzt in einem Hintergrundthread erstellt, obwohl das gesamte Rendering im UI-Thread erfolgt. GlesRenderer unterstützt zu diesem Zweck zwei verknüpfte Kontexte. WatchFaceControlClient.createHeadlessWatchFaceClient und WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient werden möglicherweise aufgelöst, 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 in der Datei api.txt nicht mehr sichtbar. (I54801)
- Es wurde festgelegt, dass „EditorSession.createOnWatchEditingSession“ eine TimeoutCancelException auslöst, wenn statt einer Nullsitzung ein Fehler auftritt. 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
wurde veröffentlicht. Version 1.0.0-alpha14 enthält diese Commits.
Neue Funktionen
EditorSession.openComplicationProviderChooser
gibt jetzt ChosenComplicationProvider zurück, das die Zusatzfunktions-IDComplicationProviderInfo
sowie ein Bundle mit allen zusätzlichen Extras enthält, die von der Anbieterauswahl zurückgegeben werden.- Darüber hinaus migrieren wir kontinuierlich Code zu Kotlin und der Großteil der Watch Face API ist jetzt in Kotlin definiert.
API-Änderungen
- Die GlesRenderer-Eigenschaften
eglContext
undeglDisplay
können jetzt nicht als Nullwerte festgelegt werden. Alle GL-Fehler werden jetzt überGlesRenderer.GlesException
statt über RuntimeExceptions gemeldet. (Ib1005) androidx.wear.watchface.complications.rendering.ComplicationDrawable
wurde von Java zu Kotlin migriert (Ibc3eb).androidx.wear.watchface.complications.rendering.ComplicationStyle
wurde von Java zu Kotlin migriert (I3375e).- Wir haben für jede Zusatzfunktion in EditorSession Informationen zum Anbieter für Zusatzfunktionen hinzugefügt. (I37f14)
- Wir haben das Ergebnis von
EditorSession.openComplicationProviderChooser
um Informationen erweitert, die von den ausgewählten zurückgegeben wurden. (Iead6d)
Zusatzfunktionen und Zifferblatt Version 1.0.0-alpha13
5. Mai 2021
androidx.wear:wear-*:1.0.0-alpha13
wurde 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 zu bieten, kann das Zifferblatt jetzt ContentDescriptionLabels als Bedienungshilfen über die Eigenschaft "additionalContentDescriptionLabels" des Renderers angeben. Um die Reihenfolge von ContentDescriptionLabels zu steuern, wurde das barrierefreie TraversalIndex-Element zu den Komplikationen hinzugefügt. Dies kann durch eine ComplicationsUserStyleSetting geändert werden.
Um Entwickler zu ermutigen, Screenreader sorgfältig zu prüfen, haben wir festgelegt, dass die Felder
contentDescription
vonShortTextComplicationData.Builder
,LongTextComplicationData.Builder
undRangedValueComplicationData.Builder
an ihre Konstruktoren übergeben werden müssen. WennComplicationText.EMPTY
fürcontentDescription
übergeben wird, wird automatisch eincontentDescription
aus dem Text und dem Titel generiert.WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient
gibt jetztServiceStartFailureException
aus, wenn das Zifferblatt während der Initialisierung eine Ausnahme auslöst. Dadurch lassen sich Probleme beim Start des Zifferblatts viel einfacher diagnostizieren.
API-Änderungen
- Wir haben die Möglichkeit hinzugefügt, dass in ComplicationProviderInfo ein Null-Komponentenname angegeben werden kann. Dies ist erforderlich, um ältere Versionen von Wear OS zu unterstützen. (I744d2)
- Wir haben
androidx.wear.complications.SystemProviders
von Java zu Kotlin migriert. (Ia1f8b) - Wir haben alle Klassen aus der öffentlichen API ausgeblendet, die sich in android.support.wearable.complications erstellt und entsprechende ggf. Wrapper in AndroidX zu verwenden. (I7bd50)
- Wir haben die Methode in
TimeDifferenceComplicationText.Builder
vonsetMinimumUnit
bissetMinimalTimeUnit
(I20c64) - Wir haben
ShortTextComplicationData.Builder
und vonLongTextComplicationData.Builder
contentDescription
vonRangedValueComplicationData.Builder
Feld, das im Konstruktor übergeben werden muss. (I8cb69) - Wir haben "ComplicationProviderService.onComplicationUpdate" in "onComplicationRequest" umbenannt und gekapselten ID- und Typparameter dieser Methode in data ComplicationRequest. Der entsprechende Listener wurde in ComplicationRequestListener und die zugehörige Methode ComplicationRequestListener.onComplicationData umbenannt. (Iaf146)
- Wir haben die Methode
isActiveAt
ausComplicationData
undvalidTimeRange
. Dieses Methodenaufruf kann durchvalidTimeRange.contains
ersetzt werden. (I65936) - Die Beschreibung der Methode wurde geändert. ComplicationProviderService.onComplicationEnabledd zum Empfangen einer ComplicationType anstelle einer Ganzzahl. (Idb5ff)
- ProviderUpdateRequester wurde von Java nach Koltin migriert. (Ibce13)
- GlesRender.makeContextCurrent ist jetzt öffentlich. Der Zifferblattcode muss möglicherweise gl-Aufrufe außerhalb des Renderings und von onGlContextCreated ausführen. Da es sowohl einen interaktiven als auch einen monitorlosen Kontext geben kann, ist dies erforderlich. (I8a43c)
- WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient löst jetzt ServiceStartFailureException aus, wenn das Zifferblatt während der Initialisierung ausgelöst wird. 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) - Auf dem Zifferblatt kann jetzt über die Property „additionalContentDescriptionLabels“ von
Renderer
ContentDescriptionLabels als Bedienungshilfen angegeben werden. Zusätzlich zur Steuerung der Sortierung von ContentDescriptionLabels „AccessibilityTraversalIndex“ wurde zu den Komplikationen hinzugefügt. Dies kann durch eine ComplicationsUserStyleSetting geändert werden. (Ib7362) - Dokumentation zur Verarbeitung von Touch-Ereignissen auf dem Zifferblatt maximieren. (Iaf31e)
Fehlerkorrekturen
EditorSession.getComplicationsPreviewData()
gibt jetzt eine Karte für alle eher nicht leeren Zusatzfunktionen zurück. Für leere Zusatzfunktionen wird eine Instanz von EmptyComplicationData verwendet. (I1ef7e)
Zusatzfunktionen und Zifferblatt Version 1.0.0-alpha12
21. April 2021
androidx.wear:wear-*:1.0.0-alpha12
wurde veröffentlicht. Version 1.0.0-alpha12 enthält diese Commits.
Neue Funktionen
Zifferblatt-Editoren müssen Teile des Zifferblatts hervorheben, um zu erkennen, welcher Aspekt einer Uhr konfiguriert wird. Wir haben RenderParameters erweitert, damit Stile und Zusatzfunktionen hervorgehoben werden können. Es gibt einen neuen optionalen HighlightLayer, der mit Alpha-Transparenz auf dem Zifferblatt mattiert werden soll (die Screenshot-APIs können diese Maskierung für dich übernehmen oder den HighlightLayer selbst bereitstellen, um maximale Flexibilität zu erreichen). Beispiel: Angenommen, du hättest einen Stil, mit dem du das Aussehen der Uhr-Zeiger konfigurieren kannst, und der Renderer kann in seinem renderHighlightLayer einen Umriss um sie zeichnen.
Um die Unterstützung des Complication Providers für die Barrierefreiheit zu fördern, haben wir PhotoImageComplicationData.Builder's, MonochromaticImageComplicationData.Builder und Das contentDescription-Feld von SmallImageComplicationData.Builder muss ein obligatorisches Konstruktorargument sein. Zur Unterstützung von Komplikationen am Rand (um den Bildschirmrand gezeichnet) wurden ComplicationTapFilter und Complication.createEdgeComplicationBuilder hinzugefügt. Das Rendern und Treffertests von Edge-Zusatzfunktionen bleiben im Zifferblatt. Edge-Treffertests werden im Companion-Editor nicht unterstützt.
API-Änderungen
- Präfix
PROVIDER_
zu Konstanten in SystemProviders hinzugefügt. (I1e773) - Wir haben
PhotoImageComplicationData.Builder
und vonMonochromaticImageComplicationData.Builder
Das FeldcontentDescription
vonSmallImageComplicationData.Builder
ist für Folgendes obligatorisch: im Konstruktor übergeben werden. (I9643a) ProviderInfoRetriever.requestPreviewComplicationData
wurde inretrievePreviewComplicationData
umbenannt. (I911ee)ComplicationProviderService
wurde von Java zu Koltin migriert. (I849f2)- Methode
ComplicationProviderService.onBind
ist jetzt endgültig (I39af5) - Wir haben die Schnittstelle
CanvasComplication
reaktiviert undCanvasComplicaitonDrawable
,GlesTextureComplication
undComplicationHighlightRenderer
zuwear-watchface-complications-rendering
verschoben. (I84670) RenderParameters
wurde refaktoriert, um das erweiterte Hervorhebungs-Rendering zu unterstützen. Es ist jetzt möglich, das Rendern von Hervorhebungen für Stile sowie für alle oder eine einzelne Zusatzfunktion anzufordern. Zusätzlich verfügen CanvasRenderer und GlesRenderer über eine neue abstrakte renderHighlightLayer -Methode, mit der vom Editor angeforderte Hervorhebungen gerendert werden können. Die Ebene wurde in „WatchFaceLayer“ umbenannt. (IC2444)ComplicationTapFilter
undComplication.createEdgeComplicationBuilder
unterstützen jetzt Edge-Zusatzfunktionen. Das Rendern und Treffertests von Edge-Zusatzfunktionen bleiben im Zifferblatt. Treffertests werden in Editoren nicht unterstützt. (Ia6604)- Für
DoubleRangeUserStyleSetting
undLongRangeUserStyleSetting
:defaultValue
,maximumValue
undminimumValue
sind jetzt Kotlin-Properties. Außerdem wurdenUserStyleSetting.Option
-Funktionen wie toBooleanOption, toCoplicationOptions, toListOption und Ähnliches 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 die ParameteroutlineExpansion
undoutlineStrokeWidth
. (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
wurde veröffentlicht. Version 1.0.0-alpha11 enthält diese Commits.
Neue Funktionen
- Die Zifferblatt-APIs wurden optimiert. Bei den meisten Änderungen handelt es sich um einfache Umbenennungen.
InteractiveWatchFaceWcsClient
undInteractiveWatchFaceSysUiClient
wurden jedoch inInteractiveWatchFaceClient
zusammengeführt.
API-Änderungen
- ContentDescriptionLabel.text ist jetzt ein ComplicationText und nicht die alte Wearable-Supportbibliothek TimeDependentText. (I80c03)
- Es kann nicht garantiert werden, dass
SystemProviders.GOOGLE_PAY
auf allen Android R-Geräten vorhanden ist. Deshalb wurde es aus der Liste entfernt. Sie können diesen Anbieter weiterhin überDefaultComplicationProviderPolicy
verwenden (If01b5) - Aus Konsistenzgründen haben wir ComplicationUpdateCallback in ComplicationUpdateListener umbenannt. (I61ec7)
- Die UserStyle-Zuordnung des Wire-Formats wurde in
Map<String, byte[]>
geändert. Der öffentlichen API wurde die KlasseUserStyleData
hinzugefügt, die jetzt von wear-watchface-client und wear-watchface-editor verwendet wird. Außerdem ist „CustomValueUserStyleSetting.CustomValueOption.value“ jetztbyte[]
anstelle vonString
. (Iaa103) UserStyleSetting
undUserStyleSetting.Option
verwenden jetztUserStyleSetting.Id
bzw.UserStyleSetting.Option.Id
, um ihre IDs anstelle eines Strings zu speichern. (I63f72)InteractiveWatchFaceClient.SystemState
wurde inWatchUiState
umbenannt. (I6a4e0)InteractiveWatchFaceWcsClient
undInteractiveWatchFaceSysUiClient
wurden zusammengeführt, da die Aufteilung der Zuständigkeit schwer zu erklären war (Iff3fa)- Die enum-Werte der Ebene wurden zur Verdeutlichung umbenannt.
Layer#TOP_LAYER
ist jetztLayer#COMPLICATIONS_OVERLAY
undLayer#BASE_LAYER
ist jetztLayer#BASE
(Ia144e) UserStyleListener
wurde inUserStyleChangeListener
umbenannt (I18524).UserStyleRepository
wurde inCurrentUserStyleRepository
umbenannt (I6ea53).InteractiveWatchFaceWcsClient.updateInstance
wurde inupdateWatchfaceInstance
umbenannt. (I321dc)- TapType-Ereignisse auf dem Zifferblatt wurden umbenannt, um sie an MotionEvents / Compose anzupassen. (I0dfd0)
- TakeWatchfaceScreenshot wurde in renderWatchFaceToBitmap und TakeComplicationScreenshot in renderComplicationToBitmap (Ie0697) umbenannt.
- Die CanvasComplication-Oberfläche wurde zugunsten der offenen Klasse CanvasComplicationDrawable entfernt. (I1f81f)
WatcfaceControlServiceFactory
wurde aus der öffentlichen API entfernt. (I1f8d3)- Wir haben
CanvasComplication.setData
inCanvasComplication.loadData
umbenannt. (Wenn1239) ComplicationsManager.bringAttentionToComplication
wurde indisplayPressedAnimation
umbenannt. (IC4297)WatchFaceService.createWatchFace
hat jetzt eine@UiThread
-Anmerkung. (Ib54c2)- Der Name eines CanvasComplicationDrawable-Parameters wurde geändert, um einen Fehler zu beheben. (I50dac)
- Wir haben
HeadlessWatchFaceClient.toBundle()
undHeadlessWatchFaceClient.createFromBundle
hinzugefügt, um das Senden vonHeadlessWatchFaceClient
über AIDL zu unterstützen. (I07c35) - HeadlessWatchFaceClient und InteractiveWatchFaceClient verfügen jetzt über „ClientUnsubscribeListener“ und „isConnectionAlive()“, damit Sie feststellen können, ob die Verbindung aus irgendeinem Grund unterbrochen wurde (z.B. weil das Zifferblatt unterbrochen wird). (IE446d)
WatchFaceControlClient#getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClientAsync
ist jetzt eine Sperrfunktion und wurde ingetOrCreateInteractiveWatchFaceClient
umbenannt. (Ib745d)EditorState.commitChanges
undhasCommitChanges()
wurden inshouldCommitChanges()
umbenannt. (I06e04)previewComplicationData
wurde inpreviewComplicationsData
umbenannt, um anzuzeigen, dass es auf der Karte (normalerweise) mehr als eine Zusatzfunktion gibt. (I56c06)InteractiveWatchFaceWcsClient.bringAttentionToComplication
wurde aus Konsistenz mitComplicationsManager.displayPressedAnimation
indisplayPressedAnimation
umbenannt. (IC9999)- Alle Instanzen der Zifferblatt-Instanz-ID wurden in einer neuen WatchFaceId-Klasse zusammengefasst (I45fdf).
- Die Property
complicationState
wurde incomplicationsState
umbenannt, um die Pluralität anzuzeigen. (Ided07) - Wir haben die verschiedenen Konvertierungen für Wear-Watchface-Client-Binder entfernt, da sie erforderlich sein sollten. (Icc4c0)
- Aus Konsistenzgründen wurde
EditorServiceClient
so umgestaltet, dass Listener anstelle von Beobachtern verwendet werden. (Iec3a4) - Wir haben einige fehlende
@Px
-Annotationen zuInteractiveWatchFaceSysUiClient
undWatchFaceControlClient
hinzugefügt. (I3277a) - EditorObserverCallback wurde aus Konsistenzgründen in EditorObserverListener umbenannt. (IE572d)
- EditorState.watchFaceInstanceId ist auf das Android R-API-Level und höher beschränkt und kann nicht mehr als Nullwert ausgegeben werden. (Id52bb)
EditorSession.launchComplicationProviderChooser
wurde inopenComplicationProviderChooser
umbenannt. (I9d441)EditorSession.createOnWatchEditingSessionAsync
wurde increateOnWatchEditingSession
umbenannt und ist jetzt eine Sperrfunktion. (ID257b)- Mehrere fehlende
@UiThread
-Anmerkungen zuEditorSession
hinzugefügt. (I6935c) UserStyleSetting.affectsLayers
wurde inaffectedLayers
umbenannt. (I6e22b)
Version 1.0.0-alpha10
24. März 2021
androidx.wear:wear-*:1.0.0-alpha10
wurde veröffentlicht. Version 1.0.0-alpha10 enthält diese Commits.
Neue Funktionen
- Es ist jetzt möglich, während WatchFaceService.createWatchFace offene gl-Objekte (z. B.Texturen) zu erstellen, da GlesRenderer jetzt einen expliziten Aufruf von initOpenGLContext erfordert, der innerhalb von createWatchFace erfolgen kann.
API-Änderungen
IdAndComplicationData
war etwas umständlich und wurde aus der öffentlichen API entfernt. Kurse und Benutzeroberflächen refaktoriert wurden. (I4c928)- Wir haben
ReferenceTime
durchCountUpTimeReference
undCountDownTimeReference
ersetzt. Diese sind selbsterklärender. (Ib66c6) - Einige fehlende
@Px
- und@ColorInt
-Annotationen wurden hinzugefügt. (I9bbc3) Complication.complicationConfigExtras
kann jetzt nicht mit Nullwerten gelöscht werden und ist standardmäßig aufBundle.EMPTY
gesetzt. (Iad04f)GlesRenderer
erfordert jetzt, dass Sie nach der ErstellunginitOpenGLContext
aufrufen. Diese Funktion war ein internes Detail, befindet sich aber jetzt in der öffentlichen API, um früher GL-Aufrufe innerhalb von createWatchFace zu ermöglichen. (I726c2)Complication.setRenderer
wurde entfernt, da dies nicht mehr erforderlich sein sollte. (Ie992f)Complicaiton.setComplicationBounds
gehört nicht mehr zur öffentlichen API. Die Position einer Zusatzfunktion lässt sich überComplicationsUserStyleSetting
anpassen. (Ibd9e5)ComplicationsManager.TapCallback.onComplicationSingleTapped
wurde inonComplicationTapped
umbenannt. (I3a55c)ComplicationOutlineRenderer.drawComplicationSelectOutline
wurde indrawComplicationOutline
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
wurden veröffentlicht. Version 1.0.0-alpha09 enthält diese Commits.
Neue Funktionen
- Die Schnittstelle zwischen dem WCS/SysUI-Host und dem Zifferblatt hat sich weiterentwickelt. Ein Editor kann jetzt feststellen, ob durch eine Stiländerung eine Zusatzfunktion aktiviert oder deaktiviert wird (aktiviert = initialEnabled plus Überschreibung aus ComplicationsUserStyleSetting).
EditorService.closeEditor
erlaubt SysUI außerdem, bei Bedarf einen Zifferblatt-Editor aus der Ferne zu schließen. - Zusätzlich
InteractiveWatchFaceWcsClient.setUserStyle
mit dem leistungsstärkerenupdateInstance
-Befehl, mit dem gleichzeitig die Instanz-ID geändert, der Stil festgelegt und Zusatzfunktionen entfernt werden können.
API-Änderungen
- TraceEvents wurden den Zifferblattbibliotheken hinzugefügt. (I1a141)
ComplicationState
hat jetzt die neue EigenschaftinitiallyEnabled
, die nützlich ist, um die Folgen eines Stilwechsels vorherzusehen. (I8c905)- Wir haben
InteractiveWatchFaceWcsClient.setUserStyle
durch den leistungsstärkeren BefehlupdateInstance
ersetzt, mit dem Sie die Instanz-ID ändern, den Stil festlegen und Zusatzfunktionen entfernen können. (Ife6f6) - Die Screenshot-APIs von WatchFaceClient werden nicht mehr komprimiert, da dies langsam war. Stattdessen überlassen wir die Nachbearbeitung dem Aufrufer. (Id35af)
- Es ist jetzt möglich, einen Zifferblatt-Editor aus der Ferne über
EditorService.closeEditor
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
wurde veröffentlicht. Version 1.0.0-alpha08 enthält diese Commits.
Neue Funktionen
- Einige Zifferblätter haben eine oder mehrere Zusatzfunktionen. Zu diesem Zweck haben wir "Complication.Builder#setFixedComplicationProvider" hinzugefügt, die verhindert, dass der Nutzer die Zusatzfunktion in diesem Slot ändert, wenn er auf "true" gesetzt ist.
- Die Zifferblattbibliotheken sind zuerst Kotlin und verwenden Koroutinen (z.B. Sperren). 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 & wear/wear-watchface-editor-guava.
API-Änderungen
- Wir haben die Unterstützung für doppelte Antippen von Zusatzfunktionen entfernt, die die Anbieterauswahl starten. Diese Funktion war bei Zifferblättern nicht üblich und die Implementierung von SysUI wurde kompliziert. (I3ef24)
- ProviderInfoRetriever-Methoden können „ServiceBreakedException“ auslösen, wenn der Binder unerwartet geschlossen wird. (Ib2cc4)
- Ab Android 11 gibt es Einschränkungen dafür, wann der ProviderChooser ausgeführt werden kann. Außerdem sollen Editoren mit dem neuen
wear-watchface-editor
erstellt werden, daher wird ComplicationHelperActivity aus der öffentlichen API entfernt. (Ib19c1) - Statische ComplicationText-Methoden zugunsten von Buildern entfernt. (Ibe399)
- Wir haben den Guave ListenableFuture-Wrapper für die verschiedenen Methoden zum Sperren der Zifferblattbibliothek eingeführt. (I16b2c)
- Zur Verdeutlichung der API haben wir RenderParameters einen sekundären Konstruktor hinzugefügt, der für die Verwendung mit anderen LayerModes als
LayerMode.DRAW_OUTLINED
keine Färbung erfordert. (I497ea) - Zuvor unterscheidet sich „ListUserStyleSetting“ von der anderen, da es ein Standardargument hatte. Jetzt übernehmen alle StyleSetting-Unterklassenkonstruktoren zuletzt den Standardwert. (I9dbfd)
- CanvasComplication wurde refaktoriert, sodass eine versteckte Methode verwendet wird, was die Implementierung einer Unterklasse vereinfacht (I5b321).
- „EditorResult“ wurde durch einen neuen EditorService und
EditorSession.broadcastState()
ersetzt, um Aktualisierungen an einen Beobachter (in der Regel SysUI) zu streamen. (IC4370) - Einige Zifferblätter sind um eine bestimmte Zusatzfunktion als integraler Bestandteil des Zifferblatts aufgebaut, für die der Anbieter nicht vom Nutzer konfiguriert werden kann. Um dies zu unterstützen, haben wir
Complication.Builder#setFixedComplicationProvider
hinzugefügt. (I4509e) - EditorRequest gibt jetzt den Paketnamen anstelle von ComponentName an, da es für SysUI umständlich war, den Klassennamen des Editors zu ermitteln, und wir nur den Paketnamen benötigen. (Ib6814)
Version 1.0.0-alpha07
10. Februar 2021
androidx.wear:wear-*:1.0.0-alpha07
wurde veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.
Neue Funktionen
- WatchFaceService.createWatchFace ist jetzt eine Sperrfunktion. Das bedeutet, dass das Zifferblatt den UI-Thread nicht mehr blockieren muss, während auf den E/A-Vorgang gewartet wird. Entsprechend Daten zu Wear-Watchface-Editor und Wear-Zusatzfunktionen
API-Änderungen
- Die PhotoImage-Klasse entfernen und Icon direkt verwenden. (I8a70b)
- Machen Sie den „validTimeRange“ von ComplicationData verfügbar. (I91366)
- Bildähnliche Attribute expliziter machen. (I81700)
- Die Daten für Wear-watchface-Editor und Wear-Complications wurden so umgestaltet, dass anstelle von gemeinsamen Routinen Sperren verwendet werden. Rx Java und Zukünftige COMPAT-Wrapper folgen. (If3c5f)
- ProviderInfoRetriever gibt jetzt eine Ausnahme vom Typ „PreviewNotAvailableException“ aus, wenn „requestPreviewComplicationData“ aufgrund von Verbindungsproblemen oder fehlender API-Unterstützung keine Vorschaudaten zurückgeben kann. (I4964d)
- WatchFaceControlService::createWatchFaceControlClient ist jetzt eine ausgesetzte Funktion und getOrCreateHintergrundServiceBackedInteractiveWatchFaceWcsClient heißt jetzt getOrCreateBackgroundServiceBackedInteractiveWatchFaceWcsClientAsync und gibt
Deferred<InteractiveWatchFaceWcsClient>
zurück. RX-Java- und Future-Compat-Wrapper. (I5d461) - Benennen Sie
CATEGORY_PROVIDER_CONFIG_ACTION
inCATEGORY_PROVIDER_CONFIG
um. (I7c068) - Bitte beachten Sie, dass createOnWatchEditingSession jetzt eine angehaltene Funktion ist, da das Zifferblatt manchmal erst kurz nach Beginn der Editor-Aktivität verfügbar ist. (Ida9aa)
- WatchFaceService.createWatchFace ist jetzt eine Beendigungsfunktion, die eine asynchrone Initialisierung ermöglicht. Bisher mussten Sie den Hauptthread blockieren. (If076a)
- UserStyle verfügt nun über einen Array-Operator und wir haben Umwandlungshilfen zu UserStyle.Option hinzugefügt. (I35036)
- Wir haben einen Marshalling-Fehler bei UserStyle-Wirkformaten behoben, bei dem einige der instabilen verborgenen APIs geändert wurden. (I8be09)
- Mithilfe von CustomValueUserStyleSetting können Sie eine einzelne anwendungsspezifische Zeichenfolge in einem UserStyle speichern. Die standardmäßigen Zifferblatteditoren ignorieren diesen Wert. (IC04d2)
- InstanceID wird nicht in den Intent-Extras für R und ältere Versionen von Android Wear OS übergeben, die nicht aktualisiert werden können. Um dies zu unterstützen, können wir jetzt zulassen, dass InstancID null ist. (Id8b78)
- „EditorRequest“ enthält jetzt den Editor ComponentName, der als Komponente in WatchFaceEditorContract.createIntent (I3cd06) festgelegt ist.
- Das Zifferblatt „EditorResult“ enthält jetzt „ComplicationData“ in der Vorschau, damit der Anrufer nach der Bearbeitung einen Screenshot des Zifferblatts aufnehmen kann. (I2c561)
Fehlerkorrekturen
- Es wurden toString()-Überschreibungen zu UserStyle, UserStyleSetting und UserStyleSchema hinzugefügt, was die Arbeit mit diesen Klassen etwas verbessert. (I9f5ec)
Version 1.0.0-alpha06
27. Januar 2021
androidx.wear:wear-*:1.0.0-alpha06
wurde veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.
Neue Funktionen
- Wir haben einen neuen Editor für Wear/Wear-Zifferblätter eingeführt, mit dem Zifferblattentwickler und potenziell OEMs einen Editor für Stile und Zusatzfunktionen erstellen können. SysUI sendet einen Intent an das Zifferblatt, das die neue EditorSession-Klasse verwendet, um auf WatchFace-Details zuzugreifen und das Ergebnis über Activity.setWatchRequestResult aufzuzeichnen. Dazu haben wir ProviderInfoRetriever.requestPreviewComplicationData hinzugefügt, mit der Zifferblatt-Editoren „ComplicationData“ in der Vorschau anfordern können. Der Vorteil der Vorschau von ComplicationData im Gegensatz zu Live-Daten ist, dass Sie beim Rendern Ihres Editors keine Berechtigungsdialogfelder anzeigen müssen. Wenn ein Nutzer einen Anbieter mit einer Berechtigung auswählt, wird er weiterhin aufgefordert, die Berechtigung zu erteilen.
API-Änderungen
- ComplicationProviderInfo verfügt jetzt über ein Feld für den ComponentName des Anbieters. Dieses Feld wird zu WearOS zu einem späteren Zeitpunkt unterstützt und ist in der Zwischenzeit null. (Id8fc4)
- Wir haben „ProviderInfoRetriever.requestPreviewComplicationData“ hinzugefügt, mit dem Zifferblatteditoren eine Vorschau von ComplicationData abrufen können. Das ist hilfreich, weil für Live-Zusatzfunktionen möglicherweise Berechtigungen erforderlich sind und Sie jetzt Vorschaudaten für nicht aktive Zusatzfunktionen anzeigen können. (I2e1df)
- ComplicationManager ist jetzt ein optionaler Parameter des WatchFace-Konstruktors. Die Argumente wurden neu angeordnet, um dies zu ermöglichen. (I66c76)
- Wir haben den Zusatzfunktionen ein optionales Bundle hinzugefügt, das beim Festlegen mit dem Intent zusammengeführt wird, der zum Starten der Anbieterauswahlaktivität gesendet wird. (Ifd4ad)
- Wir haben eine neue
wear-watchface-editor
-Mediathek hinzugefügt, die auf Zifferblättern und von SysUi gehosteten Editoren unterstützt wird. SysUI startet diese Editoren durch Senden eines Intents. Der Dienst für Zifferblattaktivitäten kann die neue EditorSession-Klasse verwenden, um auf WatchFace-Details zuzugreifen und das Ergebnis über Activity.setWatchRequestResult aufzuzeichnen. (I2110d) - „LayerMode.DRAW_HIGHLIGHTED“ heißt jetzt „LayerMode.DRAW_OUTLINED“ und „RenderParameters.highlightComplicationId“ heißt jetzt RenderParameters.selectedComplicationId. Damit wird zusätzlich zur Kontur eine Markierung für die angegebene Zusatzfunktion gezeichnet. (I90a40)
- WatchFaceControlClient.getOrCreateBackgroundServiceBackedInteractiveWatchFaceWcsClient kann jetzt mit einer ServiceStartFailureException behoben werden, wenn der Dienst während des Wartens auf die Erstellung des Zifferblatts abstürzt. (I0f509)
- EditorSession.complicationPreviewData ist jetzt ein ListenableFuture, da das Abrufen dieser Daten ein asynchroner Prozess ist. (Iead9d)
Fehlerkorrekturen
- Wir entfernen nicht verwendete Felder aus „ComplicationOverlay“ und behalten dabei „Aktiviert“ und „complicationBounds“ bei. (I17b71)
Version 1.0.0-alpha05
13. Januar 2021
androidx.wear:wear-*:1.0.0-alpha05
wurde veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.
Neue Funktionen
Zifferblätter unterstützen oft eine Reihe von Zusatzfunktionen, die unterschiedlich oft angezeigt werden. Zur einfacheren Einrichtung unterstützen wir jetzt anfangs deaktivierte Zusatzfunktionen durch den Aufruf von setEnabled(false) im Builder. Diese können später über ComplicationsUserStyleSetting aktiviert werden.
API-Änderungen
- ComplicationHelperActivity akzeptiert jetzt
Collection<ComplicationType>
anstelle eines int-Arrays, um die Verwendung zu vereinfachen. (I1f13d) ProviderInfoRetriever.retrieveProviderInfo
gibt jetzt korrektListenableFuture<ProviderInfo[]>
zurück. (If2710)- Sie können jetzt eine anfangs deaktivierte Zusatzfunktion erstellen, indem Sie im Builder „setEnabled(false)“ aufrufen. (Idaa53)
- WatchFaceState hat jetzt die Eigenschaft isHeadless, die nur für monitorlose Instanzen gilt. (Ifa900)
- ComplicationDrawable unterstützt jetzt optional das synchrone Laden von Drawables. Sie wird von den Screenshot-APIs verwendet. (I34d4a)
Version 1.0.0-alpha04
16. Dezember 2020
androidx.wear:wear-*:1.0.0-alpha04
wurde veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.
Neue Funktionen
- Die Wear-Zifferblattbibliothek unterstützt jetzt das Festlegen von Grenzen pro Typ. Beispiel: können Sie zu einem breiten Begrenzungsrahmen für ComplicationType.LONG_TEXT wechseln, während Sie für andere Typen einen kleineren Begrenzungsrahmen verwenden.
API-Änderungen
- Für Zusatzfunktionen wird jetzt "ComplicationBounds" verwendet, die ein
Map<ComplicationType, RectF>
umschließt, um die Größen der Zusatzfunktionen zu unterstützen. (I1ebe7) - Mit RenderParameters können Sie jetzt die Hervorhebungsfarbe für Screenshots angeben. (Iff42b)
- Mit Ausnahme der Grenzen müssen Sie jetzt ComplicationsUserStyleSetting zum Ändern von Zusatzfunktionen verwenden, um sicherzustellen, dass das Betriebssystem synchronisiert wird. (I8dc5d)
- Renderer ist jetzt eine versiegelte Klasse. Das bedeutet, dass CanvasRenderer und GlesRenderer jetzt innere Renderer-Klassen sind. (Iab5d4, b/173803230)
- „CanvasComplicationDrawable.drawHighlight“ wurde in „drawOutline“ umbenannt. ObservableWatchData hat jetzt einige fehlende UiThread-Annotationen. ScreenState wurde vollständig aus WatchState entfernt. (Wenn1393)
- Das Mindest-API-Level für Wear-Zifferblätter ist jetzt 25. Für die Hardware-Canvas-Unterstützung ist API-Level 26 oder höher erforderlich. (IC9bbd)
- InteractiveWatchFaceWcsClient verfügt jetzt über einen getComplicationIdAt-Hilfsprogramm. (I05811)
- Das API-Level für Wear-watchface-client wurde auf 25 reduziert, für die Screenshot-APIs ist jedoch das API-Level 27 erforderlich. (Id31c2)
Fehlerkorrekturen
- Wir zeigen nun den aktuellen ComplicationData-Typ der Zusatzfunktion unter "ComplicationState" an. (I9b390)
- InteractiveWatchFaceWcs verfügt jetzt über die Methode „bringAttentionToComplication“, mit der die angegebene Zusatzfunktion kurz hervorgehoben wird. (I6d31c)
InteractiveWatchFaceWcsClient#setUserStyle
hat jetzt eine Überlastung, die Map<string, string=""> akzeptiert was potenziell einen zusätzlichen IPC-Umlauf vermeiden kann, der für die Erstellung von UserStyle erforderlich ist. (I24eec)</string,>
Version 1.0.0-alpha03
2. Dezember 2020
androidx.wear:wear-*:1.0.0-alpha03
wurde veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.
Neue Funktionen
Die Complication-Klasse verfügt jetzt über eine compicationData-Eigenschaft, mit der auf Zifferblättern Änderungen an ComplicationData beobachtet werden können. Dadurch können die Abmessungen der Zusatzfunktion je nach Art der Zusatzfunktion geändert werden.
Variable Framerates werden jetzt durch Zuweisen zu „Renderer.interactiveDrawModeUpdateDelayMillis“ unterstützt. Bei Zifferblättern, auf denen jede Sekunde kurze Animationen abgespielt werden, kann dies zu erheblichen Energieeinsparungen führen, da das Gerät ohne Animation in den Ruhemodus wechselt.
API-Änderungen
- „
BACKGROUND_IMAGE
“ wurde zusammen mit den zugehörigen Kursen in „PHOTO_IMAGE
“ umbenannt. Diese Zusatzfunktion wird nicht nur für den Hintergrund verwendet, daher wurde der Name geändert. (I995c6) - DefaultComplicationProviderPolicy, die korrekt mit IntDefs annotiert ist. (I3b431)
- Die ausgeblendete TimeDependentText-Klasse wird nicht mehr über ContentDescriptionLabel offengelegt. Stattdessen fügen wir eine Zugriffsfunktion hinzu, um den Text zu einem bestimmten Zeitpunkt abzurufen. (Ica692)
- Der Konstruktor von ObservableWatchData ist jetzt intern. (I30121, b/173802666)
- Die Zusatzfunktion verfügt jetzt über „compicationData“, mit der Zifferblätter die Veränderungen von ComplicationData beobachten können. Die Zusatzfunktion verfügt außerdem über einen neuen isActiveAt-Aufruf, mit dem ermittelt werden kann, ob zum angegebenen Datum und der Uhrzeit etwas gerendert werden soll. (Ic0e2a)
- Das leere
SharedMemoryImage
befindet sich nicht mehr in der öffentlichen API. (I7ee17) WatchFace.overridePreviewReferenceTimeMillis
hat jetzt eine IntRange-Annotation und der Getter und Setter haben einheitliche Namen. (Ia5f78)Complication.Builder
wird jetzt zur Verdeutlichung überComplication.createRoundRectComplicationBuilder
oderComplication.createBackgroundComplicationBuilder
erstellt (I54063).- WatchFace.TapListener wurde hinzugefügt, mit dem Tippen, das nicht von Zusatzfunktionen verbraucht wird, vom Zifferblatt erkannt werden kann. (Ic2fe1, b/172721168)
- WatchFace unterstützt jetzt variable Framerates, indem
Renderer.interactiveDrawModeUpdateDelayMillis
zugewiesen wird. Dies kann dazu beitragen, die Akkulaufzeit zu verlängern, indem der Ruhemodus beendet wird, wenn keine Animation aktiviert ist. (I707c9) - WatchFace.Builder wird nicht mehr benötigt und invalid() und interactiveUpdateRateMillis wurden in den Renderer verschoben. (I329ea)
- Zur besseren Java-Interoperabilität wurden Getter für boolesche Attribute in WatchState umbenannt (I6d2f1).
- TapListener wurde aus Konsistenzgründen in TapCallback und InvalidCallback in InvalidListener umbenannt. (I9414e)
- Die Stiloptionen für das Wear 2.0-Zifferblatt wurden zur Verdeutlichung in eine eigene Klasse verschoben. WatchFace.Builder-Setter haben jetzt symmetrische WatchFace-Klassen-Getter. Iefdfc
- InteractiveWatchFaceWcsClient und
WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient
wurden hinzugefügt. Mit diesen werden entweder eine vorhandene Instanz abgerufen oder erstellt, sobald der Wallaper-Dienst eine Verbindung hergestellt und die Engine erstellt hat. (Id666e) - WatchFaceControlClient ist jetzt eine Schnittstelle für Tests zur Simulation. (I875d9)
- HeadlessWatchFaceClient, InteractiveWatchFaceSysUiClientImpl und InteractiveWatchFaceWcsClient sind jetzt Schnittstellen, die Tests erleichtern. (I7cdc3)
- Anmerkungen zu Methoden in
wear-watchface-complications-rendering
hinzugefügt (I0d65c)
Fehlerkorrekturen
- Bildschirmform aus DeviceConfig entfernen, wodurch
android.content.res.Configuration#isScreenRound()
dupliziert wurde (Ifadf4) WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient
wurde so geändert, dass einMap<String, String>
anstelle vonUserStyle
akzeptiert wird, da es schwierig ist, eineUserStyle
zu erstellen, ohne das Schema zu kennen, das Sie erst abrufen können, nachdem der Client erstellt wurde. (Iea02a)- Korrigieren Sie
InteractiveWatchFaceWcsClient
, damitComplicationState
anstelle des Übertragungsformats verwendet wird. (Icb8a4) UserStyleSettings
ist jetzt eine versiegelte Klasse, da die Zifferblatt-Editoren nur die integrierten Klassen verstehen. (I2d797)
Version 1.0.0-alpha02
11. November 2020
androidx.wear:wear-*:1.0.0-alpha02
wurde veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.
API-Änderungen
ComplicationDetails
heißt jetztComplicationState
und ist ordnungsgemäß zusammengefasst. Die Nutzung der Wearable-Unterstützung „@ComplicationData.ComplicationType
“ wurde zu AndroidxComplicationType
migriert. (I4dd36)- Fügen Sie den RenderParameters einen optionalen
highlightedComplicationId
-Parameter hinzu, mit dem Sie die Hervorhebung einer einzelnen Zusatzfunktion in Screenshots anfordern können. (I66ce9) ComplicationProviderService
, um die neue Stilkomplikations-API aus Konsistenzgründen zu verwenden (Id5aea)getPreviewReferenceTimeMillis
ruft jetzt Referenzzeiten vonDeviceConfig
ab. (I779fe)- Zur Vereinfachung der Oberfläche der Renderer API können Sie stattdessen
SurfaceHolder.Callback
verwenden, um Änderungen zu beobachten. (I210db) CanvasComplicationRenderer
bezieht sich nicht aufRenderer
und wird daher zur besseren Übersichtlichkeit umbenannt. (Ibe880)
Fehlerkorrekturen
- Erste Version von
androidx.wear:wear-watchface-client
(I1e35e) - Der Name von
GlesTextureComplication#renderer
wurde zur besseren Übersicht geändert (Ib78f7) StyleCategory
zur besseren Verständlichkeit inStyleSetting
umbenennen (I488c7)UserStyleSchema
für eine übersichtlichere API hinzufügen (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
wurden veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
API-Änderungen
- Wir haben einige Dinge entfernt, die wir nicht in der öffentlichen API veröffentlichen wollten. (I41669)
androidx.wear:wear-complications-provider
-Bibliothek erstellen. (I77f1f)- „ComplicationsUserStyleCategory“, die neue empfohlene Kategorie zum Konfigurieren von Zusatzfunktionen (I96909)
- Fügen Sie eine Wear-Complication-Data API hinzu. (I7c268)
- Funktionen mit booleschen Werten, denen das Präfix „is“ statt „get“ vorangestellt wird (If36ff)
- Wir empfehlen, die Verwendung von "geschützt" zu vermeiden. Diese Klasse wurde so refaktoriert, dass Parameter über den Konstruktor erfasst werden. (I61644)
- Zur besseren Verständlichkeit wurde „setBackgroundComplication“ umbenannt. (I96fe3)
- Kotlin-Attribute für „ComplicationDrawable isHighlighted“ und Daten (I4dcc8)
- Anstelle von ComplicationRenderer.InvalidCallback fügen wir Complication#invalid() (I4f4c6) hinzu.
- Diese APIs werden im WearableSupport eingestellt und hier entfernt. (Ib425c)
- Einige WatchFace-Builder-Methoden wurden umbenannt, um den Wear 2.0-Legacy-Charakter zu betonen. (Idb775)
- Erster Beta-API-Kandidat für Wear/Wear-Watchface (Id3981)
- Erste überwachte Version der API. (Ie9fe6)
- „ComplicationDrawable.BorderStyle IntDef“ wird richtig ausgeblendet und aus Konsistenzgründen zu „ComplicationStyle“ verschoben. (I27f7a)
- Fehlende Anmerkungen für ComplicationStyle-Methoden hinzufügen (I838fd)
- Diese Bibliothek hat keine öffentliche API-Oberfläche (I88e2b).
- Alle Optionsklassen für Stilkategorien sind jetzt korrekt endgültig. (Ib8323)
- Erste überwachte Version der API. (I27c85)
Fehlerkorrekturen
- ComplicationProviderService verfügt jetzt über eine explizite getComplicationPreviewData-Methode. (I4905f)
- API-Lint-Prüfung für MissingGetterMatchingBuilder ist für Androidx aktiviert (I4bbea, b/138602561).
- Benennen Sie das Rendering von Wear-Zusatzfunktionen um. (Ifea02)
- Anzeigenamen der Stilkategorien sind jetzt „CharSequences“ (I28990)
- Überschreiben durch Overlay für aktuelle Designs ersetzen und Namenskonventionen für Stile. (I4fde9)
- Zur besseren Verständlichkeit wurde UserStyle#getOptions umbenannt. (I695b6)
Version 1.2.0
Version 1.2.0
15. September 2021
androidx.wear:wear:1.2.0
wurde veröffentlicht. Version 1.2.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.1.0
CurvedText-Komponente zum einfachen Schreiben von gebogenem Text hinzugefügt, 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" />
Ein ArcLayout-Container wurde hinzugefügt, um seine untergeordneten Elemente nacheinander auf einem Bogen entweder im oder gegen den Uhrzeigersinn anzuordnen. Die untergeordneten Elemente können sowohl das standardmäßige Android-Widget als auch das Widget „gewölbt“ sein. Widgets, die die
ArcLayout.Widget
-Schnittstelle implementieren. (I536da) Ein 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>
Ein neuer Layout-Container, DismissibleFrameLayout, wurde hinzugefügt, der für die Verwendung innerhalb einer Aktivität das Schließen der Schaltfläche "Zurück" und/oder das Wischen zum Schließen handhabt. Es muss mindestens ein Listener hinzugefügt werden, damit auf eine Ablehnungsaktion reagiert werden kann. Ein Listener entfernt in der Regel eine beinhaltende Ansicht oder ein Fragment aus der aktuellen Aktivität. setSwipeDismissible(boolean) & setBackButtonDismissible(boolean) werden zur direkten Steuerung der Funktionen bereitgestellt. Dieses neue Layout soll das vorhandene SwipeDismissFrameLayout ersetzen.
Der Hinweis, dass eine Aktivität automatisch fortgesetzt werden kann, wenn das Gerät in der AmbientModeSupport-Klasse den Inaktivmodus verlässt, wird jetzt unterstützt. Diese Funktion war zuvor in der eingestellten WearableActivity-Klasse in der WearableSupportLibrary verfügbar. (I336ab)
Migrierte WearableCalendarContract-Klasse aus der Wearable-Supportbibliothek. Diese API stellt eine Teilmenge der über CalendarContract verfügbaren Daten bereit, wird aber automatisch mit Wearable-Geräten synchronisiert. (I6f2d7)
In
androidx.wear.utils
wurde eine neue APIWearTypeHelper
hinzugefügt, mit der ermittelt werden kann, ob das angegebene Wear-Gerät für China ist. (Ib01a9)androidx.wear.widget.ConfirmationOverlay
wurden Bedienungshilfen hinzugefügt, die Nachrichten vorlesen, wenn sie gefolgt von einer Animationsbeschreibung festgelegt wird. (I524dd)Der Fehler, der zum Absturz von ConfirmationActivity geführt hat, wenn keine Nachricht angezeigt wurde, wurde behoben. bereitgestellt wurde. (IE6055)
Der Fehler, durch den horizontales Scrollen von RecyclerViews verursacht wurde, wurde behoben.
WearableDrawerLayout
, um einen Blick auf alle Interaktionen zu werfen. (I24c7f)
Version 1.2.0-rc01
1. September 2021
androidx.wear:wear:1.2.0-rc01
wurde 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
wurde veröffentlicht. Version 1.2.0-beta01 enthält diese Commits.
Fehlerkorrekturen
- Fehler behoben, der zum Absturz von ConfirmationActivity geführt hat, wenn keine Meldung angezeigt wurde bereitgestellt wurde. (IE6055)
Version 1.2.0-alpha13
4. August 2021
androidx.wear:wear:1.2.0-alpha13
wurde veröffentlicht. Version 1.2.0-alpha13 enthält diese Commits.
API-Änderungen
WearTypeHelper.isChinaDevice
wurde inWearTypeHelper.isChinaBuild
umbenannt. (I47302)
Fehlerkorrekturen
- Wir haben
androidx.wear.widget.ConfirmationOverlay
Bedienungshilfen hinzugefügt, mit denen Nachrichten vorgelesen werden, wenn sie gefolgt von einer Animationsbeschreibung festgelegt wird. (I524dd)
Version 1.2.0-alpha12
21. Juli 2021
androidx.wear:wear:1.2.0-alpha12
wurde veröffentlicht. Version 1.2.0-alpha12 enthält diese Commits.
API-Änderungen
- Wir haben eine neue API
WearTypeHelper
inandroidx.wear.utils
hinzugefügt, um festzustellen, ob das angegebene Wear-Gerät für China ist. (Ib01a9)
Version 1.2.0-alpha11
30. Juni 2021
androidx.wear:wear:1.2.0-alpha11
wurde veröffentlicht. Version 1.2.0-alpha11 enthält diese Commits.
Fehlerkorrekturen
- Der Fehler, durch den horizontales Scrollen von RecyclerViews verursacht wurde, wurde behoben.
WearableDrawerLayout
, um einen Blick auf alle Interaktionen zu werfen. (I24c7f)
Version 1.2.0-alpha10
2. Juni 2021
androidx.wear:wear:1.2.0-alpha10
wurde veröffentlicht. Version 1.2.0-alpha10 enthält diese Commits.
Neue Funktionen
- Alpha10 verbessert die Unterstützung von Bedienungshilfen in Curved Text und ArcLayouts. Außerdem wurden einige geringfügige Umbenennungen von im DismissibleFrameLayout-Element hinzugefügt, um die API klarer zu machen.
API-Änderungen
- Wir haben die folgenden Methoden in
DismissibleFrameLayout
(Ib195e) umbenannt: <ph type="x-smartling-placeholder">- </ph>
Callback#onDismissed
->Callback#onDismissedFinished
isSwipeDismissible
->isDismissableBySwipe
isBackButtonDismissible
->isDismissableByBackButton
- Wir haben folgende Methoden endgültig festgelegt (Ib195e):
<ph type="x-smartling-placeholder">
- </ph>
setBackButtonDismissible
setSwipeDismissible
registerCallback
unregisterCallback
Fehlerkorrekturen
- Verwenden Sie den Inhalt der CurvedTextView bei TalkBack. (I05798)
- Bessere Zugänglichkeit für normale Ansichten in einem ArcLayout. (I4418d)
Version 1.2.0-alpha09
18. Mai 2021
androidx.wear:wear:1.2.0-alpha09
wurde veröffentlicht. Version 1.2.0-alpha09 enthält diese Commits.
API-Änderungen
- Eine neue Funktion
CurvedTextView.setTypeface()
(ähnlich der vonTextView
) wurde hinzugefügt, um die Schriftart und den Stil für Fett- und Kursivdruck festzulegen. (I4653c) WearArcLayout
wurde inArcLayout
,WearCurvedText
inCurvedText
undWearArcLayout.ArcLayoutWidget
inArcLayout.Widget
umbenannt. (I6e5ce) <ph type="x-smartling-placeholder">- </ph>
- Am
ArcLayout.Widget
wurdegetThicknessPx
ingetThickness
umbenannt. - Konstanten für die vertikale Ausrichtung in
ArcLayout.LayoutParams
sind jetzt benannt mitVERTICAL_ALIGN_
(anstelle des vorherigenVALIGN_
)
- Am
- Am
CurvedTextView
wurden die MethodensetMinSweepDegrees
undsetMaxSweepDegrees
durchsetSweepRangeDegrees
ersetzt (I7a9d9).
Version 1.2.0-alpha08
5. Mai 2021
androidx.wear:wear:1.2.0-alpha08
wurde veröffentlicht. Version 1.2.0-alpha08 enthält diese Commits.
API-Änderungen
- Zur Verbesserung der Verständlichkeit des Codes haben wir einigen Winkelparametern und Rückgabetypen
@FloatRange
-Anmerkungen hinzugefügt. (I430dd) - In der Schnittstelle
WearArcLayout.ArcLayoutWidget
heißt die MethodeinsideClickArea
jetzt isPointInsideClickArea. (Ia7307)
Version 1.2.0-alpha07
24. März 2021
androidx.wear:wear:1.2.0-alpha07
wurde veröffentlicht. Version 1.2.0-alpha07 enthält diese Commits.
Fehlerkorrekturen
- Fehler mit nicht gekrümmten untergeordneten Elementen innerhalb von WearArcLayout wurden behoben, die durch die Verwendung der Bildschirmgröße verursacht wurden, deren Höhe größer als Breite ist. Diese nicht gekrümmten untergeordneten Elemente werden jetzt bei allen Bildschirmtypen innerhalb eines Bogens platziert.
Version 1.2.0-alpha06
27. Januar 2021
androidx.wear:wear:1.2.0-alpha06
wurde veröffentlicht. Version 1.2.0-alpha06 enthält diese Commits.
API-Änderungen
- Migrieren Sie die Bibliothek „Laufende Aktivitäten“ in eine neue Unterbibliothek: „Wear-ongoing“. Kurse sind jetzt im Paket „androidx.wear.ongoing“ verfügbar (bisher androidx.wear.ongoingactivities) (I7c029).
- Migrieren Sie die WearableCalendarContract-Klasse von der Wearable-Supportbibliothek zu AndroidX. Diese API stellt eine Teilmenge der über CalendarContract verfügbaren Daten bereit, wird aber automatisch mit Wearable-Geräten synchronisiert. (I6f2d7)
Fehlerkorrekturen
- Die Funktion zum Schließen der Schaltfläche „Zurück“ wird in Dismissible FrameLayout standardmäßig deaktiviert, da auf Wearable-Geräten weiterhin die Wischbewegung zum Schließen im Vollbildmodus verwendet wird (Ic24e3).
- Einige Probleme bei der Handhabung der Sichtbarkeit von Kindern unter WearArcLayout wurden behoben (Icf912).
Version 1.2.0-alpha05
13. Januar 2021
androidx.wear:wear:1.2.0-alpha05
wurde veröffentlicht. Version 1.2.0-alpha05 enthält diese Commits.
Fehlerkorrekturen
- Aktualisieren Sie die Javadoc der Klasse „AmbientModeSupport“, um Beispiel-Snippets bereitzustellen, um die allgemeine Verwendung dieser Klasse besser zu veranschaulichen.
Version 1.2.0-alpha04
16. Dezember 2020
androidx.wear:wear:1.2.0-alpha04
wurde veröffentlicht. Version 1.2.0-alpha04 enthält diese Commits.
API-Änderungen
- Der Hinweis, dass eine Aktivität automatisch fortgesetzt werden kann, wenn das Gerät in der AmbientModeSupport-Klasse den Inaktivmodus verlässt, wird jetzt unterstützt. Diese Funktion war zuvor in der eingestellten WearableActivity-Klasse in der WearableSupportLibrary verfügbar. (I336ab)
- Laufende Aktivität
<ph type="x-smartling-placeholder">
- </ph>
- Beim Erstellen einer laufenden Aktivität kann jetzt eine Kategorie festgelegt werden, z.B.
OngoingActivitiy.Builder.getCategory(String)
- OngoingActivityData hat jetzt einen Zeitstempel, der angibt, wann die OngoingActivity erstellt wurde:
OngoingActivityData.getTimestamp()
- (I91cb4)
- Beim Erstellen einer laufenden Aktivität kann jetzt eine Kategorie festgelegt werden, z.B.
- Das Festlegen von Rändern für untergeordnete WearArcLayout-Elemente wurde hinzugefügt, indem die Layoutparameter geändert wurden, um MarginLayoutParams zu erweitern, d.h. WearArcLayout.LayoutParams erweitert android.view.ViewGroup.MarginLayoutParams. (I2cd88)
- Ändere den Standardankertyp von WearCurvedTextView zu
WearArcLayout.ANCHOR_CENTER
(warWearArcLayout.ANCHOR_START
). Dies vereinfacht die Kontraktion zwischen dem Arc-Layout und dem gewölbten Text, da der gebogene Text sich standardmäßig oben x-zentriert gezeichnet wird und das Layout des übergeordneten Bogens ihn an die gewünschte Position drehen kann. (I105ff)
Version 1.2.0-alpha03
2. Dezember 2020
androidx.wear:wear:1.2.0-alpha03
wurde veröffentlicht. Version 1.2.0-alpha03 enthält diese Commits.
Neue Funktionen
Ein neuer Layout-Container DismissibleFrameLayout, das für die Verwendung innerhalb einer Aktivität das Schließen der Schaltfläche "Zurück" und/oder das Schließen durch Wischen verarbeitet Es muss mindestens ein Listener hinzugefügt werden, damit auf eine Ablehnungsaktion reagiert werden kann. Ein Listener entfernt in der Regel eine beinhaltende Ansicht oder ein Fragment aus der aktuellen Aktivität. setSwipeDismissible(boolean) & setBackButtonDismissible(boolean) werden zur direkten Steuerung der Funktionen bereitgestellt. Dieses neue Layout soll das vorhandene SwipeDismissFrameLayout ersetzen.
Gekrümmte Widgets verarbeiten jetzt Touch-Events. Normale Widgets innerhalb eines WearArcLayouts empfangen alle Touch-Ereignisse in ihrem Koordinatenraum. WearCurvedTextView (in einem WearArcLayout- oder nicht) kann onClick- und onLongClick-Handler festlegen.
Klassen für laufende Aktivitäten heißen jetzt VersionedParcelables und nicht mehr benutzerdefinierte Serialisierung/Deserialisierung. Das statische Symbol und der Touch-Intent sind jetzt erforderlich.
API-Änderungen
- Das Attribut „sweepDegrees“ für WearCurvedTextView ist 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
wurde veröffentlicht. Version 1.2.0-alpha02 enthält diese Commits.
In dieser Version wird erstmals eine neue „Ongoing Activity API“ hinzugefügt. Diese API kann von Entwicklern verwendet werden, um zu signalisieren, dass eine lang andauernde Aktivität, z. B. ein Fitnesstraining oder eine Medienwiedergabesitzung, läuft. Entwickler können damit regelmäßige Statusupdates wie „Strecke und Laufzeit“ oder „Aktuelle Titelwiedergabe“ zur Anzeige auf dem Zifferblatt oder im App Launcher zur Verfügung stellen. Diese Funktion ist auf zukünftige Geräte ausgerichtet, auf denen die Funktion für laufende Aktivitäten aktiviert ist.
API-Änderungen
- Neue API für laufende Aktivitäten, dies ist eine Bedienungshilfe für nicht unterstützte Geräte. (I69a31)
Version 1.2.0-alpha01
28. Oktober 2020
androidx.wear:wear:1.2.0-alpha01
wurde veröffentlicht. Version 1.2.0-alpha01 enthält diese Commits.
Neue Funktionen
- WearCurvedTextView-Komponente zum einfachen Schreiben von gekrümmtem Text hinzugefügt, der der Krümmung des größten Kreises folgt, der in der 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"
/>
- Es wurde ein WearArcLayout-Container hinzugefügt, mit dem die untergeordneten Elemente nacheinander auf einem Bogen entweder im oder gegen den Uhrzeigersinn angeordnet werden können. Die untergeordneten Elemente können sowohl das standardmäßige Android-Widget als auch das Widget „gewölbt“ sein. Widgets, die die zugehörige 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-Eingabe 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
wurden veröffentlicht. Version 1.2.0-alpha02 enthält diese Commits.
API-Änderungen
disallowEmoji
wurde inWearableRemoteInputExtender
insetEmojisAllowed
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
wurden veröffentlicht. Version 1.2.0-alpha01 enthält diese Commits.
API-Änderungen
- Alle Schaltflächenpositionen von
WearableButtons
wurden offengelegt. (Ibb12c) - Die Klasse
WearableRemoteInputExtender
wurde hinzugefügt, mit der Wear-spezifische Extras zu „android.app.RemoteInput“ hinzugefügt werden können. (I01903)
Wear-Eingabe 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
wurden veröffentlicht. Version 1.1.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.0.0
RemoteInputIntentHelper
wurde hinzugefügt.- Mit dieser Klasse kann ein RemoteInput-Intent erstellt werden. Damit können Sie dann Input von Ihren Nutzern in einer anpassbaren Aktivität 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
wurden veröffentlicht. Version 1.1.0-rc01 enthält diese Commits.
Keine API-Änderungen seit androidx.wear:wear-input:1.1.0-beta01
und 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
wurden ohne Änderungen seit dem 1.1.0-alpha03
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
wurden veröffentlicht. Version 1.1.0-alpha03 enthält diese Commits.
Fehlerkorrekturen
- Es wurde ein Fehler behoben, durch den RemoteInput-Intents, denen
RemoteInput
s überRemoteInputHelper.putRemoteInputsExtra
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
wurden veröffentlicht. Version 1.1.0-alpha02 enthält diese Commits.
API-Änderungen
- Die Methoden von
RemoteInputIntentHelper
, die zum Abrufen oder Einfügen von Extras verwendet werden, die die Labels „title“, „cancel“, „confirm“ und „in progress“ repräsentieren, verwenden jetztCharSequence
anstelle vonString
für diese Labels. (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
wurden veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.
API-Änderungen
- Migration der RemoteInputIntent-Klasse von der Wearable-Supportbibliothek zu AndroidX Die migrierte Klasse wird in RemoteInputIntentHelper umbenannt und bietet Hilfsfunktionen zur Unterstützung von Remote-Eingaben durch das Starten eines Intents. (I47cee)
Wear-Eingabe 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
wurden veröffentlicht. Version 1.0.0 enthält diese Commits.
Dieser Release ist mit 1.0.0-rc01
identisch.
Hauptfunktionen von Version 1.0.0
Migration der WearableButtons-Funktionen von der Wearable-Supportbibliothek zu Jetpack.
androidx.wear.input.test.TestWearableButtonsProvider
wurde hinzugefügt, dieandroidx.wear.input.WearableButtonsProvider
implementiert, um das Testen von Anwendungen zu unterstützen, die mit derandroidx.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
wurden veröffentlicht. 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
wurden ohne Änderungen seit dem 1.1.0-alpha01
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
wurde veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
API-Änderungen
androidx.wear.input.test.TestWearableButtonsProvider
wurde hinzugefügt, dieandroidx.wear.input.WearableButtonsProvider
implementiert, um das Testen von Anwendungen zu unterstützen, die mit derandroidx.wear:wear-input
-Bibliothek entwickelt wurden. (I0ed0c)
Wear-Eingabe Version 1.0.0-alpha01
2. September 2020
androidx.wear:wear-input:1.0.0-alpha01
wurde 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 Unterstützung für Tests wird im nächsten Jetpack-Release in der androidx.wear:wear-input-testing
-Bibliothek bereitgestellt.
Version 1.1.0
Version 1.1.0
14. Oktober 2020
androidx.wear:wear:1.1.0
wurde veröffentlicht. Version 1.1.0 enthält diese Commits.
Große Änderungen seit Version 1.0.0
- Das Präfix
layout_
für das Attribut „boxedEdges“ (jetztlayout_BoxedEdges
) fürBoxInsetLayout
wurde hinzugefügt, um der Android-Namenskonvention zu entsprechen. Dadurch wird der Linter-Fehler in Android Studio für diese Attribute entfernt. (I4272f) ConfirmationActivity
wurde eine optionaleEXTRA_ANIMATION_DURATION_MILLIS
hinzugefügt, um die Dauer zu ermöglichen, in der das Bestätigungsdialogfeld angezeigt wird. (adb83ce, b/143356547)WearableActionDrawView
wurde aktualisiert, um das Aufblähen der Aktionsleiste zu verzögern, bis die Leiste zum ersten Mal geöffnet wird. (I01026, b/163870541)
Version 1.1.0-rc03
2. September 2020
androidx.wear:wear:1.1.0-rc03
wurde veröffentlicht. Version 1.1.0-rc03 enthält diese Commits.
Fehlerkorrekturen
- Ein Problem wurde behoben, durch das beim Öffnen der Aktionsleiste keine Inhalte angezeigt wurden. (I01026, b/163870541)
Version 1.1.0-rc02
24. Juni 2020
androidx.wear:wear:1.1.0-rc02
wurde veröffentlicht. Version 1.1.0-rc02 enthält diese Commits.
Fehlerkorrekturen
- Das Präfix
layout_
für das Attribut „boxedEdges“ (jetztlayout_boxedEdges
) fürBoxInsetLayout
wurde hinzugefügt, um der Android-Namenskonvention zu entsprechen. Dadurch wird der Linter-Fehler in Android Studio für diese Attribute entfernt.
Version 1.1.0-rc01
14. Mai 2020
androidx.wear:wear:1.1.0-rc01
wurde ohne Änderungen seit dem .1.0-beta01
freigegeben. Version 1.1.0-rc01 enthält diese Commits.
Version 1.1.0-beta01
29. April 2020
androidx.wear:wear:1.1.0-beta01
wurde ohne Änderungen seit dem androidx.wear:wear:1.1.0-alpha01
freigegeben. Version 1.3.0-beta01 enthält diese Commits.
Version 1.1.0-alpha01
15. April 2020
androidx.wear:wear:1.1.0-alpha01
wurde veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.
API-Änderungen
ConfirmationActivity
wurde eine optionaleEXTRA_ANIMATION_DURATION_MILLIS
hinzugefügt, um die Dauer zu ermöglichen, in der das Bestätigungsdialogfeld angezeigt wird. (adb83ce, 134523c, b/143356547)
Fehlerkorrekturen
WearableActionDrawView
wurde aktualisiert, um das Aufblähen der Aktionsleiste zu verzögern, bis die Leiste zum ersten Mal geöffnet wird. (5cd32f7)