2018 升级macOS High Sierra后cocoapo

一、 概要

CocoaPods可以用来方便的统一管理这些第三方库
初衷：因为mac系统更新到10.13.5， cocoapod失效了要重新安装。因此写下该博文方便日后自己查看

二、安装

步骤
1，检查是否已安装rvm，若安装了跳过，未安装的话先安装
2，检查ruby是否最新版，安装最新版的ruby（为了匹配mac系统）
3，安装cocoapod 第三方苦管理工具

概念

rvm : Ruby Version Manager 安装和空置Ruby版本的工具
Ruby: 先理解为一种脚本语言，作为安装cocoapod的镜像
Cocoapod : 类库管理工具，管理第三方库

第一步，首先要检查Mac是否安装了rvm。打开终端，输入指令

rvm -v

image.png
step1 :安装rvm

curl -L get.rvm.io | bash -s stable

step2 :指定源

source ~/.rvm/scripts/rvm

step3 :查看版本确认是否安装成功

rvm -v

//会出现类似这种的  表示安装成功
rvm 1.29.3 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io]

Step 4: 列出所有指定源里的ruby版本

rvm list known

//出现 以下的内容
[ruby-]1.8.6[-p420]
[ruby-]1.8.7[-head] # security released on head
[ruby-]1.9.1[-p431]
[ruby-]1.9.2[-p330]
[ruby-]1.9.3[-p551]
[ruby-]2.0.0[-p648]
[ruby-]2.1[.10]
[ruby-]2.2[.7]
[ruby-]2.3[.4]
[ruby-]2.4[.1]
ruby-head

第二步，用rvm安装ruby环境

Step1:查看当前的ruby的版本

ruby -v

//当前版本是2.33，上面查询最新的版本是2.4.1
ruby 2.3.3p222 (2016-11-21 revision 56859) [universal.x86_64-darwin17]

Step2:升级最新版的ruby

rvm install 2.4.1  

Step3:这里在升级ruby的时候失败的话 可能是gem太老了可以尝试用如下命令升级 gem

sudo gem update --system

Step4:检查ruby源并移除

1、移除现有Ruby默认源    gem sources --remove https://rubygems.org/
2、使用新的源    gem sources -a https://gems.ruby-china.com/
这里注意:
以前的https://ruby.taobao.org/ 被抛弃了
以前的https://gems.ruby-china.org/ 域名已更换成https://gems.ruby-china.com/
3.验证新源是否替换成功    gem sources -l

*** CURRENT SOURCES ***
https://gems.ruby-china.com/

代表替换成功！！

需要注意以下⤵️

image.png

第三步，安装CocoaPods

sudo 表示管理员执行指令，需要输入密码的
Step1:安装cocoapods

OS X 10.11之前系统的安装cocoapods 指令：
$ sudo gem install cocoapods

OS X 10.11以后系统的安装cocoapods 指令：
$ sudo gem install -n /usr/local/bin cocoa pods

Step2:初始化cocoapods

pod setup

Step3:更新gem

//再更新一次吧
sudo gem update --system

Step4:测试一下是否安装成功

pod --version
1.5.3 //暂时最新版本

pod search afnetworking

-> AFNetworking (3.2.1)
   A delightful iOS and OS X networking framework.
   pod 'AFNetworking', '~> 3.2.1'
   - Homepage: https://github.com/AFNetworking/AFNetworking
   - Source:   https://github.com/AFNetworking/AFNetworking.git
   - Versions: 3.2.1, 3.2.0, 3.1.0, 3.0.4, 3.0.3, 3.0.2, 3.0.1, 3.0.0,
   3.0.0-beta.3, 3.0.0-beta.2, 3.0.0-beta.1, 2.6.3, 2.6.2, 2.6.1, 2.6.0, 2.5.4,
   2.5.3, 2.5.2, 2.5.1, 2.5.0, 2.4.1, 2.4.0, 2.3.1, 2.3.0, 2.2.4, 2.2.3, 2.2.2,
   2.2.1, 2.2.0, 2.1.0, 2.0.3, 2.0.2, 2.0.1, 2.0.0, 2.0.0-RC3, 2.0.0-RC2,
   2.0.0-RC1, 1.3.4, 1.3.3, 1.3.2, 1.3.1, 1.3.0, 1.2.1, 1.2.0, 1.1.0, 1.0.1,
   1.0, 1.0RC3, 1.0RC2, 1.0RC1, 0.10.1, 0.10.0, 0.9.2, 0.9.1, 0.9.0, 0.7.0,
   0.5.1 [master repo]
   - Subspecs:
     - AFNetworking/Serialization (3.2.1)
     - AFNetworking/Security (3.2.1)
     - AFNetworking/Reachability (3.2.1)
     - AFNetworking/NSURLSession (3.2.1)
     - AFNetworking/UIKit (3.2.1)

第四，常见的安装错误

• Unable to find a pod with name, author, summary, or description matching
  解决方法：

rm ~/Library/Caches/CocoaPods/search_index.json (第一步)

pod search afnetworking (第二步)

• can't find gem cocoapods (>= 0.a)
  解决方法：

1: sudo gem uninstall cocoapods

2: gem install cocoapods

3: pod install

• [!] An error occurred while performing [Git](http://lib.csdn.net/base/git) pull on repo master.
  解决方法：

sudo rm -fr ~/.cocoapods/repos/master
然后再: pod setup

• Creating search index for spec repo 'master'..

当pod search 回车后出现以下, 只需要等就可以了, 第一次的时候是会等得比较久一些

• Requirements installation failed with status: 1.
  这是安装ruby的时候出现的问题
  解决方法：

brew update
rvm get head
rvm install 2.3

• /usr/local/etc/openssl/cert.pem
  这是更新ruby的时候，报openssl错的时候
  解决方法：

rvm pkg install openssl
rvm install 2.0.0 
rvm use 2.0.0 --default

• can't find gem cocoapods (>= 0.a) (Gem::GemNotFoundException)
  解决方法：（可尝试下。如果不行请再百度）

which pod  //现找一下 pod的路径
sudo rm -rf /usr/local/bin/pod  //删除目录下的文件
gem list  //获取gem
gem uninstall cocoapods -v 0.39.0  //移除程序包
gem uninstall cocoapods-core -v 0.39.0

sudo gem install cocoapods //重新安装cocoapod
pod --version

• 当安装比较卡想退出安装: Ctrl + C键

• /Library/Ruby/Site/2.0.0/rubygems.rb:270:in find_spec_for_exe': can't find gem cocoapods (>= 0.a) (Gem::GemNotFoundException) from /Library/Ruby/Site/2.0.0/rubygems.rb:298:inactivate_bin_path' from /usr/local/bin/pod:22:in `<main>'
  解决方法：

一、可能因为ruby版本过低导致，请先升级ruby到最新版本，在重新安装pod

二、如果更新了ruby为最新版本也不行，请走下一步（更新ruby上文能查阅）
1.gem install cocoapods
2.pod install

• 升级macOS High Sierra后cocoapods不能使用的解决办法

sudo gem update --system  //升级ruby
sudo gem install -n /usr/local/bin cocoapods  //重新安装cocoapods

当以后更新了mac系统版本，如果出现cocoapod出现问题。更新ruby最新版本。然后再重新安装cocoapod，最后走一次pod setup就可以。

最后感谢网上朋友提供的资料，以下是他的博文
cocoaPods的安装和使用