Android 17 平台包含可能對應用程式造成影響的行為變更。無論 targetSdkVersion 為何,凡是在 Android 17 上執行的應用程式,「一律」都會受到下列行為變更所影響。您必須測試自己的應用程式,並視需要進行修改,以便在適當情況下支援這些變更。
另請務必查看僅對指定 Android 17 為目標版本的應用程式造成影響的行為變更。
核心功能
Android 17 (API 級別 37) 包含下列異動項目,這類變更會修改或擴充 Android 系統的各種核心功能。
應用程式記憶體限制
Android 17 引入了基于设备 RAM 总容量的应用内存限制,旨在为应用和 Android 用户打造更稳定、更确定的环境。这些限制侧重于在内存泄漏和其他异常值触发系统级不稳定(导致界面卡顿、耗电量增加和应用被终止)之前,对其进行检测。虽然我们预计对绝大多数应用会话的影响微乎其微,但我们建议您遵循以下内存最佳实践,包括建立内存基准。
您可以通过在 ApplicationExitInfo 中调用 getDescription 来确定应用会话是否受到影响;如果应用受到影响,退出原因将为 REASON_OTHER,说明将包含字符串 "MemoryLimiter:AnonSwap" 以及其他信息。您还可以将基于触发器的性能分析与 TRIGGER_TYPE_ANOMALY 搭配使用,以获取在达到内存限制时收集的堆转储。
管理应用的内存文档提供了相关信息,可帮助您诊断应用的内存问题并优化其资源消耗。
测试应用在内存限制下的行为
您可以使用 Android 调试桥 (adb) 调整或停用任何设备上的内存限制。shell 命令 am 提供了三个子命令来调整内存限制。(这些命令对不施加内存限制的设备没有影响。)
am memory-limiter ignore <uid>|none|allam memory-limiter manual <pid> <limit>|max|noneam 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 将扩大对包含动态密码 (OTP) 的短信的保护范围。
在之前的 Android 版本中,此保护机制主要针对 SMS Retriever 格式。对于大多数应用,包含短信检索器哈希的消息延迟了 3 小时才送达。不过,某些应用(例如默认短信处理程序)不受延迟影响,拥有哈希的应用也不受延迟影响。
从 Android 17 开始,此保护措施也适用于 WebOTP 格式的消息。如果应用有权读取短信,但不是 WebOTP 消息的预期接收者(由网域验证确定),则应用在收到消息 3 小时后才能访问该消息。此项变更旨在提高用户安全性,确保只有与消息中提及的网域相关联的应用才能以编程方式读取验证码。
在这 3 小时的延迟期间,SMS_RECEIVED_ACTION 广播会被扣留,短信提供程序数据库查询会被过滤。延迟后,这些应用便可收到短信。此项变更适用于所有应用,无论其目标 API 级别如何。
某些应用(例如默认短信助理应用、已连接设备的配套应用等)不受此延迟的影响。所有依赖读取短信来提取动态密码的应用都应改用 SMS Retriever 或 SMS User Consent API,以确保功能正常运行。
安全性
Android 17 對裝置和應用程式安全性進行了下列改善。
usesClearTraffic 淘汰計畫
我們計劃在日後推出的版本中淘汰 usesCleartextTraffic 元素。如果應用程式需要建立未加密 (HTTP) 連線,應改用網路安全設定檔案,指定應用程式需要建立明文連線的網域。
請注意,網路安全性設定檔僅支援 API 級別 24 以上版本。如果應用程式的最低 API 級別低於 24,請同時執行下列兩項操作:
- 將
usesCleartextTraffic屬性設為true - 使用網路設定檔
如果應用程式的最低 API 級別為 24 以上,您可以使用網路設定檔,不必設定 usesCleartextTraffic。
限制隱含 URI 授權
目前,如果應用程式啟動的意圖含有動作 ACTION_SEND、ACTION_SEND_MULTIPLE 或 ACTION_IMAGE_CAPTURE 的 URI,系統會自動將讀取和寫入 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);
個別應用程式金鑰庫限制
应用应避免在 Android 密钥库中创建过多密钥,因为密钥库是设备上所有应用的共享资源。从 Android 17 开始,系统会强制限制应用可以拥有的密钥数量。对于以 Android 17(API 级别 37)或更高版本为目标平台的非系统应用,此限制为 50,000 个键;对于所有其他应用,此限制为 200,000 个键。系统应用的密钥数量上限为 20 万,无论其目标 API 级别为何。
如果应用尝试创建超出限制的密钥,则创建会失败,并显示 KeyStoreException。异常的消息字符串包含有关键限制的信息。如果应用对异常调用 getNumericErrorCode(),则返回值取决于应用的目标 API 级别:
- 以 Android 17(API 级别 37)或更高版本为目标平台的应用:
getNumericErrorCode()会返回新的ERROR_TOO_MANY_KEYS值。 - 所有其他应用:
getNumericErrorCode()会返回ERROR_INCORRECT_USAGE。
封鎖跨設定檔回送流量
从 Android 17 开始,默认情况下不再允许跨资料环回流量。同一配置文件内的环回流量不受影响。 此变更适用于在 Android 17 或更高版本上运行的所有应用,无论应用的目标 API 级别如何。
使用者體驗和系統 UI
Android 17 包含下列異動項目,旨在打造更一致、直覺的使用者體驗。
裝置旋轉後自動恢復預設的 IME 版面空間
從 Android 17 開始,如果裝置設定變更 (例如旋轉),且應用程式本身未處理這項變更,系統就不會還原先前的輸入法編輯器顯示設定。
如果應用程式發生未處理的設定變更,且在變更後需要顯示鍵盤,您必須明確要求顯示鍵盤。您可以透過下列任一方式提出要求:
- 將
android:windowSoftInputMode屬性設為stateAlwaysVisible。 - 在 Activity 的
onCreate()方法中,透過程式輔助方式要求螢幕鍵盤,或新增onConfigurationChanged()方法。
手動輸入
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 通知和對話方塊管理重新配對。系統會提示使用者確認重新配對,確保他們知道重新連線。
周邊裝置製造商和隨附應用程式開發人員應確認硬體和應用程式能妥善處理繫結轉換。如要測試這項行為,請使用下列任一方法模擬遠端綁定中斷:
- 手動移除周邊裝置的繫結資訊
- 依序前往「設定」>「已連結的裝置」,手動解除裝置配對