Swift Package Manager中如何配置SWIFT_OBJC_BRIDGING_HEADER桥接头文件

首先明确：Swift Package Manager 本身不支持直接使用传统 Xcode 项目的桥接头文件配置，你可以通过以下两种方案实现需求：

方案一：在包清单（Package.swift）中配置框架依赖 #

如果是依赖公开的二进制 OC 框架，直接在目标配置中添加链接参数和头文件搜索路径即可：

• 打开你包根目录下的 Package.swift 文件
• 在对应 Swift 目标的 linkerSettings 中添加需要链接的 OC 框架，示例配置如下：

.target(
    name: "你的Swift目标名",
    dependencies: [],
    linkerSettings: [
        .linkedFramework("Framework") // 替换为你实际的OC框架名
    ]
)

• 如果是自定义的第三方 OC 框架，需要额外在 swiftSettings 中添加头文件搜索路径，确保编译器能找到对应头文件：

.target(
    name: "你的Swift目标名",
    dependencies: [],
    swiftSettings: [
        .unsafeFlags(["-I", "路径/to/框架的头文件目录"]) // 替换为实际头文件所在路径
    ],
    linkerSettings: [
        .linkedFramework("Framework")
    ]
)

配置完成后，你就可以直接在 Swift 代码中使用 import Framework 导入框架，不需要手动写 #import 语句。

方案二：通过中间 OC 目标桥接 #

如果框架需要特殊的头导入逻辑，或者你需要用到框架中没有暴露到模块map的内容，可以在包中新增一个 OC 类型的目标作为中间层：

• 在 Package.swift 中新增一个 OC 目标，在该目标的 umbrella header（伞头文件）中导入你需要的 OC 框架头：

//  OC 目标的伞头文件，命名为和目标同名，比如你的OC目标叫ObjcBridge，就叫ObjcBridge.h
#import <Foundation/Foundation.h>
#import <Framework/header.h>
//! Project version number for ObjcBridge.
FOUNDATION_EXPORT double ObjcBridgeVersionNumber;
//! Project version string for ObjcBridge.
FOUNDATION_EXPORT const unsigned char ObjcBridgeVersionString[];

• 配置 OC 目标的依赖和框架链接参数，再将你的 Swift 目标依赖这个 OC 中间目标即可，Swift 代码可以直接调用到 OC 目标中暴露的所有接口，包括你导入的 OC 框架内容。

注意：如果是二进制框架，需要确保你已经通过 .binaryTarget 将框架添加到包的依赖中，否则会出现链接失败的问题。

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