wear protolayout

  
此库允许定义一组将在远程 surface 上渲染/评估的界面布局和非界面表达式。
最近更新时间 稳定版 候选版 Beta 版 Alpha 版
2024 年 8 月 7 日 1.2.0 - - -

声明依赖项

如需添加 wear-protolayout 的依赖项，您必须将 Google Maven 制品库添加到项目中。如需了解详情，请参阅 Google 的 Maven 制品库。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

Groovy

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

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

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

Kotlin

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

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

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

如需详细了解依赖项，请参阅添加 build 依赖项。

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对此库有任何改进建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

1.2 版

版本 1.2.0

2024 年 8 月 7 日

发布了 androidx.wear.protolayout:protolayout-*:1.2.0。1.2.0 版包含。这些提交内容。

自 1.1.0 以来的重要变更

  • FontStyle 已更新，可为变量轴提供额外的字体支持，并提供更好的字体选择 API 来支持即将推出的 Flex 字体。
  • 其他修饰符支持： <ph type="x-smartling-placeholder">
      </ph>
    • 转换修饰符，提供平移、旋转和缩放功能（有或没有动画）。
    • 为每个角半径指定不同的值（水平和垂直）。
  • 通过将任何使用 Clickable 修饰符的元素的可点按区域扩展到至少 48dp 的 48dp，改进了所有触摸目标的可访问性。
  • 通过添加 setResponsiveContentInsetEnabled 改进了 PrimaryLayout 和 EdgeContentLayout，以便更好地支持这些布局在不同屏幕尺寸上的响应行为，并提高功能块的一致性。
  • 针对 Android 14 的非线性字体缩放，改进了 Material Text 的缩放/非缩放功能。
  • 改进了对所有弧形元素上的 RTL 布局方向支持。

其他更改

  • 如需了解 1.1.0 版中引入的一系列更完整的变更，请参阅 beta01 版本说明。

版本 1.2.0-rc01

2024 年 7 月 24 日

发布了 androidx.wear.protolayout:protolayout-*:1.2.0-rc01。版本 1.2.0-rc01 中包含这些提交内容。

bug 修复

  • 我们修复了标准的 Material Chip，因此仅当没有传入主标签或次级标签时，才能将其用作图标。(Iceef9)
  • 更新了 Material 布局文档，添加了相关页面的视觉效果，以便您更轻松地理解布局。（I0256a）

版本 1.2.0-beta01

2024 年 7 月 10 日

发布了 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 已更新，提供额外的字体支持，如下所示： <ph type="x-smartling-placeholder">
      </ph>
    • 设置不同的字体变体设置，例如 FontSetting.weight 和 FontSetting.width
    • 为所有数字字符设置相同的宽度 - 表格数字（FontSetting.tnum 字体功能设置）
    • 改进了字体选择 API，通过指定要使用的首选字体系列名称来支持即将推出的 Flex 字体。
  • 扩展了 Corner 修饰符，支持使用单独的水平值和垂直值指定每个 CornerRadius，从而允许具有不对称角的建筑物元素。
  • 添加了新的 Transformation 修饰符，提供 LayoutElement 的平移、旋转和缩放功能。您可以使用动态值为这些转换添加动画效果。
  • 向所有弧形元素（Arc、ArcLine 和 ArcText）添加了带有 Clockwise、CounterClockwise 和 Normal 选项的 setArcDirection，以更好地支持不同布局方向（例如 LTR 和 RTL）。
  • 将使用 Clickable 修饰符的任何元素的可点按区域延长到至少 48dp 48dp，改进了所有触摸目标的可访问性。
  • 通过添加 setResponsiveContentInsetEnabled 改进了 PrimaryLayout 和 EdgeContentLayout，以便更好地支持这些布局在不同屏幕尺寸上的响应行为，并提高功能块的一致性。添加了 linter 警告，以建议使用这些 API 并进行快速修复。
  • 针对 Android 14 的非线性字体缩放，改进了 Material Text 的缩放/非缩放功能。

API 变更

  • 移除了默认字体系列名称 (DEFAULT_SYSTEM_FONT)，因为它暗示了不使用 preferredFontFamilies API。（I39dab）
  • 传入 FontSetting.width 的参数应为正数。（I1266f）

版本 1.2.0-alpha05

2024 年 6 月 26 日

发布了 androidx.wear.protolayout:protolayout-*:1.2.0-alpha05。版本 1.2.0-alpha05 中包含这些提交内容。

新功能

  • 向 Material.CompactChip 添加了 hasText 方法，用于检查是否已设置文本内容。（I6e8fc）

API 变更

  • FontFamily 常量已移至 FontStyle，而不是其 Builder 类中。（I06ced）
  • 更新 FontSetting.weight 和 FontSetting.width API 以包含 Range 注解，并将 weight 的形参更改为 int。（Ia726c）

bug 修复

  • Material 库中的不可缩放文本现在可以在 Android 14 的非线性字体缩放中正常运行。（I6601e）

版本 1.2.0-alpha04

2024 年 5 月 29 日

发布了 androidx.wear.protolayout:protolayout-*:1.2.0-alpha04。版本 1.2.0-alpha04 包含这些提交内容。

API 变更

  • 添加了非对称边角 API，以便能够使用 2 个值单独指定每个角的半径。（Icbd69）
  • 扩展了 FontSetting API，使其包含： <ph type="x-smartling-placeholder">
      </ph>
    • 字体功能设置，例如将字体设置为表格。(If12b7)
    • 字体变体设置，例如为可变字体设置自定义宽度。（I2b36d）
  • 向 FontStyle 添加了字体系列 API，以允许指定应使用的字体系列的顺序列表。（Iba9f5）
  • Material 的 LayoutDefaults 中内容和次级标签之间的空间高度常量已重命名，这些常量最初以“Edge content”为前缀，现在更加通用，因为它们可以同时应用于 PrimaryLayout 和 EdgeContentLayout。（I4dc32）

bug 修复

  • 将变量字体轴的命名方式从 axisName 重命名为了 axisTag。（I02ba3）

版本 1.2.0-alpha03

2024 年 5 月 14 日

发布了 androidx.wear.protolayout:protolayout-*:1.2.0-alpha03。版本 1.2.0-alpha03 中包含这些提交内容。

新功能

  • 添加了用于为 FontStyle 设置自定义权重值的 API。（I7390a）

bug 修复

  • 修复了由于目标映射为空而导致的 getTouchDelegateInfo 失败问题。（I2accf）

版本 1.2.0-alpha02

2024 年 5 月 1 日

发布了 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）

bug 修复

  • 修复了初始化期间可能存在重复平台数据的问题。(Iba0fd)
  • 在 DynamicDataNode 中引入了一个新的 getter，用于检索节点费用。获取动态节点配额时会用到此费用。目前，具有固定值的节点的费用将为 0，所有其他节点的费用将为 1。（Ia33e1）
  • 从 NO_OP_QUOTA_MANAGER 中移除了计数逻辑。（Ib50b8）
  • 我们添加了 lint 规则，以便在没有 setResponsiveContentInsetEnabled 的情况下使用 PrimaryLayout 时报告警告，并提供快速修复。（I12025）
  • 动态表达式节点的数量有限制。(Iffae8)

版本 1.2.0-alpha01

2024 年 3 月 6 日

发布了 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 setter，以更好地与用户体验准则保持一致，并将主标签放置在顶部的固定位置以及为标签进行自适应插入，确保功能块的一致性。（I60175）
  • 我们添加了 PrimaryLayout.setResponsiveContentInsetEnabled，用于向此布局中的主标签、次级标签和底部条状标签添加自适应边衬区，以免内容离开屏幕边缘。（I0c457）
  • 添加了从 CircularProgressIndicator 移除外边距的方法，以便将其用作较小的组件。（I55c06）

API 变更

  • 现在，默认情况下，功能块渲染程序会排除所有文本元素的字体内边距，且不提供包含内边距的选项。（I3e300）

bug 修复

  • 修复了在文本上使用省略号、字母间距和居中对齐时的文本对齐问题。（I716c7）
  • 添加了针对 skia 弧形绘制问题的解决方法。（I08f09）
  • 修复了 RTL 布局的 ArcLine 绘制方向。（I6c141）

版本 1.1

版本 1.1.0

2024 年 2 月 7 日

发布了 androidx.wear.protolayout:protolayout-*:1.1.0。版本 1.1.0 中包含这些提交内容。

自 1.0.0 以来的重要变更

  • ArcLine 中的渐变支持，并且能更好地表示大于 360 度的长度。
  • 日期时间格式支持动态数据类型的不同时区。
  • 改进了文本自动调整大小和省略号选项，用于处理截断的文本。
  • 分隔符支持带有可选重量的展开后尺寸。
  • 针对所有 ProtoLayout API 的架构版本要求注释。
  • 已将目标区域扩展到任何 Clickable 元素，扩展至 48 dp x 48 dp，以满足无障碍功能要求。
  • 字体内边距默认处于关闭状态，并且是所有文本元素和包含文本的 Material 组件的唯一行为。

其他更改

  • 如需了解 1.1.0 版中引入的一系列更完整的变更，请参阅 beta01 版本说明。

版本 1.1.0-rc01

2024 年 1 月 24 日

发布了 androidx.wear.protolayout:protolayout-*:1.1.0-rc01。版本 1.1.0-rc01 中包含这些提交内容。

bug 修复

  • 启用更新后，PlatformTimeUpdateNotifierImpl 会立即生效。（I77145）
  • 修复了 RTL 布局的 CircularProgressIndicator。从现在开始，在任何情况下都将按顺时针方向发展。（I95ee3）
  • 添加了针对 skia 弧形绘制问题的解决方法。（I08f09）

版本 1.1.0-beta01

2024 年 1 月 10 日

发布了 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 添加阴影，并通过在现有 StrokeCap 上添加 Shadow，在上限上添加阴影，以便更好地表示大于 360 度的长度。
  • DynamicInstant 支持时区日期时间格式。DynamicInstant 和 DynamicDuration 可用作状态或平台数据类型。
  • 文字大小自动调整功能，支持将多个大小设为 FontStyle.setSizes，其中文字大小会根据其在父项中的空间自动调整。此外，我们还通过添加 TEXT_OVERFLOW_ELLIPSIZE 并废弃了 TEXT_OVERFLOW_ELLIPSIZE_END，改进了溢出文本的省略效果选项。
  • Spacer 现在支持使用具有可选重量的展开后尺寸。为了构建 ExpandedDimensionProp，我们添加了一个辅助方法 DimensionBuilders.weight。
  • 支持使用 Modifier.visible 动态隐藏和取消隐藏布局元素。这包括在 BoolProp 中使用动态价值。
  • 现在，所有 ProtoLayout API 都包含架构版本要求注释，您可以在调用新版 API 之前检查版本。
  • 现在，每个具有 Clickable 的元素在渲染程序中的目标区域至少为 48x48，以更好地支持无障碍功能要求。
  • 为了遵循其他 Material 组件和 Compose 举措，我们现在已默认在所有 Text 元素上关闭字体内边距。此外，AndroidTextStyle 和相关 setter 已从公共 API 中移除。 修复了以下 bug：
  • 在 EdgeContentLayout 中添加了一个 setter，用于定位边缘内容，使其可在其他内容之前放置。
  • 在遇到无法识别的枚举值时持续抛出异常。
  • 当表达式生成无效数值（NaN 或无限）或抛出 ArithmeticException 时，使该表达式的结果失效。

API 变更

  • 更新了 SweepGradient API，以允许在构造函数中接受颜色或 ColorStops。（I6676f）

bug 修复

  • 添加了受限的 API 和渲染程序支持，用于设置 arc 元素的绘制方向。（Idef5a）
  • 如果未指定，RoundMode 会在 FloatToInt32Node 中默认为 Floor。如果无法识别所提供的 RoundMode，节点仍会抛出异常。（I1b2d8）

版本 1.1.0-alpha04

2023 年 12 月 13 日

发布了 androidx.wear.protolayout:protolayout-*:1.1.0-alpha04。版本 1.1.0-alpha04 中包含这些提交内容。

新功能

  • VersionInfo 类未实现 Comparable 接口。（I8d13c）
  • 渲染程序现在支持 TEXT_OVERFLOW_ELLIPSIZE 选项。（I7f085）

API 变更

  • 文本溢出选项 TEXT_OVERFLOW_ELLIPSIZE_END 现已废弃。请使用行为非常相似的新 API TEXT_OVERFLOW_ELLIPSIZE。（I822d8）
  • 为了遵循其他 Material 组件和 Compose 举措，我们现在已默认关闭所有 Text 元素的字体内边距。此外，AndroidTextStyle 和相关 setter 已从公共 API 中移除。（I79094、Ib0b03、I32959、Iaf7d5、Ifa298、I0a4ae、Ida9d3）
  • Modifier.hidden 已替换为 Modifier.visible。(I56902)
  • FontStyle#setSizes 现在接受 int 参数，而不是 SpProp 参数。（I02b37）

bug 修复

  • 遇到未定义或无法识别的枚举值时抛出异常。（I9d2cf）
  • 重构了 DynamicTypeBindingRequest。（I27b57）
  • 当表达式生成无效数值（NaN 或无限）或抛出 ArithmeticException 时，使该表达式的结果失效。（I681ae）

版本 1.1.0-alpha03

2023 年 11 月 29 日

发布了 androidx.wear.protolayout:protolayout-*:1.1.0-alpha03。版本 1.1.0-alpha03 中包含这些提交内容。

新功能

  • 添加了对动态隐藏/取消隐藏布局元素的实验性支持 (I64a78)
  • 向 BoolProp 添加了动态值支持 (I2fe96)
  • 向 ProtoLayout API 添加了架构版本要求注解 (I0f03c)
  • 使用 TextOverflow 中的新选项扩展 API，以便在未达到行数上限（但文本空间不足）时，省略固定父级容器中的文本。（I110a9）
  • 添加了辅助方法 DimensionBuilders.weight，用于构建具有权重的 ExpandedDimensionProp。（I4f72b）
  • DynamicInstant 和 DynamicDuration 可用作状态或平台数据类型。（I6819f）

API 变更

  • 更新了 API 以隐藏 DynamicZonedDateTime 并将其所有操作移至 DyanamicInstant。(I34b94)
  • 分隔符现在支持使用较大尺寸作为宽度/高度。（Ie7c94）
  • 在渲染程序中支持点击目标区域扩展 (I39c79)

版本 1.1.0-alpha02

2023 年 11 月 15 日

发布了 androidx.wear.protolayout:protolayout-*:1.1.0-alpha02。版本 1.1.0-alpha02 中包含这些提交内容。

新功能

  • 向 API 添加了 ArcLine StrokeCap Shadow 字段。（I830ec）
  • 扩展 API，以便能够指定要展开的分隔符的宽度或高度。（I757ca）
  • 我们添加了一个实验性 API，用于根据文本在父项中的空间自动调整文本大小。（Ibbe63）
  • 支持最小可点击尺寸 (I178e3)
  • 为 StrokeCap Shadow 添加了渲染程序支持。（I48b17）
  • 在 ArcLine 中添加了对清除渐变的渲染程序支持。（I4d5bb）

版本 1.1.0-alpha01

2023 年 10 月 18 日

发布了 androidx.wear.protolayout:protolayout-*:1.1.0-alpha01。版本 1.1.0-alpha01 中包含这些提交内容。

新功能

  • 向 Arcline 添加了画笔选项，支持 SweepGradient。（Ie7ce3）
  • 添加了对时区的日期时间格式的支持。(Ibfae0)
  • 添加了区域日期时间格式设置所需的 proto 和 java 封装容器。（I97126）
  • 添加了 getter，用于读回存储在 DynamicDataValue 中的值。（Ie6cea）
  • 在 EdgeContentLayout 中添加了一个 setter，用于定位边缘内容，使其可在其他内容之前放置。（Ie8e8a）

bug 修复

  • 修复了具有多个时间数据源注册的表达式未立即更新的问题。（I8e1a8）
  • 修复了差异更新期间使根元素居中的 bug。（Ie48f7）
  • 不会再忽略未设置（或为空）的布局约束条件值。（Ibc785）
  • 缩短了从布局变为可见到其流水线节点初始化之间的延迟时间。（I38d4e）

版本 1.0

版本 1.0.0

2023 年 8 月 9 日

发布了 androidx.wear.protolayout:protolayout-*:1.0.0。版本 1.0.0 中包含这些提交内容。

1.0.0 的主要功能

ProtoLayout 库引入了一些 API，用于创建可在不同 Wear OS Surface 中使用的布局和表达式。例如，Tiles 库使用这些 API 来支持平台数据绑定（以便更快地更新图块数据）和动画。

版本 1.0.0-rc01

2023 年 7 月 26 日

发布了 androidx.wear.protolayout:protolayout-*:1.0.0-rc01。版本 1.0.0-rc01 中包含这些提交内容。

  • 如需从 Tiles 迁移到 ProtoLayout，请按照此处的说明进行操作。

API 变更

  • 我们从 Arc 元素中移除了 setLayoutConstraintForDynamicAnchorAngle 和 getLayoutConstraintForDynamicAnchorAngle 方法。这些方法是误添加的，它们对提供的布局没有任何影响。（If7d01）
  • 我们已将 ProtoLayout 布局的最大深度限制为 30 个嵌套的 LayoutElements。（I8a74b）

bug 修复

  • 我们添加了一项检查，如果为 SpanText 设置了 DynamicColor，则会抛出。（I0e5bc）
  • 澄清了 DAILY_CALORIES 数据源单位为千卡。（Iaa785）

版本 1.0.0-beta01

2023 年 6 月 21 日

发布了 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）

bug 修复

  • 更新了包含动态字段的 Prop 消息，改为使用 oneof (I81739)
  • 针对具有 setter 的过载重复使用 setter 实现 (Ied70c)
  • 在具有过载的 setter 中正确记录指纹 (I86ed2)

版本 1.0.0-alpha11

2023 年 6 月 7 日

发布了 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 接口已替换为 protolayout-expression-pipeline 库中的 PlatformTimeUpdateNotifier，后者用于提供更新时间数据所需的频率。（I60869）
  • 将 PlatformDataProvider 中的 register/unregisterForData 重命名为了 set/clearReceiver (I14b02)
  • 在 Material Text 中，getExcludeFontPadding 已重命名为 hasExcludeFontPadding。（Iea01d）
  • 向所有条状标签组件添加了用于完美对齐标签的 setter。现在，所有条状标签都应用了最低的可点按目标。（I8ae92）
  • LayoutDefaults#BUTTON_MAX_NUMBER 已重命名为 MAX_BUTTONS。（I84788）
  • 将 DAILY_DISTANCE 重命名为 DAILY_DISTANCE_M。（I4f758）

bug 修复

  • 更新了 Prop 类型文档，以阐明强制执行静态值的原因。指定在未提供静态值时使用的默认值。（I155aa）
  • PlatformDataKey 命名空间应遵循 Java 样式命名。（I47bda）

版本 1.0.0-alpha10

2023 年 5 月 24 日

发布了 androidx.wear.protolayout:protolayout-*:1.0.0-alpha10。版本 1.0.0-alpha10 中包含这些提交内容。

新功能

  • 添加了用于访问应用推送状态的 AppDataKey；添加了用于访问平台数据的 PlatformDataKey；在 StateStore 中添加了命名空间支持。（I7985e）
  • 支持对 DynamicBool 执行 Equal 和 NotEqual 操作。（I6a0c1）

API 变更

  • FontStyles 类现已最终确定 (Iaa2ea)
  • 已弃用 LayoutElementBuilders#FontStyles。请使用 androidx.wear.protolayout.Typography 或创建自己的FontStyle。（Ic929b）
  • 在 Action 接口中隐藏 Action#Builder 嵌套接口。Builder 的实现已由 LoadAction 和 LaunchAction 类提供。（I1d70c）
  • 允许将 DynamicFloat 与 FloatProp 搭配使用。请注意，FloatProp 不需要布局约束条件，因为它不用作布局更改属性。（I286ac）
  • LoalAction 和 SetStateAction 操作已被移除，因为它们目前尚不受支持。（I5d6a6）
  • 为内嵌图片资源添加了对 ARGB_8888 格式的支持。（I8a07c）
  • 将 StateEntryValue 重命名为 DynamicDataValue，并更新状态 API 以使用 DynamicDataKey (If1c01)
  • 为了确保 StateStore 的每个实例都能妥善控制和控制内存用量和状态更新时间，我们限制了 StateStore 中允许的条目数量。因此，开发者需要确保其映射中的条目不超过 MAX_STATE_ENTRY_COUNT 个，否则在创建或更新 StateStore 时会收到 IllegalStateException。（Ibadb3）
  • 隐藏 OnLoadTrigger 和 OnConditionMetTrigger 类，并将 OnConditionMetTrigger 的 setTrigger 重命名为 setCondition。（Ibf629）
  • 出于性能和兼容性方面的原因，ProtoLayout 渲染程序不支持 AnimatedVectorDrawable 资源中的全套功能。在能够定义受支持的 API 集之前，我们会将这些 API 标记为实验性 API。（Ic6daf）
  • 添加了每日距离、每日卡路里和每日楼层数的动态类型。平台运行状况来源的键现在位于 PlatformHealthSources.Keys 下 (Ib7637)
  • Easing.cubicBezier 方法取代了 CubicBezierEasing.Builder。这样一来，EasingFunction 类已被移除，该类中的加/减速常量现在可以直接通过 Easing 接口访问。此外，setInfiniteRepeatable 已被 INFINITE_REPEATABLE_WITH_RESTART 和 INFINITE_REPEATABLE_WITH_REVERSE 取代 (Ib41e7)
  • 实现 PlatformDataProvider 以提供心率和每日步数。从公共 API 中移除了 SensorGateway 接口。（I55b84）
  • 添加了 PlatformDataProvider，并更新 StateStore 以在表达式流水线中的节点需要提供程序支持的键时注册到 PlatformDataProvider。（Ib616a）
  • SensorGateway 不再 Closeable，因为它不再保留任何状态。（I6b4f7）
  • 允许将“FloatProp”与“DynamicFloat”用于“CircularProgressIndicator”中的进度。支持版本 1.2 的渲染器支持此功能。旧版渲染程序将回退到 staticValue（如果提供），否则回退到 0 (I0d91b)
  • MultiButtonLayout 常量已重构为 LayoutDefaults.MultiButtonLayoutDefaults 类，该类现在包含的按钮大小取决于布局中的按钮数量。（I13973）
  • 支持在 Material Text 中将 StringProp 与 DynamicString 搭配使用。支持版本 1.2 的渲染器支持此功能。旧版渲染程序将回退到提供的静态值。将 Text#getText 返回值类型从 String 更新为 StringProp。（I7275b）

版本 1.0.0-alpha09

2023 年 5 月 10 日

发布了 androidx.wear.protolayout:protolayout-*:1.0.0-alpha09。版本 1.0.0-alpha09 中包含这些提交内容。

新功能

  • 我们添加了一个实验性的扩展程序布局元素。请注意，此属性无法默认使用，并且需要能够理解布局元素的渲染程序扩展程序。（I6581d）
  • 添加了对 ArcLine 的 StrokeCap 支持。（I94951）
  • 添加了对条件即时操作的支持。（I489a7）
  • 添加了对条件持续时间操作的支持。（Iab469）
  • 添加了对从秒创建时长的支持。（Ib5fa1）

API 变更

  • 从 DynamicTypeEvaluator 中移除了 enable/disablePlatformSource 方法。调用方应负责更新。（I78c6d）
  • 允许限制绑定数据类型的大小。（Ie2966）
  • 添加了对 protolayout-material 中动态内容说明的支持。（I62c8e）
  • 对 AnimationParameters 中的时长和延迟使用 long 和 @IntRange。（I388b6）

版本 1.0.0-alpha08

2023 年 4 月 19 日

发布了 androidx.wear.protolayout:protolayout-*:1.0.0-alpha08。版本 1.0.0-alpha08 中包含这些提交内容。

新功能

  • AndroidTextStyle已添加到“LayoutElementBuilders”。（I8d967）
  • 我们添加了对在 ProtoLayout Material Text 中设置排除字体内边距的支持。（I17f5d）
  • 内嵌图片现在支持 ARGB_8888。（I18c1e）
  • DynamicColor 现在支持 onCondition 操作。（I10927）

API 变更

  • 支持反向动画的自定义时长 (I3251f)
  • 我们添加了 SemanticDescription 修饰符。此外，ContentDescription 不可绑定。（I3f1d）
  • DynamicBool.isFalse() 方法现已替换为 DynamicBool.negate()，并移除了 DynamicBool.isTrue()。除了 NaN DynamicFloat 值以及将 DynamicInt32 范围缩小为 DynamicFloat 之外，现在还会发出无效的动态结果。（I6ac1e）
  • Int 和浮点型格式设置工具现在使用构建器模式。（Ieb213）

bug 修复

  • 已从可生成动画的字段中移除后备静态值。(Ifcb01)
  • 移除了 DynamicTypeValueReceiver#onPreUpdate。（I2dc35）
  • 动态表达式中的字符串长度现在设有上限。（I4c93）
  • Gradle 依赖项现在可以根据需要正确设置为 api，而不是 implementation。(I40503)

版本 1.0.0-alpha07

2023 年 4 月 5 日

发布了 androidx.wear.protolayout:protolayout-*:1.0.0-alpha07。版本 1.0.0-alpha07 中包含这些提交内容。

新功能

  • 向 StringProp 添加了动态价值支持 (I04342)
  • 标记可绑定的布局元素 (Ia110b)

API 变更

  • 在 Consumer 中，sensorGateway#registerSensorGatewayConsumer 接受数据类型（而不是方法）作为参数。（Icf314）
  • ObservableStateStore 已重命名为 StateStore。（Ieb0e2）
  • 添加了 DynamicTypeEvaluator.Builder 而不是构造函数参数，以允许更多可选参数，包括 ObservableStateStore 现在默认为空存储区。（I6f832）
  • 重构了 DynamicTypeEvaluator 中参数的顺序。（Ic1ba4）

bug 修复

  • 正确地将信号从平台传感器来源传播到下游节点 (I5a922)

版本 1.0.0-alpha06

2023 年 3 月 22 日

发布了 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)

bug 修复

  • 添加了 FloatNodesTest (Id7281)
  • 修复了无法加载结构化位图时渲染程序崩溃的问题。

版本 1.0.0-alpha05

2023 年 3 月 8 日

发布了 androidx.wear.protolayout:protolayout-*:1.0.0-alpha05。版本 1.0.0-alpha05 中包含这些提交内容。

新功能

  • 我们添加了实验性“内容更新”为 Modifiers 对象添加动画效果。每当元素（带有此修饰符）或其某个子元素在布局更新期间发生更改时，就会触发此动画。（bd03e5d）

API 变更

  • 向 Repeatable 添加了 forwardRepeatDelayMillis 和 reverseRepeatDelayMillis。我们还将 AnimationSpec 中的 delayMillis 重命名为 startDelayMillis (Ifb266)
  • DynamicTypeEvaluator.bind 方法现在接受执行器。（I346ab）
  • 我们向 BoundDynamicType 添加了 startEvaluation 方法，以便在绑定动态类型后触发评估。（I19908）

bug 修复

  • Animator 对象将重复用于单个元素的后续动画。（Ia3be9）

版本 1.0.0-alpha04

2023 年 2 月 22 日

发布了 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 辅助方法（用于启动 activity）。

bug 修复

  • 在功能块动画中，将 set/getSpec 重命名为 set/getAnimationSpec (I3d74b)

版本 1.0.0-alpha03

2023 年 2 月 8 日

发布了 androidx.wear.protolayout:protolayout-*:1.0.0-alpha03。版本 1.0.0-alpha03 中包含这些提交内容。

新功能

  • 我们在 protolayout-express 库中为动态类型添加了 toByteArray() 和 fromByteArray()。
  • 我们在 protolayout-expression 库中为动态类型添加了 toString()。
  • 我们添加了对动态类型的评估支持。protolayout-expression-pipeline 库中的 DynamicTypeEvaluator 类可用于评估之前创建的动态类型（DynamicString、DynamicFloat…）并接收相关的更新值
  • 当动画无法播放时（可能是由于评估器已停用动画，或由于正在运行的动画数量已达到设定的上限），系统会使用基于可呈现动画效果的节点设置的静态值来替换动画。

版本 1.0.0-alpha02

2023 年 1 月 25 日

发布了 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。在下一 Alpha 版中，androidx.wear.tiles:tiles 中的布局构建器将被废弃。

版本 1.0.0-alpha01

2023 年 1 月 11 日

发布了 androidx.wear.protolayout:protolayout-expression:1.0.0-alpha01 和 androidx.wear.protolayout:protolayout-proto:1.0.0-alpha01。版本 1.0.0-alpha01 中包含这些提交内容。

新功能

  • 此版本引入了用于从动态变量创建表达式的一个名为“ProtoLayout Expression”的新库。