如何通过Swift Package Manager为XCFramework配置外部头文件路径？

问题场景 #

我正尝试将一个XCFramework封装为Swift包，目录结构如下：

/MyXCFPackage
    /Package.swift
    /MyXCFPackage.xcframework
    /include <- 存放额外头文件

当前使用的Package.swift内容：

// swift-tools-version:5.6
import PackageDescription

let package = Package(
    name: "MyXCFPackage",
    products: [
        .library(
            name: "MyXCFPackage",
            targets: ["MyXCFPackage"])
    ],
    targets: [
        .binaryTarget(
            name: "MyXCFPackage",
            path: "./MyXCFPackage.xcframework"
        )
    ]
)

该XCFramework并非为Swift Package Manager设计，仅包含.a库文件，未内置头文件。将此包引入客户端项目后，无法访问include目录下的头文件。框架要求需将/include目录添加到Xcode的HEADER_SEARCH_PATHS构建设置中，请问如何通过Swift Package Manager实现这一配置？

解决方案 #

直接在binaryTarget中添加对应的编译设置，指定头文件搜索路径即可。修改后的Package.swift代码如下：

// swift-tools-version:5.6
import PackageDescription

let package = Package(
    name: "MyXCFPackage",
    products: [
        .library(
            name: "MyXCFPackage",
            targets: ["MyXCFPackage"])
    ],
    targets: [
        .binaryTarget(
            name: "MyXCFPackage",
            path: "./MyXCFPackage.xcframework",
            // 为C/C++代码配置头文件搜索路径
            cxxSettings: [
                .headerSearchPath("./include")
            ],
            // 如果需要在Swift代码中直接调用C/C++接口，添加此配置
            swiftSettings: [
                .unsafeFlags(["-I", "./include"])
            ]
        )
    ]
)

关键说明 #

• 若头文件为纯C语言，可使用cSettings替代cxxSettings，效果一致。
• ./include是相对于Package.swift的相对路径，需确保目录结构与路径匹配。
• 配置完成后，Swift Package Manager会自动将该路径注入到客户端项目的HEADER_SEARCH_PATHS中，无需手动在Xcode里调整。

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