Cocoapods坑点

系统版本:Mac OS 12.2.1
Xcode版本:13.2.1

目前mac上的ruby版本是2.6.0,使用命令sudo gem install cocoapods或者sudo gem install -n /usr/local/bin cocoapods,直接安装cocoapods报错,ERROR: While executing gem ... (Gem::FilePermissionError)You don't have write permissions for the /System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/gems/2.6.0 directory.】

没有安装权限。

解决思路:

检查mac是否安装rvm,使用rvm安装ruby环境,更新RubyGems版本,安装Cocoapods即可。

第一步:首先要检查Mac是否安装了rvm,打开终端,输入指令rvm -v

第二步:用rvm安装ruby环境

第三步:检查更新RubyGems(Ruby1.9.1以后的版本自带RubyGems)

第四步:检查ruby源并移除

第五步:安装cocoapods(sudo表示管理员执行指令,需要输入密码的)

第六步:cocoapods集成第三方框架到项目工程里面去

RubyGems相关命令

Cocoapods相关命令

前提告知:安装cocoapods需要Ruby环境,所以,首先要检查Ruby环境的版本!!!

Mac OS X 系统自带的Ruby,但是如果不管理它,它是不会自动升级的,所以,我们需要一个Ruby版本及安装工具管理它,那是什么???

Ruby的管家婆登场--------》》RVM全称是Ruby Version Manager,是一个非常好用的Ruby版本以及安装工具。就是用来安装和控制Ruby版本的工具。

Rvm也是需要我们自己安装的,所以,别废话,开始安装~

第一步,首先要检查Mac是否安装了rvm。打开终端,输入指令
rvm -v

如果提示command not found,说明该台Mac 没有安装rvm,没有安装就安装呗~

step1:安装rvm

`curl -L get.rvm.io | bash -s stable`

step2:指定源

source ~/.rvm/scripts/rvm`

step3: 查看版本确认是否安装成功

rvm -v

step4:列出所有指定源里的ruby版本

rvm list known
第二步,用rvm安装ruby环境
注意,当ruby版本低于2.2.2时,安装cocoapods会报错,可通过指令ruby -v 检查当前版本。如果版本低于2.2.2,啥也不要说快更新一下。

输入指令:rvm install 2.4.0 ,然后根据提示按“enter”键。

安装完之后输入指令rvm list查看ruby版本,看看是否安装成功。

第三步,检查更新RubyGems(Ruby1.9.1以后的版本自带RubyGems)

RubyGems是一个方便而强大的Ruby程序包管理器,Ruby的第三方插件是用gem方式来管理,非常容易发布和共享,一个简单的命令就可以安装上第三方的扩展库。

建议RubyGems升级到2.6.X以上。

查看RubyGems的版本用指令:gem -v 得到结果。

更新RubyGems的版本指令:

gem update --system
第四步,检查ruby源并移除

先是检查ruby源

gem sources -l

如果是taobao或者https://rubygems.org/的话,执行以下命令进行移除:

gem sources --remove https://rubygems.org/

替换添加国内的镜像源,之后以要添加国内的ruby-china源,是因为taobao源已经停止维护了,所以此处替换的是ruby-chia源,且尽量确保只有一个。输入指令

注意:ruby-chia已迁移至https://gems.ruby-china.com
gem sources --add https://gems.ruby-china.com

ruby源已经是https://gems.ruby-china.com
替换完之后,再次检查gem sources -l 是否替换成功

第五步,安装cocoapods(sudo表示管理员执行指令,需要输入密码的)

安装cocoapods
注意osx 10.11之前系统的安装cocoapods指令:

sudo gem install cocoapods

osx10.11之后系统的安装cocoapods指令

sudo gem install -n /usr/local/bin cocoapods

如果有 gems installed 标志着安装成功了

到这里,cocoapods已经安装成功了!!!!

第六步,cocoapods集成第三方框架到项目工程里面去

step1:先去Xcode中创建一个项目

step2:打开终端,输入cd项目路径

step3:使用命令 pod init创建podfile文件,然后配置好你需要导入的第三方即可。

RubyGems相关命令
# 显示gem的帮助

gem –h/--help

# 显示gem的版本号

gem –v /--version

# 4.1 安装软件

gem install xxx

# 查看一个已安装的软件

gem specification XXX

# 卸载一个软件

gem uninstall XXX

# 将所有安装的软件列表

gem query --local

# 短命令: gem q -l

查看某个已安装的软件

gem query --local --name-matches XXX
Cocoapods相关命令

# 第一次使用安装框架    
# 只用安装一次,之后使用 添加删除都用 pod update --no-repo-update

pod install

# 安装框架,不更新本地索引,速度快

pod install --no-repo-update

# 今后升级、添加、删除框架,或者框架不好用

pod update

# 更新框架,不更新本地索引,速度快

pod update --no-repo-update

# 搜索框架

$ pod search XXX

帮助

$ pod --help


Ruby升级

目前mac上ruby版本是2.5的,今天进行了升级

因为我这边已经安装了brew,所以直接安装最新版本ruby

brew reinstall ruby

最新版本是ruby 3.0.0

执行完命令后,ruby -v 后其实还是原来的版本,这是因为环境变量没有配置。因此,还有一个步骤就是配置环境变量。

执行以下两步就OK了

echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profile

执行后,查看版本后,会判断已更新到最新版本。

你可能感兴趣的:(Cocoapods坑点)