如何配置Swift Package Manager引入iOS SDK中的C++头文件

问题分析 #

你当前配置里直接用相对路径usr/include/c++/v1作为头搜索路径是无效的——这个路径属于iOS SDK的系统目录，SPM无法通过相对路径定位到正确的SDK位置。同时你的测试目标依赖配置存在错误（依赖自身），需要同步修正。

正确配置方案 #

1. 修正头搜索路径配置 #

对于iOS SDK自带的标准C++头文件，你可以通过SDKROOT环境变量动态引用SDK路径，无需硬编码绝对路径。修改cxxSettings如下：

cxxSettings: [
    .headerSearchPath("$(SDKROOT)/usr/include/c++/v1"),
    // 明确指定使用iOS默认的libc++标准库，避免编译冲突
    .unsafeFlags(["-stdlib=libc++"])
]

$(SDKROOT)会自动指向当前编译环境下的iOS SDK根目录，确保头文件路径的正确性。

2. 修正测试目标的依赖配置 #

测试目标LibModuleTests当前依赖自身会导致编译错误，需改为依赖你要测试的模块：

.testTarget(
    name: "LibModuleTests",
    dependencies: ["LibModule1", "LibModule2Framework"]),

3. 完整修正后的Package.swift #

let package = Package(
    name: "LibProject",
    platforms: [.iOS(.v13)],
    products: [
        .library(
            name: "LibProject",
            targets: ["LibModule1", "LibModule2Framework"]),
    ],
    dependencies: [
    ],
    targets: [
        .target(
            name: "LibModule1",
            path: "Sources/LibModule1",
            // 如果LibModule1也需要引用C++头文件，同步添加cxxSettings
            cxxSettings: [
                .headerSearchPath("$(SDKROOT)/usr/include/c++/v1"),
                .unsafeFlags(["-stdlib=libc++"])
            ]),
        .target(
            name: "LibModule2Framework",
            path: "Sources/LibModule2Framework",
            publicHeadersPath: ".",
            cxxSettings: [
                .headerSearchPath("$(SDKROOT)/usr/include/c++/v1"),
                .unsafeFlags(["-stdlib=libc++"])
            ]
        ),
        .testTarget(
            name: "LibModuleTests",
            dependencies: ["LibModule1", "LibModule2Framework"]),
    ],
    cLanguageStandard: .c17,
    cxxLanguageStandard: .gnucxx17
)

额外说明 #

• 若使用自定义iOS SDK（非Xcode默认），需确保SDKROOT环境变量指向自定义SDK根目录，或直接把$(SDKROOT)替换为自定义SDK的绝对路径。
• 确认C++代码中系统头文件用尖括号引用（如#include <string>），而非双引号，确保编译器从指定的系统路径查找。

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