BepInEx.Debug 使用教程

BepInEx.Debug 使用教程

BepInEx.Debug Tools for debugging and developing BepInEx plugins 项目地址: https://gitcode.com/gh_mirrors/be/BepInEx.Debug

1. 项目介绍

BepInEx.Debug 是一个为 BepInEx 插件开发提供调试工具和资源的开源项目。它旨在帮助开发者更有效地开发和调试 BepInEx 插件，包含了一系列实用的工具，如异常解析器、内部日志镜像、简易性能分析器等。

2. 项目快速启动

以下是一个快速启动 BepInEx.Debug 的指南：

首先，确保你已经安装了至少 BepInEx 5.x 版本。

然后，从 GitHub 上克隆或下载 BepInEx.Debug 项目：

git clone https://github.com/BepInEx/BepInEx.Debug.git

根据你的游戏是 32 位还是 64 位，将 MonoProfiler32.dll 或 MonoProfiler64.dll 文件复制到游戏根目录下，确保它们位于游戏的可执行文件和其它 DLL 文件旁边。

接下来，对于项目中的其他工具（如 DemystifyExceptions、MirrorInternalLogs 等），你需要编译它们，并将编译后的 DLL 文件放入 BepInEx/patchers 目录下。

3. 应用案例和最佳实践

异常解析器使用案例

将 DemystifyExceptions 编译后的 DLL 文件放入 BepInEx/patchers 目录。这个工具会将异常转换成更易读的格式，特别是对于复杂的结构，如枚举器、Lambda 表达式等。

内部日志镜像最佳实践

使用 MirrorInternalLogs 工具来捕获和镜像 Unity 的内部调试日志。将编译后的 DLL 文件放入 BepInEx/patchers 目录，它会创建一个公共事件，开发者可以监听这个事件来接收所有的 Unity 日志。

性能分析器应用案例

Simple Mono Profiler 可以在任何可以运行 BepInEx 5.x 的 Unity 玩家构建中用作性能分析工具。只需将发布存档解压到游戏根目录，然后按配置文件中指定的热键（默认为 KeyCode.BackQuote）来触发数据转储。

4. 典型生态项目

BepInEx 社区中有很多基于 BepInEx 的插件和工具，例如：

• BepInEx.Harmony：一个用于在 BepInEx 插件中应用 Harmony Patch 的库。
• BepInEx.IL2CPP：用于在 IL2CPP 编译的游戏中运行 BepInEx 插件的兼容层。
• BepInEx.Preloader：一个预加载程序，用于在游戏启动前加载和初始化 BepInEx 插件。

以上就是 BepInEx.Debug 的使用教程，希望对您的插件开发有所帮助。

BepInEx.Debug Tools for debugging and developing BepInEx plugins 项目地址: https://gitcode.com/gh_mirrors/be/BepInEx.Debug