作为一个入门不久的初级开发人员，本着一个自我知识整理归档地目的，概括性地介绍下 CocoaPods 的安装与使用。
此文整理于2016年6月。
CocoPods简介
CocoaPods 是针对 Swift 和 Objective-C 项目进行管理添加依赖的一个工具。它拥有一万八千多个类库来优雅地拓展项目，管理着 Swift 和 Objective-C 项目的第三方库引入。
官网地址：CocoaPods官网
安装
由于 CocoaPods 是基于 Ruby 环境下工作的，故需要确保系统中已经设置完毕 Ruby 环境。
一般条件下 Mac 自备 Ruby ，故一般不需要设置，除非曾进行过卸载，请自行 Google 。
1.打开Terminal（终端），移除官方源。
gem sources --remove https://rubygems.org/
2.添加所需源，采取下方任意一个指令。
gem sources --add https://gems.ruby-china.org
gem sources -a https://gems.ruby-china.org
为什么不使用淘宝的gem源，原因是其已经不可接受外界维护了。详见RubyGems镜像
3.确保所需源已添加，执行下面指令。
gem sources -l
显示效果如下，则证明添加成功。
*** CURRENT SOURCES ***
https://gems.ruby-china.org
4.进行 CocoaPods 安装，输入指令后输入计算机密码开始安装。
sudo gem install cocoapods
5.安装完成，键入配置命令，如果安装无误，便可以进入使用阶段。
pod setup
使用
1.CocoaPods 已经安装完毕，当需要进行第三方类库导入时，利用终端指令访问到项目路径下，进行 CocoaPods 初始化操作。
pod init
2.进行初始化命令后, 生成一个Podfile文件，采取文本编辑器(Vim、Sublime Text等等)对其进行信息编辑，打开后显示界面如下：
# Uncomment this line to define a global platform for your project
// 取消注释该句子, 证明你需要为项目使用一个通用平台
# platform :ios, '9.0'
// 如果你需要导入第三方库, 直接在此编辑信息, 如
pod 'AFNetworking', '~> 3.0'
target 'xxx' do
# Uncomment this line if you're using Swift or would like to use dynamic frameworks
// 取消注释该句子, 如果你正在使用Swift或者需要使用动态框架的话
# use_frameworks!
# Pods for xxx
target 'xxxTests' do
inherit! :search_paths
# Pods for testing
end
end
3.信息编辑完毕后, 进行库安装。
- 不更新本地库信息直接安装，优点是安装快，缺点是如果有新库发布，安装将失败，安装失败后需要使用获取最新库信息安装指令。
pod install --no-repo-update
- 根据
Podfile信息进行安装，缺点是安装速度慢，优点是能保证当前库可用。
pod install
4.第三方库导入完毕，这之后打开项目就应该进入xxx.xcworkspace，而不再是xxx.xcodeproj
当然，之后我们可能会添加更多第三方库，当Podfile文件进行修改，需要执行以下命令中的一个。
pod update --no-repo-update
pod update
P.S. 更新命令的区别同库安装的区别，当然，也可以选择在Podfile文件修改后，重新执行一遍库安装，可以达到同样的效果。
安装CocoaPod的几个常见问题
1.gem过旧，安装失败：
切换到ruby-china的gem源，使用sudo gem update命令进行源更新，安装过程中需要输入 Y 来保证新文件与旧文件冲突时进行文件的重写。
2.安装 CocoaPods 时，终端卡在Setting up CocoaPods master repo指令：
此时不妨新建一个终端窗口，隔几分钟使用du -sh * 或者du -sh ./指令查看~/.cocoapods里的文件大小，会发现其大小一直在改变。因为此时 CocoaPods 默认把信息下载在~/.cocoapods目录下。
3.使用pod install指令时，显示
[!] Pods written in Swift can only be integrated as frameworks; this feature is still in beta.
Add `use_frameworks!` to your Podfile or target to opt into using it.The Swift Pods being used are: xxx, xxxx, xxxxx:
根据指示，在Podfile文件中添加一句use_frameworks!即可
# Uncomment this line to define a global platform for your project
# platform :ios, '9.0'
use_frameworks!
4.使用sudo gem install cocoapods指令进行安装时，如果系统更新为 EI Capitan 版本，采取指令
sudo gem install -n /usr/local/bin cocoapods
可以解决下述问题：
ERROR: While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/pod
卸载
有些时候，也许我们不想使用 CocoaPods 功能了，那么如何对其进行卸载呢?
一般我们可查看gems的本地程序包，通过键入gem list命令后输出如下图显示，因个人使用安装的多少，数量不定
但是针对 CocoaPods 的相关组件应该相同, 按需求进行程序包的移除处理即可, 依次删除以cocoapods为前缀的程序包:
sudo gem uninstall cocoapods
sudo gem uninstall cocoapods-core
......