符合 Google Play's 目標 API 級別規定

上傳的 APK 必須符合 Google Play 的目標 API 級別規定。

自 2024 年 8 月 31 日起，下列規定將會生效：

  • 新應用程式和應用程式更新必須指定 Android 14 (API 級別 34) 以上版本，才能提交至 Google Play；Wear OS 和 Android TV 應用程式除外，這類應用程式必須指定 Android 13 (API 級別 33) 以上版本。
  • 現有應用程式則須指定 Android 13 (API 級別 33) 以上版本為目標，才能繼續提供給裝置上 Android 作業系統高於這個目標 API 級別的新使用者。如果應用程式指定 Android 12 (API 級別 31) 以下版本 (Wear OS 為 Android 10 (API 級別 29) 以下；Android TV 則為 Android 11 (API 級別 30) 以下)，則只有在 Android 作業系統版本不高於應用程式目標 API 級別的裝置上，才能使用該應用程式。

如需更多時間更新應用程式，您可以申請將期限延至 2024 年 11 月 1 日。今年稍晚，您就能在 Play 管理中心存取應用程式的期限展延表單。

以下是不適用這些規定的應用程式：

  • 永久性的私人應用程式：僅內部發行，只有特定機構的使用者能存取的應用程式。
  • 應用程式本身或一併封裝的 APK，將 Android Automotive OS 設為目標平台。

為何要指定較新的 SDK？

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

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

本文件特別介紹了一些重點，協助您更新目標 API 級別，以滿足 Google Play 的要求。請根據遷移目標版本，參閱下列各節的操作說明。

從 Android 12 以上版本 (API 級別 31) 遷移至較新版本

如要將應用程式更新為指定較新的 Android 版本，請參考相關行為變更清單：

從 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 級別時，請考慮透過最新平台功能更新應用程式，讓使用者享有愉快的使用體驗。

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

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

另請注意，應用程式或遊戲的 targetSdkVersion 可能會限制對私人 Android 平台程式庫的存取權，詳情請參閱「連結至平台程式庫的 NDK 應用程式」。

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

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

測試應用程式

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

  • 您的應用程式已編譯為 API 29，且沒有出現錯誤或警告。

  • 您的應用程式對使用者拒絕權限要求的情況已有應對策略，且會要求使用者提供權限。方法如下：

    • 前往應用程式的「應用程式資訊」畫面，停用所有權限。
    • 開啟應用程式，確認不會發生當機狀況。
      • 執行核心用途測試，並確認系統會再次要求提供必要權限。

  • 「打盹」模式可呈現預期結果，且不會發生錯誤。

    • 使用 ADB，讓執行中的應用程式進入「休眠」模式。
      • 測試所有會觸發 Firebase 雲端通訊訊息的用途。
      • 測試所有使用鬧鐘或工作的用途。
      • 清除背景服務的所有依附元件。
    • 將應用程式設為「應用程式待命」模式
      • 測試所有會觸發 Firebase 雲端通訊訊息的用途。
      • 測試所有使用鬧鐘的用途。

  • 處理拍攝的新相片 / 影片

  • 處理與其他應用程式共用檔案的作業 - 測試所有與其他應用程式共用檔案資料的用途 (包括同一開發人員的其他應用程式)

    • 測試其他應用程式是否能看到內容而不會導致當機。

其他資訊

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