# 真机调试能力升级 Beta
当前小游戏真机调试已支持以下能力：
- 在 Sources 面板中对源代码进行断点调试
- 在 Console 面板中查看日志、运行代码

虽然能对开发者调优、定位游戏问题提供一定帮助，但仍然存在以下问题：
1. Network 无法显示网络请求
2. Sources 显示的混淆后的代码
3. 函数调用、网络请求无法与游戏逻辑关联
4. 无法获取小游戏启动耗时、首帧耗时等小游戏框架的性能
5. 缺少wx接口耗时分析的手段

因此平台计划在原真机调试功能的基础上，逐步对小游戏真机调试能力进行升级。

原真机调试功能入口及基础使用请查看[文档](remote-debug)

## v1.0

### 版本变更
1. 支持 Performance 
2. Network 支持查看 wx.request、wx.downloadFile、wx.uploadFile、wx.connectSocket 数据
3. Sources 面板支持Source Map

### 版本要求
- Android 微信客户端版本 >= 8.0.55
- 基础库版本 >= 3.7.4
- 微信开发者工具版本 >= [Nightly 1.06.2412302](/miniprogram/dev/devtools/log.md)

> 注意：iOS暂不支持

### 使用

1. Network

Tab切换至 Network 面板，即可查看所有网络请求

  ![](https://res8.wxqcloud.qq.com.cn/wxdoc/cb3fa385-60a1-4f4b-a17b-239d2c05d763.png)

2. Sources

Tab切换至 Sources 面板，可查看业务源代码

  ![](https://res8.wxqcloud.qq.com.cn/wxdoc/dfc6c11c-1740-4234-b6da-fa862b393ab9.png)

3. Performance

Tab切换至 Performance 面板，可查看CPU和wx接口调用
> 关于Performance，可查阅[chrome文档](https://developer.chrome.com/docs/devtools/performance)

  ![](https://res8.wxqcloud.qq.com.cn/wxdoc/dbd47d34-c310-4d95-b8f4-73d1795e0950.png)
  ![](https://res8.wxqcloud.qq.com.cn/wxdoc/5f42c5ac-ea43-4237-8e4d-eeb37d42029e.png)

### 已知问题
1. Console 面板中会显示非业务的日志
2. Network 中的请求无法查看响应
3. Network 中部分请求响应的size显示为0
4. Network 中没有wx.createImage的请求

## v2.0

### 版本变更
1. 支持 iOS 高性能模式真机调试
2. 调试面板支持 Sources、Network、Console、Performance 功能
3. Sources 支持 Source Map
4. Network 支持查看 wx.request、wx.downloadFile、wx.uploadFile、wx.connectSocket 数据
5. Performance支持分析主线程执行性能

### 版本要求
- iOS 微信客户端版本 >= 8.0.61
- 基础库版本 >= 3.8.10
- 微信开发者工具版本 >= [Nightly 1.06.2506242](/miniprogram/dev/devtools/log.md)
- iOS 系统版本 >= 16.4
- 需开启小游戏[高性能模式](/minigame/dev/guide/performance/perf-high-performance.md)

### 使用

#### 前置准备
- 通过 USB 数据线将 iOS 设备连接到电脑（如果是 Mac 则可直接连接，Windows 电脑需要安装 [iTunes](https://www.apple.com/itunes/)）
- iOS 设备开启「网页检查器」：设置 - Safari浏览器 - 高级 - 网页检查器
- iOS 设备信任电脑、电脑允许配件连接

使用 Mac 电脑时，可以通过以下方式验证前置准备是否完成：参考[Enabling Web Inspector](https://webkit.org/web-inspector/enabling-web-inspector/)开启 Safari 的「开发」子菜单， iOS 手机通过数据线连接电脑后，可在「开发」中显示设备。

#### 切换 iOS 系统调试
默认「iOS 系统」调试不可选择，当满足以下条件时可选：
- 完成前置准备
- iOS 系统版本 >= 16.4
- 开启小游戏高性能模式

  ![](https://res8.wxqcloud.qq.com.cn/wxdoc/d5a4b017-9b90-40df-b649-31beba092145.png)

> 注意：只支持一台 iOS 设备和电脑连接，请拔掉除调试设备外的其他 iOS 设备

#### 使用 iOS 设备扫码调试
使用 iOS 设备扫码后，即可正常开始调试

> 注意：当使用 iOS 客户端版本或基础库版本不符合要求的设备扫码时，会立即结束调试

### 已知问题
1. Windows 电脑上使用时，会出现防火墙提示，允许即可
2. Mac 电脑请确保已安装如下包
- libplist
- libusbmuxd
- libimobiledevice

  示例
  > brew install libplist libusbmuxd libimobiledevice

## 问题反馈 & 建议

- **问题反馈&建议**：[点击查看二维码](https://mmgame.qpic.cn/image/1d8915a34e424ae59a6870c55d0b5f17dca54dba7e291f7c4cc196df8247f9d2/0)