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

從 Android 10 以下版本（API 級別 29）移轉

請選擇要自哪一個 Android 版本移轉：

移轉至 Android 5（API 級別 21）

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

• Android 5.0（API 級別 21）
• Android 4.4（API 級別 19）。
• Android 4.1.x（API 級別 16）。

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

移轉至 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 及更高版本平台的應用程式：

• 背景執行限制
  • 系統會對未在前景執行的應用程式限制其服務。
    • 若 startService() 受到禁止，現在當應用程式嘗試叫用 startService() 會產生例外狀況。
    • 若要啟用前景服務，應用程式必須使用 startForeground()和 startForegroundService()。
    • 仔細查看對 JobScheduler API 所做的變更；內容如 Android 8.0（API 級別 26）行為變更網頁所述。
    • Firebase 雲端訊息須使用 Google Play 服務 SDK 10.2.1 版或更高版本。
    • 使用 Firebase 雲端訊息時，訊息的傳送會受限於背景執行的限制。如收到訊息後需執行背景工作（例如執行背景資料同步），您的應用程式應透過 Firebase Job Dispatcher 或 JobIntentService 進行工作排程。詳情請參閱Firebase 雲端訊息說明文件。
  • 隱式廣播
    • 隱式廣播的使用有其限制。若要進一步瞭解和處理背景事件相關的資訊，請參閱 JobScheduler API 的說明文件。
  • 背景位置資訊限制
    • 在背景執行的應用程式在存取位置資料時會受到限制。
      • 有 Google Play 服務的裝置請使用整合式位置預測提供工具定期取得位置的更新資訊。
• 通知管道
  • 您應為每個管道定義通知中斷屬性。
  • 您必須為要顯示的通知指定一個管道。
  • 這個平台版本支援 NotificationCompat.Builder。
• 隱私設定
  • 每個應用程式簽署金鑰有其所屬的 ANDROID_ID。

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

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

• 電源管理
  • 應用程式待命值區會根據應用程式的參與情況提供新的背景限制，例如延後工作、鬧鐘以及高優先順序訊息的配額
  • 改善省電模式增加對待命式應用程式的限制
• 前景服務權限
  • 必須要求一般權限 FOREGROUND_SERVICE（非執行階段權限）
• 隱私設定變更
  • 限制存取背景感應器
  • 限制存取通話記錄，現在移入 CALL_LOG 權限群組
  • 限制存取電話號碼，必須具備 READ_CALL_LOG 的權限
  • 限制存取 Wi-Fi 資訊

如需 Android 9.0（API 級別 28）推出變更的詳盡清單，請參閱行為變更。

從 Android 9（API 級別 28）移轉至 Android 10（API 級別 29）

• 使用全螢幕意圖的通知
  • 必須要求一般權限 USE_FULL_SCREEN_INTENT（非執行階段權限）。
• 支援折疊式裝置和大螢幕裝置
  • 現在，多個活動可同時進入「已恢復」狀態，但實際上焦點只會在一個活動上。
    • 這項變更會影響 onResume() 和 onPause() 的行為。
    • 訂閱 onTopResumedActivityChanged() 即可偵測到新的「最上方已恢復」生命週期的概念。
      • 只有一個活動處於「最上方已恢復」狀態。
  • 將 resizeableActivity 設定為 false 時，應用程式也可以另外指定 minAspectRatio，自動為長寬比較窄的應用程式加上上下黑邊的效果。
• 隱私設定變更
  • 限定範圍儲存空間
    • 外部的儲存空間存取僅限於應用程式的特定目錄，以及應用程式已建立的特定媒體類型。
  • 當應用程式在背景執行，要存取受限定的位置必須具備 ACCESS_BACKGROUND_LOCATION 權限。
  • 對無法重設的 ID（例如 IMEI 和序號）限制存取。
  • 對體能活動資訊限制存取，例如使用者步數必須具備 ACTIVITY_RECOGNITION 權限。
  • 限制存取部分電話、藍牙和 Wi-Fi API，必須具備 ACCESS_FINE_LOCATION 權限。
  • 限制存取 Wi-Fi 設定
    • 應用程式無法直接啟用或停用 Wi-Fi，必須使用設定面板來執行這項操作。
    • 限制開始連線到一個 Wi-Fi 網路，必須使用 WifiNetworkSpecifier 或 WifiNetworkSuggestion。

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