Wear
androidx.wear.activity
androidx.wear.ambient
androidx.wear.input
androidx.wear.utils
androidx.wear.widget
androidx.wear.widget.drawer
(Siehe Refdocs für alle Wear-Pakete
In dieser Tabelle sind alle Artefakte in der Gruppe androidx.wear
aufgeführt.
Artefakt | Stabile Version | Releasekandidat | Beta-Ausgabe | Alpharelease |
---|---|---|---|---|
Wear | 1.3.0 | - | - | 1.4.0-alpha01 |
Wear OS-Eingabe | 1.1.0 | - | - | 1.2.0-alpha02 |
Wear-Input-Tests | 1.1.0 | - | - | 1.2.0-alpha02 |
dauerhafter Tragekomfort | 1.0.0 | - | - | 1.1.0-alpha01 |
Wear-Smartphone-Interaktionen | 1.0.1 | - | - | 1.1.0-alpha04 |
Wear Remote-Interaktionen | 1.0.0 | - | - | 1.1.0-alpha02 |
Abhängigkeiten deklarieren
Zum Hinzufügen einer Abhängigkeit von Wear musst du deinem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie im Maven-Repository von Google.
Fügen Sie der Datei build.gradle
für Ihre Anwendung oder Ihr Modul die Abhängigkeiten für die benötigten Artefakte hinzu:
Groovig
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. Lassen Sie uns wissen, wenn Sie neue Probleme entdecken oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie eine neue erstellen. Durch Klicken auf die Stern-Schaltfläche können Sie zu einem vorhandenen Problem abstimmen.
Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.
Wear Tooling-Vorschau Version 1.0
Version 1.0.0
29. November 2023
androidx.wear:wear-tooling-preview:1.0.0
wird freigegeben. Version 1.0.0 enthält diese Commits.
Funktionen in Version 1.0.0
- Füge
WearDevices
hinzu, um gültige Wear-Geräte aufzulisten, die für UI-Vorschauen verwendet werden können.
Version 1.0.0-rc01
15. November 2023
androidx.wear:wear-tooling-preview:1.0.0-rc01
wird ohne Änderungen veröffentlicht. Version 1.0.0-rc01 enthält diese Commits.
Version 1.0.0-beta01
18. Oktober 2023
androidx.wear:wear-tooling-preview:1.0.0-beta01
wird ohne Änderungen veröffentlicht. Version 1.0.0-beta01 enthält diese Commits.
Version 1.0.0-alpha01
23. August 2023
androidx.wear:wear-tooling-preview:1.0.0-alpha01
wird freigegeben. Version 1.0.0-alpha01 enthält diese Commits.
API-Änderungen
- Füge
WearDevices
hinzu, um gültige Wear-Geräte aufzulisten, die für UI-Vorschauen verwendet werden können (Ib036e)
Wear-Version 1.4
Version 1.4.0-alpha01
15. November 2023
androidx.wear:wear:1.4.0-alpha01
wird freigegeben. 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 1.3.0-rc01
veröffentlicht. Version 1.3.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.2.0
- Migrieren Sie
AmbientModeSupport
, umLifecycleObserver
zu verwenden.AmbientModeSupport
wird zugunsten der neuen Lebenszyklusklassen verworfen. ConfirmationOverlay
mit neuen Symbolen/Layout, neuen Schriftarten und Schriftartmesswerten aktualisierenSwipeDismissTransitionHelper
wurde aktualisiert, um anstelle eines zweitenView
ein Hintergrund-Drawable zu verwenden, um Fehler bei der Verwendung vonFragmentContainerView
zu korrigierenSwipeDismissFrameLayout
-Animation wurde aktualisiert, damit sie der Wear-Plattform und den Wear Compose-Implementierungen entspricht.- Fehlerkorrektur für
SwipeDismissFrameLayout
, um ein versehentliches Schließen von Fragmenten mit senkrechten Strichen zu vermeiden ArcLayout
unterstützt jetzt Erweiterungsgewichtungen, die ähnlich funktionieren wie reguläre Layoutgewichtungen.layoutDirection
aufArcLayout
unterstützen
Version 1.3.0-rc01
21. Juni 2023
androidx.wear:wear:1.3.0-rc01
wurde ohne Änderungen seit 1.3.0-beta01
veröffentlicht. Version 1.3.0-rc01 enthält diese Commits.
Version 1.3.0-beta01
7. Juni 2023
androidx.wear:wear:1.3.0-beta01
wird freigegeben. Version 1.3.0-beta01 enthält diese Commits.
API-Änderungen
- Nach Feedback wurden
AmbientLifecycleObserver
aktualisiert.AmbientLifecycleObserverInterface
wurde inAmbientLifecycleObserver
umbenannt. Eine Instanz kann durch Aufrufen vonAmbientLifecycleObserver(...)
abgerufen werden.isAmbient
wurde in ein Feld und nicht in eine Methode verschoben. (I84b4f)
Fehlerkorrekturen
- Hinzufügen von Nullprüfungen für Fälle, in denen die übergeordnete Ansicht null ist, während Alpha und Übersetzung in
SwipeToDismiss
zurückgesetzt werden. (Ib0ec7)
Version 1.3.0-alpha05
19. April 2023
androidx.wear:wear:1.3.0-alpha05
wird freigegeben. Version 1.3.0-alpha05 enthält diese Commits.
API-Änderungen
- Migrieren Sie
AmbientModeSupport
, umLifecycleObserver
zu verwenden.AmbientModeSupport
zugunsten der neuen lebenszyklusbewussten Klassen einstellen. (I1593b)
Fehlerkorrekturen
- Aktualisiere die Herangehensweise an das Hintergrund-Scrim-Verfahren von
SwipeDismissTransitionHelper
so, dass Drawables verwendet werden, 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
wird freigegeben. Version 1.3.0-alpha04 enthält diese Commits.
Fehlerkorrekturen
- Wir haben die Animation in
SwipeDismissFrameLayout
aktualisiert, damit sie der Wear-Plattform und den Wear Compose-Implementierungen entspricht. (I7261b)
Version 1.3.0-alpha03
24. August 2022
androidx.wear:wear:1.3.0-alpha03
wird freigegeben. Version 1.3.0-alpha03 enthält diese Commits.
Neue Funktionen
ArcLayout
unterstützt jetzt Erweiterungsgewichtungen, die ähnlich funktionieren wie reguläre Layoutgewichtungen. Sie können also die relative Größe untergeordneter Elemente angeben, ohne ihre Winkel direkt berechnen zu müssen. Außerdem haben wir einen Best-Effort-MaxAngleDegrees
hinzugefügt, der beim Maximieren untergeordneter Elemente mit Gewichtungen berücksichtigt wird. Wenn Sie beispielsweise den Bogen bei mehreren untergeordneten Elementen mit Gewichten auf 90 Grad klemmen, wird dabei auch der Abstand berücksichtigt, der von nicht maximierten Elementen eingenommen wird.
API-Änderungen
ArcLayout.LayoutParams
wurde gewichtet, sodass ein Widget den verfügbaren Platz ausfüllen kann. Wenn mehrere Widgets vorhanden sind, ist ihr Anteil am verfügbaren Platz proportional zu ihrer Gewichtung. Darüber hinaus haben wirArcLayout.setMaxAngleDegrees
hinzugefügt, sodass Sie die Einblendung beispielsweise auf 90 Grad begrenzen können. Dies hat jedoch keinen Einfluss auf das Layout untergeordneter Widgets mit fester Größe.ArcLayout.Widget
verfügt jetzt übersetSweepAngleDegrees
, wodurchArcLayout
ein Widget mit einer Gewichtung ungleich null über seine Größe informieren kann. (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
wird freigegeben. Version 1.3.0-alpha02 enthält diese Commits.
Neue Funktionen
layoutDirection
aufArcLayout
(I14d49) unterstützen- Verbesserte Inhaltsbeschreibungsnachricht für Bestätigungs-Overlay (I0fdf8)
- Aktualisiere
ConfirmationOverlay
mit neuen Symbolen/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 SwipeCloseFrameLayout mit einer vertikalen Ziehbewegung (Idb6d8)
- Behebung von VerificationOverlay, wenn keine Nachricht vorhanden ist (I63e6f)
Externer Beitrag
- Dae Gyu LEE (Samsung) – Versehentliches Schließen von Fragmenten in SwipeCloseFrameLayout mit vertikaler Ziehbewegung vermeiden (Idb6d8)
Version 1.3.0-alpha01
29. September 2021
androidx.wear:wear:1.3.0-alpha01
wird freigegeben. Version 1.3.0-alpha01 enthält diese Commits.
Fehlerkorrekturen
ConfirmationOverlay
schiebt das Symbol jetzt nach oben, um längere Nachrichten aufzunehmen, ohne dass die Nachricht in den Rand des Geräts (oder aus dem Bildschirm) gelangt. (I54bff)
Wear-Ongoing & Interactions Version 1.1.0
VerWear-Phone-Interactions-Version 1.1.0-alpha04
10. Januar 2024
androidx.wear:wear-phone-interactions:1.1.0-alpha04
wird freigegeben. Version 1.1.0-alpha04 enthält diese Commits.
API-Änderungen
- Wir haben
RemoteAuthClient.isRemoteAuthAvailable
hinzugefügt, das prüft, ob die Remote-Authentifizierung verfügbar ist. (Ibc10c)
Version 1.1.0-alpha02
10. Januar 2024
androidx.wear:wear-remote-interactions:1.1.0-alpha02
wird freigegeben. Version 1.1.0-alpha02 enthält diese Commits.
API-Änderungen
- Wir haben
RemoteActivityHelper.isRemoteActivityHelperAvailable
hinzugefügt, mit dem geprüft werden kann, ob die Funktion zum Starten einer Remote-Aktivität verfügbar ist. (I107a9) - Wir haben den Konstruktor von
RemoteActivityHelper
so aktualisiert, dass er optionale Parameter enthält, die mit Java kompatibel sind. (I75554)
Version 1.1.0-alpha01
21. Juni 2023
androidx.wear:wear-remote-interactions:1.1.0-alpha01
wird freigegeben. Version 1.1.0-alpha01 enthält diese Commits.
Fehlerkorrekturen
- Die Vervollständigung und Fehlerbehandlung in
RemoteActivityHelper
wurde verbessert. (I60d60)
Externer Beitrag
- Entfernen Sie die Guava-Abhängigkeit aus
wear-remote-interactions
und verwenden Sie kleinere Alternativen.
Wear-Smartphone-Interactions-Version 1.1.0-alpha03
9. März 2022
androidx.wear:wear-phone-interactions:1.1.0-alpha03
wird freigegeben. Version 1.1.0-alpha03 enthält diese Commits.
Fehlerkorrekturen
redirectUrl
ausOAuthRequest
gibt jetzt einen leeren String zurück, wenn die Weiterleitungs-URL in der angegebenen Anfrage-URL nicht festgelegt ist. (I44242)
Wear-Smartphone-Interactions-Version 1.1.0-alpha02
15. Dezember 2021
androidx.wear:wear-phone-interactions:1.1.0-alpha02
wird freigegeben. 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 inaktiven Links zuErrorCode
(I260e8).
Wear-Smartphone-Interactions-Version 1.1.0-alpha01
15. September 2021
androidx.wear:wear-phone-interactions:1.1.0-alpha01
wird freigegeben. Version 1.1.0-alpha01 enthält diese Commits.
API-Änderungen
Wear-Ongoing & Interactions Version 1.0.0
Wear-Smartphone-Interactions-Version 1.0.1
15. Dezember 2021
androidx.wear:wear-phone-interactions:1.0.1
wird freigegeben. Version 1.0.1 enthält diese Commits.
Fehlerkorrekturen
- Es wurde eine Ausnahme von
BridgingManager
ausgelöst, wenn versucht wurde, Bridging-Benachrichtigungen ohneexcludedTags
zu deaktivieren.
Wear-Smartphone-Interaktionen, Wear-Remote-Interaktionen Version 1.0.0
15. September 2021
androidx.wear:wear-phone-interactions:1.0.0
und androidx.wear:wear-remote-interactions:1.0.0
werden 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 von Wearables bis Smartphones. Sie enthält Folgendes:
PhoneDeviceType
bietet Hilfsmethoden zum Bestimmen des Smartphone-Typs, mit dem die aktuelle Smartwatch gekoppelt ist. Die Funktion ist nur auf Wearable-Geräten verfügbar.BridgingManager
,BridgingManagerService
undBridgingConfig
APIs, um Benachrichtigungen zur Laufzeit zu aktivieren oder zu deaktivieren und optional Tags für Benachrichtigungen festzulegen, die vom Bridging-Modus ausgenommen sind.RemoteAuthClient
unterstützt die Remote-Authentifizierung auf Wearables und das Hinzufügen der OAuth-PKCE-Erweiterung. Es werden zusätzliche Handler und Hilfsklassen für die Kommunikation bereitgestellt.
Die Remote Interaction Library enthält APIs für Interaktionen zwischen den Wearables und Smartphones. Sie enthält Folgendes:
WatchFaceConfigIntentHelper
bietet Hilfsfunktionen zur Angabe der ID und des Komponentennamens bei den Aktivitäten zur Konfiguration des Zifferblatts für das Companion auf dem Smartphone.- Klasse
RemoteActivityHelper
, 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
werden veröffentlicht. Version 1.0.0-rc01 enthält diese Commits.
Fehlerkorrekturen
- Fehler beheben, der verhindert, dass Fehler, die in den Google Play-Diensten aufgetreten sind, an den Aufrufer weitergeleitet werden, wenn RemoteActivityHelper (I60d60) verwendet wird
- Ein Fehler wurde behoben, bei dem das Future-Objekt von RemoteActivityHelper nie ausgeführt wurde, wenn keine verbundenen Knoten vorhanden waren oder die angeforderte Knoten-ID nicht gefunden wurde (I60d60).
Wear-Ongoing Version 1.1
Version 1.1.0-alpha01
23. August 2023
androidx.wear:wear-ongoing:1.1.0-alpha01
wird freigegeben. Version 1.1.0-alpha01 enthält diese Commits.
API-Änderungen
- Fügen Sie der laufenden Aktivität ein Feld für die Inhaltsbeschreibung hinzu. Diese wird von Bedienungshilfen verwendet, um die laufende Aktivität zu beschreiben. (I79fc6)
Fehlerkorrekturen
@RequiresPermission
wurde APIs hinzugefügt, für die ab SDK 33 die BerechtigungPOST_NOTIFICATIONS
gewährt werden muss. (Ie542e, b/238790278)
Wear-Ongoing Version 1.0.0
1. September 2021
androidx.wear:wear-ongoing:1.0.0
wird freigegeben. 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, mit der sie ihre Aktivitäten als „Laufende Aktivitäten“ kennzeichnen und die erforderlichen Informationen angeben können.
- Laufende Aktivitäten sind Aktivitäten, die im Hintergrund der Uhr ausgeführt werden können (z.B. Training, Anrufe und Medien). Unter Wear 3 wird eine als fortlaufend 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 Wear Ongoing Activity Guide.
Wear-Smartphone-Interactions Wear-Remote-Interactions Version 1.0.0-beta01
18. August 2021
androidx.wear:wear-phone-interactions:1.0.0-beta01
und androidx.wear:wear-remote-interactions:1.0.0-beta01
werden veröffentlicht. Version 1.0.0-beta01 enthält diese Commits.
API-Änderungen
- Kurs "
RemoteIntentHelper
" wurde in "RemoteActivityHelper
" umbenannt. Die FunktionenRemoteIntentHelper#getRemoteIntentExtraIntent
undRemoteIntentHelper#getRemoteIntentNodeId
wurden inRemoteActivityHelper#getTargetIntent
bzw.RemoteActivityHelper#getTargetNodeId
umbenannt. (Id2042)
Wear-Ongoing-Version 1.0.0-rc01
18. August 2021
androidx.wear:wear-ongoing:1.0.0-rc01
wurde ohne Änderungen seit 1.0.0-beta01
veröffentlicht. Version 1.0.0-rc01 enthält diese Commits.
Wear-Ongoing-Version 1.0.0-beta01
4. August 2021
androidx.wear:wear-ongoing:1.0.0-beta01
wird freigegeben. Version 1.0.0-beta01 enthält diese Commits.
API-Änderungen
- Einige Setter in OngoingActivity.Builder akzeptieren jetzt ein Null-Argument, um den Setter und Gettern Symmetrie und Konsistenz zu verleihen (I17ee5).
Wear-Smartphone-Interactions-Version 1.0.0-alpha07
4. August 2021
androidx.wear:wear-phone-interactions:1.0.0-alpha07
wird freigegeben. Version 1.0.0-alpha07 enthält diese Commits.
API-Änderungen
WearTypeHelper.isChinaDevice
wurde inWearTypeHelper.isChinaBuild
umbenannt. (I47302)- Wir haben die RemoteAuthClient-Bibliothek aktualisiert, sodass „redirect_uri“ automatisch basierend auf dem Gerätetyp (RoW/China) ausgewählt wird. (I38866)
- Es wurde ein Fehler behoben, der verursachte, dass beim Konvertieren von BridgingConfig in/aus 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
wird freigegeben. Version 1.0.0-alpha06 enthält diese Commits.
Wear-Smartphone-Interactions-Version 1.0.0-alpha06
21. Juli 2021
androidx.wear:wear-phone-interactions:1.0.0-alpha06
wird freigegeben. Version 1.0.0-alpha06 enthält diese Commits.
API-Änderungen
- Die Klasse
BridgingManagerSeviceBinder
ist jetzt eine Unterklasse des Dienstes und wurde in BridgingManagerSevice umbenannt. (I9fca2) - Die Methode
RemoteAuthClient.Callback.onAuthorizationError
wurde geändert und enthält nun den Parameter „OAuthRequest“. Methoden, die Callbacks erfordern, erfordern jetzt auch einen Executor, auf dem der Callback ausgeführt wird. (I35e11)
Fehlerkorrekturen
- Die Authentifizierungs-API wurde durch mehr dokumentierte Parameter und nach Möglichkeit durch die Verwendung von Eigenschaften verständlicher. (I12287)
Wear-Smartphone-Interactions-Version 1.0.0-alpha05
30. Juni 2021
androidx.wear:wear-phone-interactions:1.0.0-alpha05
wird freigegeben. Version 1.0.0-alpha05 enthält diese Commits.
Fehlerkorrekturen
- Parameter, die im Konstruktor für
BridgingConfig.Builder
übergeben werden sollen, wurden dokumentiert.
Wear-Ongoing-Version 1.0.0-alpha06
2. Juni 2021
androidx.wear:wear-ongoing:1.0.0-alpha06
wird freigegeben. Version 1.0.0-alpha06 enthält diese Commits.
API-Änderungen
- Fügen Sie der laufenden Aktivität das Titelfeld hinzu. (I7a405)
Fehlerkorrekturen
SerializationHelper.copy()
erstellt jetzt eine Verteidigungskopie der Informationen (I8b276).- Verbesserte „setCategory“-Dokumentation (Iff01f)
Wear-Ongoing-Version 1.0.0-alpha05
18. Mai 2021
androidx.wear:wear-ongoing:1.0.0-alpha05
wird freigegeben. Version 1.0.0-alpha05 enthält diese Commits.
API-Änderungen
OngoingActivity
verfügt jetzt über Getter zum Abrufen aller Werte, die direkt über den Builder festgelegt wurden (oder die Standardeinstellungen aus der zugehörigen Benachrichtigung). (Id8ac8)- Mit der neuen Klasse
Status
wird nun der Status derOngoingActivity
erstellt. OngoingActivityData
undOngoingActivityStatus
gehören nicht mehr zur öffentlichen API.
- Mit der neuen Klasse
Die Klassen
TextStatusPart
undTimerStatusPart
sind nicht mehr Teil der öffentlichen API. (I57fb6)- Verwenden Sie
Status.TextPart
, um einePart
mit statischem Text zu erstellen. - Um eine
Part
mit einer Stoppuhr (zählen) zu erstellen, verwendeStatus.Stopwatch
- Um ein Gerät (
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
wird freigegeben. Version 1.0.0-alpha04 enthält diese Commits.
API-Änderungen
- In OngoingActivity heißen die Methoden fromPresentOngoingActivity jetzt WiederherstellungOngoingActivity.
- Für „OngoingActivity“ gibt es jetzt eine vollständige Reihe von Getter, die zuvor nur unter „OngoingActivityData“ verfügbar waren. (I0ee4d)
Wear-Remote-Interactions-Version 1.0.0-alpha05
21. Juli 2021
androidx.wear:wear-remote-interactions:1.0.0-alpha05
wird freigegeben. Version 1.0.0-alpha05 enthält diese Commits.
API-Änderungen
Wir haben die Klasse
RemoteIntentHelper
hinzugefügt (zuvor RemoteIntent in der Wearable-Supportbibliothek), die zum Öffnen von Intents auf anderen Geräten (z.B. von Smartwatch zu Smartphone) verwendet werden kann. (I1d7e0)Die Klasse „PlayStoreAvailability“ 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 und kein chinesisches Gerät handelt, ist der Play Store verfügbar. (Ie7dec)
Wear-Smartphone-Interactions-Version 1.0.0-alpha04
7. April 2021
androidx.wear:wear-phone-interactions:1.0.0-alpha04
wird freigegeben. Version 1.0.0-alpha04 enthält diese Commits.
API-Änderungen
- Die
ErrorCode
-Konstanten wurden aktualisiert, damit die neue Bibliothek abwärtskompatibel mit der Implementierung in der Wearable-Supportbibliothek ist.
Fehlerkorrekturen
- Die Ausnahme, die durch die neue OAuth API beim Starten einer OAuth-Sitzung verursacht wurde, wurde behoben.
Wear-Remote-Interactions-Version 1.0.0-alpha03
7. April 2021
androidx.wear:wear-remote-interactions:1.0.0-alpha03
wird freigegeben. Version 1.0.0-alpha03 enthält diese Commits.
API-Änderungen
PlayStoreAvailability
wurde in eine 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 den tatsächlichen HTML-Zeichen korrekt angezeigt wird.
Wear-Ongoing Wear-Smartphone-Interactions Version 1.0.0-alpha03
10. März 2021
androidx.wear:wear-ongoing:1.0.0-alpha03
und androidx.wear:wear-phone-interactions:1.0.0-alpha03
werden veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.
Neue Funktionen
- Migrieren Sie OAuthClient von der Wearable-Supportbibliothek zu AndroidX. 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. Es werden zusätzliche Handler und Hilfsklassen für die Kommunikation bereitgestellt.
- Laufende Aktivitäten können jetzt mithilfe des neuen OngoingActivity.Builder-Konstruktors einer Benachrichtigung mit -Tag zugeordnet werden.
API-Änderungen
- In der Bibliothek für laufende Aktivitäten (I653b4) werden jetzt Benachrichtigungs-Tags unterstützt.
- Migrieren Sie OAuthClient von der Wear-Supportbibliothek zu AndroidX und fügen Sie den Support für die OAuth-PKCE-Erweiterung hinzu (I3eaaa).
Wear-Remote-Interactions-Version 1.0.0-alpha02
10. März 2021
androidx.wear:wear-remote-interactions:1.0.0-alpha02
wird freigegeben. Version 1.0.0-alpha02 enthält diese Commits.
Neue Funktionen
- Die PlayStoreAvailability-Klasse wird von der Wearable Support Library zu AndroidX migriert. Mit einer API lässt sich prüfen, ob der Play Store auf dem Smartphone verfügbar ist.
Fehlerkorrekturen
- Die PlayStoreAvailability-Klasse wird von der Wearable Support Library zu AndroidX migriert. (I69bfe)
Version 1.0.0-alpha02
10. Februar 2021
androidx.wear:wear-ongoing:1.0.0-alpha02
und androidx.wear:wear-phone-interactions:1.0.0-alpha02
werden veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.
API-Änderungen
- Unterstützung für komplexere Statusangaben hinzugefügt. Sie bestehen aus einer oder mehreren Vorlagen und einer Reihe von Teilen, die zum Füllen der Platzhalter der Vorlage verwendet werden. OngoingActivityStatus verfügt jetzt über eine statische Methode zum Erstellen einfacher Status mit nur einem Teil (einem Text oder Timer) und über einen Builder, um komplexere Status zu erstellen. (I1fe81)
- Verschieben Sie BridgingManager- und BridgingConfig-Klassen von der Wear Support Library zu AndroidX. AndroidX bietet APIs, um Benachrichtigungen zur Laufzeit zu aktivieren/deaktivieren und optional Tags für Benachrichtigungen festzulegen, 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 der laufenden Aktivitäten zu einer neuen Unterbibliothek: Wear-ongoing. Die Kurse sind jetzt im Paket „androidx.wear.ongoing“ enthalten (bisher „androidx.wear.ongoingactivities“) (I7c029)
Eine neue Supportbibliothek mit Klassen erstellen, die Interaktionen von Wearables bis 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 zum Ermitteln des Smartphone-Typs, mit dem die aktuelle Smartwatch gekoppelt ist, nur für Wearable-Geräte. (ibd947)
Eine neue Supportbibliothek mit Klassen erstellen, die Interaktionen zwischen Wearables und Smartphones unterstützen. Sie enthält zuerst Klassen, die aus der Wearable-Supportbibliothek migriert wurden. (I9deb4)
Migriere die WatchFaceCompanion-Klasse von der Wearable-Supportbibliothek zu AndroidX. Die migrierte Klasse wurde in „WatchFaceConfigIntentHelper“ umbenannt. Sie bietet Hilfsfunktionen zum Angeben der ID und des Komponentennamens in den Konfigurationsaktivitäten für das Zifferblatt im Companion-Modus auf dem Smartphone. Sie kann auch lokal zur Konfiguration des Zifferblatts auf dem Wearable-Gerät verwendet werden. (Ia455f)
Zusatzfunktionen für Wearables und Zifferblatt 1.0.0
Version 1.0.0-alpha22
15. September 2021
androidx.wear:wear-*:1.0.0-alpha22
wird freigegeben. Version 1.0.0-alpha22 enthält diese Commits.
Neue Funktionen
- Die EditorSession abonniert jetzt Lebenszyklus-Beobachter, sodass Sie sie nicht mehr explizit schließen müssen, wenn Ihre Aktivität beendet wird.
API-Änderungen
- EditorSession und ListenableEditorSession verwenden jetzt Kotlin-StateFlows für „complicationSlotsState“, „ComplicationsPreviewData“ und „ComplicationsDataSourceInfo“. (I761d9)
- EditorSession#userStyle ist jetzt
MutableStateFlow<UserStyle>
(I32ca9) - EditorSession.createOnWatchEditorSession verwendet jetzt einen Lebenszyklus-Beobachter und wird automatisch geschlossen, wenn onDestroy erkannt wird. Außerdem muss für
createOnWatchEditorSession
jetzt nur noch die Aktivität übergeben werden. Außerdem wurden identische Änderungen auf ListenableEditorSession angewendet. (Ic6b7f) - Der Konstruktor von CustomValueUserStyleSetting wurde als Teil der öffentlichen API wiederhergestellt. (I2e69a)
UserStyle
übernimmt jetzt die Werte vonMap<UserStyleSetting, UserStyleSetting.Option>
undMutableUserStyleSetting#put
löst fügen Ausnahme 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
wird freigegeben. Version 1.0.0-alpha21 enthält diese Commits.
API-Änderungen
- Alle APIs für öffentliche Zifferblatt-, Client-, Editor- und Zusatzfunktionen verwenden jetzt java.time.Instant für Uhrzeiten statt als Long, sodass das Mindest-API-Level auf 26 erhöht wurde. (I3cd48)
- Die APIs für das Zifferblatt und die Zusatzfunktion verwenden jetzt die unveränderliche Zone „ZonedDateTime“ anstelle von Kalender. (I25cf8)
- ComplicationSlots werden jetzt mit NoDataComplicationData initialisiert, ComplicationSlot.complicationData hat jetzt immer einen Wert und CanvasComplicationDrawable.complicationData kann keine Nullwerte mehr enthalten. (I4dfd6) Dadurch wird das Flackern von Komplikationen beim Wechseln zwischen Zifferblättern reduziert. Das beseitigt diese nicht.
Version 1.0.0-alpha20
18. August 2021
androidx.wear:wear-*:1.0.0-alpha20
wird freigegeben. Version 1.0.0-alpha20 enthält diese Commits.
API-Änderungen
- ComplicationDataSourceInfo wurde „createFallbackPreviewData“ hinzugefügt, die verwendet werden kann, wenn ComplicationDataSourceInfoRetriever.retrievePreviewComplicationData null zurückgibt. (I38c4d)
- ComplicationDataSourceUpdateRequester wurde in eine Schnittstelle umgewandelt, um Mocking in Einheitentests zu ermöglichen. Sie können mit ComplicationDataSourceUpdateRequester.create() einen konkreten ComplicationDataSourceUpdateRequester erstellen. (I7da22)
- RenderParameters.endedComplicationSlotIds wurde durch RenderParameters.lastComplicationTapDownEvents ersetzt, die die neue TapEvent-Klasse zur Verfügung stellen. Diese Klasse enthält ein Dreifach von x- und y-Koordinaten für das Tippen in Pixeln sowie einen Zeitstempel. „
WatchFace.TapListener.onTap
“ wurde durch „onTapEvent(@TapType tapType: Int, tapEvent: TapEvent)
“ ersetzt. Außerdem wurdeInteractiveWatchFaceClient.displayPressedAnimation
entfernt. (Id87d2) - Explizite Threading-Anmerkung für setImportantForAccessibility (I990fa) hinzugefügt
- „ComplicationSlotBoundsType“ wurde in „wear/wear-watchface“ in „androidx-wear-watchface.ComplicationSlotBoundsType“ verschoben. (I09420)
- Die Übergabe von Zeichenfolgen-Ressourcen-IDs an UserStyleSetting und Options wurde jetzt unterstützt. Dies ist jetzt die empfohlene Methode zum Erstellen dieser Objekte. (I03d5f)
- Für die maximale Kabelgröße eines UserStyle-Schemas wurden Grenzwerte festgelegt. Symbole im Schema dürfen außerdem nicht größer als 400 x 400 Pixel sein. (I3b65b)
- Es wurde eine MutableUserStyle-Klasse hinzugefügt, um Änderungen an UserStyle-Instanzen zu unterstützen (I95a40).
ListenableWatchFaceMetadataClient.Companion#listenableCreateWatchFaceMetadataClient
wurde 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, das bei Übergabe anrenderWatchFaceToBitmap
oderPreviewScreenshotParams
das Rendering mit der Standardvorschauzeit des Zifferblatts anfordert. (If7b3c) - Wir haben UserStyleSetting-Konstruktoren, die CharSequence übernehmen, aus der öffentlichen API entfernt. Es wird empfohlen, stattdessen die Konstruktoren zu verwenden, die StringResource-IDs benötigen. (I8537b)
CurrentUserStyleRepository.UserStyleChangeListener
unterstützt jetzt SAM-Konvertierung. (I85989)
Version 1.0.0-alpha19
4. August 2021
androidx.wear:wear-*:1.0.0-alpha19
wird freigegeben. 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)- Geben Sie die Konstanten
BooleanOption.TRUE
undBooleanOption.FALSE
an und verbieten Sie das Erstellen von Instanzen (I46e09). - Methoden in wear-watchface-client, die RemoteException auslösen können, wurden nun entsprechend annotiert. (Ib8438)
- Aus Konsistenzgründen haben wir
EditorSession.createOnWatchEditingSession
increateOnWatchEditorSession
umbenannt, ähnlichcreateHeadlessEditingSession
heißt jetztcreateHeadlessEditorSession
. Auch die Guavenverpackungen wurden umbenannt. (I1526b) EditorSession
ist jetzt eine Schnittstelle undListenableEditorSession.commitChangesOnClose
wurde ordnungsgemäß delegiert. (I7dc3e)- Alle Schemas von Nutzerstilen, die Einstellungen oder Optionen mit in Konflikt stehenden IDs enthalten (Ic2715), lehnen jetzt ab.
- Wir haben ein überlastetes
UserStyle.get
hinzugefügt, dasUserStyleSetting.Id
akzeptiert. (I2aa0f)
Version 1.0.0-alpha18
21. Juli 2021
androidx.wear:wear-*:1.0.0-alpha18
wird freigegeben. Version 1.0.0-alpha18 enthält diese Commits.
API-Änderungen
ComplicationHelperActivity
wurde in die Bibliothek „androidx.wear:wear-watchface
“ verschoben. (I39e76)- Aus Gründen der Einheitlichkeit und Klarheit wurde
ComplicationProvider
inComplicationDataSource
umbenannt und alle Klassen mit „Provider“ in ihrem Namen wurden in ähnlicher Weise umbenannt. (Iaef0b) CanvasComplication.isHighlighted
wurde inRenderParameters.pressedComplicationSlotIds
verschoben. Dies ist ein Schritt hin zu einem zustandslosenCanvasComplication
. Zur Unterstützung dieser Änderung verwendetCanvasComplication.render
jetzt auchslotId
als Parameter und wir übergebenComplicationSlot
anGlesTextureComplication
. (I50e6e)- Wir haben
headlessDeviceConfig
zuEditorRequest
hinzugefügt. Wenn dieser Parameter ungleich null ist, wird er verwendet, um eine monitorlose Instanz zu erstellen, um die EditorSession zu unterstützen, anstatt auf die interaktive Instanz zu reagieren. So kann der Editor für ein anderes Zifferblatt aufgerufen werden. (I0a820) - Wir haben eine experimentelle
WatchFaceMetadataClient
hinzugefügt, mit der statische Metadaten für das Zifferblatt, z. B.UserStyleSchema
, und korrigierte Details zuComplicationSlots
effizient abgerufen werden können. I6bfdf CanvasRenderer.uiThreadInit
wurde in „init“ umbenannt. I6fff9:- Wir haben „PreviewScreenshotParams“ hinzugefügt, einen optionalen neuen Parameter für EditorRequest, mit dem EditorSession angewiesen wird, nach einem Commit mit diesem Parameter einen Vorschau-Screenshot zu erstellen. Das Vorschaubild ist auf
EditorState.previewImage
zu sehen. (Ic2c16)
Fehlerkorrekturen
- Entwickler müssen ihrem eigenen Manifest nicht mehr die Funktion „ComplicationHelperActivity“ hinzufügen. (I6f0c2)
Version 1.0.0-alpha17
30. Juni 2021
androidx.wear:wear-*:1.0.0-alpha17
wird freigegeben. Version 1.0.0-alpha17 enthält diese Commits.
Neue Funktionen
In
GlesRenderer
wurdenmakeUiThreadContextCurrent
undmakeBackgroundThreadContextCurrent
durchrunUiThreadGlCommands
undrunBackgroundThreadGlCommands
ersetzt, die beide einRunnable
akzeptieren. Die Bibliothek stellt sicher, dass jeweils nur ein ausführbarer GL-Befehl ausgeführt wird.Um die UiThread-Initialisierung zu erleichtern, haben wir
CanvasRenderer.uiThreadInit
hinzugefügt, das einmal im UiThread vor jedem Aufruf aufgerufen wird. Außerdem haben wironRendererCreated
zuCanvasComplication
hinzugefügt, damitRenderer
undCanvasComplication
den Status einfacher teilen können.Zur Klarstellung sei erwähnt, dass wir
Complication
inComplicationSlot
undcomplicationId
je nach Nutzung entweder incomplicationSlotId
odercomplicationInstanceId
umbenannt haben
API-Änderungen
- Zur Klarstellung sei erwähnt, dass wir
Complication
inComplicationSlot
undcomplicationId
je nach Nutzung entweder incomplicationSlotId
odercomplicationInstanceId
umbenannt haben. Klassen, die Complication verwenden, wurden in ähnlicher Weise umbenannt. Der Name ComplicationsManager heißt jetzt ComplicationSlotsManager. (I4da44) - In GlesRenderer wurden
makeUiThreadContextCurrent
undmakeBackgroundThreadContextCurrent
durchrunUiThreadGlCommands
undrunBackgroundThreadGlCommands
ersetzt. Beide akzeptierenRunnable
. Diese Funktionen werden nur benötigt, wenn Sie GL-Aufrufe außerhalb des Renderings, vonrunBackgroundThreadGlCommands
undonUiThreadGlSurfaceCreated
ausführen müssen. Dies ist erforderlich, da es mehrere GlesRenderer mit jeweils einem eigenen Kontext im selben Prozess geben kann, möglicherweise von verschiedenen Zifferblättern. Außerdem wird jetzt der Zugriff auf den freigegebenen aktuellen GL-Kontext synchronisiert. (I04d59) - Wir haben
CanvasRenderer.uiThreadInit
hinzugefügt, das einmal auf dem UiThread vor jedem Aufruf zum Rendering aufgerufen wird. Zur Verdeutlichung haben wir in GlesRenderer außerdemonGlContextCreated
inonBackgroundThreadGlContextCreated
undonGlSurfaceCreated
inonUiThreadGlSurfaceCreated
umbenannt. (If86d0) HeadlessWatchFaceClient
undInteractiveWatchFaceClient
getComplicationsSlotState
wurden ingetComplicationSlotsState
umbenannt. InComplicationSlot
wurdencreateRoundRectComplicationBuilder
,createBackgroundComplicationBuilder
undcreateEdgeComplicationBuilder
increateRoundRectComplicationSlotBuilder
,createBackgroundComplicationSlotBuilder
bzw.createEdgeComplicationSlotBuilder
umbenannt. (Ib9adc)- Wir haben onRendererCreated zu CanvasComplication hinzugefügt, damit Renderer und CanvasComplication den Status einfacher teilen können. (I5e1ac)
Version 1.0.0-alpha16
16. Juni 2021
androidx.wear:wear-*:1.0.0-alpha16
wird freigegeben. 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 andere Probleme mit dem Editor für Zifferblatt behoben.
Fehlerkorrekturen
- NPE in
onComplicationProviderChooserResult
verhindern (b/189594557) - Probleme mit veralteten Oberflächen unddrawBlack beheben (b/189452267)
- Fehler beim Zugriff auf
complicationsManager.watchState
beheben (b/189457893) - Fehler in Bezug auf die Lebensdauer des Hintergrundthreads beheben (b/189445428)
- Probleme mit dem Zifferblatt-Editor vor der R-Version beheben (b/189126313)
- Keine direkten Bootparameter für Änderungen des Editor-Stils aktualisieren (b/187177307)
Version 1.0.0-alpha15
2. Juni 2021
androidx.wear:wear-*:1.0.0-alpha15
wird freigegeben. Version 1.0.0-alpha15 enthält diese Commits.
Neue Funktionen
Der Großteil der Zifferblattinitialisierung wird jetzt in einem Hintergrundthread durchgeführt. Nachdem das Zifferblatt gerendert wurde, wird dies auf dem UiThread ausgeführt. Es gibt eine Gedächtnisbarriere zwischen Laden und Rendern, sodass die meisten Zifferblätter nichts Besonderes tun müssen. Zifferblätter mit GLES können eine Ausnahme sein, da der Kontext Thread-spezifisch ist und wir zwei verknüpfte Kontexte erstellen, sodass es möglich ist, GL-Ressourcen (z.B. Texturen und Shader) in den Hintergrundthread hochzuladen und im 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 das Laden von Assets mit createWatchFace einige Zeit in Anspruch nehmen kann. Aus diesem Grund haben wir WatchFaceControlClient.getDefaultProviderPoliciesAndType
eingeführt, das eine Zuordnung von Complication-IDs zu DefaultComplicationProviderPolicies und dem Standard-ComplicationType zurückgibt. Dies ist schneller als das Erstellen einer monitorlosen Instanz, da das Zifferblatt zum Ausführen der Abfrage nicht vollständig initialisiert werden muss.
Die Zusatzfunktionen werden 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, das eine Zuordnung von Komplikations-IDs zu DefaultComplicationProviderPolicies und dem Standard-ComplicationType zurückgibt. Wenn möglich, wird ein schneller Weg verwendet, um das vollständige Erstellen eines Zifferblatts zu vermeiden. Um dies zu erleichtern, musste die WatchFaceService API um zwei neue Methoden erweitert werden: createUserStyleSchema und createComplicationsManager. Die Ergebnisse werden an createWatchFace übergeben. Außerdem werden jetzt Komplikationen mit einer CanvasComplicationFactory erstellt, die eine lazy Konstruktion der CanvasComplication-Renderer ermöglicht. (Iad6c1) - Wir haben NEXT_LET_APP aus SystemProviders entfernt. (I3df00)
- ObservableWatchData ist jetzt eine versiegelte Klasse. (Ic940d)
- CanvasComplicationFactory.create (in der Regel an io gebunden) wird jetzt für jede Zusatzfunktion in einem Hintergrundthread aufgerufen, bevor der UI-Thread gerendert wird. Es gibt eine Speicherbarriere zwischen Konstruktion und Rendering, sodass keine speziellen Threading-Primitive erforderlich sind. (Ia18f2)
- Das Zifferblatt wird jetzt in einem Hintergrundthread erstellt, obwohl das Rendering im UI-Thread erfolgt. GlesRenderer unterstützt dies jedoch in zwei verknüpften Kontexten. WatchFaceControlClient.createHeadlessWatchFaceClient und WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient können möglicherweise aufgelöst werden, bevor „WatchFaceService.createWatchFace“ abgeschlossen ist. Nachfolgende API-Aufrufe werden blockiert, bis die Smartwatch-Initialisierung abgeschlossen ist. (Id9f41)
- EXPANSION_DP und STROKE_WIDTH_DP sind in api.txt nicht mehr sichtbar. (I54801)
- Wir haben EditorSession.createOnWatchEditingSession so konfiguriert, dass TimeoutDeletionException ausgelöst wird, wenn anstelle des Sendens einer Null-Sitzung 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
wird freigegeben. Version 1.0.0-alpha14 enthält diese Commits.
Neue Funktionen
EditorSession.openComplicationProviderChooser
gibt jetzt ChosenComplicationProvider zurück, der die Zusatzfunktions-ID,ComplicationProviderInfo
und ein Bundle mit zusätzlichen Extras enthält, die von der Anbieterauswahl zurückgegeben werden.- Darüber hinaus haben wir kontinuierlich Code zu Kotlin migriert und der Großteil der Watch Face API ist jetzt in Kotlin definiert.
API-Änderungen
- Die GlesRenderer-Eigenschaften
eglContext
undeglDisplay
dürfen jetzt keine Nullwerte enthalten. GL-Fehler werden jetzt überGlesRenderer.GlesException
und nicht mehr über RuntimeExceptions gemeldet. (Ib1005) androidx.wear.watchface.complications.rendering.ComplicationDrawable
wurde von Java zu Kotlin migriert (Ibc3eb).- Wir haben
androidx.wear.watchface.complications.rendering.ComplicationStyle
von Java zu Kotlin migriert (I3375e). - Wir haben für jede Zusatzfunktion in EditorSession Informationen zum jeweiligen Anbieter hinzugefügt. (I37f14)
- Wir haben das Ergebnis von
EditorSession.openComplicationProviderChooser
um Informationen erweitert, die von den ausgewählten Nutzern zurückgegeben wurden. (Iead6d)
Wear-Zusatzfunktionen und Zifferblatt-Version 1.0.0-alpha13
5. Mai 2021
androidx.wear:wear-*:1.0.0-alpha13
wird freigegeben. Version 1.0.0-alpha13 enthält diese Commits.
Neue Funktionen
Zifferblätter können neben der Uhrzeit und Zusatzfunktionen wichtige visuelle Elemente enthalten. Damit Screenreader dies unterstützen können, kann das Zifferblatt jetzt über die Eigenschaft „additionalContentDescriptionLabels“ des Renderers „ContentDescriptionLabels“ für Bedienungshilfen angeben. Um die Reihenfolge von ContentDescriptionLabels zu steuern, wurde „AccessibilityTraversalIndex“ zu Zusatzfunktionen hinzugefügt. Dies kann durch eine „ComplicationsUserStyleSetting“ geändert werden.
Um Entwickler zu ermutigen, Screenreader sorgfältig zu verwenden, haben wir die Übergabe der Felder
contentDescription
vonShortTextComplicationData.Builder
,LongTextComplicationData.Builder
undRangedValueComplicationData.Builder
als obligatorisch an ihre Konstruktoren vorgenommen. WennComplicationText.EMPTY
fürcontentDescription
übergeben wird, wird automatisch eincontentDescription
aus Text und Titel generiert.WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient
gibt jetztServiceStartFailureException
aus, wenn das Zifferblatt während der Init-Methode eine Ausnahme ausgibt. Dies vereinfacht die Diagnose von Problemen beim Start des Zifferblatts viel einfacher.
API-Änderungen
- In ComplicationProviderInfo kann jetzt ein Null-Komponentenname angegeben werden. Dieser ist erforderlich, um ältere Versionen von Wear OS zu unterstützen. (I744d2)
androidx.wear.complications.SystemProviders
wurde von Java zu Kotlin migriert. (Ia1f8b)- Wir haben alle Klassen in der öffentlichen API ausgeblendet, die sich in „android.support.wearable.complications“ befinden, und bei Bedarf entsprechende Wrapper in AndroidX erstellt. (I7bd50)
- Die Methode in
TimeDifferenceComplicationText.Builder
wurde vonsetMinimumUnit
insetMinimalTimeUnit
umbenannt. (I20c64) - Das Feld
contentDescription
vonShortTextComplicationData.Builder
,LongTextComplicationData.Builder
undRangedValueComplicationData.Builder
muss im Konstruktor übergeben werden. (I8cb69) - Wir haben „ComplicationProviderService.onComplicationUpdate“ in onComplicationRequest umbenannt und den eingekapselten ID- und Typparameter dieser Methode in Data ComplicationRequest angegeben. Der entsprechende Listener wurde in ComplicationRequestListener und seine Methode ComplicationRequestListener.onComplicationData umbenannt. (Iaf146)
- Wir haben die Methode
isActiveAt
ausComplicationData
entfernt und stattdessen das FeldvalidTimeRange
verfügbar gemacht. Dieser Methodenaufruf kann durchvalidTimeRange.contains
ersetzt werden. (I65936) - Wir haben die Beschreibung der Methode „ComplicationProviderService.onComplicationAktiv“ geändert, sodass anstelle einer Ganzzahl ein ComplicationType wird (Idb5ff)
- ProviderUpdateRequester wurde von Java zu Koltin migriert. (Ibce13)
- GlesRender.makeContextCurrent ist jetzt öffentlich. Der Code des Zifferblatts muss möglicherweise gl-Aufrufe außerhalb des Renderings und von „onGlContextCreated“ ausführen. Dafür ist möglicherweise sowohl ein interaktiver als auch ein monitorloser Kontext erforderlich. (I8a43c)
- WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient wirft jetzt ServiceStartFailureException ab, wenn das Zifferblatt während der Init-Methode ausgelöst wird. Außerdem gibt 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 „ContentDescriptionLabels“ für Bedienungshilfen über die Property „additionalContentDescriptionLabels“ des
Renderer
s angegeben werden. Zusätzlich zur Kontrolle der Reihenfolge von ContentDescriptionLabels wurde der AccessibilityTraversalIndex zu den Zusatzfunktionen hinzugefügt. Dies kann durch eine „ComplicationsUserStyleSetting“ geändert werden. (Ib7362) - Maximieren Sie die Dokumentation zum Umgang mit Touch-Ereignissen im Zifferblatt. (Iaf31e)
Fehlerkorrekturen
EditorSession.getComplicationsPreviewData()
gibt jetzt eine Map für alle eher nur nicht leeren Komplikationen zurück. Eine Instanz von „EmptyComplicationData“ wird für leere Zusatzfunktionen verwendet. (I1ef7e)
Wear-Zusatzfunktionen und Zifferblatt-Version 1.0.0-alpha12
21. April 2021
androidx.wear:wear-*:1.0.0-alpha12
wird freigegeben. Version 1.0.0-alpha12 enthält diese Commits.
Neue Funktionen
Bearbeiter müssen bestimmte Teile des Zifferblatts hervorheben, um besser erkennen zu können, welcher Aspekt einer Uhr konfiguriert wird. Wir haben die RenderParameters erweitert, sodass Stile und Zusatzfunktionen hervorgehoben werden können. Es gibt ein neues optionales HighlightLayer-Element, das auf dem Zifferblatt mit Alpha-Transparenz mattiert werden soll. Die Screenshot-API können diese Maskierung für Sie übernehmen oder HighlightLayer allein für maximale Flexibilität bereitstellen. Angenommen, Sie haben einen Stil, mit dem Sie das Erscheinungsbild der Uhranzeige konfigurieren können, kann der Renderer in seinem renderHighlightLayer einen Umriss um die Zeiger ziehen.
Um die Unterstützung von Komplikationsanbietern für die Barrierefreiheit zu fördern, haben wir das contentDescription-Feld von PhotoImageComplicationData.Builder, MonochromaticImageComplicationData.Builder und SmallImageComplicationData.Builder in ein obligatorisches Konstruktorargument umgewandelt. ComplicationTapFilter und Complication.createEdgeComplicationBuilder wurden zur Unterstützung von Edge-Zusatzfunktionen hinzugefügt, die am Rand des Bildschirms gezeichnet werden. Das Rendern und die Treffertests für Edge-Zusatzfunktionen sind auf dem Zifferblatt überlassen. Edge-Treffertests werden vom Companion-Editor nicht unterstützt.
API-Änderungen
- Den Konstanten in SystemProviders wurde das Präfix
PROVIDER_
hinzugefügt. (I1e773) - Das Feld
contentDescription
vonPhotoImageComplicationData.Builder
,MonochromaticImageComplicationData.Builder
undSmallImageComplicationData.Builder
muss im Konstruktor übergeben werden. (I9643a) ProviderInfoRetriever.requestPreviewComplicationData
wurde inretrievePreviewComplicationData
umbenannt. (I911ee)ComplicationProviderService
von Java nach Koltin migriert. (I849f2)- Methode
ComplicationProviderService.onBind
ist jetzt endgültig (I39af5) - Wir haben die Oberfläche
CanvasComplication
reaktiviert undCanvasComplicaitonDrawable
,GlesTextureComplication
undComplicationHighlightRenderer
nachwear-watchface-complications-rendering
verschoben. (I84670) RenderParameters
wurde refaktoriert, um ein erweitertes Rendering von Markierungen zu unterstützen. Es ist jetzt möglich, das Rendern von Highlights für Stile sowie für alle oder einzelne Zusatzfunktionen anzufordern. Darüber hinaus verfügen CanvasRenderer und GlesRenderer über eine neue abstrakte renderHighlightLayer-Methode zum Rendern von vom Editor angeforderten Markierungen. Die Ebene wurde in „WatchFaceLayer“ umbenannt. (Ic2444)ComplicationTapFilter
undComplication.createEdgeComplicationBuilder
wurden hinzugefügt, um Edge-Zusatzfunktionen zu unterstützen. Das Rendern und die Treffertests für Edge-Zusatzfunktionen sind auf dem Zifferblatt überlassen. Treffertests werden in Editoren nicht unterstützt. (Ia6604)- Für
DoubleRangeUserStyleSetting
undLongRangeUserStyleSetting
:defaultValue
,maximumValue
undminimumValue
sind jetzt Kotlin-Properties. Darüber hinaus wurdenUserStyleSetting.Option
-Funktionen wie toBoolesche Option, toCoplicationOptions, toListOption und ähnliche entfernt. (I52899) - Fügen Sie die Kinngröße zu den Eigenschaften des für das Zifferblatt verfügbaren Geräts 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
wird freigegeben. Version 1.0.0-alpha11 enthält diese Commits.
Neue Funktionen
- Die APIs für das Zifferblatt wurden überarbeitet. Die meisten Änderungen betreffen einfache Umbenennungen.
InteractiveWatchFaceWcsClient
undInteractiveWatchFaceSysUiClient
wurden jedoch zuInteractiveWatchFaceClient
zusammengeführt.
API-Änderungen
- „ContentDescriptionLabel.text“ ist jetzt ein „ComplicationText“ anstelle der alten Wearable-Supportbibliothek „TimeDependentText“. (I80c03)
- Es kann nicht garantiert werden, dass
SystemProviders.GOOGLE_PAY
auf allen Android R-Geräten vorhanden ist. Daher wurde es aus der Liste entfernt. Du kannst diesen Anbieter weiterhin überDefaultComplicationProviderPolicy
(If01b5) verwenden - Aus Konsistenzgründen haben wir „ComplicationUpdateCallback“ in „ComplicationUpdateListener“ umbenannt. (I61ec7)
- Die Karte für das UserStyle-Kabelformat wurde in
Map<String, byte[]>
geändert. Der Einfachheit halber wurde der öffentlichen API eineUserStyleData
-Klasse hinzugefügt, die jetzt von wear-watchface-client und wear-watchface-editor verwendet wird. Außerdem ist „CustomValueUserStyleSetting.CustomValueOption.value“ jetztbyte[]
stattString
. (Iaa103) UserStyleSetting
undUserStyleSetting.Option
verwenden jetztUserStyleSetting.Id
bzw.UserStyleSetting.Option.Id
zum Speichern ihrer IDs anstelle eines Strings. (I63f72)InteractiveWatchFaceClient.SystemState
wurde inWatchUiState
umbenannt. (I6a4e0)InteractiveWatchFaceWcsClient
undInteractiveWatchFaceSysUiClient
wurden zusammengeführt, weil es schwierig war, die Aufteilung der Verantwortung zu erklären (Iff3fa).- Die „enum“-Werte von Ebenen wurden zur Verdeutlichung umbenannt.
Layer#TOP_LAYER
ist jetztLayer#COMPLICATIONS_OVERLAY
undLayer#BASE_LAYER
ist jetztLayer#BASE
(Ia144e) UserStyleListener
wurde inUserStyleChangeListener
(I18524) umbenanntUserStyleRepository
wurde inCurrentUserStyleRepository
(I6ea53) umbenanntInteractiveWatchFaceWcsClient.updateInstance
wurde inupdateWatchfaceInstance
umbenannt. (I321dc)- WatchFace TapType-Ereignisse wurden umbenannt, um sie an „MotionEvents“ und „Compose“ anzupassen. I0dfd0
- TakeWatchfaceScreenshot wurde in „renderWatchFaceToBitmap“ umbenannt, „takeComplicationScreenshot“ in „renderComplicationToBitmap“ (Ie0697).
- Die Oberfläche „CanvasComplication“ wurde zugunsten der offenen Klasse „CanvasComplicationDrawable“ entfernt. I1f81f.
WatcfaceControlServiceFactory
wurde aus der öffentlichen API entfernt. (I1f8d3)CanvasComplication.setData
wurde inCanvasComplication.loadData
umbenannt. (If1239)ComplicationsManager.bringAttentionToComplication
wurde indisplayPressedAnimation
umbenannt. (Ic4297)WatchFaceService.createWatchFace
hat jetzt die Anmerkung@UiThread
. (Ib54c2)- Der Name eines „CanvasComplicationDrawable“-Parameters wurde geändert, um einen Fehler zu beheben. (I50dac)
- Wir haben
HeadlessWatchFaceClient.toBundle()
undHeadlessWatchFaceClient.createFromBundle
hinzugefügt, damit das Senden vonHeadlessWatchFaceClient
über AIDL unterstützt wird. (I07c35) - „HeadlessWatchFaceClient“ und „InteractiveWatchFaceClient“ verfügen jetzt über „ClientConnectionListener“ und „isConnectionAlive()“, damit Sie beobachten können, ob die Verbindung aus irgendeinem Grund unterbrochen wurde (z.B. weil das Zifferblatt abgebrochen wird). (Ie446d)
- „
WatchFaceControlClient#getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClientAsync
“ ist jetzt eine Sperrfunktion und wurde in „getOrCreateInteractiveWatchFaceClient
“ umbenannt. (Ib745d) EditorState.commitChanges
undhasCommitChanges()
wurden inshouldCommitChanges()
umbenannt. (I06e04)previewComplicationData
wurde inpreviewComplicationsData
umbenannt, um anzugeben, dass es normalerweise mehr als eine Zusatzfunktion auf der Karte gibt. (I56c06)InteractiveWatchFaceWcsClient.bringAttentionToComplication
wurde aus Gründen der Übereinstimmung mitComplicationsManager.displayPressedAnimation
indisplayPressedAnimation
umbenannt. (Ic9999)- Alle Instanzen der Watchface-Instanz-ID wurden in eine neue WatchFaceId-Klasse (I45fdf) eingekapselt.
- Die Property
complicationState
wurde incomplicationsState
umbenannt, um die Pluralität anzugeben. (Ided07) - Wir haben die verschiedenen „Wear-Watchface-Client Binder“-Conversions entfernt. Diese sollten erforderlich sein. (Icc4c0)
- Aus Konsistenzgründen wurde
EditorServiceClient
refaktoriert, um Listener anstelle von Beobachtern zu verwenden. (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 darf keine Nullwerte mehr enthalten. (Id52bb)
EditorSession.launchComplicationProviderChooser
wurde inopenComplicationProviderChooser
umbenannt. (I9d441)- „
EditorSession.createOnWatchEditingSessionAsync
“ wurde in „createOnWatchEditingSession
“ umbenannt und ist jetzt eine Funktion zum Anhalten. (Id257b) - Es wurden mehrere fehlende
@UiThread
-Annotationen 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
wird freigegeben. 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 in createWatchFace ausgeführt werden kann.
API-Änderungen
IdAndComplicationData
war etwas umständlich und wurde aus der öffentlichen API entfernt. Die Klassen und Schnittstellen, in denen sie verwendet wurden, wurden refaktoriert. (I4c928)- Wir haben
ReferenceTime
durchCountUpTimeReference
undCountDownTimeReference
ersetzt. Diese sind selbsterklärlicher. (Ib66c6) - Es wurden einige fehlende
@Px
- und@ColorInt
-Anmerkungen hinzugefügt. (I9bbc3) Complication.complicationConfigExtras
kann jetzt keine Nullwerte mehr hinzufügen und ist standardmäßig aufBundle.EMPTY
gesetzt. (Iad04f)GlesRenderer
erfordert jetzt, dass Sie nach der BaustelleinitOpenGLContext
aufrufen. Diese Funktion war ein internes Detail, ist jetzt aber in der öffentlichen API verfügbar, um GL-Aufrufe früher in createWatchFace zu ermöglichen. (I726c2)- Wir haben „
Complication.setRenderer
“ entfernt, da sie nicht benötigt werden sollte. (Ie992f) Complicaiton.setComplicationBounds
gehört nicht mehr zur öffentlichen API. Wenn du die Position einer Zusatzfunktion ändern möchtest, kannst du das überComplicationsUserStyleSetting
tun. (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
werden veröffentlicht. Version 1.0.0-alpha09 enthält diese Commits.
Neue Funktionen
- Die Schnittstelle zwischen WCS/SysUI-Host und dem Zifferblatt hat sich weiterentwickelt. Ein Bearbeiter kann jetzt feststellen, ob durch eine Stiländerung eine Zusatzfunktion aktiviert oder deaktiviert wird (aktiviert = initialEnabled plus jeder Überschreibung von „ComplicationsUserStyleSetting“).
EditorService.closeEditor
ermöglicht es SysUI außerdem, bei Bedarf einen Editor für Zifferblatt per Fernzugriff zu schließen. - Zusätzlich
InteractiveWatchFaceWcsClient.setUserStyle
mit dem leistungsstärkeren BefehlupdateInstance
, der: die Instanz-ID ändert, den Stil festlegt und Zusatzfunktionen auf einmal löscht.
API-Änderungen
- TraceEvents wurde den Zifferblattbibliotheken hinzugefügt. (I1a141)
ComplicationState
hat jetzt die neue EigenschaftinitiallyEnabled
, mit der sich die Auswirkungen von Stiländerungen vorhersagen lassen. (I8c905)- Wir haben
InteractiveWatchFaceWcsClient.setUserStyle
durch einen leistungsstärkeren BefehlupdateInstance
ersetzt, der Folgendes ermöglicht: ändert die Instanz-ID, legt den Stil fest und löscht Zusatzfunktionen. (Ife6f6) - Die Screenshot-APIs von WatchFaceClient komprimieren nicht mehr die Screenshots, da dies zu langsam war. Stattdessen überlassen wir die Nachbearbeitung dem Aufrufer. (Id35af)
- Es ist jetzt möglich, einen Editor für Zifferblatt per Fernzugriff ü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
wird freigegeben. Version 1.0.0-alpha08 enthält diese Commits.
Neue Funktionen
- Einige Zifferblätter wurden um eine oder mehrere Zusatzfunktionen gestaltet. Um dies zu unterstützen, haben wir „Complication.Builder#setFixedComplicationProvider“ hinzugefügt, die bei der Einstellung „true“ verhindert, dass der Nutzer die Zusatzfunktion in diesem Slot ändert.
- Die Zifferblattbibliotheken basieren zuerst auf Kotlin und verwenden Koroutinen (z.B. Anhalten-Funktionen). Für Java-Nutzer haben wir ListenableFuture-Wrapper bereitgestellt, um die Interoperabilität in den folgenden Bibliotheken zu verbessern: wear/wear-watchface-guava, wear/wear-watchface-client-guava und wear/wear-watchface-editor-guava.
API-Änderungen
- Wir haben die Unterstützung für das Doppeltippen auf Zusatzfunktionen eingestellt, bei denen die Anbieterauswahl eingeführt wurde. Diese Funktion war bei Zifferblättern eher selten und hat die Implementierung der SysUI komplizierter gemacht. (I3ef24)
- ProviderInfoRetriever-Methoden können ServiceSeparatedException auslösen, wenn das Binder unerwartet geschlossen wird. (Ib2cc4)
- Ab Android 11 gibt es Einschränkungen dafür, wann der Provider Chooser ausgeführt werden kann. Außerdem möchten wir, dass Editoren mit dem neuen
wear-watchface-editor
erstellt werden, damit ComplicationHelperActivity aus der öffentlichen API entfernt wird. (Ib19c1) - Entfernen Sie die statischen ComplicationText-Methoden zugunsten von Buildern. (Ibe399)
- Wir haben guava ListenableFuture-Wrapper für die verschiedenen Methoden zum Sperren der Zifferblattbibliothek eingeführt. (I16b2c)
- Zur besseren Übersichtlichkeit der API haben wir RenderParameters einen sekundären Konstruktor hinzugefügt, der zur Verwendung mit anderen LayerModes als
LayerMode.DRAW_OUTLINED
keine Tönung erfordert. (I497ea) - Bisher hatte sich ListUserStyleSetting durch ein Standardargument von der anderen unterscheidet. Jetzt übernehmen alle Konstruktoren der Unterklasse StyleSetting den Standardwert zuletzt. I9dbfd.
- CanvasComplication wurde refaktoriert, um eine versteckte Methode zu verwenden, was die Implementierung einer Unterklasse vereinfacht (I5b321).
- Wir haben EditorResult refaktoriert zu einem neuen EditorService und
EditorSession.broadcastState()
zum Streamen von Updates an einen Beobachter (üblicherweise SysUI). (Ic4370) - Einige Zifferblätter sind um eine bestimmte Zusatzfunktion als fester Bestandteil des Zifferblatts aufgebaut, wobei der Anbieter nicht vom Nutzer konfiguriert werden kann. Um dies zu unterstützen, haben wir
Complication.Builder#setFixedComplicationProvider
hinzugefügt. (I4509e) - EditorRequest gibt jetzt anstelle von ComponentName den Paketnamen an, da es für SysUI umständlich war, den Klassennamen des Editors zu suchen, und wir wirklich nur den Paketnamen benötigen. (Ib6814)
Version 1.0.0-alpha07
10. Februar 2021
androidx.wear:wear-*:1.0.0-alpha07
wird freigegeben. 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 eine E/A gewartet wird. Ähnlich wie Wearable-Zifferblatt-Editor und Wear-Zusatzfunktionen
API-Änderungen
- PhotoImage-Klasse entfernen und Symbol direkt verwenden. (I8a70b)
- Machen Sie den Parameter „validTimeRange“ von „ComplicationData“ verfügbar. (I91366)
- Machen Sie bildähnliche Attribute expliziter. (I81700)
- Die Daten zu wear-watchface-editor und wear-complications wurden refaktoriert, um Sperrenfunktionen anstelle von Koroutinen zu verwenden. Zu befolgende Rx-Java- und Future-Compat-Wrapper. (If3c5f)
- ProviderInfoRetriever wirft jetzt PreviewNotAvailableException ab, wenn requestPreviewComplicationData aufgrund von Verbindungsproblemen oder fehlender API-Unterstützung keine Vorschaudaten zurückgeben kann. (I4964d)
- WatchFaceControlService::createWatchFaceControlClient ist jetzt eine ausgesetzte Funktion. getOrCreateHintergründeServiceBackedInteractiveWatchFaceWcsClient heißt jetzt getOrCreateHintergründeServiceBackedInteractiveWatchFaceWcsClientAsync und gibt
Deferred<InteractiveWatchFaceWcsClient>
zurück. RX-Java- und Future-Compat-Wrapper, denen gefolgt werden soll. (I5d461) - Benennen Sie
CATEGORY_PROVIDER_CONFIG_ACTION
inCATEGORY_PROVIDER_CONFIG
um. (I7c068) - Bitte beachte, dass „createOnWatchEditingSession“ jetzt eine ausgesetzte Funktion ist, da das Zifferblatt manchmal erst kurz nach Beginn der Editoraktivität verfügbar ist. (Ida9aa)
- WatchFaceService.createWatchFace ist jetzt eine Sperrfunktion, die eine asynchrone Initialisierung ermöglicht, da zuvor der Hauptthread blockiert werden musste. (If076a)
- UserStyle verfügt jetzt über einen Array-Operator und UserStyle.Option wurden Umwandlungshilfen hinzugefügt. (I35036)
- Wir haben einen Marshalling-Fehler behoben, bei dem UserStyle-Wireframes einige der instabilen, versteckten APIs veränderten. (I8be09)
- Mit CustomValueUserStyleSetting können Sie eine einzelne anwendungsspezifische Zeichenfolge innerhalb eines UserStyle speichern. Die Standardeditoren für das Zifferblatt ignorieren diesen Wert. (Ic04d2)
- InstanceID wird in den Intent-Extras für R und ältere Versionen von Android WearOS, die nicht aktualisiert werden können, nicht übergeben. Um dies zu unterstützen, darf die InstancID jetzt null sein. (Id8b78)
- EditorRequest enthält jetzt den Editor ComponentName, der als Komponente in WatchFaceEditorContract.createIntent (I3cd06) festgelegt ist.
- „EditorResult“ für das Zifferblatt enthält jetzt eine Vorschau „ComplicationData“, mit der Anrufer nach der Bearbeitung einen Screenshot des Zifferblatts machen können. (I2c561)
Fehlerkorrekturen
- Hinzufügung von toString()-Überschreibungen zu UserStyle, UserStyleSetting und UserStyleSchema, wodurch die Arbeit mit diesen Klassen etwas einfacher wird. (I9f5ec)
Version 1.0.0-alpha06
27. Januar 2021
androidx.wear:wear-*:1.0.0-alpha06
wird freigegeben. Version 1.0.0-alpha06 enthält diese Commits.
Neue Funktionen
- Wir haben eine neue Bibliothek für Wear & Wear-Zifferblatt-Editor eingeführt, mit der Zifferblattentwickler und möglicherweise OEMs einen Editor für Stil und Zusatzfunktionen erstellen können. SysUI sendet einen Intent an das Zifferblatt, der die neue EditorSession-Klasse verwendet, um auf WatchFace-Details zuzugreifen und das Ergebnis über Activity.setWatchRequestResult aufzuzeichnen. Um dies zu unterstützen, haben wir ProviderInfoRetriever.requestPreviewComplicationData hinzugefügt, mit der Zifferblatt-Editoren eine Vorschau von ComplicationData anfordern können. Der Vorteil von ComplicationData in der Vorschau ist im Gegensatz zu Live-Daten, dass beim Rendern des Editors keine Berechtigungsdialogfelder angezeigt werden müssen. Hinweis: Wenn ein Nutzer einen Anbieter mit einer Berechtigung auswählt, wird er dennoch aufgefordert, die Berechtigung zu erteilen.
API-Änderungen
- „ComplicationProviderInfo“ hat jetzt ein Feld für den „ComponentName“ des Anbieters. Dieses Feld wird Wear OS später unterstützt. Bis dahin ist es null. (Id8fc4)
- Wir haben ProviderInfoRetriever.requestPreviewComplicationData hinzugefügt, mit der Zifferblatt-Editoren eine Vorschau von ComplicationData anfordern können. Das ist nützlich, da 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. Wenn das Set mit dem Intent zusammengeführt wird, der gesendet wird, um die Aktivität zur Anbieterauswahl zu starten. (Ifd4ad)
- Wir haben eine neue
wear-watchface-editor
-Bibliothek hinzugefügt, die auf Zifferblatt- und SysUi-Editoren unterstützt wird. SysUI startet diese Editoren durch Senden eines Intents. Der Dienst für Zifferblatt-Aktivitäten kann mit der neuen EditorSession-Klasse auf WatchFace-Details zugreifen und das Ergebnis über Activity.setWatchRequestResult aufzeichnen. (I2110d) - „LayerMode.DRAW_HIGHLIGHTED“ heißt jetzt „LayerMode.DRAW_OUTLINED“ und „RenderParameters.highlightComplicationId“ heißt jetzt „RenderParameters.selectedComplicationId“. Damit wird neben einem Umriss eine Hervorhebung der angegebenen Zusatzfunktion dargestellt. (I90a40)
- Die Zukunft von WatchFaceControlClient.getOrCreateHintergründeServiceBackedInteractiveWatchFaceWcsClient kann jetzt mit einer ServiceStartFailureException aufgelöst werden, wenn der Dienst während der 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
wird freigegeben. Version 1.0.0-alpha05 enthält diese Commits.
Neue Funktionen
Zifferblätter unterstützen oft eine Reihe von Konfigurationen für Zusatzfunktionen, wobei unterschiedlich viele angezeigt werden. Um die Einrichtung zu vereinfachen, unterstützen wir jetzt standardmäßig deaktivierte Zusatzfunktionen, indem wir für den Builder setEnabled(false) aufrufen. Diese können später über „ComplicationsUserStyleSetting“ aktiviert werden.
API-Änderungen
- Für die Funktion „ComplicationHelperActivity“ wird jetzt
Collection<ComplicationType>
anstelle eines int-Arrays akzeptiert, was die Verwendung vereinfacht. (I1f13d) ProviderInfoRetriever.retrieveProviderInfo
gibt jetzt korrektListenableFuture<ProviderInfo[]>
zurück. (If2710)- Sie können jetzt eine anfänglich deaktivierte Zusatzfunktion erstellen, indem Sie „setEnabled(false)“ für den Builder aufrufen. (Idaa53)
- WatchFaceState verfügt jetzt über eine isHeadless-Eigenschaft, die nur für monitorlose Instanzen gilt. (Ifa900)
- „ComplicationDrawable“ unterstützt jetzt optional das synchrone Laden von Drawables. Diese wird von den Screenshot APIs verwendet. (I34d4a)
Version 1.0.0-alpha04
16. Dezember 2020
androidx.wear:wear-*:1.0.0-alpha04
wird freigegeben. Version 1.0.0-alpha04 enthält diese Commits.
Neue Funktionen
- Die Wear-Zifferblatt-Bibliothek unterstützt jetzt das Festlegen von Grenzen pro Typ. So können Sie beispielsweise für ComplicationType.LONG_TEXT zu einem breiten Begrenzungsrahmen wechseln und für andere Typen einen kleineren Begrenzungsrahmen verwenden.
API-Änderungen
- Für Komplikationen wird jetzt „ComplicationBounds“ verwendet, die ein
Map<ComplicationType, RectF>
umschließt, um Größen von Komplikationstypen zu unterstützen. (I1ebe7) - Mit RenderParameters können Sie jetzt die Hervorhebungsfarbe für Screenshots angeben. (Iff42b)
- Mit Ausnahme von Grenzen müssen Sie jetzt „ComplicationsUserStyleSetting“ verwenden, um Zusatzfunktionen zu ändern, um sicherzustellen, dass das Betriebssystem synchron bleibt. I8dc5d
- Renderer ist jetzt eine versiegelte Klasse. Das bedeutet, dass CanvasRenderer und GlesRenderer jetzt interne Klassen von Renderer sind. (Iab5d4, b/173803230)
- „CanvasComplicationDrawable.drawHighlight“ wurde in „drawOutline“ umbenannt. Für ObservableWatchData fehlen jetzt einige UiThread-Annotationen. „ScreenState“ wurde vollständig aus „WatchState“ entfernt. (If1393)
- Das Mindest-API-Level für das Wear-Zifferblatt ist jetzt 25. Hinweis: Für die Unterstützung von Hardware-Canvas ist API-Level 26 oder höher erforderlich. (Ic9bbd)
- InteractiveWatchFaceWcsClient verfügt jetzt über einen Helper „getComplicationIdAt“. (I05811)
- Das API-Level für Wear-Watchface-Client wurde auf 25 reduziert, für die Screenshot-APIs ist jedoch API-Level 27 erforderlich. (Id31c2)
Fehlerkorrekturen
- Wir zeigen jetzt den ComplicationData-Typ „ComplicationData“ der Zusatzfunktion im ComplicationState“. (I9b390)
- InteractiveWatchFaceWcs verfügt jetzt über die Methode „bringAttentionToComplication“, um die angegebene Zusatzfunktion kurz hervorzuheben. (I6d31c)
InteractiveWatchFaceWcsClient#setUserStyle
hat nun eine Überlastung, die Map<string, string=""> akzeptiert. Dadurch kann möglicherweise ein zusätzlicher IPC-Roundtrip vermieden werden, 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
wird freigegeben. Version 1.0.0-alpha03 enthält diese Commits.
Neue Funktionen
Die Klasse „Complication“ hat jetzt eine „compicationData“-Eigenschaft, mit der Zifferblätter Änderungen an ComplicationData erkennen können. So lassen sich die Abmessungen der Zusatzfunktion je nach Typ ändern.
Variable Framerates werden jetzt unterstützt, indem „Renderer.interactiveDrawModeUpdateDelayMillis“ zugewiesen wird. Bei Zifferblättern mit kurzen Animationen pro Sekunde kann dies zu Energieeinsparungen führen, da das Gerät in den Ruhemodus wechselt, wenn es nicht animiert ist.
API-Änderungen
BACKGROUND_IMAGE
und zugehörige Klassen wurden inPHOTO_IMAGE
umbenannt. Diese Art der Zusatzfunktion wird nicht ausschließlich für Hintergründe verwendet, daher die Namensänderung. (I995c6)- DefaultComplicationProviderPolicy korrekt mit IntDefs annotiert. (I3b431)
- Die ausgeblendete TimeDependentText-Klasse wird nicht mehr über „ContentDescriptionLabel“ verfügbar gemacht. 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 Änderungen an ComplicationData erkennen können. Die Zusatzfunktion verfügt auch über einen neuen isActiveAt-Aufruf, mit dem angegeben werden kann, ob zum angegebenen Datum/Uhrzeit etwas gerendert werden soll. (Ic0e2a)
- Das leere
SharedMemoryImage
ist nicht mehr in der öffentlichen API. (I7ee17) WatchFace.overridePreviewReferenceTimeMillis
verfügt jetzt über eine IntRange-Annotation und die Namen der Getter und Setter sind einheitlich. (Ia5f78)Complication.Builder
wird jetzt zur besseren Verständlichkeit überComplication.createRoundRectComplicationBuilder
oderComplication.createBackgroundComplicationBuilder
erstellt (I54063)- „WatchFace.TapListener“ wurde hinzugefügt, mit dem das Zifferblatt, wenn keine Zusatzfunktionen genutzt werden, Daten erfassen kann. (Ic2fe1, b/172721168)
- Watch Face unterstützt jetzt variable Framerates, indem
Renderer.interactiveDrawModeUpdateDelayMillis
zugewiesen wird. Dies kann dazu beitragen, die Akkulaufzeit zu verlängern, indem der Ruhemodus aktiviert wird, wenn der Nutzer nicht animiert wird. (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 Eigenschaften in WatchState (I6d2f1) umbenannt.
- TapListener wurde aus Konsistenzgründen in TapCallback und InvalidCallback in "InvalidListener" umbenannt. (I9414e)
- Die Stiloptionen für das Wear 2.0-Zifferblatt wurden zur besseren Übersichtlichkeit in eine eigene Klasse verschoben. WatchFace.Builder-Setter haben jetzt symmetrische WatchFace-Klassengetter. Iefdfc
- InteractiveWatchFaceWcsClient und
WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient
wurden hinzugefügt. Diese Instanzen rufen entweder eine vorhandene Instanz ab oder erstellen sie, nachdem der Wallaper-Dienst eine Verbindung hergestellt und die Engine erstellt hat. (Id666e) - WatchFaceControlClient ist jetzt eine Schnittstelle, mit der sich Tests simulieren lassen. (I875d9)
- HeadlessWatchFaceClient, InteractiveWatchFaceSysUiClientImpl und InteractiveWatchFaceWcsClient sind jetzt Schnittstellen, die das Testen vereinfachen. I7cdc3
- Anmerkungen zu Methoden in
wear-watchface-complications-rendering
(I0d65c) hinzugefügt
Fehlerkorrekturen
- Entfernen Sie die Bildschirmform aus DeviceConfig, in der
android.content.res.Configuration#isScreenRound()
dupliziert wurde (Ifadf4) WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient
wurde so geändert, dassMap<String, String>
anstelle vonUserStyle
akzeptiert wird, weil 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
, umComplicationState
anstelle des Kabelformats zu verwenden. (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
wird freigegeben. Version 1.0.0-alpha02 enthält diese Commits.
API-Änderungen
ComplicationDetails
heißt jetztComplicationState
und ist richtig gepackt. Die Nutzung der Wearable-Unterstützung@ComplicationData.ComplicationType
wurde zu AndroidxComplicationType
migriert. (I4dd36)- Du kannst RenderParameters den optionalen
highlightedComplicationId
-Parameter hinzufügen, mit dem du eine Hervorhebung einer einzelnen Zusatzfunktion in Screenshots anfordern kannst. (I66ce9) ComplicationProviderService
zur Verwendung der neuen Stilkomplikations-API für Konsistenz (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
ist nicht vonRenderer
abhängig und wird zur besseren Verständlichkeit umbenannt. (Ibe880)
Fehlerkorrekturen
- Erste Version von
androidx.wear:wear-watchface-client
(I1e35e) - Der Name von
GlesTextureComplication#renderer
wurde zur besseren Verständlichkeit geändert (Ib78f7). - Benennen Sie
StyleCategory
zur Verdeutlichung inStyleSetting
um (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
werden veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
API-Änderungen
- Einige Elemente wurden entfernt, die nicht in der öffentlichen API verfügbar sein wollten. (I41669)
androidx.wear:wear-complications-provider
-Mediathek erstellen. I77f1f- ComplicationsUserStyleCategory – die neue empfohlene Kategorie für das Konfigurieren von Zusatzfunktionen (I96909)
- wear-complication-data API hinzufügen (I7c268)
- Funktionen mit booleschen Werten geben das Präfix „is“ statt „get“ zurück (If36ff)
- Die API-Empfehlung besteht darin, die Verwendung von Protect-Tags zu vermeiden. Daher wurde diese Klasse so umgestaltet, dass Parameter über den Konstruktor aufgenommen werden. (I61644)
- Benennen Sie „setBackgroundComplication“ aus Gründen der Übersichtlichkeit um. (I96fe3)
- Kotlin-Properties für „ComplicationDrawable“ mit isHighlighted und Daten verwenden (I4dcc8)
- Anstelle von ComplicationRenderer.InvalidCallback fügen wir Complication#invalidator() (I4f4c6) hinzu.
- Diese APIs werden im WearableSupport eingestellt und hier entfernt. (Ib425c)
- Einige Smartwatch-Methoden zum Erstellen von Zifferblatt wurden umbenannt, um die Legacy-Version von Wear 2.0 hervorzuheben. (Idb775)
- Erster Beta-API-Kandidat für Wear/Wear-Watchface (Id3981)
- Erste verfolgte Version der API. (Ie9fe6)
- „ComplicationDrawable.BorderStyle IntDef“ wird korrekt ausgeblendet und wechseln zu „ComplicationStyle“, um Konsistenz zu erreichen. (I27f7a)
- Fehlende Anmerkungen für ComplicationStyle-Methoden hinzufügen (I838fd)
- Diese Bibliothek hat keine öffentliche API-Oberfläche (I88e2b)
- Alle Optionsklassen der Stilkategorie sind jetzt korrekt final. (Ib8323)
- Erste verfolgte Version der API. (I27c85)
Fehlerkorrekturen
- Der ComplicationProviderService wurde in eine explizite getComplicationPreviewData-Methode geändert. (I4905f)
- Die API-Lint-Prüfung für MissingGetterMatchingBuilder ist für Androidx aktiviert (I4bbea, b/138602561).
- „Wear-Zusatzfunktionen“-Rendering umbenennen. (Ifea02)
- Die Anzeigenamen der Stilkategorien heißen jetzt „CharSequences“ (I28990).
- „Überschreiben“ durch „Overlay“, damit die Namenskonventionen für aktuelle Designs und Stile übernommen werden. (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
wird freigegeben. 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 der 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 die untergeordneten Elemente einzeln auf einem Bogen anzuordnen, entweder im oder gegen den Uhrzeigersinn. Die Kinder können sowohl standardmäßige Android-Widgets als auch sogenannte „gewölbte“ Widgets sein, 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>
Es wurde ein neuer Layout-Container namens DismissibleFrameLayout hinzugefügt, der das Schließen der Zurück-Schaltfläche und/oder das Wischen zum Schließen ermöglicht und für die Verwendung innerhalb einer Aktivität vorgesehen ist. Damit auf Ablehnungen reagiert werden kann, muss mindestens ein Listener hinzugefügt werden. Ein Listener entfernt in der Regel eine enthaltende Ansicht oder ein Fragment aus der aktuellen Aktivität. Dieses neue Layout ersetzt das vorhandene SwipeCloseFrameLayout.
Unterstützung für die Angabe, dass eine Aktivität „automatisch fortgesetzt“ werden kann, wenn das Gerät den Inaktivmodus in der AmbientModeSupport-Klasse verlässt, wurde hinzugefügt. Diese Funktion war zuvor in der eingestellten WearableActivity-Klasse der WearableSupportLibrary verfügbar. (I336ab)
Die WearableKalenderContract-Klasse wurde aus der Wearable-Supportbibliothek migriert. Diese API stellt einen Teil der über KalenderContract verfügbaren Daten bereit, wird jedoch 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 bestimmt ist. (Ib01a9)androidx.wear.widget.ConfirmationOverlay
wurden Bedienungshilfen hinzugefügt, die Nachrichten vorlesen, wenn diese festgelegt sind, gefolgt von einer Animationsbeschreibung. (I524dd)Es wurde ein Fehler behoben, der zum Absturz der Bestätigungaktivität führte, wenn keine Nachricht angegeben wurde. (Ie6055)
Es wurde ein Fehler behoben, bei dem horizontal scrollbares RecyclerViews-Element dazu führte, dass
WearableDrawerLayout
alle Interaktionen überließ. (I24c7f)
Version 1.2.0-rc01
1. September 2021
androidx.wear:wear:1.2.0-rc01
wird ohne Änderungen seit der letzten Betaversion veröffentlicht. Version 1.2.0-rc01 enthält diese Commits.
Version 1.2.0-beta01
18. August 2021
androidx.wear:wear:1.2.0-beta01
wird freigegeben. Version 1.2.0-beta01 enthält diese Commits.
Fehlerkorrekturen
- Es wurde ein Fehler behoben, der zum Absturz der Bestätigungaktivität führte, wenn keine Nachricht angegeben wurde. (Ie6055)
Version 1.2.0-alpha13
4. August 2021
androidx.wear:wear:1.2.0-alpha13
wird freigegeben. 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, die Nachrichten vorlesen, wenn sie festgelegt sind, gefolgt von einer Animationsbeschreibung. (I524dd)
Version 1.2.0-alpha12
21. Juli 2021
androidx.wear:wear:1.2.0-alpha12
wird freigegeben. Version 1.2.0-alpha12 enthält diese Commits.
API-Änderungen
- Wir haben in
androidx.wear.utils
eine neue API (WearTypeHelper
) hinzugefügt, mit der ermittelt werden kann, ob das angegebene Wear-Gerät für China bestimmt ist. (Ib01a9)
Version 1.2.0-alpha11
30. Juni 2021
androidx.wear:wear:1.2.0-alpha11
wird freigegeben. Version 1.2.0-alpha11 enthält diese Commits.
Fehlerkorrekturen
- Es wurde ein Fehler behoben, bei dem horizontal scrollbares RecyclerViews-Element dazu führte, dass
WearableDrawerLayout
alle Interaktionen überließ. (I24c7f)
Version 1.2.0-alpha10
2. Juni 2021
androidx.wear:wear:1.2.0-alpha10
wird freigegeben. Version 1.2.0-alpha10 enthält diese Commits.
Neue Funktionen
- Alpha10 verbessert die Unterstützung der Bedienungshilfen in gebogenem Text und ArcLayouts. Außerdem wurden einige kleinere Elemente im CloseibleFrameLayout umbenannt, um die API zu verdeutlichen.
API-Änderungen
- Wir haben die folgenden Methoden in
DismissibleFrameLayout
(Ib195e) umbenannt:Callback#onDismissed
->Callback#onDismissedFinished
isSwipeDismissible
->isDismissableBySwipe
isBackButtonDismissible
->isDismissableByBackButton
- Folgende Methoden sind endgültig (Ib195e):
setBackButtonDismissible
setSwipeDismissible
registerCallback
unregisterCallback
Fehlerkorrekturen
- Verwenden Sie den Inhalt von CurvedTextView in 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
wird freigegeben. Version 1.2.0-alpha09 enthält diese Commits.
API-Änderungen
- Es wurde eine neue
CurvedTextView.setTypeface()
-Funktion hinzugefügt (ähnlich der vonTextView
), um Schriftart und Fett-/Kursivformatierung festzulegen. (I4653c) WearArcLayout
wurde inArcLayout
,WearCurvedText
inCurvedText
undWearArcLayout.ArcLayoutWidget
inArcLayout.Widget
umbenannt. (I6e5ce)- Am
ArcLayout.Widget
wurdegetThicknessPx
ingetThickness
umbenannt. - Konstanten für die vertikale Ausrichtung für
ArcLayout.LayoutParams
werden jetzt mitVERTICAL_ALIGN_
anstelle des vorherigenVALIGN_
benannt.
- Am
- Am
CurvedTextView
wurden die MethodensetMinSweepDegrees
undsetMaxSweepDegrees
durchsetSweepRangeDegrees
(I7a9d9) ersetzt.
Version 1.2.0-alpha08
5. Mai 2021
androidx.wear:wear:1.2.0-alpha08
wird freigegeben. Version 1.2.0-alpha08 enthält diese Commits.
API-Änderungen
- Um die Verständlichkeit des Codes zu verbessern, haben wir einigen Winkelparametern und Rückgabetypen
@FloatRange
-Annotationen 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
wird freigegeben. Version 1.2.0-alpha07 enthält diese Commits.
Fehlerkorrekturen
- Behebung von Fehlern mit nicht gebogenen untergeordneten Elementen in WearArcLayout, die durch die Verwendung einer Bildschirmgröße mit einer Höhe über der Breite verursacht wurden. Diese nicht gebogenen untergeordneten Elemente werden jetzt bei allen Bildschirmtypen korrekt innerhalb eines Bogens platziert.
Version 1.2.0-alpha06
27. Januar 2021
androidx.wear:wear:1.2.0-alpha06
wird freigegeben. Version 1.2.0-alpha06 enthält diese Commits.
API-Änderungen
- Migrieren Sie die Bibliothek der laufenden Aktivitäten zu einer neuen Unterbibliothek: Wear-ongoing. Die Kurse sind jetzt im Paket „androidx.wear.ongoing“ enthalten (bisher „androidx.wear.ongoingactivities“) (I7c029)
- Migriere die WearableKalenderContract-Klasse von der Wearable-Supportbibliothek zu AndroidX. Diese API stellt einen Teil der über KalenderContract verfügbaren Daten bereit, wird jedoch automatisch mit Wearable-Geräten synchronisiert. (I6f2d7)
Fehlerkorrekturen
- Deaktivieren Sie die Option zum Schließen der Zurück-Schaltfläche standardmäßig im Closedible FrameLayout, da die Option zum Schließen durch Wischen auf Wearable-Geräten weiterhin die Hauptmethode ist, um zum vorherigen Bildschirm zurückzukehren (Ic24e3).
- Probleme mit der Sichtbarkeit von untergeordneten Elementen in WearArcLayout behoben (Icf912)
Version 1.2.0-alpha05
13. Januar 2021
androidx.wear:wear:1.2.0-alpha05
wird freigegeben. Version 1.2.0-alpha05 enthält diese Commits.
Fehlerkorrekturen
- Aktualisieren Sie das Javadoc der Klasse „AmbientModeSupport“, um Beispiel-Snippets bereitzustellen, die die allgemeine Verwendung dieser Klasse besser veranschaulichen.
Version 1.2.0-alpha04
16. Dezember 2020
androidx.wear:wear:1.2.0-alpha04
wird freigegeben. Version 1.2.0-alpha04 enthält diese Commits.
API-Änderungen
- Unterstützung für die Angabe, dass eine Aktivität „automatisch fortgesetzt“ werden kann, wenn das Gerät den Inaktivmodus in der AmbientModeSupport-Klasse verlässt, wurde hinzugefügt. Diese Funktion war zuvor in der eingestellten WearableActivity-Klasse der WearableSupportLibrary verfügbar. (I336ab)
- OngoingActivity
- Beim Erstellen einer OngoingActivity 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 OngoingActivity kann jetzt eine Kategorie festgelegt werden, z.B.
- Unterstützung für das Festlegen von Rändern für untergeordnete WearArcLayout-Elemente hinzugefügt, indem die Layoutparameter geändert werden, um MarginLayoutParams zu erweitern, d.h. WearArcLayout.LayoutParams erweitert android.view.ViewGroup.MarginLayoutParams. (I2cd88)
- Ändern Sie den Standard für den Ankertyp von WearCurvedTextView in
WearArcLayout.ANCHOR_CENTER
(vorherWearArcLayout.ANCHOR_START
). Dies vereinfacht den Übergang zwischen dem Bogenlayout und dem gebogenen Text, da der gebogene Text standardmäßig oben x-zentriert ist und das übergeordnete Bogenlayout an die gewünschte Stelle gedreht werden kann. (I105ff)
Version 1.2.0-alpha03
2. Dezember 2020
androidx.wear:wear:1.2.0-alpha03
wird freigegeben. Version 1.2.0-alpha03 enthält diese Commits.
Neue Funktionen
Ein neuer Layout-Container „DismissibleFrameLayout“, der das Schließen der Zurück-Schaltfläche und/oder das Schließen durch Wischen verarbeitet, ist für die Verwendung innerhalb einer Aktivität vorgesehen. Damit auf Ablehnungen reagiert werden kann, muss mindestens ein Listener hinzugefügt werden. Ein Listener entfernt in der Regel eine enthaltende Ansicht oder ein Fragment aus der aktuellen Aktivität. Dieses neue Layout ersetzt das vorhandene SwipeCloseFrameLayout.
Gebogene Widgets verarbeiten jetzt Touch-Ereignisse. Normale Widgets in einem WearArcLayout empfangen alle Touch-Ereignisse, die ihrem Koordinatenraum zugeordnet sind. Mit WearCurvedTextView kann – ob in einem WearArcLayout oder nicht – die Handler „ selbst“ und „onLongClick“ festgelegt werden.
Laufende Aktivitätsklassen sind jetzt „versionedParcelables“ anstelle der benutzerdefinierten Serialisierung/Deserialisierung. Das statische Symbol und der Touch-Intent sind jetzt erforderlich.
API-Änderungen
- Das Attribut „sweepDegrees“ für WearCurvedTextView wird in minSweepDegrees und maxSweepDegrees unterteilt, um ein flexibleres Layout dieses Widgets zu erzielen.
Version 1.2.0-alpha02
11. November 2020
androidx.wear:wear:1.2.0-alpha02
wird freigegeben. Version 1.2.0-alpha02 enthält diese Commits.
In dieser Version wird erstmals ein neues „Ongoing Activity API“ hinzugefügt. Diese API kann von Entwicklern verwendet werden, um zu signalisieren, dass eine lange andauernde Aktivität, z. B. ein Fitnesstraining oder eine Medienwiedergabe-Sitzung, stattfindet. Damit können Entwickler regelmäßige Statusupdates wie „Strecke und gelaufene Zeit“ oder „Aktueller Titel“ zur Anzeige auf dem Zifferblatt oder im App Launcher bereitstellen. Diese Funktion ist auf zukünftige Geräte ausgerichtet, auf denen die Funktion „Aktive Aktivitäten“ aktiviert ist.
API-Änderungen
- Neue API für laufende Aktivitäten; kann auf nicht unterstützten Geräten nicht durchgeführt werden. (I69a31)
Version 1.2.0-alpha01
28. Oktober 2020
androidx.wear:wear:1.2.0-alpha01
wird freigegeben. Version 1.2.0-alpha01 enthält diese Commits.
Neue Funktionen
- WearCurvedTextView-Komponente zum einfachen Schreiben von gebogenem 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 angeordnet werden, entweder im oder gegen den Uhrzeigersinn. Die untergeordneten Elemente können sowohl standardmäßige Android-Widgets als auch sogenannte „Curved“-Widgets sein, die die ArcLayoutWidget-Schnittstelle implementieren. Anwendungsbeispiel:
<androidx.wear.widget.WearArcLayout
android:layout_width="match_parent"
android:layout_height="match_parent"
app:anchorPosition="center">
<ImageView
android:layout_width="20dp"
android:layout_height="20dp"
android:src="@drawable/ic_launcher"
/>
<androidx.wear.widget.WearCurvedTextView
android:layout_width="match_parent"
android:layout_height="match_parent"
android:text="Curved Text"
style="@android:style/TextAppearance.Small"
android:padding="2dp"
/>
</androidx.wear.widget.WearArcLayout>
(I536da)
Wear-Input 1.2
Version 1.2.0-alpha02
29. September 2021
androidx.wear:wear-input:1.2.0-alpha02
und androidx.wear:wear-input-testing:1.2.0-alpha02
werden 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 werden soll. (I28393)
Version 1.2.0-alpha01
15. September 2021
androidx.wear:wear-input:1.2.0-alpha01
und androidx.wear:wear-input-testing:1.2.0-alpha01
werden veröffentlicht. Version 1.2.0-alpha01 enthält diese Commits.
API-Änderungen
- Alle Konstanten für die Schaltflächenposition von
WearableButtons
wurden offengelegt. (Ibb12c) WearableRemoteInputExtender
-Klasse wurde hinzugefügt, mit der Wear-spezifische Extras zu android.app.RemoteInput hinzugefügt werden können. (I01903)
Wear-Input 1.1.0
Version 1.1.0
18. August 2021
androidx.wear:wear-input:1.1.0
und androidx.wear:wear-input-testing:1.1.0
werden 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 Ihre Nutzer in einer anpassbaren Aktivität um Input bitten.
Version 1.1.0-rc01
4. August 2021
androidx.wear:wear-input:1.1.0-rc01
und androidx.wear:wear-input-testing:1.1.0-rc01
werden 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
werden 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
werden veröffentlicht. Version 1.1.0-alpha03 enthält diese Commits.
Fehlerkorrekturen
- Es wurde ein Fehler behoben, der dazu führte, dass 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
werden veröffentlicht. Version 1.1.0-alpha02 enthält diese Commits.
API-Änderungen
- Methoden von
RemoteInputIntentHelper
, die zum Abrufen oder Einfügen von Extras verwendet werden, die Labels für Titel, Abbrechen, Bestätigen und In Bearbeitung darstellen, 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
werden veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.
API-Änderungen
- Migriere die RemoteInputIntent-Klasse von der Wearable Support Library zu AndroidX. Die migrierte Klasse wurde in "RemoteInputIntentHelper" umbenannt. Diese Klasse bietet Hilfsfunktionen zur Unterstützung von Remote-Eingaben durch das Starten eines Intents. (I47cee)
Wear-Input 1.0.0
Version 1.0.0
2. Dezember 2020
androidx.wear:wear-input:1.0.0
und androidx.wear:wear-input-testing:1.0.0
werden 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 von WearableButtons-Funktionen von der Wearable Support Library zu Jetpack.
androidx.wear.input.test.TestWearableButtonsProvider
wurde hinzugefügt, umandroidx.wear.input.WearableButtonsProvider
zu implementieren, 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
werden 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
werden ohne Änderungen seit dem 1.1.0-alpha01
veröffentlicht. Version 1.0.0-beta01 enthält diese Commits.
Wear-Input-Test-Version 1.0.0-alpha01
14. Oktober 2020
androidx.wear:wear-input-testing:1.0.0-alpha01
wird freigegeben. Version 1.0.0-alpha01 enthält diese Commits.
API-Änderungen
androidx.wear.input.test.TestWearableButtonsProvider
wurde hinzugefügt, umandroidx.wear.input.WearableButtonsProvider
zu implementieren, um das Testen von Anwendungen zu unterstützen, die mit derandroidx.wear:wear-input
-Bibliothek entwickelt wurden. (I0ed0c)
Wear-Input Version 1.0.0-alpha01
2. September 2020
androidx.wear:wear-input:1.0.0-alpha01
wird freigegeben. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
Migration von WearableButtons-Funktionen von der Wearable Support Library zu Jetpack. Im nächsten Jetpack-Release wird die androidx.wear:wear-input-testing
-Bibliothek zusätzliche Unterstützung für Tests bieten.
Version 1.1.0
Version 1.1.0
14. Oktober 2020
androidx.wear:wear:1.1.0
wird freigegeben. Version 1.1.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.0.0
- Dem boxedEdges-Attribut (jetzt
layout_BoxedEdges
) wurde das Präfixlayout_
fürBoxInsetLayout
hinzugefügt, um der Android-Namenskonvention zu entsprechen. Dadurch wird der Linter-Fehler in Android Studio für diese Attribute entfernt. (I4272f) ConfirmationActivity
wurde optionalEXTRA_ANIMATION_DURATION_MILLIS
hinzugefügt, um die Dauer des Bestätigungsdialogfelds zu berücksichtigen. (adb83ce, b/143356547)WearableActionDrawView
, um das Aufblasen der Aktionsleiste zu verzögern, bis sie zum ersten Mal geöffnet wird. (I01026, b/163870541)
Version 1.1.0-rc03
2. September 2020
androidx.wear:wear:1.1.0-rc03
wird freigegeben. 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
wird freigegeben. Version 1.1.0-rc02 enthält diese Commits.
Fehlerkorrekturen
- Dem boxedEdges-Attribut (jetzt
layout_boxedEdges
) wurde das Präfixlayout_
fürBoxInsetLayout
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 .1.0-beta01
veröffentlicht. Version 1.1.0-rc01 enthält diese Commits.
Version 1.1.0-beta01
29. April 2020
androidx.wear:wear:1.1.0-beta01
wurde ohne Änderungen seit androidx.wear:wear:1.1.0-alpha01
veröffentlicht. Version 1.3.0-beta01 enthält diese Commits.
Version 1.1.0-alpha01
15. April 2020
androidx.wear:wear:1.1.0-alpha01
wird freigegeben. Version 1.1.0-alpha01 enthält diese Commits.
API-Änderungen
ConfirmationActivity
wurde optionalEXTRA_ANIMATION_DURATION_MILLIS
hinzugefügt, um die Dauer des Bestätigungsdialogfelds zu berücksichtigen. (adb83ce, 134523c, b/143356547)
Fehlerkorrekturen
WearableActionDrawView
, um das Aufblasen der Aktionsleiste zu verzögern, bis sie zum ersten Mal geöffnet wird. 5cd32f7