Swift Package可通过Xcode构建但swift build失败：缺失.h头文件

问题根源 #

1. 依赖未绑定到目标Target #

你的Package.swift仅在顶层声明了依赖，但未将该依赖关联到McuMgr.Bindings.iOS目标。SwiftPM命令行工具严格遵循配置文件逻辑，不会自动关联未明确指定的依赖，导致构建时不会编译McuManager模块，自然无法生成McuManager-Swift.h这类Swift/Objective-C桥接头文件，最终触发头文件缺失错误。

Xcode能正常构建是因为它有自身的依赖解析逻辑（如缓存、隐式关联），但SPM命令行不会做这类额外处理。

2. 依赖名称匹配错误 #

你在dependencies中给依赖命名为McuMgr，但实际拉取的包中，需要引入的模块名称是McuManager（从代码里的import McuManager和错误信息可确认），且包的实际名称为IOS-nRF-Connect-Device-Manager，名称不匹配会导致SPM无法正确识别依赖。

修复代码 #

修改Package.swift的targets部分，明确绑定依赖：

// swift-tools-version:5.3

import PackageDescription

let package = Package(
    name: "McuMgr.Bindings.iOS",
    platforms: [.iOS(.v9), .macOS(.v10_13)],
    products: [
        .library(
            name: "McuMgr.Bindings.iOS",
            targets: ["McuMgr.Bindings.iOS"]
        ),
    ],
    dependencies: [
        .package(
            url: "https://github.com/Laerdal/IOS-nRF-Connect-Device-Manager.git",
            .exact("0.13.0")
        ),
    ],
    targets: [
        .target(
            name: "McuMgr.Bindings.iOS",
            path: "Source",
            exclude:["Info.plist"],
            // 新增：绑定依赖包中的McuManager模块
            dependencies: [.product(name: "McuManager", package: "IOS-nRF-Connect-Device-Manager")]
        )
    ]
)

验证步骤 #

1. 清理缓存：swift package clean
2. 重新构建：swift build

此时之前的“依赖未被使用”警告会消失，SPM会正确编译依赖模块并生成所需的桥接头文件，构建即可成功。

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