Носить плитку
Последнее обновление | Стабильный выпуск | Кандидат на выпуск | Бета-версия | Альфа-релиз |
---|---|---|---|---|
16 октября 2024 г. | 1.4.1 | - | - | 1.5.0-альфа02 |
Объявление зависимостей
Чтобы добавить зависимость от Wear, вам необходимо добавить в свой проект репозиторий Google Maven. Для получения дополнительной информации прочтите репозиторий Google Maven .
Добавьте зависимости для нужных вам артефактов в файл build.gradle
для вашего приложения или модуля:
классный
dependencies { // Use to implement support for wear tiles implementation "androidx.wear.tiles:tiles:1.5.0-alpha02" // Use to utilize standard components and layouts in your tiles implementation "androidx.wear.protolayout:protolayout:1.3.0-alpha02" // Use to utilize components and layouts with Material Design in your tiles implementation "androidx.wear.protolayout:protolayout-material:1.3.0-alpha02" // Use to include dynamic expressions in your tiles implementation "androidx.wear.protolayout:protolayout-expression:1.3.0-alpha02" // Use to preview wear tiles in your own app debugImplementation "androidx.wear.tiles:tiles-renderer:1.5.0-alpha02" // Use to fetch tiles from a tile provider in your tests testImplementation "androidx.wear.tiles:tiles-testing:1.5.0-alpha02" }
Котлин
dependencies { // Use to implement support for wear tiles implementation("androidx.wear.tiles:tiles:1.5.0-alpha02") // Use to utilize standard components and layouts in your tiles implementation("androidx.wear.protolayout:protolayout:1.3.0-alpha02") // Use to utilize components and layouts with Material Design in your tiles implementation("androidx.wear.protolayout:protolayout-material:1.3.0-alpha02") // Use to include dynamic expressions in your tiles implementation("androidx.wear.protolayout:protolayout-expression:1.3.0-alpha02") // Use to preview wear tiles in your own app debugImplementation("androidx.wear.tiles:tiles-renderer:1.5.0-alpha02") // Use to fetch tiles from a tile provider in your tests testImplementation("androidx.wear.tiles:tiles-testing:1.5.0-alpha02") }
классный
dependencies { // Use to implement support for wear tiles implementation "androidx.wear.tiles:tiles:1.5.0-alpha02" // Use to utilize standard components and layouts in your tiles implementation "androidx.wear.protolayout:protolayout:1.3.0-alpha02" // Use to utilize components and layouts with Material Design in your tiles implementation "androidx.wear.protolayout:protolayout-material:1.3.0-alpha02" // Use to include dynamic expressions in your tiles implementation "androidx.wear.protolayout:protolayout-expression:1.3.0-alpha02" // Use to preview wear tiles in your own app debugImplementation "androidx.wear.tiles:tiles-renderer:1.5.0-alpha02" // Use to fetch tiles from a tile provider in your tests testImplementation "androidx.wear.tiles:tiles-testing:1.5.0-alpha02" }
Котлин
dependencies { // Use to implement support for wear tiles implementation("androidx.wear.tiles:tiles:1.5.0-alpha02") // Use to utilize standard components and layouts in your tiles implementation("androidx.wear.protolayout:protolayout:1.3.0-alpha02") // Use to utilize components and layouts with Material Design in your tiles implementation("androidx.wear.protolayout:protolayout-material:1.3.0-alpha02") // Use to include dynamic expressions in your tiles implementation("androidx.wear.protolayout:protolayout-expression:1.3.0-alpha02") // Use to preview wear tiles in your own app debugImplementation("androidx.wear.tiles:tiles-renderer:1.5.0-alpha02") // Use to fetch tiles from a tile provider in your tests testImplementation("androidx.wear.tiles:tiles-testing:1.5.0-alpha02") }
Дополнительные сведения о зависимостях см. в разделе Добавление зависимостей сборки .
Обратная связь
Ваши отзывы помогают сделать Jetpack лучше. Дайте нам знать, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете добавить свой голос к существующей проблеме, нажав кнопку со звездочкой.
Дополнительную информацию см . в документации по системе отслеживания проблем .
Версия 1.5
Версия 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
теперь использует APIWearSdk
(если доступен) для обеспечения более точного результата. ( 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
.
- Они используются для проверки лучших практик в вашей плитке. Во-первых, они выдадут предупреждение, если ваша плитка не содержит элементов с модификатором
- Добавлена документация для
TestingTileProviderClient constructors
DefaultTileProviderClient
и TestingTileProviderClient. ( 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 )
- Заставил TileUpdateRequester принимать
- Добавлена возможность добавлять дополнения в 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, а также классы, которые позволяют системе получать плитку и отображать ее рядом с циферблатом.