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 修饰符的元素的可点按区域扩展到至少 48dp48dp,改进了所有触摸目标的可访问性。
  • 通过添加 setResponsiveContentInsetEnabled 改进了 PrimaryLayoutEdgeContentLayout,以便更好地支持这些布局在不同屏幕尺寸上的响应行为,并提高功能块的一致性。
  • 针对 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.weightFontSetting.width
    • 为所有数字字符设置相同的宽度 - 表格数字(FontSetting.tnum 字体功能设置)
    • 改进了字体选择 API,通过指定要使用的首选字体系列名称来支持即将推出的 Flex 字体。
  • 扩展了 Corner 修饰符,支持使用单独的水平值和垂直值指定每个 CornerRadius,从而允许具有不对称角的建筑物元素。
  • 添加了新的 Transformation 修饰符,提供 LayoutElement 的平移、旋转和缩放功能。您可以使用动态值为这些转换添加动画效果。
  • 向所有弧形元素(ArcArcLineArcText)添加了带有 ClockwiseCounterClockwiseNormal 选项的 setArcDirection,以更好地支持不同布局方向(例如 LTR 和 RTL)。
  • 将使用 Clickable 修饰符的任何元素的可点按区域延长到至少 48dp 48dp,改进了所有触摸目标的可访问性。
  • 通过添加 setResponsiveContentInsetEnabled 改进了 PrimaryLayoutEdgeContentLayout,以便更好地支持这些布局在不同屏幕尺寸上的响应行为,并提高功能块的一致性。添加了 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.weightFontSetting.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”为前缀,现在更加通用,因为它们可以同时应用于 PrimaryLayoutEdgeContentLayout。(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 元素现在可以选择向其中添加 ArcDirectionClockwiseCounterclockwiseNormal)。将此行为添加到 ArcArcLineArcText 会修复它们在 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 支持时区日期时间格式。DynamicInstantDynamicDuration 可用作状态或平台数据类型。
  • 文字大小自动调整功能,支持将多个大小设为 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 中移除。(I79094Ib0b03I32959Iaf7d5Ifa298I0a4aeIda9d3
  • 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
  • DynamicInstantDynamicDuration 可用作状态或平台数据类型。(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 元素中移除了 setLayoutConstraintForDynamicAnchorAnglegetLayoutConstraintForDynamicAnchorAngle 方法。这些方法是误添加的,它们对提供的布局没有任何影响。(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 现在接受 DynamicDataKeyDynamicDataValue 的类型安全映射,而不是不安全的泛型。这意味着,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
  • CompactChipTitleChip 现在支持向其中添加图标。(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 执行 EqualNotEqual 操作。(I6a0c1

API 变更

  • FontStyles 类现已最终确定 (Iaa2ea)
  • 已弃用 LayoutElementBuilders#FontStyles。请使用 androidx.wear.protolayout.Typography 或创建自己的FontStyle。(Ic929b
  • Action 接口中隐藏 Action#Builder 嵌套接口。Builder 的实现已由 LoadActionLaunchAction 类提供。(I1d70c
  • 允许将 DynamicFloatFloatProp 搭配使用。请注意,FloatProp 不需要布局约束条件,因为它不用作布局更改属性。(I286ac
  • LoalActionSetStateAction 操作已被移除,因为它们目前尚不受支持。(I5d6a6
  • 为内嵌图片资源添加了对 ARGB_8888 格式的支持。(I8a07c
  • StateEntryValue 重命名为 DynamicDataValue,并更新状态 API 以使用 DynamicDataKey (If1c01)
  • 为了确保 StateStore 的每个实例都能妥善控制和控制内存用量和状态更新时间,我们限制了 StateStore 中允许的条目数量。因此,开发者需要确保其映射中的条目不超过 MAX_STATE_ENTRY_COUNT 个,否则在创建或更新 StateStore 时会收到 IllegalStateException。(Ibadb3
  • 隐藏 OnLoadTriggerOnConditionMetTrigger 类,并将 OnConditionMetTriggersetTrigger 重命名为 setCondition。(Ibf629
  • 出于性能和兼容性方面的原因,ProtoLayout 渲染程序不支持 AnimatedVectorDrawable 资源中的全套功能。在能够定义受支持的 API 集之前,我们会将这些 API 标记为实验性 API。(Ic6daf
  • 添加了每日距离、每日卡路里和每日楼层数的动态类型。平台运行状况来源的键现在位于 PlatformHealthSources.Keys 下 (Ib7637)
  • Easing.cubicBezier 方法取代了 CubicBezierEasing.Builder。这样一来,EasingFunction 类已被移除,该类中的加/减速常量现在可以直接通过 Easing 接口访问。此外,setInfiniteRepeatable 已被 INFINITE_REPEATABLE_WITH_RESTARTINFINITE_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 中将 StringPropDynamicString 搭配使用。支持版本 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
  • 添加了对 ArcLineStrokeCap 支持。(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 添加了 forwardRepeatDelayMillisreverseRepeatDelayMillis。我们还将 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)
  • 我们添加了 OnLoadOnConditionalMet 触发器。它们可用于启动支持触发器的动画。
  • 我们为较大尺寸添加了布局粗细,为封装尺寸添加了最小尺寸。
  • 我们添加了时长和即时动态类型。它们可用于在动态表达式中表示时间时刻或时长。
  • 添加了对 AnimatedVectorDrawableSeekableAnimatedVectorDrawable 作为布局资源的支持。

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 类可用于评估之前创建的动态类型(DynamicStringDynamicFloat…)并接收相关的更新值
  • 当动画无法播放时(可能是由于评估器已停用动画,或由于正在运行的动画数量已达到设定的上限),系统会使用基于可呈现动画效果的节点设置的静态值来替换动画。

版本 1.0.0-alpha02

2023 年 1 月 25 日

发布了 androidx.wear.protolayout:protolayout:1.0.0-alpha02androidx.wear.protolayout:protolayout-expression:1.0.0-alpha02androidx.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-alpha01androidx.wear.protolayout:protolayout-proto:1.0.0-alpha01版本 1.0.0-alpha01 中包含这些提交内容

新功能

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