[参] CocoaPods的安装
一、CocoaPods的安装
安装CocoaPods需要ruby环境，所以首先要检查ruby环境的版本！Mac OS X系统自带ruby环境，但是如果不管理它，它是不会自动升级的，所以需要一个ruby版本管理工具---》RVM全称Ruby Version Manager。
- 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 表示管理员执行指令，需要输入密码。
- 安装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
-
安装CocoaPods过程中的一些截图：
安装rvm.jpg
检查ruby是否安装成功.png
列出可安装的ruby版本.jpg
安装指定版本的ruby.jpg
设置一个有效的ruby源.png
安装CocoaPods.jpg
更新RubyGems.jpeg
执行安装Cocopods并发生错误，对错误进行处理.jpeg
处理后依旧有错误的解决方案.jpeg
安装Cocoapods.jpeg
二、如果你的电脑上已经下载安装好了CocoaPods,便可以按照以下步骤使用 CocoPods
- 在终端中进入cd到项目总目录.注:将项目直接拖入终端即可得到项目总目录
进入项目总目录 -
编辑 Podfile (配置文件):在终端输入 vim Podfile 回车,即进入配置文件编辑状态,输入 i 进入编辑模式.
编辑配置文件 - 编辑配置文件之后输入 Esc : wq 回车即可退出编辑.注:第一次退出之后,在项目的总目录下就会出现配置文件
配置文件 - 终端执行 pod install 回车,安装 CocoaPods 并加载第三方库.注:首次执行时安装 CocoaPods ,这个过程需要几秒,记得关闭 Xcode 哦
安装 CocoaPods - 安装完成之后,在项目的总目录下便会出现 .xcworkspace 文件,打开该文件便可以看到安装了 CocoaPods 的项目结构. 注:从此之后就不再是打开 .xcodeproj 文件,而是打开 . xcworkspace 文件了
.xcworkspace 文件
项目结构 - 当你需要添加新的第三方依赖库时,可以按照步骤二,三在终端编辑 Podfile 文件,也可以在 Xcode 中编辑 Podfile 文件.不过编辑过 Podfile 文件之后都需要执行 pod update 回车,以加载新增的第三方库文件.
- pods 命令:
pod update 加载新增的第三方库，同时更新pods
pod update --verbose --no-repo-update 快速更新pods，只加载新增的第三方库
pod search SDWebImage 查找第三方库
- 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的版本，写这个限制和什么都不写是一个效果，都表示使用最新版本
三、遇到的问题
-
ld: library not found for -lPods-项目名,具体见下图：
library not found for -lPods-项目名.png
解决办法：在Link Binary With Libraries下删除对应的文件libPods-项目名.a
删除问题文件.png -
当你使用pod install时，你可能会遇到类似下图红色区域内的错误提示,不要紧张,换为执行 pod update(更新 CocoaPods )即可.
更新 CocoaPods - 当你使用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 出错 - 当你在进行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~
