Glance Wear

  
Glance Wear to biblioteka do tworzenia widżetów na Wear OS
Najnowsza aktualizacja Wersja stabilna Wersja kandydująca do publikacji Wersja beta Wersja alfa
9 września 2026 r. - - - 1.0.0-alpha18

Deklarowanie zależności

Aby dodać zależność od biblioteki glance-wear, musisz dodać do projektu repozytorium Maven Google. Więcej informacji znajdziesz w repozytorium Maven Google.

Dodaj zależności od potrzebnych artefaktów w pliku build.gradle aplikacji lub modułu:

Odlotowe

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")
}

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Prześlij opinię

Twoja opinia pomoże nam ulepszyć Jetpacka. Daj nam znać, jeśli znajdziesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki. Zanim utworzysz nowy problem, zapoznaj się z istniejącymi problemami w tej bibliotece. Możesz dodać swój głos do istniejącego problemu, klikając przycisk gwiazdki.

Utwórz nowy problem

Więcej informacji znajdziesz w dokumentacji narzędzia do śledzenia problemów Issue Tracker documentation.

Glance Wear w wersji 1.0

Wersja 1.0.0-alpha18

9 września 2026 r.

Ukazały się wersje androidx.glance.wear:wear:1.0.0-alpha18, androidx.glance.wear:wear-core:1.0.0-alpha18 i androidx.glance.wear:wear-tooling-preview:1.0.0-alpha18. Wersja 1.0.0-alpha18 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodaliśmy parametr useSafeFallbackRendererVersion do WearWidgetPreview, aby umożliwić wyświetlanie podglądu widżetów z bezpiecznym zestawem operacji rezerwowych obsługiwanych przez starsze hosty. (I9c324)

Poprawki błędów

  • Zaktualizowaliśmy compileSdk dla bibliotek Compose do wersji 37.1. Będzie to wymagać przechodniego zaktualizowania compileSdk we wszystkich aplikacjach i bibliotekach korzystających z Compose. (I05b0f)
  • Dodaliśmy kontrolę lint, która ostrzega przed zbędnym użyciem parametru fontFamily w widżetach Wear. (I7730c)

Wersja 1.0.0-alpha17

26 sierpnia 2026 r.

Ukazały się wersje androidx.glance.wear:wear:1.0.0-alpha17, androidx.glance.wear:wear-core:1.0.0-alpha17 i androidx.glance.wear:wear-tooling-preview:1.0.0-alpha17. Wersja 1.0.0-alpha17 zawiera te zmiany.

Nowe funkcje

  • Dodaliśmy kontrole lint w Glance Wear, aby wymusić, że każdy element <container> w pliku XML <wearwidget-provider> z metadanymi widżetu wyraźnie określa obsługiwany atrybut typu i nie definiuje zduplikowanych typów. (I52c9a, b/464458215)

Wersja 1.0.0-alpha16

12 sierpnia 2026 r.

Ukazały się wersje androidx.glance.wear:wear:1.0.0-alpha16, androidx.glance.wear:wear-core:1.0.0-alpha16 i androidx.glance.wear:wear-tooling-preview:1.0.0-alpha16. Wersja 1.0.0-alpha16 zawiera te zmiany.

Nowe funkcje

  • Dodaliśmy walidację Lint dla metadanych XML <wearwidget-provider>, aby zapewnić obecność wymaganych elementów konfiguracji (takich jak container i previewImage). (Ia9983, b/464458215)
  • Dodaliśmy ostrzeżenie o błędzie Lint dotyczące ustawienia czarnego lub przezroczystego tła widżetu Wear (Idedb0, b/529269573).
  • Włączyliśmy operację zdalnego Compose CORE_TEXT dla profilu widżetów Wear. Dzięki temu RemoteText może korzystać z funkcji czcionek zmiennych, takich jak osie czcionek, wysokość wiersza itp., na obsługiwanych renderach hosta z automatycznym przejściem na starszą wersję, gdy nie jest obsługiwana.

Poprawki

  • Zaktualizowaliśmy KDocs dla adnotacji AssociateWithGlanceWearWidget zgodnie z opiniami deweloperów.

Wersja 1.0.0-alpha15

29 lipca 2026 r.

Ukazały się wersje androidx.glance.wear:wear:1.0.0-alpha15, androidx.glance.wear:wear-core:1.0.0-alpha15 i androidx.glance.wear:wear-tooling-preview:1.0.0-alpha15. Wersja 1.0.0-alpha15 zawiera te zmiany.

Nowe funkcje

  • Dodaliśmy ostrzeżenie Lint, gdy ustawisz puste tło dokumentu widżetu Wear. (Ic6475, b/529269573)

Wersja 1.0.0-alpha14

15 lipca 2026 r.

Ukazały się wersje androidx.glance.wear:wear:1.0.0-alpha14, androidx.glance.wear:wear-core:1.0.0-alpha14 i androidx.glance.wear:wear-tooling-preview:1.0.0-alpha14. Wersja 1.0.0-alpha14 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodaliśmy dostawców parametrów podglądu RoundAllWidgetPreviewParams, RoundSmallWidgetPreviewParams i RoundLargeWidgetPreviewParams dla w pełni zaokrąglonych widżetów Glance Wear. (If5336, b/512405233)

Nowe funkcje

  • Skonfigurowaliśmy i dodaliśmy bibliotekę Linter dla widżetów Glance Wear.(If4218, b/527402079)
    • Dodaliśmy kontrolę lint, aby zapewnić, że podklasy GlanceWearWidgetService wyraźnie deklarują powiązaną klasę widżetu za pomocą adnotacji @AssociateWithGlanceWearWidget. (Idc575, b/477024153)
  • Ulepszyliśmy zgodność wsteczną widżetów działających na starszych hostach, propagując obsługiwane operacje za pomocą WearWidgetParams i dodając filtrowanie profilu dozwolonych operacji. (Ib0a1b, I83cb1, [b/526716195])

Wersja 1.0.0-alpha13

1 lipca 2026 r.

Ukazały się wersje androidx.glance.wear:wear:1.0.0-alpha13, androidx.glance.wear:wear-core:1.0.0-alpha13 i androidx.glance.wear:wear-tooling-preview:1.0.0-alpha13. Wersja 1.0.0-alpha13 zawiera te zmiany.

Zmiany w interfejsie API

Poprawki błędów

  • Dostosowaliśmy parametry widżetu Wear w kształcie squircle na potrzeby podglądu zgodnie z opiniami użytkowników.

Wersja 1.0.0-alpha12

17 czerwca 2026 r.

Ukazały się wersje androidx.glance.wear:wear:1.0.0-alpha12, androidx.glance.wear:wear-core:1.0.0-alpha12 i androidx.glance.wear:wear-tooling-preview:1.0.0-alpha12. Wersja 1.0.0-alpha12 zawiera te zmiany.

Nowe funkcje

  • Dodaliśmy AssociateWithGlanceWearWidget, którego musisz użyć w GlanceWearWidgetService, aby określić, z którą implementacją GlanceWearWidget jest powiązany. (Ifcabb, b/514679763)

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

  • Dodaliśmy pędzel image do WearWidgetBrush, aby obsługiwać tła bitmapowe w widżetach Wear. (I9a228, b/513481558)

  • Wprowadziliśmy funkcję pomocniczą @Composable o nazwie WearWidgetPreview, aby uprościć tworzenie widżetów Glance Wear przez usunięcie kodu powtarzalnego wymaganego do podglądów w IDE.

Zmiany w interfejsie API

  • Zmieniliśmy nazwę androidx.glance.wear.health.DataType na androidx.glance.wear.health.HealthData (I4cb0b, b/516746689).
  • Udostępniliśmy isHeartRateBpmAvailable, aby określić, czy heartRateBpm jest dostępny na hoście. (I5999d, b/514641567)
  • Udostępniliśmy operatory porównania RemoteInt. (I5fe3d, b/513228889)
  • Udostępniliśmy interfejs API Flow captureRemoteDocument i nowe przeciążenie captureSingleRemoteDocument (które przyjmuje RemoteCreationDisplayInfo) jako publiczne interfejsy API. (I87b0e, b/513228889)
  • Dodaliśmy @CallSuper do metod cyklu życia GlanceWearWidgetService.

Wersja 1.0.0-alpha11

3 czerwca 2026 r.

Ukazały się wersje androidx.glance.wear:wear:1.0.0-alpha11, androidx.glance.wear:wear-core:1.0.0-alpha11 i androidx.glance.wear:wear-tooling-preview:1.0.0-alpha11. Wersja 1.0.0-alpha11 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodaliśmy WearWidgetPreview, aby umożliwić wyświetlanie podglądu widżetów Wear w Android Studio. (I36504, b/485147770)
  • Udostępniliśmy zmienne is*Available (isDailyStepsAvailable itp.), aby sprawdzić, czy powiązany typ danych o zdrowiu jest dostępny i prawidłowy. (Ib98a7, b/498179656)
  • Dodaliśmy interfejs API triggerUpdateAll do GlanceWearWidget, aby wywoływać aktualizację wszystkich widżetów danej aplikacji. (I6ab20, b/510896410)

Poprawki błędów

  • Dodaliśmy informacje o wersji renderera w WearWidgetParams jako pole wewnętrzne, aby zapobiec uszkodzeniu dokumentu wygenerowanego w wersji alpha10. (Idcf8e, b/511263591, b/512830184)
  • Włączyliśmy przepływ aktualizacji wymuszonej w trybie debugowania lub emulatorze dla widżetów Wear.

Wersja 1.0.0-alpha10

19 maja 2026 r.

Ukazały się wersje androidx.glance.wear:wear:1.0.0-alpha10, androidx.glance.wear:wear-core:1.0.0-alpha10 i androidx.glance.wear:wear-tooling-preview:1.0.0-alpha10. Wersja 1.0.0-alpha10 zawiera te zmiany.

Zmiany w interfejsie API

  • Udostępniliśmy interfejsy API glance.wear.health.DataType w widżecie Wear. Deweloperzy mogą używać tych interfejsów API do uzyskiwania dostępu do danych dotyczących zdrowia w systemie.

Poprawki błędów

  • Naprawiliśmy pętlę awarii występującą w wersji alpha09 na emulatorze Wear 7 lub urządzeniach z rendererem 1.6, uniemożliwiając wysyłanie pustej osi czcionki do odtwarzacza w przypadku widżetu Glance Wear.

Wersja 1.0.0-alpha09

6 maja 2026 r.

Ukazały się wersje androidx.glance.wear:wear:1.0.0-alpha09 i androidx.glance.wear:wear-core:1.0.0-alpha09. Wersja 1.0.0-alpha09 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodaliśmy ExperimentalGlanceWearApi, który będzie używany w przypadku eksperymentalnych funkcji Glance Wear. (Id2f76, b/498179813)

Poprawki błędów

  • Zaktualizowaliśmy parser metadanych XML widżetu Wear, aby uwzględniał widżety podczas uruchamiania.

Wersja 1.0.0-alpha08

22 kwietnia 2026 r.

Ukazały się wersje androidx.glance.wear:wear:1.0.0-alpha08 i androidx.glance.wear:wear-core:1.0.0-alpha08. Wersja 1.0.0-alpha08 zawiera te zmiany.

Poprawki błędów

  • Dodaliśmy tag <queries> do manifestu biblioteki glance:wear:wear, aby mieć pewność, że PackageManager wysyła zapytania do prawidłowych usług w celu uzyskania aktualizacji push. (I192787)

Inne

  • Cofnęliśmy zmianę "Aktualizuje compileSdk Compose do wersji 37" (I6007), która dotyczy też glance-wear, więc w tej wersji wymaganie compileSdk nie wynosi już 37.

Wersja 1.0.0-alpha07

8 kwietnia 2026 r.

Ukazały się wersje androidx.glance.wear:wear:1.0.0-alpha07 i androidx.glance.wear:wear-core:1.0.0-alpha07. Wersja 1.0.0-alpha07 zawiera te zmiany.

Nowe funkcje

  • Dodaliśmy domyślne tło widżetu Wear, gdy WearWidgetBrush jest pusty lub nieokreślony. (I8300b)
  • Zaktualizowaliśmy interfejs API getActiveWidgets, aby zwracał typ kontenera widżetu. (2772eb1)

Zmiany w interfejsie API

  • Zmieniliśmy interfejs API aktualizacji widżetu, aby przyjmował WidgetInstanceId, i dodaliśmy pomocnika do pobierania identyfikatorów danego widżetu. Nowy interfejs API zgłasza wyjątek IllegalArgumentException, jeśli podany identyfikator jest nieprawidłowy lub nie należy do wywołującego. (I6f3c5, b/446828899)
  • Dodaliśmy gradient pionowy i poziomy w WearWidgetBrush. (If70ae, b/470080675)

Wersja 1.0.0-alpha06

25 marca 2026 r.

Ukazały się wersje androidx.glance.wear:wear:1.0.0-alpha06 i androidx.glance.wear:wear-core:1.0.0-alpha06. Wersja 1.0.0-alpha06 zawiera te zmiany.

Nowe funkcje

  • Zdefiniowaliśmy operacje dla profilu widżetów Wear w tekście.

Zmiany w interfejsie API

  • Zmieniliśmy nazwę CONTAINER_TYPE_FULLSCREEN na CONTAINER_TYPE_TILE_COMPAT, aby lepiej odróżnić widżet zgodności z pełnym ekranem. Obejmuje to przywrócenie mapowania typu FULLSCREEN na LARGE w parametrach widżetu.

Wersja 1.0.0-alpha05

11 marca 2026 r.

Ukazały się wersje androidx.glance.wear:wear:1.0.0-alpha05 i androidx.glance.wear:wear-core:1.0.0-alpha05. Wersja 1.0.0-alpha05 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodaliśmy interfejs API WearWidgetBrush z metodą color, która będzie używana do tła widżetu Wear. (I66f54, b/464273091)
  • Usunęliśmy metodę fetchActiveWidgetsForProvider, ponieważ istnieje już metoda fetchActiveWidgets. (I85e4e, b/486197890)

Wersja 1.0.0-alpha04

25 lutego 2026 r.

Ukazały się wersje androidx.glance.wear:wear:1.0.0-alpha04 i androidx.glance.wear:wear-core:1.0.0-alpha04. Wersja 1.0.0-alpha04 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodaliśmy interfejs API GlanceWearWidgetManager, aby umożliwić aplikacjom wysyłanie zapytań o aktywne widżety i karty. (I5be95)
  • Przenieśliśmy interfejsy API z biblioteki glance:wear:wear-core do pakietu androidx.glance.wear.core. (I429cf)

Poprawki błędów

  • Udostępniliśmy typowe typy zdalnych elementów kompozycyjnych i modyfikatorów (Id1d40).

Wersja 1.0.0-alpha03

11 lutego 2026 r.

Ukazały się wersje androidx.glance.wear:wear:1.0.0-alpha03 i androidx.glance.wear:wear-core:1.0.0-alpha03. Wersja 1.0.0-alpha03 zawiera te zmiany.

Zmiany w interfejsie API

Wersja 1.0.0-alpha02

28 stycznia 2026 r.

Ukazały się wersje androidx.glance.wear:wear:1.0.0-alpha02 i androidx.glance.wear:wear-core:1.0.0-alpha02. Wersja 1.0.0-alpha02 zawiera te zmiany.

Nowe funkcje

  • Zmieniliśmy mapowanie FULLSCREEN na LARGE w parametrach widżetu (ad78d95).

Poprawki błędów

  • Naprawiliśmy użycie DataStore, które uniemożliwiało wyświetlanie wielu instancji widżetu (474f3e4).

Wersja 1.0.0-alpha01

14 stycznia 2026 r.

Ukazały się wersje androidx.glance.wear:wear:1.0.0-alpha01 i androidx.glance.wear:wear-core:1.0.0-alpha01. Wersja 1.0.0-alpha01 zawiera te zmiany.

  • Glance Wear to biblioteka do tworzenia widżetów na Wear OS za pomocą RemoteCompose.