真机调试

概述

为帮助开发者更精准定位代码问题、提升开发效率， TapTap 平台进一步强化调试能力，提供完整的日志追踪（Log）与实时调试（Debug）工具链。开发者可通过集成化面板实时捕获运行阶段的日志信息，支持多层级日志分类检索、异常堆栈深度解析及运行上下文状态还原；同时开放断点调试、内存快照分析、变量动态监控等功能模块，实现代码执行流程的逐帧追踪与资源消耗可视化，有效缩短问题排查周期。该能力覆盖主流开发环境与多终端设备，助力开发者在复杂场景下快速定位逻辑漏洞，优化代码质量与运行稳定性。

使用小游戏测试包

TapTap 小游戏支持 TapTap Android 版本 2.83.0 及以上，iOS 版本 4.55.0 及以上。使用App扫码功能，在小游戏开发后台扫描测试包二维码进入小游戏

Android

配置环境

• Android小游戏调试是利用Chrome DevTools调试，因此需要安装Chromel浏览器。
• adb 调试工具，需要安装Android SDK，并配置环境变量。
• 手机打开开发者模式，开启USB调试模式。
• 执行 adb forward tcp:9229 tcp:9229

调试流程

1. 打开Chrome浏览器，输入 chrome://inspect/#devices
2. 打开小游戏，右上角点击唤起面板， 选择开发调试

3. 点击打开调试

4. 重新进入游戏，在浏览器里看到设备信息，点击 inspect

iOS

查看日志

vConsole

在小游戏菜单中开启日志并重新启动小游戏

在游戏界面中可点击 vConsole 按钮打开窗口查看日志

设备日志

调试设备连接macOS，打开 控制台

选择对应的设备，开启日志流式传输，并在搜索栏筛选 子系统: com.taptap.instantGame

Safari调试

准备工作 (如已完成可跳过)

1. 调试设备 打开调试设备的 系统设置，找到 Safari浏览器 设置， 找到 高级(最底部)， 点击进入页面，打开 网页检查器 选项

2. macOS 打开 Safari 浏览器的 设置 ，切换到 高级 选项卡，打开 显示网页开发者 选项开关

开始调试

1. 调试设备连接macOS，在小游戏菜单中开启调试并重新启动小游戏

2. 在小游戏弹出提示框后，在macOS的Safari中找到并点击对应的小游戏运行容器 小游戏提示框 Safari连接容器 Safari网页检查器

3. 连接完成后，小游戏界面中点击 确定 进入游戏，此时Safari网页检查器中会展示游戏js代码，此时即可通过断点调试

如需重新调试，可以在小游戏菜单中点击 重启，并重复2，3步操作，即可重新运行小游戏，断点在小游戏重启后不会消失