文档目录

小米应用商店

上架助手可以把 APK 和应用资料提交到小米应用商店。小米只有一个整体提交的接口,所以填的内容先存在这台电脑上,最后连同图标、截图和安装包一次交给小米。上架助手的基本用法见上架助手入门。

获取自动发布私钥

  1. 登录 小米开发者站,进入「管理中心」→「应用服务」→「自动发布接口」。
  2. 复制页面上的私钥。私钥是整个开发者账号共用的,在网页上重置后旧的马上失效。

添加到 AppBridge

  1. 打开侧栏「API 密钥」,切到「小米」栏,点「添加凭据」。
  2. 填名称(自己认得出就行)、账号(小米开发者站登录用的邮箱)和自动发布私钥。不要填小米账号的登录密码。
  3. 公钥证书一般不用改,默认用内置的小米公钥。测试连接提示签名不对时,再到「自动发布接口」页面「下载公钥文件」,点「选择公钥文件」选进来(.cer、.pem 或 .crt)。
  4. 选保存位置:只在本机、保存到云端,或者共享给团队,见云端存储。
  5. 点「测试连接」,看到「连接成功,账号、私钥和公钥证书都对」后保存。
    API 密钥页的小米栏:已添加的小米凭据,显示账号邮箱和内置公钥证书,下方有测试连接按钮

私钥默认只保存在本机,用 Windows 数据保护加密。用上架助手时,凭据随每次操作经 AppBridge 服务器转给小米,服务器不保存、不记录。添加和测试凭据不需要套餐,上架需要套餐包含上架助手。

添加应用

在上架助手顶部切到「小米」。小米没有列出全部应用的接口,应用要按包名添加一次,之后会记住。

  1. 点「添加应用」。已经添加过应用的,点应用名旁边的下拉箭头,在菜单里点「添加应用」。
  2. 填包名,比如 com.example.app;也可以点「从 APK 读包名」。
  3. 添加时会用凭据查一次小米,查不了会直接报错,不会加进列表。

新应用要先在小米开发者站「创建应用」填好包名,上传软著等资质、填联系人,接口才能提交。从列表里移除应用只是不在这里显示,小米上的不受影响,填好的草稿也会留着。

顶部能看到小米上在架的版本。右边可以切换小米凭据、打开小米开发者站、刷新小米上的情况。

发布类型与安装包

小米上架助手的发布类型与安装包步骤:还没上架的应用是首次上架,这次是新增应用,下方是选择或拖入 APK 的区域

第一步是「发布类型与安装包」。软件按小米上的情况自己判断这次怎么交,顶部和这一步都会写「这次:……」:

这次什么情况
新增应用小米上还没有这个应用,是首次上架,每一步的信息都要填全,必须选 APK
更新版本小米上已经有在架的版本,这次选了新 APK,要写更新说明(最多 500 字)
只改资料小米上已经有在架的版本,这次不选 APK,不换安装包
  • 小米只收 APK,不收 AAB。手上只有 AAB 的,用 bundletool 或打包工具导出通用 APK。
  • 选好 APK 会读出包名、版本号和带了哪些 so 库。包名和这个应用对不上会直接拦下来。
  • 新包的 versionCode 不能比小米上在架的小。同一个版本重复提交,要换一个不完全一样的包。
  • 新应用不能只带 32 位的 so 库。32 位和 64 位分开打包的,可以再选「第二个 APK」做双包,两个包的 versionCode 要一样。更新版本只有 32 位时会提醒,不拦。
  • 只改资料时小米不让改名称。要改名得连同新版本一起提交,还要提供软著。

更新已上架的应用

小米没有读取已上架资料的接口,所以这里看不到小米上现在的介绍和截图。更新时在「我要更新信息」里勾上这次要改的,页面上就只出现这几项,没勾的不交,小米上保持原样:

  • 可以勾的有:应用名称、开发者名称、应用分类、关键字、一句话简介、应用介绍、应用截图。
  • 隐私政策网址、适用设备和图标小米每次都要。第一次更新时要在这里填一次,存在这台电脑上,以后不用再填。
  • 一般传个新 APK、写好更新说明、确认图标和隐私政策就能提交。

应用信息

小米上架助手的应用信息步骤:顶部列出还没填的项,下方是应用名称、开发者名称、分类、适用设备、关键字和一句话简介

每一步改完点「保存」,先保存在这台电脑上,提交审核时一起交给小米。填的时候就会按小米的要求检查:

项目要求
应用名称最多 15 个汉字(英文 30 个,中文算 2 个字符)。要和软著上的名称一致,一年最多改两次
开发者名称可选,不填用开发者站注册的
分类从小米的分类里选,新增应用必选
适用设备手机、平板,或手机和平板
关键字用空格分隔,不能用逗号、顿号;最多 8 个,每个不超过 10 个字
一句话简介最多 17 个汉字(英文 34 个),结尾不加标点,不用问句和「最」「第一」这类词
应用介绍20–4000 字
隐私政策网址必填,以 http:// 或 https:// 开头

图标与截图

要求
应用图标正方形,每次提交都要带上,会替换掉网页上的。不是 512×512 PNG 的会自动转成 512×512 PNG。要和装到手机上看到的图标一样
手机截图4–5 张,竖屏 1080×1920 或横屏 1920×1080,方向要一致,每张不超过 5 MB
平板截图适用设备选了平板时要传,4–5 张,方向要一致。小米没公布尺寸,按原样上传

截图可以拖进来,按顺序展示,用每张图上的箭头调整前后。比例相差 3% 以内的会自动缩放,带透明背景的铺白底,比例不对的会说清楚要什么尺寸。

审核信息

给小米审核人员看的,不会显示在应用商店上。需要登录才能用的应用要填测试账号,不需要登录的可以不填。

  • 测试账号最多 5 个,登录方式选「账号密码」或「短信验证码」。账号和密码(或手机号和验证码)要一起填,注册码或准入码可选。
  • 补充说明可选,最多 500 字,比如测试时要注意的地方、验证码怎么拿到、要什么设备。

提交审核

小米上架助手的提交审核步骤:提交前检查列出还缺的项,每项后面有去对应步骤的链接,最后一项要在小米开发者站创建应用
  1. 看「提交前检查」:还缺的项后面有链接,点了直接去对应的步骤;要在网页上做的,点「打开开发者站」。
  2. 选上线时间:审核通过后立即上线,或定时上线。定时上线提交后要改时间,得去开发者站。只改资料时没有这一项。
  3. 点「提交到小米」,确认后开始处理图片、计算校验值,再上传资料、图片和安装包。小米开始接收前可以点「取消」。

提交前会用小米上最新的情况再查一遍。小米不让新增这个包名时(可能被别人占用了),提交按钮是灰的,要先在小米开发者站认领。审核一般 1–3 个工作日。

提交后要改的话,得等审核结束,或者先在小米开发者站撤回审核。小米上有版本还没上线时再提交,多半会被小米拒绝。

审核状态与通知

小米没有查审核结果的接口,软件会看小米上在架的版本和最近提交的版本来推断,顶部和「提交审核」里会写出来:

显示什么意思
审核中或等上线小米上有比在架新的版本还没上线,在审核或等定时上线。现在改的内容可以先存着,等它上线后再提交
可能被驳回这台电脑上次提交的版本没上线,小米上也看不到在等的版本,多半被驳回或撤回了。去小米开发者站看原因,改好再提交
小米上已经是这个版本了上次提交的版本已经上线

只改资料提交的看不出结果,要去开发者站看。具体的驳回原因小米接口也不给,同样要在开发者站看,「提交审核」里有「去开发者站看」的链接。

在上架助手里添加过的小米应用,AppBridge 会自己找出在审核中的(大约 12 小时找一次,提交或打开时马上记下),之后在后台大约每 30 分钟查一次。上线了,或者看起来被驳回、撤回了,会弹 Windows 通知,点通知直接在上架助手里打开这个应用。在设置的「后台运行」里可以关掉「审核结果通知」(默认开)。关闭窗口默认收进托盘继续运行,程序在运行才会查。需要登录 AppBridge 账号,套餐包含上架助手。

要在小米网页上做的

下面这些小米没有开放接口,要在小米开发者站上操作:

  • 创建新应用(填包名)、上传软著等资质、填联系人。
  • 撤回审核、下架、分阶段发布。
  • 改定时上线的时间。
  • 查看审核结果和驳回原因。

没找到答案?看看常见问题,或者发邮件到 hi@setonink.com。