Wear OS 版本資訊

本頁包含 Wear OS 版本的相關資訊，例如穿戴式裝置 SDK 和穿戴式裝置支援資料庫。

2023 年 8 月 31 日穿戴式裝置 SDK 18.1.0

穿戴式裝置 SDK 18.1.0 版包含次要 API 更新，以便支援下一個穿戴式裝置支援資料庫版本。更新內容包括：

支援手機更換，詳情請參閱 NodeClient.OnNodeMigratedListener。
MessageClient 傳送及回覆訊息的其他文件。
更新 API 說明中的連結。

2022 年 9 月 20 日穿戴式裝置 SDK 18.0.0

穿戴式裝置 SDK 18.0.0 版包含次要 API 更新，以便支援下一個穿戴式裝置支援資料庫版本。更新內容包括：

針對以 Android 13 為目標的應用程式提供 WearableListenerService 支援 (問題 235538840)
新的 MessageClient.sendRequest() 方法

2022 年 2 月 16 日穿戴式裝置支援資料庫 2.9.0 版

穿戴式裝置支援資料庫 2.9.0 版淘汰了所有其他類別。請改用 Wear OS Jetpack 程式庫。

2021 年 10 月 29 日 Wear OS Jetpack 程式庫

Wear OS Jetpack 程式庫為取代穿戴式裝置支援資料庫所設，這兩種程式庫的設計無法彼此搭配使用。穿戴式裝置支援資料庫不適用於 Wear OS 3。

2021 年 4 月 27 日穿戴式裝置 SDK 17.1.0

穿戴式裝置 SDK 17.1.0 版包含次要 API 更新，以支援下一個穿戴式裝置支援資料庫版本。

2020 年 9 月 28 日穿戴式裝置支援資料庫 2.8.1 版

穿戴式裝置支援程式庫 2.8.1 版包含下列變更。

允許在使用錶面範本時停用 Jetifier

Android Studio 錶面範本現在使用 AndroidX 依附元件允許停用 Jetifier。這些修正內容會在透過 Android Studio 4.2 以上版本使用錶面範本時生效。

2020 年 9 月 24 日穿戴式裝置支援資料庫 2.8.0 版

穿戴式裝置支援程式庫 2.8.0 版包含下列變更。

用來指定預設非系統小工具供應商的備用功能

錶面目前可以使用 setDefaultComplicationProviderWithFallbacks 指定一或多個預設要使用的非系統小工具供應商。如果沒有安裝指定的非系統供應商，系統會改回使用預設的系統供應商。

WearableActivity 已淘汰

WearableActivity 已淘汰，請改用 AmbientModeSupport。

SKIP_CONFIRMATION_UI 已淘汰

ActionConfirmationActivity.SKIP_CONFIRMATION_UI 已淘汰，這項額外功能從 Wear 2.0 發布後就未曾使用過。

2020 年 5 月 15 日穿戴式裝置支援資料庫 2.7.0 版

穿戴式裝置支援程式庫 2.7.0 版包含下列功能。

錶面硬體加速

現在使用 CanvasWatchFaceService 類別時，你可以要求使用硬體加速畫布。利用硬體加速功能來改善錶面效能，以及存取更多 UI 效能資料。

詳情請參閱「使用硬體加速功能改善錶面效能」。

2020 年 4 月 21 日穿戴式裝置支援資料庫 2.6.0 版

穿戴式裝置支援程式庫 2.6.0 版包含下列改善項目。

遷移至 Android Jetpack

穿戴式裝置支援資料庫已遷移至 Android Jetpack。現有的程式庫現已使用 androidx 命名空間在 AndroidX 中建立對應，並可透過 AndroidX 存取。此外，已淘汰支援資料庫中的所有依附元件均已移除。

這項變更也可讓您在 Android Studio 4.0 以上版本中使用穿戴式裝置支援資料庫，因此解決了問題 #147972079 等問題。

2019 年 8 月 28 日穿戴式裝置支援資料庫 2.5.0 版

穿戴式裝置支援程式庫 2.5.0 版包含下列改善項目。

修正以 TYPE_NO_PERMISSION 小工具類型呼叫 startActivity() 時的 ComplicationDrawable 問題

ComplicationDrawable 現在包含 NEW_TASK 標記，能確保來自 WatchFaceService 的 startActivity() 呼叫包含 FLAG_ACTIVITY_NEW_TASK，藉此避免 android.util.AndroidRuntimeException。

這項變更可讓 TYPE_NO_PERMISSION 小工具類型正確啟動權限要求活動，而不會使錶面停止運作。

2018 年 9 月 25 日穿戴式裝置 SDK 16.0.0

穿戴式裝置 SDK 16.0.0 版將必要的 Google Play 服務版本從 12.4 版降至 8.6 版。這項變更可讓現有應用程式更新至最新版穿戴式裝置 SDK，而不必更新 Google Play 服務 APK。

2018 年 6 月 11 日 Wear OS 開發人員預覽版 2 的更新內容

在 Wear OS 開發人員預覽版 2 近期的無線更新中，背景應用程式的鬧鐘和工作功能已重新啟用。

這項政策變更可進一步提高應用程式開發作業的彈性，但背景鬧鐘和工作功能仍適用其他 Android P 限制，包括與應用程式待命值區相關的限制。請遵循最佳做法，確保應用程式無論在哪個值區中都能正常運作。

此外，這項更新也限制了背景應用程式對於使用者輸入內容和感應器資料的存取權，藉此進一步保護使用者輸入內容和資料隱私權。視應用程式的需求而定，您可能必須使用前景服務持續存取感應器資料。

2018 年 5 月 8 日 Wear OS 開發人員預覽版 2

Wear OS 開發人員預覽版 2 提供更完善的 Google 助理體驗等功能。

請使用 Wear OS by Google Issue Tracker 提交任何錯誤或意見回饋。越早提交，修正內容就越有機會納入最終版本。

已知問題

本節包含預覽版 2 的已知問題。

Wear OS 映像檔相關問題

使用任何應用程式時，如果按下手錶側邊的電源鍵，可能會返回上一個畫面而非錶面。

中國版 Wear OS 映像檔相關問題

使用任何應用程式時，如果按下手錶側邊的電源鍵，可能會返回上一個畫面而非錶面。
與音量相關的音效設定無法保留。舉例來說，即使手錶已關閉音效設定，只要有人來電，手錶就會發出鈴聲。此外，調整鬧鐘音量不會有任何效果。
多則持續性通知可能無法正確顯示。舉例來說，如果同時設定了計時器和碼錶，系統就不會顯示相關通知。建議您只使用一則持續性通知測試應用程式，不要同時使用多則持續性通知。
中國版 Wear 應用程式商店無法運作。開發人員無法透過該管道更新或安裝新的應用程式。建議您改用 ADB，將應用程式側載進行測試。

Wear 模擬器相關問題

在已配對的模擬器中，配對手機接到的來電不會顯示 (或鏡射) 為來電。
使用 SDK Manager 安裝或確認您已安裝最新版 Android P 或中國版時，如果勾選這些選項旁邊的核取方塊，這些方塊可能會變為未勾選狀態。在這種情況下，請再次勾選核取方塊。
當模擬器執行冷啟動時，系統可能會顯示以下錯誤訊息：「您的裝置發生內部問題，詳情請洽詢製造商。」這不會影響相關功能。只要向下捲動並按一下「確定」，即可開始測試應用程式。
模擬器可能不支援語音回覆功能。舉例來說，如果您在 Wear 模擬器中收到 Google Hangouts 訊息通知，並嘗試透過語音回覆訊息，系統會顯示「Google 持續停止」錯誤訊息，您也無法透過語音回覆。
免安裝執行功能可能與 Wear 模擬器不相容。
您可能無法利用程式 (例如透過 ADB 或取得錯誤報告) 擷取螢幕截圖。請改為按一下模擬器工具列中的相機按鈕擷取螢幕截圖。

中國版 Wear 模擬器相關問題

在已配對的模擬器中，配對手機接到的來電可能不會顯示 (或鏡射) 為來電。因此，模擬器中可能不會顯示未接來電通知。此外，您可能無法透過模擬器接聽來電，在這種情況下，裝置會持續發出來電響鈴。
使用 SDK Manager 安裝或確認您已安裝最新版 Android P 或中國版時，如果勾選這些選項旁邊的核取方塊，這些方塊可能會變為未勾選狀態。在這種情況下，請再次勾選核取方塊。
當模擬器執行冷啟動時，系統可能會顯示以下錯誤訊息：「您的裝置發生內部問題，詳情請洽詢製造商。」這不會影響相關功能。只要向下捲動並按一下「確定」，即可開始測試應用程式。
免安裝執行功能可能與 Wear 模擬器不相容。
您可能無法利用程式 (例如透過 ADB 或取得錯誤報告) 擷取螢幕截圖。請改為按一下模擬器工具列中的相機按鈕擷取螢幕截圖。

Wear OS 版 Google 助理

我們改善了對 Wear OS 版 Google 助理的支援，讓您不必編寫 Android 程式碼，就能打造與穿戴式裝置相容的體驗。具體來說，您可以針對 Actions on Google 平台進行建構作業，協助使用者透過您的產品和服務處理大小事。

此外，Wear OS 現可讓您透過語音和觸控方式加快互動速度，而且還支援建議方塊，其功用如下：

協助使用者快速完成互動
為使用者提供動作功能的提示

此外，Wear OS 現在支援更多視覺化資訊卡，以及清單和輪轉介面。

因此，您可以使用 DialogFlow、範本或 Actions SDK，針對 Wear OS 建立 Actions on Google，也可以善用手錶專屬的全新回應範本。Actions on Google 的最佳做法包括：

簡單扼要的對話方塊
提供視覺化和語音意見回饋功能

這些 Wear OS 版 Google 助理強化功能無須搭配 Android P 也可使用，並會向所有 Wear 2.0 使用者推出。如需 Actions on Google 建構方式的簡介，請參閱「與 Google 助理整合」一文。

開發人員預覽版 2 的節約耗電量功能

如下一節所述，現在可透過電源相關功能延長電池續航力。本節的開發人員預覽版 2 相關資訊將取代開發人員預覽版 1 的電源相關資訊。

新模式：強化省電模式

當手錶處於強化省電模式時，系統會顯示預設的省電錶面。下列所有功能都會停用：

收音機
觸控螢幕
傾斜喚醒功能

使用者按一下側邊按鈕可查看時間，長按該按鈕則可切換回完整運作模式，並執行 NFC 付款或回覆訊息等工作。請假設在強化省電模式下，應用程式、錶面和顯示區資料供應應用程式都無法使用。

背景活動受限

為提升電源管理成效，除非手錶已連接充電器，否則背景應用程式無法再啟動鬧鐘和工作，但錶面和使用中的小工具等項目除外。

附註：如果應用程式必須持續執行 (例如進行背景監控)，建議您透過 startForegroundService() 方法使用前景服務。詳情請參閱「背景服務限制」一節。前景服務適用於健康監測等特殊用途。

改善應用程式相容性

為了改善應用程式相容性，Android P 已開始針對非 SDK 介面的使用方式設下特定限制。請進行遷移規劃，停止使用非 SDK 方法和欄位。如果沒有適用於您所需用途的公開對等做法，請告訴我們。

深色 UI 系統主題

自 2018 年初起，Wear OS 已改用新的預設 UI 主題，其中通知串流和系統啟動器的背景顏色較深。這項變更的目的是讓應用程式介面更加一目瞭然。請使用這個新的 UI 主題檢查應用程式的無障礙設計。

新版程式碼研究室現已推出

為協助您瀏覽進行 Wear OS 開發作業的重要方式，我們推出了新版程式碼研究室。舉例來說，您可以在新的 Kotlin 錶面程式碼研究室中，以 Kotlin 領域專屬語言 (DSL) 進行實驗。

2018 年 3 月 27 日 Wear OS 開發人員預覽版 1

本節包含 Wear OS by Google 開發人員預覽版 1 的相關資訊。我們預計在發布正式版之前，針對這個預覽版發布幾項更新。請使用 Wear OS by Google Issue Tracker 提交您發現的任何錯誤。越早提交，修正內容就越有機會納入最終版本。

已知問題

如果在 Wear OS 隨附應用程式中輕觸「回報穿戴式裝置錯誤」，則雖然系統看似已回報錯誤，但實際上並未產生錯誤報告。請改用 adb bugreport。
有時無法使用手錶接聽來電。在這種情況下，使用者必須直接透過手機接聽來電。
配對或啟動預先載入的應用程式後，系統有時會顯示「偵測到 API 相容性問題」錯誤訊息。這則錯誤訊息很快就會消失，不會影響可用性。
在手錶和模擬器的「設定」選單中，「取得錯誤報告」選項會顯示兩次。由於只有其中一個選項有作用，因此如要取得錯誤報告，請逐一嘗試使用這兩個選項。輕觸有作用的選項後，畫面上會出現浮動式訊息，指出系統正在產生錯誤報告。
在中國版中，語音輸入會導致應用程式停止運作。舉例來說，使用語音搜尋或透過語音新增提醒時就會發生這類情況，原因是這項功能會用到語音輸入 API。如要進行測試，請使用鍵盤或手寫方式輸入內容，不要使用語音輸入。
中國版 Wear 應用程式商店無法運作。開發人員無法透過該管道更新或安裝新的應用程式。建議您改用 ADB，將應用程式側載進行測試。

這個開發人員預覽版的重要功能

開發人員預覽版 1 包含下列應用程式測試功能：

受限的背景活動：為提升電源管理成效，背景應用程式無法再使用鬧鐘和執行工作，但錶面和使用者選取的小工具等項目除外。這項功能會在開發人員預覽版中逐步推出，因此可能不會立即您的手錶上發布。
附註：如果應用程式必須持續執行，請使用 startForegroundService() 方法將其改成前景服務。詳情請參閱「背景服務限制」一節。
應用程式使用非 SDK 介面的限制：為了改善應用程式相容性，Android P 已開始針對非 SDK 介面的使用方式設下特定限制。請進行遷移規劃，停止使用非 SDK 方法和欄位。如果沒有適用於您所需用途的公開對等做法，請告訴我們。
深色 UI 系統主題：自 2018 年初起，Wear OS 已改用新的預設 UI 主題，其中通知串流和系統啟動器的背景顏色較深。這項變更的目的是讓應用程式介面更加一目瞭然。請使用這個新的 UI 主題檢查應用程式的無障礙設計。
未配戴手錶時，系統會關閉無線電：為提升電源管理成效，當偵測到使用者長時間未配戴手錶時，系統會關閉藍牙無線電、Wi-Fi 無線電和行動數據無線電。這項功能會在開發人員預覽版中逐步推出，因此一開始可能不會在您的手錶上發布。如果這項功能會導致您難以進行開發，您可以透過 ADB 使用以下指令停用此功能：
adb shell settings put global off_body_radios_off_for_small_battery_enabled 0
藍牙連線中斷時，系統會關閉 Wi-Fi：為提升電源管理成效，當手錶的藍牙連線中斷時，手錶就不會再自動連線至 Wi-Fi。不過在某些情況下，手錶仍會自動連線至 Wi-Fi，例如應用程式必須使用高頻寬網路，或是手錶已連接充電器時。這項功能會在開發人員預覽版中逐步推出，因此一開始可能不會在您的手錶上發布。

穿戴式裝置支援資料庫 2.3.0 版相關更新

穿戴式裝置支援資料庫 2.3.0 版說明文件更新包含品牌重塑更新資訊。

此外，程式庫的 2.3.0 版也包含與 ComplicationDrawable 和 TextRenderer 相關的更新，針對文字範圍附加了標記物件的文字做出了修改。這些類別改善了範圍化文字的處理方式。只有部分文字範圍能夠顯示 (請參閱 setText 方法，瞭解可繪製的文字範圍類型)，這樣當文字範圍顯示於錶面時才不會看起來很突兀。

2018 年 3 月 15 日 Wear 品牌重塑

本節包含 Wear OS 功能的相關資訊。

Android Wear 的新名稱

Android Wear 已重新命名為 Wear OS by Google。

2018 年 2 月 27 日微光模式更新

本節包含 Android Wear 新功能的相關資訊。

支援微光模式的新類別

27.1.0 版的 Android 支援資料庫包含 AmbientModeSupport 這個新類別，用來取代現已淘汰的 AmbientMode 類別。我們預計在未來幾週內更新範例。

2018 年 1 月 25 日最終版模擬器及其他功能

本節包含 Android Wear 新功能的相關資訊。

Android 模擬器：Wear 相關更新

Android 模擬器的最終 Wear 相關更新已可供測試 API 26 版的應用程式。

穿戴式裝置支援資料庫 2.2.0 版中的強化功能

2.2.0 版的穿戴式裝置支援資料庫包含下列更新。

新的未讀取通知指標

使用者想知道是否有未讀取的通知，因此我們提供了一項新指標：錶面底部的圓圈，中間包含一個圓點。如果您想自行管理通知，可以使用 setHideNotificationIndicator 隱藏預設指標並顯示自己的指標，或使用 setShowUnreadCountIndicator 在狀態列中顯示通知計數。

您可以使用 setAccentColor 方法自訂未讀取通知指標的外環顏色。

注意：Wear 2.8.0 正式版不支援未讀取通知指標。請改用最新的 Wear 模擬器測試實作結果。從下一個消費者版本的 Wear (2.9.0 版) 開始，系統預設會顯示未讀取通知指標。

ComplicationDrawable 類別的改善項目

當系統顯示 TYPE_NO_PERMISSION 值 (表示錶面沒有取得小工具資料的權限) 時，ComplicationDrawable 類別會針對使用者輕觸的錶面啟動權限要求。

此外，當圖片載入完成或輕觸醒目顯示期間結束時，ComplicationDrawable 類別會將自身判定為無效。如要回應這項無效判定 (例如重新繪製錶面)，請新增 Drawable.Callback。

已知問題

如果您在模擬器中啟用劇院模式 (請參閱「變更螢幕和亮度設定」一文)，模擬器可能會一直處於劇院模式。如要修正這個問題，您必須清除模擬器資料，詳情請參閱「執行及停止模擬器，並清除資料」一節。
在 API 級別 25 或 26 的模擬器視窗中，電源鍵無法運作。請改用電源鍵以外的按鈕。具體來說，如要切換至微光模式 (例如模擬使用者用手掌遮住螢幕的情形)，請使用模擬器工具列中的電源鍵 (位於畫面右側)。如要透過互動模式啟動應用程式啟動器，請使用模擬器工具列中的主畫面按鈕。
在中國版模擬器中，如果使用手寫輸入法，螢幕可能會開始閃爍。此外，當你點選螢幕小鍵盤的按鈕時，鍵盤會遮住一半的螢幕。

2017 年 12 月 18 日新增 Google Play 服務存取方式

本節包含 Android Wear 新功能的相關資訊。

捨棄 GoogleApiClient 類別

從 11.8.0 版的 Google Play 服務起，Wear 應用程式應進行遷移，不再使用 GoogleApiClient 類別，並改用基於 GoogleApi 類別的 API 用戶端物件和 Tasks API。

注意：這項更新不適用於中國版 Android Wear 應用程式。這類應用程式通常採用 10.2.0 版 Google Play 服務。

詳情請參閱下列資源：




  New components for connecting with Google Play services



  When you use classes that extend the 
  GoogleApi class, such as
  
  DataClient and
  
  MessageClient, the Google Play services SDK manages
  connections to Google Play services for you. Apps that use these classes no longer need to
  create and manage GoogleApiClient
  objects. See the blog post 
  Moving Past GoogleApiClient for more information. 



  For the replacements of Wear-related components for connecting to Google
  Play services, see
  
  Replacements for deprecated components.
  For releases and known issues related to
  Google Play services, see the Release Notes for
  Google Play services.



  Note: If you compile your app with the latest version of
  Google Play services, users are prompted to update their devices to that
  latest version. However, a known issue for apps that target API version
  26 might prevent users from being prompted to update their devices. This
  issue is described in the Release Notes for
  Google Play services.


2017-Oct-25 Ambient mode and more

This section contains information about new Android Wear features.


  Android Support Library, v27.0.0: Features and bugfixes



  The 
  27.0.0 version of the Android Support Library contains new features
  for Wear. Review the following section.



  New, preferred way to support ambient mode



  Ambient mode lets a Wear app remain visible to a user when the
  device goes idle. The Android Support Library has a new,
  preferred way for your apps to use ambient mode. The Wear team seeks
  
  developer feedback about this significant change.



  Specifically, using the 
  AmbientMode class offers the following benefits:



  The Activity
  subclasses in the Android Support Library, such as 
    FragmentActivity. Functionality for
    support library fragments is available.
  

  
    
    Architecture components, which are 
    lifecycle aware.
  

  Better support for Google
  Sign-In.
  



  Manifest metadata constants in the Android Support Library



  Constants for Android Wear apps, used in the meta-data tag
  in the Android Manifest file, are now 
  available in the Android Support Library. To use the constants—for
  standalone apps, notification bridging mode, and watch face preview
  images—add a reference to the following in the dependencies section of
  the app module's build.gradle file, which requires the latest
  version of the Google Repository:



Groovy
implementation 'com.android.support:wear:27.0.0'
Kotlin
implementation("com.android.support:wear:27.0.0")




  Action drawer updates



  Updates are available to the 
  WearableActionDrawerView class, which is used for creating a wearable
  action drawer. In the latest version:



  When menu items are modified, the action drawer properly updates.
  

  If set for an action drawer, the title displays correctly.
  



  Inflation of the RoundedDrawable class


Assuming an API level of at least 24, the
  
  RoundedDrawable class can now be inflated from a drawable XML file;
  see 
  Custom drawables.


  Wearable Support Library, v2.1.0: Enhancements and more



  The 
  2.1.0 version of the Wearable Support Library includes the updates
  described in the following section, and requires Android Support Library version 26.0.2 or
  higher.



  Supply burn-in-safe images for ambient mode



  The 
  ComplicationDrawable class lets you supply burn-in-safe
  images for ambient mode. Specifically, a 
  ComplicationData object's burn-in protection small
  image field lets a watch face display a small image in the
  SMALL_IMAGE complication type, in ambient mode, when burn-in
  protection is enabled.



  Tap event updates for complications



  The 
  ComplicationDrawable class has a new onTap method
  that lets your watch face pass tap events to complications. The new
  method builds on the existing functionality in which a tap on the watch
  face triggers the 
  WatchFaceService.Engine.onTapCommand method.



  You can pass the coordinates to a ComplicationDrawable with
  an onTap call to launch the action associated with the
  ComplicationDrawable that contains the tap coordinates. When
  the new onTap method is called, you can use a return value
  of true to see whether a ComplicationDrawable
  launched the action associated with it.



  Additionally, the setHighlightDuration method sets the
  duration for a complication to remain highlighted after the
  onTap method is called.



  Progress bar for ranged value complications



  If you prefer to draw your own progress bar for ranged value
  complications in your watch face, use the
  setRangedValueProgressHidden method of the
  ComplicationDrawable class to hide the ranged value progress
  that's drawn by the ComplicationDrawable.


2017-Oct-02 Android Wear beta


  
    
      Date: 2017-Oct-02

      Build: OWP4.170828.008

      Supported device: LG Watch Sport

      
    
  


This section contains known issues for an Android Wear beta release. For
  information about the beta program or to enroll,
  see the 
  Android beta page.


  Known issues



  Google Pay and its cards do not function with this Android Wear beta
    release.
  Even if cellular connectivity is on, it is turned off after the beta
    is installed. As a workaround, turn on cellular connectivity after
    the beta is installed by navigating to
    Settings > Connectivity > Cellular.
  If notifications are erratic or missing after a beta update,
    or contacts were not synced, factory-reset your watch.
  In the Wear tutorial, which starts after a watch is set up, some cards
    behave erratically, but they can be dismissed normally with a swipe.
  On Android 6.0  phones, phone call notifications are not
    received on the watch.
  Heart rate monitoring sometimes fails after an update. As a workaround,
    reboot the watch.
  The OTA card in the stream sometimes fails to enable an installation.
    As a workaround, navigate to
    Settings > System > About > System Updates.