行為變更：指定 Android 11 的應用程式

和先前版本一樣，Android 11 也包含可能會影響應用程式的行為變更。以下行為變更僅適用於指定 Android 11 以上版本為目標的應用程式。如果您的應用程式將 targetSdkVersion 設為 30，建議您視情況修改應用程式，以支援這些行為。

另外，請務必查看影響所有在 Android 11 上執行的應用程式的行為變更清單。

隱私權

Android 11 導入了變更和限制功能，強化使用者隱私，包括：

• 強制使用限定範圍儲存空間：外部儲存空間目錄的存取權僅限於特定應用程式目錄，以及應用程式已建立的特定媒體類型。
• 自動重設權限：如果使用者已連續數月未與應用程式互動，系統會自動重設應用程式的私密資訊權限。
• 背景位置資訊存取權：使用者必須導向至系統設定，才能將背景位置資訊存取權授予應用程式。
• 套件瀏覽權限：當應用程式查詢裝置上已安裝應用程式的清單時，系統會篩選傳回的清單。

詳情請參閱隱私權頁面。

安全性

堆積指標標記

變更項目詳情

變更名稱：NATIVE_HEAP_POINTER_TAGGING

變更 ID：135754954

切換方式

測試應用程式與 Android 11 的相容性時，您可以使用下列 ADB 指令開啟或關閉這項變更：

adb shell am compat enable (135754954|NATIVE_HEAP_POINTER_TAGGING) PACKAGE_NAME
adb shell am compat disable (135754954|NATIVE_HEAP_POINTER_TAGGING) PACKAGE_NAME

如要進一步瞭解相容性架構及切換變更，請參閱「在應用程式中測試及偵錯平台行為變更」。

在最重要的位元組 (MSB) 中，堆積指標現在有非零的標記。如果應用程式未正確使用指標 (包括修改 MSB 的應用程式)，現在可能會當機或遇到其他問題。為支援已啟用 ARM Memory Tagging Extension (MTE) 的未來硬體，請務必做出這項變更。詳情請參閱「標記指標」。

如要停用這項功能，請參閱 allowNativeHeapPointerTagging 資訊清單說明文件。

浮動式訊息更新

已封鎖背景的自訂浮動式訊息

基於安全性考量並維持良好的使用者體驗，如果指定 Android 11 或以上版本的應用程式從背景傳送包含自訂檢視的浮動式訊息，系統會封鎖包含自訂檢視的浮動式訊息。請注意，系統仍允許使用文字浮動式訊息；這些浮動式訊息是透過未呼叫 setView() 的 Toast.makeText() 所建立的浮動式訊息。

如果應用程式嘗試從背景發布包含自訂檢視區塊的浮動式訊息，系統不會向使用者顯示訊息。而是會將下列訊息記錄在 logcat 中：

W/NotificationService: Blocking custom toast from package \
  <package> due to package not in the foreground

浮動式訊息回呼

如果想在浮動式訊息 (文字或自訂) 出現或消失時收到通知，請使用 Android 11 新增的 addCallback() 方法。

文字浮動式訊息 API 變更

指定 Android 11 以上版本為目標的應用程式會看到文字浮動式訊息的以下副作用：

• getView() 方法會傳回 null。
• 下列方法的傳回值無法反映實際值，因此，您不應該在應用程式中參考這些值：
  • getHorizontalMargin()
  • getVerticalMargin()
  • getGravity()
  • getXOffset()
  • getYOffset()
• 以下方法不是人工作業，因此您的應用程式不應使用這些方法：
  • setMargin()
  • setGravity()

連線能力

APN 資料庫的讀取權限有限

變更項目詳情

變更名稱：APN_READING_PERMISSION_CHANGE_ID

變更 ID：124107808

切換方式

測試應用程式與 Android 11 的相容性時，您可以使用下列 ADB 指令開啟或關閉這項變更：

adb shell am compat enable (124107808|APN_READING_PERMISSION_CHANGE_ID) PACKAGE_NAME
adb shell am compat disable (124107808|APN_READING_PERMISSION_CHANGE_ID) PACKAGE_NAME

如要進一步瞭解相容性架構及切換變更，請參閱「在應用程式中測試及偵錯平台行為變更」。

以 Android 11 為目標的應用程式現在需要 Manifest.permission.WRITE_APN_SETTINGS 特殊權限，才能讀取或存取「電話」供應商 APN 資料庫。如果嘗試在沒有這項權限的情況下存取 APN 資料庫，就會產生安全性例外狀況。

無障礙功能

在資訊清單檔案中宣告與 TTS 引擎的互動

由於套件瀏覽權限有所變更，如果應用程式指定 Android 11 並與文字轉語音 (TTS) 引擎互動，就必須在資訊清單檔案中加入下列 <queries> 元素：

<queries>
  <intent>
    <action
       android:name="android.intent.action.TTS_SERVICE" />
  </intent>
</queries>

在中繼資料檔案中宣告無障礙工具按鈕用途

變更項目詳情

變更名稱：REQUEST_ACCESSIBILITY_BUTTON_CHANGE

變更 ID：136293963

切換方式

測試應用程式與 Android 11 的相容性時，您可以使用下列 ADB 指令開啟或關閉這項變更：

adb shell am compat enable (136293963|REQUEST_ACCESSIBILITY_BUTTON_CHANGE) PACKAGE_NAME
adb shell am compat disable (136293963|REQUEST_ACCESSIBILITY_BUTTON_CHANGE) PACKAGE_NAME

如要進一步瞭解相容性架構及切換變更，請參閱「在應用程式中測試及偵錯平台行為變更」。

從 Android 11 開始，無障礙服務無法宣告其具有與系統無障礙工具按鈕建立關聯的執行階段宣告。如果您將 AccessibilityServiceInfo.FLAG_REQUEST_ACCESSIBILITY_BUTTON 附加至 AccessibilityServiceInfo 物件的 flags 屬性，架構就不會將無障礙工具按鈕回呼事件傳遞至服務。

如要在無障礙服務中接收無障礙回呼事件，請使用無障礙服務中繼資料檔案，宣告您的服務與無障礙工具按鈕的關聯。請在 accessibilityFlags 屬性定義中加入 flagRequestAccessibilityButton 值。無障礙服務中繼資料檔案的常見位置為 res/raw/accessibilityservice.xml。

相機

媒體意圖動作需要系統預設攝影機

從 Android 11 開始，只有預先安裝的系統相機應用程式才能回應以下意圖動作：

• android.media.action.VIDEO_CAPTURE
• android.media.action.IMAGE_CAPTURE
• android.media.action.IMAGE_CAPTURE_SECURE

如有多個預先安裝的系統相機應用程式可用，系統會開啟對話方塊，讓使用者選取應用程式。如果您希望應用程式使用特定的第三方相機應用程式來代表其擷取圖片或影片，可以為意圖設定套件名稱或元件，明確表示這些意圖。

封裝與安裝應用程式

壓縮資源檔案

變更項目詳情

變更名稱：RESOURCES_ARSC_COMPRESSED

變更 ID：132742131

切換方式

測試應用程式與 Android 11 的相容性時，您可以使用下列 ADB 指令開啟或關閉這項變更：

adb shell am compat enable (132742131|RESOURCES_ARSC_COMPRESSED) PACKAGE_NAME
adb shell am compat disable (132742131|RESOURCES_ARSC_COMPRESSED) PACKAGE_NAME

如要進一步瞭解相容性架構及切換變更，請參閱「在應用程式中測試及偵錯平台行為變更」。

如果指定 Android 11 (API 級別 30) 以上版本的應用程式含有壓縮的 resources.arsc 檔案，或是此檔案未對齊 4 位元組邊界，則無法安裝。如果存在上述任一條件，系統就無法為這個檔案進行記憶體對應。無法對應記憶體的資源表格必須讀取 RAM 中的緩衝區，導致系統出現不必要的記憶體壓力，並大幅增加裝置的 RAM 用量。

如果您之前使用的是壓縮的 resources.arsc 檔案，請改為嘗試其他策略，例如縮減應用程式資源或其他縮減、模糊化及最佳化應用程式的方法。

現已必須使用 APK 簽名配置 v2

如果應用程式指定 Android 11 (API 級別 30)，而且目前只使用 APK 簽名配置 v1 簽署，現在也必須使用 APK 簽署配置 v2 以上版本簽署。在搭載 Android 11 的裝置上，使用者無法安裝或更新僅使用 APK 簽署配置 v1 簽署的應用程式。

如要驗證應用程式是使用 APK Signature Scheme v2 以上的版本簽署，您可以使用 Android Studio 或指令列上的 apksigner 工具。

注意： 如要支援搭載舊版 Android 的裝置，除了使用 APK Signature Scheme v2 以上版本簽署 APK 之外，您也應繼續使用 APK 簽名配置 v1 簽署 APK。

Firebase

Firebase JobDispatcher 和 GCMNetworkManager

如果應用程式指定的 API 級別為 30 以上，則在搭載 Android 6.0 (API 級別 23) 以上版本的裝置上，系統會停用 Firebase JobDispatcher 和 GcmNetworkManager API 呼叫。如需遷移資訊，請參閱「從 Firebase JobDispatcher 遷移至 WorkManager」和「從 GCMNetworkManager 遷移至 WorkManager」。

語音辨識

由於套件瀏覽權限有所變更，如果應用程式指定 Android 11 並與語音辨識服務互動，就必須在資訊清單檔案中加入下列 <queries> 元素：

<queries>
  <intent>
    <action
       android:name="android.speech.RecognitionService" />
  </intent>
</queries>

OnSharedPreferenceChangeListener 的回呼變更

變更項目詳情

變更名稱：CALLBACK_ON_CLEAR_CHANGE

變更 ID：119147584

切換方式

測試應用程式與 Android 11 的相容性時，您可以使用下列 ADB 指令開啟或關閉這項變更：

adb shell am compat enable (119147584|CALLBACK_ON_CLEAR_CHANGE) PACKAGE_NAME
adb shell am compat disable (119147584|CALLBACK_ON_CLEAR_CHANGE) PACKAGE_NAME

如要進一步瞭解相容性架構及切換變更，請參閱「在應用程式中測試及偵錯平台行為變更」。

針對指定 Android 11 (API 級別 30) 的應用程式，每次呼叫 Editor.clear 時，系統現在都會使用 null 金鑰對 OnSharedPreferenceChangeListener.onSharedPreferenceChanged 進行回呼。

非 SDK 介面限制

基於與 Android 開發人員合作及最新的內部測試，Android 11 包含更新後的受限制非 SDK 介面清單。在限制非 SDK 介面之前，我們盡可能確保公開替代方案的可得性。

如果您的應用程式並不是以 Android 11 為目標版本，則此處所述的某些變更可能不會立即對您造成影響。不過，雖然您目前可使用某些非 SDK 介面 (視應用程式的目標 API 級別而定)，但使用任何非 SDK 方法或欄位時，一律可能會導致應用程式停止運作。

如果不確定應用程式是否使用非 SDK 介面，可對應用程式進行測試以便確認。如果您的應用程式仰賴非 SDK 介面，則建議您開始規劃遷移至 SDK 替代方案。我們瞭解有些應用程式可使用非 SDK 介面運作。如果您除了為應用程式中的某個功能使用非 SDK 介面外，已別無他法，則應要求新的公用 API。

如要進一步瞭解此 Android 版本中的變更，請參閱 Android 11 的非 SDK 介面限制更新。如要進一步瞭解非 SDK 介面的一般資訊，請參閱非 SDK 介面的限制。