本頁說明使用錶面格式的錶面結構,以及如何建構及部署錶面。
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。
如要瞭解如何取得及建構這項工具,請參閱「記憶體用量評估工具」。