升級至最新版 Wear OS

Stay organized with collections Save and categorize content based on your preferences.

從 Wear 2.0 升級

本指南說明 Wear OS 的升級程序。

Android 專屬變更

Wear 2.0 包含從 API 級別 25 到 API 級別 28 的多個 Android 版本。

注意:Android 10 (API 級別 29) 沒有任何 Wear OS 版本。

如果 Wear OS 應用程式指定 Wear OS 2.0 (API 級別 28),則要升級的作業大部分都是處理從 Android 9 (API 級別 28) 至 Android 11 (API 級別 30) 的平台變更。

由於 Android 10 (API 級別 29) 沒有任何 Wear OS 版本,因此當您將 compileSdkVersiontargetSdkVersion 欄位從 28 變更為 30 時,需要一次處理這些變更。

注意:即使您不在應用程式中變更 compileSdkVersiontargetSdkVersion,請確保應用程式與 API 級別 29 相容

Wear-OS 專屬變更

Wear OS 2.0 中擁有資訊方塊小工具、重疊、錶面及許多其他介面。不過,您必須修改使用者介面,才能加入最新的設計規範。

如果您使用的是目前的錶面 API (非 Jetpack),LegacyWatchFaceOverlayStyle API 將無法在 Wear OS API 級別 30 上執行。

API 級別 30 包含 Ongoing Activity API

進行中的活動允許「進行中的通知」在 Wear OS 使用者介面中的其他介面顯示,讓使用者能夠對於長時間執行的活動提升參與程度。

注意:新版 Alpha 錶面 API 的某些功能僅適用於搭載 API 級別 30 以上的裝置。

選擇初始版本

如「Android 專屬變更」一節所述,Wear OS 版本會連結至 Android 版本。選擇要使用的初始版本時,考慮最常使用的 Wear OS 裝置。

大多數開發人員都會建構指定 API 級別 30 的可靠應用程式,但會讓 minSdkVersion 版本夠低,以鎖定最熱門的 Android 版本。舉例來說,如要允許 Wear 2.0 裝置支援,請將 minSdkVersion 設為 25。

如果你具有 Android 開發經驗,在 Wear OS 上大部分的知識都類似。如要瞭解不同之處,請參閱「Wear OS 對比行動裝置開發」。

注意:API 級別 30 的 Wear OS 模擬器系統映像檔,目前仍為開發人員預覽版。 如需最新資訊,請參閱「版本資訊」。

適用於 Wear OS 的 Jetpack 程式庫

Wear OS Jetpack 程式庫是五個包含與穿戴式裝置支援程式庫相似功能的程式庫,且為 Wear OS 3 提供更好的支援。

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

詳情請參閱「 Wear OS Jetpack 程式庫穩定版」。