C# 代码断点调试

我们的小游戏 Connect App 方案实现了 C# 代码的 debug 能力。如同在其它平台一样，开发者可以通过 Visual Studio 或 Rider，调试 Connect App 中运行的小游戏。可以正常地连接到小游戏，设置断点，查看变量值，单步执行等等。

注意：

• .NET 8 Scripting Backend 暂不支持C# Debugging，请确保项目使用了 IL2CPP 的 Scripting Backend；
• 目前仅在 Android 端的 Connect App 支持 Connect App 相关能力，IOS 端暂未支持；
• 微信/抖音开发者工具尚未支持 C# Debugging 能力。

使用流程

打包设置

• 勾选小游戏构建配置文件 Inspector 中的 Development Build 和 Script Debugging。
• 按照Unity 小游戏宿主打包及上传中的流程打包小游戏。

在 Connect App 中开启 C# 代码调试

开发者需在 菜单栏 -> 开发调试 -> 开启 C# 代码调试 开启开发调试，此时会开启 DebugProxy，以便 IDE 扫描到相关进程并进行后续连接。开启后在同样位置可以关闭开发调试。

使用 IDE 连接 Connect App

使用前请确保运行 Connect App 的设备和 IDE 处于同一局域网内。

以 Rider 为例，在 Rider 中打开工程。

• 选择 Attach to Unity Process

• 选择 WeixinMiniGame(WebGLHost, Tuanjie)

• 注意：如果在 IDE 中未搜索到相关 Unity 进程，可以通过手动输入 HOST:PORT 进行连接，其中 HOST 为 Android 设备 ip，port 固定为 56789。
• 若无线网络不稳定，可以通过 ADB 转发端口进行调试，步骤如下：
  1. 安装 ADB 工具；
  2. 启用手机的 USB 调试模式；
  3. 使用USB线将安卓设备连接到调试用的计算机；
  4. 在计算机的命令行中输入以下两条命令： adb forward tcp:56789 tcp:56789 adb reverse tcp:54997 tcp:54997
  5. 在IDE中指定 127.0.0.1:56789 进行连接

断点调试

Attach 完成后，即可进行代码的断点调试