Runtime打包工具更新时间: 2025-08-05 18:04:00
小米线上存在webview和runtime两种运行环境,开发者可以联系商务针对运行环境的进行打包进行最优策略匹配,为线上用户带来最优体验,小米线上从1309版本允许双包并存。
包体类型 | 打包方式 | 最小框架版本限制 | 优势 |
小米webview | unity/cocos引擎直接打包 | 1060 | 版本覆盖度高 |
小米runtime | 小米打包工具打包 | 1308.3 | 包体整体变小,启动时长缩短约10% |
联盟runtime | 联盟打包工具打包 | 1308.3 | 包体整体变小,启动时长缩短约10% |
一、小米打包工具打包
1、通过cocos、laya、erget等IDE构建小米快游戏项目, 如cocos IDE

项目构建成功后,点击文件夹按钮,打开项目所在位置

2、在项目下创建package.json文件
请注意 quickgame-cli版本,需要是0.1.26-beta.14
{
"name": "xiaomi-quickgame",
"version": "1.0.0",
"build-template": "xiaomigame",
"scripts": {
"build": "quickgame build --cocos-wx-game --include-file-ext .pem,.pkm,.webp",
"release": "quickgame release --cocos-wx-game --include-file-ext .pem,.pkm,.webp",
"server": "quickgame server",
"debug": "quickgame debug"
},
"babel": {
"plugins": [
"babel-plugin-transform-remove-strict-mode"
]
},
"dependencies": {
"quickgame-cli": "^0.2.3"
}
}
3)在项目下执行如下命令,即可输出rpk (推荐使用node 16版本)
npm install && npm run release
二、小米打包工具调试
1、通过启动参数,选择运行游戏的Runtime
通过在设置页->启动参数设置选项中增加参数,来实现运行环境选择,具体参数说明如下:
参数名 | 是否必须 | 参数说明 | 默认值 |
engineType | 否 | 运行游戏的引擎类型,取值范围:unity、cocos、webview | -- |
useVConsole | 否 | 是否开启 vConsole,只当 engineType=unity 或 cocos 时生效 | false |
waitingDebugger | 否 | 是否在启动时等待 inspect 调试,只当 engineType=unity 或cocos 时生效 | false |
使用示例:
engineType=cocos&useVConsole=true&waitingDebugger=false
操作步骤:

2、开启性能监控
当 engineType=unity 时,可以通过开启性能面板选项进一步查看游戏运行性能情况

上一篇:打包工具
下一篇:调试
文档内容是否有帮助?
有帮助
无帮助