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

Создавайте приложения для умных часов Wear OS by Google.
Последнее обновление Стабильный выпуск Кандидат на выпуск Бета-версия Альфа-релиз
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 теперь использует 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-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 ):
    • getApiVersionrequestApiVersion
    • 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, а также классы, которые позволяют системе получать плитку и отображать ее рядом с циферблатом.