HashLink Debugger：为您的 HashLink JIT 应用提供强大的调试支持

HashLink Debugger 是为 VSCode 设计的扩展，专门用于调试 HashLink JIT 应用。该扩展仅适用于 64 位版本的 VSCode，确保您能够高效地进行调试工作。

从源码构建

如果您希望从源码构建该扩展，以下说明将为您提供帮助。请注意，这些步骤仅在从市场安装扩展时不需要。

编译

您需要 Haxe 4 以及以下依赖项：

haxelib install vshaxe
haxelib install vscode
haxelib install vscode-debugadapter
haxelib git hscript https://github.com/HaxeFoundation/hscript.git
haxelib git format https://github.com/HaxeFoundation/format.git

如果您想编译 VSCode 扩展或使用命令行节点版本，还需要 NodeJS，并安装以下依赖项：

npm install

准备好所有依赖项后，您可以使用 make build 进行编译。

命令行版本

除了 VSCode 插件，您还可以编译并运行一个类似 gdb 的命令行版本：

在 HashLink 中运行调试器：

cd hashlink-debugger/debugger
haxe debugger.hxml
hl debug.hl /my/path/filetodebug.hl

然后您可以使用类似 gdb 的命令，如 run/bt/break 等（请查看源代码）。

命令行调试器还可以使用 nodejs 编译和运行：

cd hashlink-debugger/debugger
haxe node_debug.hxml
npm install
node debugger.js /my/path/filetodebug.hl

安装

请注意，VSCode 不允许用户为单个扩展指定目录，因此，最简单的办法是将此存储库直接克隆到 VSCode 的扩展目录中（在 Windows 上为 C:\Users\\.vscode\extensions）。

或者，您可以运行 make package（需要先安装依赖项 npm install vsce -g）来生成 VSCode 扩展包文件（.vsix）。您可以使用 VSCode > 扩展 > 从 VSIX 安装来使用此文件。

支持的平台

支持 Windows、Linux 和 Mac（仅限 Intel 芯片，不适用于 Rosetta）。对于 OSX/MacOS，请确保您的 Hashlink 版本为 1.12.0 或更高，并且在安装过程中运行了 make codesign_osx。