Android各版本适配总结

Android 各版本适配总结targetSdk整理日期2026-07-30范围Android 8API 26→ Android 17API 37说明以下为升targetSdkVersion后的关键行为变更与适配要点跑在新系统上但未升 target 时仍需对照「所有应用」行为变更做兼容测试。官方入口Versions · Play target API0. 速查表版本API代号/备注适配关键词升 target 后Android 8.0/8.126/27Oreo通知渠道、后台执行限制、隐式广播限制Android 928Pie明文 HTTP 默认禁止、非 SDK 限制、前台服务通知Android 1029Q分区存储可选强制、后台定位、设备标识、手势导航Android 1130R强制分区存储、软件包可见性、后台定位分步授权Android 12 / 12L31/32Sexported必填、PendingIntent 可变性、精确闹钟、FGS 启动限制Android 1333T通知运行时权限、媒体细分权限、附近设备权限Android 1434UFGS 类型必填、动态广播导出标志、隐式 Intent 限制Android 1535V强制边到边、FGS 超时、屏幕分享部分共享Android 1636Baklava边到边不可 opt-out、预测性返回默认、大屏限制可临时 opt-outAndroid 1737—大屏限制永久生效、局域网权限、CT 默认开、MessageQueue 无锁1. Google Play 目标 API 要求截至 2026场景要求新应用 / 更新提交2026-08-31起须targetSdk ≥ 36Android 16已上架应用对新用户可见须targetSdk ≥ 35Android 15否则仅对「系统版本 ≤ 你的 target」设备可见Wear / Automotive更新可仍为 API 35TV / XR可为 API 34延期Play Console 可申请延长至约2026-11-01以控制台为准Android 17预计2027 年中起要求 target 37以官方公告为准优缺点跟进最高 target优点满足上架与分发获得系统新能力与安全默认值减少老旧行为技术债缺点每升一级都有 breaking change大屏/边到边/权限改造成本高依赖三方 SDK 进度2. Android 8API 26/27— Oreo关键变更通知渠道NotificationChannel未创建渠道则通知可能不展示后台执行限制隐式广播大量禁用后台服务受限改用JobScheduler/WorkManager/ FGS后台位置更严格的后台定位限制自适应图标、多窗口相关行为适配要点为所有通知创建 Channel后台任务迁到 WorkManager / JobScheduler静态注册的隐式广播改为显式或动态注册例外除外3. Android 9API 28— Pie关键变更明文流量默认禁止usesCleartextTrafficfalse需 HTTP 时用 Network Security Config前台服务启动 FGS 必须显示通知非 SDK 接口限制正式推进Apache HTTP client从 bootclasspath 移除需依赖或迁移适配要点HTTPS 优先明文域名白名单写进 network_security_config排查反射/私有 APIFGS 通知合规4. Android 10API 29— Q关键变更分区存储Scoped Storage按 target 逐步收紧完整强制在 11后台启动 Activity大幅限制后台定位需ACCESS_BACKGROUND_LOCATION设备唯一标识IMEI/序列号等受限改用可重置 ID / SSAID 等策略活动识别需ACTIVITY_RECOGNITION手势导航与边衬区冲突处理全屏 Intent需USE_FULL_SCREEN_INTENT适配要点文件访问改 MediaStore / SAF / 应用专属目录后台勿随意startActivity定位分前台/后台申请合规说明用途5. Android 11API 30— R关键变更强制分区存储外部存储仅应用专属目录 自身创建的媒体等软件包可见性查询已安装应用需queries或可见性例外后台定位须先获前台定位再跳转设置授予后台权限自动重置长期未使用应用敏感权限被收回APK Signature Scheme v2成为必要建议同时保留 v1适配要点去掉对任意路径File直读外置存储的依赖Manifest 声明queries调起微信/支付宝/地图等后台定位引导流程符合政策6. Android 12 / 12LAPI 31/32— S关键变更android:exported必填含 Intent Filter 的组件必须显式声明PendingIntent 可变性须指定FLAG_IMMUTABLE或FLAG_MUTABLE精确闹钟SCHEDULE_EXACT_ALARM/ 后续特殊权限策略后台启动 FGS进一步限制近似位置申请精确定位时须同时能处理仅授予粗略定位蓝牙权限拆分BLUETOOTH_SCAN/CONNECT/ADVERTISE部分场景启动画面SplashScreen API通知样式自定义通知装饰12L大屏/可折叠更好支持多窗口行为增强适配要点全量组件补exportedPendingIntent 全部标明可变性闹钟/日历类评估精确闹钟权限定位仅要精度时声明并处理 coarse-only大屏做基础响应式为 16/17 打底7. Android 13API 33— Tiramisu关键变更POST_NOTIFICATIONS运行时权限未授权则无法发通知FGS 通知在抽屉可能不可见任务管理器仍可见媒体权限细分READ_MEDIA_IMAGES/VIDEO/AUDIO替代宽泛存储读权限附近设备Wi‑Fi/蓝牙等更多迁到附近设备权限模型广告 ID使用广告 ID 须声明AD_ID** foregound 服务与通知权限**联动体验变化Photo Picker鼓励替代宽权限读图适配要点合适时机申请通知权限拒绝时降级体验存储权限改为对应媒体权限或系统 Photo Picker广告相关清单声明AD_ID或按政策移除8. Android 14API 34— UpsideDownCake关键变更前台服务类型强制每个 FGS 必须声明foregroundServiceType 对应FOREGROUND_SERVICE_*权限startForeground传入类型动态注册 BroadcastReceiver必须指定RECEIVER_EXPORTED/RECEIVER_NOT_EXPORTED隐式 Intent 无法发到未导出的内部组件对外发送更严格匹配完整屏幕意图等权限进一步管控JobScheduler部分网络约束需ACCESS_NETWORK_STATE照片二次授权 / 部分访问选图数量限制等与后续版本延续适配要点梳理所有 FGS映射官方类型dataSync/mediaPlayback/location…Context 注册广播全部带导出标志组件间通信改用显式 Intent蓝牙相关 API 注意BLUETOOTH_CONNECT等强制校验点9. Android 15API 35— VanillaIceCream关键变更边到边edge-to-edge默认强制内容绘制到系统栏后方可用windowOptOutEdgeToEdgeEnforcement临时退出仅 35dataSync/mediaProcessingFGS 24h 内合计约 6 小时超时超时须stopSelf()否则崩溃级异常BOOT_COMPLETED启动部分类型 FGS 被禁持有SYSTEM_ALERT_WINDOW时启动 FGS条件更严后台 Activity 启动规则再收紧优雅文本高度等排版默认变化可能影响布局屏幕共享支持应用部分共享等隐私增强适配要点全面适配 WindowInsets / 边到边不要依赖长期 opt-outdataSync/ 媒体处理改 WorkManager 或严格控时开机广播勿拉起受限类型 FGS回归字体与高度变化导致的截断/重叠10. Android 16API 36— Baklava关键变更边到边 opt-out 失效windowOptOutEdgeToEdgeEnforcement废弃且无效预测性返回默认开启onBackPressed()/KEYCODE_BACK不再回调须OnBackInvokedCallback/OnBackPressedDispatcher可临时android:enableOnBackInvokedCallbackfalseopt-out大屏sw ≥ 600dp忽略方向/可调整大小/宽高比限制可临时opt-out兼容模式健康/健身等更细权限与其他隐私增强按业务查阅官方上架侧常同步要求16KB 内存页设备兼容NDK/so 对齐以 Play 当期政策为准适配要点边到边Insets 处理到位去掉 opt-out返回键全面迁预测性返回 API平板/折叠/桌面窗口响应式布局评估是否仍用大屏 opt-out17 将取消Native 库验证 16KB page sizePlay2026-08-31 起新应用与更新默认须 target36。11. Android 17API 37详细清单见同目录Android17适配总结.md关键变更升 target 37类别要点大屏方向/resize/宽高比限制不可再 opt-out游戏分类可豁免隐私ACCESS_LOCAL_NETWORKSMS OTP 标准短信延迟物理键盘密码默认不显末位安全CT 默认开启Safer Native DCLSystem.load须只读BAL 收紧性能无锁 MessageQueue禁反射内部static final不可再改媒体后台音频限制加强其他蓝牙 RFCOMMread()返回 -1NPU 需声明 feature通讯录 CP2 收紧所有应用与 target 无关跑在 17 上跨 Profile 回环localhost默认阻断usesCleartextTraffic计划废弃 → Network Security Config更严的应用内存限额等适配要点大屏自适应彻底落地局域网 / OTP / CT / native 加载 / 后台音频逐项回归去掉 MessageQueue / static final 黑科技CameraX ≥ 1.5.2 或 1.6.012. 跨版本主题演进便于规划存储10 分区可选11 强制分区13 媒体细分 / Picker后台8 限制广播服务10 限制启 Activity12 限制启 FGS14 FGS 类型15 FGS 超时UI10 手势导航15 边到边16 边到边强制 预测返回16/17 大屏自适应隐私10 标识/定位11 包可见性13 通知权限17 局域网/OTP/CT13. 推荐升级路径工程实践先兼容、后升 target在目标系统真机/模拟器装现网包 → 再升compileSdk/targetSdk按阶跃升级例如 33→34→35→36→37每级解决 FGS/边到边/大屏等「门槛变更」用兼容性开关adb am compat enable/disable …单项验证锁依赖AndroidX、推送、支付、地图、加固/热修均需声明支持新 API清单与权限审计Merged Manifest 查三方带入的权限与 exported最低建议基线2026 下半年角色建议手机应用上架targetSdk 36并启动 37 预研内部库 / 插件至少验证到 API 36/37游戏关注大屏豁免规则 16KB page 多窗口14. 官方文档索引版本行为变更target10https://developer.android.com/about/versions/10/behavior-changes-1011https://developer.android.com/about/versions/11/behavior-changes-1112https://developer.android.com/about/versions/12/behavior-changes-1213https://developer.android.com/about/versions/13/behavior-changes-1314https://developer.android.com/about/versions/14/behavior-changes-1415https://developer.android.com/about/versions/15/behavior-changes-1516https://developer.android.com/about/versions/16/behavior-changes-1617https://developer.android.com/about/versions/17/behavior-changes-17Playhttps://developer.android.com/google/play/requirements/target-sdk15. 与单版本文档关系本文件各版本横向总览 升级路径Android17适配总结.mdAPI 37 纵深清单与 Checklist政策与日期以 Google Play / Android Developers 最新公告为准。