目录

一：CocoaPods 的安装

1、更换 Gem 的源
2、更新升级 Gem 版本
3、安装CocoaPods
4、更换repo镜像为国内服务器

二：CocoaPods的使用

1、新建 Podfile 文件
2、编辑 Podfile 文件
3、执行导入命令
4、第三方库更新

三：各种问题

安装基本流程

1.先升级Gem 
  gem update --system
2.切换cocoapods的数据源 
  2.1 删除老的源(地址在国外，比较卡) 
      gem sources --remove https://rubygems.org/ 
  2.2 新增国内源
      gem sources -a https://gems.ruby-china.org/
  2.3 查看当前源
      gem sources -l
3.安装cocoapods 
  gem install cocoapods
4.将Podspec文件托管地址从github切换到国内的oschina
  4.1 先删除老的数据
      pod repo remove master
  4.2 换成国内镜像
      pod repo add master https://git.coding.net/CocoaPods/Specs.git
  4.3 更新镜像
      pod repo update
5.设置pod仓库 
  pod setup
6.测试 【如果有版本号，则说明已经安装成功】 
  pod --version
7.利用cocoapods来安装第三方框架
  7.1 进入要安装框架的项目的.xcodeproj同级文件夹 
  7.2 在该文件夹中新建一个文件Podfile 
  7.3 在文件中告诉cocoapods需要安装的框架信息 
      7.3.1 该框架支持的平台 
      7.3.2 适用的iOS版本 
      7.3.3 框架的名称 
      7.3.4 框架的版本
8.安装
  pod install --no-repo-update
  pod update --no-repo-update

一：CocoaPods安装

CocoaPods是用Ruby实现的，要想使用它首先需要有Ruby的环境。幸运的是OS X系统默认的已经可以运行Ruby了，因此我们只需要执行以下命令。

1: 更换Gem源

Gem是一个管理Ruby库和程序的标准包，它通过Ruby Gem(如 http://rubygems.org/ )源来查找、安装、升级和卸载软件包

// 1.移除掉原有的源（服务器在国外，速度较慢）
- gem sources --remove https://rubygems.org/
// 2.等有反应之后再敲入以下命令（淘宝源已经停止维护了，现在是https://gems.ruby-china.org/）
- gem sources -a https://gems.ruby-china.org/
// 3.验证是否替换成功
- gem sources -l

Gem源

2: 更新Gem版本

Gem是管理Ruby库和程序的标准包，如果它的版本过低也可能导致安装失败，解决方案自然是升级Gem，执行下述命令即可:

// 更新升级gem
- gem update --system

3: 安装Cocoapods

// 安装CocoaPods（OS X 10.11以前,包含10.11）
- gem install cocoapods   // 默认安装最新版本
- gem install cocoapods -v 1.0.0   // 安装指定1.0.0版本
// 安装CocoaPods（10.11后苹果升级了安全策略）
- gem install -n /usr/local/bin cocoapods

安装cocoapods

4: 更换repo镜像

所有的项目的Podspec文件都托管在https://github.com/CocoaPods/Specs。 第一次执行pod setup时，CocoaPods会将这些podspec索引文件更新到本地的 ~/.cocoapods/目录下，这个索引文件比较大，所以第一次更新时非常慢。而且很大几率失败，反正我是没有成功过，挂了vpn也不行。
后来就出现了国内镜像，这里推荐git coding上的https://git.coding.net/CocoaPods/Specs.git 貌似这个镜像也是cocoapods官方维护的。

// 1.移除原有服务器
- pod repo remove master
// 2.添加境内服务器(建议使用第二种方法)
- pod repo add master https://git.coding.net/CocoaPods/Specs.git
- git clone https://git.coding.net/CocoaPods/Specs.git ~/.cocoapods/repos/master
// 3.更新镜像(这一步不要忘了)
- pod repo update

移除原有服务

新增国内镜像，方法1

新增国内镜像，方法2

更新repo镜像内容

5: 设置Pod仓库

// 设置pod 仓库
- pod setup

设置pod仓库

6: 测试

通过search命令或者查看version，可以判断是否安装成功

// 查看版本
- pod --version
// 查询库
- pod search JWTrace

查询pod版本

search命令

二：CocoaPods使用

1: 新增Podfile文件

使用时需要在你的项目根目录下新建一个名为Podfile的文件，将依赖的库名字依次列在文件中即可

// 控制台，cd进入项目根目录
cd /Users/wangjun/Desktop/WorkSpace/CocoapodsDemo
// 新增Podfile文件
vim Podfile

编辑Podfile文件内容

2: 导入库

导入完成之后，打开xxx.xcworkspace，启动项目

// 导入库
pod install

导入库

三：问题

升级、安装过程中，会遇到很多问题，这了列举一些我碰到的。

1: pod setup时异常

Setting up CocoaPods master repo
[!] /usr/local/bin/git clone https://github.com/CocoaPods/Specs.git master

Cloning into 'master'...
error: RPC failed; curl 18 transfer closed with outstanding read data remaining
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed

Setting up CocoaPods master repo
[!] /usr/local/bin/git clone https://github.com/CocoaPods/Specs.git master

Cloning into 'master'...
error: RPC failed; curl 56 SSL read: error:00000000:lib(0):func(0):reason(0), errno 54
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed

Setting up CocoaPods master repo
[!] /usr/bin/git clone https://github.com/CocoaPods/Specs.git master

Cloning into 'master'...
error: RPC failed; curl 56 SSLRead() return error -9806
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed

这三种问题，都是因为repo镜像done不下来导致的。
执行CocoaPods安装中的第4步 即可

2: Size问题

Setting up CocoaPods master repo
[!] /usr/bin/git clone https://github.com/CocoaPods/Specs.git master

Cloning into 'master'...
error: RPC failed; result=56, HTTP code = 200
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed

这个是用于在执行pod setup命令的时候,里面会执行从github上面clone资源到本地的语句,但是要clone的东西太大了,超过的git限制的大小.尝试执行以下语句把默认的限制变大:(52428000=500×1024×1024,即500M)

// 配置
git config http.postBuffer 524288000

buffconfig

四：更多

1: pod install提速

每次执行pod install和pod update的时候，cocoapods都会默认更新一次spec仓库。这是一个比较耗时的操作。在确认spec版本库不需要更新时，给这两个命令加一个参数跳过spec版本库更新,可以明显提高这两个命令的执行速度。

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

2: 导入库时，版本选择

#pod ‘AFNetworking’             //不显式指定依赖库版本，表示每次都获取最新版本
#pod ‘AFNetworking’,  ‘2.0’     //只使用2.0版本
#pod ‘AFNetworking’, ‘>2.0′     //使用高于2.0的版本
#pod ‘AFNetworking’, ‘>=2.0′    //使用大于或等于2.0的版本
#pod ‘AFNetworking’, ‘<2.0′     //使用小于2.0的版本
#pod ‘AFNetworking’, ‘<=2.0′    //使用小于或等于2.0的版本
#pod ‘AFNetworking’, ‘~>0.1.2′  //使用大于等于0.1.2但小于0.2的版本，相当于>=0.1.2并且<0.2.0
#pod ‘AFNetworking’, ‘~>0.1′    //使用大于等于0.1但小于1.0的版本
#pod ‘AFNetworking’, ‘~>0′      //高于0的版本，写这个限制和什么都不写是一个效果，都表示使用最新版本

3: 一些其他命令

// 忽略第三方库的警告
inhibit_all_warnings!
// OC中引入Swifty库
use_frameworks!