iOS项目中使用CocoaPods问题解决方案

文／yehot（简书作者）
原文链接：http://www.jianshu.com/p/a2007d8e2607
著作权归作者所有，转载请联系作者获得授权，并标注“简书作者”。

为什么iOS项目中应该使用CocoaPods作为第三方依赖管理工具？
因为：

 

（全文完）

 

开个玩笑。
真正的原因是这样：

目录：

• 从一个bug说起
• 分析需求及解决方案
• 确定方案
• CocoaPods学习资料

 

1、公司的项目里统一使用SVG格式的图片；
2、GitHub上只有一个star数超过一千的SVG解析库，叫SVGKit。（对，就是这个坑爹的库）
    坑1： 这个库一直使用非ARC，有100多个类；
    坑2： 这个库还依赖另外一个库CocoaLumberjack；
    坑3： 把这个库配置到项目中就会报一种错误：

 

 

3、公司的项目是直接以源码的形式使用的该库。
  结果就是 Build Phase 中成了这样：
  （我不知道当初加这些 -fno-objc-arc 标记的人是否崩溃，我光看着就觉得淡淡的忧桑：这么多得加多久？加漏了或者多加了，都是坑。）

 

 

4、因为用的源码，项目里的SVGKit版本很久都不会更新。导致在iPhone6S以上设备时，由于旧版本的库没有适配6S，必崩。现在必须要更新到这个库的最新版本。

二、解决方案的探索：

 

方案一：

用最新源码替换掉旧版源码文件
  问题：1、类文件太多，麻烦，容易出错；
     2、还是会有大量的 -fno-objc-arc 标记，很烦；
  结论：否决

 

方案二：

SVGKit作者推荐——静态库（该库的GitHub页面也只介绍了这一种用法）
  问题：1、只有.h 头文件，出错没法定位和修改。
     2、静态库里使用了category必须要加 -ObjC 标记。
     3、静态库.a文件需要区分device版本和simulator版本，或者合并后使用。
  结论：否决

 

关于问题2这里要解释下，本来是没什么问题的，但我不幸遇到了这个坑：
  1、静态库里如果使用了 category，需要加 -ObjC 标记。否则在使用的时会崩溃：

 

 

  2、当时花了好久没解决这个问题的原因是，我记得自己设置了呀。
     后来才想起来为毛还是崩，这是我们的项目target，你们感受下：

 

 

    有任何一个target忘了设置，就又埋了个坑。
  3、关于 为什么要加 -ObjC 标记 的问题，以前是有查过资料的，这里完全是因为target太多遗漏导致的。

笔记如下：  

-ObjC 标记的作用:

• 用到一个第三方库，这个库的使用向导里面特别说明，在添加完该库后，需要在Xcode的Build Settings下Other Linker Flags里面加入-ObjC标志。之所以使用该标志，和Objective-C的一个重要特性：类别（category)有关。根据这里的解释，Unix的标准静态库实现和Objective-C的动态特性之间有一些冲突：Objective-C没有为每个函数（或者方法）定义链接符号，它只为每个类创建链接符号。
• 这样当在一个静态库中使用类别来扩展已有类的时候，链接器不知道如何把类原有的方法和类别中的方法整合起来，就会导致你调用类别中的方法时，出现"selector not recognized"，也就是找不到方法定义的错误。
• 为了解决这个问题，引入了-ObjC标志，它的作用就是将静态库中所有的和对象相关的文件都加载进来。
• 本来这样就可以解决问题了，不过在64位的Mac系统或者iOS系统下，链接器有一个bug，会导致只包含有类别的静态库无法使用-ObjC标志来加载文件。变通方法是使用-all_load 或者-force_load标志，它们的作用都是加载静态库中所有文件，不过all_load作用于所有的库，而-force_load后面必须要指定具体的文件。

 

方案三：

使用 CocoaPods
问题：作者没有说明这个库是否支持CocoaPods
   这也是我最开始没有考虑改用 CocoaPods 的原因）

• 这里提示大家，可以使用以下命令，测试某个库是否支持CocoaPods
  $ pod try XXX

  鉴于这里不是介绍如何使用 CocoaPods，这里只讨论下使用 CocoaPods 的好处，以及一些使用经验（我会在后文列一些 CocoaPods 的资料）。

优点：
1、解决了方案一中，需要在项目里 大量标记 -fno-objc-arc 的问题：
—— CocoaPods自动生成的关联库会在关联工程中自动标记好，原始项目中只管用就行
2、解决了方案二中，只有.h 头文件，没有源码、出错没法定位和修改的问题：
—— CocoaPods也是使用静态库依赖，但是保留全部.m文件
3、解决了方案二中，静态库使用时的一些坑，和需要打包.a文件的麻烦操作。
—— CocoaPods自动完成
4、极大的简化了操作：
  1> cd进入.xcodeproj文件所在的目录
  $ pod init
  2> 在自动生成的Podfile文件中，加入要pod的库名
  $ pod install
  3> 搞定。
5、最重要的一点：以后再遇到这次的升级第三方库版本的需求时，只需一行命令即可：
  $ pod update
结论：就是这个了！

方案四 ：

在cocoapods 执行

 sudo gem install cocoapods

的时候出现  While executing gem ... (Gem::FilePermissionError)

    You don't have write permissions for the /usr/bin directory.

 

改为 sudo gem install -n /usr/local/bin cocoapods  即可

 

 

 

 

 

 

干货部分

CocoaPods学习资料

CocoaPods入门：

1、CocoaPods安装和使用教程
（入门看这一篇就够了）
2、CocoaPods pod install/pod update更新慢的问题
  最近使用CocoaPods来添加第三方类库，无论是执行pod install还是pod update都卡在了Analyzing dependencies不动
  原因在于当执行以上两个命令的时候会升级CocoaPods的spec仓库，加一个参数可以省略这一步，然后速度就会提升不少。命令如下：

pod install --verbose --no-repo-update
pod update --verbose --no-repo-update

3、mac升级到10.11，cocoapods没了
  使用命令行sudo gem install cocoa pods出错，换成sudo gem install -n /usr/local/bin cocoa pods即可，详见： http://t.cn/Ry8tZAs
4、使用经验：
  1> pods install 时，可以不加版本号（默认下载对应库的最新版本）

 

 

  但是，下载完依赖后，最好加上版本号，避免在添加了新的库，或者pod update时，由于某些第三方库频繁升级而带来的不稳定。

 

 

  2> 多人合作的较大项目，Podfile文件可以设置权限，只由一个人来修改、添加依赖的库。
  3 > SVN或者Git做版本管理时，不要上传 Pods 、workspace 目录：
（可以设置ignore）

 

 //

最新的cocoapod导入xmpp的时候，会出现循环依赖，所以撸主选择了手动导入。

一开始还用的挺开心的，后来，使用cocoapods导入其他的框架，发现调用的时候总是报错。

Undefined symbols for architecture x86_64:

  "_OBJC_CLASS_$_SVProgressHUD", referenced from:

      objc-class-ref in HJCXMPPTools.o

ld: symbol(s) not found for architecture x86_64

clang: error: linker command failed with exit code 1 (use -v to see invocation)

 

在网上搜索了一堆的攻略，cocoapods卸载重新按照了108遍，然而这并没有什么卵用。

后来我再次用cocoapod更新框架的时候，发现终端的一段警告

[!] The `myQQ [Debug]` target overrides the `OTHER_LDFLAGS` build setting defined in `Pods/Target Support Files/Pods/Pods.debug.xcconfig'. This can lead to problems with the CocoaPods installation

    - Use the `$(inherited)` flag, or

    - Remove the build settings from the target.

 

这下有了思路了，原来我手动导入xmpp的时候，修改了Other Linker Flags

 

所以解决办法就是：

按照提示，增加$(inherited)

 

添加之后，问题终于解决

 

CocoaPods高阶用法：

1、即使你不使用第三方库，CocoaPods仍然是一个管理代码相关性的绝佳工具
2、借助GitHub托管Category,利用CocoaPods集成到项目中
3、Cocoapods创建私有podspec
4、写一个Pod发布到CocoaPods
5、CocoaPods的一些略为高级一丁点的使用

 

//TODO:1、利用多个 project 做本地依赖管理
       2、私有仓库的使用尝试

 

 

推荐拓展阅读

 

著作权归作者所有

 

 

 

 

最新的cocoapod导入xmpp的时候，会出现循环依赖，所以撸主选择了手动导入。

一开始还用的挺开心的，后来，使用cocoapods导入其他的框架，发现调用的时候总是报错。

Undefined symbols for architecture x86_64:

  "_OBJC_CLASS_$_SVProgressHUD", referenced from:

      objc-class-ref in HJCXMPPTools.o

ld: symbol(s) not found for architecture x86_64

clang: error: linker command failed with exit code 1 (use -v to see invocation)

 

在网上搜索了一堆的攻略，cocoapods卸载重新按照了108遍，然而这并没有什么卵用。

后来我再次用cocoapod更新框架的时候，发现终端的一段警告

[!] The `myQQ [Debug]` target overrides the `OTHER_LDFLAGS` build setting defined in `Pods/Target Support Files/Pods/Pods.debug.xcconfig'. This can lead to problems with the CocoaPods installation

    - Use the `$(inherited)` flag, or

    - Remove the build settings from the target.

 

这下有了思路了，原来我手动导入xmpp的时候，修改了Other Linker Flags

 

所以解决办法就是：

按照提示，增加$(inherited)

 

添加之后，问题终于解决