小米上架需确保包名、软著名、截图尺寸三项完全一致:包名须为三段式反向域名且与manifest.json及后台严格一致;软著名称须与应用名称逐字相同;截图必须为1080×1920的PNG/JPG,去状态栏并展示核心功能。

包名必须与小米开发者平台完全一致
小米应用商店审核时会校验 package name 和你在小米开发者后台填写的“应用包名”是否一字不差。常见错误是:uni-app 项目中 manifest.json 的 appid 或 bundleName 写成 uni.xxxx(HBuilder 默认生成),但小米后台注册时填了 com.xxx.app,导致签名验证失败、上传后提示“包名不匹配”或直接拒审。
实操建议:
- 统一使用三段式反向域名格式,例如
com.example.myapp,避免uni.或io.开头(小米不认可这类非标准包名) - 检查
manifest.json中"appid"和"bundleName"字段值必须相同且全小写、无下划线、无大写字母 - 云端打包前,在 HBuilderX 的“发行 → 原生App-云打包 → Android配置”里确认“应用标识(Android包名)”已手动覆盖为该值
- 小米后台新建应用时,“包名”字段粘贴的必须是最终打包 APK 中实际声明的包名——可用
aapt dump badging your-app.apk | grep package验证
隐私政策弹窗必须在首次启动时强制触发
小米应用商店明确要求:APP 启动后、任何权限申请前,必须主动弹出《隐私政策》和《用户服务协议》双协议弹窗,且用户未点击“同意”前,禁止调用 uni.getLocation、uni.chooseImage 等任何需授权的 API。否则上架会被直接驳回,错误提示常为“未明示收集目的”或“强制索取权限”。
实操建议:
- 不要依赖第三方插件自动拦截,优先在
App.vue的onLaunch中用uni.showModal或自定义弹窗强制展示 - 弹窗文案需包含明确数据用途,例如:“为提供定位服务,我们将收集您的位置信息;为保存图片,我们将访问相册存储空间”
- 确保
androidPrivacy.json文件存在于项目根目录,且内容不含注释(哪怕一行//都会导致弹窗不显示) - 小米审核时会模拟冷启动,所以弹窗逻辑不能放在某个页面的
onLoad,而必须在全局生命周期中执行
截图尺寸必须严格匹配小米要求:1080×1920
小米应用商店只接受宽高比为 9:16、精确尺寸为 1080x1920 的截图,上传其他尺寸(如 480x800、720x1280)会提示“图片尺寸不符合规范”,且不支持自动缩放。很多开发者误以为“只要比例对就行”,结果反复被退回。
小米/米家智能家居设备控制。通过MCP Server工具控制家中设备,包括灯、空气净化器、电暖气、空调、风扇、扫地机器人、窗帘等。触发场景:用户提到智能家居控制指令,如"把灯关掉"、"开空调"、"净化器调到睡眠模式"、"客厅太暗了"、"家里空气不好"等。即使未明确提及"小米"或"米家",只要涉及家居设备控制即可触发。
实操建议:
- 使用真机截取(推荐小米手机),或用 Android Studio 的 Device Frame Generator 导出带边框的 1080×1920 图片
- 截图内容需展示核心功能界面,不能含状态栏/导航栏(小米明确要求“去除顶部通知栏”)
- 单张大小不能超过 5 MB,格式仅限
PNG或JPG,WEBP 不被识别 - 至少上传 3 张、最多 5 张,每张内容不可重复(例如不能全是首页)
软著证书名称必须与应用商店填写的应用名称完全一致
小米审核人员会人工比对软著登记证书上的“软件名称”和你在后台填写的“应用名称”。哪怕多一个空格、少一个版本号(如证书写“MyApp V1.0”,后台填“MyApp”),都会判定为“资质不一致”,驳回并要求重新提交软著。
实操建议:
- 软著申请时,软件名称务必按最终上架名填写,不要加“测试版”“Beta”等后缀
- 应用商店后台填写的“应用名称”字段,必须逐字复制软著证书 PDF 中的“软件全称”栏内容
- 软著下发周期约 10–15 个工作日,务必在打包前完成申请,避免因等证书耽误上线节奏
- 若已用错名称,不要试图修改证书,应重新申请——小米不接受名称变更说明函
小米上架最易被忽略的点是:它不校验签名证书指纹,但极度依赖包名、软著名、截图尺寸这三项静态信息的一致性。一旦其中任一环节有毫厘偏差,审核就会卡在初审阶段,且不会给出具体行号或文件位置提示。建议每次提交前,用小米提供的“APK检测工具”本地扫描一遍,比盲传更省时间。










