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
7 października 2026 r. - - - 1.0.0-alpha20

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:

Odlotowe

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

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

Kotlin

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

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

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

7 października 2026 r.

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

Zmiany w interfejsie API

  • Dodano stałe CATEGORY_PROVIDER_CONFIG, EXTRA_CONFIG_WIDGET_ID i EXTRA_CONFIG_PROVIDER_COMPONENT do elementu GlanceWearWidget na potrzeby obsługi intencji konfiguracji dostawcy widżetu. (I32fa4)
  • Zmieniono nazwę parametru useSafeFallbackRendererVersion w pliku WearWidgetPreview na useBaselineHostVersion. (I07bca)

Poprawki błędów

  • Naprawiliśmy aktualizacje widżetów w emulatorze zasobnika widżetów podczas wywoływania funkcji triggerUpdateAll w wersjach z możliwością debugowania. (I22d3f)
  • Zmieniliśmy domyślną wartość useSafeFallbackRendererVersion w WearWidgetPreview z true na false, aby podglądy były domyślnie renderowane w najnowszej wersji renderera. (Ied6b9)

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 metadanych 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 zapewnić obecność wymaganych elementów konfiguracji (takich jak container i previewImage). (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

  • Dodano ostrzeżenie Lint podczas ustawiania pustego tła w dokumencie widżetu na Wear. (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, aby zapewnić pełną funkcjonalność 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 standardowego wymaganego w przypadku podglądów w IDE.

Zmiany w interfejsie API

  • Zmieniono nazwę androidx.glance.wear.health.DataType 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 Wear 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 API triggerUpdateAll 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. Deweloperzy mogą używać tych interfejsów API do uzyskiwania dostępu do danych dotyczących zdrowia.

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.

androidx.glance.wear:wear:1.0.0-alpha09 i androidx.glance.wear:wear-core:1.0.0-alpha09 zostały opublikowane. Wersja 1.0.0-alpha09 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodaliśmy ExperimentalGlanceWearApi, które będą 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.

androidx.glance.wear:wear:1.0.0-alpha08 i androidx.glance.wear:wear-core:1.0.0-alpha08 zostały opublikowane. 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ż glance-wear, więc w tej wersji wymaganie compileSdk nie wynosi już 37.

Wersja 1.0.0-alpha07

8 kwietnia 2026 r.

androidx.glance.wear:wear:1.0.0-alpha07 i androidx.glance.wear:wear-core:1.0.0-alpha07 zostały opublikowane. 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.

androidx.glance.wear:wear:1.0.0-alpha06 i androidx.glance.wear:wear-core:1.0.0-alpha06 zostały opublikowane. Wersja 1.0.0-alpha06 zawiera te zmiany.

Nowe funkcje

  • Zdefiniuj operacje w profilu widżetów na zegarek Wear.

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 na LARGE w parametrach widżetu.

Wersja 1.0.0-alpha05

11 marca 2026 r.

androidx.glance.wear:wear:1.0.0-alpha05 i androidx.glance.wear:wear-core:1.0.0-alpha05 zostały opublikowane. 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ż fetchActiveWidgets. (I85e4e, b/486197890)

Wersja 1.0.0-alpha04

25 lutego 2026 r.

androidx.glance.wear:wear:1.0.0-alpha04 i androidx.glance.wear:wear-core:1.0.0-alpha04 zostały opublikowane. 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.

androidx.glance.wear:wear:1.0.0-alpha03 i androidx.glance.wear:wear-core:1.0.0-alpha03 zostały opublikowane. Wersja 1.0.0-alpha03 zawiera te zmiany.

Zmiany w interfejsie API

Wersja 1.0.0-alpha02

28 stycznia 2026 r.

androidx.glance.wear:wear:1.0.0-alpha02 i androidx.glance.wear:wear-core:1.0.0-alpha02 zostały opublikowane. 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.

androidx.glance.wear:wear:1.0.0-alpha01 i androidx.glance.wear:wear-core:1.0.0-alpha01 zostały opublikowane. Wersja 1.0.0-alpha01 zawiera te zmiany.

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