小米Android 17应用适配

欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。

这个通知是小米应用商店针对 Android 17（API 级别 37） 的强制适配要求。针对你的 uni-app 项目，需要按以下步骤处理：

核心处理步骤

1. 升级 HBuilderX 版本

确保使用 HBuilderX 4.87 或更高版本（当前最新正式版已支持 Android 高版本适配）。低版本打包的 APK 可能因 targetSdkVersion 过低或兼容性问题被小米驳回。

2. 调整 targetSdkVersion

在 manifest.json 中检查并更新 Android 目标版本：

{  
  "app-plus": {  
    "distribute": {  
      "android": {  
        "targetSdkVersion": 37  
      }  
    }  
  }  
}

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

注意：如果云打包，需确保 HBuilderX 为最新版，云端打包环境会自动适配 Android 17 的编译要求。

3. 隐私合规适配（重点）

小米对 Android 17 应用的隐私合规审核极严格，务必检查：

• 使用 template 模式隐私弹窗：在 manifest.json 中配置 privacy 节点，使用系统模板而非自定义弹窗
• 禁止提前初始化 SDK：确保在用户点击"同意"前，APP 和 SDK（包括 uni-ad、统计、推送等）不进行任何初始化、不收集任何设备信息（IMEI、IMSI、OAID、MAC 地址等）
• 更新隐私政策：在隐私政策中明确说明适配 Android 17，并补充小米澎湃 OS 的相关描述

参考：Android 平台隐私与政策提示框

4. 权限与行为变更适配

Android 17 引入了新的权限和行为变更，重点检查：

• 存储权限：适配分区存储（Scoped Storage），避免使用 WRITE_EXTERNAL_STORAGE 等旧权限
• 后台启动限制：检查是否有后台启动 Activity 的行为
• 通知权限：Android 13+ 需动态申请通知权限，确保在 Android 17 上正常
• 前台服务：如果使用了前台服务（如音乐播放、定位），需声明新的前台服务类型

5. 16KB 页面大小支持（如适用）

如果应用包含原生 SO 库（如地图、推送等），需确保支持 16KB 内存页面大小（Google Play 和小米澎湃 OS 3.3 的强制要求）：

• 升级 HBuilderX 到 4.81+ 版本
• 注意：升级后最低支持版本变为 Android 5.0（API 21），不再支持 Android 4.4

6. 真机测试

务必在 小米澎湃 OS 3.3（Android 17） 真机上测试以下场景：

• 首次启动隐私弹窗是否正常
• 同意隐私政策前是否有网络请求或 SDK 初始化
• 核心功能（定位、相机、相册、推送）是否正常
• 分屏、折叠屏等澎湃 OS 特有场景

时间提醒

小米要求 2026 年 8 月 31 日后 未完成适配的应用将被限制（审核驳回、搜索降权、分机型屏蔽或下架）。建议立即升级 HBuilderX 并重新打包提交审核。

相关参考

• Android 16KB 页面大小适配
• 小米应用市场上架注意事项
• Android 平台隐私合规常见问题

如果使用的是 uni-app x，适配要求相同，但需额外注意 UTS 插件的兼容性，建议到 uni-app 官方技术交流群 咨询具体插件的 Android 17 适配情况。