行為變更：指定 Android 11 為目標版本的應用程式

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

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

隱私權

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

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

詳情請參閱「隱私權」頁面。

安全性

堆積指標標記

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 以上版本為目標的應用程式從背景傳送包含自訂檢視畫面的浮動式訊息，系統會封鎖這類訊息。請注意，系統仍允許文字浮動式訊息，也就是使用 Toast.makeText() 建立，且不呼叫 setView() 的浮動式訊息。

如果應用程式嘗試從背景發布含有自訂檢視畫面的浮動式訊息，系統不會向使用者顯示訊息。而是會在 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 資料庫的讀取權限

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>

在中繼資料檔案中宣告無障礙工具按鈕的使用情形

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

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

應用程式套件和安裝

壓縮資源檔案

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 Signature Scheme v2

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

如要確認應用程式是否使用 APK 簽署配置 v2 以上版本簽署，您可以使用 Android Studio，或在指令列上使用 apksigner 工具。

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 的回呼異動

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 11 根據與 Android 開發人員合作及最新的內部測試，提供最新的受限制非 SDK 介面清單。在限制非 SDK 介面之前，我們會盡可能確保有公開替代方案。

如果您的應用程式並不是以 Android 11 為目標版本，則此處所述的某些變更可能不會立即對您造成影響。雖然您目前可以使用某些非 SDK 介面 (視應用程式的目標 API 級別而定)，但使用任何非 SDK 方法或欄位時，均可能面臨應用程式故障的高度風險。

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

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