经得起考验的CocoaPods安装教程

**前言**
这是我个人经验的记录下来的安装cocoaPods顺序，本来是记录下来放到云笔记方便以后翻阅的，是3年前写的，这不是新型病毒疫情，公司全体在家办公，需要给给家里的新电脑按照环境。遇到了些新的问题，又改了下，发到这里，与大家分享下我的经验。
安装CocoaPods涉及三方面：CocoaPods本身、Ruby环境、Ruby管理工具。原因：
1. CocoaPods是用Ruby实现的，所以，使用CocoaPods的前提是处于Ruby环境下。
2. 需要用到Ruby管理工具来安装Ruby。管理Ruby的工具有很多，rvm就是其中一个，它提供一个便捷的多版本 Ruby 环境的管理和切换。

安装步骤

**最重要的：**
保证iOS 系统版本为最新，XCode的版本也是最新。否则会有情况不明的问题。

1. Ruby管理工具rvm的安装

首先检测rvm是否安装：

    rvm -v

安装过程：

    1. curl -L https://get.rvm.io | bash -s stable   // 安装rvm
    2. source ~/.rvm/scripts/rvm                         //载入rvm环境
    3. rvm -v ／／验证rvm是否正常安装

(    1. curl -L https://get.rvm.io | bash -s stable   // 安装rvm====>这个地址有时候会变，请到官网重新copy过来运行：RVM: Ruby Version Manager - RVM Ruby Version Manager - Documentation)

2. 安装Ruby
虽然Mac都自带Ruby，但是CocoaPods的安装需要特定版本的Ruby。而Mac自带的Ruby的版本可能不合适。选哪个版本比较好呢？一般来说，用最新版本的Ruby是最保险的。

安装过程：
1.首先，查看目前的所有Ruby版本。找到最新的版本号。

    rvm list known

2.安装最新版本的Ruby

    rvm install ruby-xx.xx(xx.xx表示版本号)

3.更改Ruby的软件源。
Ruby的软件源用的是亚马逊的云服务，访问不了。所以，在安装CocoaPods前，需要更改该软件源为我们可以访问的源。修改方式如下。

    Ruby源更改动态：
    2018.3月以前的时候，Ruby源要更改为：https://gems.ruby-china.org
    2018.3月后，Ruby源变了，要更改为：https://gems.ruby-china.com 

可以先用【gem sources -l】命令查看源是否为最新的Ruby源（目前是https://gems.ruby-china.com ） 。不是的话再按照3.1的方法把源改为最新的Buby源。

  3.1 更改Ruby源
    gem sources --remove https://rubygems.org/  (移除https://rubygems.org/下载地址)
    gem sources -a  https://gems.ruby-china.com （添加https://gems.ruby-china.org/为下载地址）
    注意：gem sources -a 后面的这个地址，要用https，而不是http
  3.2 检查更改是否成功**
    gem sources -l
    如果结果显示只有 https://ruby.taobao.org/ 这个下载地址。则表示我们的更改操作正确。

3.安装CocoaPods

1.安装CocoaPods

    sudo gem install cocoapods

2.检测安装是否正确

    which pod (which命令：查看可执行文件的位置)

3. pod setup（这个步骤，请直接看下面的Tips）

Tips： 下载速度太慢解决办法
备注：以下的（1）－（3）步骤，也可以简化为，拷贝同事的本地的/.cocoapods/repos/下的master文件，放到自己本机的/.cocoapods/repos目录下。

    (1.) 进入本机目录：
    /.cocoapods/repos
    (2.) 终端进入到目录/.cocoapods/repos，然后执行clone Specs项目的语句：  git clone https://github.com/CocoaPods/Specs.git 等待其clone完成。终端会显示有clone的进度，比直接执行po d setup更直观。
    (3. )将clone的Specs项目的文件夹改名为master，然后拖到/Users/用户名/.cocoapods/repos目录下。
    (4.) 运行 pod install --verbose --no-repo-update   或  pod setup （推荐使用pod install --verbose --no-repo-update。因为--no-repo-update参数禁止了pod setup默认执行的更新spec文件的行为）

所有的项目的 Podspec 文件都托管在https://github.com/CocoaPods/Specs。第一次执行pod setup时，CocoaPods 会将这些podspec索引文件更新到本地的 ~/.cocoapods/repos目录下，这个索引文件比较大。所以第一次更新时非常慢。
pod setup在执行时，会输出Setting up CocoaPods master repo，但是会等待比较久的时间。这步其实是 Cocoapods 在将它的信息下载到 ~/.cocoapods/repos目录下，如果你等太久，可以试着 cd 到那个目录，用du -sh *来查看下载进度。

遇到的问题

【问题1】
pod install 的时候，总是install openssl 失败。没有什么信息提示，只是有一大板的红色openssl 的配置文件信息。
【解决】
(1)用openssl-universal（修改podfile文件)。这个办法有点不好的是，有可能引入的其他库也引入了openssl。
(2)有可能是xcode不是最新版本所致(我就是这个问题，当时iOS 系统为10.1.6，xcode的版本为8--最新版本为10.13.2，xcode为9)

【问题2】
Failed to connect to raw.githubusercontent.com port 443: Connection refused
【解决】
这是由于该网址的域名解析被污染的缘故。通过修改hosts可以解决这个问题：
打开/etc/hosts 文件，添加语句：

    199.232.4.133 raw.githubusercontent.com

  【问题3】rvm install ruby-3.0.6

Error: Checksum mismatch.

Expected: 61029cec31c68a1fae1fa90fa876adf43d0becff777da793f9b5c5577f00567a

  Actual: 768234d58c98e5b5dc0e860f2e266d573db89430c6d8fdb1986b3fb84c5ee2d2

Archive: /Users/jun/Library/Caches/Homebrew/portable-ruby-2.6.10_1.el_capitan.bottle.tar.gz

To retry an incomplete download, remove the file above.

Error: Failed to upgrade Homebrew Portable Ruby!

【解决】

Checksum mismatch.说明下载的文件和期望的hashCode对不上，删掉对应的文件就行了。

参考文档

1.https://blog.csdn.net/fengsh998/article/details/52172741
2.https://www.cnblogs.com/jiang-xiao-yan/p/5229608.html

3.brew 安装出现Checksum mismatch解决方法_error: checksum mismatch._叮咚细语的博客-CSDN博客