Version: 1.3
语言 : 中文
FrameDebugger
Memory Profiler增强

C#代码断点调试

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

注意: * 目前宿主上C# Debugging对新的.NET 8 Scripting Backend还不支持,所以请确保项目使用了IL2CPP的 Scripting Backend。 * 目前仅在Android端的Connect App支持宿主相关能力,未来将支持IOS端 * 微信开发者工具尚未支持C# Debugging能力,未来可能支持

使用流程

打包设置

  • 在构建时打开Development Build和Script Debugging。
  • 按照小游戏宿主中的流程打包小游戏

在宿主中开启C#代码调试

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

使用IDE连接宿主

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

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

  • 选择Attach to Unity Process
  • 选择WeixinMiniGame(WebGLHost, Tuanjie)
  • 注意: 如果在IDE中未搜索到相关Unity进程,可以通过手动输入HOST:PORT进行连接,其中HOST为Android设备ip,port固定为56789。
  • 若无线网络不稳定,可以通过ADB转发端口进行调试,步骤如下:
  • 安装ADB工具
  • 启用手机的USB调试模式
  • 使用USB线将安卓设备连接到调试用的计算机
  • 在计算机的命令行中输入以下两条命令:

    ### adb forward tcp:56789 tcp:56789 adb reverse tcp:54997 tcp:54997
  • 在IDE中指定127.0.0.1:56789进行连接

断点调试

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

FrameDebugger
Memory Profiler增强