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

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

請選取您要從哪一個 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。

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

• 隱私權
  • 強制使用限定範圍儲存空間：應用程式應採用限定範圍儲存空間模型，將應用程式專屬的內容、媒體和其他類檔案儲存到一個專屬位置，並經由這個位置存取這些檔案。
  • 自動重設權限：如果使用者已連續數月未與應用程式互動，系統會自動重設應用程式的私密資訊權限。這項功能對大多數的應用程式沒有影響。如果應用程式主要在背景運作，無需與使用者互動，您可以考慮要求使用者停用自動重設。
  • 背景位置資訊存取權：應用程式必須分別要求前景和背景的位置資訊存取權。 只能透過應用程式設定授予背景位置資訊存取權，而無法在執行階段權限對話方塊中進行。
  • 套件瀏覽權限：當應用程式查詢裝置上已安裝的應用程式和服務清單時，系統會對傳回的清單進行篩選。
    • 如果您使用文字轉語音或 語音辨識服務，則必須在資訊清單檔案中為這些服務新增查詢元素。
• 安全性
  • 系統不再支援經過壓縮的「resource.arsc」檔案
  • 現在必須使用 APK Signature Scheme v2。為了顧及回溯相容性，開發人員也應繼續使用 APK Signature Scheme v1 進行簽署。
  • 非 SDK 介面限制。如果應用程式指定 API 級別 30，我們不建議使用非 SDK 介面，原因在於系統現已封鎖部分非 SDK 介面。如要瞭解 Android 11 已封鎖哪些非 SDK 介面，請參閱這個章節的完整清單。

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

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