макетирование одежды

Эта библиотека позволяет определять набор макетов пользовательского интерфейса и выражений, не относящихся к пользовательскому интерфейсу, которые будут отображаться/выполняться на удаленных поверхностях.
Последнее обновление Стабильный релиз Предварительная версия для выпуска Бета-версия Альфа-версия
17 декабря 2025 г. 1.3.0 - - 1.4.0-alpha03

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

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

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

классный 

dependencies {
    // Use to implement support for Wear ProtoLayout Expressions
    implementation "androidx.wear.protolayout:protolayout-expression:1.3.0"

    // Use to implement support for Wear ProtoLayout
    implementation "androidx.wear.protolayout:protolayout:1.3.0"

    // Use to utilize components and layouts with Material design in your ProtoLayout
    implementation "androidx.wear.protolayout:protolayout-material:1.3.0"
}

Котлин 

dependencies {
    // Use to implement support for Wear ProtoLayout Expressions
    implementation("androidx.wear.protolayout:protolayout-expression:1.3.0")

    // Use to implement support for Wear ProtoLayout
    implementation("androidx.wear.protolayout:protolayout:1.3.0")

    // Use to utilize components and layouts with Material design in your ProtoLayout
    implementation("androidx.wear.protolayout:protolayout-material:1.3.0")
}
,

классный 

dependencies {
    // Use to implement support for Wear ProtoLayout Expressions
    implementation "androidx.wear.protolayout:protolayout-expression:1.3.0"

    // Use to implement support for Wear ProtoLayout
    implementation "androidx.wear.protolayout:protolayout:1.3.0"

    // Use to utilize components and layouts with Material design in your ProtoLayout
    implementation "androidx.wear.protolayout:protolayout-material:1.3.0"
}

Котлин 

dependencies {
    // Use to implement support for Wear ProtoLayout Expressions
    implementation("androidx.wear.protolayout:protolayout-expression:1.3.0")

    // Use to implement support for Wear ProtoLayout
    implementation("androidx.wear.protolayout:protolayout:1.3.0")

    // Use to utilize components and layouts with Material design in your ProtoLayout
    implementation("androidx.wear.protolayout:protolayout-material:1.3.0")
}

Для получения дополнительной информации о зависимостях см. раздел «Добавление зависимостей сборки» .

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

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

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

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

Версия 1.4

Версия 1.4.0-alpha03

17 декабря 2025 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.4.0-alpha03 . Версия 1.4.0-alpha03 содержит следующие коммиты .

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

  • Сравнение двух типов ресурсов для улучшения обработки ресурсов и повышения производительности теперь осуществляется с использованием оптимизированных методов хеширования и равенства. ( 82f21b2f )

Версия 1.4.0-alpha02

22 октября 2025 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.4.0-alpha02 . Версия 1.4.0-alpha02 содержит следующие коммиты .

Новые функции

  • Добавлен новый источник событий платформы ( isInAmbientMode ), описывающий, находится ли устройство в режиме ожидания или нет ( Ief832 ).

Изменения в API

  • Теперь clickable элемент PendingIntent принимает резервное действие ( LoadAction / LaunchAction ), которое будет использоваться, если PendingIntent не поддерживается рендерером ProtoLayout . Резервное действие будет автоматически выбрано и размещено в макете, если версия рендерера ниже той, которая поддерживает PendingIntent . ( I6eee2 , b/450259727 )
  • Поле protoLayoutScope в MaterialScope теперь имеет значение NonNull для упрощения использования при создании MaterialScope с помощью materialScopeWithResources . Кроме того, появилась функция hasProtoLayoutScope для проверки наличия этого поля. ( I1858f , b/450067019 )

Версия 1.4.0-alpha01

24 сентября 2025 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.4.0-alpha01 . Версия 1.4.0-alpha01 содержит следующие коммиты .

Новые функции

  • Добавлен вспомогательный метод для LayoutModifier , который позволяет элементу плавно появляться по мере того, как плитка становится видимой. ( I38531 , b/390345969 )
  • Добавлен materialScopeWithResources для поддержки концепции MaterialScope в M3, который также обеспечивает автоматическую регистрацию ресурсов. В его состав добавлены новые вспомогательные методы для изображений ( backgroundImage avatarImage и icon), которые устраняют необходимость ручной регистрации ресурсов в onTileResourceRequest при их использовании. ( I525bd , b/428692714 )
  • Вспомогательные функции Kotlin для ProtoLayout , предназначенные для работы Image и ImageResources , с использованием ProtoLayoutScope и автоматической регистрации ресурсов. ( Iada82 , b/430584304 )
  • Добавлен геттер для определения количества свойств Лотти, разрешенных для настройки одной анимации Лотти. ( I73733 , b/436532706 )
  • Добавить API в AndroidLottieResourceByResId , позволяющий настраивать анимацию Lottie через свойства, а также API для создания свойства для оформления слота с указанием его ID и цвета. ( I301b3 , b/423581481 )
  • Добавить API поставщика для приема PendingIntent в качестве действия клика ( I01978 , b/433802488 )
  • В Image.Builder добавлен новый API — setImageResource , позволяющий напрямую устанавливать объект ресурса в качестве изображения в onTileRequest , без необходимости регистрировать его в сопоставлении в onTileResourcesRequest . ( Ifa69a , b/428693523 )
  • Добавлена ​​концепция ProtoLayoutScope в рамках подготовки к улучшенной обработке ресурсов в Tiles. ( I132ce , b/428692423 )
  • ProtoLayout Material3 MaterialScope поле Context теперь доступно как public и может использоваться в методах внутри этой области видимости без необходимости его передачи. ( I0e5cc , b/414559956 )
  • Сделать API семантики заголовков общедоступными ( I75299 , b/413653475 )
  • Предоставить доступ к константам ARC_DIRECTION_* в качестве общедоступных для использования в Arc/ArcLine/ArcText/DashedArcLine . ( I83959 , b/427556439 )

Изменения в API

  • Мы объявили устаревшими методы Image.Builder() и Image.Builder.setResourceId в пользу нового API автоматической регистрации ресурсов, доступного в Image.Builder(ProtoLayoutScope) и Image.Builder.setImageResource , который устраняет необходимость переопределения метода onTileResourcesRequest . ( I7bfe6 , b/432758526 )
  • Переместите API для создания ProtoLayoutScope из категории ограниченного доступа в категорию публичного доступа. Однако их не следует использовать, поскольку система уже обрабатывает эти вызовы. ( I1d8e8 , b/432758251 )

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

  • Добавить реализацию для поддержки PendingIntent в ProtoTiles ( I38167 , b/430610429 )
  • Добавить метод invalidateLayout . ( Ief898 )
  • Перенос минимального SDK по умолчанию с API 21 на API 23 ( Ibdfca , b/380448311 , b/435705964 , b/435705223 )
  • ImageResource теперь есть методы hashCode и equals . ( I650ee , b/428692423 , b/428693523 )
  • Добавить новое протокольное сообщение PendingIntentAction и его построитель-обертку ( Ie2aca , b/427643502 )
  • Уменьшить частоту создания экземпляров ZoneId . ( I284d3 )
  • Применить описание содержимого по умолчанию к textButton с одним слотом. ( I0dc8a , b/415001534 )
  • Исправлены вычисления для корректировки максимального количества строк на стороне рендерера. ( I933bc , b/414353620 )

Версия 1.3

Версия 1.3.0

4 июня 2025 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.3.0 . Версия 1.3.0 содержит следующие коммиты .

Важные изменения по сравнению с версией 1.2.0

  • В дизайне часов используется технология Material 3: компоненты и компоновка оптимизированы для круглого дисплея и масштабируются под разные размеры экрана, от маленьких до больших.
    • Это включает в себя библиотеку protolayout-material3 , написанную исключительно на Kotlin, с более похожими на Compose API для следующих компонентов и функций:
    • Динамическая цветовая тема, заимствованная из системы и циферблата часов, с использованием новейшей темы Material3 для цветов, форм и типографики.
    • MaterialScope для учета всех заданных по умолчанию параметров и упрощения настройки.
    • iconEdgeButton , textEdgeButton
    • iconButton , textButton , button , imageButton , avatarButton , compactButton
    • titleCard , appCard , graphicDataCard , iconDataCard , textDataCard
    • circularProgressIndicator , segmentedCircularProgressIndicator
    • primaryLayout , buttonGroup
    • Все компоненты работают с любыми версиями SDK и ProtoLayout Renderer, обеспечивая разумные резервные варианты там, где это применимо.
  • Более удобные для Kotlin API, похожие на Compose, для базовых элементов ProtoLayout.
    • LayoutModifier позволяет добавлять большинство модификаторов в виде цепочек функций ( padding , contentDescription (включая clearSemantics ), background , clip , opacity и т. д.), и может быть преобразован в существующий объект Modifiers
    • LayoutColors и LayoutString — типы данных с упрощенной поддержкой использования динамических полей и ограничений.
    • text и fontStyle
    • Улучшена поддержка карт для StateBuilder , включая DynamicDataMap и фабричные методы, такие как intAppDataKey для упрощения создания объектов AppDataKey
  • Анимации Lottie поддерживают возможность установки различных триггеров для запуска анимации, например, при загрузке макета или при отображении макета.
    • Улучшена поддержка градиентов:
    • API для линейных градиентов, входящий в состав Brush , может использоваться в модификаторах Background для таких элементов, как Box , Spacer и т. д.
    • Разрешить динамические значения цвета в ColorStop , используемом для линейных и градиентных переходов.
    • Существующий градиент заметания в дуговых объектах теперь поддерживает динамические цвета, а также начальные и конечные углы.
  • Привязка данных платформы в protolayout-expression позволяет получать информацию всякий раз, когда изменяется видимость макета, что, например, может использоваться для скрытия определенных частей макета во время пролистывания плитки.
  • В библиотеку тестирования protolayout-testing добавлена ​​поддержка упрощенного модульного тестирования любых элементов ProtoLayout.
  • Новый элемент DashedArcLine с улучшенным набором функций, позволяющий использовать пунктирные линии, в отличие от существующего ArcLine
  • ArcSpacer поддерживает задание длины в единицах измерения DP вместо градусов.
  • Добавлена ​​ось закругления FontSetting применимая к некоторым шрифтам.

Версия 1.3.0-rc01

20 мая 2025 г.

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

Версия 1.3.0-beta02

7 мая 2025 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.3.0-beta02 . Версия 1.3.0-beta02 содержит следующие коммиты .

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

  • Мы внесли важное улучшение в параметры типографического оформления, применяемые в API 36 и выше. Это связано с тем, что начиная с API 36 все тайлы будут отображаться системным шрифтом, поэтому это изменение обеспечивает лучшую согласованность в карусели тайлов. ( If316f )
  • Конструкторы Text , Spacer , ArcLine и DashedArcLine не будут выдавать ошибку, если для динамических значений не заданы layoutConstraints . Обратите внимание, что более старые рендереры по-прежнему требуют установки layoutConstraints и будут игнорировать любые динамические значения, у которых они не заданы. ( Ic52e8 )
  • Добавьте модификатор семантики заголовка, чтобы указать, что элемент макета является заголовком раздела контента в целях доступности, и по умолчанию отметьте текст в слоте заголовка элемента primaryLayout как заголовок, предназначенный для людей с ограниченными возможностями. ( Iae1fb )
  • Финальная доработка пользовательского интерфейса primaryLayout , где расстояние между слотом заголовка и основным слотом уменьшено до 4dp вместо 6dp на экранах меньшего размера. ( I0e056 )
  • Применить описание содержимого по умолчанию к textEdgeButton . ( Ifaf8b )
  • Небольшое обновление внутреннего отступа avatarButton . ( I0910b )

Версия 1.3.0-beta01

9 апреля 2025 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.3.0-beta01 . Версия 1.3.0-beta01 содержит следующие коммиты .

Новые функции

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

  • В дизайне часов используется технология Material 3: компоненты и компоновка оптимизированы для круглого дисплея и масштабируются под разные размеры экрана, от маленьких до больших.
    • Это включает в себя библиотеку protolayout-material3 , написанную исключительно на Kotlin, с более похожими на Compose API для следующих компонентов и функций:
    • Динамическая цветовая тема, заимствованная из системы и циферблата часов, с использованием новейшей темы Material3 для цветов, форм и типографики.
    • MaterialScope для учета всех заданных по умолчанию параметров и упрощения настройки.
    • iconEdgeButton , textEdgeButton
    • iconButton , textButton , button , imageButton , avatarButton , compactButton
    • titleCard , appCard , graphicDataCard , iconDataCard , textDataCard
    • circularProgressIndicator , segmentedCircularProgressIndicator
    • primaryLayout , buttonGroup
    • Все компоненты работают с любыми версиями SDK и ProtoLayout Renderer, обеспечивая разумные резервные варианты там, где это применимо.
  • Более удобные для Kotlin API, похожие на Compose, для базовых элементов ProtoLayout.
    • LayoutModifier позволяет добавлять большинство модификаторов в виде цепочек функций ( padding , contentDescription (включая clearSemantics ), background , clip , opacity и т. д.), и может быть преобразован в существующий объект Modifiers
    • LayoutColors и LayoutString — типы данных с упрощенной поддержкой использования динамических полей и ограничений.
    • text и fontStyle
    • Улучшена поддержка карт для StateBuilder , включая DynamicDataMap и фабричные методы, такие как intAppDataKey для упрощения создания объектов AppDataKey
  • Анимации Lottie поддерживают возможность установки различных триггеров для запуска анимации, например, при загрузке макета или при отображении макета.
    • Улучшена поддержка градиентов:
    • API для линейных градиентов, входящий в состав Brush , может использоваться в модификаторах Background для таких элементов, как Box , Spacer и т. д.
    • Разрешить динамические значения цвета в ColorStop , используемом для линейных и градиентных переходов.
    • Существующий градиент заметания в дуговых объектах теперь поддерживает динамические цвета, а также начальные и конечные углы.
  • Привязка данных платформы в protolayout-expression позволяет получать информацию всякий раз, когда изменяется видимость макета, что, например, может использоваться для скрытия определенных частей макета во время пролистывания плитки.
  • В библиотеку тестирования protolayout-testing добавлена ​​поддержка упрощенного модульного тестирования любых элементов ProtoLayout.
  • Новый элемент DashedArcLine с улучшенным набором функций, позволяющий использовать пунктирные линии, в отличие от существующего ArcLine
  • ArcSpacer поддерживает задание длины в единицах измерения DP вместо градусов.
  • Добавлена ​​ось закругления FontSetting применимая к некоторым шрифтам.

Версия 1.3.0-alpha10

12 марта 2025 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.3.0-alpha10 . Версия 1.3.0-alpha10 содержит следующие коммиты .

Новые функции

  • Добавить вспомогательную функцию для Brush в модификаторе фона Kotlin. ( I995de )
  • В MaterialScope стало доступно обязательное поле Android Context, что упрощает его использование разработчиками в функциях, создающих компоненты для плиток Material3. ( I7df73 )

Изменения в API

  • Переименуйте API platformVisibilityStatus в PlatformEventSources.isLayoutVisible и добавьте новый экспериментальный API PlatformEventSources.isLayoutUpdatePending . ( IE1E04 )

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

  • Теперь поля для primaryLayout округляются в большую сторону, что в некоторых случаях может привести к уменьшению пространства в основном слоте до 2 dp. ( I8f5d3 )
  • Уточнение стандартной динамической цветовой темы в компонентах Material3 ProtoLayout . ( Iff5f3 )
  • Типографика Typography.NUMERAL_* по умолчанию больше не является табличной/моноширинной. Если текст анимируется, настоятельно рекомендуется добавить параметр FontSetting.tabularNum() . Во всех остальных случаях этот параметр моноширинного формата не требуется, и без него будет доступно больше символов. ( Id3cd9 )
  • Уточнение стандартной динамической цветовой темы в компонентах Material3 ProtoLayout . ( I9d831 )

Версия 1.3.0-alpha09

26 февраля 2025 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.3.0-alpha09 . Версия 1.3.0-alpha09 содержит следующие коммиты .

Новые функции

  • Добавлены экспериментальные модификаторы для enterTransition и exitTransition ( I4a4d6 )
  • Мы добавили дополнительную привязку платформы для получения статуса видимости всего макета при его изменении. ( I250c3 )
  • Разрешить внедрение данных о состоянии тестового приложения и платформе в LayoutElementAssertionsProvider для оценки динамических значений. ( Ib5fcb )
  • Добавить фильтры углов в библиотеку тестирования макета ( IE2361 )
  • ButtonColors , CardColors и ProgressIndicatorColors теперь поддерживают метод copy с возможностью переопределения некоторых параметров. ( IE2054 )

Изменения в API

  • Добавить поддержку динамической привязки данных в библиотеку тестирования ( Ib98de )
  • Исправлена ​​ошибка использования imageButton с функцией backgroundImage путем удаления эффекта наложения. Кроме того, добавлена ​​возможность указания значения null для цвета backgroundImage , что означает, что наложение не будет применено. ( Ibec3c )

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

  • Изменен метод hasValueOfType по умолчанию: теперь вместо IllegalArgumentException он выбрасывает исключение UnsupportedOperationException . ( Ia36c3 )
  • Значения цветовых токенов по умолчанию обновлены в соответствии с последней спецификацией ( I75d44 ).
  • Исправлена ​​ошибка сглаживания, видимая на дуговых линиях в рендерере AndroidX tiles. ( I88190 )

Версия 1.3.0-alpha08

12 февраля 2025 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.3.0-alpha08 . Версия 1.3.0-alpha08 содержит следующие коммиты .

Новые функции

  • Добавить параметр списка FontSetting для текста Material3. ( Ic102d )
  • Добавлен класс DynamicDataMap , который теперь поддерживается StateBuilder , для более типобезопасного API Kotlin для состояний приложения ( I012ba ).
  • Добавлены фабричные методы, такие как intAppDataKey для упрощения создания объектов AppDataKey ( Icea2a ).
  • В дополнение к методам hasInt/hasColor/ ..., DynamicDataValue теперь имеет метод hasValueOfType(Class<?>) ( I4f7a6 ).
  • Мы добавили errorDim в ColorScheme Material3 ProtoLayout для обработки ошибок высокого приоритета или экстренных действий, таких как оповещения о безопасности. ( Ia17bb )
  • Мы добавили защиту от сбоя при доступе к глобальной настройке reducemotion, которая срабатывала на некоторых платформах, где эта настройка не была предоставлена. ( I01e2c )

Изменения в API

  • addKeyToValueMapping переименован в addToStateMap , а методы DynamicDataMap.put удалены, поскольку они были избыточными. ( Ibe9dd )
  • В Material3 Typography теперь поддерживается переменная ось округлости для системных шрифтов, поддерживающих эту ось. В ProtoLayout FontSetting также поддерживается ось округлости для шрифтов, поддерживающих эту ось. ( I33eb5 )
  • Переименовано multilineAlignment в alignment в текстовом методе Material3. ( I2b66b )
  • Обновите круговой индикатор выполнения, присвоив ему тип «Box», а также укажите тип mainContent в constructGraphic как Box ( I5a3dc ).
  • Улучшена поддержка использования циклического индикатора прогресса на графике ( I039db )

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

  • Разрешить динамические значения в ColorStop , а также для начального/конечного углов в SweepGradient . ( I0146d )
  • Исправлены ошибки в документации. ( I4a63a )
  • Обновлены компоненты Material 3 ( graphicCard и avatarButton ) для обеспечения резервного варианта, когда расширение размеров weight не поддерживается (например, ниже API 33). Обновлен компонент текста для резервного использования TEXT_OVERFLOW_ELLIPSIZE_END когда TEXT_OVERFLOW_ELLIPSIZE не поддерживается рендерером. ( I19e2c )
  • Обновление документации для PrimaryLayoutMargins ( Ibaf7b ).

Версия 1.3.0-alpha07

29 января 2025 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.3.0-alpha07 . Версия 1.3.0-alpha07 содержит следующие коммиты .

Новые функции

  • Добавлена ​​опция API для установки различных триггеров для анимаций Лотти. Кроме того, добавлен API для триггеров, срабатывающих, когда макет виден ( I8272d ).
  • Добавлены модификаторы border , visibility и opacity . ( I6d3dd )
  • Добавлена ​​кнопка аватара в компонент ProtoLayout Material3. ( Idb5ae )
  • Теперь мы позволяем настраивать отступы (боковые, а в некоторых случаях и нижние) в Material3 primaryLayout . ( Ib22f6 )
  • Добавьте сегментированный вариант кругового индикатора выполнения. ( I6a648 )
  • Добавлен компактный компонент кнопки в ProtoLayout Material3. ( Ia3c5c )
  • Добавлены компоненты кнопки в форме таблетки и кнопки с изображением в ProtoLayout Material3. ( Ifb88a )

Изменения в API

  • Теперь LayoutModfier.foldIn называется foldRight , чтобы лучше отразить ожидаемое поведение ( Idf242 ).
  • Триггер VisibleOnce теперь находится в экспериментальной стадии. ( Ib2d26 )
  • Удалите withOpacity из публичного API, так как существует альтернатива в виде графической библиотеки. ( I030c2 )
  • Переименованы методы верхнего уровня в LayoutString.kt и LayoutColor.kt , теперь им присвоены имена, понятные для Java. ( I7aff0 )
  • Удалены типографические элементы, не относящиеся к ProtoLayout, в Material3. ( Idd9ae )
  • Добавьте суффикс Color к полям в классах *Colors в Material3. ( I2d114 )

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

  • Добавлена ​​реализация резервного варианта EdgeButton для старых рендереров без поддержки асимметричных углов. ( I63364 )
  • Добавлена ​​резервная реализация циклического индикатора выполнения с использованием более старого рендерера. ( I0f134 )

Версия 1.3.0-alpha06

15 января 2025 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.3.0-alpha06 . Версия 1.3.0-alpha06 содержит следующие коммиты .

Новые функции

  • LayoutColor поддерживает как статические, так и динамические типы цветов ( I4c89b )
  • Добавлен компонент текстовой кнопки ProtoLayout Material3 ( ID680d ).
  • Добавьте компонент ProtoLayout Material3 iconButton ( ICA3F0 ).
  • Добавлен компонент контейнера кнопки Material3 из ProtoLayout. ( I17a38 )
  • Добавлена ​​поддержка семантических модификаторов Chainable для protolayout-material3 ( I4af62 ).
  • Добавлен односегментный CircularProgressIndicator ProtoLayout Material3 ( I2c8a2 ).
  • Добавлены padding и модификаторы metadata ( I8720a )
  • Добавлены background , clip и clickable модификаторы ( I35478 )
  • Добавьте LinearGradient к кисти и разрешите его использование в модификаторе фона. ( Ic4dea )
  • Добавить небольшой размер для appCard и titleCard . ( I91f98 )
  • Добавлен компонент ProtoLayout Material3 graphicDataCard . ( I92be7 )
  • Добавлены компоненты ProtoLayout Material3 iconDataCard и textDataCard . ( I4e1e4 )
  • Добавлен компонент ProtoLayout Material3 appCard . ( Id4c57 )
  • Абстрактное EdgeButtonColors в ButtonColors . ( I83624 )
  • Добавлен компонент titleCard ProtoLayout Material3 ( I2dc72 ).

Изменения в API

  • API ProtoLayout Material3 теперь принимает LayoutString для поддержки как статического, так и динамического текста. ( I9c24a )

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

  • Добавить реализацию рендерера для создания объекта DashedArcLine ( I0c700 )
  • Изменение в механизме рендеринга, позволяющее ArcSpacer учитывать длину dp. ( I1437b )

Версия 1.3.0-alpha05

11 декабря 2024 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.3.0-alpha05 . Версия 1.3.0-alpha05 содержит следующие коммиты .

Новые функции

  • Добавлена ​​поддержка строковых полей макета, допускающих LayoutString . ( Ida650 )
  • Добавлен компонент контейнера карточки из ProtoLayout Material3 . ( IC985A )

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

  • В этой библиотеке теперь используются аннотации JSpecify, определяющие наличие нулевого значения , которые относятся к использованию типов. Разработчикам Kotlin следует использовать следующий аргумент компилятора для обеспечения корректного использования: -Xjspecify-annotations=strict (это значение по умолчанию, начиная с версии 2.1.0 компилятора Kotlin). ( Id1f9b , b/326456246 )

Версия 1.3.0-alpha04

13 ноября 2024 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.3.0-alpha04 . Версия 1.3.0-alpha04 содержит следующие коммиты .

Новые функции

  • Обновлена ​​форма Material3: теперь это класс с полями, хранящими фактическое значение угла, как в Wear Compose. ( Ied8cd )
  • Обновлены цвета Material3 с учетом концепции ColorScheme , аналогичной той, что используется в Wear Compose. ( If645e )
  • Добавьте в библиотеку тестирования несколько часто используемых сопоставителей. ( IE5CEC )

Версия 1.3.0-alpha03

30 октября 2024 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.3.0-alpha03 . Версия 1.3.0-alpha03 содержит следующие коммиты .

Новые функции

  • Добавьте LayoutElementAssertionsProvider , LayoutElementAssertion и LayoutElementMatcher в библиотеку тестирования ( Id1110 ).

Версия 1.3.0-alpha02

16 октября 2024 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.3.0-alpha02 . Версия 1.3.0-alpha02 содержит следующие коммиты .

Новые функции

  • Начальная версия библиотеки Material 3. Включает компоненты text , edgeButton , buttonGroup и primaryLayout .

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

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

Внешний вклад

Версия 1.3.0-alpha01

2 октября 2024 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.3.0-alpha01 . Версия 1.3.0-alpha01 содержит следующие коммиты .

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

  • Уточнено, что доступность названий семейств шрифтов Roboto и Roboto Flex зависит от устройства. ( I193be )
  • В AndroidX Tile renderer включено семейство шрифтов Roboto Flex. ( I08e94 )

Версия 1.2

Версия 1.2.1

16 октября 2024 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.2.1 . Версия 1.2.1 содержит следующие коммиты .

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

  • В результате этого изменения androidx компилируется с использованием protobuf 4.28.2 для устранения уязвимости CVE-2024-7254 . Обновите зависимость от версии 1.2.0 пакетов androidx.wear.protolayout:protolayout-proto и androidx.wear.protolayout:protolayout-external-protobuf до версии 1.2.1, чтобы устранить риск уязвимости.

Версия 1.2.0

7 августа 2024 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.2.0 . Версия 1.2.0 содержит следующие коммиты .

Важные изменения по сравнению с версией 1.1.0

  • FontStyle внесены изменения, обеспечивающие дополнительную поддержку шрифтов для переменных осей, а также улучшен API выбора шрифтов для поддержки будущих шрифтов Flex.
  • Дополнительная поддержка модификаторов:
    • Модификатор трансформации, позволяющий перемещать, вращать и масштабировать объекты с анимацией или без нее.
    • Задание различных значений (по горизонтали и вертикали) для каждого радиуса скругления углов.
  • Улучшена доступность всех сенсорных элементов за счет расширения области касания любого элемента, использующего модификатор Clickable, до размеров не менее 48dp на 48dp .
  • Улучшены свойства PrimaryLayout и EdgeContentLayout за счет добавления setResponsiveContentInsetEnabled , что обеспечивает лучшую поддержку адаптивного поведения этих макетов на экранах разных размеров и повышает согласованность работы с Tiles.
  • Улучшено масштабирование/отсутствие масштабирования Material Text для нелинейного масштабирования шрифтов в Android 14.
  • Улучшена поддержка направления RTL-разметки для всех дуговых элементов.

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

Версия 1.2.0-rc01

24 июля 2024 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.2.0-rc01 . Версия 1.2.0-rc01 содержит следующие коммиты .

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

  • Мы исправили стандартный Material Chip таким образом, что его можно использовать в качестве значка только в том случае, если не переданы ни основная, ни дополнительная метка. ( Iceef9 )
  • Документация по макетам Material Design обновлена ​​и теперь включает визуальные элементы с соответствующей страницы для более удобного понимания макетов. ( I0256a )

Версия 1.2.0-beta01

10 июля 2024 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.2.0-beta01 . Версия 1.2.0-beta01 содержит следующие коммиты .

Новые функции

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

  • FontStyle добавлена ​​поддержка дополнительных шрифтов:
    • Настройка различных параметров шрифта, таких как FontSetting.weight и FontSetting.width
    • Установка одинаковой ширины для всех цифровых символов — табличных цифр (настройка шрифта FontSetting.tnum )
    • Улучшены API выбора шрифтов для поддержки будущих гибких шрифтов путем указания предпочтительных названий семейств шрифтов для использования.
  • Модификатор Extended Corner позволяет задавать для каждого CornerRadius отдельные горизонтальные и вертикальные значения, что дает возможность создавать элементы с асимметричными углами.
  • Добавлен новый модификатор Transformation , позволяющий изменять положение, вращение и масштабирование элемента LayoutElement . Эти преобразования можно анимировать с помощью динамических значений.
  • Добавлена setArcDirection с параметрами Clockwise , CounterClockwise и Normal для всех элементов дуги ( Arc , ArcLine и ArcText ) для лучшей поддержки различных направлений компоновки (например, LTR и RTL).
  • Улучшена доступность всех сенсорных элементов за счет расширения области касания любого элемента, использующего модификатор Clickable до размеров не менее 48dp на 48dp .
  • Улучшены PrimaryLayout и EdgeContentLayout за счет добавления setResponsiveContentInsetEnabled для лучшей поддержки адаптивного поведения этих макетов на экранах разных размеров и повышения согласованности Tiles. Добавлено предупреждение линтера, предлагающее использовать эти API с быстрым исправлением.
  • Улучшено масштабирование/отсутствие масштабирования Material Text для нелинейного масштабирования шрифтов в Android 14.

Изменения в API

  • Имя семейства шрифтов по умолчанию ( DEFAULT_SYSTEM_FONT ) удалено, поскольку оно подразумевается при неиспользовании API preferredFontFamilies . ( I39dab )
  • Параметр, передаваемый в FontSetting.width , должен быть положительным. ( I1266f )

Версия 1.2.0-alpha05

26 июня 2024 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.2.0-alpha05 . Версия 1.2.0-alpha05 содержит следующие коммиты .

Новые функции

  • Добавьте метод hasText к Material.CompactChip для проверки того, было ли установлено текстовое содержимое. ( I6e8fc )

Изменения в API

  • Константы FontFamily перемещены в FontStyle , а не в класс Builder. ( I06ced )
  • Обновите API FontSetting.weight и FontSetting.width , добавив аннотации Range, и измените параметр weight на целочисленный ( Ia726c ).

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

  • Тексты, не масштабируемые в библиотеке Material, теперь корректно работают с нелинейным масштабированием шрифтов в Android 14. ( I6601e )

Версия 1.2.0-alpha04

29 мая 2024 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.2.0-alpha04 . Версия 1.2.0-alpha04 содержит следующие коммиты .

Изменения в API

  • Добавлен API для асимметричных углов, позволяющий указывать радиус каждого угла отдельно с помощью двух значений. ( Icbd69 )
  • Расширен API FontSetting , теперь он включает в себя:
    • Настройка параметров шрифта, например, установка табличного шрифта. ( If12b7 )
    • Настройка вариативности шрифта, например, установка пользовательской ширины для вариативных шрифтов. ( I2b36d )
  • В FontStyle добавлен API для семейств шрифтов, позволяющий указывать порядок использования тех или иных семейств шрифтов. ( Iba9f5 )
  • Переименованы константы для высоты пространства между содержимым и дополнительной меткой в LayoutDefaults модуля Material, которые изначально имели префикс «Edge content», чтобы сделать их более универсальными, поскольку они могут применяться как к PrimaryLayout так и EdgeContentLayout . ( I4dc32 )

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

  • Переименование осей с переменным шрифтом: с axisName на axisTag . ( I02ba3 )

Версия 1.2.0-alpha03

14 мая 2024 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.2.0-alpha03 . Версия 1.2.0-alpha03 содержит следующие коммиты .

Новые функции

  • Добавлен API для установки пользовательских значений толщины шрифта FontStyle . ( I7390a )

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

  • Исправлена ​​ошибка в getTouchDelegateInfo , возникающая из-за пустой карты целевых объектов. ( I2accf )

Версия 1.2.0-alpha02

1 мая 2024 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.2.0-alpha02 . Версия 1.2.0-alpha02 содержит следующие коммиты .

Изменения в API

  • Мы добавили поддержку отключения обратной связи в виде пульсаций для отдельных кликабельных элементов. ( If1ede )
  • API для преобразования был удален из ArcModifiers , поскольку они не поддерживают эту функцию ( Ic0827 ).
  • Теперь ArcDirectionProp Builder ожидает значение в конструкторе. ( I76ada )
  • Метод PlatformDataValues.Builder.putAll позволит объединить один PlatformDataValue с другим. ( I50ba3 )
  • Text#setIsScalable переименована в Text#setScalable . ( If920e )
  • В Material Text можно задать, следует ли использовать масштабируемый размер (увеличивается при изменении размера шрифта пользователем) или нет. ( Ibc849 )
  • Мы добавили возможность задать описание контента для TitleChip . ( I5d21f )
  • Исправлена ​​ошибка в работе CompactChip теперь он корректно работает только с иконкой, а API обновлен для поддержки этой опции. ( I6589e )

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

  • Исправлена ​​ошибка, из-за которой при инициализации могли возникать дублирующиеся данные платформы. ( Iba0fd )
  • Ввести новый геттер для DynamicDataNode для получения стоимости узла. Стоимость используется при получении динамической квоты на узлы. В настоящее время узлы с фиксированными значениями имеют стоимость 0, все остальные узлы — стоимость 1. ( Ia33e1 )
  • Удалите логику подсчета из NO_OP_QUOTA_MANAGER . ( Ib50b8 )
  • Мы добавили правило линтинга, которое выдает предупреждение при использовании PrimaryLayout без setResponsiveContentInsetEnabled , и предлагаем быстрое решение проблемы. ( I12025 )
  • Существует ограничение на количество динамических узлов выражений. ( Iffae8 )

Версия 1.2.0-alpha01

6 марта 2024 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.2.0-alpha01 . Версия 1.2.0-alpha01 содержит следующие коммиты .

Новые функции

  • Теперь элементы ProtoLayout Arc могут добавлять параметр ArcDirection ( Clockwise , Counterclockwise или Normal ). Добавление этого поведения к Arc , ArcLine или ArcText исправит их поведение в макетах с направлением текста справа налево (RTL). ( I90699 )
  • В EdgeContentLayout добавлен новый сеттер setResponsiveContentInsetEnabled для лучшего соответствия рекомендациям по UX, обеспечения единообразия в Tiles за счет фиксированного расположения основной метки сверху и адаптивного отступа для меток. ( I60175 )
  • Мы добавили PrimaryLayout.setResponsiveContentInsetEnabled , который добавляет адаптивный отступ к основной метке, дополнительной метке и нижнему чипу в этом макете, чтобы избежать выхода содержимого за края экрана. ( I0c457 )
  • Добавлен метод для удаления внешних полей из CircularProgressIndicator , чтобы его можно было использовать в качестве более компактного компонента. ( I55c06 )

Изменения в API

  • Теперь средство рендеринга плиток по умолчанию исключает отступы шрифта для всех текстовых элементов, без возможности их включения. ( I3e300 )

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

  • Исправлена ​​проблема выравнивания текста при одновременном использовании параметров многоточия, межбуквенного расстояния и выравнивания по центру. ( I716c7 )
  • Добавлено обходное решение проблемы с отрисовкой дуги Skia. ( I08f09 )
  • Исправить направление отрисовки ArcLine для RTL-макетов. ( I6c141 )

Версия 1.1

Версия 1.1.0

7 февраля 2024 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.1.0 . Версия 1.1.0 содержит следующие коммиты.

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

  • Поддержка градиентов и более точное отображение длин, превышающих 360 градусов, в ArcLine .
  • Форматирование даты и времени поддерживает различные часовые зоны для динамических типов данных.
  • Улучшены параметры автоматического изменения размера текста и добавления многоточия для обработки усеченного текста.
  • Проставка позволяет увеличить габаритные размеры за счет дополнительного утяжелителя.
  • Аннотация, указывающая на требование к версии схемы, для всех API ProtoLayout .
  • Расширена целевая область для любого Clickable элемента до 48 dp x 48 dp в соответствии с требованиями доступности.
  • Отступы шрифта по умолчанию отключены, и это единственное поведение для всех текстовых элементов и компонентов Material Design, содержащих текст.

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

Версия 1.1.0-rc01

24 января 2024 г.

Выпущена библиотека androidx.wear.protolayout:protolayout-*:1.1.0-rc01 . Версия 1.1.0-rc01 содержит следующие коммиты.

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

  • Функция PlatformTimeUpdateNotifierImpl срабатывает сразу после включения обновления. ( I77145 )
  • Исправлена ​​ошибка CircularProgressIndicator для RTL-макетов. Теперь он будет вращаться по часовой стрелке во всех случаях. ( I95ee3 )
  • Добавлено обходное решение проблемы с отрисовкой дуги Skia. ( I08f09 )

Версия 1.1.0-beta01

10 января 2024 г.

Выпущена версия androidx.wear.protolayout:protolayout-*:1.1.0-beta01 . Версия 1.1.0-beta01 содержит следующие коммиты.

Новые функции

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

  • Теперь ArcLine поддерживает градиенты благодаря добавлению Brush с SweepGradient , а также добавлению тени к вершине линии для более точного отображения длины, превышающей 360 градусов, путем добавления Shadow к существующему StrokeCap .
  • DynamicInstant поддерживает форматирование даты и времени по зонам. DynamicInstant и DynamicDuration можно использовать в качестве типов данных состояния или платформы.
  • Функция автоматического изменения размера текста позволяет задавать несколько размеров с помощью FontStyle.setSizes , при этом размер текста будет автоматически масштабироваться в зависимости от пространства внутри родительского элемента. Кроме того, мы улучшили параметры многоточия для текста, выходящего за пределы родительского элемента, добавив TEXT_OVERFLOW_ELLIPSIZE и заменив TEXT_OVERFLOW_ELLIPSIZE_END на устаревший.
  • Теперь Spacer поддерживает расширенные размеры с необязательным весом. Для создания ExpandedDimensionProp мы добавили вспомогательный метод DimensionBuilders.weight .
  • Поддержка динамического скрытия и отображения элементов макета с помощью Modifier.visible . Это включает в себя использование динамических значений в BoolProp .
  • Теперь все API ProtoLayout имеют аннотацию, указывающую на требование версии схемы, и версию можно проверить перед вызовом более нового API.
  • Every element that has Clickable now has its target area extended to at least 48x48 in the renderer to better support accessibility requirements.
  • Following other Material components and Compose initiatives, we have now turned off font padding by default on all Text elements. Additionally, AndroidTextStyle and related setters have been removed from the public API. with following bug fixes:
  • Added a setter for positioning the edge content in EdgeContentLayout so it can be positioned before other content.
  • Consistently throwing an exception when encountering an unrecognized enum value.
  • Invalidate the result of an expression when it yields an invalid numeric value (NaN or infinite) or throws an ArithmeticException .

Изменения в API

  • Updates to SweepGradient API to allow accepting either colors or ColorStops in the constructor. ( I6676f )

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

  • Adding a restricted API and renderer support for setting a direction in which arc elements are drawn. ( Idef5a )
  • RoundMode defaults to Floor in FloatToInt32Node when unspecified. The node will still throw an exception if the provided RoundMode is unrecognized. ( I1b2d8 )

Версия 1.1.0-alpha04

13 декабря 2023 г.

androidx.wear.protolayout:protolayout-*:1.1.0-alpha04 is released. Version 1.1.0-alpha04 contains these commits.

Новые функции

  • VersionInfo class not implements the Comparable interface. ( I8d13c )
  • Renderer now supports TEXT_OVERFLOW_ELLIPSIZE option. ( I7f085 )

Изменения в API

  • Text overflow option TEXT_OVERFLOW_ELLIPSIZE_END is now deprecated. Please use the new API TEXT_OVERFLOW_ELLIPSIZE with very similar behavior. ( I822d8 )
  • Following other Material components and Compose initiatives, we have now turned off font padding by default on all Text elements. Additionally, AndroidTextStyle and related setters have been removed from the public API. ( I79094 , Ib0b03 , I32959 , Iaf7d5 , Ifa298 , I0a4ae , Ida9d3 )
  • Modifier.hidden is replaced with Modifier.visible ( I56902 )
  • FontStyle#setSizes now accepts int instead of SpProp arguments. ( I02b37 )

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

  • Throw an exception when encountering an Undefined or Unrecognized enum value. ( I9d2cf )
  • Refactor DynamicTypeBindingRequest . ( I27b57 )
  • Invalidate the result of an expression when it yields an invalid numeric value (NaN or infinite) or throws an ArithmeticException . ( I681ae )

Версия 1.1.0-alpha03

29 ноября 2023 г.

androidx.wear.protolayout:protolayout-*:1.1.0-alpha03 is released. Version 1.1.0-alpha03 contains these commits.

Новые функции

  • Add experimental support for dynamically hiding/unhiding layout elements ( I64a78 )
  • Add dynamic value support to BoolProp ( I2fe96 )
  • Add schema version requirement annotation to ProtoLayout APIs ( I0f03c )
  • Extending the API with the new option in TextOverflow for ellipsizing the Text in a fixed parent container even when max lines is not reached (but there's not enough space for Text). ( I110a9 )
  • Added helper method DimensionBuilders.weight for building ExpandedDimensionProp with weight. ( I4f72b )
  • DynamicInstant and DynamicDuration can be used as state or platform data types. ( I6819f )

Изменения в API

  • Update The API to hide DynamicZonedDateTime and move all its operations to DyanamicInstant ( I34b94 )
  • Spacer now supports Expanded dimension for width/height. ( Ie7c94 )
  • Support click target area extension in Renderer ( I39c79 )

Версия 1.1.0-alpha02

15 ноября 2023 г.

androidx.wear.protolayout:protolayout-*:1.1.0-alpha02 is released. Version 1.1.0-alpha02 contains these commits.

Новые функции

  • Added an ArcLine StrokeCap Shadow field to the API. ( I830ec )
  • Extending the API to be able to specify Spacer's width or height to expand. ( I757ca )
  • Мы добавили экспериментальный API для автоматического масштабирования размера текста в зависимости от пространства внутри родительского элемента. ( Ibbe63 )
  • Support minimum clickable size ( I178e3 )
  • Added renderer support for StrokeCap Shadow . ( I48b17 )
  • Add renderer support for Sweep Gradient in ArcLine . ( I4d5bb )

Версия 1.1.0-alpha01

18 октября 2023 г.

androidx.wear.protolayout:protolayout-*:1.1.0-alpha01 is released. Version 1.1.0-alpha01 contains these commits.

Новые функции

  • Added a brush option to Arcline , with support for SweepGradient . ( Ie7ce3 )
  • Added support for zoned date-time formatting. ( Ibfae0 )
  • Added protos and java Wrappers required for zoned date-time formatting. ( I97126 )
  • Added getters for reading back the value stored in a DynamicDataValue . ( Ie6cea )
  • Added a setter for positioning the edge content in EdgeContentLayout so it can be positioned before other content. ( Ie8e8a )

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

  • Fixed an issue when an expression with multiple time data source registrations was not being updated immediately. ( I8e1a8 )
  • Fixed a bug to center root element during diff updates. ( Ie48f7 )
  • Unset (or empty) layout constraint values will not be ignored anymore. ( Ibc785 )
  • Reduced delay between a layout becoming visible and its pipeline nodes being initialized. ( I38d4e )

Версия 1.0

Версия 1.0.0

9 августа 2023 г.

androidx.wear.protolayout:protolayout-*:1.0.0 is released. Version 1.0.0 contains these commits.

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

ProtoLayout library introduces APIs for creating layouts and expressions that can be used across different Wear OS surfaces. For example Tiles library uses these APIs to support platform data binding (for faster tile data updates) and animations.

Версия 1.0.0-rc01

26 июля 2023 г.

androidx.wear.protolayout:protolayout-*:1.0.0-rc01 is released. Version 1.0.0-rc01 contains these commits.

  • To migrate from Tiles to ProtoLayout , please follow the instructions here .

Изменения в API

  • We have removed setLayoutConstraintForDynamicAnchorAngle and getLayoutConstraintForDynamicAnchorAngle methods from Arc element. These methods have been added by mistake and they didn't have any effect on the provided layout. ( If7d01 )
  • We have limited the maximum depth that a ProtoLayout 's layout can have to 30 nested LayoutElements . ( I8a74b )

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

  • We have added a check to throw if DynamicColor has been set for a SpanText . ( I0e5bc )
  • It is clarified that DAILY_CALORIES data source unit is kcal. ( Iaa785 )

Версия 1.0.0-beta01

21 июня 2023 г.

androidx.wear.protolayout:protolayout-*:1.0.0-beta01 is released. Version 1.0.0-beta01 contains these commits.

Новые функции

  • Allow setting clock for time binding tests. ( I05622 )

Изменения в API

  • PlatformDataReceiver.onData() and StateBuilders.Builder.addKeyToValueMapping now accept type-safe mapping of DynamicDataKey to DynamicDataValue rather than unsafe generics. That means that DynamicDataValue is now typed with its DynamicType . HEART_RATE_ACCURACY_X constants moved to the root of PlatformHealthSources , to match other Android constants positioning. HEART_RATE_ACCURACY_X int constants are now used directly in DynamicHeartRateAccuracy.constant() and DynamicHeartRateAccuracy.dynamicDataValueOf() instead of value constant. ( I82ff5 )
  • The PlatformHealthSources.Constants class was instantiable by mistake. This has been fixed now. ( Icb849 )
  • PlatformTimeUpdateNotifier#setReceiver now receives Runnable instead of Supplier function and Executor to notify on. ( I9d938 )
  • We have changed the parameter type in the PlatformTimeUpdateNotifier#setReceiver from Callable to Supplier . ( I664bf )
  • CompactChip and TitleChip now support adding an icon to it. ( I5a01e )

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

  • Update Prop messages with dynamic fields to use oneof instead ( I81739 )
  • Reuse setters implementation for overloads that have setters ( Ied70c )
  • Properly record fingerprints in setters that have overloads ( I86ed2 )

Версия 1.0.0-alpha11

7 июня 2023 г.

androidx.wear.protolayout:protolayout-*:1.0.0-alpha11 is released. Version 1.0.0-alpha11 contains these commits.

Новые функции

  • We've added a PlatformDataKey for heart rate accuracy. ( I7f9b8 )

Изменения в API

  • Rename StateBuilders#getIdToValueMapping to getKeyToValueMapping and change the return type to Map<<AppDataKey<?>,DynamicDataValue> . ( Iaa7ae )
  • Make StateStore a final class ( I408ca )
  • TimeGateway interface has been replaced by PlatformTimeUpdateNotifier in protolayout-expression-pipeline library which provides desired frequency for updating time data. ( I60869 )
  • Rename register / unregisterForData in PlatformDataProvider to set / clearReceiver ( I14b02 )
  • In Material Text, getExcludeFontPadding has been renamed to hasExcludeFontPadding . ( Iea01d )
  • Setter for perfectly aligning label was added to all chip components. All chips now have min tappable target applied. ( I8ae92 )
  • LayoutDefaults#BUTTON_MAX_NUMBER has been renamed to MAX_BUTTONS . ( I84788 )
  • DAILY_DISTANCE is renamed to DAILY_DISTANCE_M . ( I4f758 )

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

  • Update Prop types docs to clarify why static value is enforced. Specify the default value used if static value wasn't provided. ( I155aa )
  • PlatformDataKey namespaces should follow Java style naming. ( I47bda )

Версия 1.0.0-alpha10

24 мая 2023 г.

androidx.wear.protolayout:protolayout-*:1.0.0-alpha10 is released. Version 1.0.0-alpha10 contains these commits.

Новые функции

  • Add AppDataKey for accessing app pushed state; Add PlatformDataKey for accessing platform data; Add namespace support in StateStore . ( I7985e )
  • Support Equal and NotEqual operations for DynamicBool . ( I6a0c1 )

Изменения в API

  • FontStyles class is now final ( Iaa2ea )
  • LayoutElementBuilders#FontStyles has been deprecated. Please use androidx.wear.protolayout.Typography or create your own FontStyle . ( Ic929b )
  • Hide Action#Builder nested interface from Action interface. Implementations of Builder are already provided by LoadAction and LaunchAction classes. ( I1d70c )
  • Allow using DynamicFloat with FloatProp . Note that FloatProp do no require layout constraints as it's not used as a layout changing prop. ( I286ac )
  • The LoalAction and SetStateAction actions are removed as they were not really supported yet. ( I5d6a6 )
  • Added support for ARGB_8888 format for inline image resources. ( I8a07c )
  • Rename StateEntryValue to DynamicDataValue , and update the state APIS to use the DynamicDataKey ( If1c01 )
  • Мы ограничиваем количество записей, разрешенных в StateStore , чтобы обеспечить эффективное использование памяти и контроль времени обновления состояния для каждого экземпляра StateStore . В результате разработчику необходимо убедиться, что в карте не содержится более MAX_STATE_ENTRY_COUNT записей, иначе при создании или обновлении StateStore возникнет исключение IllegalStateException . ( Ibadb3 )
  • Hide OnLoadTrigger and OnConditionMetTrigger classes, and rename setTrigger to setCondition for OnConditionMetTrigger . ( Ibf629 )
  • For performance and compatibility reasons, the ProtoLayout renderers won't support the full set of features in AnimatedVectorDrawable resources. We're marking those APIs as experimental until we can define the supported set. ( Ic6daf )
  • Added dynamic types for daily distance, daily calories and daily floors. Keys for platform health sources are now under PlatformHealthSources.Keys ( Ib7637 )
  • The Easing.cubicBezier method replaces the CubicBezierEasing.Builder . With that the EasingFunction class is removed and the easing constants from that class are now directly accessible from the Easing interface. In addition setInfiniteRepeatable is replaced by INFINITE_REPEATABLE_WITH_RESTART and INFINITE_REPEATABLE_WITH_REVERSE ( Ib41e7 )
  • Implement PlatformDataProvider to provide heart rate and daily steps. SensorGateway interface is removed from public API. ( I55b84 )
  • Add PlatformDataProvider , and update StateStore to register to PlatformDataProvider when the provider's supported key is required by node from expression pipeline. ( Ib616a )
  • SensorGateway is no longer Closeable as it no longer maintains any state. ( I6b4f7 )
  • Allow using FloatProp with DynamicFloat for progress in CircularProgressIndicator . This is supported for renderers supporting version 1.2. Old renderers will fallback to the staticValue if provided, otherwise to 0 ( I0d91b )
  • MultiButtonLayout constants have been refactored into LayoutDefaults.MultiButtonLayoutDefaults class which now contains those for button sizes depending on a number of buttons in the layout. ( I13973 )
  • Support using StringProp with DynamicString in Material Text. This is supported for renderers supporting version 1.2. Old renderers will fallback to the provided static value. Update Text#getText return type from String to StringProp . ( I7275b )

Версия 1.0.0-alpha09

10 мая 2023 г.

androidx.wear.protolayout:protolayout-*:1.0.0-alpha09 is released. Version 1.0.0-alpha09 contains these commits.

Новые функции

  • We've added an experimental extension layout element. Note that this can't be used by default and requires a renderer extension capable of understanding the layout element. ( I6581d )
  • Added StrokeCap support for ArcLine . ( I94951 )
  • Added support for Conditional Instant operation. ( I489a7 )
  • Added support for Conditional Duration operation. ( Iab469 )
  • Added support for creating duration from seconds. ( Ib5fa1 )

Изменения в API

  • enable/disablePlatformSource methods have been removed from DynamicTypeEvaluator . The caller should be responsible for updates. ( I78c6d )
  • Allow capping the size of bound data types. ( Ie2966 )
  • Add support for dynamic content description in protolayout-material . ( I62c8e )
  • Use long and @IntRange for duration and delay in AnimationParameters. ( I388b6 )

Версия 1.0.0-alpha08

19 апреля 2023 г.

androidx.wear.protolayout:protolayout-*:1.0.0-alpha08 is released. Version 1.0.0-alpha08 contains these commits.

Новые функции

  • AndroidTextStyle has been added to LayoutElementBuilders . ( I8d967 )
  • We have added support for setting excluding font padding in ProtoLayout Material Text. ( I17f5d )
  • ARGB_8888 is now supported for inline images. ( I18c1e )
  • DynamicColor now supports onCondition operation. ( I10927 )

Изменения в API

  • Support custom duration for reverse animation ( I3251f )
  • We've added the SemanticDescription modifier. In addition, ContentDescription is not bindable. ( I3f1d )
  • The DynamicBool.isFalse() method is now replaced with DynamicBool.negate() and the DynamicBool.isTrue() is removed. In addition NaN DynamicFloat values and narrowing a DynamicInt32 to a DynamicFloat now emit an invalid dynamic result. ( I6ac1e )
  • Int and float formatters now use the Builder pattern. ( Ieb213 )

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

  • Fallback static value has been removed from animatable fields. ( Ifcb01 )
  • DynamicTypeValueReceiver#onPreUpdate has been removed. ( I2dc35 )
  • Length of Strings in dynamic expressions are now capped. ( I4c93 )
  • Теперь зависимости Gradle корректно устанавливаются на api вместо implementation , когда это необходимо. ( I40503 )

Версия 1.0.0-alpha07

5 апреля 2023 г.

androidx.wear.protolayout:protolayout-*:1.0.0-alpha07 is released. Version 1.0.0-alpha07 contains these commits.

Новые функции

  • Add dynamic value support to StringProp ( I04342 )
  • Mark bindable layout elements ( Ia110b )

Изменения в API

  • sensorGateway#registerSensorGatewayConsumer takes data type as a parameter instead of method in Consumer. ( Icf314 )
  • ObservableStateStore был переименован в StateStore . ( Ieb0e2 )
  • Added DynamicTypeEvaluator.Builder instead of constructor arguments to allow more optional arguments, including ObservableStateStore which now defaults to an empty store. ( I6f832 )
  • Refactored order of parameters in DynamicTypeEvaluator . ( Ic1ba4 )

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

  • Correctly propagate signals from platform sensor sources to downstream nodes ( I5a922 )

Версия 1.0.0-alpha06

22 марта 2023 г.

androidx.wear.protolayout:protolayout-*:1.0.0-alpha06 is released. Version 1.0.0-alpha06 contains these commits.

Новые функции

  • We've added an experimental API for using heart rate and daily steps in dynamic expressions ( Ifd711 )
  • We have added support for reverse and forward delay for animations. ( Ic25f7 )
  • We've added DynamicColor support to Border and Background
  • We've added dynamic value support to types in DimensionBuilder
  • Layout and components from tiles-material are moving to protolayout-material

Изменения в API

  • LoadActionListener has been added to ProtoLayoutViewInstance . ( If7806 )

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

  • Added FloatNodesTest ( Id7281 )
  • Fix renderer crash when unable to load structured bitmap.

Версия 1.0.0-alpha05

8 марта 2023 г.

androidx.wear.protolayout:protolayout-*:1.0.0-alpha05 is released. Version 1.0.0-alpha05 contains these commits.

Новые функции

  • We've added an experimental "content update" animation to the Modifiers object. This animation will trigger whenever the element (with this modifier) or one of its children changes during a layout update. ( bd03e5d )

Изменения в API

  • We've added forwardRepeatDelayMillis and reverseRepeatDelayMillis to Repeatable . We've also renamed delayMillis in AnimationSpec to startDelayMillis ( Ifb266 )
  • DynamicTypeEvaluator.bind methods now accept an Executor. ( I346ab )
  • We've added the startEvaluation method to the BoundDynamicType to trigger the evaluation after the dynamic type is bound. ( I19908 )

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

  • The Animator object will be reused for subsequent animations of a single element. ( Ia3be9 )

Версия 1.0.0-alpha04

22 февраля 2023 г.

androidx.wear.protolayout:protolayout-*:1.0.0-alpha04 is released. Version 1.0.0-alpha04 contains these commits.

Новые функции

  • ObservableStateStore now informs the listeners when a key is removed too.
  • We've added renderer schema version and font scale to DeviceParameters (which can be used to conditionally create layouts in response to different versions and font settings).
  • We've added support for animating DynamicInt32 values ( I05485 )
  • We've added OnLoad and OnConditionalMet triggers. These can be used to start animations that support a trigger.
  • We've added layout weight for expanded dimensions and min size for wrapped dimensions.
  • We've added duration and instant dynamic types. These can be used to represent a time instant or duration in a dynamic expression.
  • We've added support for AnimatedVectorDrawable and SeekableAnimatedVectorDrawable as layout resources.

Изменения в API

  • Sensor data requires API 29+. ( I8099e )
  • We've added two launchAction helper methods (for launching Activities).

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

  • Rename set/getSpec to set/getAnimationSpec in Tiles animation ( I3d74b )

Версия 1.0.0-alpha03

8 февраля 2023 г.

androidx.wear.protolayout:protolayout-*:1.0.0-alpha03 is released. Version 1.0.0-alpha03 contains these commits.

Новые функции

  • We have added toByteArray() and fromByteArray() to Dynamic types in protolayout-express library.
  • We have added toString() to Dynamic types in protolayout-expression library.
  • We have added evaluation support for Dynamic types. The DynamicTypeEvaluator class from the protolayout-expression-pipeline library can be used to evaluate (and receive updated values) for a previously create Dynamic type ( DynamicString , DynamicFloat , …)
  • When animations can't be played (either because they are disabled by the evaluator, or the number of running animations has reached the set limit), the static values set on the animatable node will be used to replace the animation.

Версия 1.0.0-alpha02

25 января 2023 г.

androidx.wear.protolayout:protolayout:1.0.0-alpha02 , androidx.wear.protolayout:protolayout-expression:1.0.0-alpha02 , and androidx.wear.protolayout:protolayout-proto:1.0.0-alpha02 are released. Version 1.0.0-alpha02 contains these commits.

Новые функции

  • Layout builders from androidx.wear.tiles:tiles are moving to androidx.wear.protolayout:protolayout . The ones in androidx.wear.tiles:tiles will be deprecated in one of the next alpha releases.

Версия 1.0.0-alpha01

11 января 2023 г.

androidx.wear.protolayout:protolayout-expression:1.0.0-alpha01 and androidx.wear.protolayout:protolayout-proto:1.0.0-alpha01 are released. Version 1.0.0-alpha01 contains these commits.

Новые функции

  • This release introduces a new library "ProtoLayout Expression" for creating expressions from dynamic variables.