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',如图:
MacOS 10.15.x 最新安装 Cocoapods 教程及问题解决

  这个时候不要慌,上面提示的大概意思是在安装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 时系统会自动检测你缺少哪些依赖会自动下载的。然后你就会发现终端开始自动跑命令行,这时候是不是很开心,终于要成功了,内心一阵笑嘻嘻,然而现实总是让人忍不住来一句妈卖批,在最后关头又特么出了差错啦,啊啊啊啊啊啊。。。

  报错显示: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人才。

上一篇:macOS 平台 Homebrew 更新 brew update 卡死,完美解决


下一篇:Mac下如何安装adb