CocoaPods详解之----进阶篇

谁践踏了优雅 2022-08-21 04:15 225阅读 0赞

CocoaPods详解之----进阶篇

作者：[wangzz][]

原文地址：[http://blog.csdn.net/wzzvictory/article/details/19178709][http_blog.csdn.net_wzzvictory_article_details_19178709]

转载请注明出处

如果觉得文章对你有所帮助，请通过留言或关注微信公众帐号wangzzstrive来支持我，谢谢！

## 一、Podfile.lock文件 ##

上文讲过，在开始使用CocoaPods，执行完pod install之后，会生成一个Podfile.lock文件。这个文件看起来跟我们关系不大，实际上绝对不应该忽略它。

该文件用于保存已经安装的Pods依赖库的版本，通过CocoaPods安装了SBJson、AFNetworking、Reachability三个POds依赖库以后对应的Podfile.lock文件内容为：

**\[objc\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  PODS:  
2.    - AFNetworking (2.1.0):  
3.      - AFNetworking/NSURLConnection  
4.      - AFNetworking/NSURLSession  
5.      - AFNetworking/Reachability  
6.      - AFNetworking/Security  
7.      - AFNetworking/Serialization  
8.      - AFNetworking/UIKit  
9.    - AFNetworking/NSURLConnection (2.1.0):  
10.     - AFNetworking/Reachability  
11.     - AFNetworking/Security  
12.     - AFNetworking/Serialization  
13.   - AFNetworking/NSURLSession (2.1.0):  
14.     - AFNetworking/NSURLConnection  
15.   - AFNetworking/Reachability (2.1.0)  
16.   - AFNetworking/Security (2.1.0)  
17.   - AFNetworking/Serialization (2.1.0)  
18.   - AFNetworking/UIKit (2.1.0):  
19.     - AFNetworking/NSURLConnection  
20.   - Reachability (3.0.0)  
21.   - SBJson (4.0.0)  
22.   
23. DEPENDENCIES:  
24.   - AFNetworking (~> 2.0)  
25.   - Reachability (~> 3.0.0)  
26.   - SBJson (~> 4.0.0)  
27.   
28. SPEC CHECKSUMS:  
29.   AFNetworking: c7d7901a83f631414c7eda1737261f696101a5cd  
30.   Reachability: 500bd76bf6cd8ff2c6fb715fc5f44ef6e4c024f2  
31.   SBJson: f3c686806e8e36ab89e020189ac582ba26ec4220  
32.   
33. COCOAPODS: 0.29.0

Podfile.lock文件最大得用处在于多人开发。对于没有在Podfile中指定Pods依赖库版本的写法，如下：

**\[objc\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  pod 'SBJson'

该句话用于获取当前SBJson这个Pods依赖库的最新版本。  
当团队中的某个人执行完pod install命令后，生成的Podfile.lock文件就记录下了当时最新Pods依赖库的版本，这时团队中的其它人check下来这份包含Podfile.lock文件的工程以后，再去执行pod install命令时，获取下来的Pods依赖库的版本就和最开始用户获取到的版本一致。如果没有Podfile.lock文件，后续所有用户执行pod install命令都会获取最新版本的SBJson，这就有可能造成同一个团队使用的依赖库版本不一致， 这对团队协作来说绝对是个灾难！

在这种情况下，如果团队想使用当前最新版本的SBJson依赖库，有两种方案：

*  更改Podfile，使其指向最新版本的SBJson依赖库；
 *  执行pod update命令；

鉴于Podfile.lock文件对团队协作如此重要，我们需要将它添加到版本管理中。

## 二、Podfile文件 ##

对于普通用户来说，使用CocoaPods我们打交道最多的就是Podfile文件。CocoaPods是用ruby实现的，因此Podfile文件的语法就是ruby的语法。接着从以下几个方面来介绍Podfile:

### 1、Podfile文件存放位置 ###

这是在上篇文章中，遗留的一个问题。通常情况下我们都推荐Podfile文件都放在工程根目录，如下图所示：![SouthEast][]

事实上Podfile文件可以放在任意一个目录下，需要做的是在Podfile中指定工程的路径，和原来相比，Podfile文件就在最开始的位置增加了一行，具体内容如下：

**\[objc\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  xcodeproj "/Users/wangzz/Desktop/CocoaPodsTest/CocoaPodsTest.xcodeproj"  
2.    
3.  platform :ios    
4.  pod 'Reachability',  '~> 3.0.0'    
5.  pod 'SBJson', '~> 4.0.0'    
6.      
7.  platform :ios, '7.0'    
8.  pod 'AFNetworking', '~> 2.0'

指定路径使用的是xcodeproj关键字。

此后，进入Podfile文件所在路径，执行pod install命令就会和之前一样下载这些Pods依赖库，而且 生成的相关文件都放在了Podfile所在目录下面，如下图： ![SouthEast 1][]

和之前一样，我们仍然需要使用这里生成的workspace文件打开工程。

### 2、Podfile和target ###

Podfile本质上是用来描述Xcode工程中的targets用的。如果我们不显式指定Podfile对应的target，CocoaPods会创建一个名称为default的隐式target，会和我们工程中的第一个target相对应。换句话说， 如果在Podfile中没有指定target，那么只有工程里的第一个target能够使用Podfile中描述的Pods依赖库。

如果想在一个Podfile中同时描述project中的多个target，根据需求的不同，可以有不同的实现方式。为了说明问题，在原来的工程中再创建一个名称为Second的target，现在的project中包含的target有： ![SouthEast 2][]

①多个target中使用相同的Pods依赖库

比如，名称为CocoaPodsTest的target和Second的target都需要使用Reachability、SBJson、AFNetworking三个Pods依赖库，可以使用 link\_with关键字来实现，将Podfile写成如下方式：

**\[objc\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  link\_with 'CocoaPodsTest', 'Second'  
2.  platform :ios    
3.  pod 'Reachability',  '~> 3.0.0'    
4.  pod 'SBJson', '~> 4.0.0'    
5.      
6.  platform :ios, '7.0'    
7.  pod 'AFNetworking', '~> 2.0'

这种写法就实现了CocoaPodsTest和Second两个target共用相同的Pods依赖库。

②不同的target使用完全不同的Pods依赖库

CocoaPodsTest这个target使用的是Reachability、SBJson、AFNetworking三个依赖库，但Second这个target只需要使用OpenUDID这一个依赖库，这时可以使用 target关键字，Podfile的描述方式如下：

**\[objc\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  target :'CocoaPodsTest' **do**  
2.  platform :ios    
3.  pod 'Reachability',  '~> 3.0.0'    
4.  pod 'SBJson', '~> 4.0.0'    
5.      
6.  platform :ios, '7.0'    
7.  pod 'AFNetworking', '~> 2.0'  
8.  end  
9.    
10. target :'Second' **do**  
11. pod 'OpenUDID', '~> 1.0.0'  
12. end

其中，do/end作为开始和结束标识符。

### 3、使用Podfile管理Pods依赖库版本 ###

再引入依赖库时，需要显示或隐式注明引用的依赖库版本，具体写法和表示含义如下：

**\[objc\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  pod 'AFNetworking'      //不显式指定依赖库版本，表示每次都获取最新版本  
2.  pod 'AFNetworking', '2.0'     //只使用2.0版本  
3.  pod 'AFNetworking', '> 2.0'     //使用高于2.0的版本  
4.  pod 'AFNetworking', '>= 2.0'     //使用大于或等于2.0的版本  
5.  pod 'AFNetworking', '< 2.0'     //使用小于2.0的版本  
6.  pod 'AFNetworking', '<= 2.0'     //使用小于或等于2.0的版本  
7.  pod 'AFNetworking', '~> 0.1.2'     //使用大于等于0.1.2但小于0.2的版本  
8.  pod 'AFNetworking', '~>0.1'     //使用大于等于0.1但小于1.0的版本  
9.  pod 'AFNetworking', '~>0'     //高于0的版本，写这个限制和什么都不写是一个效果，都表示使用最新版本

## 三、CocoaPods常用命令 ##

### 1、pod install ###

根据Podfile文件指定的内容，安装依赖库，如果有Podfile.lock文件而且对应的Podfile文件未被修改，则会根据Podfile.lock文件指定的版本安装。

每次更新了Podfile文件时，都需要重新执行该命令，以便重新安装Pods依赖库。

### 2、pod update ###

若果Podfile中指定的依赖库版本不是写死的，当对应的依赖库有了更新，无论有没有Podfile.lock文件都会去获取Podfile文件描述的允许获取到的最新依赖库版本。

### 3、pod search ###

命令格式为：

**\[objc\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  $ pod search OpenUDID

后面的OpenUDID为参数。

从命令的名称不难看出，该命令是用来按名称搜索可用的Pods依赖库，执行结果如下：

**\[objc\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  \-> OpenUDID (1.0.0)  
2.     Open source initiative **for** a universal and persistent UDID solution **for** iOS.  
3.     pod 'OpenUDID', '~> 1.0.0'  
4.     - Homepage: http://OpenUDID.org  
5.     - Source:   https://github.com/ylechelle/OpenUDID.git  
6.     - Versions: 1.0.0 \[master repo\]

这里我们搜到了一条可用数据，里面描述了OpenUDID库的简要信息。其实我们真正需要的是上述结果中的第三行：

**\[objc\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  pod 'OpenUDID', '~> 1.0.0'

不难看出，这是我们需要添加到Podfile文件中的。

有了这条命令，就可以方便、迅速地找到需要的Pods依赖库。

### 4、pod setup ###

命令格式为：

**\[ruby\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  $ pod setup

执行完了以后会打印：

**\[ruby\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  Setting up CocoaPods master repo  
2.  Updating 7cd4668..f3d3ced  
3.    
4.  Fast-forward

接下来还会打印很多更新信息。

这条命令用于跟新本地电脑上的保存的Pods依赖库tree。由于每天有很多人会创建或者更新Pods依赖库，这条命令执行的时候会相当慢，还请耐心等待。我们需要经常执行这条命令，否则有新的Pods依赖库的时候执行pod search命令是搜不出来的。

## pod setup 失败解决 ##

2014年12月11日 [mmcer][] [发表评论][Link 1] [阅读评论][Link 2]

cocoapods 是 iOS 上不错的包依赖管理软件，在前面的文章里衣服自己洗是有做简单的介绍。

苹果发布了Mac OS X 10.10 后，就安装了新系统和 XCode 6，然后顺便执行了 sudo gem update –system

然后噩梦就来了，这次要创建一个新的项目，写好 podfile 后，结果安装失败。然后网上一搜索，发现 OS X 10.10后有点问题，需要先卸载 cocoapods，然后再重新安装。各种细节和其它诸如Command Line Tools之类的就不展开说了。

安装倒是成功了，可是在执行 pod setup时，总是失败。提示 There was an error reading ‘/Users/mmcer/.cocoapods/repos/master/CocoaPods-version.yml ，然后给了一个官方的URL地址。

按照该地址访问 http://blog.cocoapods.org/Repairing-Our-Broken-Specs-Repository/，使用里面的方法删除本地文件夹

sudo rm -rf ~/.cocoapods/repo/master/
    sudo setup

仍然失败，衣服自己洗以为是网络、CDN或者国家防火墙的问题，于是回家后又是各种环境，还是不行。网上是各种搜索，大家的解决方法和上面的几乎是一样的。

后来就闲逛github，在他们的 issue 里发现了居然别人也有相同的问题，并且自己摸索解决了。这里真是要汗颜下自己，没有一早想到这里不说，还懒的自己去摸索。

原因就是曾经的更新导致，具体就是 psych 这个组件，卸载然后安装一个低版本就可以了。github 里是用的2.0.0，但是我用了一个略高的版本发现也是可以的。

sudo gem uninstall psych
    sudo gem install psych -v 2.0.0

帖子里还有个人是把所有的gem安装的软件都卸载了然后重装发现也可以解决问题，衣服自己洗觉得太麻烦就没有采用。

之后再重新执行 pod setup 和 pod install 都正常了。浪费了3天时间，对进度还是有很大影响的，不过这个是题外话了。

[wangzz]: http://blog.csdn.net/wzzvictory_tjsd
[http_blog.csdn.net_wzzvictory_article_details_19178709]: http://blog.csdn.net/wzzvictory/article/details/19178709
[view plain]: http://blog.csdn.net/wzzvictory/article/details/19178709#
[CODE]: https://code.csdn.net/assets/CODE_ico.png
[CODE_CODE]: https://code.csdn.net/snippets/194794
[ico_fork.svg]: https://code.csdn.net/assets/ico_fork.svg
[ico_fork.svg 1]: https://code.csdn.net/snippets/194794/fork
[SouthEast]: /images/20220731/b68ecb19729a4d3492680e78efff7b1a.png
[SouthEast 1]: /images/20220731/6e8276af43524fb9977fba9a3c8b4b31.png
[SouthEast 2]: /images/20220731/5a91a8bf63bf4165a2f2d636eb04e979.png
[mmcer]: http://www.withonly.com/?author=1
[Link 1]: http://www.withonly.com/?p=489#respond
[Link 2]: http://www.withonly.com/?p=489#comments