Karty na Wear

tworzyć aplikacje na zegarki z Wear OS by Google.
Ostatnia aktualizacja Wersja stabilna Wersja kandydująca Wersja Beta Wersja alfa
11 grudnia 2024 r. 1.4.1 - - 1.5.0-alpha05

Deklarowanie zależności

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

Dodaj zależności dla artefaktów, których potrzebujesz, w pliku build.gradle aplikacji lub modułu:

Groovy

dependencies {
    // Use to implement support for wear tiles
    implementation "androidx.wear.tiles:tiles:1.5.0-alpha04"

    // Use to utilize standard components and layouts in your tiles
    implementation "androidx.wear.protolayout:protolayout:1.3.0-alpha04"

    // Use to utilize components and layouts with Material Design in your tiles
    implementation "androidx.wear.protolayout:protolayout-material:1.3.0-alpha04"

    // Use to include dynamic expressions in your tiles
    implementation "androidx.wear.protolayout:protolayout-expression:1.3.0-alpha04"

    // Use to preview wear tiles in your own app
    debugImplementation "androidx.wear.tiles:tiles-renderer:1.5.0-alpha04"

    // Use to fetch tiles from a tile provider in your tests
    testImplementation "androidx.wear.tiles:tiles-testing:1.5.0-alpha04"
}

Kotlin

dependencies {
    // Use to implement support for wear tiles
    implementation("androidx.wear.tiles:tiles:1.5.0-alpha04")

    // Use to utilize standard components and layouts in your tiles
    implementation("androidx.wear.protolayout:protolayout:1.3.0-alpha04")

    // Use to utilize components and layouts with Material Design in your tiles
    implementation("androidx.wear.protolayout:protolayout-material:1.3.0-alpha04")

    // Use to include dynamic expressions in your tiles
    implementation("androidx.wear.protolayout:protolayout-expression:1.3.0-alpha04")

    // Use to preview wear tiles in your own app
    debugImplementation("androidx.wear.tiles:tiles-renderer:1.5.0-alpha04")

    // Use to fetch tiles from a tile provider in your tests
    testImplementation("androidx.wear.tiles:tiles-testing:1.5.0-alpha04")
}

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

Opinia

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

Tworzenie nowego zgłoszenia

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

Wersja 1.5

Wersja 1.5.0-alpha05

11 grudnia 2024 r.

androidx.wear.tiles:tiles-*:1.5.0-alpha05 został zwolniony. Wersja 1.5.0-alpha05 zawiera te komisy.

Nowe funkcje

  • Dodaj interfejs API dla TileService, aby przetwarzać zdarzenia interakcji partiami. (I04d1b)

Poprawki błędów

  • Biblioteka ta korzysta teraz z adnotacji JSpecify dotyczących nullowania, które są używane w zależności od typu. Deweloperzy Kotlina powinni używać tych argumentów kompilatora, aby wymusić prawidłowe użycie: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode (I390e9, b/326456246)
  • Usunięto błąd, który powodował, że wysyłanie żądań aktualizacji kafelków w interfejsie API 34, gdy aplikacja targetSdk ma wyższą wersję niż 34, powodowało błąd SecurityException (If62a1).
  • Naprawiono zależność od WearSdk w testach Robolectric. (I37796)

Wersja 1.5.0-alpha04

13 listopada 2024 r.

androidx.wear.tiles:tiles-*:1.5.0-alpha04 został zwolniony. Wersja 1.5.0-alpha04 zawiera te komity.

Wersja 1.5.0-alpha03

30 października 2024 r.

androidx.wear.tiles:tiles-*:1.5.0-alpha03 został zwolniony. Wersja 1.5.0-alpha03 zawiera te komity.

Wersja 1.5.0-alpha02

16 października 2024 r.

androidx.wear.tiles:tiles-*:1.5.0-alpha02 został zwolniony. Wersja 1.5.0-alpha02 zawiera te komity.

Poprawki dotyczące bezpieczeństwa

  • Od momentu wprowadzenia tej zmiany androidx kompiluje się z użyciem protobuf 4.28.2, aby rozwiązać problem CVE-2024-7254. Aby rozwiązać problem z luką w zabezpieczeniach, zaktualizuj zależność od wersji androidx.wear.tiles:tiles-proto 1.5.0-alpha01 do wersji 1.5.0-alpha02.

Wersja 1.5.0-alpha01

2 października 2024 r.

androidx.wear.tiles:tiles-*:1.5.0-alpha01 został zwolniony. Wersja 1.5.0-alpha01 zawiera te komity.

Wersja 1.4

Wersja 1.4.1

16 października 2024 r.

androidx.wear.tiles:tiles-*:1.4.1 został zwolniony. Wersja 1.4.1 zawiera te komity.

Poprawki dotyczące bezpieczeństwa

  • Od momentu wprowadzenia tej zmiany androidx kompiluje się z użyciem protobuf 4.28.2, aby rozwiązać problem CVE-2024-7254. Aby rozwiązać problem z luką w zabezpieczeniach, zaktualizuj zależność od wersji 1.4.0 pakietu androidx.wear.tiles:tiles-proto do wersji 1.4.1.

Wersja 1.4.0

7 sierpnia 2024 r.

androidx.wear.tiles:tiles-*:1.4.0 został zwolniony. Wersja 1.4.0 zawiera te komitowane zmiany.

Ważne zmiany od wersji 1.3.0

  • Obsługa narzędzi do określania niestandardowych danych platformy na potrzeby podglądów kafelków w Android Studio.

Wersja 1.4.0-rc01

24 lipca 2024 r.

androidx.wear.tiles:tiles-*:1.4.0-rc01 nie wprowadza żadnych zmian w porównaniu z poprzednią wersją. Wersja 1.4.0-rc01 zawiera te komisy.

Wersja 1.4.0-beta01

10 lipca 2024 r.

androidx.wear.tiles:tiles-*:1.4.0-beta01 został zwolniony. Wersja 1.4.0-beta01 zawiera te komity.

Nowe funkcje

Wersja 1.4.0-beta01 pakietu Wear Tiles oznacza, że ta wersja biblioteki jest kompletna pod względem funkcji, a interfejs API jest zablokowany (z wyjątkiem wersji oznaczonych jako eksperymentalne). Wersja 1.4 usługi na tarczę na Wear OS zawiera te nowe funkcje i interfejsy API:

  • Obsługa narzędzi do określania niestandardowych danych platformy na potrzeby podglądów kafelków w Android Studio.

Wersja 1.4.0-alpha05

26 czerwca 2024 r.

androidx.wear.tiles:tiles-*:1.4.0-alpha05 został zwolniony. Wersja 1.4.0-alpha05 zawiera te komisy.

Wersja 1.4.0-alpha04

29 maja 2024 r.

androidx.wear.tiles:tiles-*:1.4.0-alpha04 został zwolniony. Wersja 1.4.0-alpha04 zawiera te komisy.

Wersja 1.4.0-alpha03

14 maja 2024 r.

androidx.wear.tiles:tiles-*:1.4.0-alpha03 został zwolniony. Wersja 1.4.0-alpha03 zawiera te komity.

Poprawki błędów

  • TileService#getActiveTilesAsync korzysta teraz z interfejsu API WearSdk (jeśli jest dostępny), aby wyświetlać dokładniejsze wyniki. (I57bd8)

Wersja 1.4.0-alpha02

1 maja 2024 r.

androidx.wear.tiles:tiles-*:1.4.0-alpha02 został zwolniony. Wersja 1.4.0-alpha02 zawiera te komity.

Zmiany w interfejsie API

  • Przenieś tileId do parametru konstruktora Buildera jako wymagane pole i zdefiniuj domyślną wartość sygnatury czasowej dokumentu w metodzie gettera. (I98c2b)
  • Dodaj protokoły TileInteractionEvent, TileEnter i TileLeave oraz opakowania Java potrzebne do grupowania zdarzeń wejścia/wyjścia z kafelka. (I112b0)
  • Przerzuć kod TileRenderer, aby zamiast obiektu TileRenderer.Config używać konstruktora. (Ib66f9)
  • Dodaj atrybut platformDataProviders do tagu TileRenderer.Config. (I6030d)
  • Dodaj do klasy TileRenderer nowy konstruktor obsługujący nową klasę TileRenderer.Config. Inne konstruktory są wycofane. (Iae7ff)
  • Dodaj pole platformDataValues do pola TilePreviewData, aby umożliwić zastąpienie wartości danych platformy. (If437a)

Poprawki błędów

  • Udokumentuj, że domyślną wartością dla TileRenderer.Config.Builder#setTilesTheme jest 0. (Iced18)

Wersja 1.4.0-alpha01

6 marca 2024 roku

androidx.wear.tiles:tiles-*:1.4.0-alpha01 został zwolniony. Wersja 1.4.0-alpha01 zawiera te komisy.

Wersja 1.3

Wersja 1.3.0

7 lutego 2024 r.

androidx.wear.tiles:tiles-*:1.3.0 został zwolniony. Wersja 1.3.0 zawiera te commity.

Ważne zmiany od wersji 1.2.0

  • Zaktualizowano narzędzia do obsługi podglądu kafelków.
  • Obsługa zapytań dotyczących aktywnych kart należących do aplikacji.

Dodatkowe zmiany

Wersja 1.3.0-rc01

24 stycznia 2024 r.

androidx.wear.tiles:tiles-*:1.3.0-rc01 został zwolniony. Wersja 1.3.0-rc01 zawiera te commity.

Zmiany w interfejsie API

  • Nazwa TileService#getActiveTilesSnapshotAsync została zmieniona na getActiveTilesAsync. (If6b87)

Wersja 1.3.0-beta01

10 stycznia 2024 r.

androidx.wear.tiles:tiles-*:1.3.0-beta01 został zwolniony. Wersja 1.3.0-beta01 zawiera te zatwierdzenia.

Wersja 1.3.0-beta01 pakietu Wear Tiles oznacza, że ta wersja biblioteki jest kompletna pod względem funkcji, a interfejs API jest zablokowany (z wyjątkiem wersji oznaczonych jako eksperymentalne). Interfejs Wear Tiles w wersji 1.3 zawiera te nowe funkcje i interfejsy API:

  • Moduł narzędzi do tworzenia kafelków na Wear OS został zaktualizowany, aby obsługiwał podgląd kafelków. Jest gotowy do opublikowania.
  • Obsługa zapytań o to, które karty należące do aplikacji są aktywne z użyciem TileService.getActiveTilesSnapshotAsync.

Wersja 1.3.0-alpha04

13 grudnia 2023 r.

androidx.wear.tiles:tiles-*:1.3.0-alpha04 został zwolniony. Wersja 1.3.0-alpha04 zawiera te commity.

Wersja 1.3.0-alpha03

29 listopada 2023 r.

androidx.wear.tiles:tiles-*:1.3.0-alpha03 został zwolniony. Wersja 1.3.0-alpha03 zawiera te commity.

Nowe funkcje

  • Dodano nowy interfejs API TileService#getActiveTilesSnapshotAsync do zapytań o to, które elementy należące do aplikacji są aktywne. (I6850e)

Zmiany w interfejsie API

  • Zmień nazwę @TilePreview na @Preview (Ifc08a)

Wersja 1.3.0-alpha02

15 listopada 2023 r.

androidx.wear.tiles:tiles-*:1.3.0-alpha02 został zwolniony. Wersja 1.3.0-alpha02 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodaliśmy eksperymentalny interfejs API, który automatycznie dostosowuje rozmiar tekstu do miejsca, jakie zajmuje w elemencie nadrzędnym. (Ibbe63)

Wersja 1.3.0-alpha01

18 października 2023 r.

androidx.wear.tiles:tiles-*:1.3.0-alpha01 został zwolniony. Wersja 1.3.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

  • Prześlij kontekst jako parametr metody podglądu zamiast parametrów wywołania zwrotnego TilePreviewData. (I5e97d)
  • Moduł narzędzi do obsługi kafelków na Wear OS został zaktualizowany, aby obsługiwać podgląd kafelków. Jest gotowy do opublikowania. (I63d0f)

Wersja 1.2

Wersja 1.2.0

9 sierpnia 2023 r.

androidx.wear.tiles:tiles-*:1.2.0 został zwolniony. Wersja 1.2.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.1.0

  • stabilna wersja Wear Tiles 1.2.0 (więcej informacji);
  • Wersja 1.2 zawiera obsługę wiązania elementów układu z danymi platformy (w celu szybszego aktualizowania) oraz animacji. Instrukcje dotyczące migracji znajdziesz w notatkach do wersji (1.2.0-rc01).

Wersja 1.2.0-rc01

26 lipca 2023 r.

androidx.wear.tiles:tiles-*:1.2.0-rc01 został zwolniony. Wersja 1.2.0-rc01 zawiera te zatwierdzenia.

  • W wersji 1.2 biblioteka Tiles została przebudowana, a większość funkcji i interfejsów API została przeniesiona do nowej biblioteki ProtoLayout (pakiet androidx.wear.protolayout). Niewielka ich część pozostała w bibliotece Tiles (androidx.wear.tiles):

    • Nazwy wszystkich klas pozostały bez zmian, w wersji 1.1 są tylko dodatki.
    • Większość interfejsów API pozostała bez zmian, a jedyną zmianą jest nazwa pakietu.
    • Niektóre metody w bibliotece TileService/TileBuilder zostały wycofane i teraz mają zmienione nazwy, a zamiast wycofanych metod obsługiwane są nowe typy ProtoLayout.

  • Aby ułatwić Ci migrację, przygotowaliśmy krótkie instrukcje i skrypt, który przeprowadzi tę zmianę. Znajdziesz je tutaj.

Zmiany w interfejsie API

  • Maksymalna głębia układu została ograniczona do 30 zagnieżdżonych elementów w płytce. Jeśli ta głębia zostanie przekroczona, renderowanie płytek spowoduje wyświetlenie wcześniej rozszerzonego układu. (I8a74b)

Wersja 1.2.0-beta01

21 czerwca 2023 r.

androidx.wear.tiles:tiles-*:1.2.0-beta01 jest opublikowany bez wprowadzenia zmian. Wersja 1.2.0-beta01 zawiera te commity.

Wersja 1.2.0-alpha07

7 czerwca 2023 r.

androidx.wear.tiles:tiles-*:1.2.0-alpha07 został zwolniony. Wersja 1.2.0-alpha07 zawiera te commity.

Nowe funkcje

  • TileRenderer.setState umożliwia ustawienie stanu sesji renderowania. Ten stan będzie obowiązywał w przypadku bieżącego i przyszłych układów (do czasu ustawienia nowego stanu) (Iaaf35)
  • Typy protolayout są teraz w pełni obsługiwane we wszystkich interfejsach API do renderowania kafelków. (I428b0)

Poprawki błędów

  • Ustawienie motywu niestandardowego jest teraz możliwe w sekcji ProtoLayoutViewInstance. (Iae8c0)

Wersja 1.2.0-alpha06

24 maja 2023 r.

androidx.wear.tiles:tiles-*:1.2.0-alpha06 został zwolniony. Wersja 1.2.0-alpha06 zawiera te commity.

Zmiany w interfejsie API

  • Zmień nazwę interfejsu StateEntryValue na DynamicDataValue i zaktualizuj interfejsy API stanu, aby używały interfejsu DynamicDataKey (If1c01).
  • Ograniczamy liczbę wpisów dozwolonych w StateStore, aby zapewnić odpowiednią kontrolę i ograniczenie wykorzystania pamięci oraz czasu aktualizacji stanu w przypadku każdego wystąpienia StateStore. Dlatego deweloper musi zadbać o to, aby na mapie nie było więcej niż MAX_STATE_ENTRY_COUNT pozycji. W przeciwnym razie podczas tworzenia lub aktualizowania StateStore pojawi się błąd IllegalStateException. (Ibadb3)

Wersja 1.2.0-alpha05

10 maja 2023 r.

androidx.wear.tiles:tiles-*:1.2.0-alpha05 został zwolniony. Wersja 1.2.0-alpha05 zawiera te commity.

Nowe funkcje

  • Do zdarzeń i zapytań dotyczących kafelków dodaliśmy identyfikator kafelka. Ten identyfikator może służyć do powiązania niektórych danych z kartą w karuzeli. (Ic4f83)

Zmiany w interfejsie API

  • Funkcja TileRenderer.inflateAsync zwraca teraz wartość ListenableFuture. (I2f2b9)
  • Generatory kafelków, które mają zamienniki w bibliotece protolayout, są teraz oznaczone jako wycofane. (Ie2029)

Poprawki błędów

  • W dokumentacji javadoc dla metody TileService.onTileResourcesRequest wyjaśniono, kiedy system może ją wywołać. (Iee037)

Wersja 1.2.0-alpha04

19 kwietnia 2023 r.

androidx.wear.tiles:tiles-*:1.2.0-alpha04 został zwolniony. Wersja 1.2.0-alpha04 zawiera te commity.

Poprawki błędów

  • W razie potrzeby zależności Gradle są teraz prawidłowo ustawione na api zamiast implementation. (I40503)

Wersja 1.2.0-alpha03

5 kwietnia 2023 r.

androidx.wear.tiles:tiles-*:1.2.0-alpha03 został zwolniony. Wersja 1.2.0-alpha03 zawiera te komisy.

Zmiany w interfejsie API

  • Dodaliśmy obsługę typów androidx.wear.protolayout w funkcji TileRenderer (I4ac7f).
  • Nazwa ObservableStateStore została zmieniona na StateStore. (Ieb0e2)
  • Dodaj przeciążenia typów prototypów do TileRenderer (I4ac7f)
  • Włączanie animacji w TileRenderer (I07dcf)

Wersja 1.2.0-alpha02

22 marca 2023 r.

androidx.wear.tiles:tiles-*:1.2.0-alpha02 został zwolniony. Wersja 1.2.0-alpha02 zawiera te commity.

Zmiany w interfejsie API

  • Biblioteka materiałów kafelków została wycofana. Użyj nowej biblioteki ProtoLayout Material, która ma te same funkcje. (If242b)

Poprawki błędów

  • Aplikacja TileRenderer została zaktualizowana, aby korzystać z nowych funkcji biblioteki protolayout. (I832f9)

Wersja 1.2.0-alpha01

8 marca 2023 r.

androidx.wear.tiles:tiles-*:1.2.0-alpha01 został zwolniony. Wersja 1.2.0-alpha01 zawiera te commity.

Nowe funkcje

  • Dodaliśmy do onTileResourceRequest rolę TileService, aby udostępniać zasoby z biblioteki protolayout. (983d9c5)
  • Zaktualizowaliśmy funkcje ResourcesRequest i TileRequest, aby obsługiwały typy State i DeviceParameters z biblioteki protolayout. (88fa01d)
  • Zaktualizowaliśmy TileBuilders.Tile, aby obsługiwał typy State i Timeline z biblioteki protolayout. (168619c)

Poprawki błędów

  • Ulepszenia w dokumentacji Javadocs. (I3ed73)
  • Zmieniono domyślne kolory onPrimary i powierzchni. (I0b039)

Wersja 1.1

Wersja 1.1.0

24 sierpnia 2022 r.

androidx.wear.tiles:tiles-*:1.1.0 został zwolniony. Wersja 1.1.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.0.0

  • To pierwsza stabilna wersja zawierająca bibliotekę komponentów Tiles Material (więcej informacji znajdziesz na naszym blogu).
  • Ta biblioteka zawiera komponenty i układy, które są zgodne ze wskazówkami dotyczącymi Material Design i łatwe w użyciu. Obejmuje on komponenty Button, Chip, CompactChip, TitleChip, CircularProgressIndicator i Text.Wszystkie te komponenty mają własne obiekty kolorów, które można tworzyć za pomocą głównej klasy Colors, aby łatwo stosować ten sam motyw we wszystkich komponentach. Oprócz kolorów dostępna jest klasa Typography, która umożliwia łatwe pobieranie obiektów FontStyle za pomocą nazwy typografii.
  • Oprócz komponentów dostępne są też zalecane układy płytek: PrimaryLayout, EdgeContentLayout, MultiButtonLayout, MultiSlotLayout. Wszystkie układy mają zastosowane zalecane wartości wypełnienia i style zgodne ze wskazówkami dotyczącymi Material Design.
  • Listę komponentów i schematów w bibliotece materiałów Płytki znajdziesz w informacjach o wersji Płytki.

Wersja 1.1.0-rc01

10 sierpnia 2022 r.

androidx.wear.tiles:tiles-*:1.1.0-rc01 został zwolniony. Wersja 1.1.0-rc01 zawiera te zatwierdzenia.

  • Nie wprowadzono żadnych nowych zmian między wersją beta a wersją RC.

Wersja 1.1.0-beta01

27 lipca 2022 roku

androidx.wear.tiles:tiles-*:1.1.0-beta01 został zwolniony. Wersja 1.1.0-beta01 zawiera te commity.

Wersja 1.0.0-beta01 biblioteki komponentów Tiles Material zawiera komponenty i układy, które są zgodne ze wskazówkami dotyczącymi Material Design i łatwe w stworzeniu.

Dołączone komponenty:

  • Button – klikalny obiekt o okrągłym kształcie z ikoną, tekstem lub obrazem w 3 wstępnie zdefiniowanych rozmiarach.
  • Chip – klikalny obiekt w kształcie stadionu, który może zawierać ikonę, etykiety główną i dodatkową oraz ma stałą wysokość i szerokość, którą można dostosować.
  • CompactChip i TitleChip – 2 warianty standardowego elementu Chip, które mają odpowiednio mniejszą i większą wysokość i mogą zawierać 1 wiersz tekstu.
  • CircularProgressIndicator – łuk na krawędzi ekranu o danym kącie początkowym i końcowym, który może opisywać pełny lub częściowy okrąg z pełnym łukiem postępu.
  • Text – tekst sformatowany za pomocą zalecanych stylów typograficznych Wear Material;

Wszystkie te komponenty mają własne obiekty kolorów, które można tworzyć za pomocą głównej klasy Colors, aby łatwo stosować ten sam motyw we wszystkich komponentach. Oprócz kolorów istnieje klasa Typography, która umożliwia łatwe uzyskiwanie obiektów FontStyle za pomocą nazwy typograficznej.

Oprócz komponentów dostępne są też zalecane układy kafelków:

  • PrimaryLayout – układ, który można dostosować, dodając etykiety główne lub dodatkowe, treść na środku oraz element główny na dole. Główna treść w tym układzie może zostać dodana jako obiekt MultiSlotLayout lub MultiButtonLayout.
  • EdgeContentLayout – układ do wyświetlania CircularProgressIndicator na krawędzi z główną zawartością wewnątrz oraz etykietą główną lub dodatkową wokół niej.
  • MultiButtonLayout – układ, który może zawierać od 1 do 7 przycisków rozmieszczonych zgodnie z wytycznymi Material Design w zależności od ich liczby.
  • MultiSlotLayout – układ w postaci rzędów z wyrównanymi poziomo i rozstawionymi slotami (na ikony lub inne małe treści).

Wszystkie układy mają zastosowane zalecane wartości wypełnienia i style zgodne ze wskazówkami Material Design.

Zmiany w interfejsie API

  • Duże zmiany w komponentach elementów, które obejmują rozdzielenie ustawień w edytorze, tak aby każda część treści była przekazywana osobno z nowymi nazwami zgodnymi ze wskazówkami (etykieta główna, etykieta pomocnicza, identyfikator zasobu obrazu). Jeśli nie ustawisz opisu treści, zostanie on wygenerowany automatycznie. (I57622)
  • Nazwa ProgressIndicatorLayout została zmieniona na EdgeContentLayout. (Ic1aa6)
  • Treści dotyczące rozmiaru przycisku zostały przemianowane na nazwy z sufiksem without _BUTTON, a dodatkowe wyjaśnienia dotyczące Javadocs zostały dodane w całości Button. (I1dfe2)

Poprawki błędów

  • Marginesy, wypełnień i ogólnego układu w ramach układów Material Design, aby pasowały do wszystkich typów zalecanych układów oraz rozmiarów i kształtów ekranu.
  • Ulepszenia układów Material. In MultiSlotLayout slots are now flexible in width where they’ll wrap content instead of being fixed size.(I52919),(If18b4)
  • Obszar, który można dotknąć, CompactChip został powiększony, aby spełniać wytyczne dotyczące ułatwień dostępu. (Ie8264)

Wersja 1.1.0-alpha09

29 czerwca 2022 r.

androidx.wear.tiles:tiles-*:1.1.0-alpha09 został zwolniony. Wersja 1.1.0-alpha09 zawiera te commity.

Nowe funkcje

  • Dodaliśmy obsługę opcjonalnych etykiet w sekcji ProgressIndicatorLayout. (I30788)

Zmiany w interfejsie API

  • Metody pomocnicze dla ElementMetadata przyjmują teraz ElementMetadata zamiast Modifiers. (I5a70f)

Poprawki błędów

  • Usunięto ograniczenie do 9 znaków w przypadku kraju CompactChip. Jeśli tekst jest za duży, aby zmieścić się na ekranie w trybie PrimaryLayout, zostanie wydłużony. (Id56ec)
  • Metody dostępu w Chip mają teraz przyrostek Content. (Iba437)
  • Uszczegółowienie Javadoc w klasach Materiał płytki. (I56e41), (I80f31), (Iba437)

Wersja 1.1.0-alpha08

1 czerwca 2022 r.

androidx.wear.tiles:tiles-*:1.1.0-alpha08 został zwolniony. Wersja 1.1.0-alpha08 zawiera te zatwierdzenia.

Nowe funkcje

  • Do klasy Helper dodano metody pomocnicze, które umożliwiają śledzenie metadanych komponentu za pomocą tagu metadanych. (I70db2),(I30c3d)
  • Do wszystkich komponentów i schematów w ramach komponentu Tiles Material dodano stałą metodę fromLayoutElement. Należy go używać do testowania, aby przekształcić element LayoutElement uzyskany z dostępu do zawartości kontenera w jego pierwotny typ. (Ia572a),(Idbd8a),(I3ae13),(I292fe),(I8b20f),(I3cacb),(I84b24)

Wersja 1.1.0-alpha07

18 maja 2022 r.

androidx.wear.tiles:tiles-*:1.1.0-alpha07 został zwolniony. Wersja 1.1.0-alpha07 zawiera te commity.

Zmiany w interfejsie API

  • Do metod ProgressIndicatorLayout i PrimaryLayout dodaliśmy metody dostępu powiązane z różnymi metodami mutatora dla treści. Teraz wszystkie metody setter w tych klasach mają odpowiadające im metody getter (Iddbe5). (Iabe4e)
  • Getter dla opisu treści w Material Components może zwracać wartość null, ponieważ jego setter nie jest obowiązkowy.
  • Próba utworzenia przycisku bez przekazanych treści spowoduje błąd IllegalArgumentException. (I7fc0c)
  • Nazwa pól związanych z kolorami ikon w sekcji ChipColors została zmieniona z iconTintColor na iconColor. (Ic053b)

Poprawki błędów

  • Dodano androidTests dla układów w materiałach dotyczących kart. (I96404)

Wersja 1.1.0-alpha06

11 maja 2022 roku

androidx.wear.tiles:tiles-*:1.1.0-alpha06 został zwolniony. Wersja 1.1.0-alpha06 zawiera te commity.

Nowe funkcje

  • Nowy układ został dodany do podbiblioteki układów Material Design – MultiButtonLayout. Reprezentuje układ, który może zawierać od 1 do 7 przycisków rozmieszczonych zgodnie z wytycznymi Material Design. W większości przypadków ten układ powinien być przekazywany jako zawartość do elementu PrimaryLayout. (Ib727f)

Zmiany w interfejsie API

  • MultiSlotLayout został przekształcony tak, aby zawierał tylko sloty. Ten układ powinien zostać przekazany jako zawartość do głównego PrimaryLayout. (I1870f)
  • Zaktualizowano zdefiniowane domyślne kolory CircularProgressIndicator, aby były jedną wartością zamiast kolorów podstawowego i dodatkowego. (I64a51)
  • Dodano metodę gettera dla poziomego odstępu w MultiSlotLayout. (I11e1e)

Poprawki błędów

  • Do komponentów zostały dodane testy Androida dotyczące komponentów. (I20041)

Wersja 1.1.0-alpha05

6 kwietnia 2022 roku

androidx.wear.tiles:tiles-*:1.1.0-alpha05 został zwolniony. Wersja 1.1.0-alpha05 zawiera te commity.

Nowe funkcje

  • Dodaliśmy pomocnicze metody do konwertowania LayoutElement na Layout, Timeline i TimelineEntry w tych klasach, aby ułatwić tworzenie kafelków. (I2f6d1)
  • Do biblioteki komponentów został dodany obiekt Colors, który będzie przekazywany do kolorów komponentów jako motyw. (I0792c)

Zmiany w interfejsie API

  • Komponent Material Text wymaga przekazania tekstu do konstruktora. Ten komponent można teraz dostosować, ustawiając wagę. (I25dbd)
  • Usunięto stałe z ChipDefaults, które nie są używane w publicznych setterach. (I7baed)
  • Usunięto z klas CompactChip i TitleChip metody getter, które nie mają odpowiadających im metod setter. (I99e85)
  • Element DEFAULT_PADDING został usunięty z listy ProgressIndicatorDefaults. (Idabcd)
  • Komponenty Material Design teraz akceptują CharSequence jako opis treści zamiast ciągu znaków. (I5b21a)

Poprawki błędów

  • Zmieniono implementację metod settera opcjonalnych parametrów w przycisku. (Ib7135)
  • Do czcionek w sekcji Typografia dodaliśmy wariant stylu czcionki. (I8dbc6)

Wersja 1.1.0-alpha04

23 marca 2022 r.

androidx.wear.tiles:tiles-*:1.1.0-alpha04 został zwolniony. Wersja 1.1.0-alpha04 zawiera te commity.

Nowe funkcje

  • Do PrimaryLayout można dodać opcjonalną etykietę główną lub dodatkową. (Ib9916)
  • Komponent tekstowy można dostosować, ustawiając przepełnienie, kursywę, podkreślenie itp. (I703f7)

Zmiany w interfejsie API

  • Domyślne stałe kolorów zostały usunięte z interfejsu Tiles Material API. (I0ab55)
  • Wszystkie klikalne komponenty w materiałach typu „Płytki” wymagają obiektu Clickable w konstruktorze Buildera zamiast działania. (I2f101)

Poprawki błędów

  • Tekst będzie teraz wyświetlany w postaci kropek w komponencie elementu tekstowego i elementu elementu tekstowego. (I8a2f8)
  • Ulepszony wygląd komponentów, gdy skala czcionki użytkownika jest ustawiona na dużą. (Ib63b1)
  • Wyjaśnienie Javadocs setPrimaryChipContent w PrimaryLayout. (Ie6296)

Wersja 1.1.0-alpha03

23 lutego 2022 r.

androidx.wear.tiles:tiles-*:1.1.0-alpha03 został zwolniony. Wersja 1.1.0-alpha03 zawiera te commity.

Zmiany w interfejsie API

  • Do Materiału do tworzenia kafelków dodano komponent Text ze stylami typografii zalecanymi przez Google. (Iec0ae)

Wersja 1.1.0-alpha02

9 lutego 2022 r.

androidx.wear.tiles:tiles-*:1.1.0-alpha02 został zwolniony. Wersja 1.1.0-alpha02 zawiera te commity.

Nowe funkcje

  • Dodano nową podbibliotekę layouts w sekcji Materiał na kafelkach. Zawiera ona układy kafelków z zalecanym marginesem i odstępem, które ułatwiają i przyspieszają tworzenie kafelków. Początkowe układy:
    • PrimaryLayout (I7ba91), który przedstawia układ z układem głównym u dołu i treściami w środku.
    • MultiSlotLayout (I32104) to układ z etykietami w wierszach 1 i 3, wyrównanymi poziomo i rozstawionymi slotami w wierszu 2. Za nimi znajduje się 4. wiersz z głównym elementem.
    • ProgressIndicatorLayout (I9fec6) przedstawiający układ z kołowym wskaźnikiem postępu wokół krawędzi ekranu i podanymi wewnątrz treściami.
  • Do komponentów Material Tiles został dodany CircularProgressIndicator (Ic4b88).

Zmiany w interfejsie API

  • Zmieniono nazwy pozostałych stałych elementów używanych przez TitleChip, aby zawierały tytuł. (I14f4c)
  • Metoda setHorizontalAlignment została dodana do Chip. (Ie6e0b)

Wersja 1.1.0-alpha01

26 stycznia 2022 r.

androidx.wear.tiles:tiles-*:1.1.0-alpha01 został zwolniony. Wersja 1.1.0-alpha01 zawiera te commity.

Nowe funkcje

  • Dodano nową bibliotekę Elementy mozaiki. Zawiera komponenty, które umożliwiają szybsze i prostsze tworzenie układów kafelków z użyciem Material Design. Początkowe komponenty:
    • Button
    • Chip
    • CompactChip
    • TitleChip

Poprawki błędów

  • Naprawiono błąd w TileUiClient, który powodował odrzucanie zasobów z bufora. (I60e0b)

Wersja 1.0

Wersja 1.0.1

26 stycznia 2022 r.

androidx.wear.tiles:tiles-*:1.0.1 został zwolniony. Wersja 1.0.1 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiono błąd w TileUiClient, który powodował odrzucanie zasobów z bufora. (I60e0b)

Wersja 1.0.0

3 listopada 2021 r.

androidx.wear.tiles:tiles-*:1.0.0 został zwolniony. Wersja 1.0.0 zawiera te zatwierdzenia.

Najważniejsze funkcje wersji 1.0.0

  • Biblioteka Wear Tiles zawiera funkcje do tworzenia niestandardowych kafelków na urządzenia z Wear OS oraz klasy, które umożliwiają systemowi pobieranie kafelka i wyświetlanie go obok tarczy zegarka.
  • tiles-renderer umożliwia wyświetlanie kafelka w ramach aktywności Androida, co ułatwia szybkie testowanie układów.

Wersja 1.0.0-rc01

27 października 2021 roku

androidx.wear.tiles:tiles-*:1.0.0-rc01 został zwolniony. Wersja 1.0.0-rc01 zawiera te zatwierdzenia.

Wersja 1.0.0-beta01

13 października 2021 r.

androidx.wear.tiles:tiles-*:1.0.0-beta01 został zwolniony. Wersja 1.0.0-beta01 zawiera te commity.

Poprawki błędów

  • Naprawiono błąd NullPointerException w TileUiClient, gdy podano pustą wersję zasobu. (I0586e)

Wersja 1.0.0-alpha12

29 września 2021 r.

androidx.wear.tiles:tiles-*:1.0.0-alpha12 został zwolniony. Wersja 1.0.0-alpha12 zawiera te zatwierdzenia.

Poprawki błędów

  • Funkcja UpdateScheduler nie używa już słabego odwołania. Rozwiązano problemy, które powodowały, że TileUiClient nie aktualizował się(I1120d, b/199061124).

  • Zadeklaruj, że SysUiTileUpdateRequester wysyła zapytania do PacakgeManager, aby naprawić błąd, w którym aktualizacje kafelków nie działały na urządzeniach R+. (I1120d)

Wersja 1.0.0-alpha11

1 września 2021 roku

androidx.wear.tiles:tiles-*:1.0.0-alpha11 został zwolniony. Wersja 1.0.0-alpha11 zawiera te commity.

Nowe funkcje

  • Dodaliśmy i opublikowaliśmy bibliotekę testów androidx.wear.tiles:tiles-testing library, aby ułatwić deweloperom testowanie ich kafelków. (Iedb6b)

Zmiany w interfejsie API

  • Nazwa usługi TileProviderService została zmieniona na TileService. (I1ad2c)
  • Zaktualizowano konstruktory kafelków. Statyczne metody .builder() zostały wycofane na rzecz wywołania new Foo.Builder(), a przeciążenia settera, które przyjmowały instancję Builder, zostały usunięte. (Ia9606)
  • Komponent TileRenderer powinien teraz używać kontekstu interfejsu użytkownika zamiast kontekstu aplikacji. (I84b61)

Poprawki błędów

  • Naprawiono błąd, który w pewnych sytuacjach powodował stosowanie podwójnego podkreślenia. (Ib6712)

Wersja 1.0.0-alpha10

18 sierpnia 2021 r.

Funkcje androidx.wear.tiles:tiles:1.0.0-alpha10, androidx.wear.tiles:tiles-proto:1.0.0-alpha10 i androidx.wear.tiles:tiles-renderer:1.0.0-alpha10 są dostępne. Wersja 1.0.0-alpha10 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Usunięto sprawdzanie układu z publicznego interfejsu API. Te opcje są zawsze włączone, ale wyświetlają ostrzeżenie tylko wtedy, gdy sprawdzanie zakończy się niepowodzeniem. (Ie9f29)
  • Komponent TileRenderer przyjmuje teraz kontekst interfejsu użytkownika zamiast kontekstu aplikacji.

Poprawki błędów

  • Naprawiono błąd uniemożliwiający klikanie elementów klikalnych w elementach rozszerzalnych.

Wersja 1.0.0-alpha09

21 lipca 2021 r.

Funkcje androidx.wear.tiles:tiles:1.0.0-alpha09, androidx.wear.tiles:tiles-proto:1.0.0-alpha09 i androidx.wear.tiles:tiles-renderer:1.0.0-alpha09 są dostępne. Wersja 1.0.0-alpha09 zawiera te commity.

Nowe funkcje

  • Dodano sprawdzanie układu do renderowania kart na Wear. (I3a869)
    • Są one używane do sprawdzania sprawdzonych metod w płytce. Na początek, jeśli kafelek nie zawiera żadnych elementów z modyfikatorem Semantics, pojawi się ostrzeżenie.
  • Dodaliśmy dokumentację dotyczącą DefaultTileProviderClient i TestingTileProviderClient constructors. (I9f4b9)

Zmiany w interfejsie API

  • Zmiana nazwy w TileProviderClient (I0ec36):
    • getApiVersion -> requestApiVersion
    • tile/resourcesRequest -> requestTile/Resources
    • onTileFooEvent -> sendOnTileFooEvent
  • Dodano sprawdzanie układu do renderowania kart na Wear. (I3a869)

Poprawki błędów

  • Upewnij się, że element docelowy LaunchAction nie ma specjalnych uprawnień. (I39136)

Wersja 1.0.0-alpha08

30 czerwca 2021 r.

Funkcje androidx.wear.tiles:tiles:1.0.0-alpha08, androidx.wear.tiles:tiles-proto:1.0.0-alpha08 i androidx.wear.tiles:tiles-renderer:1.0.0-alpha08 są dostępne. Wersja 1.0.0-alpha08 zawiera te commity.

Nowe funkcje

  • Elementy rozciągające obsługują teraz atrybuty line_height zamiast line_spacing.

Zmiany w interfejsie API

  • Dodanie obsługi atrybutu line_height w elementach rozszerzalnych i usunięcie atrybutu line_spacing. (Ibeb54)
    • Kod korzystający z line_spacing należy przeportować, aby używał zamiast tego line_height.

Poprawki błędów

  • Naprawiono błąd związany z użyciem wymiarów proporcjonalnych. (I37ace)
  • Naprawiono błąd uniemożliwiający wyświetlanie opisów treści w elementach tekstowych. (Id2c7d)

Wersja 1.0.0-alpha07

16 czerwca 2021 r.

Funkcje androidx.wear.tiles:tiles:1.0.0-alpha07, androidx.wear.tiles:tiles-proto:1.0.0-alpha07 i androidx.wear.tiles:tiles-renderer:1.0.0-alpha07 są dostępne. Wersja 1.0.0-alpha07 zawiera te commity.

Zmiany w interfejsie API

  • Dodaj interfejs TileProviderClient i wyświetl DefaultTileProviderClient, aby umożliwić implementacjom wiązanie się z interfejsem TileProviderService. (I69165)

Wersja 1.0.0-alpha06

2 czerwca 2021 r.

Funkcje androidx.wear.tiles:tiles:1.0.0-alpha06, androidx.wear.tiles:tiles-proto:1.0.0-alpha06 i androidx.wear.tiles:tiles-renderer:1.0.0-alpha06 są dostępne. Wersja 1.0.0-alpha06 zawiera te commity.

Zmiany w interfejsie API

  • Wszystkie klasy Builder zawierają teraz metody gettera dla wszystkich właściwości. Pamiętaj, że są one przeznaczone tylko do celów testowych (I9d155).
  • Zmiana pakietu: klasy z androidx.wear.tiles.builders zostały przeniesione do androidx.wear.tiles.
  • Dodanie eksperymentalnej obsługi barwienia do kafelków. (I38929)
  • Nazwa LayoutElementBuilders.HALIGN_* została zmieniona na LayoutElementBuilders.HORIZONTAL_ALIGN_* (I67e58)
  • Nazwa LayoutElementBuilders.VALIGN_* została zmieniona na LayoutElementBuilders.VERTICAL_ALIGN_* (I67e58)
  • Nazwa LayoutElementBuilders.SPAN_VALIGN_* została zmieniona na LayoutElementBuilders.SPAN_VERTICAL_ALIGN_* (I67e58)
  • Dodaliśmy klasy konstruktorów dla żądań i zdarzeń. (Ib5cf4)
  • Zmieniono TileProviderService tak, aby używało żądań i klas zdarzeń z poziomów RequestBuilders i EventBuilders, a nie RequestReaders/EventReaders (np. onTileRequest zwraca teraz obiekt RequestBuilders.TileRequest, a nie RequestReaders.TileRequest). (I46ea1)

Poprawki błędów

  • Naprawiono błąd dotyczący asynchronicznego wczytywania obrazów w renderowaniu kafelków. (Iad9b0)
  • Usunięto błąd układu podczas umieszczania obrazu o szerokości lub wysokości expand() w elementach Box o szerokości lub wysokości wrap(). (I33770)

Wersja 1.0.0-alpha05

18 maja 2021 r.

Funkcje androidx.wear.tiles:tiles:1.0.0-alpha05, androidx.wear.tiles:tiles-proto:1.0.0-alpha05 i androidx.wear.tiles:tiles-renderer:1.0.0-alpha05 są dostępne. Wersja 1.0.0-alpha05 zawiera te commity.

Zmiany w interfejsie API

  • Usunięto getTileId z przychodzących zdarzeń dotyczących kafelków (TileAddEvent, TileRemoveEvent, TileEnterEvent, TileLeaveEvent, TileRequest). (Ifbba2)
  • Nazwa „ImageResource#setAndroidResourceByResid” została zmieniona na „setAndroidResourceByResId” (I4ba6e)
  • Zmieniliśmy nazwę TimelineManager#deInit na AutoCloseable i wdrożony (I5dff2)

Wersja 1.0.0-alpha04

5 maja 2021 roku

Funkcje androidx.wear.tiles:tiles:1.0.0-alpha04, androidx.wear.tiles:tiles-proto:1.0.0-alpha04 i androidx.wear.tiles:tiles-renderer:1.0.0-alpha04 są dostępne. Wersja 1.0.0-alpha04 zawiera te commity.

Zmiany w interfejsie API

  • Ukryte konkretne klasy TileProviderService.
    • Zmiana metody TileUpdateRequester na Class<? extends TileProviderService>. (Ib7cca)
  • Dodano możliwość dodawania dodatkowych elementów do klasy AndroidActivity. (I748f4)

Wersja Tiles 1.0.0-alpha03

21 kwietnia 2021 r.

Funkcje androidx.wear.tiles:tiles:1.0.0-alpha03, androidx.wear.tiles:tiles-proto:1.0.0-alpha03 i androidx.wear.tiles:tiles-renderer:1.0.0-alpha03 są dostępne. Wersja 1.0.0-alpha03 zawiera te commity.

Zmiany w interfejsie API

  • Zmień nazwę TileManager -> TileClient
    • Zmień nazwę TileManager#create -> TileClient#connect (I91839)

Poprawki błędów

  • Dodano reguły Proguard, aby zapewnić prawidłowe działanie funkcji tiles i tiles-renderer przy włączonym Proguard (Ie3d85).

Wersja 1.0.0-alpha02

7 kwietnia 2021 r.

Funkcje androidx.wear.tiles:tiles:1.0.0-alpha02, androidx.wear.tiles:tiles-proto:1.0.0-alpha02 i androidx.wear.tiles:tiles-renderer:1.0.0-alpha02 są dostępne. Wersja 1.0.0-alpha02 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • androidx.wear:wear-tiles przeniósł grupy i od teraz powinien być nazywany androidx.wear.tiles:tiles
  • androidx.wear:wear-tiles-renderer przeniósł grupy i od teraz powinien być nazywany androidx.wear.tiles:tiles-renderer
  • Funkcja TileRenderer.LoadActionListener używa teraz wystąpienia androidx.wear.tiles.builders.StateBuilders.State, a nie androidx.wear.tiles.proto.StateProto.State.
  • TileRenderer obsługuje teraz zasoby kafelka z androidx.wear.tiles.builders.ResourceBuilders.Resources, a nie z instancji androidx.wear.tiles.renderer.ResourceAccessors.

Poprawki błędów

  • Rozwiązano problem z niemożliwością użycia funkcji LoadActionListener, ponieważ ujawniała ona wewnętrzną klasę.

Wersja 1.0.0-alpha01

10 marca 2021 r.

Funkcje androidx.wear:wear-tiles:1.0.0-alpha01, androidx.wear:wear-tiles-proto:1.0.0-alpha01 i androidx.wear:wear-tiles-renderer:1.0.0-alpha01 są dostępne. Wersja 1.0.0-alpha01 zawiera te commity.

Nowe funkcje

  • Biblioteka Wear Tiles Renderer zapewnia funkcje do tworzenia niestandardowych kafelków na urządzeniach z Wear OS oraz klasy, które umożliwiają systemowi pobieranie kafelka i wyświetlanie go obok tarczy zegarka.