Swift+Pods开发Common SDK：Pods与bridging header配置问题求助

一、Pods配置修正 #

• 确保SDK的Podfile针对目标target正确声明依赖，示例配置：

target 'CommonSDK' do
  use_frameworks!
  # 添加你需要的Pods依赖，比如：
  pod 'AFNetworking'
  pod 'SDWebImage'
end

• 执行pod install后，进入SDK的Xcode项目，检查Build Phases -> Link Binary With Libraries，确认Pods对应的.framework文件已被添加。
• 打开SDK target的Build Settings，找到Framework Search Paths和Header Search Paths，确认已包含$(inherited)，确保继承Pods自动生成的路径配置，避免手动路径遗漏。

二、Bridging Header正确配置 #

• 在SDK根目录创建CommonSDK-Bridging-Header.h文件，仅放入需要暴露给Swift代码的自定义Objective-C头文件，不要直接引入Pods的头文件（Pods框架通过Swift的import语句引入即可）。
• 进入SDK target的Build Settings，搜索Objective-C Bridging Header，设置路径为$(SRCROOT)/CommonSDK-Bridging-Header.h（如果文件在子目录，调整路径为相对SDK根目录的位置，比如$(SRCROOT)/Classes/CommonSDK-Bridging-Header.h）。
• 检查Swift Compiler - General下的Objective-C Bridging Header配置，确认路径无拼写错误，且文件实际存在。

三、多项目适配注意事项 #

• 将Common SDK以私有Pod或Git子模块的方式引入三个项目，确保每个项目的Podfile正确依赖SDK，比如：

pod 'CommonSDK', :path => '../CommonSDK' # 本地路径依赖，或私有仓库地址

• 确保三个项目的Build Settings中，ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES设置为YES，避免运行时缺失Swift标准库。
• 统一SDK与三个项目的Deployment Target版本，避免因系统版本不兼容导致的编译或运行错误。

四、排错步骤 #

• 清理编译缓存：执行Command+Shift+K清理Build Folder，之后重新编译SDK和项目。
• 定位错误细节：如果是Pods相关错误，检查Pods是否安装完整、框架是否正确链接；如果是Bridging Header错误，查看编译日志中的具体路径或语法提示，排查文件路径或头文件内容问题。
• 单独验证SDK：先单独编译Common SDK，确保自身无编译错误后，再集成到项目中测试。

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