Glance Wear

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

Abhängigkeiten deklarieren

Wenn Sie eine Abhängigkeit von „glance-wear“ hinzufügen möchten, müssen Sie Ihrem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie unter Google-Repository bei Maven.

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

Cool

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

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

Kotlin

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

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

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-alpha19

23. September 2026

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

Nur Änderungen an internen Tests.

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 WearWidgetPreview hinzugefügt, damit Widgets mit einer sicheren Fallback-Gruppe unterstützter Vorgänge für ältere Hosts in der Vorschau angezeigt werden können. (I9c324)

Fehlerkorrekturen

  • compileSdk für Compose-Bibliotheken auf Version 37.1 aktualisiert. Dazu muss compileSdk für alle Apps und Bibliotheken, die Compose verwenden, transitiv aktualisiert werden. (I05b0f)
  • Es wurde eine 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

  • Wir haben Lint-Prüfungen in Glance Wear hinzugefügt, um zu erzwingen, dass für jedes <container> in einem <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

  • Es wurde eine Lint-Validierung für <wearwidget-provider>-XML-Metadaten hinzugefügt, um sicherzustellen, dass erforderliche Konfigurationselemente wie 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)
  • Die Funktion CORE_TEXT„Remote Compose“ für das Wear-Widgets-Profil wurde aktiviert. So kann RemoteText variable Schriftfunktionen wie Schriftachsen und Zeilenhöhen auf unterstützten Host-Renderern verwenden. Wenn die Funktion nicht unterstützt wird, erfolgt ein automatischer Fallback.

Diverse Fehlerkorrekturen

  • KDocs für die Annotation AssociateWithGlanceWearWidget wurden basierend auf dem Feedback von Entwicklern 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

  • Dem Wear-Widget-Dokument wurde eine Lint-Warnung hinzugefügt, wenn 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

  • Wir haben die Vorschauparameteranbieter RoundAllWidgetPreviewParams, RoundSmallWidgetPreviewParams und RoundLargeWidgetPreviewParams für vollständig abgerundete Glance Wear-Widgets hinzugefügt. (If5336, b/512405233)

Neue Funktionen

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

Version 1.0.0-alpha13

01. 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

Diverse Fehlerkorrekturen

  • Wir haben die Parameter für das Wear-Widget in Squircle-Form für die Vorschau basierend auf 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

  • AssociateWithGlanceWearWidget hinzugefügt, die auf der GlanceWearWidgetService verwendet werden muss, um anzugeben, mit welcher Implementierung von GlanceWearWidget sie verknüpft ist. (Ifcabb, b/514679763)

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

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

  • Wir haben die @Composable-Hilfsfunktion WearWidgetPreview eingeführt, um die Entwicklung von Glance Wear-Widgets zu vereinfachen. Dazu wird der Boilerplate-Code entfernt, 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 bereitgestellt, um festzustellen, ob heartRateBpm auf dem Host verfügbar ist. (I5999d, b/514641567)
  • RemoteInt-Vergleichsoperatoren verfügbar gemacht. (I5fe3d, b/513228889)
  • Die captureRemoteDocument Flow API und eine neue captureSingleRemoteDocument-Überladung (mit RemoteCreationDisplayInfo) wurden als öffentliche APIs verfügbar gemacht. (I87b0e, b/513228889)
  • Wir haben @CallSuper den GlanceWearWidgetService-Lebenszyklusmethoden 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

  • Wir haben WearWidgetPreview für die Vorschau von Wear-Widgets in Android Studio hinzugefügt. (I36504, b/485147770)
  • is*Available-Variablen (isDailyStepsAvailable usw.) verfügbar machen, 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)

Fehlerkorrekturen

  • Fügen Sie Informationen zur Renderer-Version als internes Feld in WearWidgetParams ein, um zu verhindern, dass das mit der Alpha10-Version generierte Dokument beschädigt wird. (Idcf8e, b/511263591, b/512830184)
  • Aktualisierungsablauf für Wear-Widgets im Debug-Modus oder Emulator erzwingen

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

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

Fehlerkorrekturen

  • Ein Absturz, der in der Version alpha09 auf Wear 7-Emulatoren oder Geräten mit dem 1.6-Renderer auftrat, wurde behoben. Dazu wurde verhindert, 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

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

Fehlerkorrekturen

  • Der Parser für Wear-Widget-XML-Metadaten wurde aktualisiert, um Widgets beim Booten zu berücksichtigen.

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.

Fehlerkorrekturen

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

Sonstiges

  • Die Änderung „Updates Compose compileSdk to 37“ (I6007) wurde zurückgesetzt. Sie gilt auch für glance-wear. Die Anforderung für compileSdk ist in dieser Version also 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

  • Standardmäßigen Wear-Widget-Hintergrund hinzufügen, wenn WearWidgetBrush leer oder nicht angegeben ist. (I8300b)
  • Die getActiveWidgets API wurde aktualisiert, um den Containertyp des Widgets zurückzugeben. (2772eb1)

API-Änderungen

  • Die Widget-Update-API wurde so geändert, dass sie WidgetInstanceId akzeptiert. Außerdem wurde ein Helfer zum Abrufen von IDs für ein bestimmtes Widget hinzugefügt. Die neue API gibt IllegalArgumentException zurück, wenn die angegebene ID ungültig ist oder nicht dem Aufrufer gehört. (I6f3c5, b/446828899)
  • Fügen Sie in WearWidgetBrush einen vertikalen und einen horizontalen Farbverlauf hinzu. (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

  • Definieren Sie die Vorgänge für das Wear-Widgets-Profil inline.

API-Änderungen

  • Wir haben CONTAINER_TYPE_FULLSCREEN in CONTAINER_TYPE_TILE_COMPAT umbenannt, um das Widget für die Vollbildkompatibilität 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

  • Wir haben die WearWidgetBrushAPI mit der Methode color für den Hintergrund von Wear-Widgets 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)
  • Wir haben APIs aus der glance:wear:wear-core-Bibliothek in das androidx.glance.wear.core-Paket verschoben. (I429cf)

Fehlerkorrekturen

  • Häufig verwendete Remote-Composable- und Modifier-Typen verfügbar machen (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 in 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 LARGE zuordnen (ad78d95)

Fehlerkorrekturen

  • Die Verwendung von DataStore wurde korrigiert, um zu verhindern, 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.