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
23 września 2026 r. - - - 1.0.0-alpha19

Deklarowanie zależności

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

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

Groovy

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

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. Jeśli odkryjesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nową kartę, zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz oddać głos na istniejący problem, klikając przycisk gwiazdki.

Tworzenie nowego problemu

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Glance Wear w wersji 1.0

Wersja 1.0.0-alpha19

23 września 2026 r.

androidx.glance.wear:wear:1.0.0-alpha19, androidx.glance.wear:wear-core:1.0.0-alpha19 i androidx.glance.wear:wear-tooling-preview:1.0.0-alpha19 są udostępnione. Wersja 1.0.0-alpha19 zawiera te zmiany.

Zmiany tylko w testach wewnętrznych.

Wersja 1.0.0-alpha18

9 września 2026 r.

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 są udostępnione. Wersja 1.0.0-alpha18 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodano parametr useSafeFallbackRendererVersion do funkcji WearWidgetPreview, aby umożliwić wyświetlanie podglądu widżetów z bezpiecznym zestawem operacji rezerwowych dla starszych hostów. (I9c324)

Poprawki błędów

  • compileSdk bibliotek Compose zaktualizowanych do wersji 37.1. Wymaga to przechodniego zaktualizowania compileSdk we wszystkich aplikacjach i bibliotekach korzystających z Compose. (I05b0f)
  • Dodaliśmy sprawdzanie kodu, aby ostrzegać przed zbędnym użyciem parametru fontFamily w widżetach na Wear. (I7730c)

Wersja 1.0.0-alpha17

26 sierpnia 2026 r.

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 są udostępnione. Wersja 1.0.0-alpha17 zawiera te zmiany.

Nowe funkcje

  • Dodano sprawdzanie kodu w Glance Wear, aby wymusić, że każdy element <container> w pliku <wearwidget-provider> XML 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.

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 są udostępnione. Wersja 1.0.0-alpha16 zawiera te zmiany.

Nowe funkcje

  • Dodano weryfikację Lint dla metadanych XML <wearwidget-provider>, aby upewnić się, że wymagane elementy konfiguracji (takie jak container i previewImage) są obecne. (Ia9983, b/464458215)
  • Dodano ostrzeżenie o błędzie lintera dotyczące ustawienia czarnego lub przezroczystego tła widżetu na urządzeniu z Wear OS (Idedb0, b/529269573)
  • Włączono CORE_TEXT zdalne pisanie wiadomości w przypadku profilu widżetów na zegarku. Dzięki temu RemoteText może korzystać z funkcji zmiennych czcionek, takich jak osie czcionek, wysokość wiersza itp., na obsługiwanych renderach hosta z automatycznym powrotem do poprzedniej wersji, gdy nie są one obsługiwane.

Poprawki

  • Zaktualizowano dokumentację KDoc dla adnotacji AssociateWithGlanceWearWidget na podstawie opinii deweloperów.

Wersja 1.0.0-alpha15

29 lipca 2026 r.

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 są udostępnione. Wersja 1.0.0-alpha15 zawiera te zmiany.

Nowe funkcje

  • Dodaliśmy ostrzeżenie Lint, które się wyświetla, gdy w dokumencie widżetu na Wear ustawiono puste tło. (Ic6475, b/529269573)

Wersja 1.0.0-alpha14

15 lipca 2026 r.

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 są udostępnione. 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 sprawdzanie kodu, aby upewnić się, że podklasy GlanceWearWidgetService jawnie 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 do nich filtrowanie profilu dozwolonych operacji. (Ib0a1b, I83cb1, [b/526716195])

Wersja 1.0.0-alpha13

1 lipca 2026 r.

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 są udostępnione. 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 zaokrąglonego kwadratu na potrzeby podglądu na podstawie opinii użytkowników.

Wersja 1.0.0-alpha12

17 czerwca 2026 r.

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 są udostępnione. Wersja 1.0.0-alpha12 zawiera te zmiany.

Nowe funkcje

  • Dodano AssociateWithGlanceWearWidget, które musi być używane w GlanceWearWidgetService, aby wskazać, z którą implementacją GlanceWearWidget jest powiązane. (Ifcabb, b/514679763)

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

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

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

Zmiany w interfejsie API

  • Nazwa androidx.glance.wear.health.DataType została zmieniona na androidx.glance.wear.health.HealthData (I4cb0b, b/516746689)
  • isHeartRateBpmAvailable jest udostępniana, aby określić, czy heartRateBpm jest dostępna na hoście. (I5999d, b/514641567)
  • Udostępniono operatory porównania RemoteInt. (I5fe3d, b/513228889)
  • Udostępniliśmy interfejs captureRemoteDocument Flow API 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.

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 są udostępnione. Wersja 1.0.0-alpha11 zawiera te zmiany.

Zmiany w interfejsie API

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

Poprawki błędów

  • Dodaj informacje o wersji renderera w WearWidgetParams jako pole wewnętrzne, aby zapobiec uszkodzeniu dokumentu wygenerowanego w wersji alpha10. (Idcf8e, b/511263591, b/512830184)
  • Uruchamianie przepływu aktualizacji wymuszonej w trybie debugowania lub na emulatorze w przypadku widżetów na Wear.

Wersja 1.0.0-alpha10

19 maja 2026 r.

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 są udostępnione. Wersja 1.0.0-alpha10 zawiera te zmiany.

Zmiany w interfejsie API

  • Udostępnij interfejsy glance.wear.health.DataType API w widżecie na zegarek. Programiści mogą używać tych interfejsów API do uzyskiwania dostępu do danych o stanie systemu.

Poprawki błędów

  • Naprawiono pętlę awarii występującą w wersji alpha09 na emulatorze Wear 7 lub urządzeniach z renderem 1.6, uniemożliwiając wysyłanie pustej osi czcionki do odtwarzacza w przypadku widżetu Szybkiego podglądu na Wear.

Wersja 1.0.0-alpha09

6 maja 2026 r.

Publikacja 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óre będzie używane w eksperymentalnych funkcjach Glance Wear. (Id2f76, b/498179813)

Poprawki błędów

  • Zaktualizowano parser metadanych XML widżetu na zegarek Wear, aby rozpoznawał widżety podczas uruchamiania.

Wersja 1.0.0-alpha08

22 kwietnia 2026 r.

Publikacja 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

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

Inne

  • Cofnięto zmianę „Updates Compose compileSdk to 37” (I6007), która dotyczy też biblioteki glance-wear, więc w tej wersji wymaganie compileSdk nie wynosi już 37.

Wersja 1.0.0-alpha07

8 kwietnia 2026 r.

Publikacja 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

  • Dodaj domyślne tło widżetu Wear, gdy pole WearWidgetBrush jest puste lub nie zostało określone. (I8300b)
  • Zaktualizuj interfejs getActiveWidgets API, aby zwracał typ kontenera widżetu. (2772eb1)

Zmiany w interfejsie API

  • Zmiana interfejsu API aktualizacji widżetu, aby przyjmował wartość WidgetInstanceId, i dodanie funkcji pomocniczej do pobierania identyfikatorów danego widżetu. Nowy interfejs API zwraca błąd IllegalArgumentException, jeśli podany identyfikator jest nieprawidłowy lub nie należy do wywołującego. (I6f3c5, b/446828899)
  • Dodaj gradient pionowy i poziomy w WearWidgetBrush. (If70ae, b/470080675)

Wersja 1.0.0-alpha06

25 marca 2026 r.

Publikacja 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

  • Zdefiniuj operacje dla profilu widżetów na Wear w formie wbudowanej.

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 wcześniej FULLSCREEN typu LARGE w parametrach widżetu.

Wersja 1.0.0-alpha05

11 marca 2026 r.

Publikacja 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 WearWidgetBrushinterfejs API z metodą color, która będzie używana w przypadku tła widżetu na zegarku. (I66f54, b/464273091)
  • Forma płatności fetchActiveWidgetsForProvider została usunięta, ponieważ istnieje już forma płatności fetchActiveWidgets. (I85e4e, b/486197890)

Wersja 1.0.0-alpha04

25 lutego 2026 r.

Publikacja 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

  • Dodano interfejs GlanceWearWidgetManager API, który umożliwia aplikacjom wysyłanie zapytań o aktywne widżety i kafelki. (I5be95)
  • Przenieśliśmy interfejsy API z biblioteki glance:wear:wear-core do pakietu androidx.glance.wear.core. (I429cf)

Poprawki błędów

  • Udostępnianie typów Remote Composable i Modifier (Id1d40)

Wersja 1.0.0-alpha03

11 lutego 2026 r.

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

Publikacja 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

  • Zmiana mapowania FULLSCREEN na LARGE w parametrach widżetu (ad78d95)

Poprawki błędów

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

Wersja 1.0.0-alpha01

14 stycznia 2026 r.

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