如何为纯Swift框架自定义modulemap文件？

在Objective-C框架里，我们可以通过自定义module.modulemap文件自动导入、导出并链接依赖框架，示例如下：

framework module SomeName {
    requires objc, blocks, objc_arc

    umbrella header "SomeName.h"

    use Security
    export Security
    link framework "Security"

    use Foundation
    export Foundation
    link framework "Foundation"
}

其他项目导入这个框架时，Security和Foundation会自动导入，符号可直接访问；开启Link Frameworks Automatically（CLANG_MODULES_AUTOLINK）后，还能自动完成依赖框架的链接。

但纯Swift框架的情况不同：Xcode会自动生成如下格式的modulemap，若我们自定义modulemap并在Build Settings中配置，Xcode会自动追加生成内容，导致自定义的依赖声明被覆盖，无法生效。

module SomeName.Swift {
  header "SomeName-Swift.h"
  requires objc
}

解决方法 #

我们可以通过自定义包含自动生成子模块的完整modulemap来实现需求，步骤如下：

1. 创建自定义module.modulemap文件
   在Swift框架的目录中新建module.modulemap，内容如下：

framework module SomeName {
    requires objc, objc_arc

    // 保留Xcode自动生成的Swift子模块结构
    module Swift {
        header "SomeName-Swift.h"
        requires objc
    }

    // 添加需要自动导入、导出和链接的依赖框架
    use Security
    export Security
    link framework "Security"

    use Foundation
    export Foundation
    link framework "Foundation"
}

这个文件既包含了Xcode原本自动生成的SomeName.Swift子模块，又添加了我们需要的依赖声明。

2. 配置Xcode Build Settings
   在框架的Build Settings中，找到Module Map File选项，设置为自定义module.modulemap的路径（例如$(SRCROOT)/YourFrameworkName/module.modulemap，根据实际目录调整）。

3. 确保自动链接开启
   确认Link Frameworks Automatically（CLANG_MODULES_AUTOLINK）选项处于开启状态，这样依赖框架会自动完成链接。

注意事项 #

• 自定义modulemap的路径必须正确，确保Xcode能准确定位到文件。
• 如果后续框架新增依赖，需要手动在module.modulemap中添加对应的use、export和link framework语句。
• SomeName-Swift.h是Xcode自动生成的桥接头文件，确保相对路径正确（通常框架的modulemap和Headers目录同级，直接写文件名即可）。

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