打包指南更新时间:2026-03-23 11:47:04
小米已经接入ovmr快游戏联盟,后续将重点维护联盟渠道,强烈推荐新开发者接入快联盟标准,亦建议存量开发者尽快完成迁移适配。
一、注意事项
- 工程结构严格遵循平台项目目录规范,同时需根据小米平台manifest配置及须知检查主配置文件manifest.json中各字段及字段值
- 管控包体大小,使其符合小米开放平台上传规范(分包操作及大小限制详见分包目录及大小限制),主包仅加载必要核心资源,非必要资源尽量放入分包,提升游戏加载速度,压缩主包大小
- 打包时注意不要将无用的文件、资源等放入待打包工程中,以免打入无关文件增大包体积
- 打包后充分测试(功能、性能、兼容),具体的调试步骤详见调试指南,避免审核驳回
二、打包流程
1.生成Debug包
runtime包无法通过引擎IDE中直接导出生成,开发者需要先在引擎IDE构建出小游戏工程,再到工程根目录下使用小米提供的命令行进行手动打包。
首先使用引擎IDE构建生成小游戏工程:
- 通过cocos、laya、erget等IDE构建小米小游戏项目, 如cocos IDE

- unity游戏的构建导出则需要下载导入unity的小米小游戏插件:工具插件1.5.9版本

然后打开构建出的小游戏工程文件夹,修改工程根目录下的package.json文件,将 quickgame-cli 工具版本手动修改至>=0.2.5版,修改完成后在小游戏工程根目录下执行npm install安装依赖,依赖安装完成后在小游戏工程根目录下执行 npm run build进行手动打包,打出的包体放在dist文件夹中。

package.json中内容如下:
{
"name": "xiaomi-quickgame",
"version": "1.0.0",
"build-template": "xiaomigame",
"scripts": {
"build": "quickgame build",
"release": "quickgame release",
"server": "quickgame server",
"debug": "quickgame debug"
},
"babel": {
"plugins": [
"babel-plugin-transform-remove-strict-mode"
]
},
"dependencies": {
"quickgame-cli": "0.2.5"
}
}- 注意事项:部分引擎生成的小游戏工程中可能没有package.json文件,若无此文件则自己创建一个,创建完成后在小游戏工程根目录下执行
npm install安装依赖,依赖安装完成后方可进行手动打包。
2.生成正式包
2.1 签名文件准备
与调试时使用的debug包不同,在打用于正式发布的release包体时需要进行签名,因此在打包前需要准备好签名文件,将其放在构建出的小游戏工程目录的sign文件夹中。


若之前已经生成过签名文件则务必使用之前使用的签名文件,若无签名文件则需要生成签名文件,生成方式如下:
通过openssl命令等工具生成签名文件private.pem、certificate.pem,在小米小游戏工程<project-name>/sign目录下创建release目录,将私钥文件private.pem和证书文件certificate.pem拷贝进去。例如:
openssl req -newkey rsa:2048 -nodes -keyout private.pem -x509 -days 3650 -out certificate.pem注意:正式签名文件生成之后请务必妥善保管,之后每次上传到开平的包都需要使用此签名进行打包,否则会签名校验失败无法上传,且此签名无法变更!
2.2 构建包体
- 同样先使用引擎IDE构建小游戏工程,只不过需要在填写配置项中勾选包体种类为正式包,然后填写签名文件的路径后进行打包即可。cocos中较为特殊,cocos中取消勾选“使用调试密钥库”,然后填写选择下面两个签名文件的路径后进行构建生成。

- 打包时,除使用的打包命令不同外,其余与debug包打包完全相同,正式包体打包调用
npm run release,执行命令前确保sign文件夹下存在release签名文件即可 - 如需更换打包工具版本,除在package.json文件中修改依赖项中的“quickgame-cli”版本外,需要将原node_modules文件夹删除,然后重新执行
npm install重新安装依赖文件后再执行打包命令进行打包
上一篇:运行机制
下一篇:调试指南
文档内容是否有帮助?
有帮助
无帮助