wear protolayout

  
此库允许定义一组将在远程 Surface 上呈现/评估的界面布局和非界面表达式。
最近更新时间 稳定版 候选版 Beta 版 Alpha 版
2024 年 11 月 13 日 1.2.1 - - 1.3.0-alpha04

声明依赖项

如需添加 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.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"
}

Kotlin

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")
}

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

反馈

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

创建新问题

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

版本 1.3

版本 1.3.0-alpha04

2024 年 11 月 13 日

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

新功能

  • 将 Material3 形状更新为包含用于存储实际 Corner 值的字段的类，与 Wear Compose 中的类一样。(Ied8cd)
  • 更新了 Material3 颜色，以包含 ColorScheme 概念，与 Wear Compose 中的颜色相同。(If645e)
  • 向测试库添加了多个常用的匹配器。(Ie5cec)

版本 1.3.0-alpha03

2024 年 10 月 30 日

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

新功能

  • 向测试库添加了 LayoutElementAssertionsProvider、LayoutElementAssertion 和 LayoutElementMatcher (Id1110)

版本 1.3.0-alpha02

2024 年 10 月 16 日

发布了 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。将 androidx.wear.protolayout:protolayout-proto 和 androidx.wear.protolayout:protolayout-external-protobuf 的 1.3.0-alpha01 版本依赖项升级到 1.3.0-alpha02，以解决漏洞风险。

外部贡献

版本 1.3.0-alpha01

2024 年 10 月 2 日

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

bug 修复

  • 阐明了 Roboto 和 Roboto Flex 字体系列名称的可用性取决于设备。(I193be)
  • 在 AndroidX 功能块渲染程序中启用了 Roboto Flex 字体系列。(I08e94)

版本 1.2

版本 1.2.1

2024 年 10 月 16 日

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

2024 年 8 月 7 日

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

自 1.1.0 以来的重要变更

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

其他更改

版本 1.2.0-rc01

2024 年 7 月 24 日

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

bug 修复

  • 我们修复了标准 Material 条状标签，因此只有在未传入任何主标签或次要标签的情况下，它才能用作图标。(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 已更新为支持以下其他字体：
    • 设置不同的字体变体设置，例如 FontSetting.weight 和 FontSetting.width
    • 为所有数字字符设置相同的宽度 - 表格数字（FontSetting.tnum 字体功能设置）
    • 改进了字体选择 API，通过指定要使用的首选字体系列名称来支持即将推出的 Flex 字体。
  • 扩展了 Corner 修饰符，以支持使用单独的水平和垂直值指定每个 CornerRadius，从而允许构建具有不对称角落的元素。
  • 添加了新的 Transformation 修饰符，用于对 LayoutElement 进行平移、旋转和缩放。您可以使用动态值为这些转换添加动画效果。
  • 向所有弧形元素（Arc、ArcLine 和 ArcText）添加了带有 Clockwise、CounterClockwise 和 Normal 选项的 setArcDirection，以便更好地支持不同的布局方向（例如 LTR 和 RTL）。
  • 通过将使用 Clickable 修饰符的任何元素的可点按区域扩大到至少 48dp x 48dp，提高了所有触摸目标的无障碍功能。
  • 通过添加 setResponsiveContentInsetEnabled 改进了 PrimaryLayout 和 EdgeContentLayout，以更好地支持这些布局在不同屏幕尺寸下的响应式行为，并改进了功能块的一致性。添加了 lint 警告，以建议使用这些 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 const 已移至 FontStyle，而不是其构建器类。(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，以添加以下内容：
    • 字体功能设置，例如将字体设置为表格。(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)
  • 已从 ArcModifiers 中移除用于转换的 API，因为它们不支持该功能 (Ic0827)
  • ArcDirectionProp 构建器现在需要在构造函数中提供值。(I76ada)
  • PlatformDataValues.Builder.putAll 方法允许将一个 PlatformDataValue 合并到另一个 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，以满足无障碍功能要求。
  • 字体内边距默认处于关闭状态，是所有包含文本的 Text 元素和 Material 组件中的唯一行为。

其他更改

版本 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 和渲染程序支持，用于设置弧形元素的绘制方向。(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 计划保持一致，我们现在默认会为所有文本元素关闭字体内边距。此外，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)
  • Spacer 现在支持宽度/高度的展开尺寸。(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，以便指定要展开的 Spacer 的宽度或高度。(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)
  • 添加了用于读回 DynamicDataValue 中存储的值的 getter。(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 库引入了用于创建可在不同 Wear OS Surface 上使用的布局和表达式的 API。例如，功能块库使用这些 API 来支持平台数据绑定（以更快地更新功能块数据）和动画。

版本 1.0.0-rc01

2023 年 7 月 26 日

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

  • 如需从功能块迁移到 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)
  • protolayout-expression-pipeline 库中的 TimeGateway 接口已替换为 PlatformTimeUpdateNotifier，后者可提供所需的更新时间数据的频率。(I60869)
  • 将 PlatformDataProvider 中的 register/unregisterForData 重命名为 set/clearReceiver (I14b02)
  • 在 Material Text 中，getExcludeFontPadding 已重命名为 hasExcludeFontPadding。(Iea01d)
  • 为所有条状标签组件添加了用于完美对齐标签的设置器。现在，所有条状标签都已应用最小可点按目标。(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 嵌套接口。LoadAction 和 LaunchAction 类已提供 Builder 的实现。(I1d70c)
  • 允许在 FloatProp 中使用 DynamicFloat。请注意，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)
  • 允许在 CircularProgressIndicator 中将 FloatProp 与 DynamicFloat 搭配使用以显示进度。支持版本 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 变更

  • enable/disablePlatformSource 方法已从 DynamicTypeEvaluator 中移除。调用方应负责更新。(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 文本中设置排除字体内边距的支持。(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)

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 变更

  • 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 变更

  • 我们已将 forwardRepeatDelayMillis 和 reverseRepeatDelayMillis 添加到 Repeatable 中。我们还将 AnimationSpec 中的 delayMillis 重命名为 startDelayMillis (Ifb266)
  • DynamicTypeEvaluator.bind 方法现在接受 Executor。(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”的新库。