錶面格式

注意： 如要在預先安裝 Wear OS 5 以上版本的裝置上安裝錶面，或是在 Google Play 發布所有新錶面，則必須使用錶面格式。

自 2026 年 1 月起，凡是在所有 Wear OS 裝置上安裝錶面，都必須採用錶面格式。

如要進一步瞭解對使用者造成的影響，請參閱這篇說明中心文章。

使用者查看手錶時，最先看到的就是錶面，因此錶面是 Wear OS 上使用率最高的介面。使用者會根據自己的風格和需求，透過錶面打造個人專屬的智慧手錶，並快速掌握資訊。

目標對象

全新的錶面格式 (WFF) 讓錶面建構作業更加輕鬆。我們與 Samsung 合作推出了 Watch Face Studio，這是一種所見即所得的工具，可讓您直接設計錶面。

如果您想手動管理手錶設定，也可以使用 XML 定義錶面。這些指南適用於使用 XML 或建構自訂工具來使用錶面格式建立錶面的開發人員。Android Studio 也支援使用錶面格式建構及執行錶面。

錶面格式是 Google 與 Samsung 合作開發的宣告式 XML 格式，可用於設定錶面的外觀和行為。與其他錶面 API 不同，錶面格式只需要資源和宣告式指示，不像 APK 必須包含用於轉譯錶面的程式碼。Wear OS 平台會負責轉譯錶面所需的邏輯，讓您可以專注於實現創意構想，而不必在程式碼最佳化或電池效能方面多費心思。

相較於使用舊版 Jetpack Watch Face 程式庫建構的錶面，以這個新格式建構錶面可減少維護和更新的需求。舉例來說，您無需更新錶面，即可提高效能或減少電池耗電量，甚至取得最新的錯誤修正項目。

關於格式

錶面格式 (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。