封裝及發布 Wear 應用程式

使用者可以透過 Wear OS 用手錶前往 Play 商店,並直接在手錶上下載 Wear 應用程式。另外,使用者也可以透過 Play 商店網頁直接在手錶安裝應用程式。

如果 Wear 應用程式有隨附的行動應用程式,則您必須用同一組金鑰簽署這兩個應用程式,以便兩者透過 Data Layer API 通訊。

Play 商店準備工作

如要讓您的應用程式出現在智慧型手錶專用的 Play 商店中,請在 Play 管理中心上傳手錶版 APK,方法和其他 APK 完全相同。如果您只有手錶版 APK 而沒有手機版 APK,則不需採取其他行動。

如果您除了手錶版 APK 以外還有手機版 APK,則必須使用多重 APK 提交方式

發布到 Wear 手錶

在搭載 Wear OS 的裝置上,當使用者安裝擁有隨附手錶應用程式的手機應用程式時,系統便會發出可以取得手錶應用程式的手錶通知。使用者輕觸通知即可開啟手錶的 Play 商店,商店會提供選項讓使用者安裝手錶應用程式。

如果透過 Play 管理中心上傳手錶版 APK,則可以獨立更新 Wear APK,不會影響手機版 APK。接下來,使用者可以透過手錶的 Play 商店接收更新。把更新推送到 Play 管理中心之後,應用程式便會自動更新,除非使用者在手錶的 Play 商店設定中停用了自動更新功能。使用者也可以手動透過 Play 商店更新應用程式。

指定版本代碼

手錶版 APK 的版本代碼可使用與手機版 APK 不同的配置,且其版本代碼也不得重複。

目前無法同時為手機和手錶建立一個共用的 APK。

如果 Wear APK 和隨附應用程式 APK 共用程式碼並須配合版本,則您應該將版本代碼的最後兩位數保留給 APK 變數使用。APK 變數的其中一個例子便是 CPU 架構。範例可參考「支援多個 APK」。

以下為建議使用的版本代碼配置:

  • 將版本代碼前兩位數設定為 targetSdkVersion,例如 28。
  • 將接下來的三位數設定為產品版本,例如用 152 代表 1.5.2 產品版本。
  • 將接下來的兩位數設定為版本編號,例如 01。
  • 將最後兩位數保留給多重 APK 變數使用,例如 00。

使用此處建議的版本代碼範例值 (28、152、01 和 00) 後,此範例 APK 變數的版本代碼就是 251520100。

也請參閱「設定應用程式版本資訊」。

設定手錶指定目標

您必須在 Android 資訊清單檔案中將 uses-feature 元素設定為 android.hardware.type.watch。另外,請勿把 required 屬性設定為 false。目前尚未支援同時為 Wear 和非 Wear 裝置建立單一 APK。

因此,如果有 APK 設定與以下範例相同,Google Play 就只會提供 APK 給手錶使用:

<manifest package="com.example.standalone"
    xmlns:android="http://schemas.android.com/apk/res/android">
    <uses-feature
        android:name="android.hardware.type.watch"/>
    ...
</manifest>

請將上述程式碼範例中的 android.hardware.type.watch 設定與其他條件結合,例如 SDK 版本、螢幕解析度和 CPU 架構。這樣做之後,不同的 Wear APK 即可對應不同的硬體設定。

指定應用程式的獨立設定

Wear 需要使用手錶應用程式 Android 資訊清單檔案中的 meta-data 元素,當做 <application> 元素的子項。meta-data 元素的名稱為 com.google.android.wearable.standalone,且值必須設定為 truefalse。此元素會說明手錶應用程式是否為獨立應用程式,以及該手錶應用程式是否能夠不需搭配手機使用 (核心功能包括不需要其他裝置進行驗證)。

請參閱「獨立與非獨立 Wear OS 應用程式」一文,瞭解如何宣告獨立設定,並取得手錶應用程式分類的其他相關說明。

即使這個值為 false,還是可以先安裝手錶應用程式,再安裝手機應用程式。

注意:如果 Wear 應用程式有隨附的手機應用程式,則 Wear 應用程式和手機應用程式都必須使用相同的套件名稱。

使用 Play 管理中心

您可以使用 Play 管理中心上傳獨立的 Wear APK 到應用程式資訊內。

另請參閱「支援多個 APK」和「管理應用程式」相關說明。請在上傳前確定 APK 已經簽署完畢,詳情請見本主題的後續說明。

上傳並發布 APK

使用 Play 管理中心上傳並發布 APK 的程序與行動裝置類似。此外,您需要在 Play 管理中心選擇加入 Wear OS,如以下步驟所示:

  1. 前往 Play 管理中心的「設定」並點選開啟更多選項。
  2. 前往「Advanced Settings」並選取「Release types」分頁標籤,然後按一下「Add release type」。
  3. 按一下「Wear OS」

上傳 Wear OS 應用程式的螢幕截圖,然後在應用程式的 Google Play 商店資訊中提及 Wear OS。詳情請參閱「發布至 Wear OS」一文。

Play 商店拒絕 Wear OS 應用程式的常見原因

請參閱以下清單,盡可能避免應用程式遭到 Play 商店拒絕。另外也請參閱 Wear OS 應用程式品質頁面,確定應用程式符合這些規範。

商店資訊中未提及「Wear OS」

開發人員必須在 Wear/手錶應用程式的商店資訊中提及「Wear OS」。

基本功能故障

這個分類非常廣泛,不過如果應用程式無法正確發揮功能,便有可能遭拒。請務必使用模擬器和實體裝置徹底測試您的應用程式。

另外,請確保應用程式螢幕截圖可以反映應用程式的真實樣貌。如果螢幕截圖不準確,系統會認定應用程式並未提供宣傳的功能,因此拒絕發布應用程式。

沒有 Wear 螢幕截圖

所有應用程式都必須提供 Wear 螢幕截圖。這個程序和行動裝置類似,您可以輕鬆利用 Android Studio 達成目的。另外,我們也有為螢幕截圖提供數款 Wear 錶面。

格式不適合圓形螢幕

如果應用程式不支援圓形螢幕,請務必在 Play 商店說明中指明。否則,如果應用程式無法在圓形螢幕上正確轉譯版面配置,便會遭到拒絕。

請務必使用圓形裝置或模擬器測試應用程式,確保相同版面配置可以正確轉譯。建議使用 Android Studio 的版面配置檢查器內附的 Wear OS 版面配置。詳情請參閱「開啟版面配置檢查器」。

不符合功能規定

不符合功能規定的常見例子為未針對 Wear 強化通知功能。請您務必遵守視覺效果指南的規範,若是訊息應用程式,請使用 RemoteInput 讓使用者可以回覆訊息。