本地及Azure DevOps Pipeline中swift-openapi-generator命令行构建失败

可能的原因与解决步骤 #

1. 修正Swift Package依赖配置 #

确保swift-openapi-generator仅作为Build Tool Plugin引入，而非普通target依赖。错误的配置会导致Xcode自动链接_OpenAPIGeneratorCore。

正确的Package.swift配置示例：

let package = Package(
    name: "YourPackage",
    dependencies: [
        // 仅添加运行时依赖，不要将swift-openapi-generator放在这里
        .package(url: "https://github.com/apple/swift-openapi-runtime", from: "1.0.0"),
        // 插件依赖放在package的dependencies里
        .package(url: "https://github.com/apple/swift-openapi-generator", exact: "1.0.0"),
    ],
    targets: [
        .target(
            name: "YourTarget",
            dependencies: [
                .product(name: "OpenAPIRuntime", package: "swift-openapi-runtime"),
            ],
            plugins: [
                // 在这里声明使用生成器插件
                .plugin(name: "OpenAPIGenerator", package: "swift-openapi-generator"),
            ]
        ),
    ]
)

如果之前误将swift-openapi-generator加入了target的dependencies，请移除该条目。

2. 清理CI环境缓存 #

Azure DevOps Pipeline可能缓存了旧的依赖解析结果或派生数据，导致构建异常：

• 在xcodebuild命令前添加清理步骤：

  xcodebuild clean -project YourProject.xcodeproj -scheme YourScheme -configuration Release
  rm -rf ~/Library/Caches/org.swift.swiftpm
  rm -rf .build  # 仅适用于SPM项目
  

• 若使用CocoaPods，执行：

  pod deintegrate && pod install
  

3. 检查Build Settings中的意外链接配置 #

进入项目target的Build Settings，搜索以下项：

• Other Linker Flags：若存在-l_OpenAPIGeneratorCore或指向该库的条目，直接删除
• Framework/Library Search Paths：确认没有指向_OpenAPIGeneratorCore的路径

4. 验证Build Phases配置 #

• 查看Run Build Tool Plug-ins阶段，确保仅运行OpenAPIGenerator插件，无额外依赖
• 再次确认Link Binary With Libraries中确实不存在_OpenAPIGeneratorCore相关库文件

5. 调整xcodebuild命令参数 #

强制重新解析依赖并使用正确的构建参数：

xcodebuild build -project YourProject.xcodeproj -scheme YourScheme -configuration Release -resolvePackageDependencies -destination 'generic/platform=iOS'

若为SPM项目，可尝试用swift build替代xcodebuild：

swift build -c release

6. 锁定兼容的generator版本 #

Xcode 15.0.1可能与特定版本的swift-openapi-generator更兼容，建议在Package.swift中指定精确版本，避免自动升级到不兼容版本。

内容的提问来源于stack exchange，提问作者zeeshan