一、 概要
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
#安装rvm出现的坑报SSL_ERROR_SYSCALL in connection to raw.githubusercontent.com:443，请使用国内的homebrew后重新走上一步安装rvm。
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
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
#如果pod setup的时候，提示pod: command not found
$ sudo gem install -n /usr/local/bin cocoapods /
$ sudo chmod +rx /usr/local/bin
#setup结束后，Unable to find a pod with name, author, summary, or description matching `afnetworking`
$ pod repo remove master
$ cd ~/.cocoapods/repos
$ git clone --depth 1 https://github.com/CocoaPods/Specs.git master
$ rm ~/Library/Caches/CocoaPods/search_index.json
$ pod search afnetworking
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)
安装 oh my zsh
// 习惯使用oh my zsh，方便知道成功或失败状态
$ sh -c "$(curl -fsSL https://raw.github.com/robbyrussell/oh-my-zsh/master/tools/install.sh)"
第四，常见的安装错误
- 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) pullon repomaster.
解决方法：
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就可以。
- /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
开始一直报错Failed to connect to raw.githubusercontent.com port 443: Connection refused error: Error: 7
#重装command line tools，再执行安装homebrew指令
removing the old tools ($ rm -rf /Library/Developer/CommandLineTools)
install xcode command line tools again ($ xcode-select --install).
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
- pod install提示找不到.cocoapods文件夹
#注意xxx为本机用户名
pod repo add /Users/xxx/.cocoapods/repos
- 安装rvm出现的坑报SSL_ERROR_SYSCALL in connection to raw.githubusercontent.com:443
通过以下IP 查询工具查询IP地址，然后我们需要在系统 hosts 文件中添加关联的 ip 地址即可。具体请参考该链接
https://www.ipaddress.com/
