如何为Homebrew导入的C库创建Swift包？遇System Module Package配置报错

一、module.modulemap中的制表符与空格是否有区别？ #

在LLVM的模块映射语法里，制表符和空格没有语法层面的区别——只要是用于缩进的空白字符，编译器都会正常识别。不过为了代码可读性和规范统一，建议固定用一种缩进方式（比如4个空格或1个制表符），避免混合使用导致格式混乱，但这不会影响编译结果。

二、解决swift build的错误提示 #

错误信息：error: 'clibetpan': configuration of package 'clibetpan' is invalid; the 'providers' property can only be used with a System Module Package

错误原因 #

providers属性只能用于系统模块包（System Module Package），你当前的Package.swift没有声明为系统模块包，且配置不符合系统模块包的要求，导致编译报错。

解决方案 #

1. 修改Package.swift，声明为系统模块包
   替换原Package.swift为以下内容，明确指定target类型为.systemModule并配置providers：

// swift-tools-version: 6.1
import PackageDescription

let package = Package(
    name: "CLibEtPan",
    products: [
        .library(name: "CLibEtPan", targets: ["CLibEtPan"])
    ],
    targets: [
        .systemModule(
            name: "CLibEtPan",
            path: ".",
            providers: [
                .brew(["libetpan"]),
                .apt(["libetpan"])
            ]
        )
    ]
)

2. 修正module.modulemap的头文件路径
   原文件中的../../Headers/...路径错误，基于当前目录结构，正确相对路径应为./Headers/CLibEtPan-Bridging-Header.h，修改后的module.modulemap：

module CLibEtPan {
    header "./Headers/CLibEtPan-Bridging-Header.h"
    link "etpan"
    export *
}

如果libetpan已通过Homebrew安装到系统默认路径，也可以直接引用系统头文件，省去本地桥接头文件：

module CLibEtPan {
    header "/usr/local/include/libetpan/libetpan.h" // Intel Mac路径
    // Apple Silicon Mac替换为：header "/opt/homebrew/include/libetpan/libetpan.h"
    link "etpan"
    export *
}

3. 可选：适配多架构的头文件搜索路径
   若需要同时兼容Intel和Apple Silicon Mac，可在Package.swift的target中添加头文件搜索路径：

.systemModule(
    name: "CLibEtPan",
    path: ".",
    providers: [
        .brew(["libetpan"]),
        .apt(["libetpan"])
    ],
    cSettings: [
        .headerSearchPath("/usr/local/include"),
        .headerSearchPath("/opt/homebrew/include")
    ]
)

完成以上修改后，重新执行swift build即可正常编译。

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