转载自：邦Ben的《iOS CocoaPods 安装笔记（持续更新）
今天悲催的公司电脑被空调积水给泡了，要重新安装，反正我是记不住这些步骤的了，所以从以前的CSDNblog中迁移过来方便看
CocoaPods 能让开发者非常方便的使用第三方类库，不用自己去管理依赖问题，以及非arc等编译条件在mac 系统下调用终端：
基本的步骤是 gem install cocoapods -> pod setup -> pod init -> edit Podfile -> pod install -> open xcworksapce (期间出现对应的问题 就对应解决)
1、安装cocoapods
转载注：这里也可以brew搞定
为了防止gem安装更新失败，因此先替换为国内的淘宝的镜像源，否则在天朝的网络限制中会很慢很慢
gem sources --remove https://rubygems.org/ //等有反应之后再敲入以下命令 (淘宝源地址更新为https了) gem sources -a https://ruby.taobao.org/ //或者 更新为 ruby-china的镜像 gem sources -a https://gems.ruby-china.org/
检查一下看看
gem sources -l *** CURRENT SOURCES *** https://ruby.taobao.org/
使用gem安装cocoapods
sudo gem install cocoapods //现在pod 1.0 版本安装流程有点变化，有可能出现不能替换镜像源的问题，因此建议先装 0.39版本，全部安装完成后再升级到1.0版本 sudo gem install cocoapods -v 0.39 //现在多数的资料都是是0.39版本前的
如果gem出现错误先更新gem然后重新开始
//没什么问题就不要更新这个了，容易出现问题 sudo gem update --system //更新后请重新设置下taobao镜像源 //如果还有问题 请看下面
2、设置pod源码(初始化cocoapods) -- 重要问题都在这
如果pod setup 可以将github的代码下载得动，那你就不用去折腾什么oschina源了
pod setup //会将Specs.git的代码下载到~/.cocoapods/repo/master //如果还是太慢，尝试下 pod install --verbose
如果setup很慢甚至卡住 (都是因为天朝的网络原因)
为了pod install / update 的时候加快速度，specs仓库镜像换成coding上的镜像或者是 oschina 上的镜像所以建议先更换数据源
pod repo remove master //coding 上有每日更新的，建议使用这个 pod repo add master https://git.coding.net/CocoaPods/Specs.git //或者用oschina，但是https 好像有问题，一直是403，所以用ssh的方式，这里需要到官网去配置ssh key pod repo add master https://git.oschina.net/akuandev/Specs.git
如果提示失败或者setup不成功，方案有两种:
1) 手动将代码clone下来 【该方法比较有效】
转载注：网上有的文章指出可以pod repo 直接更换master源，这个方法在1.0.0已经不好用了，会提示如下错误：
[!] To setup the master specs repo, please run pod setup.
正确做法是，自己从一个镜像clone，然后执行：
git clone https://git.coding.net/CocoaPods/Specs.git ~/.cocoapods/repos/master pod setup //务必在手动下载代码后执行一次,执行后 Setup completed //在执行 pod install --verbose --no-repo-update //避免去更新了
2) 降到0.39,setup之后再升级到1.0吧
这个好像不好用
3、Cocoapods 具体使用方法
直接在需要加入cocoapods项目的根目录新建Podfile文件
$pod init //会生成模板的Podfile文件 //或者手动创建 $touch Podfile
编辑 Podfile文件
platform :ios pod 'AFNetworking'
单独某个target依赖pod（ 在1.0中要求必须指定target了）
target 'XXXTarget' do
pod 'AFNetworking'
pod 'Masonry'
end
然后再执行 pod setup 即可以后每次更改 Podfile文件 则执行 pod update 即可如果在初始化的时候出现：如果安装后出现
[!] The platform of the target `Pods` (iOS 4.3) may not be compatible with `Reachability (3.2)` which has a minimum requirement of iOS 6.0 - OS X 10.8.
则修改 Podfile 为
platform :ios, '6.0'
update 后如果出现大量提示
错误 target overrides the `OTHER_LDFLAGS`...
则项目中Building setting 设置中 搜索Other Linker Flags的地方，添加一条
`$(inherited)`
以后打开项目点击xcworksapce后缀的文件，不要点击原来的项目文件
至此，已经结束，愉快地使用吧
4、出现问题总结
如果 pod update / pod install 命令执行过慢
（首次运行的时候不要）执行pod install还是pod update都卡在了Analyzing dependencies不动原因在于当执行以上两个命令的时候会升级CocoaPods的spec仓库，加一个参数可以省略这一步，然后速度就会提升不少。
加参数的命令如下：
pod install --verbose --no-repo-update pod update --verbose --no-repo-update
gem install 出现 ERROR: While executing gem ... (Gem::FilePermissionError)
解决方法:
sudo gem install -n /usr/local/bin cocoapods
或者:
$ mkdir -p $HOME/Software/ruby $ export GEM_HOME=$HOME/Software/ruby $ gem install cocoapods //打印 $ export PATH=$PATH:$HOME/Sofware/ruby/bin $ pod --version
或者重新安装rvm
//Install Homebrew:（已经装过就不用了） $ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" // Install RVM: $ \\curl -sSL https://get.rvm.io | bash -s stable --ruby $ gem install cocoapods
出现 Invalid \Podfile file
[!] Invalid `Podfile` file: incompatible character encodings: UTF-8 and ASCII-8BIT. Updating CocoaPods might fix the issue.
这是编码的问题，有两种原因，
1.你的设备确实不支持utf8，
2.你本身录入文本有问题查看编码
localhost:xib cty$ locale
执行命令后出现
LANG="zh_CN.UTF-8"LC_COLLATE="zh_CN.UTF-8"LC_CTYPE="zh_CN.UTF-8"LC_MESSAGES="zh_CN.UTF-8"LC_MONETARY="zh_CN.UTF-8"LC_NUMERIC="zh_CN.UTF-8"LC_TIME="zh_CN.UTF-8"LC_ALL=
发现都是zh，强制设置一下
localhost:xib cty$ export LC_ALL=en_US.UTF-8 localhost:xib cty$ export.UTF-8
再检查一下
LANG="en_US.UTF-8"LC_COLLATE="en_US.UTF-8"LC_CTYPE="en_US.UTF-8"LC_MESSAGES="en_US.UTF-8"LC_MONETARY="en_US.UTF-8"LC_NUMERIC="en_US.UTF-8"LC_TIME="en_US.UTF-8"LC_ALL="en_US.UTF-8"
好像好了，继续pod install吧
[!] Invalid `Podfile` file: incompatible character encodings: UTF-8 and ASCII-8BIT. Updating CocoaPods might fix the issue.
问题依然把所有可能的配置都试一遍
gem install rails
然后
gem install rdoc
然后
gem install nokogiri --no-ri --no-rdoc
这些都设置完一般不会出现问题了，再有问题，可能是文本录入的问题2的解决办法，如果你是手动输入的这个需要注意，copy别人的也要检查一下打开键盘偏好设置设置单引号格式，当然冒号我还没找到怎么设置，一般错误会提示给你哪写错了这里不再提示utf8的错误了，输入法的错误，但是我切换了半天设置了半天还是没解决冒号，只能吧
The `master` repo requires CocoaPods 0.18.1 -
这个错误是在升级阶段出现的，升级
gem update cocoapods
- 使cocopods管理开源库编译出现Library not found for -lPods问题的解决方法
- 点击菜单栏上 Product > Edit Scheme
- 选择Build
- 加入Pods static library, 并且保证 pods 处于第一个位置
- Clean and build 项目
如果在导入头文件的时候发现无法自动补全，或者PCH文件中提示File not found
在User headers search path(在Project 和 Target 都修改)中
${SRCROOT} --右侧选择recursive
Jenkins 脚本打包中出现 uft-8问题
[33mWARNING: CocoaPods requires your terminal to be using UTF-8 encoding.
在pod install 之前执行
export LC_ALL="en_US.UTF-8" pod install --no-repo-update
2017.04.01更新：如何切换到Developing Pod
pod 'Name', :path => '~/code/Pods/'
2017.04.01更新：如何切换到TesingPod
pod 'NAME', :git => 'https://example.com/URL/to/repo/NAME.git'
2016.10.27补充：如何更换pod版本
sudo gem install -n /usr/local/bin cocoapods -v 1.0.1 --verbose sudo gem uninstall cocoapods
2016.11.07补充：如何使用两个pod版本
pod _1.0.1_ xxxx
2016.11.09补充：如何只升级某个pod的版本
pod update --no-repo-update HyphenateSDK