Karty Wear

Twórz aplikacje na zegarki z Wear OS by Google.
Najnowsza aktualizacja Wersja stabilna Kandydat do wydania Wersja Beta Wydanie alfa
7 sierpnia 2024 r. 1.4.0 - - -

Deklarowanie zależności

Aby dodać zależność w Wear, musisz dodać repozytorium Google Maven do swojego w projektach AI. Zapoznaj się z repozytorium Google Maven. .

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

Odlotowe

dependencies {
    // Use to implement support for wear tiles
    implementation "androidx.wear.tiles:tiles:1.4.0"

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

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

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

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

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

Kotlin

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

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

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

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

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

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

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

Opinia

Twoja opinia pomoże nam ulepszyć Jetpack. Daj nam znać, jeśli odkryjesz nowe problemy jak możemy ulepszyć tę bibliotekę. Przyjrzyj się istniejące problemy w tej bibliotece, zanim utworzysz nową. Możesz zagłosować nad istniejącym problemem przez klikając przycisk gwiazdki.

Tworzenie nowego numeru

Zobacz dokumentację narzędzia Issue Tracker. .

Wersja 1.4

Wersja 1.4.0

7 sierpnia 2024 r.

Usługa androidx.wear.tiles:tiles-*:1.4.0 została zwolniona. Wersja 1.4.0 zawiera te zatwierdzenia.

Ważne zmiany wprowadzone 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.

Wersja androidx.wear.tiles:tiles-*:1.4.0-rc01 została udostępniona bez zmian w porównaniu z poprzednią. Wersja 1.4.0-rc01 zawiera te zatwierdzenia.

Wersja 1.4.0-beta01

10 lipca 2024 r.

Usługa androidx.wear.tiles:tiles-*:1.4.0-beta01 została zwolniona. Wersja 1.4.0-beta01 zawiera te zatwierdzenia.

Nowe funkcje

Wersja 1.4.0-beta01 kart Wear oznacza, że ta wersja biblioteki jest kompletna, a interfejs API jest zablokowany (z wyjątkiem miejsc oznaczonych jako eksperymentalne). Wear Tiles 1.4 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.

Usługa androidx.wear.tiles:tiles-*:1.4.0-alpha05 została zwolniona. Wersja 1.4.0-alfa05 zawiera te zatwierdzenia.

Wersja 1.4.0-alpha04

29 maja 2024 r.

Usługa androidx.wear.tiles:tiles-*:1.4.0-alpha04 została zwolniona. Wersja 1.4.0-alfa04 zawiera te zatwierdzenia.

Wersja 1.4.0-alpha03

14 maja 2024 r.

Usługa androidx.wear.tiles:tiles-*:1.4.0-alpha03 została zwolniona. Wersja 1.4.0-alfa03 zawiera te zatwierdzenia.

Poprawki błędów

  • Aby podawać dokładniejsze wyniki, TileService#getActiveTilesAsync używa teraz interfejsu API WearSdk (jeśli jest dostępny). (I57bd8)

Wersja 1.4.0-alpha02

1 maja 2024 r.

Usługa androidx.wear.tiles:tiles-*:1.4.0-alpha02 została zwolniona. Wersja 1.4.0-alfa02 zawiera te zatwierdzenia.

Zmiany interfejsu API

  • Przenieś element tileId do parametru konstruktora konstruktora jako pole obowiązkowe i wartość domyślnej sygnatury czasowej dokumentu w metodzie pobierania. (I98c2b)
  • Dodaj wiadomości proto TileInteractionEvent, TileEnter i TileLeave oraz opakowania Java potrzebne do grupowania zdarzeń wejścia/opuszczenia kafelków. (I112b0)
  • Refaktoryzacja TileRenderer, aby używać konstruktora zamiast obiektu TileRenderer.Config. (Ib66f9).
  • Dodaj atrybut platformDataProviders do TileRenderer.Config. (I6030D)
  • Dodaj do obiektu TileRenderer nowy konstruktor, który obsługuje nową klasę TileRenderer.Config. Inne konstruktory zostały wycofane. (Iae7ff).
  • Dodaj pole platformDataValues do TilePreviewData, aby umożliwić zastępowanie wartości danych platformy. (If437a).

Poprawki błędów

  • Udokumentuj, że domyślna wartość parametru TileRenderer.Config.Builder#setTilesTheme wynosi 0. (Iced18).

Wersja 1.4.0-alpha01

6 marca 2024 roku

Usługa androidx.wear.tiles:tiles-*:1.4.0-alpha01 została zwolniona. Wersja 1.4.0-alfa01 zawiera te zatwierdzenia.

Wersja 1.3

Wersja 1.3.0

7 lutego 2024 r.

Usługa androidx.wear.tiles:tiles-*:1.3.0 została zwolniona. Wersja 1.3.0 zawiera te zatwierdzenia.

Ważne zmiany wprowadzone od wersji 1.2.0

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

Dodatkowe zmiany

Wersja 1.3.0-rc01

24 stycznia 2024 r.

Usługa androidx.wear.tiles:tiles-*:1.3.0-rc01 została zwolniona. Wersja 1.3.0-rc01 zawiera te zatwierdzenia.

Zmiany interfejsu API

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

Wersja 1.3.0-beta01

10 stycznia 2024 r.

Usługa androidx.wear.tiles:tiles-*:1.3.0-beta01 została zwolniona. Wersja 1.3.0-beta01 zawiera te zatwierdzenia.

Wersja 1.3.0-beta01 kart Wear oznacza, że ta wersja biblioteki jest kompletna, a interfejs API jest zablokowany (z wyjątkiem miejsc oznaczonych jako eksperymentalne). Wear Tiles 1.3 zawiera te nowe funkcje i interfejsy API:

  • Moduł dotyczący narzędzi do kafelków na Wear został zaktualizowany na potrzeby wyświetlania podglądu kart i można go opublikować.
  • Obsługa zapytań, które kafelki należące do aplikacji są aktywne w TileService.getActiveTilesSnapshotAsync.

Wersja 1.3.0-alfa04

13 grudnia 2023 r.

Usługa androidx.wear.tiles:tiles-*:1.3.0-alpha04 została zwolniona. Wersja 1.3.0-alfa04 zawiera te zatwierdzenia.

Wersja 1.3.0-alfa03

29 listopada 2023 r.

Usługa androidx.wear.tiles:tiles-*:1.3.0-alpha03 została zwolniona. Wersja 1.3.0-alfa03 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodano nowy interfejs API TileService#getActiveTilesSnapshotAsync do wysyłania zapytań dotyczących tego, które kafelki należące do aplikacji są aktywne. (I6850e)

Zmiany interfejsu API

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

Wersja 1.3.0-alfa02

15 listopada 2023 r.

Usługa androidx.wear.tiles:tiles-*:1.3.0-alpha02 została zwolniona. Wersja 1.3.0-alfa02 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodaliśmy eksperymentalny interfejs API, który automatycznie skaluje rozmiar tekstu w zależności od miejsca w obiekcie nadrzędnym. (Ibbe63)

Wersja 1.3.0-alpha01

18 października 2023 r.

Usługa androidx.wear.tiles:tiles-*:1.3.0-alpha01 została zwolniona. Wersja 1.3.0-alfa01 zawiera te zatwierdzenia.

Nowe funkcje

  • Podaj kontekst jako parametr metody podglądu zamiast parametrów wywołania zwrotnego TilePreviewData. (I5E97D)
  • Moduł dotyczący narzędzi do kafelków na Wear został zaktualizowany na potrzeby wyświetlania podglądu kafelków i można go opublikować. (I63d0f)

Wersja 1.2

Wersja 1.2.0

9 sierpnia 2023 r.

Usługa androidx.wear.tiles:tiles-*:1.2.0 została zwolniona. Wersja 1.2.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.1.0

  • Stabilna wersja kart Wear 1.2.0 (więcej informacji)
  • Karty w wersji 1.2 dodaliśmy obsługę wiązania elementów układu z danymi platformy i animacjami (co przyspiesza ich aktualizację). Instrukcje migracji znajdziesz w informacjach o wersji (1.2.0-rc01).

Wersja 1.2.0-rc01

26 lipca 2023 r.

Usługa androidx.wear.tiles:tiles-*:1.2.0-rc01 została zwolniona. Wersja 1.2.0-rc01 zawiera te zatwierdzenia.

  • W wersji 1.2 biblioteka kafelków została zmodyfikowana, a większość funkcji i interfejsów API została przeniesiona do nowej biblioteki ProtoLayout (pakiet androidx.wear.protolayout), przy czym niewielka część została w sekcji Tiles (androidx.wear.tiles):

    • Wszystkie nazwy klas pozostały takie same. Jedyne, co można dodać do wersji 1.1, to zmiany.
    • Większość interfejsów API pozostała bez zmian, a jedyną zmianą jest nazwa pakietu.
    • Niektóre metody używane w narzędziu TileService/TileBuilder zostały wycofane i zmieniły nazwy wersji, które akceptują nowe typy ProtoLayout zamiast wycofanych kafelków.
  • Aby ułatwić tę migrację, przygotowaliśmy krótkie instrukcje i skrypt, które służą do zmiany nazwy. Więcej informacji znajdziesz tutaj.

Zmiany interfejsu API

  • Ograniczyliśmy maksymalną głębokość, jaką w układzie może być maksymalnie 30 zagnieżdżonych elementów w kafelku. Jeśli zostanie ona przekroczona, mechanizm renderowania kafelków wyświetli układ, który wcześniej został powiększony. (I8a74b)

Wersja 1.2.0-beta01

21 czerwca 2023 r.

Pakiet androidx.wear.tiles:tiles-*:1.2.0-beta01 został udostępniony bez zmian. Wersja 1.2.0-beta01 zawiera te zatwierdzenia.

Wersja 1.2.0-alpha07

7 czerwca 2023 r.

Usługa androidx.wear.tiles:tiles-*:1.2.0-alpha07 została zwolniona. Wersja 1.2.0-alfa07 zawiera te zatwierdzenia.

Nowe funkcje

  • TileRenderer.setState umożliwia ustawienie stanu sesji renderowania. Ten stan będzie stosowany do zarówno obecnego układu, jak i przyszłego (dopóki nie ustawisz 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

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

Wersja 1.2.0-alpha06

24 maja 2023 r.

Usługa androidx.wear.tiles:tiles-*:1.2.0-alpha06 została zwolniona. Wersja 1.2.0-alfa06 zawiera te zatwierdzenia.

Zmiany interfejsu API

  • Zmień nazwę StateEntryValue na DynamicDataValue i zaktualizuj interfejsy API stanu tak, aby używały DynamicDataKey (If1c01).
  • Ograniczamy liczbę wpisów dozwolonych w polu StateStore, aby zapewnić prawidłowe uwzględnienie i kontrolowanie czasu wykorzystania pamięci i aktualizacji stanu w przypadku każdej instancji StateStore. W związku z tym deweloper musi zadbać o to, aby nie miał więcej niż MAX_STATE_ENTRY_COUNT wpisów na mapie. W przeciwnym razie podczas tworzenia lub aktualizowania elementu StateStore otrzyma wartość IllegalStateException. (Ibadb3).

Wersja 1.2.0-alpha05

10 maja 2023 r.

Usługa androidx.wear.tiles:tiles-*:1.2.0-alpha05 została zwolniona. Wersja 1.2.0-alfa05 zawiera te zatwierdzenia.

Nowe funkcje

  • Do zdarzeń i żądań kafelków dodaliśmy identyfikator kafelka. Ten identyfikator może służyć do powiązania niektórych danych z wystąpieniem kafelka w karuzeli. (IC4f83)

Zmiany interfejsu API

  • TileRenderer.inflateAsync zwraca teraz ListenableFuture. (I2f2b9)
  • Kreatory kafelków, które mają zastąpienie w bibliotece protolayout, są teraz oznaczone jako wycofane. (IE2029)

Poprawki błędów

  • Biblioteka javadoc dla TileService.onTileResourcesRequest wyjaśnia teraz, kiedy system może wywoływać metodę. (Iee037).

Wersja 1.2.0-alfa04

19 kwietnia 2023 r.

Usługa androidx.wear.tiles:tiles-*:1.2.0-alpha04 została zwolniona. Wersja 1.2.0-alfa04 zawiera te zatwierdzenia.

Poprawki błędów

  • Zależności Gradle są teraz prawidłowo ustawione na api zamiast implementation, gdy jest to wymagane. (I40503)

Wersja 1.2.0-alfa03

5 kwietnia 2023 r.

Usługa androidx.wear.tiles:tiles-*:1.2.0-alpha03 została zwolniona. Wersja 1.2.0-alfa03 zawiera te zatwierdzenia.

Zmiany interfejsu API

  • Do kategorii TileRenderer dodaliśmy obsługę typów androidx.wear.protolayout (I4ac7f)
  • Nazwa konta ObservableStateStore została zmieniona na StateStore. (Ieb0e2).
  • Dodaj przeciążenia typów układu prototypowego do TileRenderer (I4ac7f)
  • Włącz animacje w: TileRenderer (I07dcf)

Wersja 1.2.0-alfa02

22 marca 2023 r.

Usługa androidx.wear.tiles:tiles-*:1.2.0-alpha02 została zwolniona. Wersja 1.2.0-alfa02 zawiera te zatwierdzenia.

Zmiany interfejsu API

  • Biblioteka materiałów Tiles została wycofana. Użyj nowej biblioteki ProtoLayout Material z tymi samymi funkcjami. (If242b).

Poprawki błędów

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

Wersja 1.2.0-alpha01

8 marca 2023 r.

Usługa androidx.wear.tiles:tiles-*:1.2.0-alpha01 została zwolniona. Wersja 1.2.0-alfa01 zawiera te zatwierdzenia.

Nowe funkcje

  • Do usługi TileService dodaliśmy onTileResourceRequest, aby udostępnić zasoby z biblioteki protolayout. (983d9c5).
  • Zaktualizowaliśmy ResourcesRequest i TileRequest, by obsługiwać typy State i DeviceParameters z biblioteki protolayout. (88fa01d)
  • Zaktualizowaliśmy TileBuilders.Tile, aby obsługiwały typy State i Timeline z biblioteki protolayout. (168619c)

Poprawki błędów

  • Ulepszenia dokumentów Javadocs. (I3ed73).
  • Domyślne kolory usługi onPrimary i powierzchni uległy zmianie. (I0B039)

Wersja 1.1

Wersja 1.1.0

24 sierpnia 2022 r.

Usługa androidx.wear.tiles:tiles-*:1.1.0 została zwolniona. Wersja 1.1.0 zawiera te zatwierdzenia.

Ważne zmiany wprowadzone od wersji 1.0.0

  • Jest to pierwsza stabilna wersja, która zawiera bibliotekę 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 materiałów i łatwe w użyciu. Uwzględnione komponenty to Button, Chip, CompactChip, TitleChip, CircularProgressIndicator i Text.Wszystkie te komponenty mają własne obiekty kolorów, które można utworzyć za pomocą głównej klasy Colors, aby łatwo zastosować ten sam motyw do wszystkich komponentów. Oprócz kolorów dostępna jest też klasa Typografia, która pozwala łatwo uzyskiwać obiekty FontStyle przy użyciu nazwy typograficznej.
  • Oprócz komponentów masz też zalecane układy kafelków: PrimaryLayout, EdgeContentLayout, MultiButtonLayout i MultiSlotLayout. We wszystkich układach zastosowano zalecane dopełnienie i style zgodne z wytycznymi dotyczącymi materiałów.
  • Listę komponentów i układów z biblioteki Tiles Material Design znajdziesz w informacjach o wersji Tiles.

Wersja 1.1.0-rc01

10 sierpnia 2022 r.

Usługa androidx.wear.tiles:tiles-*:1.1.0-rc01 została zwolniona. Wersja 1.1.0-rc01 zawiera te zatwierdzenia.

  • Między wersją beta a wersją RC nie pojawiły się żadne nowe zmiany.

Wersja 1.1.0-beta01

27 lipca 2022 roku

Usługa androidx.wear.tiles:tiles-*:1.1.0-beta01 została zwolniona. Wersja 1.1.0-beta01 zawiera te zatwierdzenia.

W wersji 1.0.0-beta01 biblioteki Tiles Material są komponenty i układy, które są zgodne ze wskazówkami dotyczącymi materiałów i łatwe w tworzeniu.

Uwzględnione komponenty to:

  • Button – klikalny okrągły obiekt z ikoną, tekstem lub obrazem w 3 zdefiniowanych wstępnie rozmiarach.
  • Chip – klikalny obiekt w kształcie stadionu, który może zawierać ikonę oraz etykietę główną i dodatkową oraz ma stałą wysokość i dostosowywaną szerokość.
  • CompactChip i TitleChip – 2 warianty standardowego elementu, które mają odpowiednio mniejszą i większą wysokość i mogą zawierać 1 wiersz tekstu.
  • CircularProgressIndicator – kolorowy łuk wokół krawędzi ekranu z podanymi kątami początkowymi i końcowymi, który może opisywać pełne lub częściowe koło z pełnym łukiem postępu.
  • Text – tekst o stylu nawiązującym do zalecanych stylów typograficznych z Wear Material

Wszystkie te komponenty mają własny obiekt kolorów, który można utworzyć za pomocą głównej klasy Colors, aby łatwo zastosować ten sam motyw do wszystkich komponentów. Oprócz kolorów istnieje też klasa Typography, która umożliwia łatwe pobieranie obiektów FontStyle za pomocą nazwy typograficznej.

Oprócz komponentów masz też zalecane układy kafelków:

  • PrimaryLayout – układ, który można dostosować przez dodanie etykiet podstawowych lub dodatkowych, treści pośrodku i elementu głównego na dole. Główna treść tego układu można dodać jako obiekt MultiSlotLayout lub MultiButtonLayout.
  • EdgeContentLayout – układ do umieszczenia elementu CircularProgressIndicator wzdłuż krawędzi, z treścią główną w środku oraz etykietą główną lub dodatkową.
  • MultiButtonLayout – układ, który może zawierać 1–7 przycisków rozmieszczonych zgodnie z wytycznymi dotyczącymi materiału w zależności od ich liczby.
  • MultiSlotLayout – układ stylizowany na wiersze z wyrównaniem w poziomie i odstępami między boksami (na ikony i inne niewielkie treści).

We wszystkich układach zastosowano zalecane dopełnienie i style zgodne z wytycznymi dotyczącymi materiałów.

Zmiany interfejsu API

  • Zważyj na refaktoryzację komponentów elementu, w tym rozdzielaj elementy ustawiające w Kreatorze, aby każda część treści była przekazywana oddzielnie, zmieniając jej nazwę zgodnie z wytycznymi (etykieta podstawowa, etykieta dodatkowa, identyfikator zasobu obrazu). Jeśli nie skonfigurujesz opisu treści, zostanie on wygenerowany automatycznie. (I57622)
  • Nazwa konta ProgressIndicatorLayout została zmieniona na EdgeContentLayout. (IC1aa6).
  • Nazwa rozmiaru przycisku została zmieniona na sufiks without _BUTTON z dodatkowymi wyjaśnieniami w języku Javadocs w języku Button. (I1dfe2).

Poprawki błędów

  • Zaktualizowaliśmy marginesy, dopełnienie i ogólne rozmieszczenie elementów Material Layouts, aby uwzględnić wszystkie typy zalecanych układów oraz rozmiarów i kształtów ekranu.
  • Ulepszenia układu Material Design W boksach typu MultiSlotLayout ich szerokość jest teraz elastyczna, dzięki czemu będzie ona zawijać zawartość, zamiast mieć stały rozmiar.(I52919),(If18b4).
  • Obszar, który można kliknąć w aplikacji CompactChip, został zwiększony, aby zapewnić zgodność ze wskazówkami dotyczącymi ułatwień dostępu. (IE8264)

Wersja 1.1.0-alpha09

29 czerwca 2022 r.

Usługa androidx.wear.tiles:tiles-*:1.1.0-alpha09 została zwolniona. Wersja 1.1.0-alfa09 zawiera te zatwierdzenia.

Nowe funkcje

  • W usłudze ProgressIndicatorLayout dodaliśmy obsługę dodawania opcjonalnych etykiet. (I30788)

Zmiany interfejsu API

  • Metody pomocnicze dla funkcji ElementMetadata akceptują teraz metodę ElementMetadata zamiast modyfikatorów. (I5a70f)

Poprawki błędów

  • W domenie CompactChip usunięto ograniczenie wynoszące 9 znaków. Jeśli w tym języku (PrimaryLayout) tekst jest za duży i nie mieści się na ekranie, będzie mieć wielokropek. (Id56ec).
  • Moduły pobierające w domenie Chip mają teraz sufiks treści. (IBa437)
  • Wyjaśnienie języka Javadoc w klasach materiału Tiles. (I56e41), (I80f31), (Iba437)

Wersja 1.1.0-alpha08

1 czerwca 2022 r.

Usługa androidx.wear.tiles:tiles-*:1.1.0-alpha08 została zwolniona. Wersja 1.1.0-alfa08 zawiera te zatwierdzenia.

Nowe funkcje

  • Do modyfikatorów dodano tag metadanych, który można wykorzystać do śledzenia metadanych komponentu za pomocą metod pomocniczych dodanych do klasy Helper. (I70db2),(I30c3d)
  • Metoda statyczna fromLayoutElement została dodana do wszystkich komponentów i układów w materiale kafelków. Powinien być używany do testowania, do rzutowania elementu LayoutElement do pierwotnego typu uzyskanego dzięki dostępowi do zawartości kontenera. (Ia572a),(Idbd8a),(I3ae13),(I292fe),(I8b20f),(I3cacb),(I84b24)

Wersja 1.1.0-alpha07

18 maja 2022 r.

Usługa androidx.wear.tiles:tiles-*:1.1.0-alpha07 została zwolniona. Wersja 1.1.0-alfa07 zawiera te zatwierdzenia.

Zmiany interfejsu API

  • Moduły pobierające powiązane z różnymi ustawiającymi treści zostały dodane do ProgressIndicatorLayout i PrimaryLayout. Teraz wszyscy ustalający w tych zajęciach mają pasujące metody pobierania (Iddbe5). (Iabe4e).
  • Metoda pobierania opisu treści w komponentach Material Komponenty może zwracać wartość null, ponieważ jej metoda ustawiająca nie jest wymagana.
  • Próba utworzenia przycisku bez przekazanej treści spowoduje użycie parametru IllegalArgumentException. (I7fc0c)
  • Nazwa pól związanych z kolorami ikon w usłudze ChipColors została zmieniona z iconTintColor na iconColor. (IC053B)

Poprawki błędów

  • Dodano androidTests w przypadku układów w materiałach z płytek. (I96404).

Wersja 1.1.0-alpha06

11 maja 2022 roku

Usługa androidx.wear.tiles:tiles-*:1.1.0-alpha06 została zwolniona. Wersja 1.1.0-alfa06 zawiera te zatwierdzenia.

Nowe funkcje

  • Nowy układ został dodany do biblioteki podrzędnej Material Layouts – MultiButtonLayout. Reprezentuje układ, który może zawierać od 1 do 7 przycisków rozmieszczonych zgodnie ze wskazówkami dotyczącymi materiału. W większości przypadków ten układ powinien być przekazywany jako treść do elementu PrimaryLayout. (IB727f)

Zmiany interfejsu API

  • Tabela MultiSlotLayout została zmieniona tak, aby zawierała tylko przedziały. Ten układ należy przekazać jako treść do głównego panelu PrimaryLayout. (I1870F)
  • Zaktualizowano zdefiniowane kolory domyślne dla pola CircularProgressIndicator, tak aby zawierały tylko jedną wartość, zamiast koloru podstawowego i dodatkowego. (I64a51)
  • Dodano metodę pobierania dla poziomej spacji w elemencie MultiSlotLayout. (I11e1e).

Poprawki błędów

  • Testy komponentów na Androida zostały dodane do panelu Materiał kafelków. (I20041)

Wersja 1.1.0-alpha05

6 kwietnia 2022 roku

Usługa androidx.wear.tiles:tiles-*:1.1.0-alpha05 została zwolniona. Wersja 1.1.0-alfa05 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodano metody pomocnicze do przekształcania klas LayoutElement na Układ, Oś czasu i Oś czasu, aby ułatwić tworzenie kafelków. (I2f6d1)
  • Obiekt Colors został dodany do biblioteki Material Design, aby można go było przekazać między kolorami komponentów jako motyw. (I0792C)

Zmiany interfejsu API

  • Komponent Tekst materiału wymaga tekstu przekazywanego do konstruktora. Ten komponent można teraz dostosowywać przez ustawienie wagi. (I25dbd)
  • Stałe ChipDefaults, które nie są używane w publicznych elementach ustawiających, zostały usunięte. (I7Baed).
  • Usunięto podmioty pobierające z: CompactChip & TitleChip, które nie mają pasujących ustawień. (I99e85)
  • Usunięto DEFAULT_PADDING z listy ProgressIndicatorDefaults. (Idabcd)
  • W przypadku komponentów Material opis treści akceptuje teraz właściwość CharSequence, a nie String. (I5b21a)

Poprawki błędów

  • Refaktoryzowane implementacje opcjonalnych parametrów w elemencie Button. (IB7135)
  • Do czcionek w sekcji Typografia dodano wariant stylu czcionki. (I8dbc6).

Wersja 1.1.0-alfa04

23 marca 2022 r.

Usługa androidx.wear.tiles:tiles-*:1.1.0-alpha04 została zwolniona. Wersja 1.1.0-alfa04 zawiera te zatwierdzenia.

Nowe funkcje

  • Opcjonalną etykietę podstawową lub dodatkową można dodać do pola PrimaryLayout. (IB9916)
  • Komponent tekstu można dostosować przez dodanie przepełnienia, kursywy, podkreślenia itp. (I703f7).

Zmiany interfejsu API

  • Domyślne stałe kolorów zostały usunięte z interfejsu Tiles Material API. (I0Ab55)
  • Wszystkie klikalne komponenty w stylu Tiles Material wymagają obiektu Clickable w konstruktorze konstruktora, a nie działania. (I2f101)

Poprawki błędów

  • Tekst będzie teraz rysował wielokropek na nadmiarze w komponencie Element i Tekst. (I8a2f8).
  • Komponenty wyglądają lepiej, gdy skala czcionki użytkownika jest ustawiona na dużą. (IB63b1)
  • Wyjaśnienie w Javadocs obiektu setPrimaryChipContent w układzie PrimaryLayout. (IE6296).

Wersja 1.1.0-alfa03

23 lutego 2022 r.

Usługa androidx.wear.tiles:tiles-*:1.1.0-alpha03 została zwolniona. Wersja 1.1.0-alfa03 zawiera te zatwierdzenia.

Zmiany interfejsu API

  • Do materiału kafelków dodano komponent Text z zalecanymi stylami typografii. (Iec0ae),

Wersja 1.1.0-alfa02

9 lutego 2022 r.

Usługa androidx.wear.tiles:tiles-*:1.1.0-alpha02 została zwolniona. Wersja 1.1.0-alfa02 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodano nową bibliotekę podrzędną layouts w panelu Materiał kafelków. Zawiera sprawdzone układy kafelków z zalecanym dopełnieniem i marginesami, dzięki czemu tworzenie kafelków jest szybsze i łatwiejsze. Początkowe układy to:
    • PrimaryLayout (I7ba91) reprezentujący układ z elementem głównym na dole i treścią pośrodku.
    • MultiSlotLayout (I32104) reprezentujący układ z etykietami w wierszach 1 i 3, wyrównany w poziomie i w odstępach w boksach w wierszu 2 oraz 4 wierszu zawierającym element główny.
    • ProgressIndicatorLayout (I9fec6), który reprezentuje układ z okrągłym wskaźnikiem postępu wzdłuż krawędzi ekranu i wyświetlanymi treściami.
  • Element CircularProgressIndicator (Ic4b88) został dodany do komponentów Materiał płytek.

Zmiany interfejsu API

  • Zmieniono nazwy pozostałych stałych używanych przez TitleChip, aby uwzględnić tytuł w nazwie. (I14f4c)
  • Metoda setHorizontalAlignment została dodana do metody Chip. (IE6e0b)

Wersja 1.1.0-alpha01

26 stycznia 2022 r.

Usługa androidx.wear.tiles:tiles-*:1.1.0-alpha01 została zwolniona. Wersja 1.1.0-alfa01 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodano nowy materiał kafelki z biblioteki. Zawiera komponenty, które pozwalają szybciej i łatwiej tworzyć układy kafelków dzięki interfejsowi Material Design. Początkowe komponenty to:
    • Button
    • Chip
    • CompactChip
    • TitleChip

Poprawki błędów

  • Naprawiono błąd w zasadzie TileUiClient, który powodował odrzucenie zasobów z pamięci podręcznej. (I60e0B)

Wersja 1.0

Wersja 1.0.1

26 stycznia 2022 r.

Usługa androidx.wear.tiles:tiles-*:1.0.1 została zwolniona. Wersja 1.0.1 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiono błąd w zasadzie TileUiClient, który powodował odrzucenie zasobów z pamięci podręcznej. (I60e0B)

Wersja 1.0.0

3 listopada 2021 r.

Usługa androidx.wear.tiles:tiles-*:1.0.0 została zwolniona. Wersja 1.0.0 zawiera te zatwierdzenia.

Główne funkcje 1.0.0

  • W bibliotece kart na Wear OS możesz tworzyć własne karty na urządzenia z Wear OS oraz tworzyć klasy, które pozwolą systemowi pobrać kartę i wyświetlić ją obok tarczy zegarka.
  • Mechanizm renderowania kafelków umożliwia wyświetlanie kafelków w ramach aktywności na Androidzie, co ułatwia szybkie testowanie ich układów.

Wersja 1.0.0-rc01

27 października 2021 roku

Usługa androidx.wear.tiles:tiles-*:1.0.0-rc01 została zwolniona. Wersja 1.0.0-rc01 zawiera te zatwierdzenia.

Wersja 1.0.0-beta01

13 października 2021 r.

Usługa androidx.wear.tiles:tiles-*:1.0.0-beta01 została zwolniona. Wersja 1.0.0-beta01 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiono NullPointerException w TileUiClient, gdy wartość była pusta została podana. (I0586e)

Wersja 1.0.0-alfa12

29 września 2021 r.

Usługa androidx.wear.tiles:tiles-*:1.0.0-alpha12 została zwolniona. Wersja 1.0.0-alfa12 zawiera te zatwierdzenia.

Poprawki błędów

  • UpdateScheduler nie używa już słabego oraz rozwiązywanie problemów, w przypadku których TileUiClient się nie aktualizuje(I1120d, b/199061124)

  • Zadeklaruj, że SysUiTileUpdateRequester wysyła zapytania do PacakgeManagera, naprawiając Błąd polegający na tym, że aktualizacje kafelków nie działają na urządzeniach z R+. (I1120D)

Wersja 1.0.0-alfa11

1 września 2021 roku

Usługa androidx.wear.tiles:tiles-*:1.0.0-alpha11 została zwolniona. Wersja 1.0.0-alfa11 zawiera te zatwierdzenia.

Nowe funkcje

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

Zmiany interfejsu API

  • Nazwa usługi TileProviderService została zmieniona na TileService. (I1ad2c).
  • Zaktualizowano kreatory kafelków; statyczne metody .builder() zostały wycofane na rzecz wywoływania new Foo.Builder() i metody ustawiającej Przeciążenia, które akceptowały instancję Builder, zostały usunięte. (IA9606).
  • Aplikacja TileRenderer powinna teraz używać kontekstu interfejsu zamiast kontekstu aplikacji. (I84b61)

Poprawki błędów

  • Napraw błąd polegający na stosowaniu wielu podkreśleń w niektórych w różnych sytuacjach. (IB6712)

Wersja 1.0.0-alpha10

18 sierpnia 2021 r.

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 zostały udostępnione. Wersja 1.0.0-alfa10 zawiera te zatwierdzenia.

Zmiany interfejsu API

  • Usunięto mechanizmy sprawdzania układu z publicznego interfejsu API. Będą to zawsze: jest włączona, jednak w przypadku niepowodzenia testu jest wyświetlane ostrzeżenie. (IE9f29)
  • TileRenderer akceptuje teraz kontekst interfejsu użytkownika zamiast kontekstu aplikacji.

Poprawki błędów

  • Naprawiliśmy błąd, który uniemożliwiał klikanie klikalnych elementów w elemencie spannable.

Wersja 1.0.0-alpha09

21 lipca 2021 r.

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 zostały udostępnione. Wersja 1.0.0-alfa09 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodano narzędzia do sprawdzania układu do karty aplikacji na Wear mechanizm renderowania. (I3a869)
    • Służą one do weryfikowania sprawdzonych metod w kafelku. Na początek spowoduje to wyświetlenie ostrzeżenia, jeśli kafelek nie zawiera żadnych elementów z modyfikatorem Semantics.
  • Dodano dokumentację dotyczącą: DefaultTileProviderClient i TestingTileProviderClient constructors (I9f4b9)

Zmiany interfejsu API

  • Zmiana nazwy w obiekcie TileProviderClient (I0ec36):
    • getApiVersion -> requestApiVersion
    • tile/resourcesRequest -> requestTile/Resources
    • onTileFooEvent -> sendOnTileFooEvent
  • Dodano narzędzia do sprawdzania układu do karty aplikacji na Wear mechanizm renderowania. (I3a869)

Poprawki błędów

  • Upewnij się, że cel LaunchAction nie ma żadnych specjalnych właściwości uprawnień. (I39136)

Wersja 1.0.0-alpha08

30 czerwca 2021 r.

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 zostały udostępnione. Wersja 1.0.0-alfa08 zawiera te zatwierdzenia.

Nowe funkcje

  • Elementy spannable obsługują teraz atrybut line_height zamiast line_spacing.

Zmiany interfejsu API

  • Dodano obsługę parametru line_height w Spannables, usuń element line_spacing. (Ibeb54)
    • Kod z parametrem line_spacing powinien zostać przeniesiony tak, aby zamiast tego używał parametru line_height.

Poprawki błędów

  • Naprawiono błąd związany z używaniem wymiarów proporcjonalnych. (I37ace)
  • Naprawiono błąd uniemożliwiający elementy tekstowe zawierające opisy treści. (Id2c7d).

Wersja 1.0.0-alpha07

16 czerwca 2021 r.

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 zostały udostępnione. Wersja 1.0.0-alfa07 zawiera te zatwierdzenia.

Zmiany interfejsu API

  • Dodaj interfejs TileProviderClient i udostępnij DefaultTileProviderClient, dzięki czemu implementacje mogą powiązać interfejsu TileProviderService. (I69165).

Wersja 1.0.0-alpha06

2 czerwca 2021 r.

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 zostały udostępnione. Wersja 1.0.0-alfa06 zawiera te zatwierdzenia.

Zmiany interfejsu API

  • Wszystkie klasy konstruktora zawierają teraz metody pobierania dla wszystkich właściwości. Pamiętaj, że są one przeznaczone tylko do testów (I9d155)
  • Zmiana pakietu: zajęcia z androidx.wear.tiles.builders zostały przeniesione na listę androidx.wear.tiles.
  • Dodaj eksperymentalną obsługę odcieni do kart. (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).
  • Dodano klasy konstruktora dla żądań i zdarzeń. (Ib5cf4).
  • Przeniesiono funkcję TileProviderService, aby umożliwić korzystanie z klas żądań i zdarzeń z klas RequestBuilders i EventBuilders, a nie z RequestReaders/EventReaders (np. onTileRequest zapewnia teraz wartość RequestBuilders.TileRequest, a nie RequestReaders.TileRequest). (I46ea1).

Poprawki błędów

  • Naprawiono błąd asynchronicznego wczytywania obrazów w mechanizmie renderowania kafelków. (Iad9b0).
  • Usunięto błąd układu, który pojawiał się podczas umieszczania obrazu o szerokości lub wysokości ustawionej na expand() w elemencie Box o szerokości lub wysokości ustawionej na wrap(). (I33770)

Wersja 1.0.0-alpha05

18 maja 2021 r.

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 zostały udostępnione. Wersja 1.0.0-alfa05 zawiera te zatwierdzenia.

Zmiany interfejsu 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)
  • Zmieniono nazwę „TimelineManager#deInit” na zamknięcie i zaimplementowano AutoCloseable (I5dff2)

Wersja 1.0.0-alpha04

5 maja 2021 roku

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 zostały udostępnione. Wersja 1.0.0-alfa04 zawiera te zatwierdzenia.

Zmiany interfejsu API

  • Ukryte konkretne klasy TileProviderService.
    • Aplikacja TileUpdateRequester prosi o zgłoszenie: Class<? extends TileProviderService>. (Ib7cca)
  • Dodano możliwość dodawania dodatków do AndroidActivity. (I748f4)

Kafelki w wersji 1.0.0-alfa03

21 kwietnia 2021 r.

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 zostały udostępnione. Wersja 1.0.0-alfa03 zawiera te zatwierdzenia.

Zmiany interfejsu API

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

Poprawki błędów

  • Dodano reguły ProGuard, które zapewniają prawidłowe działanie tiles i tiles-renderer z włączoną funkcją Proguard (Ie3d85)

Wersja 1.0.0-alpha02

7 kwietnia 2021 r.

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 zostały udostępnione. Wersja 1.0.0-alfa02 zawiera te zatwierdzenia.

Zmiany interfejsu API

  • Grupa androidx.wear:wear-tiles została przeniesiona i ma teraz nazwę androidx.wear.tiles:tiles
  • Grupa androidx.wear:wear-tiles-renderer została przeniesiona i ma teraz nazwę androidx.wear.tiles:tiles-renderer
  • Funkcja TileRenderer.LoadActionListener używa teraz instancji androidx.wear.tiles.builders.StateBuilders.State, a nie androidx.wear.tiles.proto.StateProto.State.
  • TileRenderer akceptuje teraz zasoby Tile z instancji androidx.wear.tiles.builders.ResourceBuilders.Resources, a nie instancję androidx.wear.tiles.renderer.ResourceAccessors.

Poprawki błędów

  • Naprawiono brak możliwości użycia klasy LoadActionListener, ponieważ udostępniała klasę wewnętrzną.

Wersja 1.0.0-alpha01

10 marca 2021 r.

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 zostały udostępnione. Wersja 1.0.0-alfa01 zawiera te zatwierdzenia.

Nowe funkcje

  • Biblioteka mechanizmu renderowania kafelków Wear umożliwia tworzenie własnych Kafelki urządzeń z Wear OS wraz z klasami, które zezwalają na korzystanie z systemu aby pobrać kartę i wyświetlić ją obok tarczy zegarka.