Cocoapods的安装和常见问题解决

CocoaPods 能让开发者非常方便的使用第三方类库，不用自己去管理依赖问题，以及非arc等编译条件
在mac 系统下调用终端：

安装cocoapods

为了防止gem安装更新失败，因此先替换可用镜像
先替换镜像为国内的淘宝的镜像，否则在天朝的网络限制中会很慢很慢

gem sources --remove https://rubygems.org/ 
//等有反应之后再敲入以下命令 (淘宝源地址更新为https了)
gem sources -a https://ruby.taobao.org/

检查一下看看

gem sources -l
*** CURRENT SOURCES *** https://ruby.taobao.org/

使用gem安装cocoapods

sudo gem install cocoapods

如果gem出现错误
先更新gem然后重新开始

sudo gem update --system

为了pod update 的时候加快速度，specs仓库镜像换成gitcafe上的镜像或者是 oschina 上的镜像
所以建议先更换数据源

pod repo remove master
pod repo add master https://gitcafe.com/akuandev/Specs.git  

或者

pod repo add master http://git.oschina/akuandev/Specs.git 

分别替换gitcafe上的镜像或者是 oschina 上的镜像，感谢akinliu大神的贡献
然后再执行

pod setup 

Cocoapods 具体使用方法:

直接在需要加入cocoapods项目的根目录新建Podfile文件

$touch Podfile

编辑 Podfile文件

platform :ios
pod 'IQKeyboardManager' 
pod 'ASIHTTPRequest'

然后再执行 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后缀的文件，不要点击原来的项目文件

如果 pod update / pod install 命令执行过慢（首次运行的时候不要）

执行pod install还是pod update都卡在了Analyzing dependencies不动
原因在于当执行以上两个命令的时候会升级CocoaPods的spec仓库，加一个参数可以省略这一步，然后速度就会提升不少。加参数的命令如下：

pod install --verbose --no-repo-update

pod update --verbose --no-repo-update

出现的错误整理

[!] 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
gem update cocoapods --pre

使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