Носить плитку

Носить плитку

Пример кода руководства пользователя

Справочник по API
androidx.wear.tiles

Создавайте приложения для умных часов Wear OS by Google.

Последнее обновление	Стабильный выпуск	Кандидат на выпуск	Бета-версия	Альфа-релиз
26 февраля 2025 г.	1.4.1	-	-	1.5.0-альфа09

Объявление зависимостей

Чтобы добавить зависимость от Wear, вам необходимо добавить в свой проект репозиторий Google Maven. Для получения дополнительной информации прочтите репозиторий Google Maven .

Добавьте зависимости для нужных вам артефактов в файл build.gradle для вашего приложения или модуля:

классный

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

Котлин

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

Дополнительные сведения о зависимостях см. в разделе Добавление зависимостей сборки .

Обратная связь

Ваши отзывы помогают сделать Jetpack лучше. Дайте нам знать, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете добавить свой голос к существующей проблеме, нажав кнопку со звездочкой.

Создать новую задачу

Дополнительную информацию см. в документации по системе отслеживания проблем .

Версия 1.5

Версия 1.5.0-альфа09

26 февраля 2025 г.

Выпущен androidx.wear.tiles:tiles-*:1.5.0-alpha09 . Версия 1.5.0-alpha09 содержит эти коммиты .

Версия 1.5.0-альфа08

12 февраля 2025 г.

Выпущен androidx.wear.tiles:tiles-*:1.5.0-alpha08 . Версия 1.5.0-alpha08 содержит эти коммиты .

Изменения API

• TileService.onRecentInteractionEvents() для возврата ListenableFuture<Void> , что позволяет выполнять длительные задачи. ( Iaa6c5 )

Версия 1.5.0-альфа07

29 января 2025 г.

Выпущен androidx.wear.tiles:tiles-*:1.5.0-alpha07 . Версия 1.5.0-alpha07 содержит эти коммиты .

Версия 1.5.0-альфа06

15 января 2025 г.

Выпущен androidx.wear.tiles:tiles-*:1.5.0-alpha06 . Версия 1.5.0-alpha06 содержит эти коммиты .

Изменения API

• Метод processRecentInteractionEvents переименован в onRecentInteractionEvents . ( IEC3d5 )

Версия 1.5.0-альфа05

11 декабря 2024 г.

Выпущен androidx.wear.tiles:tiles-*:1.5.0-alpha05 . Версия 1.5.0-alpha05 содержит эти коммиты .

Новые возможности

• Добавьте API для TileService для пакетной обработки событий взаимодействия. ( I04d1b )

Исправления ошибок

• Эта библиотека теперь использует аннотации NULL JSpecify , которые являются типизированными. Разработчики Kotlin должны использовать следующие аргументы компилятора для обеспечения правильного использования: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode ( I390e9 , b/326456246 )
• Исправлена ​​ошибка, из-за которой запрос обновлений плиток в API 34, когда targetSdk приложения выше 34, вызывал исключение SecurityException ( If62a1 ).
• Исправлена ​​зависимость от WearSdk в тестах Robolectric. ( I37796 )

Версия 1.5.0-альфа04

13 ноября 2024 г.

Выпущен androidx.wear.tiles:tiles-*:1.5.0-alpha04 . Версия 1.5.0-alpha04 содержит эти коммиты .

Версия 1.5.0-альфа03

30 октября 2024 г.

Выпущен androidx.wear.tiles:tiles-*:1.5.0-alpha03 . Версия 1.5.0-alpha03 содержит эти коммиты .

Версия 1.5.0-альфа02

16 октября 2024 г.

Выпущен androidx.wear.tiles:tiles-*:1.5.0-alpha02 . Версия 1.5.0-alpha02 содержит эти коммиты .

Исправления безопасности

• После этого изменения androidx компилируется с protobuf 4.28.2 для устранения CVE-2024-7254 . Обновите свою зависимость от версии 1.5.0-alpha01 androidx.wear.tiles:tiles-proto до 1.5.0-alpha02, чтобы устранить риск уязвимости.

Версия 1.5.0-альфа01

2 октября 2024 г.

Выпущен androidx.wear.tiles:tiles-*:1.5.0-alpha01 . Версия 1.5.0-alpha01 содержит эти коммиты .

Версия 1.4

Версия 1.4.1

16 октября 2024 г.

Выпущен androidx.wear.tiles:tiles-*:1.4.1 . Версия 1.4.1 содержит эти коммиты .

Исправления безопасности

• После этого изменения androidx компилируется с protobuf 4.28.2 для устранения CVE-2024-7254 . Обновите свою зависимость от версии 1.4.0 androidx.wear.tiles:tiles-proto до 1.4.1, чтобы устранить риск уязвимости.

Версия 1.4.0

7 августа 2024 г.

Выпущен androidx.wear.tiles:tiles-*:1.4.0 . Версия 1.4.0 содержит эти коммиты .

Важные изменения с версии 1.3.0

• Поддержка инструментов для указания пользовательских данных платформы для предварительного просмотра плиток в Android Studio.

Версия 1.4.0-rc01

24 июля 2024 г.

androidx.wear.tiles:tiles-*:1.4.0-rc01 выпущен без изменений по сравнению с предыдущим выпуском. Версия 1.4.0-rc01 содержит эти коммиты .

Версия 1.4.0-бета01

10 июля 2024 г.

Выпущен androidx.wear.tiles:tiles-*:1.4.0-beta01 . Версия 1.4.0-beta01 содержит эти коммиты .

Новые возможности

В выпуске Wear Tiles 1.4.0-beta01 указано, что этот выпуск библиотеки является полнофункциональным, а API заблокирован (за исключением тех случаев, когда он помечен как экспериментальный). Wear Tiles 1.4 включает следующие новые функции и API:

• Поддержка инструментов для указания пользовательских данных платформы для предварительного просмотра плиток в Android Studio.

Версия 1.4.0-альфа05

26 июня 2024 г.

Выпущен androidx.wear.tiles:tiles-*:1.4.0-alpha05 . Версия 1.4.0-alpha05 содержит эти коммиты .

Версия 1.4.0-альфа04

29 мая 2024 г.

Выпущен androidx.wear.tiles:tiles-*:1.4.0-alpha04 . Версия 1.4.0-alpha04 содержит эти коммиты .

Версия 1.4.0-альфа03

14 мая 2024 г.

Выпущен androidx.wear.tiles:tiles-*:1.4.0-alpha03 . Версия 1.4.0-alpha03 содержит эти коммиты .

Исправления ошибок

• TileService#getActiveTilesAsync теперь использует API WearSdk (если доступен) для обеспечения более точного результата. ( I57bd8 )

Версия 1.4.0-альфа02

1 мая 2024 г.

Выпущен androidx.wear.tiles:tiles-*:1.4.0-alpha02 . Версия 1.4.0-alpha02 содержит эти коммиты .

Изменения API

• Переместите tileId в параметр конструктора Builder в качестве обязательного поля и задокументируйте значение метки времени по умолчанию в методе получения. ( I98c2b )
• Добавьте прототипы сообщений TileInteractionEvent , TileEnter и TileLeave , а также оболочки Java, необходимые для пакетной обработки событий входа/выхода плитки. ( I112b0 )
• Рефакторинг TileRenderer для использования Builder вместо объекта TileRenderer.Config . ( Ib66f9 )
• Добавьте атрибут platformDataProviders в TileRenderer.Config . ( I6030d )
• Добавьте в TileRenderer новый конструктор, поддерживающий новый класс TileRenderer.Config . Другие конструкторы устарели. ( Iae7ff )
• Добавьте поле platformDataValues ​​в TilePreviewData , чтобы разрешить переопределение значений данных платформы. ( Если437а )

Исправления ошибок

• Задокументируйте, что значение по умолчанию для TileRenderer.Config.Builder#setTilesTheme равно нулю. ( Лед18 )

Версия 1.4.0-альфа01

6 марта 2024 г.

Выпущен androidx.wear.tiles:tiles-*:1.4.0-alpha01 . Версия 1.4.0-alpha01 содержит эти коммиты .

Версия 1.3

Версия 1.3.0

7 февраля 2024 г.

Выпущен androidx.wear.tiles:tiles-*:1.3.0 . Версия 1.3.0 содержит эти коммиты.

Важные изменения с версии 1.2.0

• Обновлены инструменты для поддержки предварительного просмотра плиток.
• Поддержка запроса активных плиток, принадлежащих приложению.

Дополнительные изменения

• Более полный набор изменений, представленных в версии 1.3.0, см. в примечаниях к выпуску beta01 .

Версия 1.3.0-rc01

24 января 2024 г.

Выпущен androidx.wear.tiles:tiles-*:1.3.0-rc01 . Версия 1.3.0-rc01 содержит эти коммиты.

Изменения API

• TileService#getActiveTilesSnapshotAsync переименован в getActiveTilesAsync . ( Если6b87 )

Версия 1.3.0-бета01

10 января 2024 г.

Выпущен androidx.wear.tiles:tiles-*:1.3.0-beta01 . Версия 1.3.0-beta01 содержит эти коммиты.

В выпуске Wear Tiles 1.3.0-beta01 указано, что этот выпуск библиотеки является полнофункциональным, а API заблокирован (кроме тех случаев, когда он помечен как экспериментальный). Wear Tiles 1.3 включает следующие новые функции и API:

• Модуль инструментов для плиток износа обновлен для поддержки предварительного просмотра плиток и готов к публикации.
• Поддержка запроса того, какие плитки, принадлежащие приложению, активны, с помощью TileService.getActiveTilesSnapshotAsync .

Версия 1.3.0-альфа04

13 декабря 2023 г.

Выпущен androidx.wear.tiles:tiles-*:1.3.0-alpha04 . Версия 1.3.0-alpha04 содержит эти коммиты.

Версия 1.3.0-альфа03

29 ноября 2023 г.

Выпущен androidx.wear.tiles:tiles-*:1.3.0-alpha03 . Версия 1.3.0-alpha03 содержит эти коммиты.

Новые возможности

• Добавлен новый API TileService#getActiveTilesSnapshotAsync для запроса того, какие плитки, принадлежащие приложению, активны. ( I6850e )

Изменения API

• Переименуйте @TilePreview в @Preview ( Ifc08a ).

Версия 1.3.0-альфа02

15 ноября 2023 г.

Выпущен androidx.wear.tiles:tiles-*:1.3.0-alpha02 . Версия 1.3.0-alpha02 содержит эти коммиты.

Новые возможности

• Мы добавили экспериментальный API для автоматического масштабирования размера текста в зависимости от пространства, которое он имеет внутри родительского элемента. ( Иббе63 )

Версия 1.3.0-альфа01

18 октября 2023 г.

Выпущен androidx.wear.tiles:tiles-*:1.3.0-alpha01 . Версия 1.3.0-alpha01 содержит эти коммиты.

Новые возможности

• Предоставьте контекст в качестве параметра метода предварительного просмотра вместо параметров обратного вызова TilePreviewData . ( I5e97d )
• Модуль инструментов для плиток износа обновлен для поддержки предварительного просмотра плиток и готов к публикации. ( I63d0f )

Версия 1.2

Версия 1.2.0

9 августа 2023 г.

Выпущен androidx.wear.tiles:tiles-*:1.2.0 . Версия 1.2.0 содержит эти коммиты.

Важные изменения с версии 1.1.0

• Стабильная версия Wear Tiles 1.2.0 ( подробнее )
• В Tiles 1.2 добавлена ​​поддержка привязки элементов макета к данным платформы (для более быстрого обновления) и анимации. Инструкции по миграции см. в примечаниях к выпуску ( 1.2.0-rc01 ).

Версия 1.2.0-rc01

26 июля 2023 г.

Выпущен androidx.wear.tiles:tiles-*:1.2.0-rc01 . Версия 1.2.0-rc01 содержит эти коммиты.

• В выпуске v1.2 библиотека Tiles была реорганизована, и большинство функций и API перенесены в новую библиотеку ProtoLayout (пакет androidx.wear.protolayout ), при этом в Tiles осталось небольшое подмножество ( androidx.wear.tiles ):

  • Названия всех классов остались прежними, есть только дополнения к версии v1.1.
  • Большинство API остались прежними, единственное изменение — это имя пакета.
  • Некоторые методы в TileService/TileBuilder устарели и теперь имеют переименованные версии, которые принимают новые типы ProtoLayout вместо устаревшего типа Tiles.

• Чтобы облегчить эту миграцию, мы собрали небольшую инструкцию и скрипт, выполняющий такое переименование, см. здесь .

Изменения API

• Мы ограничили максимальную глубину макета 30 вложенными элементами в плитке. Если эта глубина превышена, средство визуализации плиток покажет ранее увеличенный макет. ( I8a74b )

Версия 1.2.0-бета01

21 июня 2023 г.

androidx.wear.tiles:tiles-*:1.2.0-beta01 выпущен без изменений. Версия 1.2.0-beta01 содержит эти коммиты.

Версия 1.2.0-альфа07

7 июня 2023 г.

Выпущен androidx.wear.tiles:tiles-*:1.2.0-alpha07 . Версия 1.2.0-alpha07 содержит эти коммиты.

Новые возможности

• TileRenderer.setState позволяет установить состояние сеанса рендеринга. Это состояние будет применяться к текущему макету и любому будущему (пока не будет установлено новое состояние) ( Iaaf35 ).
• Типы protolayout теперь полностью поддерживаются во всех APIS модуля рендеринга фрагментов. ( I428b0 )

Исправления ошибок

• Установка пользовательской темы теперь возможна в ProtoLayoutViewInstance . ( Iae8c0 )

Версия 1.2.0-альфа06

24 мая 2023 г.

Выпущен androidx.wear.tiles:tiles-*:1.2.0-alpha06 . Версия 1.2.0-alpha06 содержит эти коммиты.

Изменения API

• Переименуйте StateEntryValue в DynamicDataValue и обновите API состояния, чтобы использовать DynamicDataKey ( If1c01 ).
• Мы ограничиваем количество записей, разрешенных в StateStore , чтобы гарантировать, что использование памяти и время обновления состояния хорошо сдерживаются и контролируются для каждого экземпляра StateStore . В результате разработчику необходимо убедиться, что у него не более MAX_STATE_ENTRY_COUNT записей на карте, иначе он получит исключение IllegalStateException при создании или обновлении StateStore . ( Ибадб3 )

Версия 1.2.0-альфа05

10 мая 2023 г.

Выпущен androidx.wear.tiles:tiles-*:1.2.0-alpha05 . Версия 1.2.0-alpha05 содержит эти коммиты.

Новые возможности

• Мы добавили идентификатор плитки в события и запросы плитки. Этот идентификатор можно использовать для связи некоторых данных с экземпляром плитки в карусели. ( Ic4f83 )

Изменения API

• TileRenderer.inflateAsync теперь возвращает ListenableFuture . ( I2f2b9 )
• Построители плиток, у которых есть замена в библиотеке protolayout , теперь помечаются как устаревшие. ( Ie2029 )

Исправления ошибок

• Javadoc для TileService.onTileResourcesRequest теперь поясняет, когда этот метод может быть вызван системой. ( Iee037 )

Версия 1.2.0-альфа04

19 апреля 2023 г.

Выпущен androidx.wear.tiles:tiles-*:1.2.0-alpha04 . Версия 1.2.0-alpha04 содержит эти коммиты.

Исправления ошибок

• Зависимости градиента теперь правильно устанавливаются на api вместо implementation , когда это необходимо. ( I40503 )

Версия 1.2.0-альфа03

5 апреля 2023 г.

Выпущен androidx.wear.tiles:tiles-*:1.2.0-alpha03 . Версия 1.2.0-alpha03 содержит эти коммиты.

Изменения API

• Мы добавили поддержку типов androidx.wear.protolayout в TileRenderer ( I4ac7f ).
• ObservableStateStore был переименован в StateStore . ( Ieb0e2 )
• Добавьте перегрузки для типов protolayout в TileRenderer ( I4ac7f ).
• Включить анимацию в TileRenderer ( I07dcf )

Версия 1.2.0-альфа02

22 марта 2023 г.

Выпущен androidx.wear.tiles:tiles-*:1.2.0-alpha02 . Версия 1.2.0-alpha02 содержит эти коммиты.

Изменения API

• Библиотека материалов Tiles устарела. Используйте новую библиотеку ProtoLayout Material с теми же функциями. ( Если242б )

Исправления ошибок

• TileRenderer был обновлен для использования новых функций из библиотеки protolayout. ( I832f9 )

Версия 1.2.0-альфа01

8 марта 2023 г.

Выпущен androidx.wear.tiles:tiles-*:1.2.0-alpha01 . Версия 1.2.0-alpha01 содержит эти коммиты.

Новые возможности

• Мы добавили onTileResourceRequest в TileService для предоставления ресурсов из библиотеки protolayout . ( 983d9c5 )
• Мы обновили ResourcesRequest и TileRequest для поддержки типов State и DeviceParameters из библиотеки protolayout . ( 88fa01d )
• Мы обновили TileBuilders.Tile для поддержки типов State и Timeline из библиотеки protolayout . ( 168619с )

Исправления ошибок

• Улучшения в Javadocs. ( I3ed73 )
• Цвета по умолчанию для onPrimary и поверхности изменились. ( I0b039 )

Версия 1.1

Версия 1.1.0

24 августа 2022 г.

Выпущен androidx.wear.tiles:tiles-*:1.1.0 . Версия 1.1.0 содержит эти коммиты.

Важные изменения с версии 1.0.0

• Это первый стабильный выпуск, содержащий библиотеку материалов Tiles (подробнее читайте в нашем блоге ).
• Эта библиотека содержит компоненты и макеты, которые соответствуют рекомендациям по материалам и просты в использовании. Включенные компоненты: Button , Chip , CompactChip , TitleChip , CircularProgressIndicator , Text . Все эти компоненты имеют собственный объект цветов, который можно создать с помощью основного класса Colors, чтобы легко применять одну и ту же тему ко всем компонентам. Помимо цветов, существует класс Typography, позволяющий легко получать объекты FontStyle, используя имя типографии.
• Помимо компонентов, существуют рекомендуемые тайловые макеты — PrimaryLayout , EdgeContentLayout , MultiButtonLayout , MultiSlotLayout . Ко всем макетам применены рекомендованные отступы и стили, соответствующие рекомендациям по материалам.
• Список компонентов и макетов в библиотеке материалов Tiles см. в примечаниях к выпуску Tiles .

Версия 1.1.0-rc01

10 августа 2022 г.

Выпущен androidx.wear.tiles:tiles-*:1.1.0-rc01 . Версия 1.1.0-rc01 содержит эти коммиты.

• Между бета-версией и версией RC не было никаких новых изменений.

Версия 1.1.0-бета01

27 июля 2022 г.

Выпущен androidx.wear.tiles:tiles-*:1.1.0-beta01 . Версия 1.1.0-beta01 содержит эти коммиты.

Версия 1.0.0-beta01 библиотеки материалов Tiles содержит компоненты и макеты, которые соответствуют рекомендациям по материалам и просты в создании.

В состав входят следующие компоненты:

• Button — кликабельный объект круглой формы со значком, текстом или изображением трех предустановленных размеров.
• Chip — интерактивный объект в форме стадиона, который может содержать значок, основные и дополнительные метки, имеет фиксированную высоту и настраиваемую ширину.
• CompactChip и TitleChip — две вариации стандартного Чипа, имеющие соответственно меньшую и большую высоту и способные содержать одну строку текста.
• CircularProgressIndicator — цветная дуга по краю экрана с заданными начальным и конечным углами, которая может описывать полный или частичный круг, за которым находится полная дуга прогресса.
• Text — текст со стилем, в котором используются рекомендуемые стили оформления Wear Material.

Все эти компоненты имеют собственный объект цветов, который можно создать с помощью основного класса Colors , чтобы легко применять одну и ту же тему ко всем компонентам. Помимо цветов, существует класс Typography , позволяющий легко получать объекты FontStyle , используя имя типографии.

Помимо компонентов, существуют рекомендуемые раскладки тайлов:

• PrimaryLayout — макет, который можно настроить путем добавления основных или дополнительных меток, содержимого посередине и основного чипа внизу. Основное содержимое этого макета можно добавить как объект MultiSlotLayout или MultiButtonLayout .
• EdgeContentLayout — макет для размещения CircularProgressIndicator по краю с основным содержимым внутри и основной или вторичной меткой вокруг него.
• MultiButtonLayout — макет, который может содержать от 1 до 7 кнопок, расположенных в соответствии с рекомендациями по материалам, в зависимости от их количества.
• MultiSlotLayout — макет в виде строк с горизонтально выровненными и разнесенными слотами (для значков или другого небольшого содержимого).

Ко всем макетам применены рекомендованные отступы и стили, соответствующие рекомендациям по материалам.

Изменения API

• Крупный рефакторинг компонентов Chip, который включает в себя разделение установщиков в Builder, чтобы каждая часть контента передавалась отдельно с переименованием в соответствии с рекомендациями (первичная метка, вторичная метка, идентификатор ресурса изображения). Кроме того, описание контента будет создано автоматически, если оно не установлено. ( I57622 )
• ProgressIndicatorLayout был переименован в EdgeContentLayout . ( Ic1aa6 )
• Содержимое размера кнопки было переименовано в имена without _BUTTON с дополнительными пояснениями Javadocs для Button . ( I1dfe2 )

Исправления ошибок

• Поля, отступы и общее расположение в макетах материалов были обновлены для соответствия всем типам рекомендуемых макетов, а также размерам и формам экрана.
• Улучшения в макетах материалов. В MultiSlotLayout слоты теперь имеют гибкую ширину, при которой они оборачивают содержимое, а не имеют фиксированный размер. ( I52919 ), ( If18b4 ).
• Область, которую можно использовать на CompactChip , была увеличена в соответствии с правилами доступности. ( Ie8264 )

Версия 1.1.0-альфа09

29 июня 2022 г.

Выпущен androidx.wear.tiles:tiles-*:1.1.0-alpha09 . Версия 1.1.0-alpha09 содержит эти коммиты.

Новые возможности

• Мы добавили поддержку добавления необязательных меток в ProgressIndicatorLayout . ( I30788 )

Изменения API

• Вспомогательные методы для ElementMetadata теперь принимают ElementMetadata вместо модификаторов. ( I5a70f )

Исправления ошибок

• Ограничение в 9 символов на CompactChip было снято. Если текст слишком велик и не помещается на экране в PrimaryLayout , он будет иметь эллиптический размер. ( Id56ec )
• Геттеры в Chip теперь имеют суффикс Content . ( Иба437 )
• Разъяснение Javadoc по классам материалов Tiles. ( И56е41 ), ( И80ф31 ), ( Иба437 )

Версия 1.1.0-альфа08

1 июня 2022 г.

Выпущен androidx.wear.tiles:tiles-*:1.1.0-alpha08 . Версия 1.1.0-alpha08 содержит эти коммиты.

Новые возможности

• В модификаторы добавлен тег метаданных, который будет использоваться для отслеживания метаданных компонента с помощью вспомогательных методов, добавленных в класс Helper . ( I70db2 ), ( I30c3d )
• Статический метод fromLayoutElement был добавлен ко всем компонентам и макетам внутри Tiles Material. Его следует использовать для тестирования, чтобы привести LayoutElement, полученный в результате доступа к содержимому контейнера, к исходному типу. ( Ia572a ),( Idbd8a ),( I3ae13 ),( I292fe ),( I8b20f ),( I3cacb ),( I84b24 )

Версия 1.1.0-альфа07

18 мая 2022 г.

Выпущен androidx.wear.tiles:tiles-*:1.1.0-alpha07 . Версия 1.1.0-alpha07 содержит эти коммиты.

Изменения API

• Геттеры, связанные с различными сеттерами контента, теперь добавлены в ProgressIndicatorLayout и PrimaryLayout . Теперь все сеттеры в этих классах имеют соответствующие геттеры.( Iddbe5 ) ( Iabe4e )
• Метод получения для описания содержимого в компонентах материала может возвращать значение null, поскольку его метод установки не является обязательным.
• Попытка создать кнопку без переданного содержимого приведет к исключению IllegalArgumentException . ( I7fc0c )
• Поля, связанные с цветом значков, в ChipColors были переименованы с iconTintColor на iconColor . ( Ic053b )

Исправления ошибок

• Добавлены androidTests для макетов в материале плиток. ( I96404 )

Версия 1.1.0-альфа06

11 мая 2022 г.

Выпущен androidx.wear.tiles:tiles-*:1.1.0-alpha06 . Версия 1.1.0-alpha06 содержит эти коммиты.

Новые возможности

• Новый макет был добавлен в подбиблиотеку Material Layouts — MultiButtonLayout . Он представляет собой макет, который может содержать от 1 до 7 кнопок, расположенных в соответствии с рекомендациями по материалам. В большинстве случаев этот макет следует передавать в качестве содержимого PrimaryLayout . ( Ib727f )

Изменения API

• MultiSlotLayout был переработан, чтобы в нем были только слоты. Этот макет следует передать в качестве содержимого в основной PrimaryLayout . ( I1870f )
• Обновлены определенные цвета по умолчанию для CircularProgressIndicator , чтобы они имели одно значение вместо основного и вторичного. ( I64a51 )
• Добавлен метод получения горизонтальной прокладки в MultiSlotLayout . ( I11e1e )

Исправления ошибок

• В Tiles Material добавлены тесты Android для компонентов. ( я20041 )

Версия 1.1.0-альфа05

6 апреля 2022 г.

Выпущен androidx.wear.tiles:tiles-*:1.1.0-alpha05 . Версия 1.1.0-alpha05 содержит эти коммиты.

Новые возможности

• Добавлены вспомогательные методы для преобразования LayoutElement в Layout, Timeline, TimelineEntry в эти классы для упрощения создания плиток. ( I2f6d1 )
• Объект Colors был добавлен в библиотеку материалов для передачи цветов компонентам в качестве темы. ( I0792c )

Изменения API

• Для компонента Material Text требуется текст, передаваемый в конструктор. Теперь этот компонент можно настроить, задав вес. ( I25dbd )
• Удалены константы из ChipDefaults , которые не используются в публичных установках. ( I7baed )
• Удалены геттеры из CompactChip и TitleChip , у которых нет соответствующих сеттеров. ( I99e85 )
• Удален DEFAULT_PADDING из ProgressIndicatorDefaults . ( Идабкд )
• Компоненты материала теперь принимают CharSequence для описания контента вместо String. ( I5b21a )

Исправления ошибок

• Рефакторинг установщиков дополнительных параметров в Button. ( Ib7135 )
• К шрифтам в Typography добавлен вариант стиля шрифта. ( I8dbc6 )

Версия 1.1.0-альфа04

23 марта 2022 г.

Выпущен androidx.wear.tiles:tiles-*:1.1.0-alpha04 . Версия 1.1.0-alpha04 содержит эти коммиты.

Новые возможности

• В PrimaryLayout можно добавить дополнительную первичную или вторичную метку. ( Ib9916 )
• Текстовый компонент можно настроить, установив переполнение, курсив, подчеркивание и т. д. ( I703f7 ).

Изменения API

• Цветовые константы по умолчанию были удалены из API материалов Tiles. ( I0ab55 )
• Для всех интерактивных компонентов в Tiles Material требуется объект Clickable в конструкторе их Builder вместо действия. ( I2f101 )

Исправления ошибок

• Текст теперь будет рисовать многоточие при переполнении в компоненте «Чип и текст». ( I8a2f8 )
• Улучшен внешний вид компонентов, когда масштаб пользовательского шрифта установлен на большой. ( Ib63b1 )
• Уточните Javaдокументацию setPrimaryChipContent в PrimaryLayout. ( Ie6296 )

Версия 1.1.0-альфа03

23 февраля 2022 г.

Выпущен androidx.wear.tiles:tiles-*:1.1.0-alpha03 . Версия 1.1.0-alpha03 содержит эти коммиты.

Изменения API

• В материал TIles добавлен Text компонент с рекомендуемыми стилями оформления. ( Iec0ae )

Версия 1.1.0-альфа02

9 февраля 2022 г.

Выпущен androidx.wear.tiles:tiles-*:1.1.0-alpha02 . Версия 1.1.0-alpha02 содержит эти коммиты.

Новые возможности

• Добавлена ​​новая подбиблиотека layouts в Tiles Material. Он содержит продуманные макеты плиток с рекомендуемыми отступами и полями, которые позволяют ускорить и упростить реализацию разработки плиток. Первоначальные макеты:
  • PrimaryLayout ( I7ba91 ), представляющий макет с основным чипом внизу и содержимым в центре.
  • MultiSlotLayout ( I32104 ), который представляет собой макет с метками в строках 1 и 3, горизонтально выровненными и разнесенными слотами в строке 2, за которыми следует 4-я строка, содержащая основной чип.
  • ProgressIndicatorLayout ( I9fec6 ), который представляет макет с круговым индикатором выполнения по краю экрана и заданным содержимым внутри.
• CircularProgressIndicator ( Ic4b88 ) был добавлен к компонентам Tiles Material.

Изменения API

• Переименованы остальные константы, используемые TitleChip для включения заголовка в имя. ( I14f4c )
• В Chip добавлен метод setHorizontalAlignment . ( Ie6e0b )

Версия 1.1.0-альфа01

26 января 2022 г.

Выпущен androidx.wear.tiles:tiles-*:1.1.0-alpha01 . Версия 1.1.0-alpha01 содержит эти коммиты.

Новые возможности

• Добавлена ​​новая библиотека Tiles Material. Он содержит компоненты для более быстрого и простого создания макетов плиток с помощью Material Design. Исходные компоненты:
  • Button
  • Chip
  • CompactChip
  • TitleChip

Исправления ошибок

• Исправлена ​​ошибка в TileUiClient , которая приводила к удалению кэшированных ресурсов. ( I60e0b )

Версия 1.0

Версия 1.0.1

26 января 2022 г.

Выпущен androidx.wear.tiles:tiles-*:1.0.1 . Версия 1.0.1 содержит эти коммиты.

Исправления ошибок

• Исправлена ​​ошибка в TileUiClient , которая приводила к удалению кэшированных ресурсов. ( I60e0b )

Версия 1.0.0

3 ноября 2021 г.

Выпущен androidx.wear.tiles:tiles-*:1.0.0 . Версия 1.0.0 содержит эти коммиты.

Основные особенности версии 1.0.0

• Библиотека Wear Tiles предоставляет функциональные возможности для создания пользовательских плиток для устройств Wear OS, а также классы, которые позволяют системе получать плитку и отображать ее рядом с циферблатом.
• tiles-renderer позволяет отображать плитку как часть активности Android, что облегчает быстрое тестирование макетов плиток.

Версия 1.0.0-rc01

27 октября 2021 г.

Выпущен androidx.wear.tiles:tiles-*:1.0.0-rc01 . Версия 1.0.0-rc01 содержит эти коммиты.

Версия 1.0.0-бета01

13 октября 2021 г.

Выпущен androidx.wear.tiles:tiles-*:1.0.0-beta01 . Версия 1.0.0-beta01 содержит эти коммиты.

Исправления ошибок

• Исправлено исключение NullPointerException в TileUiClient , когда была предоставлена ​​пустая версия ресурса. ( I0586e )

Версия 1.0.0-альфа12

29 сентября 2021 г.

Выпущен androidx.wear.tiles:tiles-*:1.0.0-alpha12 . Версия 1.0.0-alpha12 содержит эти коммиты.

Исправления ошибок

• UpdateScheduler больше не использует слабую ссылку, исправляя проблемы, из-за которых TileUiClient не обновлялся ( I1120d , b/199061124 ).

• Объявите, что SysUiTileUpdateRequester запрашивает PacakgeManager, исправляя ошибку, из-за которой обновления плиток не работали на устройствах R+. ( I1120d )

Версия 1.0.0-альфа11

1 сентября 2021 г.

Выпущен androidx.wear.tiles:tiles-*:1.0.0-alpha11 . Версия 1.0.0-alpha11 содержит эти коммиты.

Новые возможности

• Добавлена ​​и выпущена библиотека тестирования androidx.wear.tiles:tiles-testing, позволяющая разработчикам легче тестировать свои плитки. ( Iedb6b )

Изменения API

• TileProviderService переименован в TileService. ( I1ad2c )
• Обновлены конструкторы тайлов; статические методы .builder() устарели в пользу вызова new Foo.Builder() , а перегрузки установщиков, которые принимали экземпляр Builder , были удалены. ( Ia9606 )
• TileRenderer теперь должен использовать контекст пользовательского интерфейса вместо контекста приложения. ( I84b61 )

Исправления ошибок

• Исправлена ​​ошибка, из-за которой в определенных ситуациях применялось несколько подчеркиваний. ( Ib6712 )

Версия 1.0.0-альфа10

18 августа 2021 г.

Выпущены androidx.wear.tiles:tiles:1.0.0-alpha10 , androidx.wear.tiles:tiles-proto:1.0.0-alpha10 и androidx.wear.tiles:tiles-renderer:1.0.0-alpha10 . Версия 1.0.0-alpha10 содержит эти коммиты.

Изменения API

• Удалены средства проверки макета из общедоступного API. Они всегда будут включены, но выдадут предупреждение только в случае неудачной проверки. ( Ie9f29 )
• TileRenderer теперь принимает контекст пользовательского интерфейса вместо контекста приложения.

Исправления ошибок

• Исправлена ​​ошибка, из-за которой невозможно было щелкнуть кликабельные элементы в Spannable.

Версия 1.0.0-альфа09

21 июля 2021 г.

Выпущены androidx.wear.tiles:tiles:1.0.0-alpha09 , androidx.wear.tiles:tiles-proto:1.0.0-alpha09 и androidx.wear.tiles:tiles-renderer:1.0.0-alpha09 . Версия 1.0.0-alpha09 содержит эти коммиты.

Новые возможности

• В рендерер Wear Tiles добавлены средства проверки макета. ( I3a869 )
  • Они используются для проверки лучших практик в вашей плитке. Во-первых, они выдадут предупреждение, если ваша плитка не содержит элементов с модификатором Semantics .
• Добавлена ​​документация для конструкторов DefaultTileProviderClient и TestingTileProviderClient constructors . ( I9f4b9 )

Изменения API

• Переименование в TileProviderClient ( I0ec36 ):
  • getApiVersion → requestApiVersion
  • tile/resourcesRequest -> requestTile/Resources
  • onTileFooEvent -> sendOnTileFooEvent
• В рендерер Wear Tiles добавлены средства проверки макета. ( I3a869 )

Исправления ошибок

• Убедитесь, что цель LaunchAction не имеет специальных разрешений. ( I39136 )

Версия 1.0.0-альфа08

30 июня 2021 г.

Выпущены androidx.wear.tiles:tiles:1.0.0-alpha08 , androidx.wear.tiles:tiles-proto:1.0.0-alpha08 и androidx.wear.tiles:tiles-renderer:1.0.0-alpha08 . Версия 1.0.0-alpha08 содержит эти коммиты.

Новые возможности

• Spannables теперь поддерживают line_height вместо line_spacing.

Изменения API

• Добавьте поддержку line_height в Spannables, удалите line_spacing. ( Ибеб54 )
  • Код, использующий line_spacing, должен быть перенесен на использование line_height.

Исправления ошибок

• Исправлена ​​ошибка при использовании пропорциональных размеров. ( I37ace )
• Исправлена ​​ошибка, из-за которой текстовые элементы не имели описания содержимого. ( Id2c7d )

Версия 1.0.0-альфа07

16 июня 2021 г.

Выпущены androidx.wear.tiles:tiles:1.0.0-alpha07 , androidx.wear.tiles:tiles-proto:1.0.0-alpha07 и androidx.wear.tiles:tiles-renderer:1.0.0-alpha07 . Версия 1.0.0-alpha07 содержит эти коммиты.

Изменения API

• Добавьте интерфейс TileProviderClient и откройте DefaultTileProviderClient , что позволит реализациям привязываться к интерфейсу TileProviderService . ( I69165 )

Версия 1.0.0-альфа06

2 июня 2021 г.

Выпущены androidx.wear.tiles:tiles:1.0.0-alpha06 , androidx.wear.tiles:tiles-proto:1.0.0-alpha06 и androidx.wear.tiles:tiles-renderer:1.0.0-alpha06 . Версия 1.0.0-alpha06 содержит эти коммиты.

Изменения API

• Все классы Builder теперь содержат методы получения для всех свойств. Обратите внимание, что они предназначены только для целей тестирования ( I9d155 ).
• Изменение пакета: классы из androidx.wear.tiles.builders были перенесены в androidx.wear.tiles .
• Добавьте экспериментальную поддержку оттенков в Tiles. ( I38929 )
• LayoutElementBuilders.HALIGN_* переименован в LayoutElementBuilders.HORIZONTAL_ALIGN_* ( I67e58 ).
• LayoutElementBuilders.VALIGN_* переименован в LayoutElementBuilders.VERTICAL_ALIGN_* ( I67e58 ).
• LayoutElementBuilders.SPAN_VALIGN_* переименован в LayoutElementBuilders.SPAN_VERTICAL_ALIGN_* ( I67e58 ).
• Добавлены классы построителей для запросов и событий. ( Ib5cf4 )
• TileProviderService перенесена для использования классов запросов и событий из RequestBuilders и EventBuilders вместо RequestReaders / EventReaders (например, onTileRequest теперь предоставляет вам RequestBuilders.TileRequest вместо RequestReaders.TileRequest ). ( I46ea1 )

Исправления ошибок

• Исправлена ​​ошибка асинхронной загрузки изображений для рендеринга Tiles. ( Iad9b0 )
• Исправлена ​​ошибка макета при размещении изображения с шириной или высотой, установленной для expand() в Box с шириной или высотой, установленной для wrap() . ( I33770 )

Версия 1.0.0-альфа05

18 мая 2021 г.

Выпущены androidx.wear.tiles:tiles:1.0.0-alpha05 , androidx.wear.tiles:tiles-proto:1.0.0-alpha05 и androidx.wear.tiles:tiles-renderer:1.0.0-alpha05 . Версия 1.0.0-alpha05 содержит эти коммиты.

Изменения API

• Удален getTileId из входящих событий плитки ( TileAddEvent , TileRemoveEvent , TileEnterEvent , TileLeaveEvent , TileRequest ). ( Иббба2 )
• ImageResource#setAndroidResourceByResid переименован в setAndroidResourceByResId ( I4ba6e ).
• TimelineManager#deInit переименован для закрытия и реализован AutoCloseable . ( I5dff2 )

Версия 1.0.0-альфа04

5 мая 2021 г.

Выпущены androidx.wear.tiles:tiles:1.0.0-alpha04 , androidx.wear.tiles:tiles-proto:1.0.0-alpha04 и androidx.wear.tiles:tiles-renderer:1.0.0-alpha04 . Версия 1.0.0-alpha04 содержит эти коммиты.

Изменения API

• Скрытые конкретные классы TileProviderService.
  • Заставил TileUpdateRequester принимать Class<? extends TileProviderService> . ( Ib7cca )
• Добавлена ​​возможность добавлять дополнения в AndroidActivity. ( I748f4 )

Плитки версии 1.0.0-alpha03

21 апреля 2021 г.

Выпущены androidx.wear.tiles:tiles:1.0.0-alpha03 , androidx.wear.tiles:tiles-proto:1.0.0-alpha03 и androidx.wear.tiles:tiles-renderer:1.0.0-alpha03 . Версия 1.0.0-alpha03 содержит эти коммиты.

Изменения API

• Переименуйте TileManager -> TileClient
  • Переименуйте TileManager#create -> TileClient#connect ( I91839 )

Исправления ошибок

• Добавлены правила Proguard, обеспечивающие правильную работу tiles и tiles-renderer при включенном Proguard ( Ie3d85 ).

Версия 1.0.0-альфа02

7 апреля 2021 г.

Выпущены androidx.wear.tiles:tiles:1.0.0-alpha02 , androidx.wear.tiles:tiles-proto:1.0.0-alpha02 и androidx.wear.tiles:tiles-renderer:1.0.0-alpha02 . Версия 1.0.0-alpha02 содержит эти коммиты.

Изменения API

• androidx.wear:wear-tiles переместил группы и теперь должен называться androidx.wear.tiles:tiles
• androidx.wear:wear-tiles-renderer переместил группы и теперь должен называться androidx.wear.tiles:tiles-renderer
• TileRenderer.LoadActionListener теперь использует экземпляр androidx.wear.tiles.builders.StateBuilders.State , а не androidx.wear.tiles.proto.StateProto.State .
• TileRenderer теперь принимает ресурсы Tile из androidx.wear.tiles.builders.ResourceBuilders.Resources , а не из экземпляра androidx.wear.tiles.renderer.ResourceAccessors .

Исправления ошибок

• Исправлена ​​невозможность использовать LoadActionListener , поскольку он предоставлял внутренний класс.

Версия 1.0.0-альфа01

10 марта 2021 г.

Выпущены androidx.wear:wear-tiles:1.0.0-alpha01 , androidx.wear:wear-tiles-proto:1.0.0-alpha01 и androidx.wear:wear-tiles-renderer:1.0.0-alpha01 . Версия 1.0.0-alpha01 содержит эти коммиты.

Новые возможности

• Библиотека Wear Tiles Renderer предоставляет функциональные возможности для создания пользовательских плиток для устройств Wear OS, а также классы, которые позволяют системе получать плитку и отображать ее рядом с циферблатом.

Примечание. Хотя вы можете создавать и тестировать плитки с помощью альфа-версии этой библиотеки, в настоящее время эти плитки не отображаются для пользователей Wear OS.