CocoaPods项目混编Swift/OC/C文件桥接头文件报错问题咨询

首先明确核心规则：

• CocoaPods通过pod lib create生成的Swift模板默认是framework类型编译目标，Xcode明确禁止在framework目标中使用App target常用的SWIFT_OBJC_BRIDGING_HEADER桥接头配置，这就是你之前手动加桥接头报错的直接原因。
• 这类framework目标完全支持Swift、Objective-C、C三端混编，只是配置逻辑和普通iOS App项目不同，按代码是否需要对外暴露分两种场景配置即可：

场景1：C/OC代码需要作为Pod公开API对外提供 #

如果你的C函数、OC类需要暴露给集成这个Pod的上层项目调用，按以下步骤配置：

• 确认所有新增的C源文件（.c/.h）、OC源文件（.m/.h）的Target Membership已经勾选了你自己的Pod库编译目标（Development Pods分组下的库target，不是Example App的target）
• 打开Pod的podspec配置文件，把需要对外暴露的C/OC头文件路径加到s.public_header_files字段中
• 找到Pod Classes目录下和库同名的默认伞头文件（比如库名为MyKit，对应文件就是MyKit.h），将需要公开的C/OC头文件通过#import语句导入到这个伞头中
• 回到Example目录执行pod install重新拉取配置，之后库内部的Swift代码可以直接调用C函数、OC类，上层集成的项目也可以正常访问这些公开符号。

场景2：C/OC代码仅作为Pod内部逻辑使用，不对外暴露 #

如果C/OC代码只是库内部业务逻辑，不需要给外部使用者访问，不要把相关头文件放到公开头列表，按以下步骤配置：

• 同样先确认所有C/OC源文件已经勾选Pod库的Target Membership，将内部使用的C/OC头文件路径加到podspec的s.private_header_files字段
• 新建一个私有聚合头文件（比如命名InternalImports.h），把所有内部要调用的C函数声明、OC头文件都导入到这个文件里
• 在Pod的Classes目录下新建自定义module.modulemap文件，内容参考如下（把MyKit替换成你自己的库名）：

framework module MyKit {
  umbrella header "MyKit.h"
  export *
  module * { export * }
}

module MyKit.Private {
    header "InternalImports.h"
    export *
}

• 修改podspec配置，指定自定义modulemap路径，添加Swift头文件搜索路径：

s.module_map = 'Pod/Classes/module.modulemap'
s.pod_target_xcconfig = {
  'SWIFT_INCLUDE_PATHS' => '$(PODS_TARGET_SRCROOT)/Pod/Classes/**'
}

• 执行pod install重载配置后，在需要调用C/OC逻辑的Swift文件顶部添加import MyKit.Private，就可以正常调用内部的C函数、OC方法了。

常见注意点 #

• 纯C代码不需要额外包装成OC类，只要头文件中的函数声明被正确导入，Swift会自动完成C语法到Swift语法的映射，比如C声明int c_add(int a, int b)可以直接在Swift中以c_add(1, 2)的形式调用
• 不要尝试给framework target强行配置桥接头build setting，就算临时压过编译报错，也会在后续打包、提交仓库时出现符号丢失、模块加载失败的问题

附参考工作区目录结构：

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