Swift Package Manager 中 --experimental-prepare-for-indexing 的插件工具依赖问题解析

问题背景

在使用 Swift Package Manager 构建项目时，开发者可能会遇到一个特定错误：当尝试使用 --experimental-prepare-for-indexing 标志进行构建时，系统报告找不到名为 swift-openapi-generator-arm64-apple-macosx15.0-debug-tool.exe 的目标。

技术分析

问题本质

这个问题的根源在于 Swift Package Manager 的索引准备机制。当使用 --experimental-prepare-for-indexing 标志时，构建系统会生成一个精简版的构建清单(manifest)，该清单只包含编译命令，并且仅创建宏(.macro)和插件(.plugin)产品的命令。

深层原因

在当前的实现中，LLBuildManifestBuilder.generatePrepareManifest(at:) 方法会过滤掉非宏和非插件类型的构建目标。然而，某些插件(如 OpenAPIGenerator 插件)实际上依赖于可执行工具(如 swift-openapi-generator)，这些工具本身并不是插件或宏，因此被排除在精简清单之外，导致构建失败。

平台兼容性问题

另一个值得注意的细节是，在非 Windows 平台(如 macOS)上，构建系统仍然会在目标名称后附加 .exe 后缀。这虽然不会导致功能性问题，但会造成一定的混淆。正确的做法应该是根据目标平台来决定是否添加可执行文件扩展名。

解决方案建议

1. 构建清单生成逻辑改进：需要修改 LLBuildManifestBuilder 的逻辑，使其不仅包含插件目标本身，还要包含这些插件所依赖的工具可执行文件。

2. 平台感知的文件命名：修正可执行文件命名逻辑，使其能够根据目标平台决定是否添加 .exe 后缀。

3. 依赖关系完整性检查：在准备索引阶段，构建系统应该能够识别并包含插件运行所需的所有依赖项，确保构建过程的完整性。

对开发者的影响

这个问题主要影响那些使用插件系统(特别是需要调用外部工具的插件)的项目。开发者在使用 --experimental-prepare-for-indexing 标志时需要注意：

• 如果项目使用了需要外部工具的插件，可能会遇到类似的构建失败
• 目前可以通过临时修改构建清单生成逻辑作为变通方案
• 长期解决方案需要等待 Swift Package Manager 的官方修复

总结

这个问题揭示了 Swift Package Manager 在实验性索引准备功能中对插件依赖处理的不完整性。理解这一机制有助于开发者在遇到类似问题时更快定位原因，并采取适当的应对措施。随着 Swift 工具链的不断发展，这类问题有望在未来的版本中得到完善解决。