本页介绍了使用表盘格式的表盘的结构,以及如何构建和部署这些表盘。
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 之前检查表盘主题
创建表盘主题并熟悉构建流程后,请先对表盘主题 AAB 执行提交前检查,然后再提交到 Play。
Play 会执行非常类似的检查,因此确保您通过这些提交前检查可以节省提交和审核流程中的大量时间。
以下是运行提交前检查的示例:
这些检查不仅会检查表盘使用的内存量,还会识别其他问题(例如缺少资源),并验证 XML。
如需详细了解如何获取和构建该工具,请参阅内存占用评估器。