场景一：cocoapods安装步骤
配置 cocoapods需要 ruby, 更新 ruby 需要 rbenv, 下载 rbenv 就需要 homebrew, 所以安装顺序就是 homebrew -> rbenv -> 更新ruby -> cocoapods
安装 Xcode
Xcode：CocoaPods是用于iOS开发的依赖管理工具，因此你需要先安装Xcode。
安装Homebrew
Homebrew：Homebrew是一款Mac OS平台下的软件包管理工具，拥有安装、卸载、更新、查看、搜索等很多实用的功能。它简化了安装和管理软件的过程。
// 安装Homebrew
/bin/bash -c "\$(curl -fsSL <https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh>)"
//验证是否安装brew成功
brew -v
//更新 Homebrew
brew update
安装Ruby
Ruby：CocoaPods是用Ruby编写的，因此你需要安装Ruby。虽然macOS自带了Ruby，但你可能需要更新到较新的版本。你可以使用Homebrew来安装或更新Ruby。
brew search ruby #来查看所有可用的Ruby版本。
brew install ruby@NEW_VERSION # 替换NEW_VERSION为你想要安装的具体版本号
安装 rbenv（或者rvm）
rbenv（可选）：rbenv和rvm都是 Ruby 版本管理器，允许开发者在同一台机器上轻松安装、切换和管理多个 Ruby 版本。
brew install rbenv # 安装rbenv
将rbenv初始化脚本添加到你的shell配置文件中
echo 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.zshrc
使更改生效 & 验证rbenv
source ~/.zshrc #使更改生效
rbenv --version #验证rbenv
安装CocoaPods
CocoaPods：最后，当然就是安装CocoaPods本身了。在确认已经安装了Ruby之后，你可以通过运行sudo gem install cocoapods命令来安装CocoaPods。
sudo gem install cocoapods #安装
pod --version # 验证
场景二、cocoapods 卸载->重装
1、如果之前装过cocoapods，最好先卸载掉，卸载命令：
$ sudo gem uninstall -n /usr/local/bin cocoapods
2、查看本地安装过的cocoapods相关东西
$ gem list --local | grep cocoapods
sudo gem install -n /usr/local/bin cocoapods
会显示如下：然后逐个删除吧：
cocoapods-core (0.39.0)
cocoapods-downloader (0.9.3)
cocoapods-plugins (0.4.2)
cocoapods-search (0.1.0)
cocoapods-stats (0.6.2)
cocoapods-trunk (0.6.4)
cocoapods-try (0.5.1)
$ sudo gem uninstall -n /usr/local/bin cocoapods-core
二、安装
1、 查看下当前ruby版本，如果用这个版本接下来工作失败了，就更新下ruby
ruby -v
2、更换cocoapods镜像：
$gem sources --remove https://rubygems.org/
$ gem sources --add https://gems.ruby-china.com
$gem sources -l （用来检查使用替换镜像位置成功）
3、下载安装CocoaPods
sudo gem install -n /usr/local/bin cocoapods
三、错误处理：
1、ERROR: Could not find a valid gem 'cocoapod' (>= 0) in any repository
说明你还没有安装命令行工具，执行下这个命令:
Xcode-select --install
就会发现 弹出一个窗问我们是否要安装命令行工具 。 安装完了后 再次sudo gem install cocoapods 发现还是会报同样的错误,可能是权限的问题,使用sudo -i或者sudo su进入到root之后再 执行sudo gem install -n /usr/local/bin cocoapods 。
command+q退出一下 再重新进入Shell里面 执行sudo gem install -n /usr/local/bin cocoapods 会发现出来一大段。
2、本地多个Ruby环境导致pod执行失败
如果执行任意pod指令都失败，失败信息像下面这样：
Ignoring ffi-1.13.1 because its extensions are not built. try: gem pristine ffi —version 1.13.1
Ignoring gem-wrappers-1.4.0 because its extensions are not builts. Try: gem pristine gem-wrappers —version 1.4.0
Traceback (most recent call last):
23: from /USR/LOCAL/BIN/pod:23:in `<main>`
22: from /USR/LOCAL/BIN/pod:23:in `load`
21: from /Users/username/.rvm/rubies/ruby-2.6.0/lib/ruby/gems/2.6.0/gems/cocoapods-1.9.3/bin/pod:36:in `<top (required)>`
20: from /System/Library/Frameworks/Ruby.frameworks/Versions/2.6/usr/lib/ruby/2.6.0/rubygems/core_ext/kernel_require.rb:54:in `require`
如果是这样子的话，根据错误提示说明是本地有多个Ruby环境导致的，看看根目录下是否多了 rvm 目录，或者.rvm目录下多了个Ruby，删除多余的rvm目录或目录下的Ruby即可。
四、下载指定pod的版本
//Analyzing dependencies
[!] The version of CocoaPods used to generate the lockfile (1.9.2) is higher than the version of the current executable (1.9.1). Incompatibility issues may arise.
Downloading dependencies/
同事的pod版本不一致，git就会一直提示到有这个修改，很烦人。
查看当前pod版本：
pod --version
直接下载想要的pod版本：
sudo gem install cocoapods --version 1.9.1
删除不想要的版本：
sudo gem uninstall cocoapods
Select gem to uninstall:
1. cocoapods-1.9.1
2. cocoapods-1.9.2
3. All versions
> 2
//Successfully uninstalled cocoapods-1.2.1
再次查看当前pod版本：执行一次当前pod的install命令
pod --version
pod install
五、 spec资源所有库的配置信息
-
在cocoapods安装完成以后,在用户根目录下有个隐藏文件夹，
/Users/<user>/.cocoapods.image -
而
/Users/<user>/.cocoapods/repos/master/Specs/里面是cocoapods收录的所有库的配置信息.Specs目录下，并不是直接是以库的名称命名的文件夹，而是分了3层目录，分别以0-f来命名,比如SDWebImage的配置文件位置就是/Users/<user>/.cocoapods/repos/master/Specs/1/1/7/SDWebImage，image 这里为什么会分为三层目录,是根据什么划分的呢?其实这里是把某个库的名称做了md5，md5前三位是其所对应的三层目录,比如SDWebImage的md5是
1173B6117A2CF4A6756F761AEDAE9D2C，那么其目录结构就是1/1/7.-
Spec内的框架每一个版本内并不是具体的代码,而是一个json文件,里面记录这该框架当前选中的版本的详细信息,包括作者、github位置....等等.
image
六、podfile文件 ——关于版本指定约束
- 一般我们在使用cocoapods导入第三方库前都会生成一个podfile文件,文件中记录着我们要导入的第三方库以及对应的版本信息,比如:
pod 'SDWebImage', '~> 4.3.2'
这里的意思是指:让cocoapods导入SDWbImage框架,版本号4.3.2和版本号处于4.3.2-4.4之间的,不包括4.4和更高版本.
所以要想cocoapods导入的框架是我们想要的,必须了解一下版本制定的约束
-
pod ‘ SDWebImage’--- 不指定版本，表示希望使用最新版本 -
pod 'SDWebImage', '4.3.2'--- 指定明确版本，表示只想要这个版本 - 逻辑关系
'> 0.1'--- 版本号大于0.1的
‘>= 0.1’--- 版本0.1和版本号大于0.1的
'< 0.1'--- 版本号小于0.1的
‘<= 0.1'--- 版本号0.1和版本号小于0.1的 - 最优匹配
‘~> 0.1.2'--- 版本0.1.2和版本号处于0.1.2-0.2之间的,不包括0.2和更高版本
‘~> 0.1'--- 版本0.1和版本号处于0.1-1.0之间的,不包括1.0和更高版本
‘~> 0'--- 版本0和更高，和没设没啥区别
七、常用命令 pod install、pod update、.pod repo update 、 pod install --no-repo-update
pod install:执行该命令时，如果Podfile.lock文件存在, 则直接从此文件中读取框架信息并且它会只下载Podfile.lock文件中指定的版本安装。对于不在Podfile.lock文件中的pod库，pod install命令会搜索这个pod库在Podfile文件中指定的版本来安装,安装完毕更新Podfile.lock文件；
如果Podfile.lock不存在, 则会读取Podfile文件内的框架信息，然后执行下载并且根据下载好的框架信息, 生成Podfile.lock文件.
pod update:只有当你想要更新pod库的版本时才使用pod update；它不管Podfile.lock是否存在, 都会读取Podfile文件的的框架信息去下载安装，下载好之后, 再根据下载好的框架信息, 生成Podfile.lock文件.
pod repo update: 更新整个.cocoapods下的所有库的配置文件,挨个检查对应的框架有没有新版本发布,有的话更新本地的资源配置文件.
--no-repo-update:跳过检查框架有没有新版本发布的环节,一般配合pod install使用.
pod install --no-repo-update:根据podfile文件或者podfile.lock下载并导入对应的第三方库,跳过检查资源配置文件是否需要更新的环节.
八、 pod 常用命令
$ pod --version #查看cocoapod 版本
$ gem install cocoapods -n /usr/local/bin #更新cocoapods
$ cd ~/.cocoapods/repos #进入 repos目录
$ open ~/.cocoapods/repos #进入 repos目录
$ pod repo #查看当前源
$ pod repo add master https://xxx.git #添加源
$ pod repo remove trunk #移除指定源
