將應用程式遷移至 Android 15

本文件提供一般開發和測試階段的概要資訊 這有助於您制定每日準備指數,並且與您的 以及確保使用者在 Android 15。

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

一旦原始碼符合以下條件,使用者就能開始接收新平台 發布至 Android 開放原始碼計畫 (Android 開放原始碼計畫),因此這對您的應用程式至關重要 而且效能最好 以便發揮新平台的最大效益。

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

  • 確保應用程式相容性 (在 Android 15 最終版本推出之前)
  • 以新的平台功能和 API 為目標 (在 最終版)

確保與 Android 15 相容

請務必針對現有應用程式測試各項功能 Android 15,以確保更新至 最新的 Android 版本部分平台變更可能會影響應用程式 所以請務必及早進行完整測試 你對應用程式所做的調整

你通常不必進行變更,即可調整應用程式並發布更新 應用程式的 targetSdkVersion。同樣地,您也不應需要使用新的 API 變更應用程式的 compileSdkVersion,但這取決於 以及所使用的平台功能。

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

取得 Android 15

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

檢查變更

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

測試

在裝置或模擬器上安裝應用程式,然後執行測試。焦點內容 ,並處理所有應用程式流程。

更新

只須變更因應行為所需的程式碼變更 變更或解決問題使用相同的 API 級別重新編譯 應用程式目標,無需指定 Android 15。

發布

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

執行相容性測試

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

如要進行測試,請在以下作業系統的裝置上安裝目前的已發布應用程式: Android 15,並逐步完成所有流程與功能 提出的問題為了能專注於測試 查看應用程式導入的所有應用程式行為變更 Android 15 可能會影響應用程式的運作方式或 應用程式停止運作。

此外,請務必檢查並測試受限制的非 SDK 使用情形 介面。您應替換應用程式使用的任何受限介面 具備公用 SDK 或 NDK 的對等項目。留意有哪些 Logcat 警告指出這些 存取,並使用 StrictMode 方法 detectNonSdkApiUsage() 來擷取 以程式輔助的方式建構內容

最後,請務必完整測試應用程式的程式庫和 SDK, 確保它們可在 Android 15 上正常運作,並遵循最佳做法 以及隱私權、效能、使用者體驗、資料處理和權限的相關做法。如果發生以下情況: 發現問題、嘗試更新至最新版本的 SDK,或與 向 SDK 開發人員尋求協助

完成測試並進行更新後,建議您 立即切換至相容應用程式可讓使用者及早測試應用程式 可協助您在使用者更新至 Android 15。

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

發布相容的應用程式版本後,下一步就是 更新 targetSdkVersion 即可全面支援 Android 15 並運用 Android 15 中的全新 API 和功能 您準備就緒後即可進行更新。提醒您, 指定新平台的 Play 規定。

在您計畫全面支援 Android 15 的過程中,請檢閱 影響指定 Android 15 為目標版本應用程式的行為變更。 這些與鎖定目標版本相關的行為變更可能會導致功能問題,導致您需要 讓我們看看 DNS 解析 進一步探索內部和外部位址在某些情況下,這些變更需要大幅發展, 建議您盡早瞭解並解決這些問題。協助 找出影響應用程式的特定行為變更,並使用相容性 切換按鈕,以便在啟用所選變更的情況下測試應用程式。

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

取得 Android 15 SDK

安裝最新版本的 Android Studio 預先發布版以進行建構 。請確認您有 Android 15 裝置 模擬器。
更新 targetSdkVersion 和其他版本 儲存空間設定

查看行為變更

查看套用到應用程式指定目標的行為變更 Android 15。找出應用程式可能受影響的層面、 並計劃如何提供支援

查看新的隱私權變更

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

採用 Android 15 功能

善用 Android 15 API 提供新功能並 用於你的應用程式針對 Android 15 重新編譯。

測試

在 Android 15 裝置或模擬器上進行測試。聚焦在區域 行為變更可能對應用程式造成影響。試用 請務必透過使用新 API 的功能提供平台和 API 提供意見回饋。回報任何平台、API 或第三方 SDK 問題。

最終更新

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

發布

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

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

如要開始測試完整的 Android 15 支援功能,請使用最新版本的 Android Studio 預先發布版,以便下載 Android 15 SDK 以及任何您需要的工具接著,請更新應用程式的 targetSdkVersion,並 compileSdkVersion,然後重新編譯應用程式。請參閱 SDK 設定指南,瞭解 詳細資料。

測試 Android 15 應用程式

編譯應用程式並將其安裝在執行 Android 15:開始測試,確保應用程式正常運作 且指定國家/地區版本部分行為變更只會在 您的應用程式鎖定新的平台,因此建議您查看 變更

和進行基本的相容性測試一樣,逐步完成所有流程, 有助於瞭解問題狀況請著重在 指定 Android 15 版本作為目標版本的應用程式行為變更。是 建議您根據核心應用程式品質指南檢查應用程式 以及測試最佳做法

請務必查看並測試受限制的非 SDK 介面使用情形 或特定模型或模型留意指出這些存取權限和用途的 Logcat 警告 使用 StrictMode 方法 detectNonSdkApiUsage() 來擷取 編寫程式

最後,請務必完整測試應用程式的程式庫和 SDK, 確保它們可在 Android 15 上正常運作,並遵循最佳做法 以及隱私權、效能、使用者體驗、資料處理和權限的相關做法。如果發生以下情況: 發現問題、嘗試更新至最新版本的 SDK,或與 向 SDK 開發人員尋求協助

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

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

  • 不必實際變更應用程式的 targetSdkVersion。您可以使用切換按鈕強制啟用 鎖定目標行為,以評估對現有應用程式的影響。
  • 僅對特定變更進行測試。與其為了 一次處理所有指定變更,只要使用切換按鈕,就能停用 鎖定變更,但您要測試的項目除外
  • 透過 ADB 管理切換按鈕。您可以使用 ADB 指令 停用自動化測試環境中可切換的變更。
  • 使用標準變更 ID 加快偵錯速度。每個可切換的變更都 可在記錄中快速找出錯誤根源的專屬 ID 和名稱 輸出內容

準備變更應用程式的指定目標 開發支援 Android 15 時,切換按鈕可提供實用協助。如需更多資訊 請參閱相容性架構變更 (Android 15)