Version: 1.4
语言 : 中文
C# 代码断点调试
Memory Profiler 模块增强

FrameDebugger

本手册将以微信小游戏平台为例,指导您如何有效使用 Frame Debugger,以提升开发效率和调试体验。

Development Build

  1. 在 Build Settings 窗口中切换到 MiniGame 平台,配置并勾选小游戏构建配置文件 Inspector 中的 Development Build 选项,来支持 Frame Debugger 功能。

  2. 在 Player Settings 中,选择 Resolution and Presentation,确保勾选 Run In Background 选项,以便在调试时更加方便。

  3. 在 Build Settings 中打包生成后,会得到两个文件夹:
    • minigame:使用微信开发者工具打开此文件夹,可以自动连接到 Unity 编辑器。
    • WebGL:此文件夹包含的项目不支持后台运行。在连接编辑器后,如果启用了 Frame Debugger ,需要切换回网页以传输调试数据。

*注意事项

  • 如果在 Frame Debugger 窗口中无法找到运行中的微信应用,打开微信应用后将自动连接到编辑器,名称显示为 Autoconnected Player
  • 编辑器为被动连接。在进行 development build 前,可能会有 player 无法连接上编辑器的情况。可进行一个 develop build 后,再做尝试。

Frame Debugger Build

我们为小游戏平台提供了一个新的 build 参数 Frame Debugger Build,可以打包出带有 Frame Debugger 功能的 release 版本,相比 development build 更轻量。

  1. 需要在对应小游戏构建配置文件 Inspector 中选择 Frame Debugger Build。注意当选中 Development Build 时,该参数不生效

  2. Frame Debugger Build 打包出来的包,需要配合外置 boot.config 一同使用才能连接到 editor ,详见下文中的 外置boot.config

  3. 该模式下打包生成后,同样会得到两个文件夹。其中 minigame 文件夹下的项目不支持外置 boot.config ,因此无法在该类情况下使用 Frame Debugger 。在 WebGL 文件夹下的项目可以使用 Frame Debugger 。

  4. 其他与 Development Build 下使用 Frame Debugger 相同。

外置 boot.config

使用流程

  1. 选择正确的target:WeixinMiniGame,适用范围与上面的 FrameDebugger 相同
    • Development Build
    • 开启了 FrameDebugger 的 Release Build
  2. 正常build到对应路径,例如路径 /Build/

  3. /Build/ 下创建一个 boot.config,或者找到生成的 boot.config,其为项目路径下 $ProjectName/Library/PlayerDataCache/WeixinMiniGame/Data ,并将其复制到 /Build/ 目录文件夹 系统生成的 boot config 复制到打包路径

  4. 运行 WebGL,其会自动读取目录 boot.config 。修改后,刷新网页即可使用。

参数说明

player-connection-mode=Connect
player-connection-guid=2969982123
player-connection-debug=0
player-connection-project-name=My project
player-connection-wait-timeout=-1
player-connection-ip=aaa.bbb.ccc.ddd
player-connection-ip=eee.fff.ggg.hhh
profiler-enable=1
wait-for-native-debugger=0
hdr-display-enabled=0

该参数的关键在于 player-connection-ip,需将其设置为 Editor 所在机器的 IP 地址。也可以指定端口号,但如果不熟悉端口配置,建议保持默认设置。

C# 代码断点调试
Memory Profiler 模块增强