一.CocoaPods是什么？
CocoaPods是一个用ruby编写，负责管理iOS项目中第三方开源库的工具。CocoaPods节省设置和更新第三方开源库的时间。
二.CocoaPods的下载及安装
1、升级ruby环境
ruby -v 查看当前ruby版本
查看当前ruby版本
Ruby版本过低时，需对Ruby进行升级。升级过程如下：
（1）安装RVM
RVM：Ruby Version Manager,Ruby版本管理器，包括Ruby的版本管理和Gem库管理
$ curl -Lget.rvm.io| bash -s stable
等待一段时间后就可以成功安装好 RVM。
$ source ~/.bashrc
$ source ~/.bash_profile
测试是否安装正常 rvm -v
rvm -v
（2）用RVM升级Ruby
#查看当前ruby版本
$ ruby -v
#列出已知的ruby版本
$ rvm list known
rvm list known
#安装ruby 2.4.1
$ rvm install 2.4.1
安装完成之后ruby -v查看是否安装成功。
ruby -v
2、更新ruby镜像
终端输入如下命令（把Ruby镜像指向ruby-china，避免被墙）
$ gem sources --remove https://rubygems.org/
$ gem sources -a https://gems.ruby-china.org
$ gem sources -l （用来检查使用替换镜像位置成功）
3、下载安装CocoaPods
$ sudo gem install cocoa pods 如果一切正常，你应该能看到一段安装进度
如果出现这个
无权限安装
说明没有权限，需要输入：
$ sudo gem install -n /usr/local/bin cocoapods
安装成功如下：
CocoaPods安装成功
在终端中输入：pod search AFNetworking
执行后可能会一直停在 Setting up CocoaPods master repo，然后(很久)会出现如下错误：
这说明CocoaPods还不能正常使用，需要更新pod，下载它的一些依赖包；在终端中输入：
$ pod setup 安装本地库
过一段时间之后，你会在终端中看到跟上面同样的红色的错误信息。
这说明某些环境原因导致pod更新不了，可能原因有，1）gem版本太低；2）github无法链接；3）.cocoapods目录下的配置信息错误。我们可以一个一个来排除，
1）首先更新gem到最新版本，在终端中输入：
$ sudo gem update --system // 第一步已做过
2）然后检查是否可以ping通github，在终端中输入：
$ ping github.com
或 $ ping -c 10 github.com 制定送出的数据包数目
或 ctrl+c停止发送 ctrl+z暂停
3）然后查看pod repo list：
$ pod repo list
cd ~/.cocoapods，进入cocoapods文件后在终端输入：du -sh *，查看文件大小，结果显示0 repos，说明没有安装成功；
du -sh * 安装失败
du -sh * 安装成功
重新执行pod setup，过一段时间后提示setup completed。在终端中输入 pod list，展示出安装列表；
速度较快的方式：pod install --verbose --no-repo-update
这样总算安装好了。接下来再一次输入：
pod search AFNetworking
输入过后它可能会报：
[!] Unable to find a pod with name, author, summary, or descriptionmatching `AFNetworking`
解决方案是：
输入：rm ~/Library/Caches/CocoaPods/search_index.json
后在一次输入：pod search AFNetworking就可以咯。
4、CocoaPods的使用
首先来到你的项目文件： cd 项目文件的位置
然后，添加一个Podfile文件：vim Podfile
然后按 i 进入插入模式，进行编辑，在文件中输入以下内容：
Podfile 文件
输入完成后按ESC退出编辑模式，最后输入:wq保存并退出文件。此时可以发现在项目目录下多了一个Podfile的文件，请注意这个文件必须与.xcodeproj在同一目录下。
最后：pod install / pod install --verbose --no-repo-update
强调一点：Podfile文件的编辑，务必使用vim，防止编码问题导致无法下载。
pod 第三方进程
其他错误：
（1）出现如下警告
[!] Your Podfile has had smart quotessanitised. To avoid issues in the future, you should not use TextEdit forediting it. If you are not using TextEdit, you should turn off smart quotes inyour editor of choice.
解决办法：不要使用文本编辑去编辑Podfile，使用Xcode编辑，或者使用终端敲命令去编辑。
(2) 执行pod install 或pod update 命令后，updating local specsrepositories 卡住不动
解决办法：pod install 被墙了，换成新的命令pod install --verbose --no-repo-update
(3) 项目运行时报错：Thefile “Pods.xcconfig” couldn’t be opened because there is no such file.
解决办法：pod update就可以了。
三、注意项
使用CocoaPods还需要注意以下几点：
1. 需要使用CocoaPods生成的 .xcworkspace 文件来打开工程，而不是以前的 .xcodeproj 文件。
2. 每次更改了Podfile文件，你需要重新执行一次pod update命令。
3. 当你执行pod install之后，除了Podfile外，CocoaPods还会生成一个名为Podfile.lock的文件，你应该把这个文件加入到版本管理中。因为Podfile.lock会锁定当前各依赖库的版本，之后如果多次执行pod install 不会更改版本，要pod update才会改Podfile.lock了。这样的好处是：当多人协作的时候，可以保证所有人的第三库环境是完全一样的。
网友评论