CocoaPods使用详细说明

1、概要

iOS开发时，项目中会引用许多第三方库，CocoaPods（https://github.com/CocoaPods/CocoaPods  ）能够用来统一管理这些第三方库。

若是此文章已过期，能够查看 融云 集成文档，有关于cocoaPods的集成说明。点击打开连接

2、安装
一、Ruby环境搭建

当前安装环境为MacBook Air 10.11.4。Mac OS自己自带Ruby，但仍是更新一下保险。
a 查看下当前ruby版本：
打开终端输入 ruby -v（确实安装了，更新下ruby）

1. cailianfengdeMacBook-Air:~ manager$ ruby -v
2. ruby 2.0.0p648 (2015-12-16 revision 53162) [universal.x86_64-darwin15]
3. cailianfengdeMacBook-Air:~ manager$

b 更新ruby

终端输入：gem update --system  此时可能会出现

1. ERROR: While executing gem ... (Gem::FilePermissionError) You don‘t have write permissions for the /Library/Ruby/Gems/2.0.0 directory.
2. zijingMacBook-Pro:~ shiyunlei$ sudo gem update —system

这个是由于你没有权限去更新Ruby，这个时候你能够在终端使用：sudo gem update --system来进行升级

本次获得结果是：

1. cailianfengdeMacBook-Air:~ manager$ gem update --system
2. Latest version currently installed. Aborting.
3. cailianfengdeMacBook-Air:~ manager$

意思是已是最高版本 若是有报错，能够尝试先更换镜像再执行Ruby更新操做。

二、下载安装CocoaPods准备（更换镜像）

安装CocoaPods时咱们要访问cocoapods.org，该网站可能被墙了，这样下载安装可能会很慢，咱们能够用淘宝的Ruby镜像来访问该网站，方法以下：

终端输入以下命令（把Ruby镜像指向taobao，避免被墙）

gem sources --remove https://rubygems.org/ 
gem sources -a https://ruby.taobao.org/ 
gem sources -l  （用来检查使用替换镜像位置成功）

获得结果：

1. cailianfengdeMacBook-Air:~ manager$ gem sources --remove https: //rubygems.org/
2. https: //rubygems.org/ removed from sources
3. cailianfengdeMacBook-Air:~ manager$ gem sources -a https: //ruby.taobao.org/
4. https: //ruby.taobao.org/ added to sources
5. cailianfengdeMacBook-Air:~ manager$ gem sources -l
6. *** CURRENT SOURCES ***
7.  
8. https: //ruby.taobao.org/
9. cailianfengdeMacBook-Air:~ manager$

三、下载安装CocoaPods
终端输入：sudo gem install cocoapods  备注:(苹果系统升级 OS X EL Capitan 后改成 $sudo gem install -n /usr/local/bin cocoapods 这次仍是用的前面的，也没有出现问题)

1. cailianfengdeMacBook-Air:~ manager$ sudo gem install cocoapods
2. Password:

输入电脑管理员密码，回车以后就会安装各类successful，最后会获得：

1. Installing ri documentation for cocoapods-0.39.0
2. 21 gems installed

这样就下载安装好了CocoaPods

执行:pod setup

会出现Setting up CocoaPods master repo，说明Cocoapods在将它的信息下载到 ~/.cocoapods里；cd到该目录里，用du -sh *命令来查看文件大小，每隔几分钟查看一次，这个目录最终大小是100多M，就是完成了 。(可能会通过漫长的等待)

四、使用search命令搜索类库名： 
pod search AFNetworking（也能够pod search UI等，能够查询你想要的）

若是CocoaPods支持，将会输出搜索到的全部类库版本和信息，以及在Podfile中配置的写法，终端返回信息以下：

1.  
2. -> AFNetworking ( 2.3.1)
3.  
4. A delightful iOS and OS X networking framework.
5.  
6. （这个语句是须要在编辑Podfile的时候输入的命令，便是如何安装下载相关类库的指令）
7. pod ‘AFNetworking‘, ‘~> 2.3.1’
8.  
9. - Homepage: https: //github.com/AFNetworking/AFNetworking
10.  
11. - Source: https: //github.com/AFNetworking/AFNetworking.git
12.  
13. - Versions: 2.3.1, 2.3.0, 2.2.4, 2.2.3, 2.2.2, 2.2.1, 2.2.0, 2.1.0,
14.  
15. 2.0.3, 2.0.2, 2.0.1, 2.0.0, 2.0.0-RC3, 2.0.0-RC2, 2.0.0-RC1, 1.3.4, 1.3.3,
16.  
17. 1.3.2, 1.3.1, 1.3.0, 1.2.1, 1.2.0, 1.1.0, 1.0.1, 1.0, 1.0RC3, 1.0RC2, 1.0RC1,
18.  
19. 0.10.1, 0.10.0, 0.9.2, 0.9.1, 0.9.0, 0.7.0, 0.5.1 [master repo]
20.  
21. - Sub specs:
22. - AFNetworking/Serialization ( 2.3.1)
23. -AFNetworking/Security ( 2.3.1)
24. - AFNetworking/Reachability ( 2.3.1)
25. -AFNetworking/ NSURLConnection (2.3.1)
26. - AFNetworking/ NSURLSession (2.3.1)
27. - AFNetworking/ UIKit (2.3.1)
28.  
29. -> AFNetworking+AutoRetry ( 0.0.5)
30.  
31. Auto Retries for AFNetworking requests
32.  
33. pod ‘AFNetworking+AutoRetry‘, ‘~> 0.0.5‘
34.  
35. - Homepage: https: //github.com/shaioz/AFNetworking-AutoRetry
36.  
37. - Source: https: //github.com/shaioz/AFNetworking-AutoRetry.git
38.  
39. - Versions: 0.0.5, 0.0.4, 0.0.3, 0.0.2, 0.0.1 [master repo]

这说明，AFNetworking是支持CocoaPods，因此咱们能够利用CocoaPods将AFNetworking导入你的项目中。

五、须要在工程中建立一个Podfile文件

使用命令：
cd /Users/cailianfeng/Desktop/TestCocoapodsDemo (进入工程目录，cd后面的是工程的路径)
touch Podfile（建立Podfile文件）

而后使用vim编辑Podfile文件，使用命令：vim Podfile 进入Podfile界面，而后键盘输入 i，进入编辑模式，输入：

1. platform :ios, '8.0'
2. target "cocospod" do
3. pod 'AFNetworking', '~> 2.3.1'
4. end

注意：cocospod 为项目名。

而后按Esc，而且输入“ ：”号进入vim命令模式，而后在冒号后边输入wq，点击回车，保存并退出。

这是会看到项目中多了一个podfile文件，打开能够看见

六、执行pod install 命令
在终端当前目录下输入pod install命令 漫长等待以后，获得结果：

1. Analyzing dependencies
2. Downloading dependencies
3. Installing AFNetworking ( 2.3.1)
4. Generating Pods project
5. Integrating client project
6.  
7. [!] From now on use `TestCocoapodsDemo.xcworkspace`.

而后进入项目，直接用TestCocoapodsDemo.xcworkspace打开项目。这正是你刚刚运行pod install命令产生的新文件。除了这个文件，你会发现还多了另一个文件“Podfile.lock”和一个文件夹“Pods”。而且你会发现，此时AFNetworking已经在项目的Pods文件夹中了。以后就随意使用了。

7.说明

当须要同时导入多个第三方时候 就须要修改Podfile了，就是用vim编辑的那个保存在项目根目录中的文件，修改完了Podfile文件，须要从新执行一次pod install命令。
例如：
platform :ios
pod 'JSONKit', '~> 1.4'
pod 'AFNetworking', '~> 2.0'

...

 

3、第二场景 如何正确编译运行一个包含CocoPods类库的项目

有时候好不容易在GitHub上找到一份代码符合本身想需求，下载下来，一编译，发现有各类各样错误。原来是缺失了各类其余第三方类库。这时若是会发现你下载的代码包含了Podfile。意味着你能够用CocoaPods很方便下载所须要的类库。

下载的项目中一般有三个跟CocosPods相关的文件（文件夹）：Podfile，Podfile.lock和Pods。

打开终端，cd路径进入下载的项目所在的目录，也就是和Podfile在同一目录下(因为已经有Podfile，因此不须要再建立Podfile),输入如下命令:
pod update
过几秒（也许须要十几秒，取决于你的网络情况）以后，终端出现：

1. Analyzing dependencies
2. Fetching podspec for `XXXXXXXX` from `../`
3. Downloading dependencies
4. Installing XXXXXXXXXXXXX ( 0.1.6)
5. Generating Pods project
6. Integrating client project
7.  
8. [!] From now on use `XXXXXXXXXX.xcworkspace`.

这时候，打开项目文件夹看一看，会看到多了一个文件XXXXXXXXXX.xcworkspace；根据终端的信息提示，你之后就需用新产生的XXXXXXXXXX.xcworkspace来运行这个代码了。

注意，这里有个小问题，若是刚刚不是输入pod update，而是输入pod install，会发现类库导入不成功，而且终端出现下面提示：

1. [!] Required version (XXXXXXXXXX (from `../`)) not found for `XXXXXXXXXXXX`.
2. Available versions: 0.1.6

这里的意思大概是Podfile文件过时，类库有升级，可是Podfile没有更改 pod install只会按照Podfile的要求来请求类库，若是类库版本号有变化，那么将获取失败，可是pod update会更新全部的类库，获取最新版本的类库。并且你会发现，若是用了pod update，再用pod install 就成功了；其实每次直接用 pod update 也能够。或者先用 pod install，若是不行，再用pod update。