mac安装cocoapods(新旧版本系统)

前置了解

定义

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/,但是一般情况下,在国内没有使用等是用不了的
    所以我们先移除掉默认的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使用版本
mac安装cocoapods(新旧版本系统)_第1张图片

通过命令校验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

你可能感兴趣的:(swift,macos,cocoapods,xcode)