新版 cocoapod安装、更新和使用 , 安装中出现的错误及解决方案 M1或者M2安装cocoapods

原创已于 2024-06-15 13:39:48 修改 · 4.5k 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#iOS #cocoapods #M2 #M1 #permissions

于 2016-11-28 10:51:52 首次发布

ios开发随记专栏收录该内容

66 篇文章

订阅专栏

本文提供M1/M2芯片Mac系统安装CocoaPods的详细步骤，包括设置Rosetta、更新Ruby镜像源、两种安装方案及常见问题解决方法。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

M1或者是M2系统安装cocoapods先操作一下两个设置

1、打开访达->应用->实用工具->终端->右键点击终端->显示简介->勾选使用 Rosetta 打开，关闭终端，重新打开。
2、打开访达->应用->Xcode->右键点击Xcode->显示简介->勾选使用 Rosetta 打开，关闭Xcode，重新打开。

1、mac系统已经默认安装好Ruby环境，如果你不确定自己系统中是否有Ruby的，可以在终端中输入命令行：ruby -v查看当前ruby版本

如果ruby版本较低，可以通过rvm对Ruby进行升级


$ sudo gem update --system

2、更换Ruby镜像

首先移除现有的Ruby镜像


终端输入：$ gem sources --remove https://rubygems.org/

然后添加国内最新镜像源（淘宝的Ruby镜像已经不更新了）


终端输入：$ gem sources -a https://gems.ruby-china.com/(org 暂时不能使用官方推荐使用com)

执行完毕之后输入gem sources -l来查看当前镜像


终端输入：$ gem sources -l

如果结果是
*** CURRENT SOURCES ***
https://gems.ruby-china.org/
说明添加成功，否则继续执行$ gem source -a https://gems.ruby-china.org/来添加

备注：

M系统安装ruby 等

arch -arm64 brew install xxx

3、CocoaPods的安装方案一

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

等上十几秒钟，CocoaPods就可以在你本地下载并且安装好了，不再需要其他设置。

3.CocoaPods的使用

1）CocoaPods的搜索功能

pod search AFNetworking；

执行后可能会一直停在

Setting up CocoaPods master repo然后(很久)会出现如下错误：

[!] Failed to connect to GitHub to update the CocoaPods/Specs specs repo - Please check if you are offline, or that GitHub is down

解决办法是：

这说明CocoaPods还不能正常使用，需要更新pod，下载它的一些依赖包；在终端中输入：

$ pod setup

过一段时间之后，你会在终端中看到跟上面同样的红色的错误信息。

这说明某些环境原因导致pod更新不了，可能原因有，1）gem版本太低；2）github无法链接；3）.cocoapods目录下的配置信息错误。我们可以一个一个来排除，

首先更新gem到最新版本，在终端中输入：

$ sudo gem update --system

可以只接继续进行安装：sudo gem install -n /usr/local/bin cocoapods

或者是检查是否可以ping通github，在终端中输入：

$ ping github.com

然后查看pob repo list：

$ pod repo list

说明Cocoapods在将它的信息下载到~/.cocoapods里；

cd到该目录里，用du -sh *命令来查看文件大小，结果显示0 repos，说明没有安装成功；

在终端输入：

cd ~/.cocoapods

进入cocoapods文件后在终端输入：du -sh *

重新执行pod setup，过一段时间后提示setup completed,在终端中输入pod list，展示出安装列表；

这样总算安装好了。接下来再一次输入：

pod search AFNetworking

输入过后它可能会报：

[!] Unable to find a pod with name, author, summary, or descriptionmatching `AFNetworking`

解决方案是：

输入：

rm ~/Library/Caches/CocoaPods/search_index.json

后在一次输入：pod search AFNetworking

就可以咯。

2）首先定位到项目文件目录

cd 项目位置

然后添加podfile文件：vim podfile (注：在写该文件的时候要注意格式 ' ' );

进入后按i进入插入模式，进行编辑，安装官方最新的文档格式：

platform :ios, '8.0'

target '你的项目名称' do

pod 'AFNetworking', '~> 3.0'

end

编辑完成后，按ESC退出编辑模式，最后输入:wq保存并退出文件，此时可以发现在项目目录下多了一个Podfile的文件，请注意这个文件必须与.xcodeproj在同一目录下，

最后：pod install进行安装即可

3）CocoaPods库的跳过更新安装

pod install --verbose --no-repo-update（跳过更新进行安装）

pod update --verbose --no-repo-update（跳过更新进行更新

4、CoCoapods的安装方案二

在终端中运行以下命令以安装 Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

验证 Homebrew 是否已成功安装

brew --version

安装 CocoaPods

brew install cocoapods

验证 cocoapods 是否已成功安装

pod --version

如果你是M1或者M2芯片的Mac，还需要做以下操作：

1.访达-应用程序-实用工具里，右键点击终端-显示简介（如果找不到实用工具，请以列表或分栏的方式显示项目）
2.勾选使用Rosetta打开
3.执行sudo gem install ffi

如下图提示异常

xxx ~ % sudo gem install -n /usr/local/bin cocoapods
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.10.210.