一、概要

2016年编写的教程已经失效了，2017-10-23在这里做出更新。

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

二、安装

说实话整个安装过程我折腾了好久，在网上查找各种资料，进行各种尝试，最终解决并得出以下总结：

CocoaPods的安装问题：

1.之前都是用淘宝的Ruby镜像来访问CocoaPods，但是貌似淘宝的也不能用了，于是找到了这个http://gems.ruby-china.org/，打开终端输入以下命令：

（1）检查ruby源      gem sources -l

如果没有安装过不会有提示，那么直接进入第3步。如果安装过结果一般是：

*** CURRENT SOURCES ***

https://rubygems.org/

（2）移除原有源      gem sources -r https://rubygems.org/

（3）添加新的源     gem sources -a http://gems.ruby-china.org/

（4）添加完成后的检查     gem sources -l

如果在终端中出现下面文字才表明你上面的命令是成功的：

*** CURRENT SOURCES ***

http://gems.ruby-china.org/

2.升级gem，如果它的版本过低也可能导致安装失败，在终端输入以下命令：

sudo gem update --system

安装过程都是需要等待的，稍安勿躁

3.安装CocoaPods:

OS X 10.11以前，在终端输入以下命令：

sudo gem install cocoapods

OS X 10.11以后，在终端输入以下命令：

sudo gem install -n /usr/local/bin cocoapods --pre

4.setup安装命令：

在终端输入以下命令：

pod setup

问题最多的就是这一步，第一次安装完成可能要一个小时左右，所以要耐心等待，如果这一步完成了，并出现以下结果，那么恭喜你已经成功安装了CocoaPods。

当然你也可以在这之后在终端输入以下命令：

pod --version

2017-10-23此次更新博客时的版本为：1.4.0.beta.1

显示出版本就说明成功了。在这之后大功告成，以后可以享受cocoapods带来的方便了

三、使用

1.新建一个工程，我新建的是一个OC语言的名为CocoaPods的工程，大家也尽量用这个，以后比较容易找到它。

2.cd到这个工程目录下，例如：

cd /Users/liuyingjie/Desktop/CocoaPods

3.建立文件

pod init

4.打开工程中刚刚建立好的Podfile的白色文件（文本格式），粘贴以下内容并保存

platform :ios, '7.0'

target '你的项目名称’ do

pod 'SDWebImage'

pod ‘AFNetworking’

end

5.回到终端执行以下命令：这里我简单安装两个常用库，以后再加。添加过程要等一下会，几分钟的样子吧。

pod install(或者pod update)

6.完成后进入工程目录（以后都要打开下面的这个.xcworkspace工作区），然后command+B编译操作。没有错误就表示成功添加了。

*以后加新的库  就复制到Podfile里面 然后再 pod install就可以了

7.测试一下调用头文件：

OK，没有问题，大功告成！

四、安装过程中可能会遇到的坑！

安装过程的一些问题在下一篇文章里做了一些总结：

《CocoaPods安装过程中遇到的那些坑》：

http://www.jianshu.com/p/898af2de37cc

在这个了我要对帮助我完成安装的网友iOSCaiBird表示感谢，大家也可以关注一下，他的一些文章感觉蛮好的。