如何将含WolfSSL、nanopb依赖的C库打包为Swift Package？

核心思路 #

将自有C库、依赖的第三方C库（WolfSSL、nanopb）统一纳入Swift Package结构，通过Package.swift配置编译规则与依赖关系，确保其他开发者能直接通过SPM集成，无需额外处理第三方库的编译逻辑。

1. 组织项目目录结构 #

采用模块化布局，将自有库与第三方库分开存放，便于维护：

MyCLibrarySPM/
├── Package.swift
├── Sources/
│   ├── MyCLibrary/          # 你的自有C库
│   │   ├── include/         # 对外暴露的头文件
│   │   │   └── my_lib.h
│   │   └── src/             # 自有库实现代码
│   │       └── my_lib.c
│   ├── WolfSSL/             # WolfSSL源码（或预编译XCFramework）
│   │   ├── include/
│   │   └── src/
│   └── nanopb/              # nanopb源码（或预编译XCFramework）
│       ├── include/
│       └── src/
└── Tests/
    └── MyCLibraryTests/     # 可选：Swift或C编写的测试用例

2. 配置Package.swift #

根据第三方库的形式（源码/预编译XCFramework）选择对应配置方式：

场景1：第三方库以源码形式引入

将WolfSSL、nanopb作为独立Target，让自有库依赖它们：

// swift-tools-version: 5.9
import PackageDescription

let package = Package(
    name: "MyCLibrary",
    products: [
        .library(
            name: "MyCLibrary",
            targets: ["MyCLibrary"]),
    ],
    targets: [
        // 自有C库Target
        .target(
            name: "MyCLibrary",
            dependencies: ["WolfSSL", "nanopb"],
            path: "Sources/MyCLibrary",
            publicHeadersPath: "include", // 指定对外暴露的头文件目录
            cSettings: [
                .headerSearchPath("include"),
                .headerSearchPath("../WolfSSL/include"),
                .headerSearchPath("../nanopb/include"),
                // 自有库需要的编译宏，按需添加
                .define("MY_LIB_ENABLE_LOG", .when(configuration: .debug))
            ]
        ),
        // WolfSSL源码Target
        .target(
            name: "WolfSSL",
            path: "Sources/WolfSSL",
            publicHeadersPath: "include",
            cSettings: [
                .headerSearchPath("include"),
                // WolfSSL专属编译选项，参考其官方文档
                .define("WOLFSSL_USER_SETTINGS"),
                .define("NO_FILESYSTEM")
            ]
        ),
        // nanopb源码Target
        .target(
            name: "nanopb",
            path: "Sources/nanopb",
            publicHeadersPath: "include",
            cSettings: [
                .headerSearchPath("include"),
                .define("NANOPB_NO_UNALIGNED_ACCESS")
            ]
        ),
        // 测试Target（可选）
        .testTarget(
            name: "MyCLibraryTests",
            dependencies: ["MyCLibrary"]),
    ]
)

场景2：第三方库以预编译XCFramework形式引入

若已将WolfSSL、nanopb打包为XCFramework，通过binaryTarget引入：

// 在Package.swift的targets数组中替换为：
.binaryTarget(
    name: "WolfSSL",
    path: "Artifacts/WolfSSL.xcframework"
),
.binaryTarget(
    name: "nanopb",
    path: "Artifacts/nanopb.xcframework"
),

（需将XCFramework文件放在项目根目录的Artifacts文件夹下）

3. 处理nanopb的代码生成（若需） #

如果自有库依赖nanopb的.proto文件生成C代码，可通过Swift Package的Build Tool Plugin自动生成：

1. 在项目根目录创建Plugins文件夹，添加自定义插件代码：

// Plugins/NanopbGeneratorPlugin/NanopbGeneratorPlugin.swift
import PackagePlugin

@main
struct NanopbGeneratorPlugin: BuildToolPlugin {
    func createBuildCommands(context: PluginContext, target: Target) async throws -> [Command] {
        guard let sourceTarget = target as? SourceModuleTarget else { return [] }
        // 筛选所有.proto文件
        let protoFiles = sourceTarget.sourceFiles.filter { $0.path.extension == "proto" }
        guard !protoFiles.isEmpty else { return [] }
        
        // 获取nanopb生成器路径（需将nanopb_generator工具放入项目的Tools目录）
        let generatorPath = context.tool(named: "nanopb_generator").path
        let outputDir = context.pluginWorkDirectory.appending("generated")
        try FileManager.default.createDirectory(atPath: outputDir.string, withIntermediateDirectories: true)
        
        var commands: [Command] = []
        for protoFile in protoFiles {
            let outputC = outputDir.appending("\(protoFile.path.stem).pb.c")
            let outputH = outputDir.appending("\(protoFile.path.stem).pb.h")
            
            commands.append(
                .buildCommand(
                    displayName: "Generating nanopb code for \(protoFile.path.lastComponent)",
                    executable: generatorPath,
                    arguments: [
                        protoFile.path.string,
                        "--output-dir=\(outputDir.string)"
                    ],
                    inputFiles: [protoFile.path, generatorPath],
                    outputFiles: [outputC, outputH]
                )
            )
        }
        return commands
    }
}

2. 在Package.swift中注册插件，并让自有库Target使用该插件：

// 在Package的plugins数组中添加：
plugins: [
    .plugin(name: "NanopbGeneratorPlugin", path: "Plugins/NanopbGeneratorPlugin")
],
// 在MyCLibrary的target配置中添加：
plugins: [.plugin(name: "NanopbGeneratorPlugin")],

4. 分发与集成 #

• Git仓库分发：将整个Swift Package推送到GitHub/GitLab等平台，其他开发者只需在他们的Package.swift中添加：

.package(url: "https://github.com/your-username/MyCLibrarySPM.git", from: "1.0.0")

• XCFramework分发：若需分发预编译产物，可将MyCLibrary打包为XCFramework，再创建仅包含该XCFramework的Swift Package进行分发。

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