立即下载
EN
中文
【教程】COCOS Creator 扫码预览与调试
2026.10.17
教程 Cocos Creator

01 准备 Hello PinK

 

在手机上下载并安装 Hello PinK,已安装的用户可直接进行下一步。 >> 点击前往官网下载

* 使用建议:建议优先使用 Android 设备进行扫码预览与调试。iOS 版 Hello PinK 预览功能正常,暂不支持调试。
* 文件过大单次加载时间过长可能导致失败,可再次尝试 ,当前主包与分包大小限制为500M,分包数量限制为最多50个。

 

 

02 构建成功后打开调试窗口

 

在 COCOS Creator 的「构建发布」页面,确认对应构建记录显示「成功」。点击该记录右侧的「调试」,弹出「OpenPaaS 调试窗口」,显示用于扫码调试的二维码。

 

图 1 构建成功后点击 Run 打开调试二维码

 

* 示例二维码已打码。实际操作时,请在窗口提示的有效期内扫描当前显示的二维码。

 

 

03 使用 Hello PinK 扫码

 

1. 在手机上打开 Hello PinK App。

2. 点击首页的「扫描二维码」,扫描 Creator「OpenPaaS 调试窗口」中的二维码。

3. 打开游戏进入预览。

图 2 Hello PinK 首页的扫描二维码入口

 

 

04 扫码后预览游戏

 

扫码并完成游戏包安装后,打开对应游戏,查看运行画面。在预览界面中,可直接操作游戏,检查画面显示、按钮响应及游戏流程。

 

图 3 游戏预览与 vConsole 入口示意图

 

 

05 开始调试

 

扫码连接成功后,可在电脑端自动打开的 DevTools 中进行调试,并结合手机端的游戏操作检查运行情况。

确认右侧显示「已连接」和「调试已连接」。在手机上操作游戏,并在电脑端的 Console 面板中查看日志输出,辅助检查运行情况。

 

* Android 用户需要查看运行日志时,可点击手机预览界面中的「vConsole」。

* iOS 不提供 vConsole。下图为示例,实际画面以当前调试的项目为准。

 

图 4 调试面板示意图