您上傳的 APK 必須符合 Google Play 的鎖定 API 級別規定。新應用程式和應用程式更新必須鎖定 Android 10(API 級別 29)或更高版本;而 Wear OS 應用程式則必須鎖定 API 級別 28 或更高級別。
自 2021 年 8 月起,新應用程式必須:
- 使用 Android App Bundle 格式發布。
- 使用 Play Asset Delivery 或 Play Feature Delivery 傳送下載大小超過 150 MB 的素材資源或功能。系統將不再支援新應用程式使用擴充檔案 (OBB)。
- 請鎖定 API 級別 30 (Android 11) 或更高級別,並針對行為變更進行調整;至於 Wear OS 應用程式則必須繼續鎖定 API 級別 28 或更高級別。
自 2021 年 11 月 1 日起,應用程式更新必須鎖定 API 級別 30 或更高級別,並根據 Android 11 針對行為變更進行調整。未收到更新的現有應用程式不會受到影響,仍可繼續透過 Play 商店下載。Wear OS 應用程式必須持續鎖定 API 級別 28 或更高級別。
若改爲使用 Android App Bundle 傳輸,也會影響使用舊版免安裝應用程式 ZIP 格式的免安裝體驗。自 2021 年 8 月起,新的免安裝體驗和現有免安裝體驗的更新都必須發布免安裝即用的應用程式套件。
爲何要鎖定較新的 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 10(API 級別 29)移轉至 Android 11(API 級別 30)
- 隱私設定
- 限定範圍儲存空間:應用程式應採用限定範圍式的儲存空間模型,在此模型中,系統會將針對特定應用程式、媒體及其他檔案類型儲存在專屬位置,並從中存取。
- 自動重設權限:如果使用者已連續數月未與應用程式互動,系統會自動重設應用程式的機密權限。這項功能對大多數的應用程式沒有影響。如果您的應用程式主要在背景運作,沒有與使用者之間的互動,您可以考慮要求使用者停用自動重設。
- 背景位置資訊存取權:應用程式必須分別要求前景和背景的位置資訊存取權。您只能在應用程式設定中授予背景位置資訊存取權,而不能在執行階段的權限對話方塊中操作。
- 套件瀏覽權限:當應用程式查詢裝置上已安裝的應用程式和服務清單時,系統會對傳回的清單進行篩選。
- 安全性
- 系統不再支援壓縮的
resource.arsc
檔案。 - 現在必須採用 APK Signature Scheme v2。為了顧及回溯相容性,開發人員也應繼續使用 APK Signature Scheme v1 進行簽署。
- 非 SDK 介面限制。對於鎖定 API 級別 30 的應用程式,不建議使用非 SDK 介面,因為系統現已封鎖部分非 SDK 介面。如需已封鎖的非 SDK 介面完整清單,請參閱Android 11 中現已封鎖的非 SDK 介面。
- 系統不再支援壓縮的
如需 Android 11(API 級別 30)推出變更的詳盡清單,請參閱行為變更網頁。
從 Android 10 以下版本(API 級別 29)移轉
請選擇要自哪一個 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 及更高版本平台的應用程式:
- 背景執行限制
-
系統會對未在前景執行的應用程式限制其服務。
-
若
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。
翻新您的應用程式
在為應用程式更新到鎖定的 API 級別時,請考慮採用最新的平台功讓應用程式更新,讓使用者享有愉快的使用體驗。
- 建議您使用 CameraX(目前為 Beta 版)充分運用相機功能。
- 使用 Jetpack 元件即可遵循最佳做法,省去編寫樣板程式碼的麻煩,簡化複雜的工作,讓您專心處理重要的程式碼。
- 使用 Kotlin 就能使用更少的程式碼以更快的速度編寫出更出色的應用程式。
- 請務必遵守隱私設定規定和最佳做法。
- 在應用程式中增加對深色主題的支援。
- 在應用程式中增加對手勢操作的支援。
- 將應用程式從 Google 雲端通訊 (GCM) 移轉至 Firebase 雲端通訊最新版本。
- 充份運用進階視窗管理。
- 支援更大的長寬比(大於 16:9)以享受近年來在硬體方面的進步。請確認您的應用程式可調整大小以填滿可用的螢幕空間。只有在萬不得已時才宣告最大的長寬比。若要進一步瞭解最大長寬比,請參閱宣告有限的螢幕支援。
- 新增多視窗模式支援以協助應用程式提高生產力,並管理多個螢幕。
- 如果優質的最小化應用程式可以提升使用者體驗,請新增子母畫面功能的支援。
- 為有螢幕凹口的裝置進行最佳化。
- 請勿假定狀態列的高度。請改爲使用
WindowInsets
和View.OnApplyWindowInsetsListener
。如需相關說明,請觀看這部影片。 - 請勿假定應用程式可完整佔用整個視窗。請改使用
View.getLocationInWindow()
(而非View.getLocationOnScreen()
)確認其位置。 - 處理
MotionEvent
時,請使用MotionEvent.getX()
和MotionEvent.getY()
,而非MotionEvent.getRawX()
、MotionEvent.getRawY()
。
查看並更新您的 SDK 和程式庫
請確認您的第三方 SDK 依附元件支援 API 29:部分 SDK 提供者會在資訊清單中發布這項資訊,其他則必須再進一步研究。如果您使用的是不支援 API 29 的 SDK,請與 SDK 提供者合作,優先處理解決這個問題。
此外,請注意,應用程式或遊戲的 targetSdkVersion
可能會限制對不公開 Android 平台程式庫的存取權。詳情請參閱連結至平台程式庫的 NDK 應用程式。
另外請確認您目前使用的 Android 支援資料庫版本中有哪些限制。一如既往,您必須確認 Android 支援資料庫主要版本和應用程式 compileSdkVersion
之間的相容性。
建議您不要選擇小於或等於支援資料庫主要版本的 targetSdkVersion
。您最好更新至最新且相容的支援資料庫,以便使用最新的相容性功能和錯誤修正。
測試應用程式
正確更新應用程式的 API 級別和功能後,請測試部分的核心用途。以下僅列舉部分建議,目的在於引導您進行測試。我們建議您測試以下項目:
- 您的應用程式已編譯為 API 29,且沒有出現錯誤或警告。
- 您的應用程式對使用者拒絕權限要求的情況已有所因應,且會要求使用者提供權限。方法如下:
- 前往您應用程式的「應用程式資訊」畫面,然後停用所有權限。
- 開啟應用程式,確認不會發生當機狀況。
- 執行核心用途測試,並確認系統會再次要求提供必要權限。
- 「休眠」模式可呈現預期結果,且不會發生錯誤。
- 使用 adb,讓執行中的應用程式進入「休眠」模式。
- 測試所有會觸發 Firebase 雲端通訊訊息的用途。
- 測試所有使用鬧鐘或工作的用途。
- 清除背景服務的所有依附元件。
- 將您的應用程式設為「應用程式待命」模式
- 測試所有會觸發 Firebase 雲端通訊訊息的用途。
- 測試所有使用鬧鐘的用途。
- 使用 adb,讓執行中的應用程式進入「休眠」模式。
- 處理拍攝的新相片/影片
- 檢查您的應用程式是否正確處理受限的
ACTION_NEW_PICTURE
和ACTION_NEW_VIDEO
廣播(也就是移至 JobScheduler 作業)。 - 確認所有依賴這些事件的重大用途都能正常運作。
- 檢查您的應用程式是否正確處理受限的
- 處理和其他應用程式共用檔案的作業
- 測試所有和其他應用程式共用檔案資料的用途(甚至是由相同開發人員開發的其他應用程式)
- 測試其他應用程式是否能看到內容而不會導致當機。
其他資訊
在 Google Play 管理中心選擇接收電子郵件,以便接收我們傳送給您的重大 Android 及 Google Play 最新資訊與公告,其中包含我們每個月的合作夥伴電子報。