注意: 錶面必須符合錶面格式,才能安裝在預先安裝 Wear OS 5 以上版本的裝置上,且所有在 Google Play 發布的新錶面都必須符合錶面格式。
2026 年 1 月起,錶面必須採用錶面格式,才能安裝在所有 Wear OS 裝置上。
如要進一步瞭解使用者會看到的異動,請參閱這篇說明中心文章。

使用者查看手錶時,最先看到的就是錶面,因此錶面是 Wear OS 上使用率最高的介面。使用者會根據自己的風格,透過錶面打造個人專屬的智慧手錶,並快速一覽重要資訊。
建立錶面的選項
錶面格式 (WFF) 可讓您輕鬆建構錶面。錶面格式是 Google 與 Samsung 合作開發的宣告式 XML 格式,可用於設定錶面的外觀和行為。與其他錶面 API 不同,錶面格式只需要資源和宣告式指令,不需要在 APK 中加入用於算繪錶面的程式碼。Wear OS 平台會負責轉譯錶面所需的邏輯,讓您可以專注於實現創意構想,而不必在程式碼最佳化或電池效能方面多費心思。
我們提供多種建立錶面的方式:
- 如果您偏好所見即所得的工具,直接設計錶面,請使用 Watch Face Studio。這項工具是我們與 Samsung 合作推出的。
- 如果您是設計人員,且熟悉使用 Figma,或是開發人員想加快建立錶面的前幾個步驟,請使用 Watch Face Designer,您可以在 Figma 中透過外掛程式存取這項工具。
如要手動管理手錶設定並發布至自己的應用程式商店,可以使用 XML 定義錶面,然後使用 Watch Face Push 發布。
Android Studio 預先發布版支援建構及執行使用錶面格式的錶面。
相較於使用舊版 Jetpack Watch Face 程式庫建構的錶面,以這個格式建構錶面可減少維護和更新的需求。舉例來說,您無需更新錶面,即可提高效能或減少電池耗電量,甚至取得最新的錯誤修正項目。
關於格式
錶面格式 (WFF) 錶面的核心是定義錶面版面配置和行為的文件。這份文件以 XML 編寫,符合 WFF 規格。
Wear OS 系統內含錶面算繪器元件。這個元件會剖析 WFF XML 文件,並從中算繪錶面。系統會視需要提取圖片和字型等其他資源。
也就是說,您只需要花時間說明錶面的外觀,Wear OS 就會處理所有繪製錶面的程式碼。
如要將錶面格式錶面部署至裝置,請將 XML 文件封裝在標準 AAB 或 APK 套件中。
下圖為做法總覽:
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 建構檔案。
瞭解詳情
請參閱下列指南,進一步瞭解錶面格式:
- 可用功能:瞭解各個版本的錶面格式支援哪些錶面功能。
- 設計指南:瞭解錶面版面配置和使用者體驗的最佳做法。
- 錶面設計工具:瞭解如何使用 Figma 外掛程式建立錶面。
- 設定:設定支援錶面格式的 Android App Bundle。
- GitHub 範例:開始建構錶面範例,然後部署至 Wear OS 模擬器或實體裝置。
- 記憶體用量最佳化:瞭解如何設定錶面,讓系統在算繪錶面時盡可能耗用最少記憶體。
- XML 參考資料:瞭解屬於錶面格式檔案的個別元素。根元素一律為
WatchFace
。注意:如要在 XML 參考資料中查看特定錶面格式版本的功能,請確認文件頁面頂端已選取適當的版本按鈕。 - 發布指南:瞭解如何透過 Play 商店和替代方法發布錶面並營利。
- WFF 和記憶體驗證工具:使用這些開放原始碼工具檢查錶面格式檔案是否有錯誤,並確認記憶體用量是否符合規定,再提交至 Google Play。