wear protolayout

声明依赖项

要添加对 wear-protolayout 的依赖，必须将 Google Maven 仓库添加到您的项目中。有关更多信息，请参阅 Google's Maven repository。

在应用或模块的 build.gradle 文件中，为您需要的工件添加依赖项

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

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

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

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

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

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

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

反馈

您的反馈有助于改善 Jetpack。如果您发现新问题或有改进此库的想法，请告诉我们。在创建新问题之前，请查看该库的现有问题。您可以通过点击星标按钮为您支持的现有问题投票。

创建新问题

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

版本 1.4

版本 1.4.0

2026 年 3 月 25 日

androidx.wear.protolayout:protolayout-*:1.4.0 已发布。1.4.0 版本包含这些提交。

自 1.3.0 以来的重要变更

• 有关 1.3.0 以来的更改详情，请参阅 1.4.0-beta01 版本说明。

新功能

• Wear ProtoLayout 1.4.0-beta01 版本的发布表明该库的功能已完成，且 API 已锁定（标记为实验性的除外）。Wear ProtoLayout 1.4 包含以下新功能和 API：
  • 内联图像资源与性能改进： 引入了一种改进的资源处理概念，其中 ImageResource 可以直接内联在布局本身中。
  • Material3TileService： 引入了一个新的、对 Kotlin 友好的服务，用于创建卡片（Tiles）。它通过提供一个单一的挂起函数（suspend function）来返回卡片布局和资源，从而简化了开发。它会自动管理 MaterialScope 和 ProtoLayoutScope，以实现更好的资源处理和更快的卡片加载性能。
  • 卡片预览更新： 卡片预览工具已更新，支持新的 ProtoLayoutScope 自动资源处理，确保预览能够正确反映内联资源，无需额外配置。
  • 多项 Kotlin DSL 改进： 为 Tile 和构建卡片所需的所有其他 API（如 Timeline）添加了专门的 Kotlin 辅助工具，以改善 Kotlin 开发者的体验。
  • 动态服务切换： 引入了 METADATA_GROUP_KEY，允许开发者在清单文件中对多个 TileService 实例进行分组。这使得在新 OS 版本中，可以实现代表相同卡片的不同服务之间的动态切换。
  • 更新中的卡片 ID： 开发者现在可以在更新请求中指定特定的 tileId，从而更细致地控制刷新哪些卡片实例。
  • 提高编译 SDK 要求： 为了支持新的 Material3TileService 和高级资源处理，compileSdk 版本要求已提高至 35。
  • ANR 防护： 将卡片更新请求期间的解绑逻辑移至后台线程，以防止“应用程序无响应”（ANR）错误。
  • 针对心率数据的正确 RequiresPermission 注解： 从 API 36 开始，调用 PlatformHealthSources.heartRateBpm 或 PlatformHealthSources.heartRateAccuracy 需要向调用 App 授予 android.health.connect.HealthPermissions.READ_HEART_RATE 权限。

版本 1.4.0-rc02

2026 年 3 月 11 日

androidx.wear.protolayout:protolayout-*:1.4.0-rc02 已发布。1.4.0-rc02 版本包含这些提交。

API 变更

• 从 API 36 开始，访问心率数据（例如通过带有 PlatformHealthSources.heartRateBpm 和 PlatformHealthSources.heartRateAccuracy 的 ProtoLayout 表达式库）需要向调用 App 授予 android.health.connect.HealthPermissions.READ_HEART_RATE 权限。

版本 1.4.0-rc01

2026 年 2 月 25 日

androidx.wear.protolayout:protolayout-*:1.4.0-rc01 已发布，相较前一版本无更改。1.4.0-rc01 版本包含这些提交。

版本 1.4.0-beta01

2026 年 2 月 11 日

androidx.wear.protolayout:protolayout-*:1.4.0-beta01 已发布。1.4.0-beta01 版本包含这些提交。

新功能

Wear ProtoLayout 1.4.0-beta01 版本的发布表明该库的功能已完成，且 API 已锁定（标记为实验性的除外）。Wear ProtoLayout 1.4 包含以下新功能和 API：

• 内联图像资源与性能改进： 引入了一种改进的资源处理概念，其中 ImageResource 可以直接内联在布局本身中。
  • 这显著简化了开发过程，无需在 onTileResourcesRequest 中进行手动资源映射并覆盖该方法。
  • 这显著提高了卡片的加载时间，因为无需进行两次 Binder 调用，只需实现 onTileResourcesRequest 方法即可。
  • 所有 Image API 现在都通过提供接受负责此操作的 ProtoLayoutScope 的新方法来支持这一概念。

• Material3 作用域与资源自动注册： 添加了 materialScopeWithResources 以支持带有内联图像资源的 Material3 MaterialScope 概念。此作用域处理自动资源注册，并包含新的图像辅助方法（backgroundImage、avatarImage 和 icon），以简化组件的使用。

  • 简化的代码片段

    materialScopeWithResources(
    context = context,
    deviceConfiguration = deviceParameters,
        protoLayoutScope = protoLayoutScope) {
      primaryLayout(
      // layout setup here
    iconContent = { **icon**(
    **imageResource**(
    **androidImageResource**(R.drawable.myIcon)))})
    //…
    }
    

• PendingIntent 支持： 添加了对卡片 PendingIntent 的支持。PendingIntent 可点击项接受回退操作（LoadAction 或 LaunchAction）。这确保了如果 ProtoLayout 渲染器版本较旧且不支持 PendingIntent，系统会自动使用有效的回退操作。

• 多项 Kotlin DSL 改进

  • 为 Image 和所有 ImageResources 类型添加了专门的 Kotlin 辅助工具，以改善 Kotlin 开发者的体验。
  • 为容器类型（如 Box、Row、Column 等）添加了辅助工具，使其更符合现代 Android 开发习惯。
  • 添加了新的 Kotlin Transformation 修饰符和用于淡入动画的辅助方法。

• 自定义 Lottie 动画： 在 AndroidLottieResourceByResId 中添加了 API，允许通过属性自定义 Lottie 动画，并添加了具体的支持和 API，用于基于槽位 ID 和指定颜色为槽位创建主题属性。

• 环境模式感知： 添加了一个新的平台事件源 isInAmbientMode，允许布局根据设备是否处于环境模式做出反应并更新表达式。

API 变更

• Material3 图像辅助工具： 弃用了现有的 Material3 图像辅助工具，转而使用利用 ProtoLayoutScope 和新的内联资源处理方式的新重载方法。
• MaterialScope 更新： MaterialScope 中的 protoLayoutScope 字段现在为 NonNull，以便在通过 materialScopeWithResources 创建时更易于使用。添加了一个新的 hasProtoLayoutScope 函数来检查其是否存在。MaterialScope 现在还公开了 Context 的公共字段。
• 语义标题（Semantics heading） 作为 API 在 LayoutModifier 中可用。
• 圆弧方向支持： ARC_DIRECTION_* 常量现在已公开，可用于 Arc/ArcLine/ArcText/DashedArcLine 元素。

Bug 修复

• 资源比较： 通过为比较资源类型实现优化的 hash 和 equals 方法，优化了性能。
• 为单槽位 textButton 应用默认内容描述。
• 修复了在渲染器侧调整最大行数的计算。

版本 1.4.0-alpha05

2026 年 1 月 28 日

androidx.wear.protolayout:protolayout-*:1.4.0-alpha05 已发布。1.4.0-alpha05 版本包含这些提交。

API 变更

• 添加了新的 Kotlin Transformation 修饰符。（I195a7，b/397169191）

Bug 修复

• 通过从 TileService 中移除有状态的 ProtoLayoutScope，我们解决了资源处理的问题。（I5dc0a，b/474614772）

版本 1.4.0-alpha04

2026 年 1 月 14 日

androidx.wear.protolayout:protolayout-*:1.4.0-alpha04 已发布。1.4.0-alpha04 版本包含这些提交。

API 变更

• 我们弃用了 Material3 图像辅助工具，转而使用新的利用 ProtoLayoutScope 的重载方法，以及更好的资源处理概念（其中 ImageResource 可以直接内联在布局中，无需在 onTileResourcesRequest 方法中进行映射）。为了获得最佳体验，请将其与 Wear Tiles 1.6-alpha04 版本中添加的 androidx.wear.tiles.Material3TileService 一起使用。（I8198c，b/440376391）

版本 1.4.0-alpha03

2025 年 12 月 17 日

androidx.wear.protolayout:protolayout-*:1.4.0-alpha03 已发布。1.4.0-alpha03 版本包含这些提交。

Bug 修复

• 现在使用优化的哈希和相等性方法来比较两种资源类型，以实现更好的资源处理和性能改进。（82f21b2f）

版本 1.4.0-alpha02

2025 年 10 月 22 日

androidx.wear.protolayout:protolayout-*:1.4.0-alpha02 已发布。1.4.0-alpha02 版本包含这些提交。

新功能

• 添加了新的平台事件源 (isInAmbientMode)，描述设备是否处于环境模式。（Ief832）

API 变更

• PendingIntent 可点击项现在接受回退操作（LoadAction/LaunchAction），当 ProtoLayout 渲染器不支持 PendingIntent 时使用。当渲染器版本低于支持 PendingIntent 的版本时，回退操作将自动被拾取并放入布局中。（I6eee2，b/450259727）
• MaterialScope 中的 protoLayoutScope 字段现在设为 NonNull，以便在通过 materialScopeWithResources 创建时更易于使用。此外，添加了一个 hasProtoLayoutScope 函数来检查其是否存在。（I1858f，b/450067019）

版本 1.4.0-alpha01

2025 年 9 月 24 日

androidx.wear.protolayout:protolayout-*:1.4.0-alpha01 已发布。1.4.0-alpha01 版本包含这些提交。

新功能

• 为 LayoutModifier 添加了辅助方法，使元素在卡片变得可见时淡入。（I38531，b/390345969）
• 添加了 materialScopeWithResources 以支持 M3 MaterialScope 概念，同时也负责自动资源注册。在其中，添加了新的图像辅助方法（backgroundImage、avatarImage 和 icon），使用时无需手动在 onTileResourceRequest 中注册资源。（I525bd，b/428692714）
• ProtoLayout Kotlin 辅助工具，用于配合 ProtoLayoutScope 和自动资源注册使用 Image 和 ImageResources。（Iada82，b/430584304）
• 添加了用于获取一个 Lottie 动画自定义中允许有多少 Lottie 属性的 getter。（I73733，b/436532706）
• 在 AndroidLottieResourceByResId 中添加 API 以允许通过属性自定义 Lottie 动画，并添加用于通过槽位 ID 将槽位主题化为指定颜色的属性创建 API。（I301b3，b/423581481）
• 添加接收 PendingIntent 作为点击操作的提供者 API。（I01978，b/433802488）
• 在 Image.Builder 中添加新 API - setImageResource，用于在 onTileRequest 中直接为 Image 设置资源对象，而无需在 onTileResourcesRequest 中注册映射。（Ifa69a，b/428693523）
• 添加了 ProtoLayoutScope 概念，为 Tiles 中更好的资源处理做准备。（I132ce，b/428692423）
• ProtoLayout Material3 MaterialScope 现在将 Context 字段公开，以便在作用域内的方法中使用，无需在各处传递。（I0e5cc，b/414559956）
• 将标题语义 API 公开。（I75299，b/413653475）
• 将 ARC_DIRECTION_* 常量公开，供在 Arc/ArcLine/ArcText/DashedArcLine 中使用。（I83959，b/427556439）

API 变更

• 我们弃用了 Image.Builder() 和 Image.Builder.setResourceId 方法，转而使用新的自动资源注册 API，该 API 在 Image.Builder(ProtoLayoutScope) 和 Image.Builder.setImageResource API 中可用，无需覆盖 onTileResourcesRequest。（I7bfe6，b/432758526）
• 将用于创建 ProtoLayoutScope 的 API 从受限改为公开。但它们不应被使用，因为系统已经处理了这些调用。（I1d8e8，b/432758251）

Bug 修复

• 添加对在 ProtoTiles 中支持 PendingIntent 的实现。（I38167，b/430610429）
• 添加 invalidateLayout 方法。（Ief898）
• 将默认的 minSdk 从 API 21 升级到 API 23 (Ibdfca, b/380448311, b/435705964, b/435705223)
• ImageResource 现在具有 hashCode 和 equals 方法。（I650ee，b/428692423，b/428693523）
• 添加新的 proto 消息 PendingIntentAction 及其包装构建器。（Ie2aca，b/427643502）
• 减少 ZoneId 实例的创建频率。（I284d3）
• 为单槽位 textButton 应用默认内容描述。（I0dc8a，b/415001534）
• 修复了在渲染器侧调整最大行数的计算。（I933bc，b/414353620）

版本 1.3

版本 1.3.0

2025 年 6 月 4 日

androidx.wear.protolayout:protolayout-*:1.3.0 已发布。1.3.0 版本包含这些提交。

自 1.2.0 以来的重要更改

• Material 3 设计进入手表领域，组件和布局针对圆形显示屏进行了优化，并可从小到大屏幕尺寸进行适度缩放。
  • 这包括仅限 Kotlin 的 protolayout-material3 库，其中包含更多类似 Compose 的 API，适用于以下组件和功能：
  • 来自系统和表盘的动态配色方案，具有最新的 Material3 颜色、形状和排版主题。
  • MaterialScope，用于处理所有既定的默认设置并简化自定义。
  • iconEdgeButton, textEdgeButton
  • iconButton, textButton, button, imageButton, avatarButton, compactButton
  • titleCard, appCard, graphicDataCard, iconDataCard, textDataCard
  • circularProgressIndicator, segmentedCircularProgressIndicator
  • primaryLayout, buttonGroup
  • 所有组件均可在任何 SDK 级别和 ProtoLayout 渲染器版本上运行，并在适用时提供合理的后备方案。
• 为基础 ProtoLayout 元素提供更友好的 Kotlin 和类 Compose API。
  • LayoutModifier，能够以链式函数的形式添加大多数修饰符（padding、contentDescription（包括 clearSemantics）、background、clip、opacity 等），并可转换为现有的 Modifiers 对象。
  • LayoutColors 和 LayoutString 作为类型，支持更容易地使用动态字段和约束。
  • text 和 fontStyle
  • 为 StateBuilder 提供更好的映射支持，包括 DynamicDataMap 和工厂方法（如 intAppDataKey），以更轻松地创建 AppDataKey 对象。
• 支持 Lottie 动画，包括设置不同触发选项（例如当布局加载时或可见时开始动画）。
  • 改进了渐变支持。
  • Brush 的一部分线性渐变 API，可用于 Box, Spacer 等元素的 Background 修饰符……
  • 允许在用于线性渐变和扫描渐变的 ColorStop 中使用动态颜色值。
  • 弧形对象中现有的扫描渐变（Sweep Gradient）现在支持动态颜色以及起始和结束角度。
• protolayout-expression 中的平台数据绑定，用于在布局可见性发生变化时随时接收信息，例如可用于在滑动卡片时隐藏布局的某些部分。
• 测试库 - protolayout-testing - 已添加，旨在为任何 ProtoLayout 元素提供更轻松的单元测试覆盖。
• 新元素 DashedArcLine，具有改进的功能集，使得线条可以带有虚线，与现有的 ArcLine 不同。
• ArcSpacer 支持以 DP 维度而不是度数来设置其长度。
• 添加了适用于某些字体的圆度（roundness）FontSetting 轴。

版本 1.3.0-rc01

2025 年 5 月 20 日

androidx.wear.protolayout:protolayout-*:1.3.0-rc01 已发布，相较前一版本无更改。1.3.0-rc01 版本包含这些提交。

版本 1.3.0-beta02

2025 年 5 月 7 日

androidx.wear.protolayout:protolayout-*:1.3.0-beta02 已发布。1.3.0-beta02 版本包含这些提交。

Bug 修复

• 我们对 API 36 及以上版本应用的排版设计值进行了重要改进。这是因为从 API 36 开始，所有卡片都将使用系统字体，因此这一更改在卡片轮播中引入了更好的一致性。（If316f）
• Text, Spacer, ArcLine 和 DashedArcLine 构建器如果未设置动态值的 layoutConstraints，将不会抛出异常。请注意，较旧的渲染器仍然需要设置 layoutConstraints，并且会忽略任何未设置该值的动态值。（Ic52e8）
• 添加标题语义修饰符，以指示布局元素是内容部分的标题（出于无障碍目的），并默认将 primaryLayout 标题槽位中的文本标记为无障碍标题。（Iae1fb）
• 对 primaryLayout 进行了最终的 UX 润色，在较小屏幕上，标题槽位与主槽位之间的间距从 6dp 减小到 4dp。（I0e056）
• 为 textEdgeButton 应用默认内容描述。（Ifaf8b）
• 对 avatarButton 的内部边距进行了微小更新。（I0910b）

版本 1.3.0-beta01

2025 年 4 月 9 日

androidx.wear.protolayout:protolayout-*:1.3.0-beta01 已发布。1.3.0-beta01 版本包含这些提交。

新功能

Wear ProtoLayout 1.3.0-beta01 版本的发布表明该库的功能已完成，且 API 已锁定（标记为实验性的除外）。Wear ProtoLayout 1.3 包含以下新功能和 API：

• Material 3 设计进入手表领域，组件和布局针对圆形显示屏进行了优化，并可从小到大屏幕尺寸进行适度缩放。
  • 这包括仅限 Kotlin 的 protolayout-material3 库，其中包含更多类似 Compose 的 API，适用于以下组件和功能：
  • 来自系统和表盘的动态配色方案，具有最新的 Material3 颜色、形状和排版主题。
  • MaterialScope，用于处理所有既定的默认设置并简化自定义。
  • iconEdgeButton, textEdgeButton
  • iconButton, textButton, button, imageButton, avatarButton, compactButton
  • titleCard, appCard, graphicDataCard, iconDataCard, textDataCard
  • circularProgressIndicator, segmentedCircularProgressIndicator
  • primaryLayout, buttonGroup
  • 所有组件均可在任何 SDK 级别和 ProtoLayout 渲染器版本上运行，并在适用时提供合理的后备方案。
• 为基础 ProtoLayout 元素提供更友好的 Kotlin 和类 Compose API。
  • LayoutModifier，能够以链式函数的形式添加大多数修饰符（padding、contentDescription（包括 clearSemantics）、background、clip、opacity 等），并可转换为现有的 Modifiers 对象。
  • LayoutColors 和 LayoutString 作为类型，支持更容易地使用动态字段和约束。
  • text 和 fontStyle
  • 为 StateBuilder 提供更好的映射支持，包括 DynamicDataMap 和工厂方法（如 intAppDataKey），以更轻松地创建 AppDataKey 对象。
• 支持 Lottie 动画，包括设置不同触发选项（例如当布局加载时或可见时开始动画）。
  • 改进了渐变支持。
  • Brush 的一部分线性渐变 API，可用于 Box, Spacer 等元素的 Background 修饰符……
  • 允许在用于线性渐变和扫描渐变的 ColorStop 中使用动态颜色值。
  • 弧形对象中现有的扫描渐变（Sweep Gradient）现在支持动态颜色以及起始和结束角度。
• protolayout-expression 中的平台数据绑定，用于在布局可见性发生变化时随时接收信息，例如可用于在滑动卡片时隐藏布局的某些部分。
• 测试库 - protolayout-testing - 已添加，旨在为任何 ProtoLayout 元素提供更轻松的单元测试覆盖。
• 新元素 DashedArcLine，具有改进的功能集，使得线条可以带有虚线，与现有的 ArcLine 不同。
• ArcSpacer 支持以 DP 维度而不是度数来设置其长度。
• 添加了适用于某些字体的圆度（roundness）FontSetting 轴。

1.3.0-alpha10 版本

2025 年 3 月 12 日

androidx.wear.protolayout:protolayout-*:1.3.0-alpha10 已发布。1.3.0-alpha10 版本包含这些提交。

新功能

• 为 Kotlin Background Modifier 中的 Brush 添加了辅助工具。（I995de）
• 强制性的 Android Context 字段在 MaterialScope 中已变为公共，以便在开发者为 Material3 卡片创建组件的函数中更轻松地使用。（I7df73）

API 变更

• 将 API platformVisibilityStatus 重命名为 PlatformEventSources.isLayoutVisible，并添加了一个新的实验性 API PlatformEventSources.isLayoutUpdatePending。（Ie1e04）

Bug 修复

• primaryLayout 的边距现在被正确地向上取整，这可能会在某些布局上导致主槽位空间减少最多 2dp。（I8f5d3）
• 对 ProtoLayout Material3 组件中默认动态配色方案的说明。（Iff5f3）
• Typography.NUMERAL_* 排版默认不再是等宽字体。如果文本正在动画化，强烈建议为其添加 FontSetting.tabularNum() 设置。在所有其他情况下，不需要此等宽选项，并且不使用它会有更多可用字符。（Id3cd9）
• 对 ProtoLayout Material3 组件中默认动态配色方案的说明。（I9d831）

1.3.0-alpha09 版本

2025 年 2 月 26 日

androidx.wear.protolayout:protolayout-*:1.3.0-alpha09 已发布。1.3.0-alpha09 版本包含这些提交。

新功能

• 为 enterTransition 和 exitTransition 添加了实验性修饰符。（I4a4d6）
• 我们添加了额外的平台绑定，以便在完整布局的可见性发生变化时接收其状态。（I250c3）
• 允许将测试应用程序状态和平台数据注入 LayoutElementAssertionsProvider，以便评估动态值。（Ib5fcb）
• 向 protolayout 测试库添加圆角过滤器。（Ie2361）
• ButtonColors, CardColors 和 ProgressIndicatorColors 现在支持 copy 方法，并可选择覆盖某些参数。（Ie2054）

API 变更

• 向测试库添加动态数据绑定支持。（Ib98de）
• 修复了 imageButton 与 backgroundImage 函数一起使用时的问题，移除了遮罩。此外，允许 backgroundImage 函数指定 null 作为遮罩颜色，意味着不会应用遮罩。（Ibec3c）

Bug 修复

• 将默认的 hasValueOfType 方法更改为抛出 UnsupportedOperationException 而不是 IllegalArgumentException。（Ia36c3）
• 默认颜色标记值已更新以反映最新规范。（I75d44）
• 修复了 AndroidX tiles 渲染器中圆弧线条上可见的混叠问题。（I88190）

版本 1.3.0-alpha08

2025 年 2 月 12 日

androidx.wear.protolayout:protolayout-*:1.3.0-alpha08 已发布。1.3.0-alpha08 版本包含这些提交。

新功能

• 为 Material3 文本添加 FontSetting 列表参数。（Ic102d）
• 添加了 DynamicDataMap 类，StateBuilder 现在支持该类，以便为应用程序状态提供更好的类型安全 Kotlin API。（I012ba）
• 添加了工厂方法（如 intAppDataKey），以更轻松地创建 AppDataKey 对象。（Icea2a）
• DynamicDataValue 现在除了 hasInt/hasColor/... 方法外，还具有一个 hasValueOfType(Class<?>) 方法。（I4f7a6）
• 我们向 Material3 ProtoLayout ColorScheme 添加了 errorDim，用于高优先级错误或紧急操作，例如安全警报。（Ia17bb）
• 我们添加了一个防护措施，防止在访问全局 reducemotion 设置时发生崩溃，这在某些未提供该设置的平台上会被触发。（I01e2c）

API 变更

• addKeyToValueMapping 重命名为 addToStateMap，并且移除了 DynamicDataMap.put 方法，因为它们是多余的。（Ibe9dd）
• Material3 排版现在支持支持此轴的系统字体的圆度变量轴。ProtoLayout FontSetting 支持支持此轴的字体的圆度轴。（I33eb5）
• 将 Material3 文本方法中的 multilineAlignment 重命名为 alignment。（I2b66b）
• 将圆形进度指示器更新为 Box 类型，并在 constructGraphic 中将 mainContent 指定为 Box 类型。（I5a3dc）
• 更好地支持在图表中使用圆形进度指示器。（I039db）

Bug 修复

• 允许在 ColorStop 中使用动态值，也允许在 SweepGradient 中设置起始/结束角度。（I0146d）
• 文档修复。（I4a63a）
• 更新了 Material 3 组件（graphicCard 和 avatarButton），以在不支持 weight 展开维度时（例如 API 33 以下）提供回退方案。将文本组件更新为在渲染器不支持 TEXT_OVERFLOW_ELLIPSIZE 时回退到 TEXT_OVERFLOW_ELLIPSIZE_END。（I19e2c）
• PrimaryLayoutMargins 的文档更新。（Ibaf7b）

版本 1.3.0-alpha07

2025 年 1 月 29 日

androidx.wear.protolayout:protolayout-*:1.3.0-alpha07 已发布。1.3.0-alpha07 版本包含这些提交。

新功能

• 添加了 API 选项，用于为 Lottie 动画设置不同的触发器。此外，添加了在布局可见时触发的触发器 API。（I8272d）
• 添加了 border, visibility 和 opacity 修饰符。（I6d3dd）
• 向 ProtoLayout Material3 组件添加了头像按钮。（Idb5ae）
• 我们现在允许在 Material3 primaryLayout 中自定义边距（侧边，在某些情况下包括底部）。（Ib22f6）
• 添加了圆形进度指示器的分段变体。（I6a648）
• 向 ProtoLayout Material3 添加了紧凑按钮组件。（Ia3c5c）
• 向 ProtoLayout Material3 添加了药丸形状按钮和图像按钮组件。（Ifb88a）

API 变更

• LayoutModfier.foldIn 现在改名为 foldRight，以更好地反映其预期的行为。（Idf242）
• VisibleOnce 触发器现在为实验性。（Ib2d26）
• 从公共 API 中删除了 withOpacity，因为有图形库的替代方案。（I030c2）
• 将 LayoutString.kt 和 LayoutColor.kt 中的顶级方法重命名为具有 Java 友好名称。（I7aff0）
• 删除了 Material3 中的非 ProtoLayout 排版。（Idd9ae）
• 向 Material3 中 *Colors 类的字段添加了后缀 Color。（I2d114）

Bug 修复

• 为不支持非对称圆角的旧渲染器添加 EdgeButton 回退实现。（I63364）
• 添加了圆形进度指示器在旧渲染器上的回退实现。（I0f134）

版本 1.3.0-alpha06

2025 年 1 月 15 日

androidx.wear.protolayout:protolayout-*:1.3.0-alpha06 已发布。1.3.0-alpha06 版本包含这些提交。

新功能

• LayoutColor 以支持静态和动态颜色类型。（I4c89b）
• 添加了 ProtoLayout Material3 textButton 组件。（Id680d）
• 添加 iconButton ProtoLayout Material3 组件。（Ica3f0）
• 添加了 ProtoLayout Material3 按钮容器组件。（I17a38）
• 向 protolayout-material3 添加了对可链式语义修饰符的支持。（I4af62）
• 添加了 ProtoLayout Material3 单分段 CircularProgressIndicator。（I2c8a2）
• 添加了 padding,metadata 修饰符。（I8720a）
• 添加了 background,clip 和 clickable 修饰符。（I35478）
• 将 LinearGradient 添加到 Brush，并允许将其用于 Background 修饰符。（Ic4dea）
• 为 appCard 和 titleCard 添加了小尺寸。（I91f98）
• 添加了 ProtoLayout Material3 graphicDataCard 组件。（I92be7）
• 添加了 ProtoLayout Material3 iconDataCard 和 textDataCard 组件。（I4e1e4）
• 添加了 ProtoLayout Material3 appCard 组件。（Id4c57）
• 将 EdgeButtonColors 抽象为 ButtonColors。（I83624）
• 添加了 ProtoLayout Material3 titleCard 组件。（I2dc72）

API 变更

• ProtoLayout Material3 API 现在接受 LayoutString 以支持静态和动态文本。（I9c24a）

Bug 修复

• 添加用于膨胀 DashedArcLine 的渲染器实现。（I0c700）
• 允许 ArcSpacer 采用 dp 长度的渲染器更改。（I1437b）

版本 1.3.0-alpha05

2024 年 12 月 11 日

androidx.wear.protolayout:protolayout-*:1.3.0-alpha05 已发布。1.3.0-alpha05 版本包含这些提交。

新功能

• 添加了 LayoutString 以支持可绑定的布局字符串字段。（Ida650）
• 添加了 ProtoLayout Material3 卡片容器组件。（Ic985a）

Bug 修复

• 该库现在使用 JSpecify nullness 注解，它们是类型使用的。Kotlin 开发者应使用以下编译器参数来强制执行正确使用：-Xjspecify-annotations=strict（这是 Kotlin 编译器 2.1.0 版本及以后的默认设置）。（Id1f9b，b/326456246）

版本 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 组件。

安全修复