Wear Tiles

打造适用于 Wear OS by Google 谷歌智能手表的应用。
最近更新时间 当前稳定版 下一候选版 Beta 版 Alpha 版
2021 年 7 月 21 日 - - - 1.0.0-alpha09

声明依赖项

如需添加 Wear 的依赖项,您必须将 Google Maven 代码库添加到项目中。如需了解详情,请参阅 Google 的 Maven 代码库

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

Groovy

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

    // Use to preview wear tiles in your own app
    debugImplementation "androidx.wear.tiles:tiles-renderer:1.0.0-alpha09"
}

Kotlin

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

    // Use to preview wear tiles in your own app
    debugImplementation("androidx.wear.tiles:tiles-renderer:1.0.0-alpha09")
}

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

反馈

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

创建新问题

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

版本 1.0.0

版本 1.0.0-alpha09

2021 年 7 月 21 日

发布了 androidx.wear.tiles:tiles:1.0.0-alpha09androidx.wear.tiles:tiles-proto:1.0.0-alpha09androidx.wear.tiles:tiles-renderer:1.0.0-alpha09版本 1.0.0-alpha09 中包含这些提交内容

新功能

  • 向 Wear Tiles 的渲染程序添加了布局检查工具。(I3a869)
    • 这些检查工具用于验证图块中的最佳做法。首先,如果图块中不含任何带 Semantics 修饰符的元素,这些检查工具就会显示警告。
  • 添加了有关 DefaultTileProviderClientTestingTileProviderClient constructors 的文档。(I9f4b9)

API 变更

  • TileProviderClient 中进行了以下重命名 (I0ec36):
    • getApiVersion -> requestApiVersion
    • tile/resourcesRequest -> requestTile/Resources
    • onTileFooEvent -> sendOnTileFooEvent
  • 向 Wear Tiles 的渲染程序添加了布局检查工具。(I3a869)

bug 修复

  • 确保 LaunchAction 目标没有特殊权限。(I39136)

版本 1.0.0-alpha08

2021 年 6 月 30 日

发布了 androidx.wear.tiles:tiles:1.0.0-alpha08androidx.wear.tiles:tiles-proto:1.0.0-alpha08androidx.wear.tiles:tiles-renderer:1.0.0-alpha08版本 1.0.0-alpha08 中包含这些提交内容

新功能

  • Spannable 现在支持 line_height 而非 line_spacing。

API 变更

  • 在 Spannable 中添加了对 line_height 的支持,移除了 line_spacing。(Ibeb54)
    • 应将使用 line_spacing 的代码,改为使用 line_height。

bug 修复

  • 修复了使用比例尺寸时出现的 bug。(I37ace)
  • 修复了阻止文本元素拥有内容描述的 bug。(Id2c7d)

版本 1.0.0-alpha07

2021 年 6 月 16 日

发布了 androidx.wear.tiles:tiles:1.0.0-alpha07androidx.wear.tiles:tiles-proto:1.0.0-alpha07androidx.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-alpha06androidx.wear.tiles:tiles-proto:1.0.0-alpha06androidx.wear.tiles:tiles-renderer:1.0.0-alpha06版本 1.0.0-alpha06 中包含这些提交内容

API 变更

  • 所有构建器类现在都包含所有属性的 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,以使用 RequestBuildersEventBuilders(而不是 RequestReaders/EventReaders)中的请求类和事件类(例如,onTileRequest 现在为您提供了 RequestBuilders.TileRequest,而不是 RequestReaders.TileRequest)。(I46ea1)

bug 修复

  • 修复了图块渲染程序在异步加载图像时出现的 bug。(Iad9b0)
  • 修复了在将宽度或高度设为 expand() 的图像放置在宽度或高度设为 wrap()Box 中时出现的布局 bug。(I33770)

版本 1.0.0-alpha05

2021 年 5 月 18 日

发布了 androidx.wear.tiles:tiles:1.0.0-alpha05androidx.wear.tiles:tiles-proto:1.0.0-alpha05androidx.wear.tiles:tiles-renderer:1.0.0-alpha05版本 1.0.0-alpha05 中包含这些提交内容。

API 变更

  • 从传入的图块事件(TileAddEventTileRemoveEventTileEnterEventTileLeaveEventTileRequest)中移除了 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-alpha04androidx.wear.tiles:tiles-proto:1.0.0-alpha04androidx.wear.tiles:tiles-renderer:1.0.0-alpha04版本 1.0.0-alpha04 中包含这些提交内容

API 变更

  • 隐藏了具体的 TileProviderService 类。
    • 让 TileUpdateRequester 能够接受 Class<? extends TileProviderService>。(Ib7cca)
  • 添加了向 AndroidActivity 中添加 extra 的功能。(I748f4)

Tiles 版本 1.0.0-alpha03

2021 年 4 月 21 日

发布了 androidx.wear.tiles:tiles:1.0.0-alpha03androidx.wear.tiles:tiles-proto:1.0.0-alpha03androidx.wear.tiles:tiles-renderer:1.0.0-alpha03版本 1.0.0-alpha03 中包含这些提交内容

API 变更

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

bug 修复

  • 添加了 Proguard 规则,以确保 tilestiles-renderer 在启用 Proguard 的情况下能正常运行 (Ie3d85)

版本 1.0.0-alpha02

2021 年 4 月 7 日

发布了 androidx.wear.tiles:tiles:1.0.0-alpha02androidx.wear.tiles:tiles-proto:1.0.0-alpha02androidx.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 的图块资源,而不是 androidx.wear.tiles.renderer.ResourceAccessors 实例。

bug 修复

  • 通过公开一个内部类,修复了无法使用 LoadActionListener 的问题。

版本 1.0.0-alpha01

2021 年 3 月 10 日

发布了 androidx.wear:wear-tiles:1.0.0-alpha01androidx.wear:wear-tiles-proto:1.0.0-alpha01androidx.wear:wear-tiles-renderer:1.0.0-alpha01版本 1.0.0-alpha01 中包含这些提交内容

新功能

  • Wear Tiles Renderer 库提供了为 Wear OS 设备构建自定义图块的功能,以及可让系统提取图块并将其显示在表盘旁边的类。