iOS CocoaPods 使用教程

[参] CocoaPods的安装

一、CocoaPods的安装
安装CocoaPods需要ruby环境，所以首先要检查ruby环境的版本！Mac OS X系统自带ruby环境，但是如果不管理它，它是不会自动升级的，所以需要一个ruby版本管理工具---》RVM全称Ruby Version Manager。

1. CocoaPods安装步骤:

• 首先，执行pod --version检查Mac是否安装了CocoaPods，如果没有安装进入下一步，如果已经安装则结束。
• 第二步，执行rvm -v检查Mac是否安装了rvm，如果没有安装进入下一步，如果已经安装跳到第四步。
• 第三步，执行curl -L get.rvm.io | bash -s stable安装rvm，执行source ~/.rvm/scripts/rvm指定源，然后执行rvm -v检查rvm是否安装成功。
• 第四步，执行ruby -v检查ruby版本，当ruby版本低于2.2.2时，安装cocoapods会报错。如果版本低于2.2.2进入下一步，如果版本高于2.2.2跳到第七步。
• 第五步，执行 rvm list known列出可安装的ruby版本。
• 第六步，执行rvm install 2.5.3安装指定版本的ruby，版本号2.5.3 是从上一步中得到的版本列表中选出的。
• 第七步，执行rvm list检查ruby是否安装成功，如果安装成功进入下一步，如果安装失败跳到第五步。
• 第八步，执行gem -v检查ruby版本，ruby1.9.1以后的版本自带RubyGems，RubyGems是一个方便而强大的ruby程序包管理器，建议RubyGems升级到2.6.0以上。如果RubyGems版本在2.6.0以下进入下一步，如果版本高于2.6.0跳到第十步。
• 第九步，执行gem update --system更新RubyGems。
• 第十步，执行sudo gem install cocoapods安装CocoaPods，安装失败进入下一步，安装成功则结束。
• 第十一步，执行gem sources -l检查ruby的源
• 第十二步，执行gem sources --remove https://ruby.taobao.org/移除ruby的源，其中ruby的源地址https://ruby.taobao.org/ 是从上一步中得到的。
• 第十三步，执行gem sources -a https://gems.ruby-china.com/设置一个有效的ruby源。
• 最后，执行sudo gem install cocoapods安装CocoaPods。sudo 表示管理员执行指令，需要输入密码。

2. 安装CocoaPods用到的相关命令:

pod --version    查看 CocoaPods 版本
rvm -v    查看 rvm 版本
curl -L get.rvm.io | bash -s stable    安装rvm
source ~/.rvm/scripts/rvm    指定源
ruby -v    检查ruby版本
rvm list known    列出可安装的ruby版本
rvm install 2.5.3    安装指定版本的ruby
rvm list    检查ruby是否安装成功
gem -v    检查RubyGems版本
gem update --system    更新RubyGems
gem sources -l    检查ruby的源
gem sources --remove https://ruby.taobao.org/    移除ruby源
gem sources -a https://rubygems.org/    设置ruby源
sudo gem install cocoapods    安装CocoaPods

3. 安装CocoaPods过程中的一些截图：

   
   安装rvm.jpg
   检查ruby是否安装成功.png
   列出可安装的ruby版本.jpg
   安装指定版本的ruby.jpg
   设置一个有效的ruby源.png
   安装CocoaPods.jpg
   更新RubyGems.jpeg
   执行安装Cocopods并发生错误，对错误进行处理.jpeg
   处理后依旧有错误的解决方案.jpeg
   安装Cocoapods.jpeg

二、如果你的电脑上已经下载安装好了CocoaPods,便可以按照以下步骤使用 CocoPods

1. 在终端中进入cd到项目总目录.注:将项目直接拖入终端即可得到项目总目录
   进入项目总目录

2. 编辑 Podfile (配置文件):在终端输入 vim Podfile 回车,即进入配置文件编辑状态,输入 i 进入编辑模式.

   
   编辑配置文件
3. 编辑配置文件之后输入 Esc : wq 回车即可退出编辑.注:第一次退出之后,在项目的总目录下就会出现配置文件
   配置文件
4. 终端执行 pod install 回车,安装 CocoaPods 并加载第三方库.注:首次执行时安装 CocoaPods ,这个过程需要几秒,记得关闭 Xcode 哦
   安装 CocoaPods
5. 安装完成之后,在项目的总目录下便会出现 .xcworkspace 文件,打开该文件便可以看到安装了 CocoaPods 的项目结构. 注:从此之后就不再是打开 .xcodeproj 文件,而是打开 . xcworkspace 文件了
   .xcworkspace 文件
   项目结构
6. 当你需要添加新的第三方依赖库时,可以按照步骤二,三在终端编辑 Podfile 文件,也可以在 Xcode 中编辑 Podfile 文件.不过编辑过 Podfile 文件之后都需要执行 pod update 回车,以加载新增的第三方库文件.
7. pods 命令:

pod update   加载新增的第三方库，同时更新pods
pod update --verbose --no-repo-update   快速更新pods，只加载新增的第三方库
pod search SDWebImage 查找第三方库

8. Podfile文件编辑时，第三方库版本号的各种写法:

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的版本，写这个限制和什么都不写是一个效果，都表示使用最新版本

三、遇到的问题

1. ld: library not found for -lPods-项目名,具体见下图：

   
   library not found for -lPods-项目名.png
   

   解决办法：在Link Binary With Libraries下删除对应的文件libPods-项目名.a

   
   删除问题文件.png

2. 当你使用pod install时，你可能会遇到类似下图红色区域内的错误提示,不要紧张,换为执行 pod update(更新 CocoaPods )即可.

   
   更新 CocoaPods
3. 当你使用pod update更新第三方库的时候，你可能会遇到 Please check if you are offline, or that GitHub is down 的提示。你可以查看一下这篇文章：Failed to connect to GitHub to update the CocoaPods/Specs specs repo 问题
   pod update 出错
4. 当你在进行Pods相当操作时，你可能会遇到报错 ERROR: SSL verification error at depth 0: certificate has expired (10)。如下：
   SSL verification error at depth 0.png
   原因是由于 https://ruby.taobao.org/ 作为Ruby 的源已经失效。把当前 Ruby 的源设置为默认的即可。具体见下图：
   设置当前Ruby的源为默认.png

期待你的评论建议O(∩_∩)O~