一、预备知识
1、Rvm介绍：全称 Ruby Version Manager,是安装和管理ruby的一种工具。（下面用X.X.X表示ruby的版本）
#常用命令：
rvm list # 查询已安装的版本
rvm info # 查询当前版本
rvm use X.X.X --default # 选择默认版本
rvm remove X.X.X [--docs] [--gems] # 删除该ruby版本,后面的可选项分别表示同时删除文档、gems
2、Ruby介绍： 是一种面向对象的脚本语言，简单易用，功能强大。能跨平台、可移植性好。
- Ruby的软件源使用的亚马逊云服务，国内网络环境下载时易超时，可以将官方ruby源换成国内源。
- 淘宝ruby源（ https://ruby.taobao.org/ ） 2016.06后暂停维护了。
- China ruby源（ https://gems.ruby-china.org/ ）,所以现在只能换成这个源了。
3、Gem介绍：是一个管理Ruby库的程序的标准包，它通过Ruby Gem源来查找、安装、升级和卸载软件包，非常便捷。
#常用命令：
gem -v # ruby的版本号
gem sources # ruby镜像
gem sources --add XXX # 增加配置源（例如增加China ruby,源有效才能被add上）
gem sources --remove XXX # 删除配置源（例如删除默认ruby源）
gem install XXX # 安装XXX包
gem uninstall XXX # 卸载XXX包
gem clean up # 清楚所有包的旧版本，但会保留最新版本
gem list [XXX] # 列出本地的包，可选参数表示，列出本地以XXX开头的包
sudo gem install cocoapods [--pre] # 安装CocoaPods最新版[至预览版]
sudo gem update cocoapods [--pre] # 更新CocoaPods至最新版[至预览版]
sudo gem uninstall cocoapods -v X.X.X # 卸载X.X.X版本的CocoaPods
sudo gem install cocoapods -v X.X.X #安装指定版本的CocoaPods
# 如果更新不成功，按错误提示清空该目录下的缓存包
4、CocoaPods介绍：是iOS最常用的第三方库管理工具，通过ruby实现，必须有ruby环境才能使用。OS X系统默认已经可以运行ruby。但是ruby版本过低时，CocoaPods无法正常使用，所以需要先安装更新升级rvm和ruby，pod仓库，和git一样，本地有个pod repo,和github上的版本对应。
查看本地是否存在pod索引库，执行以下命令：
- 首先
cd [~]切换到当前用户的根目录。 - 再执行
cd .cocoapods命令。(注意，这里cocoapods文件是隐藏文件) - 然后执行
open .打开当前目录,查看repos目录下是否有许多索引文件。 - 否则需要执行
pod setup安装索引，它会将CocoaPods master repo索引的信息下载到~/.cocoapods目录下。下载过程中可以cd到改目录du -sh *查看下载进度。（这个过程会比较久）
#常用命令：
pod --version # 检查CocoaPods的版本（未安装则无效）
pod init # 在新建的项目根目录运行该命令，为当前项目新建podfile文件
pod install # 下载和配置podfile里定义的项目依赖（但不包括已经下载和配置的项目依赖），（新建podfile.lock文件）并将每个依赖库的版本信息记录在podfile.lock文件中。为项目新建.xcworkspace文件。如果有Podfile.lock文件而且对应的Podfile文件未被修改，则会根据Podfile.lock文件指定的版本安装。（使用时机：第一次安装、添加依赖库、移除依赖库是需要pods）
pod update [--verbose --no-repo-update] # 若Podfile中指定的依赖库版本不是固定的（即一个范围），当对应的依赖库有了更新，无论有没有Podfile.lock文件都会去获取Podfile文件描述的允许获取到的最新依赖库版本。
pod setup # 在当前用户的.cocoapods/目录下
pod search XXX # 搜索某个库(前提是必须pod setup后，在本地建立了索引，不然搜索不到)
pod repo update # 在本地索引库已经存在的情况下，如果search不到XXX库时，就执行该命令来更新索引。否则先pod setup
pod cache list #会列出本地缓存的所有三方库
pod cache clean XXX #清除某个缓存的三方库
pod repo-rsync update #同步源
二、CocoaPods的安装与卸载
有了前面的准备，这里安装cocoaPods就很简单了（原来看第一部分的说明）
1、更换Ruby源
- 移除Ruby默认源
$ gem sources --remove https://rubygems.org/
- 使用新的源
$ gem sources -a https://gems.ruby-china.org/
- 验证Ruby源是否更换成功
$ gem sources
2、安装CocoaPods
- 检查gem版本（因为gem版本过低，可能会导致安装出现问题）
$ gem -v
- 如果gem需要升级的话执行
$ sudo gem update --system
- 有了上面关键几部后，执行安装
$ sudo gem install cocoapods
$ pod setup
3、卸载CocoaPods
如果想要完全卸载一个cocoapods库，如要做一下处理：
- 执行
$ which pod命令，如果安装过cocoapods的话，会找到一个XXX/.../XXX/pod的目录，那么使用$ rm -rf 该目录将之删除。然后再执行$ which pod查看是否还有pod的目录，有的话统统删除。 - 执行
$ rm -rf ~/.cocoapods/删除该目录 - 执行
$ rm -rf ~/Library/Caches/CocoaPods/删除该目录 - 注意：上面的这几点都不会通过
gem中的卸载命令删除。 - 执行
$ gem list，会列出gem中安装的所有软件，找到cocoapods相关的软件，下图中显示的挨个删除即可。例如（sudo gem uninstall cocoapods）,下面是我电脑中需要删除的所有cocoapods相关的东西（这里不要担心，安装cocoapods时，只需执行$ gem install cocoapods，下图中的cocoapods-xxx这些都会被重写的安装下来，如果做完全删除的话，这些东西都不会重新安装，电脑里会只安装个cocopods，这些cocoapods-xxx还是用的原来的。）
Paste_Image.png
三、CocoaPods的使用
1、三步创建一个带有依赖pods项目
- 新建项目，在项目根目录执行
pod init命令。会在根目录自动生成profile文件。 - 编辑
profile文件。 - 执行
pod install（注意这里是install,不是update）,因为第一次pod install之后会为项目生成podfile.lock文件，以及.xcwokspace文件。
2、编辑profile定义依赖（下面介绍一些简单语法，详细请查看官方文档）
- 表示依赖为
SSZipArchive最新版本
pod 'SSZipArchive'
- 表示特定的依赖版本(这里就特指版本0.9)
pod 'Objection', '0.9'
- 后面pod依赖版本具体填写方法
= 0.1 // 特指版本为0.1 或者可以直接用数字（像上面的0.9写法一样）
> 0.1 // 任何版本只要0.1
>= 0.1 // 任何版本大于或等于0.1
< 0.1 // 任何版本小于0.1
<= 0.1 // 任何版本小于等于0.1
~>0.1.2 // 0.1.2 <= 版本 < 0.2.0 （这种写法也较为常见）
- configurations语法
#表示PonyDebugger库只在工程设置为Debug或者Beta依赖（使用多重配置的写法）
pod 'PonyDebugger', :configurations => ['Debug', 'Beta']
#表示PonyDebugger库只在工程设置为Debug时依赖（使用一种配置的写法）
pod 'PonyDebugger', :configuration => 'Debug'
- subspecs语法
#表示只依赖QueryKit库下的Attribute模块（使用某个库下的单个模块写法）
pod 'QueryKit/Attribute'
#表示依赖QueryKit库下的Attribute和QuerySet模块（使用某个库下的多个模块写法）
pod 'QueryKit', :subspecs => ['Attribute', 'QuerySet']
- path语法
pod 'AFNetworking', :path => '~/Documents/AFNetworking'
- git语法
#仓库中的master分支(默认)
pod 'AFNetworking', :git => 'https://github.com/gowalla/AFNetworking.git'
#仓库中的dev分支
pod 'AFNetworking', :git => 'https://github.com/gowalla/AFNetworking.git', :branch => 'dev'
#仓库中某次tag下的代码
pod 'AFNetworking', :git => 'https://github.com/gowalla/AFNetworking.git', :tag => '0.7.0'
#仓库下某次具体提交的代码
pod 'AFNetworking', :git => 'https://github.com/gowalla/AFNetworking.git', :commit => '082f8319af'
- podspec语法
#指定依赖的podspec（一般为团队内的私有库）
pod 'JSONKit', :podspec => 'https://example.com/JSONKit.podspec'
3、注意事项：
-
pod install和pod update执行时一般都比较慢，因为它们会默认更新一次podspec索引，可以再后面添加--no-repo-update参数不让更新索引。 -
pods索引库，上面提过，有时可能会因为本地pods索引库不存在或者太旧导 致项目导致podfile中的某些依赖库下载失败。这时先通过pod search XXX命令查找本地是否存在改库。
如果不存在改库需要最好先执行pod repo update命令，更新本地索引库。这个更新的过程比较漫长，更新好之后，再执行pod seach命令，这是如果你的库无法搜索出来，那就是~/Library/Caches/CocoaPods/search_index.json库索引是旧的（这个一般是因为CocoaPods升级导致，如果你想升级Cocopods记得先卸载，再执行升级，否者search_index.json还是旧的，虽然pod repo已经是最新的了，但是通过search_index.json这个还是索引不到，这就好比你买了一个第2016年的新字典，但是还用着1998年老字典的查找目录，新搜录的东西根据老目录肯定出不来）。这个库索引Json文件比较大10多MB，你可以删除该Json。然后再执行 pod search XXX，这样就会自动下载一个最新的库索引文件了。 经过上面的一些列操作后，基本不会出什么问题了，如果发现工程因为因为pod库的问题还无法编译通过，这是采用终极绝招，干掉podfile.lock文件、pods目录、.xcworkspace文件，然后执行pod install等待直到完成。 - 没有创建过
pods索引库需要pod repo setup。（可以到当前用户更目录下的.cocoapods目录中查看是否存在repo） -
Podfile.lock它会记录库的版本信息，当pod update后版本库的改动会被记录在这个文件中，当然pod install执行后如果本地库没有发生变化该文件是不会改变的，它可以防止第三方库升级时造成的第三方库版本不一致。（协同开发时很重要）
