hmap 是一个命令行工具，用于处理 Xcode 生成的 Clang 头文件映射 (header map)。它使用 Swift 编写。

注意：我还创建了 chmap，一个跨平台工具，它提供了与 hmap 类似的功能。

• Homebrew: brew install milend/taps/hmap
• 从 GitHub 获取 发布版本。
• 从源代码构建。请参阅以下说明。

打印头文件映射的内容

hmap print ~/path/to/header_map.hmap

将二进制头文件映射的内容转换为 JSON

hmap convert ~/header_map.hmap ~/header_map.json

hmap 通过查看路径的文件扩展名来推断文件格式。

您也可以使用 convert 命令从 JSON 创建二进制头文件映射

hmap convert ~/header_map.json ~/header_map.hmap

您可以通过使用 hmap --help 来发现所有命令和选项。

• hmap 需要 Swift 5。
• 从 Xcode 10.2 开始，Swift 5 命令行工具需要 Swift 5 运行时库，该库包含在 macOS Mojave 10.4.4 中。如果您运行的是早期版本的 macOS，则需要安装 Swift 5 命令行工具运行时支持。

在使用 Xcode 构建之前，您必须通过运行以下命令下载所有依赖项

swift package update

然后通过运行以下命令生成 Xcode 项目

swift package generate-xcodeproj

如果您想从命令行构建，请运行

swift build

要生成适合分发的发布版本，请运行

swift build -c release

要验证所有测试是否通过，请运行

swift test