本页介绍了使用表盘格式的表盘的结构,以及如何构建和部署它们。
WFF 表盘的结构
表盘格式的表盘会像其他任何应用一样以 AAB 或 APK 的形式提交到 Play 商店。因此,它们与其他应用共享许多常见属性,例如需要 AndroidManifest.xml
文件,但它们具有特定的结构。
- 表盘的所有内容都位于资源文件夹中,即
res/
- 所有表盘定义都位于
res/raw/
中,包括简单情况下的res/raw/watchface.xml
以及表示支持不同设备尺寸的任何其他 XML 定义。 - 表盘所需的所有资源都位于相应的资源文件夹中,就像常规应用一样,例如:
/res/font
适用于字体/res/drawable
,适用于图片和动画素材资源/res/values/strings.xml
适用于任何字符串资源
使用 Android Studio 构建表盘主题
Android Studio 为表盘格式提供编辑器支持,可帮助您编写和调试 XML 定义。

具体功能包括:
- 基于官方表盘格式架构的标记和属性代码补全功能。
- 实时验证,以识别缺失的属性和类似的语法错误。
- 资源链接,可快速导航到 XML 文件中引用的可绘制资源、数据源和其他元素。
- 一种运行配置,可让您在设备上查看表盘。
使用 Gradle 构建表盘主题
如需最轻松地了解如何使用 Gradle 构建表盘,请查看 GitHub 上的示例。
除了构建表盘之外,这些项目中的 Gradle 脚本还会使用验证器工具检查表盘 XML 的有效性。
在向 Google Play 提交之前检查表盘主题
创建表盘并熟悉构建流程后,请在向 Play 提交表盘 AAB 之前对其执行提交前检查。
Play 会执行非常类似的检查,因此确保您通过这些提交前检查可以节省提交和审核流程中的大量时间。
运行提交前检查的示例:
这些检查不仅会检查表盘使用的内存量,还会发现其他问题,例如缺少资源,以及验证 XML。
如需详细了解如何获取和构建该工具,请参阅内存占用空间评估器。