使用CocoaPods集成Framework时遇_OBJC_CLASS_$_PodsDummy_Pods_packager重复符号问题

这个问题我之前帮不少开发者踩过坑，核心原因是cocoapods-packager给每个生成的Framework都嵌入了相同的Pods dummy符号（也就是PodsDummy_Pods_packager），当你通过CocoaPods同时引入这两个Framework时，链接阶段就会触发重复符号冲突。下面是几个亲测有效的解决方法，按优先级排序：

方法1：修改cocoapods-packager模板，生成唯一的Dummy类 #

cocoapods-packager的默认模板会给所有生成的Framework创建同名的Dummy类，我们可以修改模板让它根据Framework名称生成唯一的类名：

• 先找到cocoapods-packager的gem安装路径，在终端执行：

  gem which cocoapods-packager
  

• 进入该路径下的lib/cocoapods-packager/templates目录，找到dummy.m.erb文件
• 打开文件，把原来的PodsDummy_Pods_packager替换成PodsDummy_<%= @name %>（@name会自动替换成你的Framework名称），修改后的文件内容大概是这样：

  #import <Foundation/Foundation.h>
  
  @interface PodsDummy_<%= @name %> : NSObject
  @end
  
  @implementation PodsDummy_<%= @name %>
  @end
  

• 保存后，重新用cocoapods-packager生成两个Framework，再通过CocoaPods集成，重复符号的问题就会消失。

方法2：在Podspec中排除重复的Dummy文件 #

如果你不想修改gem源码，也可以在每个Framework对应的Podspec中添加排除规则：

• 打开你的Framework的Podspec文件，在spec.vendored_frameworks = 'YourFramework.framework'之后，添加以下代码（注意替换成你的Framework名称）：

  # 排除重复的Dummy头文件和二进制文件
  spec.exclude_files = [
    'YourFramework.framework/Versions/A/Headers/PodsDummy_Pods_packager.h',
    'YourFramework.framework/Versions/A/PodsDummy_Pods_packager.o'
  ]
  

注意：如果Dummy类已经编译进Framework的二进制包里，exclude_files可能无法生效，这时候建议优先用方法1。

方法3：重构依赖结构或切换为静态库 #

如果上面两种方法都不适用，可以考虑从依赖结构上解决问题：

• 抽离公共依赖：把两个Framework共享的第三方库单独做成一个独立的Pod，让这两个Framework的Podspec都依赖这个公共Pod，而不是把公共依赖打包进各自的Framework中。这样既避免了重复依赖，也从根源上消除了Dummy符号冲突的可能。
• 切换为静态库：用cocoapods-packager生成静态库（.a文件）而非动态Framework，静态库在CocoaPods集成时，链接器会自动处理重复符号的去重工作，不会触发冲突。

额外注意事项 #

• 确保你的Podfile中没有重复引入同一个Framework
• 生成Framework时，检查是否在podspec中正确设置了static_framework（如果需要静态Framework的话）

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