將應用程式遷移至 Android 16

本文概略說明一般開發和測試階段,旨在協助您根據平台發布時程擬定計畫備妥應用程式,確保使用者在 Android 16 享有出色體驗。

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

一旦原始碼發布到 Android 開放原始碼計畫 (AOSP),使用者就能開始接收新平台。因此應用程式必須準備妥當,且執行狀況符合使用者預期,最好能夠善用新功能與 API,充分展現新平台的優點。

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

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

確保與 Android 16 相容

請務必針對 Android 16 測試現有應用程式的功能,確保使用者更新至最新 Android 版本時能享有良好體驗。有些平台變更內容可能會影響應用程式的行為,因此請及早進行詳盡測試,視需要調整應用程式。

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

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

取得 Android 16

將 Android 16 系統映像檔刷新到裝置,或下載 Android 模擬器適用的系統映像檔。

查看變更

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

測試

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

更新

程式碼的變更範圍僅限於配合行為變更或解決問題。使用應用程式最初指定的 API 級別重新編譯,無需指定 Android 16。

發布

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

執行相容性測試

大部分情況下,Android 16 的相容性測試與一般應用程式類似。您可以趁這個機會複習核心應用程式品質指南測試最佳做法

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

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

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

完成測試和更新作業後,建議您立即發布相容的應用程式,讓使用者及早測試應用程式。這個做法有助於確保使用者更新到 Android 16 時順利適應。

更新應用程式的指定目標,且建構時使用新 API

發布應用程式的相容版本後,下一步就是更新 targetSdkVersion,並善用 Android 16 的新 API 和功能,提供 Android 16 的全方位支援。您準備完畢即可開始更新,過程中請遵守指定新平台版本的 Google Play 規定

在您計畫全面支援 Android 16 的過程中,請詳閱影響應用程式指定 Android 16 目標版本的行為變更。這些與指定目標版本有關的行為變更,可能會導致功能問題,迫使您需要處理。在某些情況下,這些變更涉及大量開發作業,因此建議您盡早瞭解並解決這些問題。為方便找出會影響應用程式的特定行為變更,可以使用相容性切換按鈕,針對特定變更項目來測試應用程式。

全面支援 Android 16 的操作步驟如下。

取得 Android 16 SDK

安裝最新版本的 Android Studio 預先發布版,以便針對 Android 16 環境建構應用程式。請確認您有可以執行 Android 16 的裝置或模擬器。
更新您的 targetSdkVersion 和其他建構設定。

查看行為變更

查看指定 Android 16 為目標版本時,應用程式適用於哪些行為變更。找出應用程式可能受影響的層面,並擬定支援方式。

查看新的隱私權變更

編寫程式碼並視需要調整架構,以支援 Android 16 的使用者隱私變更。

採用 Android 16 功能

善用 Android 16 API 替應用程式加入新功能。針對 Android 16 重新編譯。

測試

在 Android 16 裝置或模擬器上進行測試。將重點放在行為變更可能對應用程式造成的影響。嘗試執行會用到新 API 的功能。針對平台和 API 提供意見回饋。如果發生平台、API 或第三方 SDK 的相關問題,請回報。

最終更新

Android 16 API 最終版本出現時,請再次更新 targetSdkVersion 和其他建構設定、視需要追加更新項目,然後測試應用程式。

發布

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

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

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

測試 Android 16 應用程式

編譯應用程式並安裝在執行 Android 16 的裝置上之後,請開始測試,確保應用程式可以在指定 Android 16 為目標版本的環境能正常運作。某些行為變更僅適用於應用程式指定新平台版本時,因此請在測試前確認此類變更

和基本的相容性測試一樣,逐步完成所有流程與功能測試,確認是否發生問題。將測試的重點放在應用程式指定 Android 16 為目標版本時會涉及的行為變更。建議您也趁這個機會,檢查應用程式是否遵循核心應用程式品質指南測試最佳做法

請務必檢查受限制非 SDK 介面的使用情形,並視需要進行測試。請留意說明這類存取權的 Logcat 警告,並使用 StrictMode 方法 detectNonSdkApiUsage(),以程式輔助方式進行擷取。

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

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

Android 16 內含相容性切換按鈕,方便您在測試應用程式時指定行為變更。如果應用程式可進行偵錯,切換按鈕可幫助您:

  • 不必實際變更應用程式的 targetSdkVersion,即可測試指定的變更。切換按鈕可以強制啟用特定的行為變更,方便評估該變更對現有應用程式的影響。
  • 僅對特定變更進行測試。有了切換按鈕,您可以只開啟需要測試的變更項目,不需要一次處理所有變更。
  • 透過 ADB 管理切換按鈕。如果變更項目支援切換功能,您可以在自動化測試環境中,透過 ADB 指令啟用/停用這些變更。
  • 使用標準變更 ID 來加速偵錯。如果變更項目可切換啟用/停用狀態,也會附上專屬 ID 和名稱,方便您在輸出的記錄檔中快速找出錯誤的根本原因。

在您準備變更應用程式目標版本,或積極開發 Android 16 的支援內容時,切換按鈕相當實用。詳情請參閱「相容性架構變更 (Android 16)」。