一、runtime环境说明

小米侧目前一共集成了两种游戏运行环境，分别是runtime和webview：

• 我们推荐开发者升级runtime，原因是runtime在加载速度、画面效果、稳定性等诸多方面都远远优于webview
• 如果有不愿升级的或者以前接入的开发者，依然可以打webview包体，使用webview环境运行

二、runtime打包工具使用方法

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 重新安装依赖文件后再执行打包命令进行打包