注意： 对于预装 Wear OS 5 或更高版本的设备以及在 Google Play 上发布的所有新表盘，必须使用 表盘格式 进行安装。
自 2026 年 1 月起，所有 Wear OS 设备都将强制要求使用表盘格式安装表盘。
如需详细了解此 帮助中心文章 中面向用户的更改。
表盘是用户查看手表时首先看到的内容，使其成为 Wear OS 上使用最频繁的界面。用户依赖表盘来定制其手表以符合其风格，并一目了然地提供快速信息。
受众
我们新的表盘格式 (WFF) 使构建表盘变得前所未有的简单。我们与三星合作发布了 Watch Face Studio，这是一款所见即所得的工具，可让您直接设计表盘。
如果您更喜欢手动管理手表配置，也可以使用 XML 定义表盘。这些指南面向使用 XML 或构建自定义工具以使用表盘格式创建表盘的开发者。Android Studio 还支持构建和运行使用表盘格式的表盘。
表盘格式与三星合作创建，是一种声明式 XML 格式，用于配置表盘的外观和行为。与其他表盘 API 不同，在其他 API 中，您的 APK 必须包含渲染表盘的代码，而表盘格式只需要资源和声明式指令。Wear OS 平台处理渲染表盘所需的逻辑，因此您可以专注于创意，而不是代码优化或电池性能。
使用此新格式构建的表盘比使用旧版 Jetpack 表盘库构建的表盘需要更少的维护和更新。例如，您无需更新表盘即可受益于性能或电池消耗的改进，或获取最新的错误修复。
关于格式
表盘格式 (WFF) 表盘的核心是定义表盘布局和行为的文档。此文档采用 XML 编写，符合 WFF 规范。
Wear OS 系统包含一个表盘渲染器组件。此组件解析您的 WFF XML 文档并从中渲染表盘。其他资源（如图像和字体）会根据需要引入。
这种方法意味着您只需要花时间描述表盘应该是什么样子，而 Wear OS 会处理所有绘制表盘的代码。
要将表盘格式的表盘部署到设备，请将 XML 文档打包到标准 AAB 或 APK 包中。
下图显示了该方法的概览
WFF 中的版本控制
随着 WFF 的发展，新功能会不断添加，以新元素、属性、数据源等形式体现在格式中。
例如，WFF 版本 2 引入了天气支持作为数据源，而 WFF 版本 1 中不提供此功能。
设计表盘时，请注意您要使用的功能及其版本可用性。参考指南中标记了所有功能的可用性。
WFF 的每个版本都与 Wear OS 版本保持一致
| WFF 版本 | 最低 Wear OS 版本 | 最低 API 级别 |
|---|---|---|
| 1 | 4 | 33 |
| 2 | 5 | 34 |
| 3 | 5.1 | 35 |
| 4 | 6 | 36 |
请参阅此指南，了解如何适当地配置您的 AndroidManifest.xml 和 Gradle 构建文件。
了解详情
通过这些指南了解有关表盘格式的更多信息
- 可用功能：探索每个版本的表盘格式支持的表盘功能。
- 设计指南：了解表盘布局和用户体验的最佳实践。
- 设置：配置支持表盘格式的 Android App Bundle。
- GitHub 示例：通过构建示例表盘并将其部署到 Wear OS 模拟器或您的物理设备来开始使用。
- 优化内存使用：了解如何配置表盘，以便系统在渲染表盘时消耗尽可能少的内存。
- XML 参考：探索构成表盘格式文件的各个元素。根元素始终是
WatchFace。注意：要在 XML 参考中查看特定表盘格式版本的功能，请检查文档页面顶部是否选择了相应的版本按钮。 - 发布指南：了解如何通过 Play 商店和替代方法发布表盘并实现创收。
- WFF 和内存验证器：使用这些开源工具检查您的表盘格式文件是否存在错误，并在提交到 Google Play 之前确认可接受的内存使用量。