一、开发准备
1、检查手机是否支持小米快游戏
准备一个小米安卓手机,在应用商店里任意搜索一个快游戏看能否支持运行。

2、安装快应用调试器
安卓手机安装快应用调试器,官网链接: https://www.quickapp.cn/docCenter/post/69
打开安装后的快应用调试器,确认平台为com.miui.hybrid。

3、下载安装代码编辑器
如vscode https://code.visualstudio.com/Download
二、调试应用
准备好项目后就可以编译运行。在手机里预览。
1、编译rpk
执⾏命令: npm run build 在项⽬的dist⽬录编译得到debug包
执⾏命令: npm run release 在项⽬的dist⽬录编译得到release包(release包需要release签
名: ⽣成release签名)
2、启动服务Server
执⾏命令: npm run server 使⽤⼿机安装的调试器 扫码体验
端⼝占⽤情况处理: npm run server -- --port 4000 使⽤指定端⼝4000
3、打包调试(需要在框架1308及以上版本调试)
注:需要在框架1308及以上版本调试 快游戏引擎 | 小米澎湃OS开发者平台
3.1、通过启动参数,选择游戏的运行环境
通过在设置页->启动参数设置选项中增加参数,来实现运行环境选择,具体参数说明如下:
参数名 | 是否必须 | 参数说明 | 默认值 |
engineType | 否 | 游戏的运行环境类型,取值范围:unity、cocos、webview - webview包:需要在webview环境调试 - runtime包: (1)cocos游戏:需要在cocos环境调试 (2)其他游戏:需要在unity环境调试 | -- |
useVConsole | 否 | 是否开启 vConsole,只当 engineType=unity 或 cocos 时生效 | false |
waitingDebugger | 否 | 是否在启动时等待 inspect 调试,只当 engineType=unity 或cocos 时生效 | false |
使用示例:
engineType=cocos&useVConsole=true&waitingDebugger=false
操作步骤:

3.2、保证连接
3.2.1、有线调试方式
打开chrome浏览器并在地址栏输入chrome://inspect(如果你使用的是Microsoft Edge浏览器,地址可改为edge://inspect),勾选discover USB devices和discover network targets.

提示
如果无法获取到inspect页面,也可通过以下步骤获取到调试目标。
1、在“Configure...”选项内输入: localhost:9229

2、在终端执行adb指令: adb forward tcp:9229 tcp:9229

3.2.2、无线调试方式
使用前确保调试设备与被调试设备在同一局域网下
打开chrome浏览器并在地址栏输入chrome://inspect(如果你使用的是Microsoft Edge浏览器,地址可改为edge://inspect),勾选discover network target.

在“Configure...”选项内,配置调试地址与端口,“手机ip:9229”

3.3、开启性能监控
engineType为cocos或unity时,可以通过开启性能面板选项,进一步查看游戏运行性能情况。

4、电脑端webwiew查看
打开谷歌浏览器,输入chrome://inspect,然后选择对应的链接inspect
