符合 Google Play 的目標 API 級別規定

您上傳的 APK 必須符合 Google Play 的目標 API 級別規定。新應用程式和應用程式更新必須指定 Android 11 (API 級別 30) 以上版本。如果是 Wear OS 應用程式,就必須指定 API 級別 28 以上版本。

自 2022 年 8 月起,新的應用程式必須指定 API 級別 31 (Android 12) 以上版本,並依據行為變更進行調整。Wear OS 應用程式則必須指定 API 級別 28 以上版本。

自 2022 年 11 月起,應用程式更新必須指定 API 級別 31 以上版本,並依據 Android 12 的行為變更進行調整。

注意:自 2022 年起,新使用者將無法在搭載較新版本的 Android 裝置上執行部分舊版應用程式。

為何要指定較新的 SDK?

每個新的 Android 版本都會推出變更,可提升安全性與效能,並改善 Android 使用者體驗。某些變更僅適用於透過 targetSdkVersion 資訊清單屬性 (也就是目標 API 級別) 明確宣告支援的應用程式。

如果您設定讓應用程式支援最新的 API 級別,就能讓使用者享受到這些提升的效益,同時可繼續讓您的應用程式在較舊版本的 Android 上正常運作。指定使用最新 API 級別也有助於讓應用程式充分發揮平台的最新功能,讓使用者用得更加愉快。此外,從 Android 10 (API 級別 29) 開始,如果應用程式指定使用 Android 5.1 (API 級別 22) 以下版本,使用者在首次啟動應用程式時會看到警告

本文件特別介紹了一些重點,協助您更新目標 API 級別,以滿足 Google Play 的要求

如要從較舊版本遷移資料,請參閱下方的完整異動清單

注意:如果您的 Gradle 檔案含有資訊清單項目,您可以按照這個章節的設定版本說明,確認或變更應用程式 Gradle 檔案中目前的 targetSdkVersion 值。或者,您也可以按照 <uses-sdk> 資訊清單元素說明文件中的指示,使用資訊清單檔案中的 android:targetSdkVersion 屬性。

從 Android 11 (API 級別 30) 遷移至 Android 12 (API 級別 31)

安全性和權限

使用者體驗

  • 自訂通知:選用自訂內容檢視畫面的通知將不再使用完整通知區域,而是改為採用標準範本。這個範本可確保自訂通知與所有狀態的其他通知採用相同的裝飾設定。這個行為與 Notification.DecoratedCustomViewStyle 的行為幾乎相同。
  • Android 應用程式連結驗證功能異動:使用 Android 應用程式連結驗證功能時,請確保意圖篩選器包含了「BROWSABLE」類別,並支援 HTTPS 配置。

效能

  • 前景服務啟動限制:如果您指定使用 Android 12 以上版本,應用程式在背景執行時就無法啟動前景服務 (少數特殊情況除外)。如果應用程式嘗試在背景執行時啟動前景服務,就會發生例外情況 (少數特殊情況除外)。

    在應用程式於背景執行的情況下,建議您使用 WorkManager 安排及啟動加急作業。如要完成使用者要求且須及時處理的動作,請在確切的鬧鐘時間內啟動前景服務。

  • 通知彈跳床限制:當使用者輕觸通知時,部分應用程式會啟動應用程式元件,其所開啟的活動可供使用者查看及互動。這個應用程式元件又稱為通知彈跳床。

    應用程式不得透過用來做為通知彈跳床的服務或廣播接收器來啟動活動。使用者輕觸通知中的通知訊息或動作按鈕後,您的應用程式就無法在服務或廣播接收器中呼叫 startActivity()

請查看這個連結,瞭解會對指定 Android 12 (API 級別 31) 的應用程式產生影響的完整變更資訊。

從 Android 11 以下版本 (API 級別 30) 遷移

請選取您要從哪一個 Android 版本遷移:

移轉至 Android 5(API 級別 21)

請依據版本查看下方對應的「行為變更」網頁,以確認您的應用程式已將這些版本推出的變更納入考量:

請按照下一節的說明繼續操作。

移轉至 Android 6(API 級別 23)

以下注意事項適用於鎖定 Android 6.0 及更高版本平台的應用程式:

  • 執行階段權限

    • 只能在執行階段中授予危險權限。您的 UI 操作流程必須提供授予這些權限的預設用途。

    • 請盡可能讓應用程式準備好處理權限要求遭拒。舉例來說,如果使用者拒絕裝置 GPS 的存取要求,請確保您的應用程式能以其他方式繼續執行。

如需 Android 6.0(API 級別 23)推出變更的詳盡清單,請參閱該平台版本的行為變更網頁。

請按照下一節的說明繼續操作。

移轉至 Android 7(API 級別 24)

以下注意事項適用於鎖定 Android 7.0 及更高的平台版本的應用程式:

  • 休眠和應用程式待命

    請參閱這篇文章,瞭解如何為打盹和應用程式待命進行最佳化,並據此設計應用程式的行為。這篇文章的內容也包含在多個平台版本推出的漸進式變更資訊。

    裝置處於打盹和應用程式待命模式時,系統的行為如下:

    • 限制網路存取權
    • 延後鬧鐘、同步處理作業及工作
    • 限制 GPS 和 Wi-Fi 掃描
    • 限制一般優先順序 Firebase 雲端通訊訊息。
  • 權限變更

    • 系統限制存取應用程式的不公開目錄。
    • 在應用程式以外顯示 file:// URI 會觸發 FileUriExposedException。如果必須在在應用程式以外分享檔案,請執行 FileProvider
  • 系統禁止連結至非 NDK 程式庫。

如需 Android 7.0(API 級別 24)推出變更的詳盡清單,請參閱該平台版本的行為變更網頁。

請按照下一節的說明繼續操作。

移轉至 Android 8(API 級別 26)

以下注意事項適用於鎖定 Android 8.0 及更高版本平台的應用程式:

如需 Android 8.0(API 級別 26)推出變更的詳盡清單,請參閱該平台版本的行為變更網頁。

從 Android 8 (API 26) 移轉至 Android 9 (API 28)

如需 Android 9.0(API 級別 28)推出變更的詳盡清單,請參閱行為變更

從 Android 9(API 級別 28)移轉至 Android 10(API 級別 29)

從 Android 10 (API 級別 29) 遷移至 Android 11 (API 級別 30)

如需 Android 11 (API 級別 30) 推出變更的詳盡清單,請參閱行為變更網頁。

請按照上一節的操作說明繼續更新至 API 31。

翻新您的應用程式

在為應用程式更新到目標 API 級別時,請考慮透過最新平台功能更新應用程式,讓使用者享有愉快的使用體驗。

  • 建議您使用 CameraX(目前為 Beta 版)充分運用相機功能。
  • 使用 Jetpack 元件即可遵循最佳做法,省去編寫樣板程式碼的麻煩,簡化複雜的工作,讓您專心處理重要的程式碼。
  • 使用 Kotlin 就能使用更少的程式碼以更快的速度編寫出更出色的應用程式。
  • 務必遵守隱私權規定和最佳做法。
  • 在應用程式中增加對深色主題的支援。
  • 在應用程式中增加對手勢操作的支援。
  • 將應用程式從 Google 雲端通訊 (GCM) 遷移至 Firebase 雲端通訊最新版本。
  • 充份運用進階視窗管理。

查看並更新您的 SDK 和程式庫

請確認您的第三方 SDK 依附元件支援 API 29:部分 SDK 提供者會在資訊清單中發布這項資訊,其他則必須再進一步研究。如果您使用的是不支援 API 29 的 SDK,請與 SDK 提供者合作,優先處理解決這個問題。

另外請注意,應用程式或遊戲的 targetSdkVersion 可能會限制對不公開 Android 平台程式庫的存取權。如要進一步瞭解連結至平台程式庫的 NDK 應用程式,請參閱這個章節

另外請確認您目前使用的 Android 支援資料庫版本中有哪些限制。一如既往,您必須確認 Android 支援資料庫主要版本和應用程式 compileSdkVersion 之間的相容性。

建議您不要選擇小於或等於支援資料庫主要版本的 targetSdkVersion。您最好更新至最新的相容支援資料庫,以便使用最新的相容性功能和錯誤修正。

測試應用程式

正確更新應用程式的 API 級別和功能後,請測試部分的核心用途。以下僅列舉部分建議,目的在於引導您進行測試。我們建議您測試以下項目:

  • 您的應用程式已編譯為 API 29,且沒有出現錯誤或警告。
  • 您的應用程式對使用者拒絕權限要求的情況已有應對策略,而且會要求使用者提供權限。方法如下:
    • 前往您應用程式的「應用程式資訊」畫面,然後停用所有權限。
    • 開啟應用程式,確認不會發生當機狀況。
    • 執行核心用途測試,並確認系統會再次要求提供必要權限。

  • 「休眠」模式可呈現預期結果,且不會發生錯誤。
    • 使用 adb,讓執行中的應用程式進入「休眠」模式。
      • 測試所有會觸發 Firebase 雲端通訊訊息的用途。
      • 測試所有使用鬧鐘或工作的用途。
      • 清除背景服務的所有依附元件。
    • 將您的應用程式設為「應用程式待命」模式
      • 測試所有會觸發 Firebase 雲端通訊訊息的用途。
      • 測試所有使用鬧鐘的用途。

  • 處理拍攝的新相片/影片
    • 檢查您的應用程式是否正確處理受限的 ACTION_NEW_PICTUREACTION_NEW_VIDEO 廣播(也就是移至 JobScheduler 作業)。
    • 確認所有依賴這些事件的重大用途都能正常運作。
  • 處理和其他應用程式共用檔案的作業
    • 測試所有和其他應用程式共用檔案資料的用途(甚至是由相同開發人員開發的其他應用程式)
    • 測試其他應用程式是否能看到內容而不會導致當機。

其他資訊

在 Google Play 管理中心選擇接收電子郵件,以便接收我們傳送給您的重大 Android 及 Google Play 最新消息及公告,包含我們的每月合作夥伴電子報。