search
开发文档
开发文档/快游戏开发/打包与调试/调试工具/调试指南
调试指南更新时间:2025-09-04 18:04:00

一、开发准备

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

上一篇:webview打包工具
下一篇:联盟快游戏
文档内容是否有帮助?
有帮助
无帮助