錶面格式

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

目標對象

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

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

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

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

關於格式

錶面格式 (WFF) 錶面的核心是一項定義錶面版面配置和行為的文件。本文件採用 XML 編寫,符合 WFF 規格。

Wear OS 系統包含錶面轉譯器元件。這個元件會剖析 WFF XML 文件,並根據該文件算繪錶面。系統會視需要擷取圖片和字型等其他資源。

這個方法表示您只需花時間說明錶面的外觀,Wear OS 會處理所有用於繪製錶面的程式碼。

如要將錶面格式錶面部署至裝置,請將 XML 文件封裝在標準 AAB 或 APK 套件中。

下圖為這項做法的總覽:

Wear OS 系統如何從錶面格式 XML 文件算繪錶面。

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。