MacOS 10.15.x 最新安装 Cocoapods 教程及问题解决------实战
一、概念理解
首先不要急着搜索终端命令,你需要明白安装 cocoapods 都需要什么环境,这对于安装途中如果遇到问题该如何解决很重要,很重要,很重要!
1、安装pods需要依赖 ruby 环境,而安装 ruby 你需要借助工具 rvm,rvm是用来管理 ruby 版本的,也就是说你的电脑上可以安装多个不同版本的 ruby 可以使用 rvm 来管理他们。而安装 rvm 又需要借助另外一个工具 Homebrew,Homebrew是一款Mac OS平台下的软件包管理工具,拥有安装、卸载、更新、查看、搜索等很多实用的功能。这里不对 Homebrew 做过多讲解。
2、所以看完了上面,大概的安装步骤就已经很明确了—— 首先安装Homebrew --> 再安装rvm --> 再安装ruby -> 最后安装cocoapods。
二、进入正题
1、安装Homebrew
首先打开终端输入下面命令检测是否已经安装了 Homebrew :
brew list
如果终端有输出一些文件名,证明已经安装过了Homebrew这个时候你可以直接跳到第2步,如果显示 brew not Fond 之类的提示就需要安装Homebrew。
安装 Homebrew,终端输入以下命令:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
这里注意最好去Homebrew官网copy命令,因为命令可能会改变,官网地址:https://brew.sh,安装过程如果遇到什么问题,自行百度不做过多讲解,因为你遇到的问题网上已经有铺天盖地的解决方案了,基本上遇到的问题都是因为访问不到网站或者下不到资源。
2、安装 Rvm
如果 Homebrew 已经安装成功,接下来安装Rvm,首先检查是否已安装过Rvm,输入下面命令:
rvm -v
如果提示 rvm 1.29.9 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io] 证明已经安装了Rvm可以直接进行第3步,否则需要安装Rvm。
安装 Rvm,终端输入以下命令:
`curl -L get.rvm.io | bash -s stable`
指定源:
`source ~/.rvm/scripts/rvm`
检查安装是否成功:
rvm -v // 安装成功 // rvm 1.29.3 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io]
3、安装 Ruby
在确保已经安装了 Rvm 之后,利用 Rvm 安装 Ruby:
rvm list known // 查看ruby版本列表 最好更新到最新的 rvm install 2.6.3 // 安装2.6.3版本(安装最新的或者次新的版本即可)
注意!重点来了,执行这一步时很可能会出现错误:Error running 'requirements_osx_brew_libs_install autoconf automake libtool pkg-config libyaml readline libksba openssl',如图:
这个时候不要慌,上面提示的大概意思是在安装autoconf、
automake、
libtool、。。。、
openssl时出现了错误,因为这些依赖文件有的比较大其中最大的大概有300M左右,所以如果你的网络不好下载很容易超时,这里建议电脑连接手机热点下载,亲测可行速度比较快。接下来我们就手动一步一步来安装这些依赖文件。终端依次执行:
brew install autoconf
brew install automake
brew install libtool
brew install libyaml
brew install libxslt
brew install libksba
brew install openssl
执行完这些命令,该下的依赖已经下载的差不多了,然后再执行一次 rvm install 2.6.3,如果有没下载到的依赖文件也不要担心,当再次执行 rvm install 2.6.3 时系统会自动检测你缺少哪些依赖会自动下载的。然后你就会发现终端开始自动跑命令行,这时候是不是很开心,终于要成功了,内心一阵笑嘻嘻,然而现实总是让人忍不住来一句MMP,在最后关头又特么出了差错啦,啊啊啊啊啊啊。。。
报错显示:Error running '__rvm_make -j 1
不要慌,兵来将挡水来土掩嘛。接着往下看,一般出现这种情况是因为你的 xcode command line 出了问题,要么没有安装要么版本不对。知道问题了就解决呗,终端输入:
xcode-select --install
然后再执行 rvm install 2.6.3,这个时候随着终端里代码不断跑动,终于看到了一片祥和的绿色(从来没有像现在这样喜欢这个颜色 =_=)。
最后说一下安装 Ruby 时一定要沉得住气,终端在下载资源或者提示你 please wait 时,一定要耐心等待,而且一定不能让电脑自动休眠,不能让电脑自动休眠,不能让电脑自动休眠!
如果做了这么多你发现还是有错误就是安装不成功Ruby,没关系那就回到最初的起点(又回到最初的起点,记忆中你青涩的脸。。。),卸载RVM,重新安装!
记得要关闭终端重新打开,输入以下命令卸载 Rvm:
sudo rm -rf .rvm .rvmrc /etc/rvmrc ;gem uninstall rvm
卸载完之后,按照上面的步骤从第2步开始再来一遍。
4、安装 Cocoapods
接下来一定要注意!注意!注意!
如果你的 Mac系统是 10.11 之前,输入:
sudo gem install cocoapods
如果你的 Mac系统是 10.11 之后,输入:
sudo gem install -n /usr/local/bin cocoapods
这篇教程说的是 MacOS 10.15.x的系统当然要选择:sudo gem install -n /usr/local/bin cocoapods 了。
等待终端跑完,你是不是迫不及待的想看看你的 pods 安装成功了没,所以你迅速的输入了 pod search AFNetworking,看看是不是成功了,结果又吃了闭门羹,报错如下:
pod search AFNetworking
[!] Unable to find a pod with name, author, summary, or description matching `AFNetworking`
这是因为虽然你 pods 是安装成功了,但是 .cocoapods/repos 库本地还没有,当然搜索不到了,所以需要执行最后一步:
git clone https://git.coding.net/CocoaPods/Specs.git ~/.cocoapods/repos/master
耐心等待终端下载完成,再试试 pod search AFNetworking ,这时候是不是一阵笑嘻嘻,哈哈哈终于成功了,内心忍不住感叹一句我真特么skr人才。