BugTrap 技术文档

1. 安装指南

下载与安装

从本项目仓库的发布（Releases）部分下载最新的 BugTrap.zip 文件，其中包含了在 Win32/x64 项目中所需的所有 BugTrap 组件：

• BugTrap[U][D][N][-x64].dll - BugTrap DLL 模块。
• BugTrap[U][D][N][-x64].lib - 由链接器使用的 BugTrap 库文件。
  • [U] - Unicode 版本带有 'U' 字母。ANSI 版本不包含 'U' 字母。
  • [D] - 调试版本带有 'D' 字母。发布版本不包含 'D' 字母。
  • [N] -托管 (.NET) 版本带有 'N' 字母。原生版本不包含 'N' 字母。
  • [-x64] - AMD-64 平台的 64 位版本有 '-x64' 后缀。x86 版本不包含此后缀。
• dbghelp.dll - DbgHelp 库（详细信息请参阅 "BugTrap 开发者指南"）。
• BugTrap.h - 包含 BugTrap API 定义的头文件。
• BTTrace.h - 自定义日志函数的 C++ 包装器。
• BTAtlWindow.h - ATL/WTL 异常处理程序。
• BTMfcWindow.h - MFC 异常处理程序。
• CrashExplorer.exe - MAP 文件分析器。
• BugTrap.chm - BugTrap 1.x 规范。

请参阅 "BugTrap 开发者指南" 以获取有关 BugTrap 用于 Win32/x64 的文件类型的额外信息。

服务器端应用程序

在 BugTrap.zip 中，您还可以找到以下服务器应用程序，用于服务器端接受崩溃报告：

• Server\BugTrapServer - 用 C# 编写的 BugTrap 服务器 Windows 服务。
• Server\BugTrapWebServer - 用 ASP.NET 编写的 BugTrap Web 服务器。
• Server\JBugTrapServer - 用 Java 编写的 BugTrap 服务器。

您可以选择任何服务器技术以开始接受来自 BugTrap 客户端的崩溃报告。打开并编辑 *.config 文件以设置不同的配置参数。

2. 使用说明

BugTrap 用于捕获托管和非托管 .NET 代码中的未处理异常，并支持将崩溃报告发送到远程服务器进行分析。有关 BugTrap 的详细用法，请参阅原作者 Maksim Pyatkovskiy 在 CodeProject 上的文章《Catch All Bugs with BugTrap》。

3. 项目 API 使用文档

项目 API 文档包含在下载的 BugTrap.chm 文件中，详细介绍了 BugTrap 的各种函数和类，以及如何使用它们来捕获和处理异常。

4. 项目安装方式

项目的安装方式是通过下载和解压提供的 BugTrap.zip 文件。将解压后的文件集成到您的开发环境中，并根据需要配置相应的服务器应用程序以接收和处理崩溃报告。请参考上述的安装指南以获取详细步骤。