Glance Wear

  
Glance Wear ist eine Bibliothek zum Erstellen von Widgets für Wear OS.
Letzte Aktualisierung Stabile Release Releasekandidat Beta-Release Alpha-Release
9. September 2026 - - - 1.0.0-alpha18

Abhängigkeiten deklarieren

Für eine Abhängigkeit von „glance-wear“ müssen Sie Ihrem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie im Maven-Repository von Google.

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

Cool

dependencies {
    implementation "androidx.glance.wear:wear:1.0.0-alpha13"

    implementation "androidx.glance.wear:wear-core:1.0.0-alpha13"
}

Kotlin

dependencies {
    implementation("androidx.glance.wear:wear:1.0.0-alpha13")

    implementation("androidx.glance.wear:wear-core:1.0.0-alpha13")
}

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

Feedback

Ihr Feedback hilft uns, Jetpack zu verbessern. Wenn Sie neue Probleme entdecken oder Ideen zur Verbesserung dieser Bibliothek haben, lassen Sie es uns wissen. Bevor Sie ein neues Problem erstellen, sollten Sie sich jedoch die bereits gemeldeten Probleme in dieser Bibliothek ansehen. Wenn Sie sich einer Problemmeldung anschließen möchten, klicken Sie auf den Button mit dem Stern.

Neues Problem melden

Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.

Glance Wear, Version 1.0

Version 1.0.0-alpha18

9. September 2026

androidx.glance.wear:wear:1.0.0-alpha18, androidx.glance.wear:wear-core:1.0.0-alpha18 und androidx.glance.wear:wear-tooling-preview:1.0.0-alpha18 sind veröffentlicht. Version 1.0.0-alpha18 enthält diese Commits.

API-Änderungen

  • Der Parameter useSafeFallbackRendererVersion wurde zu WearWidgetPreview hinzugefügt, um eine Vorschau von Widgets mit einem sicheren Fallback-Satz unterstützter Vorgänge für ältere Hosts zu ermöglichen. (I9c324)

Diverse Fehlerkorrekturen

  • compileSdk für Compose-Bibliotheken auf 37.1 aktualisiert. Dadurch muss compileSdk für alle Apps und Bibliotheken, die Compose verwenden, transitiv aktualisiert werden. (I05b0f)
  • Lint-Prüfung hinzugefügt, um vor redundanten fontFamily-Parameterverwendungen in Wear-Widgets zu warnen. (I7730c)

Version 1.0.0-alpha17

26. August 2026

androidx.glance.wear:wear:1.0.0-alpha17, androidx.glance.wear:wear-core:1.0.0-alpha17 und androidx.glance.wear:wear-tooling-preview:1.0.0-alpha17 sind veröffentlicht. Version 1.0.0-alpha17 enthält diese Commits.

Neue Funktionen

  • Lint-Prüfungen in Glance Wear hinzugefügt, um zu erzwingen, dass für jedes <container> in einer <wearwidget-provider> XML für Widget-Metadaten explizit ein unterstütztes Typattribut angegeben wird und keine doppelten Typen definiert werden. (I52c9a, b/464458215)

Version 1.0.0-alpha16

12. August 2026

androidx.glance.wear:wear:1.0.0-alpha16, androidx.glance.wear:wear-core:1.0.0-alpha16 und androidx.glance.wear:wear-tooling-preview:1.0.0-alpha16 sind veröffentlicht. Version 1.0.0-alpha16 enthält diese Commits.

Neue Funktionen

  • Lint-Validierung für <wearwidget-provider> XML-Metadaten hinzugefügt, um sicherzustellen, dass die erforderlichen Konfigurationselemente (z. B. container und previewImage) vorhanden sind. (Ia9983, b/464458215)
  • Lint-Fehlerwarnung für das Festlegen eines schwarzen oder transparenten Hintergrunds für ein Wear-Widget hinzugefügt (Idedb0, b/529269573)
  • Der Remote Compose-Vorgang CORE_TEXT für das Profil von Wear-Widgets wurde aktiviert. Dadurch kann RemoteText auf unterstützten Host-Renderern variable Schriftfunktionen wie Schriftachsen und Zeilenhöhen verwenden. Wenn dies nicht unterstützt wird, wird automatisch ein Fallback verwendet.

Diverse Fehlerkorrekturen

  • KDocs für die Annotation AssociateWithGlanceWearWidget gemäß Entwicklerfeedback aktualisiert

Version 1.0.0-alpha15

29. Juli 2026

androidx.glance.wear:wear:1.0.0-alpha15, androidx.glance.wear:wear-core:1.0.0-alpha15 und androidx.glance.wear:wear-tooling-preview:1.0.0-alpha15 sind veröffentlicht. Version 1.0.0-alpha15 enthält diese Commits.

Neue Funktionen

  • Lint-Warnung hinzugefügt, wenn für das Wear-Widget-Dokument ein leerer Hintergrund festgelegt wird. (Ic6475, b/529269573)

Version 1.0.0-alpha14

15. Juli 2026

androidx.glance.wear:wear:1.0.0-alpha14, androidx.glance.wear:wear-core:1.0.0-alpha14 und androidx.glance.wear:wear-tooling-preview:1.0.0-alpha14 sind veröffentlicht. Version 1.0.0-alpha14 enthält diese Commits.

API-Änderungen

  • Die Anbieter von Vorschauparametern RoundAllWidgetPreviewParams, RoundSmallWidgetPreviewParams und RoundLargeWidgetPreviewParams für vollständig abgerundete Glance Wear-Widgets wurden hinzugefügt. (If5336, b/512405233)

Neue Funktionen

  • Die Linter-Bibliothek für Glance Wear-Widgets wurde eingerichtet und hinzugefügt.(If4218, b/527402079)
    • Eine Lint-Prüfung wurde hinzugefügt, um sicherzustellen, dass Unterklassen von GlanceWearWidgetService ihre zugehörige Widget-Klasse explizit mit der Annotation @AssociateWithGlanceWearWidget deklarieren. (Idc575, b/477024153)
  • Die Abwärtskompatibilität für Widgets, die auf älteren Hosts ausgeführt werden, wurde verbessert, indem unterstützte Vorgänge über WearWidgetParams weitergegeben und das Profil der zulässigen Vorgänge auf diese beschränkt wurde. (Ib0a1b, I83cb1, [b/526716195])

Version 1.0.0-alpha13

1. Juli 2026

androidx.glance.wear:wear:1.0.0-alpha13, androidx.glance.wear:wear-core:1.0.0-alpha13 und androidx.glance.wear:wear-tooling-preview:1.0.0-alpha13 sind veröffentlicht. Version 1.0.0-alpha13 enthält diese Commits.

API-Änderungen

  • Die Berechtigungsprüfung wurde aus heartRateAccuracy entfernt (I14269, b/522444636)

Diverse Fehlerkorrekturen

  • Die Parameter für das Wear-Widget in Squircle-Form wurden gemäß UX-Feedback angepasst.

Version 1.0.0-alpha12

17. Juni 2026

androidx.glance.wear:wear:1.0.0-alpha12, androidx.glance.wear:wear-core:1.0.0-alpha12 und androidx.glance.wear:wear-tooling-preview:1.0.0-alpha12 sind veröffentlicht. Version 1.0.0-alpha12 enthält diese Commits.

Neue Funktionen

  • Es wurde AssociateWithGlanceWearWidget hinzugefügt, das muss für GlanceWearWidgetService verwendet werden, um anzugeben, mit welcher Implementierung von GlanceWearWidget es verknüpft ist. (Ifcabb, b/514679763)

    • Beispiel:
     @AssociateWithGlanceWearWidget(MyGlanceWearWidget::class)
 class MyGlanceWearWidgetService : GlanceWearWidgetService() {
   override val widget = MyGlanceWearWidget()
 }
 ```

  • Der Pinsel image wurde zu WearWidgetBrush hinzugefügt, um Bitmap-Hintergründe in Wear-Widgets zu unterstützen. (I9a228, b/513481558)

  • Die @Composable-Hilfsfunktion WearWidgetPreview wurde eingeführt, um die Entwicklung von Glance Wear-Widgets zu vereinfachen, indem der Boilerplate-Code entfernt wird, der für IDE-Vorschauen erforderlich ist.

API-Änderungen

  • androidx.glance.wear.health.DataType wurde in androidx.glance.wear.health.HealthData umbenannt (I4cb0b, b/516746689).
  • isHeartRateBpmAvailable wird verfügbar gemacht, um zu ermitteln, ob heartRateBpm auf dem Host verfügbar ist. (I5999d, b/514641567)
  • Vergleichsoperatoren für RemoteInt verfügbar gemacht. (I5fe3d, b/513228889)
  • Die Flow API captureRemoteDocument und eine neue Überladung captureSingleRemoteDocument (die RemoteCreationDisplayInfo verwendet) wurden als öffentliche APIs verfügbar gemacht. (I87b0e, b/513228889)
  • @CallSuper wurde den Lebenszyklusmethoden von GlanceWearWidgetService hinzugefügt.

Version 1.0.0-alpha11

3. Juni 2026

androidx.glance.wear:wear:1.0.0-alpha11, androidx.glance.wear:wear-core:1.0.0-alpha11 und androidx.glance.wear:wear-tooling-preview:1.0.0-alpha11 sind veröffentlicht. Version 1.0.0-alpha11 enthält diese Commits.

API-Änderungen

  • WearWidgetPreview wurde hinzugefügt, um eine Vorschau von Wear-Widgets in Android Studio zu ermöglichen. (I36504, b/485147770)
  • Die Variablen is*Available (isDailyStepsAvailable usw.) wurden verfügbar gemacht, um zu prüfen, ob der zugehörige Gesundheitsdatentyp verfügbar und gültig ist. (Ib98a7, b/498179656)
  • Die triggerUpdateAll API wurde zu GlanceWearWidget hinzugefügt, um ein Update für alle Widgets der angegebenen App auszulösen. (I6ab20, b/510896410)

Diverse Fehlerkorrekturen

  • Informationen zur Renderer-Version als internes Feld in WearWidgetParams aufgenommen, um Fehler im mit Version alpha10 generierten Dokument zu vermeiden. (Idcf8e, b/511263591, b/512830184)
  • Erzwingen Sie im Debug-Modus oder Emulator einen Pull-Update-Ablauf für Wear-Widgets.

Version 1.0.0-alpha10

19. Mai 2026

androidx.glance.wear:wear:1.0.0-alpha10, androidx.glance.wear:wear-core:1.0.0-alpha10 und androidx.glance.wear:wear-tooling-preview:1.0.0-alpha10 sind veröffentlicht. Version 1.0.0-alpha10 enthält diese Commits.

API-Änderungen

  • Die APIs glance.wear.health.DataType in Wear-Widgets verfügbar gemacht. Entwickler können mit diesen APIs auf Gesundheitsdaten des Systems zugreifen.

Diverse Fehlerkorrekturen

  • Eine Absturzschleife in Version alpha09 auf dem Wear 7-Emulator oder Geräten mit Renderer 1.6 wurde behoben, indem verhindert wurde, dass leere Schriftachsen an den Player für das Glance Wear-Widget gesendet werden.

Version 1.0.0-alpha09

6. Mai 2026

androidx.glance.wear:wear:1.0.0-alpha09 und androidx.glance.wear:wear-core:1.0.0-alpha09 sind veröffentlicht. Version 1.0.0-alpha09 enthält diese Commits.

API-Änderungen

  • ExperimentalGlanceWearApi wurde hinzugefügt, die für experimentelle Glance Wear-Funktionen verwendet wird. (Id2f76, b/498179813)

Diverse Fehlerkorrekturen

  • Der Parser für XML-Metadaten von Wear-Widgets wurde aktualisiert, um Widgets während des Bootvorgangs zu erkennen.

Version 1.0.0-alpha08

22. April 2026

androidx.glance.wear:wear:1.0.0-alpha08 und androidx.glance.wear:wear-core:1.0.0-alpha08 sind veröffentlicht. Version 1.0.0-alpha08 enthält diese Commits.

Diverse Fehlerkorrekturen

  • Das Tag <queries> wurde dem Manifest der Bibliothek glance:wear:wear hinzugefügt, um sicherzustellen, dass PackageManager die richtigen Dienste für Push-Updates abfragt. (I192787)

Sonstiges

  • Die Änderung „Updates Compose compileSdk to 37“ (I6007) wurde zurückgesetzt, da sie auch für „glance-wear“ gilt. Daher ist die Anforderung für „compileSdk“ in dieser Version nicht mehr 37.

Version 1.0.0-alpha07

8. April 2026

androidx.glance.wear:wear:1.0.0-alpha07 und androidx.glance.wear:wear-core:1.0.0-alpha07 sind veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.

Neue Funktionen

  • Standardhintergrund für Wear-Widgets hinzufügen, wenn WearWidgetBrush leer oder nicht angegeben ist. (I8300b)
  • Die API getActiveWidgets wurde aktualisiert, um den Containertyp des Widgets zurückzugeben. (2772eb1)

API-Änderungen

  • Die API für Widget-Updates wurde geändert, um WidgetInstanceId zu verwenden, und eine Hilfsfunktion zum Abrufen von IDs für ein bestimmtes Widget wurde hinzugefügt. Die neue API löst IllegalArgumentException aus, wenn die angegebene ID ungültig ist oder nicht dem Aufrufer gehört. (I6f3c5, b/446828899)
  • Vertikalen und horizontalen Farbverlauf in WearWidgetBrush hinzugefügt. (If70ae, b/470080675)

Version 1.0.0-alpha06

25. März 2026

androidx.glance.wear:wear:1.0.0-alpha06 und androidx.glance.wear:wear-core:1.0.0-alpha06 sind veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.

Neue Funktionen

  • Die Vorgänge für das Profil von Wear-Widgets wurden inline definiert.

API-Änderungen

  • CONTAINER_TYPE_FULLSCREEN wurde in CONTAINER_TYPE_TILE_COMPAT umbenannt, um das Widget für die Kompatibilität mit dem Vollbildmodus besser zu unterscheiden. Dazu gehört auch das Zurücksetzen der Zuordnung des Typs FULLSCREEN zu LARGE in den Widget-Parametern.

Version 1.0.0-alpha05

11. März 2026

androidx.glance.wear:wear:1.0.0-alpha05 und androidx.glance.wear:wear-core:1.0.0-alpha05 sind veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.

API-Änderungen

  • Die WearWidgetBrush-API mit der Methode color für den Hintergrund von Wear-Widgets wurde hinzugefügt. (I66f54, b/464273091)
  • Die Methode fetchActiveWidgetsForProvider wurde entfernt, da bereits fetchActiveWidgets vorhanden ist. (I85e4e, b/486197890)

Version 1.0.0-alpha04

25. Februar 2026

androidx.glance.wear:wear:1.0.0-alpha04 und androidx.glance.wear:wear-core:1.0.0-alpha04 sind veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.

API-Änderungen

  • Die GlanceWearWidgetManager-API wurde hinzugefügt, damit Apps ihre aktiven Widgets und Kacheln abfragen können. (I5be95)
  • APIs aus der Bibliothek glance:wear:wear-core wurden in das Paket androidx.glance.wear.core verschoben. (I429cf)

Diverse Fehlerkorrekturen

  • Häufig verwendete Remote-Composable- und Modifier-Typen verfügbar gemacht (Id1d40)

Version 1.0.0-alpha03

11. Februar 2026

androidx.glance.wear:wear:1.0.0-alpha03 und androidx.glance.wear:wear-core:1.0.0-alpha03 sind veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.

API-Änderungen

  • Unterstützung für Interaktionsereignisse zu GlanceWearWidget hinzugefügt. (Ia4e28, b/469808447)

Version 1.0.0-alpha02

28. Januar 2026

androidx.glance.wear:wear:1.0.0-alpha02 und androidx.glance.wear:wear-core:1.0.0-alpha02 sind veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.

Neue Funktionen

  • FULLSCREEN in Widget-Parametern wieder LARGE zugeordnet (ad78d95)

Diverse Fehlerkorrekturen

  • Die Verwendung von DataStore wurde korrigiert, wodurch verhindert wurde, dass mehrere Widget-Instanzen angezeigt werden (474f3e4)

Version 1.0.0-alpha01

14. Januar 2026

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

  • Glance Wear ist eine Bibliothek zum Erstellen von Widgets für Wear OS mit RemoteCompose.