Wear 磁贴

声明依赖项

要添加对 Wear 的依赖项，您必须将 Google Maven 代码库添加到您的项目。阅读Google 的 Maven 代码库以了解更多信息。

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

dependencies {
    // Use to implement support for wear tiles
    implementation "androidx.wear.tiles:tiles:1.5.0-alpha04"

    // Use to utilize standard components and layouts in your tiles
    implementation "androidx.wear.protolayout:protolayout:1.3.0-alpha04"

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

    // Use to include dynamic expressions in your tiles
    implementation "androidx.wear.protolayout:protolayout-expression:1.3.0-alpha04"

    // Use to preview wear tiles in your own app
    debugImplementation "androidx.wear.tiles:tiles-renderer:1.5.0-alpha04"

    // Use to fetch tiles from a tile provider in your tests
    testImplementation "androidx.wear.tiles:tiles-testing:1.5.0-alpha04"
}

dependencies {
    // Use to implement support for wear tiles
    implementation("androidx.wear.tiles:tiles:1.5.0-alpha04")

    // Use to utilize standard components and layouts in your tiles
    implementation("androidx.wear.protolayout:protolayout:1.3.0-alpha04")

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

    // Use to include dynamic expressions in your tiles
    implementation("androidx.wear.protolayout:protolayout-expression:1.3.0-alpha04")

    // Use to preview wear tiles in your own app
    debugImplementation("androidx.wear.tiles:tiles-renderer:1.5.0-alpha04")

    // Use to fetch tiles from a tile provider in your tests
    testImplementation("androidx.wear.tiles:tiles-testing:1.5.0-alpha04")
}

有关依赖项的更多信息，请参阅添加构建依赖项。

反馈

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

创建新问题

查看问题跟踪器文档以了解更多信息。

1.5 版

1.5.0-alpha04 版

2024 年 11 月 13 日

androidx.wear.tiles:tiles-*:1.5.0-alpha04 已发布。1.5.0-alpha04 版包含这些提交。

1.5.0-alpha03 版

2024 年 10 月 30 日

androidx.wear.tiles:tiles-*:1.5.0-alpha03 已发布。1.5.0-alpha03 版包含这些提交。

1.5.0-alpha02 版

2024 年 10 月 16 日

androidx.wear.tiles:tiles-*:1.5.0-alpha02 已发布。1.5.0-alpha02 版包含这些提交。

安全修复

• 自此更改起，androidx 编译时针对 protobuf 4.28.2，以解决CVE-2024-7254。将您对 androidx.wear.tiles:tiles-proto 1.5.0-alpha01 版的依赖项升级到 1.5.0-alpha02 版，以解决漏洞风险。

1.5.0-alpha01 版

2024 年 10 月 2 日

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

1.4 版本

1.4.1 版本

2024 年 10 月 16 日

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

安全修复

• 根据此更改，androidx 针对 protobuf 4.28.2 编译以解决CVE-2024-7254。将 androidx.wear.tiles:tiles-proto 1.4.0 版本的依赖项升级到 1.4.1 以解决漏洞风险。

1.4.0 版本

2024 年 8 月 7 日

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

自 1.3.0 版本以来的重要更改

• Android Studio 中 Tiles 预览指定自定义平台数据的工具支持。

1.4.0-rc01 版本

2024 年 7 月 24 日

已发布 androidx.wear.tiles:tiles-*:1.4.0-rc01，与之前的版本相比没有更改。1.4.0-rc01 版本包含这些提交。

1.4.0-beta01 版本

2024 年 7 月 10 日

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

新功能

Wear Tiles 1.4.0-beta01 版本表明此库版本的功能已完成，并且 API 已锁定（除非标记为实验性）。Wear Tiles 1.4 包含以下新功能和 API

• Android Studio 中 Tiles 预览指定自定义平台数据的工具支持。

1.4.0-alpha05 版本

2024 年 6 月 26 日

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

1.4.0-alpha04 版本

2024 年 5 月 29 日

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

1.4.0-alpha03 版本

2024 年 5 月 14 日

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

错误修复

• TileService#getActiveTilesAsync 现在使用 WearSdk API（如果可用）以提供更准确的结果。（I57bd8）

1.4.0-alpha02 版本

2024 年 5 月 1 日

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

API 更改

• 将 tileId 移动到 Builder 构造函数参数作为必填字段，并在 getter 中记录默认时间戳值。（I98c2b）
• 添加 TileInteractionEvent、TileEnter 和 TileLeave proto 消息和批量处理磁贴进入/离开事件所需的 Java 包装器。（I112b0）
• 重构 TileRenderer 以使用 Builder 代替 TileRenderer.Config 对象。（Ib66f9）
• 向 TileRenderer.Config 添加 platformDataProviders 属性。（I6030d）
• 向 TileRenderer 添加一个支持新的 TileRenderer.Config 类的新的构造函数。其他构造函数已弃用。（Iae7ff）
• 向 TilePreviewData 添加 platformDataValues 字段以允许覆盖平台数据值。（If437a）

错误修复

• 记录 TileRenderer.Config.Builder#setTilesTheme 的默认值为零。（Iced18）

1.4.0-alpha01 版本

2024 年 3 月 6 日

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

1.3 版本

1.3.0 版本

2024 年 2 月 7 日

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

自 1.2.0 版本以来的重要更改

• 更新了磁贴预览支持的工具。
• 支持查询属于应用的活动磁贴。

其他更改

• 有关 1.3.0 版本中引入的更完整更改集，请参阅beta01 版本说明。

1.3.0-rc01 版本

2024 年 1 月 24 日

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

API 更改

• 将 TileService#getActiveTilesSnapshotAsync 重命名为 getActiveTilesAsync。（If6b87）

1.3.0-beta01 版本

2024 年 1 月 10 日

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

Wear Tiles 1.3.0-beta01 版本表明此库版本的功能已完成，并且 API 已锁定（除非标记为实验性）。Wear Tiles 1.3 包含以下新功能和 API

• Wear Tiles 工具模块已更新以支持磁贴预览，并已设置为发布。
• 使用 TileService.getActiveTilesSnapshotAsync 支持查询属于应用的哪些磁贴处于活动状态。

1.3.0-alpha04 版本

2023 年 12 月 13 日

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

1.3.0-alpha03 版本

2023 年 11 月 29 日

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

新功能

• 添加了一个新的 API TileService#getActiveTilesSnapshotAsync，用于查询属于应用的哪些磁贴处于活动状态。（I6850e）

API 更改

• 将 @TilePreview 重命名为 @Preview（Ifc08a）

1.3.0-alpha02 版本

2023 年 11 月 15 日

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

新功能

• 我们添加了一个实验性 API，可以根据文本在父级内部的空间自动缩放文本大小。（Ibbe63）

1.3.0-alpha01 版本

2023 年 10 月 18 日

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

新功能

• 提供上下文作为预览方法参数，而不是 TilePreviewData 回调参数。（I5e97d）
• Wear Tiles 工具模块已更新以支持磁贴预览，并已设置为发布。（I63d0f）

1.2 版本

1.2.0 版本

2023 年 8 月 9 日

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

自 1.1.0 版本以来的重要更改

• Wear Tiles 1.2.0 稳定版（阅读更多）
• Tiles 1.2 添加了对将布局元素绑定到平台数据（以便更快地更新）和动画的支持。有关迁移说明，请参阅 (1.2.0-rc01) 的版本说明。

1.2.0-rc01 版本

2023 年 7 月 26 日

已发布 androidx.wear.tiles:tiles-*:1.2.0-rc01。1.2.0-rc01 版本包含这些提交。

• 随着 v1.2 版本的发布，Tiles 库已重构，大部分功能和 API 已移动到新的ProtoLayout 库（包 androidx.wear.protolayout），一小部分保留在 Tiles (androidx.wear.tiles) 中。

  • 所有类名都保持不变，只有对 v1.1 的补充。
  • 大部分 API 保持不变，唯一更改的是包名。
  • TileService/TileBuilder 中的一些方法已弃用，现在具有接受新的 ProtoLayout 类型而不是已弃用的 Tiles 类型的重命名版本。

• 为了使此迁移更容易，我们整理了一些说明和脚本来执行此重命名，请参阅此处。

API 更改

• 我们将磁贴中布局的最大深度限制为 30 个嵌套元素。如果超过此深度，则磁贴渲染器将显示先前膨胀的布局。（I8a74b）

1.2.0-beta01 版本

2023 年 6 月 21 日

已发布 androidx.wear.tiles:tiles-*:1.2.0-beta01，没有更改。1.2.0-beta01 版本包含这些提交。

1.2.0-alpha07 版本

2023 年 6 月 7 日

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

新功能

• TileRenderer.setState 允许设置渲染会话的状态。此状态将应用于当前布局和任何未来的布局（直到设置新状态为止）（Iaaf35）
• protolayout 类型现在完全支持所有 tile-renderer API。（I428b0）

错误修复

• 现在可以在 ProtoLayoutViewInstance 中设置自定义主题。（Iae8c0）

1.2.0-alpha06 版本

2023 年 5 月 24 日

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

API 更改

• 将 StateEntryValue 重命名为 DynamicDataValue，并更新状态 API 以使用 DynamicDataKey（If1c01）
• 为了确保每个 StateStore 实例的内存使用和状态更新时间得到良好控制，我们限制了 StateStore 中允许的条目数量。因此，开发者需要确保映射中不超过 MAX_STATE_ENTRY_COUNT 个条目，否则在创建或更新 StateStore 时将收到 IllegalStateException 异常。（Ibadb3）

1.2.0-alpha05 版本

2023年5月10日

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

新功能

• 我们已将磁贴 ID 添加到磁贴事件和请求中。此 ID 可用于将某些数据与轮播中的磁贴实例关联。（Ic4f83）

API 更改

• TileRenderer.inflateAsync 现在返回 ListenableFuture。（I2f2b9）
• 在 protolayout 库中具有替代项的磁贴构建器现在被标记为已弃用。（Ie2029）

错误修复

• TileService.onTileResourcesRequest 的 javadoc 现在阐明了系统可能何时调用此方法。（Iee037）

1.2.0-alpha04 版本

2023年4月19日

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

错误修复

• gradle 依赖项现在根据需要正确设置为 api 而不是 implementation。（I40503）

1.2.0-alpha03 版本

2023年4月5日

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

API 更改

• 我们已将对 androidx.wear.protolayout 类型的支持添加到 TileRenderer。（I4ac7f）
• ObservableStateStore 已重命名为 StateStore。（Ieb0e2）
• 为 TileRenderer 添加了 protolayout 类型的重载方法。（I4ac7f）
• 在 TileRenderer 中启用动画。（I07dcf）

1.2.0-alpha02 版本

2023年3月22日

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

API 更改

• Tiles Material 库已弃用。请使用具有相同功能的新 ProtoLayout Material 库。（If242b）

错误修复

• TileRenderer 已更新为使用 protolayout 库的新功能。（I832f9）

1.2.0-alpha01 版本

2023年3月8日

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

新功能

• 我们已将 onTileResourceRequest 添加到 TileService，用于提供来自 protolayout 库的资源。（983d9c5）
• 我们已更新 ResourcesRequest 和 TileRequest 以支持来自 protolayout 库的 State 和 DeviceParameters 类型。（88fa01d）
• 我们已更新 TileBuilders.Tile 以支持来自 protolayout 库的 State 和 Timeline 类型。（168619c）

错误修复

• 改进了 Javadoc。（I3ed73）
• onPrimary 和 surface 的默认颜色已更改。（I0b039）

1.1 版本

1.1.0 版本

2022年8月24日

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

自 1.0.0 版本以来的重要更改

• 这是第一个包含 Tiles Material 库的稳定版本（更多信息请阅读我们的博客）。
• 此库包含符合 Material 指南且易于使用的组件和布局。包含的组件有 Button、Chip、CompactChip、TitleChip、CircularProgressIndicator、Text。所有这些组件都有自己的颜色对象，可以使用主 Colors 类构建，以便轻松地在所有组件上应用相同的主题。除了颜色之外，还有一个 Typography 类，可以使用字体名称轻松获取 FontStyle 对象。
• 除了组件之外，还有推荐的磁贴布局 - PrimaryLayout、EdgeContentLayout、MultiButtonLayout、MultiSlotLayout。所有布局都应用了符合 Material 指南的推荐填充和样式。
• 有关 Tiles Material 库中组件和布局的列表，请参阅Tiles 的发行说明。

1.1.0-rc01 版本

2022年8月10日

androidx.wear.tiles:tiles-*:1.1.0-rc01 已发布。1.1.0-rc01 版本包含这些提交。

• Beta 版本和 RC 版本之间没有新的更改。

1.1.0-beta01 版本

2022年7月27日

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

Tiles Material 库的 1.0.0-beta01 版本包含符合 Material 指南且易于构建的组件和布局。

包含的组件有：

• Button - 可点击的圆形对象，包含图标、文本或图像，具有 3 个预定义大小。
• Chip - 可点击的体育场形状的对象，可以包含图标、主要和次要标签，并且具有固定高度和可自定义宽度。
• CompactChip & TitleChip - 标准 Chip 的两个变体，分别具有较小和较大的高度，并且可以包含一行文本。
• CircularProgressIndicator - 屏幕边缘周围的彩色弧线，具有给定的起始和结束角度，可以描述完整的或部分圆形，其后是完整的进度弧线。
• Text - 使用推荐的 Wear Material 排版样式的样式化文本

所有这些组件都有自己的颜色对象，可以使用主 Colors 类构建，以便轻松地在所有组件上应用相同的主题。除了颜色之外，还有一个 Typography 类，可以使用字体名称轻松获取 FontStyle 对象。

除了组件之外，还有推荐的磁贴布局：

• PrimaryLayout - 一个可以自定义的布局，可以通过添加主要或次要标签、中间内容以及底部的主要芯片来进行自定义。此布局中的主要内容可以添加为 MultiSlotLayout 或 MultiButtonLayout 对象。
• EdgeContentLayout - 用于在边缘周围承载 CircularProgressIndicator，内部有主要内容，周围有主要或次要标签的布局。
• MultiButtonLayout - 一个可以包含 1-7 个按钮的布局，根据按钮数量排列，符合 Material 指南。
• MultiSlotLayout - 一种行样式布局，具有水平对齐和间隔的槽（用于图标或其他小型内容）。

所有布局都应用了符合 Material 指南的推荐填充和样式。

API 更改

• 对 Chip 组件进行了重大重构，包括在 Builder 中分离 setter，以便每个内容部分都分别传递，并重命名以符合指南（主要标签、次要标签、图像资源 ID）。此外，如果未设置，内容描述将自动生成。（I57622）
• ProgressIndicatorLayout 已重命名为 EdgeContentLayout。（Ic1aa6）
• 按钮大小内容已重命名为名称 without _BUTTON 后缀，并在 Button 中添加了其他 Javadoc 说明。（I1dfe2）

错误修复

• Material 布局中的边距、填充和整体排列已更新，以适应所有类型的推荐布局和屏幕尺寸以及形状。
• 改进了 Material 布局。在 MultiSlotLayout 中，槽的宽度现在是灵活的，它们将自动换行，而不是固定大小。（I52919）、(If18b4）
• 已增加 CompactChip 上可点击区域的大小，以遵循辅助功能指南。（Ie8264）

1.1.0-alpha09 版本

2022年6月29日

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

新功能

• 我们已添加了在 ProgressIndicatorLayout 中添加可选标签的支持。（I30788）

API 更改

• ElementMetadata 的辅助方法现在接受 ElementMetadata 而不是 Modifiers。（I5a70f）

错误修复

• 已删除 CompactChip 上 9 个字符的限制。如果文本过大而无法在 PrimaryLayout 的屏幕上显示，则它将被省略号代替。（Id56ec）
• Chip 中的 Getter 现在带有 _Content 后缀。（Iba437）
• Tiles Material 类中的 Javadoc 说明。（I56e41）、(I80f31）、(Iba437）

1.1.0-alpha08 版本

2022年6月1日

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

新功能

• 元数据标签已添加到 Modifiers 中，用于跟踪组件的元数据，并向 Helper 类添加了辅助方法。（I70db2）、(I30c3d）
• 所有 Tiles Material 内的组件和布局都添加了静态方法 fromLayoutElement。此方法应用于测试，用于将从容器内容访问获得的 LayoutElement 转换为其原始类型。（Ia572a）、(Idbd8a）、(I3ae13）、(I292fe）、(I8b20f）、(I3cacb）、(I84b24)

1.1.0-alpha07 版本

2022年5月18日

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

API 更改

• 现在，已向 ProgressIndicatorLayout 和 PrimaryLayout 添加了与不同内容设置器相关的 Getter。现在，这些类中的所有 Setter 都有匹配的 Getter。（Iddbe5）(Iabe4e)
• 由于 Material 组件的 Setter 不是必需的，因此内容描述符的 Getter 可以返回 null。
• 尝试创建未传入内容的按钮将导致 IllegalArgumentException。（I7fc0c)
• ChipColors 中与图标颜色相关的字段已从 iconTintColor 重命名为 iconColor。（Ic053b)

错误修复

• 为 Tiles Material 中的布局添加了 androidTests。（I96404)

1.1.0-alpha06 版本

2022年5月11日

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

新功能

• 新的布局已添加到 Material 布局子库中 - MultiButtonLayout。它表示一个布局，其中可以包含 1 到 7 个按钮，这些按钮根据 Material 指南排列成一行。在大多数情况下，此布局应作为内容传递给 PrimaryLayout。（Ib727f)

API 更改

• MultiSlotLayout 已重构，使其仅包含插槽。此布局应作为内容传递给主 PrimaryLayout。（I1870f)
• 已更新 CircularProgressIndicator 的默认颜色定义，改为使用一个值而不是主颜色和次颜色。（I64a51)
• 为 MultiSlotLayout 添加了水平间隔符的 Getter。（I11e1e)

错误修复

• 已将组件的 Android 测试添加到 Tiles Material。（I20041)

1.1.0-alpha05 版本

2022年4月6日

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

新功能

• 添加了辅助方法，用于将 LayoutElement 转换为 Layout、Timeline 和 TimelineEntry，以便更容易构建 Tiles。（I2f6d1)
• 已将 Colors 对象添加到 Material 库中，作为主题跨组件传递颜色。（I0792c)

API 更改

• Material 文本组件需要在构造函数中传入文本。现在可以通过设置权重来自定义此组件。（I25dbd)
• 删除了 ChipDefaults 中在公共 Setter 中未使用的常量。（I7baed)
• 删除了 CompactChip 和 TitleChip 中没有匹配 Setter 的 Getter。（I99e85)
• 删除了 ProgressIndicatorDefaults 中的 DEFAULT_PADDING。（Idabcd)
• Material 组件现在接受 CharSequence 作为内容描述，而不是 String。（I5b21a)

错误修复

• 重构了按钮中可选参数的 Setter 实现。（Ib7135)
• 已将字体样式变体添加到排印术中的字体。（I8dbc6)

1.1.0-alpha04 版本

2022年3月23日

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

新功能

• 可以向 PrimaryLayout 添加可选的主标签或次标签。（Ib9916)
• 可以通过设置溢出、斜体、下划线等来自定义文本组件。（I703f7)

API 更改

• 已从 Tiles Material API 中删除默认颜色常量。（I0ab55)
• Tiles Material 中的所有可点击组件在其 Builder 的构造函数中都需要 Clickable 对象，而不是 Action。（I2f101)

错误修复

• 现在，文本将在 Chip 和文本组件中对溢出内容绘制省略号。（I8a2f8)
• 改进了用户字体比例设置为大字体时组件的外观。（Ib63b1)
• 阐明了 PrimaryLayout 中 setPrimaryChipContent 的 Javadoc。（Ie6296)

1.1.0-alpha03 版本

2022年2月23日

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

API 更改

• 已将带有推荐排印样式的 Text 组件添加到 TIles Material。（Iec0ae)

1.1.0-alpha02 版本

2022年2月9日

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

新功能

• 已添加 Tiles Material 中的新子库 layouts。它包含具有推荐填充和边距的固定 Tiles 布局，可以加快 Tile 开发并简化实现。初始布局为：
  • PrimaryLayout (I7ba91)，它表示底部带有主芯片，中间带有内容的布局。
  • MultiSlotLayout (I32104)，它表示一个布局，其中第 1 行和第 3 行带有标签，第 2 行带有水平对齐和间隔的插槽，所有这些都紧跟在包含主芯片的第 4 行之后。
  • ProgressIndicatorLayout (I9fec6)，它表示一个布局，其中圆形进度指示器位于屏幕边缘，给定内容位于内部。
• 已将 CircularProgressIndicator (Ic4b88) 添加到 Tiles Material 组件。

API 更改

• 重命名了 TitleChip 使用的剩余常量，以在名称中包含标题。（I14f4c)
• 已向 Chip 添加了 setHorizontalAlignment 方法。（Ie6e0b)

1.1.0-alpha01 版本

2022年1月26日

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

新功能

• 已添加新的库 Tiles Material。它包含用于更快、更轻松地使用 Material 设计构建 Tiles 布局的组件。初始组件为：
  • 按钮
  • 芯片
  • 紧凑型芯片
  • 标题芯片

错误修复

• 修复了 TileUiClient 中导致缓存资源被丢弃的错误。（I60e0b)

1.0 版本

1.0.1 版本

2022年1月26日

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

错误修复

• 修复了 TileUiClient 中导致缓存资源被丢弃的错误。（I60e0b)

1.0.0 版本

2021年11月3日

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

1.0.0 的主要功能

• Wear Tiles 库提供了构建 Wear OS 设备自定义 Tiles 的功能，以及允许系统获取您的 Tiles 并将其显示在表盘旁边的类。
• tiles-renderer 允许您将磁贴显示为 Android Activity 的一部分，方便您快速测试磁贴布局。

版本 1.0.0-rc01

2021 年 10 月 27 日

已发布 androidx.wear.tiles:tiles-*:1.0.0-rc01。1.0.0-rc01 版本包含这些提交。

版本 1.0.0-beta01

2021 年 10 月 13 日

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

错误修复

• 修复了当提供空资源版本时 TileUiClient 中的 NullPointerException。I0586e)

版本 1.0.0-alpha12

2021 年 9 月 29 日

已发布 androidx.wear.tiles:tiles-*:1.0.0-alpha12。1.0.0-alpha12 版本包含这些提交。

错误修复

• UpdateScheduler 不再使用弱引用，修复了 TileUiClient 无法更新的问题(I1120d，b/199061124)

• 声明 SysUiTileUpdateRequester 查询 PacakgeManager，修复了磁贴更新在 R+ 设备上无法工作的错误。( I1120d)

版本 1.0.0-alpha11

2021 年 9 月 1 日

已发布 androidx.wear.tiles:tiles-*:1.0.0-alpha11。1.0.0-alpha11 版本包含这些提交。

新功能

• 添加并发布了一个测试库 androidx.wear.tiles:tiles-testing 库，使开发人员能够更轻松地测试他们的磁贴。( Iedb6b)

API 更改

• 将 TileProviderService 重命名为 TileService。( I1ad2c)
• 更新了磁贴构建器；静态 .builder() 方法已被弃用，取而代之的是调用 new Foo.Builder()，并且接受 Builder 实例的 setter 重载已被移除。( Ia9606)
• TileRenderer 现在应该使用 UI 上下文，而不是应用程序上下文。( I84b61)

错误修复

• 修复了在某些情况下导致应用多条下划线的错误。( Ib6712)

版本 1.0.0-alpha10

2021 年 8 月 18 日

已发布 androidx.wear.tiles:tiles:1.0.0-alpha10、androidx.wear.tiles:tiles-proto:1.0.0-alpha10 和 androidx.wear.tiles:tiles-renderer:1.0.0-alpha10。1.0.0-alpha10 版本包含这些提交。

API 更改

• 从公共 API 中删除了布局检查器。这些检查器将始终启用，但只有在检查失败时才会发出警告。( Ie9f29)
• TileRenderer 现在接受 UI 上下文，而不是 Application Context。

错误修复

• 修复了阻止点击 Spannable 中的可点击元素的错误。

版本 1.0.0-alpha09

2021 年 7 月 21 日

已发布 androidx.wear.tiles:tiles:1.0.0-alpha09、androidx.wear.tiles:tiles-proto:1.0.0-alpha09 和 androidx.wear.tiles:tiles-renderer:1.0.0-alpha09。1.0.0-alpha09 版本包含这些提交。

新功能

• 为 Wear Tiles 的渲染器添加了布局检查器。( I3a869)
  • 这些用于验证磁贴中的最佳实践。首先，如果您的磁贴不包含任何带有 Semantics 修饰符的元素，这些检查器将发出警告。
• 添加了 DefaultTileProviderClient 和 TestingTileProviderClient 构造函数的文档。( I9f4b9)

API 更改

• TileProviderClient 中的重命名 ( I0ec36)
  • getApiVersion -> requestApiVersion
  • tile/resourcesRequest -> requestTile/Resources
  • onTileFooEvent -> sendOnTileFooEvent
• 为 Wear Tiles 的渲染器添加了布局检查器。( I3a869)

错误修复

• 确保启动操作目标没有特殊权限。( I39136)

版本 1.0.0-alpha08

2021 年 6 月 30 日

已发布 androidx.wear.tiles:tiles:1.0.0-alpha08、androidx.wear.tiles:tiles-proto:1.0.0-alpha08 和 androidx.wear.tiles:tiles-renderer:1.0.0-alpha08。1.0.0-alpha08 版本包含这些提交。

新功能

• Spannables 现在支持 line_height 而不是 line_spacing。

API 更改

• 在 Spannables 中添加对 line_height 的支持，删除 line_spacing。( Ibeb54)
  • 使用 line_spacing 的代码应移植为改用 line_height。

错误修复

• 修复使用比例尺寸时的错误。( I37ace)
• 修复阻止文本元素具有内容描述的错误。( Id2c7d)

版本 1.0.0-alpha07

2021 年 6 月 16 日

已发布 androidx.wear.tiles:tiles:1.0.0-alpha07、androidx.wear.tiles:tiles-proto:1.0.0-alpha07 和 androidx.wear.tiles:tiles-renderer:1.0.0-alpha07。1.0.0-alpha07 版本包含这些提交。

API 更改

• 添加 TileProviderClient 接口，并公开 DefaultTileProviderClient，允许实现绑定到 TileProviderService 接口。( I69165)

版本 1.0.0-alpha06

2021 年 6 月 2 日

已发布 androidx.wear.tiles:tiles:1.0.0-alpha06、androidx.wear.tiles:tiles-proto:1.0.0-alpha06 和 androidx.wear.tiles:tiles-renderer:1.0.0-alpha06。1.0.0-alpha06 版本包含这些提交。

API 更改

• 所有 Builder 类现在都包含所有属性的 getter。请注意，这些仅用于测试目的 ( I9d155)
• 包更改：androidx.wear.tiles.builders 中的类已移动到 androidx.wear.tiles。
• 为磁贴添加实验性色调支持。( I38929)
• 将 LayoutElementBuilders.HALIGN_* 重命名为 LayoutElementBuilders.HORIZONTAL_ALIGN_* ( I67e58)
• 将 LayoutElementBuilders.VALIGN_* 重命名为 LayoutElementBuilders.VERTICAL_ALIGN_* ( I67e58)
• 将 LayoutElementBuilders.SPAN_VALIGN_* 重命名为 LayoutElementBuilders.SPAN_VERTICAL_ALIGN_* ( I67e58)
• 添加了请求和事件的构建器类。( Ib5cf4)
• 迁移 TileProviderService 以使用来自 RequestBuilders 和 EventBuilders 的请求和事件类，而不是 RequestReaders/EventReaders（例如，onTileRequest 现在为您提供 RequestBuilders.TileRequest，而不是 RequestReaders.TileRequest）。( I46ea1)

错误修复

• 修复了磁贴渲染器中异步图像加载的错误。( Iad9b0)
• 修复了在将宽度或高度设置为 expand() 的图像放置在宽度或高度设置为 wrap() 的 Box 中时的布局错误。( I33770)

版本 1.0.0-alpha05

2021 年 5 月 18 日

已发布 androidx.wear.tiles:tiles:1.0.0-alpha05、androidx.wear.tiles:tiles-proto:1.0.0-alpha05 和 androidx.wear.tiles:tiles-renderer:1.0.0-alpha05。1.0.0-alpha05 版本包含这些提交。

API 更改

• 从传入的磁贴事件 (TileAddEvent、TileRemoveEvent、TileEnterEvent、TileLeaveEvent、TileRequest) 中删除了 getTileId。( Ifbba2)
• 将 ImageResource#setAndroidResourceByResid 重命名为 setAndroidResourceByResId ( I4ba6e)
• 将 TimelineManager#deInit 重命名为 close，并实现了 AutoCloseable。( I5dff2)

版本 1.0.0-alpha04

2021 年 5 月 5 日

已发布 androidx.wear.tiles:tiles:1.0.0-alpha04、androidx.wear.tiles:tiles-proto:1.0.0-alpha04 和 androidx.wear.tiles:tiles-renderer:1.0.0-alpha04。1.0.0-alpha04 版本包含这些提交。

API 更改

• 隐藏具体的 TileProviderService 类。
  • 使 TileUpdateRequester 获取 Class<? extends TileProviderService>。( Ib7cca)
• 添加了向 AndroidActivity 添加额外内容的功能。( I748f4)

磁贴版本 1.0.0-alpha03

2021 年 4 月 21 日

已发布 androidx.wear.tiles:tiles:1.0.0-alpha03、androidx.wear.tiles:tiles-proto:1.0.0-alpha03 和 androidx.wear.tiles:tiles-renderer:1.0.0-alpha03。1.0.0-alpha03 版本包含这些提交。

API 更改

• 重命名 TileManager -> TileClient
  • 重命名 TileManager#create -> TileClient#connect (I91839)

错误修复

• 添加 Proguard 规则以确保 tiles 和 tiles-renderer 在启用 Proguard 时正常工作 (Ie3d85)

版本 1.0.0-alpha02

2021年4月7日

androidx.wear.tiles:tiles:1.0.0-alpha02、androidx.wear.tiles:tiles-proto:1.0.0-alpha02 和 androidx.wear.tiles:tiles-renderer:1.0.0-alpha02 已发布。 版本 1.0.0-alpha02 包含这些提交。

API 更改

• androidx.wear:wear-tiles 已移动分组，现在应称为 androidx.wear.tiles:tiles
• androidx.wear:wear-tiles-renderer 已移动分组，现在应称为 androidx.wear.tiles:tiles-renderer
• TileRenderer.LoadActionListener 现在使用 androidx.wear.tiles.builders.StateBuilders.State 的实例，而不是 androidx.wear.tiles.proto.StateProto.State。
• TileRenderer 现在接受来自 androidx.wear.tiles.builders.ResourceBuilders.Resources 的 Tile 资源，而不是 androidx.wear.tiles.renderer.ResourceAccessors 的实例。

错误修复

• 修复了无法使用 LoadActionListener 的问题，因为它公开了一个内部类。

版本 1.0.0-alpha01

2021年3月10日

androidx.wear:wear-tiles:1.0.0-alpha01、androidx.wear:wear-tiles-proto:1.0.0-alpha01 和 androidx.wear:wear-tiles-renderer:1.0.0-alpha01 已发布。 版本 1.0.0-alpha01 包含这些提交。

新功能

• Wear Tiles Renderer 库提供了构建 Wear OS 设备自定义 Tiles 的功能，以及允许系统获取您的 Tile 并将其显示在表盘旁边的类。