场景一:新开封的电脑安装cocoapods
配置 cocoapods需要 ruby, 更新 ruby 需要 rvm, 下载 rvm 需要 gpg, 下载 gpg 就需要 homebrew, 所以安装顺序就是 homebrew -> gpg -> rvm -> ruby -> cocoapods
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install gnupg
查看 rvm 的版本,系统自带,版本低可以升级
rvm -v
安装 ruby.
* $ rvm list known 查看 ruby 的版本,列表里的版本都可以拿来安装,我这里安装一个2.5.1,至于为什么不装最新的2.6.0,你们懂的
* $ rvm install 2.5.1 下载
* $ rvm use 2.5.1 --default 将2.5.1设置成默认版本
* $ rvm list 查看已安装的 ruby
* $ gem sources --add [https://gems.ruby-china.com/](https://gems.ruby-china.com/) --remove [https://rubygems.org/](https://rubygems.org/) 替换 ruby 的源,不解释
安装 cocoapods
sudo gem install -n /usr/local/bin cocoapods
场景二、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 会发现出来一大段。
四、下载指定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安装完成以后,在用户根目录下有个隐藏文件夹,
image/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
, -
这里为什么会分为三层目录,是根据什么划分的呢?其实这里是把某个库的名称做了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
下载并导入对应的第三方库,跳过检查资源配置文件是否需要更新的环节.
网友评论