本頁面由 Cloud Translation API 翻譯而成。

Switch to English

Wear OS 版本資訊

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

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

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

WearableListenerService 支援以 Android 13 為目標的應用程式 (問題 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 依附元件來停用 Jeetifier。這些修正適用於搭載 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 命名空間進行對應與存取，且已淘汰的支援資料庫中的所有依附元件皆已提供已移除。

這項變更也可讓您在 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 App Store 無法運作。開發人員無法透過該管道來更新或安裝新的應用程式。我們建議您使用「adb」做為解決問題的側載應用程式。

Wear 模擬器相關問題

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

中國版 Wear 模擬器相關問題

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

在 Wear 上使用 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 App Store 無法運作。開發人員無法透過該管道來更新或安裝新的應用程式。我們建議您使用「adb」做為解決問題的側載應用程式。

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

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

受限的背景活動：為提升電力管理效率，應用程式無法再使用鬧鐘和工作。只有錶面和使用者選取的小工具能夠啟動。這項功能會在開發人員預覽版中逐步推出，因此你可能不會立即在手錶上看到這項功能。
注意： 如果應用程式必須持續執行，請使用 startForegroundService() 方法將應用程式改成前景服務。詳情請參閱背景服務限制。
應用程式使用非 SDK 介面的限制：為了改善應用程式相容性，Android P 已開始導入使用非 SDK 介面的相關限制。規劃進行遷移，不再使用非 SDK 方法和欄位。如果針對你的用途沒有可用的公開對等方式，請告訴我們。
深色 UI 系統主題：自 2018 年初起，Wear OS 已改用預設的 UI 主題，其中通知串流和系統啟動器的背景顏色較深。這項變更的目的是讓應用程式介面更加一目瞭然；使用新的 UI 主題來查看應用程式的無障礙程度。
當手錶離身而關閉時 。這項功能會在開發人員預覽版中逐步推出，因此你一開始可能不會在手錶上看到這項功能。如果這項功能會對開發程序造成困難，你可以使用下列指令透過「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 版說明文件更新包括品牌重塑相關更新。

此外，程式庫 v2.3.0 包含與 ComplicationDrawable 和 TextRenderer 相關的更新內容，適用於含有文字範圍附加文字物件的文字。這些類別改善了對展開的文字的處理方式。只能顯示一部分的 Span 部分，詳情請參閱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 版將您的 Wear 應用程式從 GoogleApiClient類別，並使用以 API 為基礎的GoogleApi類別和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.