носить протомакет

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

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

Чтобы добавить зависимость от 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-alpha04"

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

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

Котлин

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

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

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

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

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

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

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

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

Версия 1.3

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

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 ).
  • DynamicDataValue теперь имеет метод hasValueOfType(Class<?>) в дополнение к методам hasInt/hasColor/ .... ( I4f7a6 ).
  • Мы добавили errorDim в ColorScheme Material3 ProtoLayout для ошибок с высоким приоритетом или экстренных действий, таких как оповещения о безопасности. ( Ia17bb )
  • Мы добавили защиту от сбоя при доступе к глобальной настройке уменьшения движения, которая срабатывала на некоторых платформах, где этот параметр не был предусмотрен. ( I01e2c )

Изменения API

  • addKeyToValueMapping переименованы в addToStateMap , а методы DynamicDataMap.put удалены, поскольку они были избыточными. ( Ibe9dd )
  • Material3 Typography теперь поддерживает переменную ось округлости для системных шрифтов, которые поддерживают эту ось. ProtoLayout FontSetting поддерживает ось округлости для шрифтов, которые поддерживают эту ось. ( I33eb5 )
  • multilineAlignment переименован в выравнивание в текстовом методе 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-альфа07

29 января 2025 г.

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

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

  • Добавлена ​​опция API для установки различных триггеров для анимации Лотти. Кроме того, добавлен API для триггеров, срабатывающих при отображении макета ( I8272d ).
  • Добавлены модификаторы border , visibility и opacity . ( I6d3dd )
  • Добавлена ​​кнопка аватара в компонент ProtoLayout Material3. ( Idb5ae )
  • Теперь мы разрешаем настраивать поля (боковые и в некоторых случаях нижние) в primaryLayout Material3. ( 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-альфа06

15 января 2025 г.

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

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

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

Изменения API

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

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

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

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

11 декабря 2024 г.

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

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

  • Добавлен LayoutString для поддержки привязываемых строковых полей макета. ( Ида650 )
  • Добавлен компонент контейнера карточек ProtoLayout Material3 . ( Ic985a )

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

  • Эта библиотека теперь использует аннотации NULL NULL JSpecify , которые являются типизированными. Разработчики Kotlin должны использовать следующие аргументы компилятора для обеспечения правильного использования: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode ( Id1f9b , b/326456246 )

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

13 ноября 2024 г.

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

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

  • Форма Material3 обновлена ​​и теперь представляет собой класс с полями, содержащими фактическое значение угла, как и в Wear Compose. ( Ied8cd )
  • Обновлены цвета Material3, чтобы включить концепцию ColorScheme , такую ​​же, как в Wear Compose. ( Если645е )
  • Добавьте в библиотеку тестирования несколько часто используемых средств сопоставления. ( Ie5cec )

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

30 октября 2024 г.

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

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

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

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

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-альфа01

2 октября 2024 г.

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

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

  • Уточнено, что доступность названий семейств шрифтов Roboto и Roboto Flex зависит от устройства. ( I193be )
  • Включено семейство шрифтов Roboto Flex в средстве рендеринга плиток AndroidX. ( 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 . Обновите свою зависимость от androidx.wear.protolayout:protolayout-proto и androidx.wear.protolayout:protolayout-external-protobuf версии 1.2.0 до 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 для лучшей поддержки адаптивного поведения этих макетов на экранах разных размеров и улучшения согласованности плиток.
  • Улучшено масштабирование/немасштабирование текста материала для нелинейного масштабирования шрифта Android 14.
  • Улучшена поддержка направления компоновки RTL для всех дуговых элементов.

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

Версия 1.2.0-rc01

24 июля 2024 г.

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

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

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

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

10 июля 2024 г.

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

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

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

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

Изменения API

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

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

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 , включив в него аннотации диапазона, и измените параметр веса на int. ( Ia726c )

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

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

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

29 мая 2024 г.

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

Изменения API

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

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

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

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

14 мая 2024 г.

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

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

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

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

  • Исправьте сбой в getTouchDelegateInfo из-за пустой целевой карты. ( I2accf )

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

1 мая 2024 г.

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

Изменения API

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

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

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

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

6 марта 2024 г.

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

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

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

Изменения API

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

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

  • Исправлена ​​проблема с выравниванием текста, когда в тексте используются размер эллипса, межбуквенный интервал и выравнивание по центру. ( I716c7 )
  • Добавьте обходной путь для проблемы с рисованием дуги лыжи. ( 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 x 48 точек для удовлетворения требований доступности.
  • Заполнение шрифта по умолчанию отключено и является единственным поведением для всех элементов Text и компонентов Material, содержащих текст.

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

Версия 1.1.0-rc01

24 января 2024 г.

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

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

  • PlatformTimeUpdateNotifierImpl устанавливается сразу после включения обновления. ( I77145 )
  • CircularProgressIndicator исправлен для макетов с письмом справа налево. Отныне во всех случаях он будет идти по часовой стрелке. ( I95ee3 )
  • Добавьте обходной путь для проблемы с рисованием дуги лыжи. ( I08f09 )

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

10 января 2024 г.

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

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

В выпуске Wear ProtoLayout 1.1.0-beta01 указано, что этот выпуск библиотеки является полнофункциональным, а 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.
  • Целевая область каждого элемента, имеющего Clickable , теперь расширена в средстве рендеринга как минимум до 48x48, чтобы лучше соответствовать требованиям доступности.
  • Следуя другим компонентам Material и инициативам Compose, мы теперь отключили заполнение шрифтов по умолчанию для всех Text элементов. Кроме того, AndroidTextStyle и связанные с ним параметры настройки были удалены из общедоступного API. со следующими исправлениями ошибок:
  • Добавлен установщик для позиционирования краевого содержимого в EdgeContentLayout чтобы его можно было расположить перед другим содержимым.
  • Последовательное создание исключения при обнаружении нераспознанного значения перечисления.
  • Сделайте недействительным результат выражения, если оно возвращает недопустимое числовое значение (NaN или бесконечное) или выдает ArithmeticException .

Изменения API

  • Обновления API SweepGradient , позволяющие принимать в конструкторе либо цвета, либо ColorStops . ( I6676f )

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

  • Добавление ограниченного API и поддержки средства визуализации для установки направления рисования элементов дуги. ( Idef5a )
  • RoundMode по умолчанию имеет значение Floor в FloatToInt32Node если оно не указано. Узел все равно выдаст исключение, если предоставленный RoundMode не распознается. ( I1b2d8 )

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

13 декабря 2023 г.

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

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

  • Класс VersionInfo не реализует интерфейс Comparable . ( I8d13c )
  • Renderer теперь поддерживает опцию TEXT_OVERFLOW_ELLIPSIZE . ( I7f085 )

Изменения API

  • Параметр переполнения текста TEXT_OVERFLOW_ELLIPSIZE_END больше не поддерживается. Используйте новый API TEXT_OVERFLOW_ELLIPSIZE с очень похожим поведением. ( I822d8 )
  • Следуя другим компонентам Material и инициативам Compose, мы теперь отключили заполнение шрифтов по умолчанию для всех текстовых элементов. Кроме того, AndroidTextStyle и связанные с ним параметры настройки были удалены из общедоступного API. ( I79094 , Ib0b03 , I32959 , Iaf7d5 , Ifa298 , I0a4ae , Ida9d3 )
  • Modifier.hidden заменяется на Modifier.visible ( I56902 ).
  • FontStyle#setSizes теперь принимает аргументы int вместо SpProp . ( I02b37 )

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

  • Вызов исключения при обнаружении значения перечисления Undefine или Unrecounced. ( I9d2cf )
  • Рефакторинг DynamicTypeBindingRequest . ( I27b57 )
  • Сделайте недействительным результат выражения, если оно возвращает недопустимое числовое значение (NaN или бесконечное) или выдает ArithmeticException . ( I681ae )

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

29 ноября 2023 г.

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

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

  • Добавлена ​​экспериментальная поддержка динамического скрытия/показания элементов макета ( I64a78 ).
  • Добавьте поддержку динамических значений в BoolProp ( I2fe96 ).
  • Добавление аннотации требований к версии схемы в API ProtoLayout ( I0f03c )
  • Расширение API с помощью новой опции в TextOverflow для эллипса текста в фиксированном родительском контейнере, даже если максимальное количество строк не достигнуто (но для текста недостаточно места). ( I110a9 )
  • Добавлен вспомогательный метод DimensionBuilders.weight для построения ExpandedDimensionProp с весом. ( I4f72b )
  • DynamicInstant и DynamicDuration можно использовать как типы данных состояния или платформы. ( I6819f )

Изменения API

  • Обновите API, чтобы скрыть DynamicZonedDateTime и перенести все его операции в DyanamicInstant ( I34b94 ).
  • Разделитель теперь поддерживает расширенные размеры по ширине/высоте. ( Ie7c94 )
  • Поддержка расширения целевой области щелчка в Renderer ( I39c79 )

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

15 ноября 2023 г.

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

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

  • В API добавлено поле ArcLine StrokeCap Shadow . ( I830ec )
  • Расширение API, чтобы можно было указать ширину или высоту Spacer для расширения. ( I757ca )
  • Мы добавили экспериментальный API для автоматического масштабирования размера текста в зависимости от пространства, которое он имеет внутри родительского элемента. ( Иббе63 )
  • Поддержка минимального кликабельного размера ( I178e3 ).
  • Добавлена ​​поддержка рендеринга StrokeCap Shadow . ( I48b17 )
  • Добавьте поддержку средства визуализации для Sweep Gradient в ArcLine . ( I4d5bb )

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

18 октября 2023 г.

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

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

  • В Arcline добавлена ​​опция кисти с поддержкой SweepGradient . ( Ie7ce3 )
  • Добавлена ​​поддержка зонального форматирования даты и времени. ( Ибфае0 )
  • Добавлены прототипы и Java-оболочки, необходимые для зонального форматирования даты и времени. ( I97126 )
  • Добавлены геттеры для обратного чтения значения, хранящегося в DynamicDataValue . ( Ie6cea )
  • Добавлен установщик для позиционирования краевого содержимого в EdgeContentLayout чтобы его можно было расположить перед другим содержимым. ( Ie8e8a )

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

  • Исправлена ​​проблема, из-за которой выражение с многократной регистрацией источника данных по времени не обновлялось немедленно. ( I8e1a8 )
  • Исправлена ​​ошибка центрирования корневого элемента во время обновления различий. ( Ie48f7 )
  • Неустановленные (или пустые) значения ограничений макета больше не будут игнорироваться. ( Ibc785 )
  • Уменьшена задержка между отображением макета и инициализацией узлов его конвейера. ( I38d4e )

Версия 1.0

Версия 1.0.0

9 августа 2023 г.

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

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

Библиотека ProtoLayout представляет API для создания макетов и выражений, которые можно использовать в различных средах Wear OS. Например, библиотека Tiles использует эти API для поддержки привязки данных платформы (для более быстрого обновления данных плиток) и анимации.

Версия 1.0.0-rc01

26 июля 2023 г.

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

  • Чтобы перейти с Tiles на ProtoLayout , следуйте инструкциям здесь .

Изменения API

  • Мы удалили методы setLayoutConstraintForDynamicAnchorAngle и getLayoutConstraintForDynamicAnchorAngle из элемента Arc. Эти методы были добавлены по ошибке и не оказали никакого влияния на предоставленный макет. ( Если7d01 )
  • Мы ограничили максимальную глубину макета ProtoLayout 30 вложенными LayoutElements . ( I8a74b )

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

  • Мы добавили проверку, которая выдается, если для SpanText установлен DynamicColor . ( I0e5bc )
  • Уточняется, что единицей источника данных DAILY_CALORIES является ккал. ( Iaa785 )

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

21 июня 2023 г.

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

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

  • Разрешить установку часов для тестов привязки времени. ( I05622 )

Изменения API

  • PlatformDataReceiver.onData() и StateBuilders.Builder.addKeyToValueMapping теперь принимают безопасное по типу сопоставление DynamicDataKey с DynamicDataValue а не небезопасные универсальные шаблоны. Это означает, что DynamicDataValue теперь типизируется с помощью DynamicType . Константы HEART_RATE_ACCURACY_X перемещены в корень PlatformHealthSources , чтобы соответствовать расположению других констант Android. Константы HEART_RATE_ACCURACY_X int теперь используются непосредственно в DynamicHeartRateAccuracy.constant() и DynamicHeartRateAccuracy.dynamicDataValueOf() вместо константы-значения. ( I82ff5 )
  • Класс PlatformHealthSources.Constants был создан по ошибке. Теперь это исправлено. ( Icb849 )
  • PlatformTimeUpdateNotifier#setReceiver теперь получает Runnable вместо функции Supplier и Executor для уведомления. ( I9d938 )
  • Мы изменили тип параметра в PlatformTimeUpdateNotifier#setReceiver с Callable на Supplier . ( I664bf )
  • CompactChip и TitleChip теперь поддерживают добавление значка. ( I5a01e )

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

  • Обновить сообщения Prop с помощью динамических полей, чтобы вместо них использовать oneof ( I81739 ).
  • Реализация повторного использования установщиков для перегрузок, имеющих установщики ( Ied70c )
  • Правильно записывать отпечатки пальцев в сеттерах, имеющих перегрузки ( I86ed2 ).

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

7 июня 2023 г.

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

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

  • Мы добавили PlatformDataKey для точности измерения сердечного ритма. ( I7f9b8 )

Изменения API

  • Переименуйте StateBuilders#getIdToValueMapping в getKeyToValueMapping и измените тип возвращаемого значения на Map<<AppDataKey<?>,DynamicDataValue> . ( Iaa7ae )
  • Сделайте StateStore последним классом ( I408ca ).
  • Интерфейс TimeGateway был заменен на PlatformTimeUpdateNotifier в библиотеке protolayout-expression-pipeline которая обеспечивает желаемую частоту обновления данных времени. ( I60869 )
  • Переименуйте register / unregisterForData в PlatformDataProvider , чтобы set / clearReceiver ( I14b02 ).
  • В тексте материала getExcludeFontPadding был переименован в hasExcludeFontPadding . ( Iea01d )
  • Ко всем компонентам чипа добавлен установщик для идеального совмещения этикеток. Ко всем фишкам теперь применена минимальная цель, которую можно коснуться. ( I8ae92 )
  • LayoutDefaults#BUTTON_MAX_NUMBER переименован в MAX_BUTTONS . ( I84788 )
  • DAILY_DISTANCE переименован в DAILY_DISTANCE_M . ( I4f758 )

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

  • Обновите документацию по типам реквизитов, чтобы уточнить, почему применяется статическое значение. Укажите значение по умолчанию, которое будет использоваться, если статическое значение не указано. ( I155aa )
  • Пространства имен PlatformDataKey должны соответствовать именованию в стиле Java. ( I47bda )

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

24 мая 2023 г.

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

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

  • Добавьте AppDataKey для доступа к состоянию отправки приложения; Добавьте PlatformDataKey для доступа к данным платформы; Добавьте поддержку пространства имен в StateStore . ( I7985e )
  • Поддержка операций Equal и NotEqual для DynamicBool . ( I6a0c1 )

Изменения API

  • Класс FontStyles теперь финальный ( Iaa2ea ).
  • LayoutElementBuilders#FontStyles устарел. Используйте androidx.wear.protolayout.Typography или создайте свой собственный FontStyle . ( Ic929b )
  • Скрыть вложенный интерфейс Action#Builder из интерфейса Action . Реализации Builder уже предоставляются классами LoadAction и LaunchAction . ( I1d70c )
  • Разрешить использование DynamicFloat с FloatProp . Обратите внимание, что FloatProp не требует ограничений макета, поскольку он не используется в качестве свойства изменения макета. ( I286ac )
  • Действия LoalAction и SetStateAction удалены, поскольку они еще не поддерживались. ( I5d6a6 )
  • Добавлена ​​поддержка формата ARGB_8888 для встроенных ресурсов изображений. ( I8a07c )
  • Переименуйте StateEntryValue в DynamicDataValue и обновите APIS состояния, чтобы использовать DynamicDataKey ( If1c01 ).
  • Мы ограничиваем количество записей, разрешенных в StateStore , чтобы гарантировать, что использование памяти и время обновления состояния хорошо сдерживаются и контролируются для каждого экземпляра StateStore . В результате разработчику необходимо убедиться, что у него на карте не более MAX_STATE_ENTRY_COUNT записей, иначе он получит исключение IllegalStateException при создании или обновлении StateStore . ( Ибадб3 )
  • Скройте классы OnLoadTrigger и OnConditionMetTrigger и переименуйте setTrigger в setCondition для OnConditionMetTrigger . ( Ibf629 )
  • По соображениям производительности и совместимости средства визуализации ProtoLayout не поддерживают полный набор функций ресурсов AnimatedVectorDrawable . Мы помечаем эти API как экспериментальные, пока не определим поддерживаемый набор. ( Ic6daf )
  • Добавлены динамические типы ежедневного расстояния, ежедневных калорий и ежедневных минимальных значений. Ключи для источников работоспособности платформы теперь находятся в разделе PlatformHealthSources.Keys ( Ib7637 ).
  • Метод Easing.cubicBezier заменяет CubicBezierEasing.Builder . При этом класс EasingFunction удаляется, и константы замедления из этого класса теперь доступны напрямую из интерфейса Easing . Кроме того, setInfiniteRepeatable заменяется на INFINITE_REPEATABLE_WITH_RESTART и INFINITE_REPEATABLE_WITH_REVERSE ( Ib41e7 ).
  • Внедрите PlatformDataProvider , чтобы предоставлять информацию о частоте пульса и шагах за день. Интерфейс SensorGateway удален из общедоступного API. ( I55b84 )
  • Добавьте PlatformDataProvider и обновите StateStore для регистрации в PlatformDataProvider , когда поддерживаемый ключ поставщика требуется узлу из конвейера выражений. ( Ib616a )
  • SensorGateway больше не является Closeable поскольку он больше не поддерживает какое-либо состояние. ( I6b4f7 )
  • Разрешить использование FloatProp с DynamicFloat для прогресса в CircularProgressIndicator . Это поддерживается для средств визуализации, поддерживающих версию 1.2. Старые средства визуализации будут использовать staticValue , если оно указано, в противном случае — 0 ( I0d91b ).
  • Константы MultiButtonLayout были переработаны в класс LayoutDefaults.MultiButtonLayoutDefaults , который теперь содержит их для размеров кнопок в зависимости от нескольких кнопок в макете. ( I13973 )
  • Поддержка с использованием StringProp с DynamicString в тексте материала. Это поддерживается для рендеристов, поддерживающих версию 1.2. Старые визуалисты будут вмешиваться на предоставленную статическую стоимость. Обновить Text#getText возвращать тип от String в StringProp . ( I7275b )

Версия 1.0.0-Alpha09

10 мая 2023 года

androidx.wear.protolayout:protolayout-*:1.0.0-alpha09 выпускается. Версия 1.0.0-Alpha09 содержит эти коммиты.

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

  • Мы добавили экспериментальный элемент макета расширения. Обратите внимание, что это нельзя использовать по умолчанию и требует расширения рендеринга, способного понять элемент макета. ( I6581d )
  • Добавлена ​​поддержка StrokeCap ​​для ArcLine . ( I94951 )
  • Добавлена ​​поддержка условной мгновенной операции. ( I489a7 )
  • Добавлена ​​поддержка для условной работы. ( IAB469 )
  • Добавлена ​​поддержка для создания продолжительности с секунд. ( IB5FA1 )

API меняется

  • enable/disablePlatformSource методы Platformsource были удалены из DynamicTypeEvaluator . Абонент должен нести ответственность за обновления. ( I78c6d )
  • Разрешить ограничить размер связанных типов данных. ( IE2966 )
  • Добавьте поддержку для динамического описания контента в protolayout-material . ( I62c8e )
  • Используйте Long и @IntRange для продолжительности и задержки в анимации. ( I388b6 )

Версия 1.0.0-Alpha08

19 апреля 2023 года

androidx.wear.protolayout:protolayout-*:1.0.0-alpha08 выпускается. Версия 1.0.0-Alpha08 содержит эти коммиты.

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

  • AndroidTextStyle был добавлен в LayoutElementBuilders . ( I8d967 )
  • Мы добавили поддержку для настройки за исключением прокладки шрифтов в текстовом материале ProtoLayout . ( I17f5d )
  • ARGB_8888 теперь поддерживается для встроенных изображений. ( I18c1e )
  • DynamicColor теперь поддерживает операцию onCondition . ( I10927 )

API меняется

  • Поддержка пользовательской продолжительности для обратной анимации ( i3251f )
  • Мы добавили модификатор SemanticDescription . Кроме того, ContentDescription не является привязанной. ( I3f1d )
  • Метод DynamicBool.isFalse() теперь заменен на DynamicBool.negate() , а DynamicBool.isTrue() удаляется. Кроме того, NAN DynamicFloat значения и сужение DynamicInt32 до DynamicFloat теперь излучает неверный динамический результат. ( I6ac1e )
  • Форматиры Int и Float теперь используют шаблон застройщика. ( IEB213 )

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

  • Статическое значение Swarkback было удалено из анимируемых полей. ( IFCB01 )
  • DynamicTypeValueReceiver#onPreUpdate был удален. ( I2dc35 )
  • Длина струн в динамических выражениях теперь ограничена. ( I4c93 )
  • Зависимости Gradle теперь правильно устанавливаются для api вместо implementation , когда это необходимо. ( I40503 )

Версия 1.0.0-Alpha07

5 апреля 2023 года

androidx.wear.protolayout:protolayout-*:1.0.0-alpha07 выпускается. Версия 1.0.0-Alpha07 содержит эти коммиты.

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

  • Добавить поддержку динамического значения в StringProp ( I04342 )
  • Марк привязываемый элементы макета ( IA110B )

API меняется

  • sensorGateway#registerSensorGatewayConsumer принимает тип данных в качестве параметра вместо метода в потребителе. ( ICF314 )
  • ObservableStateStore был переименован в StateStore . ( IEB0E2 )
  • Добавлен DynamicTypeEvaluator.Builder вместо аргументов конструктора, чтобы разрешить более необязательные аргументы, включая ObservableStateStore , который теперь по умолчанию в пустой магазин. ( I6f832 )
  • Рефакторированный порядок параметров в DynamicTypeEvaluator . ( IC1BA4 )

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

  • Правильно распространять сигналы из источников датчиков платформы в нижестоящие узлы ( i5a922 )

Версия 1.0.0-Alpha06

22 марта 2023 года

androidx.wear.protolayout:protolayout-*:1.0.0-alpha06 выпускается. Версия 1.0.0-Alpha06 содержит эти коммиты.

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

  • Мы добавили экспериментальный API для использования частоты сердечных сокращений и ежедневных шагов в динамических выражениях ( IFD711 )
  • Мы добавили поддержку для обратной и вперед задержки для анимации. ( IC25F7 )
  • Мы добавили DynamicColor поддержку по границе и фону
  • Мы добавили поддержку динамического значения типам в DimensionBuilder
  • Макет и компоненты из tiles-material перемещаются в protolayout-material

API меняется

  • LoadActionListener был добавлен в ProtoLayoutViewInstance . ( IF7806 )

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

  • Добавлено FloatNodesTest ( ID7281 )
  • Исправьте сбою рендеринга, если не может загрузить структурированный растровый карту.

Версия 1.0.0-Alpha05

8 марта 2023 года

androidx.wear.protolayout:protolayout-*:1.0.0-alpha05 выпускается. Версия 1.0.0-Alpha05 содержит эти коммиты.

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

  • Мы добавили экспериментальную анимацию «Обновление контента» в объект Modifiers . Эта анимация будет запускать всякий раз, когда элемент (с этим модификатором) или один из его детей изменяется во время обновления макета. ( BD03E5D )

API меняется

  • Мы добавили forwardRepeatDelayMillis и reverseRepeatDelayMillis для Repeatable . Мы также переименовали delayMillis в AnimationSpec чтобы startDelayMillis ( IFB266 )
  • DynamicTypeEvaluator.bind Методы теперь принимают исполнителя. ( I346ab )
  • Мы добавили метод startEvaluation в BoundDynamicType , чтобы запустить оценку после того, как динамический тип связан. ( I19908 )

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

  • Объект аниматора будет использоваться для последующих анимаций одного элемента. ( Ia3be9 )

Версия 1.0.0-Alpha04

22 февраля 2023 года

androidx.wear.protolayout:protolayout-*:1.0.0-alpha04 выпускается. Версия 1.0.0-Alpha04 содержит эти коммиты.

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

  • ObservableStateStore теперь сообщает слушателям, когда ключ тоже удаляется.
  • Мы добавили версию схемы рендеринга и шкалу шрифтов в DeviceParameters (которые можно использовать для условного создания макетов в ответ на различные версии и настройки шрифта).
  • Мы добавили поддержку для анимации значений DynamicInt32 ( I05485 )
  • Мы добавили триггеры OnLoad и OnConditionalMet . Они могут быть использованы для запуска анимации, которые поддерживают триггер.
  • Мы добавили веса макета для расширенных размеров и размера мин для оберщенных размеров.
  • Мы добавили продолжительность и мгновенные динамические типы. Они могут быть использованы для представления временного мгновения или продолжительности в динамическом выражении.
  • Мы добавили поддержку AnimatedVectorDrawable и SeekableAnimatedVectorDrawable как ресурсы макета.

API меняется

  • Данные датчика требуют API 29+. ( I8099e )
  • Мы добавили два вспомогательных метода launchAction (для запуски).

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

  • Переименовать set/getSpec для set/getAnimationSpec в анимации Tiles ( i3d74b )

Версия 1.0.0-Alpha03

8 февраля 2023 года

androidx.wear.protolayout:protolayout-*:1.0.0-alpha03 . Версия 1.0.0-Alpha03 содержит эти коммиты.

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

  • Мы добавили toByteArray() и fromByteArray() к динамическим типам в библиотеке ProtoLayout-Express.
  • Мы добавили toString() к динамическим типам в библиотеке ProtoLayout-Expression.
  • Мы добавили поддержку оценки для динамических типов. Класс DynamicTypeEvaluator из библиотеки ProtoLayout-Expression-Pipeline может использоваться для оценки (и получения обновленных значений) для ранее создания динамического типа ( DynamicString , DynamicFloat ,…)
  • Когда анимации нельзя воспроизводить (потому что они отключены оценщиком, или количество запущенных анимаций достигло установленного предела), статические значения, установленные на анимируемом узле, будут использоваться для замены анимации.

Версия 1.0.0-Alpha02

25 января 2023 года

androidx.wear.protolayout:protolayout:1.0.0-alpha02 , androidx.wear.protolayout:protolayout-expression:1.0.0-alpha02 и androidx.wear.protolayout:protolayout-proto:1.0.0-alpha02 . Версия 1.0.0-Alpha02 содержит эти коммиты.

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

  • Строители макета от androidx.wear.tiles:tiles переходят на androidx.wear.protolayout:protolayout . Те, кто в androidx.wear.tiles:tiles будут устареть в одном из следующих альфа -выпусков.

Версия 1.0.0-Alpha01

11 января 2023 года

androidx.wear.protolayout:protolayout-expression:1.0.0-alpha01 и androidx.wear.protolayout:protolayout-proto:1.0.0-alpha01 . Версия 1.0.0-Alpha01 содержит эти коммиты.

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

  • Этот релиз представляет новую библиотеку «выражение протоалаута» для создания выражений из динамических переменных.