Swift OpenAPI Generator 在 visionOS 平台的使用注意事项

在使用 Swift OpenAPI Generator 为 visionOS 项目生成 API 客户端代码时，开发者可能会遇到一个常见的配置问题。这个问题源于对工具链工作原理的误解，但解决方案其实非常简单。

Swift OpenAPI Generator 包含两个主要部分：代码生成器和运行时库。代码生成器是一个构建时工具，它会在编译前根据 OpenAPI 规范自动生成客户端代码。而运行时库则提供了这些生成代码所依赖的基础设施。

关键在于，_OpenAPIGeneratorCore 这个模块是专门为代码生成器本身服务的，不应该被链接到最终的应用目标中。当开发者通过 Xcode 的包插件添加依赖时，系统可能会默认选中这个模块进行链接，这就导致了构建错误。

典型的错误表现是构建过程中出现与 Yams 库相关的平台检查失败。这是因为 _OpenAPIGeneratorCore 包含了只在构建时需要的依赖，而这些依赖可能不完全支持 visionOS 平台。

解决方案很简单：检查你的 visionOS 应用目标，确保在"Link Binary With Libraries"构建阶段没有包含 _OpenAPIGeneratorCore。只需要保留生成的客户端代码和运行时库即可。

这个问题的根源在于 Xcode 包管理器的默认行为不够智能。虽然 Swift OpenAPI Generator 已经在代码中添加了平台检查来提醒开发者，但在当前 Xcode beta 版本中，这些警告可能不会直接显示在问题导航器中，除非开发者手动打开相关源文件。

对于 visionOS 开发者来说，记住一个原则：Swift OpenAPI Generator 的代码生成是构建时过程，生成完成后就不再需要生成器本身的任何组件。正确配置后，这个工具可以完美支持 visionOS 平台，为你的空间计算应用提供强大的 API 客户端生成能力。