將應用程式遷移至 Android 13

本文件以進階觀點提供一般開發和測試階段說明,協助您配合平台發布時程,擬定應用程式就緒度計畫,確保使用者享有出色的 Android 13 體驗。

每次發布 Android 版本時,我們都會推出新功能和行為變更,讓 Android 更實用、更安全且效能更佳。在多數情況下,您的應用程式均可立即正常運作,但在某些情況下,您可能需要更新應用程式以配合平台變更。

一旦原始碼發布到 Android 開放原始碼計畫 (Android 開放原始碼計畫),使用者就能開始接收新平台,因此應用程式必須準備就緒,以便使用者正常運作,並充分利用新功能和 API 充分利用新平台。

一般遷移作業分為兩個階段,可同時進行:

  • 確保應用程式相容性 (在 Android 13 最終版本推出之前)
  • 以新的平台功能和 API 為目標 (在最終版本發布後盡快實現)

確保與 Android 13 相容

請務必針對現有應用程式測試 Android 13 的功能,以確保使用者更新至最新 Android 版本時,能享有良好體驗。有些平台變更可能會影響應用程式的行為,因此請儘早進行全面的測試,並對應用程式進行必要的調整。

一般而言,你不需要變更應用程式的 targetSdkVersion,即可調整應用程式並發布更新。同樣地,您應該也不需要使用新的 API 或變更應用程式的 compileSdkVersion,但這取決於應用程式的建構方式和所使用的平台功能。

開始測試之前,請務必熟悉所有應用程式的行為變更。即使您未變更應用程式的 targetSdkVersion,這些變更仍可能對您的應用程式造成影響。

取得 Android 13

將 Android 13 系統映像檔刷新至您的裝置,或下載 Android 模擬器的系統映像檔。

檢查變更

查看系統行為變更,找出應用程式可能受到影響的層面。

測試

在裝置或模擬器上安裝應用程式,然後執行測試。關注系統行為變更,並順利完成所有應用程式流程。

更新

您只需要針對因應行為變更或解決問題,進行必要的程式碼變更。使用應用程式最初指定的 API 級別重新編譯,無需指定 Android 13 目標版本。

發布

簽署、上傳及發布更新版 Android App Bundle 或 APK。

執行相容性測試

大部分情況下,Android 13 的測試相容性與一般應用程式測試類似。建議您趁此機會檢閱核心應用程式品質指南測試最佳做法

如要進行測試,請在執行 Android 13 的裝置上安裝目前的已發布應用程式,並逐步完成所有流程與功能,同時確認是否有任何問題。為了協助您專注於測試,請參閱 Android 13 中導入的所有應用程式行為變更,瞭解可能影響應用程式功能或導致應用程式停止運作的行為變更。

此外,請務必檢查並測試受限制的非 SDK 介面使用情形。您應將應用程式使用的所有受限制介面更換為公用 SDK 或 NDK 的對應項目。請留意說明此類存取權限的 Logcat 警告,並使用 StrictMode 方法 detectNonSdkApiUsage(),以程式輔助方式擷取這些警告。

最後,請務必完整測試應用程式的程式庫和 SDK,以確保兩者可在 Android 13 上正常運作,並遵循隱私權、效能、使用者體驗、資料處理和權限的最佳做法。如有任何問題,請試著更新至最新版 SDK,或向 SDK 開發人員尋求協助。

完成測試並進行更新後,建議您立即發布相容的應用程式。如此可讓使用者及早測試應用程式,協助確保使用者在更新至 Android 13 之後,享有流暢的移轉體驗。

更新應用程式的指定目標,並使用新的 API 進行建構

發布相容的應用程式版本後,下一步就是透過更新 targetSdkVersion,並善用 Android 13 中的新 API 和功能,提供 Android 13 的完整支援。您準備就緒後即可進行更新,但請留意鎖定新平台目標版本的 Google Play 規定

在您計畫全面支援 Android 13 的過程中,請檢閱影響指定 Android 13 為目標版本應用程式的行為變更。這些與鎖定目標版本相關的行為變更可能會導致需要您善加處理的功能問題。在某些情況下,這些變更需要大規模的開發,因此建議您盡早瞭解並解決這些問題。為方便找出會影響應用程式的特定行為變更,可以使用相容性切換來測試已啟用所選變更的應用程式。

下列步驟說明如何全面支援 Android 13。

取得 Android 13 SDK

安裝最新版本的 Android Studio 預先發布版,以便使用 Android 13 進行建構。請確認您有 Android 13 裝置或模擬器。
更新您的 targetSdkVersion 和其他建構設定。

查看行為變更

查看會套用至指定 Android 13 為其目標版本應用程式的行為變更。找出應用程式可能受影響的層面,並擬定支援方式。

查看新的隱私權變更

編寫程式碼並進行必要的架構調整,以支援 Android 13 的使用者隱私變更。

採用 Android 13 功能

善用 Android 13 API,為應用程式提供新功能與能力。針對 Android 13 重新編譯。

測試

在 Android 13 裝置或模擬器上進行測試。將重點放在行為變更可能對應用程式造成影響的層面。試試看使用新 API 的功能。針對平台和 API 提供意見回饋。回報任何平台、API 或第三方 SDK 問題。

最終更新

Android 13 API 定案後,請再次更新 targetSdkVersion 和其他建構設定、進行任何必要的更新,然後測試應用程式。

發布

簽署、上傳及發布更新版 Android App Bundle 或 APK。

取得 SDK、變更指定目標、使用新的 API 進行建構

如要開始測試完整的 Android 13 支援功能,請使用最新的 Android Studio 預先發布版下載 Android 13 SDK 和其他所需工具。接著請更新應用程式的 targetSdkVersioncompileSdkVersion,然後重新編譯應用程式。詳情請參閱 SDK 設定指南

測試 Android 13 應用程式

編譯應用程式並將其安裝在執行 Android 13 的裝置上之後,請開始進行測試,以確保應用程式在以 Android 13 為目標的環境中能正常運作。某些行為變更僅會在應用程式鎖定新平台版本的情況下套用,因此請在測試前確認這些變更

和進行基本的相容性測試一樣,逐步完成所有流程與功能測試,並確認是否有任何問題。將測試的重點放在指定 Android 13 版本作為目標版本的應用程式行為變更。建議您根據核心應用程式品質指南測試最佳做法,對應用程式進行檢查。

請務必查看並測試可能適用的受限制非 SDK 介面的使用情形。請留意說明此類存取權限的 Logcat 警告,並使用 StrictMode 方法 detectNonSdkApiUsage(),以程式設計方式進行擷取。

最後,請務必完整測試應用程式的程式庫和 SDK,以確保兩者可在 Android 13 上正常運作,並遵循隱私權、效能、使用者體驗、資料處理和權限的最佳做法。如有任何問題,請試著更新至最新版 SDK,或向 SDK 開發人員尋求協助。

使用「應用程式相容性」切換按鈕進行測試

Android 13 內含相容性切換按鈕,方便您對指定行為變更的應用程式進行測試。如果是可進行偵錯的應用程式,切換按鈕可讓您:

  • 在不必實際變更應用程式 targetSdkVersion 的情況下,對鎖定的變更進行測試。您可以使用切換按鈕,強制啟用鎖定的特定行為變更,藉此評估該變更對現有應用程式的影響。
  • 僅對特定變更進行測試。如果在以指定版本為目標的變更中,您只想測試其中某些變更,則可使用切換按鈕停用不想測試的其他變更,不需要一次處理所有變更。
  • 透過 ADB 管理切換按鈕。您可以在自動化測試環境中使用 ADB 指令啟用及停用可切換的變更。
  • 使用標準變更 ID 加快偵錯速度。每個可切換的變更都有專屬 ID 和名稱,可用於在記錄輸出內容中快速找出錯誤的起因。

當您準備變更應用程式的指定目標,或在進行支援 Android 13 的開發作業時,切換按鈕可提供實用協助。詳情請參閱相容性架構變更 (Android 13)