前置了解

定义

CocoaPods：是 Swift 和 Objective-C Cocoa 项目的依赖管理器。它拥有超过 93,000 个库，用于超过 300 万个应用程序。CocoaPods 可以帮助您优雅地扩展项目。
Ruby ：一种简单快捷的面向对象（面向对象程序设计）脚本语言，macOS默认安装了Ruby，但是版本不是最新的，CocoaPods基于Ruby语言编写而成。
Homebrew ：是 macOS 的套件管理工具，是高效下载软件的一种方法。通俗地说，Homebrew 是类似于 Mac App Store 的一个软件商店。

首先明确几个点

安装pods需要依赖 ruby 环境；mac系统有自带的ruby环境，但是macOS12以上的会出现如下情况，提示版本不匹配

（ERROR:  Error installing cocoapods:
        The last version of activesupport (>= 5.0, < 8) to support your Ruby & RubyGems was 6.1.7.3. Try installing it with gem install activesupport -v 6.1.7.3 and then running the current command again
        activesupport requires Ruby version >= 2.7.0. The current ruby version is 2.6.8.205.）

但是我们可以使用brew来安装ruby，并替代系统的ruby版本，因此需要安装brew。
至此，我们可以明确了macOS12以上安装顺序：Homebrew --> ruby -> cocoapods

安装前准备

系统偏好设置查看硬件类型：
1.芯片类型：intel 或 macOS（m1/m2…）
2.mac系统的版本：主要区分macOS12和macOS12以上

系统为macOS12以上

一、安装homebrew

首先打开终端检查是否安装了homebrew：brew -v，也可以通过brew list查看已经安装够的依赖
如果没有输出对应的版本号或者模块内容，说明未安装
安装指引：mac安装homebrew

二、安装ruby

查看ruby源：gem sources -l
默认情况下的ruby源：https://rubygems.org/，但是一般情况下，在国内没有使用vpn等是用不了的
所以我们先移除掉默认的ruby源：gem sources --remove https://rubygems.org/
然后在添加国内可用ruby源：gem source -a https://gems.ruby-china.com/
紧接着就可以来安装ruby：brew install ruby
这里补充下安装过程中遇到的几个坑（欢迎留言补充交流）：
- Error: No such file or directory @ rb_sysopen：（这种情况时brew拉取不到对应依赖模块，
  - 第一种方法可以尝试更换brew的镜像，
  - 另一种方法是可以直接根据报错信息，单独下载模块：
    
    例如报错信息如下，表示node模块拉取失败，那么可以直接先单独下载node模块：brew install node@16，然后在执行brew install ruby，依次下载解决即可。

ruby下载完成之后，需要配置相关环境Path，使Brew安装的Ruby调用优先于系统的Ruby
通过打印的日志也明确告诉我们需要对环境进行一次配置，替换ruby使用版本
在这里插入图片描述

通过命令校验ruby -v，也可以发现版本还没更新，当前默认使用的还是系统的ruby版本
在这里插入图片描述

这时按照指引只需要修改下环境变量配置即可：
重新打开终端输入：export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc

记录坑点（以上语句执行失败时排查）

情况1:如果提示~/.zshrc文件查找不到

解决方式：切换配置到 ~/.bash_profile文件 echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.bash_profile
.bash_profile和.zshrc的区别
排查处理情况2方式：直接前往文件 ~/.zshrc，打开编辑添加如下配置内容

intel芯片：

if [ -d "/usr/local/opt/ruby/bin" ]; then
  export PATH=/usr/local/opt/ruby/bin:$PATH
  export PATH=`gem environment gemdir`/bin:$PATH
fi

apple芯片：

if [ -d "/opt/homebrew/opt/ruby/bin" ]; then
  export PATH=/opt/homebrew/opt/ruby/bin:$PATH
  export PATH=`gem environment gemdir`/bin:$PATH
fi

三、安装cocospods

brew安装Cocoapods：brew install cocoapods
检查Cocoapods是否安装成功：pod --version
在这里插入图片描述

系统为macOS12以下

如果当前系统时mocOS12以下的，可以不更新ruby版本直接使用默认的版本，但是不建议使用，具体看需求，下面也介绍下cocospod的安装

查看ruby源：gem sources -l
移除掉默认的ruby源：gem sources --remove https://rubygems.org/
添加国内可用ruby源：gem source -a https://gems.ruby-china.com/
更新： sudo gem updates —system
使用gem下载cocospods：sudo gem install cocoapods

mac安装cocoapods（新旧版本系统）