CocoaPods总结

一、预备知识

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执行后如果本地库没有发生变化该文件是不会改变的，它可以防止第三方库升级时造成的第三方库版本不一致。（协同开发时很重要）