本頁說明 Android 11 (API 級別 30) 相容性架構中新增的每個應用程式影響行為變更。當您準備指定 Android 11 時，請使用此清單搭配開發人員選項和 ADB 指令，為應用程式進行測試與偵錯。
添加內容
變更 ID：150939131
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
針對指定 Android 11 為目標版本的應用程式，有一個新的公用 API 超載 onChange(boolean, Uri, int)，其中包含整數 flags 引數。
如果應用程式使用包含整數 userId 引數的非 SDK onChange() 超載方法，這個新方法就是公開 SDK 的替代方案。
ADMIN_APP_PASSWORD_COMPLEXITY
變更 ID：123562444
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
針對以 Android 11 為目標版本的管理員應用程式，如果應用程式設定的密碼要求與目前指派的密碼品質無關，則擲回錯誤。舉例來說，當密碼品質設為 DevicePolicyManager.PASSWORD_QUALITY_UNSPECIFIED 時，應用程式就無法設定密碼長度下限。在此情況下，應用程式必須先呼叫 setPasswordQuality() 方法，然後只呼叫 setPasswordMinimumLength() 方法，才能設定密碼長度下限。
此外，如果指定 Android 11 的管理員應用程式降低密碼品質，任何不再套用的現有密碼規定都會重設為預設值。
APP_DATA_DIRECTORY_ISOLATION
變更 ID：143937733
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
無論其他應用程式的目標 SDK 版本為何，指定 Android 11 的應用程式將無法再存取「任何」應用程式的私人資料目錄中的檔案。
詳情請參閱「私人目錄的存取權」一文。
APN_READING_PERMISSION_CHANGE_ID
變更 ID：124107808
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
針對指定 Android 11 為目標版本的應用程式，現在必須使用 Manifest.permission.WRITE_APN_SETTINGS 權限才能存取 APN 資料庫。
如要進一步瞭解這項變更，請參閱 APN 資料庫的有限讀取權限。
BACKGROUND_RATIONALE_CHANGE_ID
變更 ID：147316723
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
現在，應用程式每次要求在背景存取裝置位置資訊時，都必須提供有效的原因。
如要進一步瞭解這項變更，請參閱「在 Android 11 中存取背景位置資訊」指南，其中討論 Android 11 中與位置資訊相關的隱私權異動。
CALLBACK_ON_CLEAR_CHANGE
變更 ID：119147584
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
現在只要呼叫 Editor.clear，系統就會使用 null 鍵對 OnSharedPreferenceChangeListener.onSharedPreferenceChanged 進行回呼。
如要進一步瞭解這項變更，請參閱「OnSharedPreferenceChangeListener 的回呼變更」。
CALLBACK_ON_MORE_ERROR_CODE_CHANGE
變更 ID：130595455
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
updateAvailableNetworks(List,
Executor,
Consumer) 和 setPreferredOpportunisticDataSubscription(int, boolean, Executor,
Consumer) 的錯誤代碼現已展開。
CALL_BACK_ON_CHANGED_LISTENER_WITH_SWITCHED_OP_CHANGE
變更 ID：148180766
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
這是 startWatchingMode(String, String,
AppOpsManager.OnOpChangedListener) 的細微行為變更。在這項變更之前，系統會返回已切換運算作業。變更完成後，如果未指定運算，系統會回頭針對實際要求的運算或所有切換的運算。
CAMERA_MICROPHONE_CAPABILITY_CHANGE_ID
變更 ID：136219221
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
針對以 Android 11 為目標版本的應用程式，只有在資訊清單檔案中將 R.attr.foregroundServiceType 和 ServiceInfo.FOREGROUND_SERVICE_TYPE_MICROPHONE 分別設為 ServiceInfo.FOREGROUND_SERVICE_TYPE_CAMERA 和 ServiceInfo.FOREGROUND_SERVICE_TYPE_MICROPHONE，前景服務才會收到使用期間和麥克風的功能。在較舊的 Android 版本中，前景服務會自動取得相機和麥克風功能。
如要進一步瞭解這項變更，請參閱「Android 11 中的前景服務類型」。
CHANGE_BACKGROUND_CUSTOM_TOAST_BLOCK
變更 ID：128611929
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
應用程式無法再在背景發布自訂浮動式訊息。不過，應用程式在背景使用 Toast.makeText(Context, CharSequence,
int) 方法及其變化版本時，仍可發布浮動式訊息。
如要進一步瞭解這項變更，請參閱「自訂浮動式訊息檢視畫面遭到封鎖」。
CHANGE_RESTRICT_SAW_INTENT
變更 ID：135920175
預設狀態：您無法切換這項變更。此變更僅由相容性架構記錄。
使用 android.settings.MANAGE_APP_OVERLAY_PERMISSION 動作和 package 資料 URI 配置的意圖不會再將使用者導向至應用程式的特定畫面，以便管理相關權限。而是會將使用者導向至可管理已要求權限的應用程式畫面。
CHANGE_TEXT_TOASTS_IN_THE_SYSTEM
變更 ID：147798919
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
文字浮動式訊息現在是由 SystemUI (而非應用程式內) 轉譯。這可以防止應用程式規避在背景張貼自訂浮動式訊息的限制。
DEFAULT_SCOPED_STORAGE
變更 ID：149924527
預設狀態：已為所有應用程式啟用。
凡是指定 Android 11 為目標版本的應用程式，現在都會預設使用限定範圍儲存空間，且無法再停用限定範圍儲存空間。
不過，無論應用程式的目標 SDK 版本和資訊清單旗標值為何，您都可以在沒有限定範圍儲存空間的情況下測試應用程式，只要關閉這項變更即可。
如要進一步瞭解 Android 11 中的限定範圍儲存空間異動，請參閱本頁的「限定範圍儲存空間」一節，瞭解 Android 11 中的 Android 儲存空間異動。
EMPTY_INTENT_ACTION_CATEGORY
變更 ID：151163173
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
針對以 Android 11 為目標版本的應用程式，如果意圖篩選器的 action 或 category 為空白字串，系統會擲回錯誤。在 Android 11 之前的平台中，有一項錯誤能夠傳遞這個案例，而不會擲回錯誤。請注意，這不包含屬性為空值或缺少的情況，因為一定會擲回錯誤。
FILTER_APPLICATION_QUERY
變更 ID：135549675
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
應用程式現在必須宣告要使用的套件和意圖，才能取得裝置上其他應用程式的詳細資料。這類宣告必須使用應用程式資訊清單中的 <queries> 標記。
如要進一步瞭解如何在 Android 11 中查詢其他已安裝的應用程式並進行互動，請參閱「套件瀏覽權限」隱私權頁面。
FORCE_ENABLE_SCOPED_STORAGE
變更 ID：值：132649864
預設狀態：已為所有應用程式停用。
凡是指定 Android 11 為目標版本的應用程式，現在都會預設使用限定範圍儲存空間，且無法再停用限定範圍儲存空間。
不過，如果應用程式仍指定 Android 10 (API 級別 29) 以下版本，無論應用程式的目標 SDK 版本和資訊清單旗標值為何，您都可以使用限定範圍儲存空間測試應用程式。
如要進一步瞭解 Android 11 中的限定範圍儲存空間異動，請參閱本頁的「限定範圍儲存空間」一節，瞭解 Android 11 中的 Android 儲存空間異動。
GET_DATA_CONNECTION_STATE_R_VERSION
變更 ID：148535736
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
如要檢查 PreciseDataConnectionState#getDataConnectionState 的 SDK 版本，
GET_DATA_STATE_R_VERSION
變更 ID：148534348
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
如要查看 getDataState() 的 SDK 版本，
GET_PROVIDER_SECURITY_EXCEPTIONS
變更 ID：150935354
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
針對指定 Android 11 (API 級別 30) 以上版本的應用程式，getProvider(String) 將不再擲回任何安全性例外狀況。
GET_TARGET_SDK_VERSION_CODE_CHANGE
變更 ID：145147528
預設狀態：已針對指定 Android 10 (API 級別 29) 以上版本為目標的應用程式啟用。
檢查 SmsManager.sendResolverResult() 方法的 SDK 版本。
GWP_ASAN
變更 ID：135634846
預設狀態：已為所有應用程式停用。
在應用程式中啟用取樣的原生記憶體錯誤偵測功能。
如要進一步瞭解這項變更，請參閱 GWP-ASan 指南。
HIDE_MAXTARGETSDK_P_HIDDEN_APIS
變更 ID：149997251
預設狀態：已針對指定 Android 10 (API 級別 29) 以上版本為目標的應用程式啟用。
如果應用程式指定 Android 10 (API 級別 29) 以上版本為目標，請移除 Android 10 (API 級別 29) max-target-p (greylist-max-p) 清單中的所有非 SDK 介面存取權。
HIDE_MAXTARGETSDK_Q_HIDDEN_APIS
變更 ID：149994052
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
如果應用程式指定 Android 11 (API 級別 30) 以上版本為目標，請移除 Android 11 (API 級別 30) max-target-q (greylist-max-q) 清單中的所有非 SDK 介面存取權。
如要進一步瞭解這項變更，請參閱Android 11 中現已封鎖的非 SDK 介面。
LISTEN_CODE_CHANGE
變更 ID：147600208
預設狀態：已針對指定 Android 10 (API 級別 29) 以上版本為目標的應用程式啟用。
如要查看 TelephonyManager.listen(PhoneStateListener,
int) 的 SDK 版本，
MISSING_APP_TAG
變更 ID：150776642
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
針對指定 Android 11 為目標版本的應用程式，現在當應用程式的資訊清單檔案缺少 application 或 instrumentation 標記時，系統會擲回錯誤。
NATIVE_HEAP_POINTER_TAGGING
變更 ID：135754954
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
現在，針對指定 Android 11 為目標版本的應用程式，在最重要的位元組中，原生堆積分配量會有非零的標記。
詳情請參閱「堆積指標標記」。
PHONE_STATE_LISTENER_LIMIT_CHANGE_ID
變更 ID：150880553
預設狀態：已為所有應用程式啟用。
針對指定 Android 11 為目標版本的應用程式，現在任何程序能透過 TelephonyManager.listen(PhoneStateListener, int) 註冊的 PhoneStateListener 物件數量設有限制。預設限制為 50，可能會透過遠端裝置設定更新變更。
當停用程序嘗試註冊太多事件監聽器時，系統會使用 TelephonyManager.listen(PhoneStateListener, int) 擲回的 IllegalStateException 強制執行這項限制。
PREVENT_META_REFLECTION_BLACKLIST_ACCESS
變更 ID：142365358
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
指定 Android 11 為目標版本的應用程式無法再使用額外的反射層存取受限制的非 SDK 介面。
PROCESS_CAPABILITY_CHANGE_ID
變更 ID：136274596
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
針對指定 Android 11 為目標版本的應用程式，旗標 Context.BIND_INCLUDE_CAPABILITIES 現在可用來將使用期間功能從用戶端程序傳遞至繫結服務。
REMOVE_ANDROID_TEST_BASE
變更 ID：133396946
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
針對以 Android 11 為目標版本的應用程式，如果應用程式未依附 android.test.runner，系統會移除 android.test.base 程式庫，因為該程式庫取決於 android.test.base 程式庫的類別。
要求存取權
變更 ID：136293963
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
針對指定 Android 11 的無障礙服務，現在必須在無障礙服務中繼資料檔案中指定 FLAG_REQUEST_ACCESSIBILITY_BUTTON 標記。否則系統會忽略該旗標。
如要進一步瞭解這項變更，請參閱在中繼資料檔案中宣告無障礙工具按鈕用途。
RESOURCES_ARSC_COMPRESSED
變更 ID：132742131
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
如果指定 Android 11 (API 級別 30) 的應用程式含有壓縮的 resources.arsc 檔案，或是該檔案未對齊 4 位元組邊界，則無法安裝。
如要進一步瞭解這項變更，請參閱「壓縮資源檔案」。
RESTRICT_STORAGE_ACCESS_FRAMEWORK
變更 ID：141600225
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
如果應用程式指定 Android 11 為目標版本，且使用儲存空間存取架構 (SAF)，您就無法再使用 ACTION_OPEN_DOCUMENT 和 ACTION_OPEN_DOCUMENT_TREE 意圖動作存取特定目錄。如要進一步瞭解上述異動，請參閱頁面中的「文件存取限制」一節，瞭解 Android 11 儲存空間的相關隱私權更新。
SELINUX_LATEST_CHANGES
變更 ID：143539591
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
這項變更會限制應用程式存取 Trust_app_R-targetSDk SELinux 網域。
這是相容性架構中的其中一項基本變更，可讓應用程式切換受 targetSdkVersion 管制的其他變更，而不必變更應用程式的 targetSDKVersion。因此，建議您不要針對指定 Android 11 為目標版本的應用程式停用這項變更，否則應用程式將無法運作。
這項異動不會對使用共用使用者 ID 的應用程式造成影響。
THROW_SECURITY_EXCEPTIONS
變更 ID：147340954
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
在 Android 11 之前，只有 setEnabled API 會針對權限錯誤擲回 SecurityException。在 Android 11 中，此舉不再是如此，而且可能會基於任何原因擲回 SecurityException，這些原因都不會向呼叫端公開。
為維持現有的 API 行為，如果未指定 Android 11 的應用程式發生舊版權限失敗或執行者強制執行失敗，例外狀況會強制轉換為 Android 11 之前來源中存在的 IllegalStateException。
USE_SET_LOCATION_ENABLED
變更 ID：117835097
預設狀態：已針對指定 Android 11 (API 級別 30) 以上版本為目標的應用程式啟用。
指定 Android 11 為目標版本的管理員應用程式無法再使用 DevicePolicyManager.setSecureSetting(ComponentName, String, String) 變更已淘汰的 Settings.Secure.LOCATION_MODE 設定。應使用 DevicePolicyManager.setLocationEnabled(ComponentName, boolean)。