定义
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以上
一、安装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
,依次下载解决即可。
-
- Error: No such file or directory @ rb_sysopen:(这种情况时brew拉取不到对应依赖模块,
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:$PATHfi
apple芯片:
if [ -d "/opt/homebrew/opt/ruby/bin" ]; then export PATH=/opt/homebrew/opt/ruby/bin:$PATH export PATH=`gem environment gemdir`/bin:$PATHfi
三、安装cocospods
brew安装Cocoapods:brew install cocoapods
检查Cocoapods是否安装成功:pod --version
如果当前系统时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
来源地址:https://blog.csdn.net/weixin_43865875/article/details/129766711