Android 17 适配详解：行为变更与升级指南

Android 17 适配详解：行为变更与升级指南

Android 17（API 级别 37）标志着 Android 向智能系统过渡的开始，采用自适应优先的开发标准，让应用体验适应更多外形规格，同时提供下一代隐私、安全、媒体、相机和性能。官方已发布版本总览、所有应用的行为变更与目标平台行为变更三份文档。本文按"先保命、再升级"的顺序，把适配要点整理成一份可落地的清单。

1、版本定位与适配策略

Android 17 的行为变更分两层：第一层作用于 Android 17 设备上的**所有应用**，无论 targetSdkVersion 是多少，装上去就生效；第二层只影响 targetSdkVersion 升到 37 的应用。适配顺序应当是先扫第一层保存量用户，再评估第二层决定升不升级。

适配节奏建议：

1. 拿 Pixel 或模拟器刷 Android 17，全流程回归现有版本，重点盯内存与音频

2. 对照第一层清单逐项排查（内存限制、OTP 保护、隐式 URI）

3. 评估 targetSdkVersion 37 升级的收益与成本，含反射、密钥库、大屏约束

4. 通过 Beta 渠道灰度，收集 ApplicationExitInfo 与线上异常

2、所有应用：内存限制（最重磅）

Android 17 引入基于设备总 RAM 的应用内存限制，在内存泄漏等异常值引发系统级卡顿、耗电、杀应用之前先做限制。官方预计对绝大多数应用影响很小，但重度内存应用必须自查。

// 1. 检查会话是否受内存限制影响
ApplicationExitInfo info = ...;
if (info.getDescription().contains("MemoryLimiter:AnonSwap")) {
    // 命中内存限制，需排查内存曲线
}

// 2. adb 手动调低限额做压力测试
// am memory-limiter status                 查看当前限制状态
// am memory-limiter manual300       给进程设 300MB 上限
// am memory-limiter manualmax       移除限制
// am memory-limiter ignore all             全局忽略（仅测试用）

排查要点：

1. 退出原因为 REASON_OTHER 且描述含 MemoryLimiter:AnonSwap 即命中

2. 用基于触发器的分析（TRIGGER_TYPE_ANOMALY）在达到限额时自动抓堆转储

3. 建立内存基准，参考官方"管理应用内存"文档优化

4. 压测时用 am memory-limiter manual 把限额调到接近线上水位

3、所有应用：隐私与安全变更

四项变更影响存量应用：短信 OTP 保护扩大、明文流量弃用计划、隐式 URI 授予收紧、跨资料环回流量拦截。

变更清单：

        - 短信 OTP 保护扩大：WebOTP 格式消息若非预期接收者（网域验证），3 小时内不可读

        - usesCleartextTraffic 弃用计划：明文连接迁移到网络安全配置文件（最低 API 24）

        - 隐式 URI 授予：ACTION_SEND / SEND_MULTIPLE / IMAGE_CAPTURE 的自动读写授权将在 Android 18 移除

        - 跨资料环回流量：默认禁止，同个人资料内不受影响

隐式 URI 检测与修复：

// 检测：StrictMode 开启隐式授权探测
StrictMode.setVmPolicy(new StrictMode.VmPolicy.Builder()
    .detectImplicitUriPermissionGrant()
    .penaltyLog()
    .build());
// adb logcat | grep "Please set the grant explicitly in the app"

// 修复：分享 intent 显式加读权限
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
// ACTION_IMAGE_CAPTURE 还需写权限
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION
    | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);

适配要点：

1. 读短信取验证码的应用全面转向 SMS Retriever 或 SMS User Consent API

2. minSdk 低于 24 的应用：usesCleartextTraffic=true 与网络配置文件**同时**设置

3. 隐式 URI 虽在 Android 18 才强制，现在就改，StrictMode 日志先行

4、所有应用：体验与媒体细节

四项易漏的变更：旋转后 IME 可见性、触控板指针捕获、后台音频加固、蓝牙自动重配对。

变更清单：

        - 旋转后 IME：配置变化未自行处理时，系统不再恢复键盘弹出状态

        - 触控板指针捕获：requestPointerCapture 默认报告相对事件，需要绝对坐标改用 POINTER_CAPTURE_MODE_ABSOLUTE

        - 后台音频加固：非有效生命周期内调用播放/音量 API 静默失败，音频焦点返回 AUDIOFOCUS_REQUEST_FAILED

        - 蓝牙自动重配对：配对信息丢失时系统后台自愈，ACTION_KEY_MISSING 仅在失败时广播

适配要点：

1. 依赖"旋转后键盘还在"的表单页，设 windowSoftInputMode=stateAlwaysVisible 或 onConfigurationChanged 主动请求

2. 音频类应用排查后台静默调音量场景，失败无异常提示，极易漏测

3. 蓝牙配套应用验证 EXTRA_PAIRING_CONTEXT 处理与密钥更新逻辑

5、targetSdk 37：反射与运行时红线

升级 targetSdkVersion 到 37 才触发的变更中，三项是"红线"级别：static final 反射禁改、密钥库限额、原生 DCL 只读。

// 红线一：static final 不可反射修改
// Field.set(staticFinalField, value) -> IllegalAccessException
// JNI SetStaticLongField() 修改 -> 应用崩溃

// 红线二：密钥库限额
// targetSdk 37+：非系统应用上限 50,000 个密钥
// 其余应用：200,000；系统应用固定 200,000
// 超限创建抛 KeyStoreException
// targetSdk 37+ 调 getNumericErrorCode() 返回 ERROR_TOO_MANY_KEYS

// 红线三：System.load() 原生库必须只读，否则 UnsatisfiedLinkError

排查要点：

1. 全局搜索反射工具类对 static final 的写操作（常见于换肤、热修、字节码工具）

2. MessageQueue 换无锁实现，反射其私有字段方法的客户端会崩，查 SDK 依赖

3. 动态下发 so 的加固/热修方案必须保证文件只读挂载

6、targetSdk 37：隐私与安全增强

六项增强：本地网络权限、标准短信 OTP 延迟、外接键盘隐藏密码、ECH 加密握手、证书透明度默认开启、BAL 收紧。

变更清单：

        - ACCESS_LOCAL_NETWORK 运行时权限：局域网发现与连接必须申请，属 NEARBY_DEVICES 组

        - 标准短信 OTP：targetSdk 37 起，非 Retriever/WebOTP 格式验证码短信同样 3 小时延迟

        - 实体键盘密码：show_passwords_physical 默认隐藏全部密码字符

        - ECH 加密客户端 Hello：加密 TLS 握手中的 SNI，可用 domainEncryption 元素按域开关

        - 证书透明度默认开启：Android 16 可选，37 强制

        - BAL 收紧：迁移到 MODE_BACKGROUND_ACTIVITY_START_ALLOW_IF_VISIBLE 等精细控制

适配要点：

1. 智能家居、投屏类应用立即接入本地网络权限，或改用系统设备选择器免提示

2. 后台音频限制更严：必须有前台服务 + "使用时"权限，或精确闹钟权限且操作 USAGE_ALARM 流

3. 大屏红线：sw>=600dp 忽略方向/宽高比限制，SDK 36 的退出选项在 37 失效

7、排查命令与自检清单

把散落在各节的操作汇成一张速查表，适配期照单执行。

// 内存限制压测
adb shell am memory-limiter status
adb shell am memory-limiter manual <pid> 300

// 隐式 URI 排查
adb logcat | grep "Please set the grant explicitly in the app"

// 密钥库余量检查（超限报错示例）
// KeyStoreException: too many keys (limit=50000)

// 退出原因核查
// REASON_OTHER + "MemoryLimiter:AnonSwap" = 命中内存限制

自检清单：

1. 存量应用：内存压测过、OTP 链路改造过、隐式 URI 修复过、后台音频回归过

2. 升级 37：反射静态字段清零、密钥库余量确认、DCL 只读改造、本地网络权限接入

3. 大屏与折叠屏：方向锁定策略重审，WebView/网络库 ECH 兼容确认

4. 蓝牙应用：自动重配对四点行为变更（上下文/密钥/广播/通知）验证

8、总结

Android 17（API 37）的适配主线是"稳定性与安全双收紧"：所有应用层面，基于 RAM 的内存限制是最重磅变更，需用 am memory-limiter 压测；短信 OTP 保护扩大到 WebOTP 与标准短信，读码应用必须转向 SMS Retriever；隐式 URI 授予、后台音频、明文流量均需提前布防。targetSdk 37 层面，static final 反射禁改、密钥库 5 万上限、原生库只读、本地网络权限、ECH、大屏限制不可退避构成升级红线。

适配路径：先按第 2~4 节完成"所有应用"层的适配并灰度验证；升级 37 前按第 5~6 节清单逐项扫雷，反射与热修方案重点攻坚；发布后持续监控 ApplicationExitInfo 中的 MemoryLimiter 记录与音频 API 静默失败日志。官方迁移核对清单走完全流程，是 Android 17 生态保持体验与合规的发布前置。