行為變更：所有應用程式

Android 17 平台包含可能對應用程式造成影響的行為變更。無論 targetSdkVersion 為何，凡是在 Android 17 上執行的應用程式，「一律」都會受到下列行為變更所影響。您必須測試自己的應用程式，並視需要進行修改，以便在適當情況下支援這些變更。

另請務必查看僅對指定 Android 17 為目標版本的應用程式造成影響的行為變更。

核心功能

Android 17 (API 級別 37) 包含下列異動項目，這類變更會修改或擴充 Android 系統的各種核心功能。

應用程式記憶體限制

Android 17 會根據裝置的總 RAM 導入應用程式記憶體限制，為應用程式和 Android 使用者打造更穩定且可預測的環境。在 Android 17 中，系統會保守地設定限制，建立系統基準，目標是在極端記憶體流失和其他離群值觸發全系統不穩定，導致 UI 延遲、電池耗電和應用程式遭終止之前，先偵測到這些狀況。我們預期絕大多數應用程式工作階段受到的影響極小，但仍建議您遵循下列記憶體最佳做法，包括建立記憶體基準。

您可以在 ApplicationExitInfo 中呼叫 getDescription，判斷應用程式工作階段是否受到影響；如果受到影響，結束原因會是 REASON_OTHER，說明則會包含 "MemoryLimiter:AnonSwap" 字串和其他資訊。您也可以搭配使用觸發式剖析和 TRIGGER_TYPE_ANOMALY，在達到記憶體上限時收集堆積傾印。

「管理應用程式的記憶體」說明文件提供相關資訊，協助您診斷應用程式的記憶體問題，並盡可能減少資源耗用量。

在記憶體限制下測試應用程式的行為

您可以使用 Android Debug Bridge (adb) 調整或停用任何裝置的記憶體限制。殼層指令 am 提供三個子指令，可調整記憶體限制。(這些指令對未設有記憶體限制的裝置沒有影響)。

  • am memory-limiter ignore <uid>|none|all
  • am memory-limiter manual <pid> <limit>|max|none
  • am memory-limiter status
ignore

指示記憶體限制器忽略部分或所有程序。傳遞 UID (Android 使用者 ID) 會指示記憶體限制器，忽略與該 UID 相關聯的所有程序強制執行作業。您也可以傳遞 all (忽略所有應用程式) 或 none (不忽略任何應用程式)。傳遞 none 會覆寫先前對 am memory-limiter ignore 的任何呼叫。

如果您指示記憶體限制器忽略 UID，您仍可呼叫 am memory-limiter manual，對應用程式中的程序套用手動記憶體限制。

manual

指示系統對具有指定 PID (程序 ID) 的程序施加記憶體限制。記憶體限制以 MB 為單位的整數指定；舉例來說，傳遞 30 會指定程序限制為 30 MB 的記憶體。傳遞 max 會移除該程序的所有記憶體限制。傳遞 none 會移除對程序設定的任何手動限制，並還原系統的預設限制 (如有)。

status

回報記憶體限制器的目前狀態，包括對可見和不可見程序施加的記憶體限制。

隱私權

Android 17 包含下列異動項目，可提升使用者隱私權。

簡訊動態密碼防護

從 Android 17 開始，Android 將擴大對含有動態密碼的簡訊提供保護。

在舊版 Android 中，這項保護措施主要著重於簡訊擷取器格式。含有簡訊擷取器雜湊的訊息會延遲三小時才傳送給大多數應用程式。不過，特定應用程式 (例如預設簡訊處理常式) 和擁有雜湊的應用程式不受延遲限制。

自 Android 17 起，這項保護措施也適用於 WebOTP 格式的訊息。如果應用程式有權讀取簡訊，但並非 WebOTP 訊息的預期收件者 (由網域驗證決定)，則在收到訊息後三小時內，應用程式無法存取該訊息。這項異動旨在提升使用者安全性，確保只有與訊息中提及的網域相關聯的應用程式，才能以程式輔助方式讀取驗證碼。

在這三小時的延遲期間，SMS_RECEIVED_ACTION 廣播會遭到保留，且 SMS 供應商資料庫查詢會經過篩選。延遲結束後，這些應用程式就能存取 SMS 訊息。這項變更適用於所有應用程式，無論目標 API 級別為何。

預設訊息助理應用程式、連結裝置的隨附應用程式等特定應用程式，則不受這項延遲限制。如果應用程式會讀取簡訊來擷取 OTP，請改用 SMS Retriever 或 SMS User Consent API，確保功能不受影響。

安全性

Android 17 包含下列裝置和應用程式安全防護改善項目。

usesClearTraffic 淘汰計畫

我們計畫在日後推出的版本中淘汰 usesCleartextTraffic 元素。 如果應用程式需要建立未加密 (HTTP) 連線，請改用網路安全性設定檔，指定應用程式需要建立明文連線的網域。

請注意，網路安全性設定檔僅適用於 API 級別 24 以上版本。如果應用程式的最低 API 級別低於 24，請同時執行下列操作：

  • 將 usesCleartextTraffic 屬性設為 true
  • 使用網路設定檔

如果應用程式的最低 API 級別為 24 以上，您可以使用網路設定檔，不必設定 usesCleartextTraffic。

限制隱含 URI 授權

目前，如果應用程式啟動的意圖含有 URI，且動作為 ACTION_SEND、ACTION_SEND_MULTIPLE 或 ACTION_IMAGE_CAPTURE，系統會自動授予目標應用程式 URI 讀取和寫入權限。但從 Android 18 開始，系統將不再自動授予這些權限。因此，建議應用程式明確授予相關 URI 權限，而非依賴系統授予。

如要在應用程式中偵測這些意圖的使用情形，請搭配使用 StrictMode 和 detectImplicitUriPermissionGrant()，觸發違規行為：

Kotlin

val policy = StrictMode.VmPolicy.Builder()
    .detectImplicitUriPermissionGrant()
    .penaltyLog()
    .build()
StrictMode.setVmPolicy(policy)

Java

StrictMode.VmPolicy policy = new StrictMode.VmPolicy.Builder()
    .detectImplicitUriPermissionGrant()
    .penaltyLog()
    .build();
StrictMode.setVmPolicy(policy);

或者，您也可以監控包含訊息 Please set the grant explicitly in the app 的已記錄例外狀況，這類訊息會在系統隱含設定授權時顯示。您可以使用下列 adb 指令監控這些記錄：

adb logcat | grep "Please set the grant explicitly in the app"

如要明確授予必要權限，請將 FLAG_GRANT_READ_URI_PERMISSION 標記新增至 ACTION_SEND 和 ACTION_SEND_MULTIPLE 意圖：

Kotlin

intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)

Java

intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);

針對 ACTION_IMAGE_CAPTURE 意圖，同時加入 FLAG_GRANT_READ_URI_PERMISSION 和 FLAG_GRANT_WRITE_URI_PERMISSION 旗標：

Kotlin

intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION or Intent.FLAG_GRANT_WRITE_URI_PERMISSION)

Java

intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);

每個應用程式的 Keystore 限制

應用程式應避免在 Android Keystore 中建立過多金鑰，因為這是裝置上所有應用程式共用的資源。從 Android 17 開始，系統會強制限制應用程式可擁有的金鑰數量。如果非系統應用程式指定 Android 17 (API 級別 37) 以上版本，金鑰上限為 50,000 個；其他應用程式的金鑰上限則為 200,000 個。無論目標 API 級別為何，系統應用程式最多只能有 200,000 個金鑰。

如果應用程式嘗試建立超出上限的金鑰，系統會傳回 KeyStoreException，導致建立作業失敗。例外狀況的訊息字串包含金鑰限制的相關資訊。如果應用程式在例外狀況中呼叫 getNumericErrorCode()，傳回值會因應用程式的目標 API 級別而異：

  • 以 Android 17 (API 級別 37) 以上版本為目標的應用程式：getNumericErrorCode() 會傳回新的 ERROR_TOO_MANY_KEYS 值。
  • 所有其他應用程式：getNumericErrorCode()退貨ERROR_INCORRECT_USAGE。

封鎖跨設定檔迴路流量

從 Android 17 開始，系統預設不再允許跨設定檔迴路流量。同一設定檔內的迴路流量不受影響。無論應用程式指定哪個 API 級別，只要在 Android 17 以上版本上執行，都會受到這項變更影響。

使用者體驗和系統 UI

Android 17 包含下列變更，目的是為了打造更一致、直覺的使用者體驗。

裝置旋轉後自動恢復預設的 IME 版面空間

Beginning with Android 17, when the device's configuration changes (for example, through rotation), and this is not handled by the app itself, the previous IME visibility is not restored.

If your app undergoes a configuration change that it does not handle, and the app needs the keyboard to be visible after the change, you must explicitly request this. You can make this request in one of the following ways:

  • Set the android:windowSoftInputMode attribute to stateAlwaysVisible.
  • Programmatically request the soft keyboard in your activity's onCreate() method, or add the onConfigurationChanged() method.

手動輸入

Android 17 包含下列異動項目，這些變更會影響應用程式與鍵盤和觸控板等人工輸入裝置的互動方式。

在指標擷取期間，觸控板預設會傳送相對事件

從 Android 17 開始，如果應用程式使用 View.requestPointerCapture() 要求指標擷取，且使用者使用觸控板，系統會辨識使用者觸控時的指標移動和捲動手勢，並以與擷取滑鼠時指標和捲動滾輪移動相同的方式，將這些手勢回報給應用程式。在大多數情況下，支援擷取滑鼠的應用程式不必為觸控板新增特殊處理邏輯。詳情請參閱 View.POINTER_CAPTURE_MODE_RELATIVE 的說明文件。

先前，系統不會嘗試辨識觸控板的手勢，而是以類似觸控螢幕觸控的格式，將原始的絕對手指位置傳送至應用程式。如果應用程式仍需要這項絕對資料，應改為使用 View.POINTER_CAPTURE_MODE_ABSOLUTE 呼叫新的 View.requestPointerCapture(int) 方法。

媒體

Android 17 包含下列媒體行為變更。

背景音訊強化

從 Android 17 開始，音訊架構會強制限制背景音訊互動，包括音訊播放、音訊焦點要求和音量變更 API，確保這些變更是由使用者刻意啟動。

如果應用程式嘗試在無效的生命週期呼叫音訊 API，音訊播放和音量變更 API 會無聲無息地失敗，不會擲回例外狀況或提供失敗訊息。音訊焦點 API 失敗，結果代碼為 AUDIOFOCUS_REQUEST_FAILED。

如需更多資訊 (包括緩解策略)，請參閱「背景音訊強化」。

連線能力

Android 17 包含下列異動項目，可提升裝置連線能力。

藍牙配對遺失時自動重新配對

Android 17 推出自主重新配對連線功能，這項系統層級的強化功能旨在自動解決藍牙連線中斷問題。

以往，如果連線遺失，使用者必須手動前往「設定」取消配對，然後重新配對周邊裝置。這項功能以 Android 16 的安全性提升為基礎，可讓系統在背景重新建立連線，使用者不必手動前往「設定」解除配對並重新配對周邊裝置。

雖然大多數應用程式不需要變更程式碼，但開發人員應留意藍牙堆疊的下列行為變更：

  • 新的配對情境：ACTION_PAIRING_REQUEST 現在包含 EXTRA_PAIRING_CONTEXT 額外內容，可讓應用程式區分標準配對要求，以及自主系統啟動的重新配對嘗試。
  • 有條件的金鑰更新：只有在重新配對成功，且新連線達到或超過先前連結的安全等級時，現有的安全金鑰才會遭到取代。
  • 修改意圖時間：現在只有在自主重新配對嘗試失敗時，才會廣播 ACTION_KEY_MISSING 意圖。如果系統在背景成功復原連線，應用程式就不必進行不必要的錯誤處理。
  • 使用者通知：系統會透過新的 UI 通知和對話方塊管理重新配對作業。系統會提示使用者確認重新配對嘗試，確保他們知道裝置要重新連線。

周邊裝置製造商和隨附應用程式開發人員應確認硬體和應用程式能妥善處理配對轉換。如要測試這項行為，請使用下列任一方法模擬遠端連結遺失：

  • 手動從周邊裝置移除配對資訊
  • 手動取消配對裝置：依序前往「設定」>「已連結的裝置」