ld: 4773 duplicate symbols for architecture x86_64

起源

最近在项目中集成百度地图的相关功能，不过遇到了一个问题。百度地图中集成了ssl库libssl.a，而我们工程中的另外一个第三方库也集成了这个库。编译的时候就会造成冲突，显示ld: 4773 duplicate symbols for architecture x86_64。

解决方式

解决问题的方式大概就分为两种：

1.修改其中的一个第三方库文件。

2.修改OTHER_LDFLAGS的编译选项，让编译器只编译其中的一个ssl库。

第一种方式，网上有不少文章说，具体可以参考：

https://www.jianshu.com/p/c7274dca62f7

第二种方式，主要和OTHER_LDFLAGS选项有关。

OTHER_LDFLAGS详解

OTHER_LDFLAGS常用的有三种：

-ObjC

链接器会把静态库中所有的Objective-C类和类别都加载到最后的可执行文件中。

-all_load

强制链接器把所有找到的目标文件都加载到可执行文件中。

-force_load

所做的事情跟-all_load其实是一样的，但是-force_load需要指定要进行全部加载的库文件的路径。

但是千万不要随便使用-all_load和-force_load参数！假如你使用了不止一个静态库文件，然后又使用了这个参数，那么你很有可能会遇到ld: duplicate symbol错误，因为不同的库文件里面可能会有相同的目标文件。但是在cocoapods创建的工程中，它会自动的设置OTHER_LDFLAGS为-ObjC -all_load 。

之所以这样做是因为在xcode4之前，xcode有个bug，你用了-ObjC以后，如果类库中只有category没有这个类的具体实现时候，这些category是加载不进来。变通方法就是加入-all_load或者-force-load。-all_load会强制链接器把目标文件都加载进来，即使没有objc代码。

因此我们可以将工程中的-all_load 直接去掉就行，但是因为我们是使用cocoapods来管理工程的，为了不需要每次pod install之后都需要删除这个参数，我们需要修改podfile文件。

CocoaPods的解决方法

post_install do |installer|
  installer.pods_project.targets.each do |target|
      #获取准备修改的pod工程 `Pod-target-lib` 
      if target.name == "Pod-target-lib"
        puts "Updating #{target.name} OTHER_LDFLAGS"
        #获取工程的xcconfig文件的路径
        xcconfig_path = ""
        target.build_configurations.each do |config|
          new_xcconfig_path = config.base_configuration_reference.real_path
          puts "new_xcconfig_path #{new_xcconfig_path} OTHER_LDFLAGS"
          if new_xcconfig_path != xcconfig_path
            xcconfig_path = config.base_configuration_reference.real_path

            # 从xcconfig中读取build_settings到字典中
            build_settings = Hash[*File.read(xcconfig_path).lines.map{|x| x.split(/\s*=\s*/, 2)}.flatten]

            # 删除 OTHER_LDFLAGS 中的-all_load
            other_flag = build_settings['OTHER_LDFLAGS'];
            build_settings['OTHER_LDFLAGS'] = other_flag.gsub('-all_load',' ')

            # 清除当前文件的内容
            File.open(xcconfig_path, "w") {|file| file.puts ""}

            # 将build_settings字典写回xcconfig
            build_settings.each do |key,value|
              File.open(xcconfig_path, "a") {|file| file.puts "#{key} = #{value}"}
            end
          end
        end
      end
    end
end

这样，每次pod install后，都会自动寻找当前工程的xcconfig配置文件，并将其中的OTHER_LDFLAGS中的-all_load选项替换成空格键。

其他注意事项

不过需要注意的是，你需要保证这两个相互冲突的第三方库所共同引用的库的版本是相同的，否则可能会出现异常。

如果出现所引用的两个第三方库的版本不同，出现符号冲突时，动态链接会使用先加载的符号。也就是说在Link Binary With Libraryies中靠前的的动态库会优先被链接，并占据当前符号的具体实现，后续的重复类或者方法会自动被忽略。

Xcode中的动态链接库

参考文献：

https://www.cnblogs.com/lulushen/p/7646635.html

https://stackoverflow.com/questions/30244675/how-can-i-modify-other-ldflags-via-cocoapods-post-install-hook

https://blog.csdn.net/idoit0204/article/details/51514299

https://www.zhihu.com/question/20728615