如何在Linux命令行构建并测试Swift/C库及Swift包装的C库？

没问题！Swift Package Manager（SPM）完全支持嵌入你自己的C库，在Linux下构建和测试这类项目非常顺畅。我给你一步步拆解整个流程：

首先把你的C库源码、Swift封装代码和测试代码按SPM的规范目录放好，示例结构如下：

MyCLibWrapper/
├── Sources/
│   ├── MyCLib/          # 你的C库源码目录
│   │   ├── clib.c
│   │   └── clib.h
│   └── MySwiftWrapper/  # Swift封装代码目录
│       └── MySwiftWrapper.swift
├── Tests/
│   └── MySwiftWrapperTests/
│       └── MySwiftWrapperTests.swift
└── Package.swift        # SPM核心配置文件

这是关键一步，要告诉SPM如何处理你的C库和Swift代码。下面是一个完整的配置示例，我会标注每个部分的作用：

// swift-tools-version: 5.9
import PackageDescription

let package = Package(
    name: "MySwiftWrapper",
    products: [
        // 定义最终要输出的Swift库
        .library(
            name: "MySwiftWrapper",
            targets: ["MySwiftWrapper"]),
    ],
    targets: [
        // 1. 定义C库的target
        .target(
            name: "MyCLib",
            path: "Sources/MyCLib", // 指定C库源码路径
            sources: ["clib.c"],    // 要编译的C源文件
            publicHeadersPath: "."  // 公开头文件的路径（这里是当前目录，让SPM能找到clib.h）
        ),
        // 2. Swift封装的target，依赖上面的C库
        .target(
            name: "MySwiftWrapper",
            dependencies: ["MyCLib"]
        ),
        // 3. 测试target，依赖Swift封装库
        .testTarget(
            name: "MySwiftWrapperTests",
            dependencies: ["MySwiftWrapper"]
        ),
    ]
)

如果你的C库需要额外编译参数（比如宏定义、头文件搜索路径），可以在cSettings里添加，比如：

.target(
    name: "MyCLib",
    path: "Sources/MyCLib",
    sources: ["clib.c"],
    publicHeadersPath: ".",
    cSettings: [
        .define("ENABLE_LOG", .when(configuration: .debug)),
        .headerSearchPath("../external/include") // 如果头文件在外部目录
    ]
)

配置好之后，你就可以在Swift里直接import MyCLib调用C函数了，注意Swift和C的类型转换（比如Int转CInt）。举个简单例子：
假设你的C库头文件clib.h是这样的：

#ifndef clib_h
#define clib_h

int add(int a, int b);
void print_message(const char* msg);

#endif /* clib_h */

对应的clib.c实现：

#include "clib.h"
#include <stdio.h>

int add(int a, int b) {
    return a + b;
}

void print_message(const char* msg) {
    printf("C Library Message: %s\n", msg);
}

那Swift封装代码MySwiftWrapper.swift可以这么写：

import MyCLib

public struct MyCLibWrapper {
    // 封装C的add函数
    public static func add(_ a: Int, _ b: Int) -> Int {
        return Int(add(CInt(a), CInt(b)))
    }

    // 封装C的print_message函数
    public static func printMessage(_ message: String) {
        message.withCString { cStr in
            print_message(cStr)
        }
    }
}

测试部分和普通Swift项目一样，用XCTest框架。示例MySwiftWrapperTests.swift：

import XCTest
@testable import MySwiftWrapper

final class MySwiftWrapperTests: XCTestCase {
    func testAddFunction() {
        XCTAssertEqual(MyCLibWrapper.add(2, 3), 5)
        XCTAssertEqual(MyCLibWrapper.add(-10, 5), -5)
    }

    func testPrintMessage() {
        // 这里可以验证输出，或者只确保函数不崩溃
        MyCLibWrapper.printMessage("Hello from Swift Test!")
        XCTAssertTrue(true)
    }
}

首先确保你的Linux机器上已经安装了Swift环境（可以从Swift官方下载对应版本的安装包，Ubuntu也可以通过apt源安装）。然后执行以下命令：

• 进入项目根目录
• 构建项目：swift build
• 运行测试：swift test
• 构建Release版本：swift build -c release

构建后的库文件会放在.build/debug或.build/release目录下，测试运行后会输出测试结果，显示哪些测试用例通过或失败。

• 如果你的C库依赖系统级别的库（比如libcurl、libssl），可以在C target的linkerSettings里添加.linkedLibrary("curl")来链接它们。
• Linux下的XCTest和macOS基本兼容，大部分测试语法都能直接用，少数平台相关的API需要做适配。
• 如果你的C库是预编译好的静态库/动态库，也可以通过SPM的systemLibrary target来引入，不过自己拥有源码的话，直接嵌入源码编译更方便。

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