一直觉得自己写的不是技术，而是情怀，一个个的教程是自己这一路走来的痕迹。靠专业技能的成功是最具可复制性的，希望我的这条路能让你们少走弯路，希望我能帮你们抹去知识的蒙尘，希望我能帮你们理清知识的脉络，希望未来技术之巅上有你们也有我。

手把手教你安装cocoapod视频教程

安装步骤：经过我多次的安装 做完下面的9步就能完成。不行网络问题或者电脑问题。

安装(Homebrew命令安装) 极力推荐

2024.06.15使用该方法安装成功

步骤一：打开隐藏文件夹

打开电脑的隐藏文件（需要重启文件夹才能看到）

defaults write com.apple.Finder AppleShowAllFiles YES;KillAll Finder

或者快捷键 com + shift + . 效果是一样的，按一次就显示，再按一次就隐藏

步骤二：安装homebrew

参考安装homebrew的连接先安装homebrew： mac 安装HomeBrew(100%成功)，使用方式一安装，不用 FQ 安装都能成功

步骤三：检测rudy的源

2.查看源(目的:检测rudy的源) gem sources -l

步骤四：移除rudy自带的源

3.移除源(目的:移除rudy自带的源) gem sources --remove https://rubygems.org/

步骤五：替换成国内的源

4.更换源(目的:替换成国内的源) gem sources --add https://gems.ruby-china.com/

步骤六：检测是否替换成功

5.查看是否更新成功(目的:检测是否替换成功) gem sources -l

步骤七：安装cocoapod

安装命令

brew install cocoapods

然后执行
用于初始化 CocoaPods 本地规范存储库，并更新到最新版本。这个命令通常在你第一次使用 CocoaPods 时运行，以确保你拥有最新的库规范

pod setup

步骤八：安装本地库(目的:下载pod第三方索引文件) - repos

2024.6.15日买了台新电脑，使用下面的命令安装失败，可能是电脑的问题，最后把云端网盘的repos文件拖拽过来，使用命令pod repo update --verbose更新一下就可以了
在这里插入图片描述

2025.02.10 安装包错：链接不上服务器之类的，终端FQ就解决了

git clone https://github.com/CocoaPods/Specs.git ~/.cocoapods/repos/master

FQ跟不FQ去下载都失败的话，就使用下面的方法，去找自己的同事，把repos文件拖拽过来，然后使用下面的命令更新本地的库就可以了

pod repo update --verbose

最好自己备份一下repos文件，放到云端网盘里面，用到下载下来直接放进去就可以了。
在这里插入图片描述
注意：如果出现下面的报错情况，重复操作命令按多几次就好了

fatal: unable to access ‘https://github.com/CocoaPods/Specs.git/’: Failed sending data to the peer（致命：无法访问“https://github.com/CocoaPods/Specs.git/”：无法向对等方发送数据）

在这里插入图片描述

步骤九：搜索第三方

感觉搜索不出名的第三方会快一点

pod search Alamofire

pod search YYKit

pod search MJRefresh

pod search Masonry

pod search JSONModel

pod search MJExtension

pod search SwiftyJSON

pod search SDWebImage

pod search Kingfisher

pod search AFNetworking

2024.10.23遇到的问题:
openssl@3.rb安装失败

Error: cocoapods: Failed to download resource "openssl@3.rb"
Download failed: https://raw.githubusercontent.com/Homebrew/homebrew-core/f8911b4fba10df05d93ad9578a4710400082fe05/Formula/o/openssl@3.rb

原因是https://raw.githubusercontent.com/Homebrew/homebrew-core/f8911b4fba10df05d93ad9578a4710400082fe05/Formula/o/openssl@3.rb无法访问,原因是安装cocoapod的时候没有把国外的源https://rubygems.org/切换到国内的源https://gems.ruby-china.com/.这个地址确实是无法访问的,切换之后,安装可能还要把rudy3.0版本以上,系统默认是rudy2.6.安装rudy需要用homebrew,然后配置环境切换到rudy3.0,在去安装cocoapod就没有问题了,之前我写过一篇文章如何切换mac 教程 ruby的安装，升级，替换, ruby@3.3, 配置ruby, ruby@2.6切换到ruby@3.3

安装 (Gem命令安装) 不推荐

不推荐是因为他是使用系统自带的rudy，系统的rudy不好升级，还是要安装homebrew再安装rudy，然后把系统的rudy切换成自己安装rudy(我之前写过教程切换rudy) mac 教程 ruby的安装，升级，替换 ，替换就是该方法替换，但是我没有使用过替换rudy的方式来解决rudy不好升级的问题，我之前一直用Gem命令安装cocoapod使用的时候，过一段时间就提示cocoapod需要升级，rudy就要升级，然后发现系统自带的rudy不好升级，导致一系列的问题，后来才改为上面的homebrew安装cocoapod，Gem命令安装的方法我只是用来记录这个安装过程

步骤零：打开隐藏文件夹

0.打开电脑的隐藏文件defaults write com.apple.Finder AppleShowAllFiles YES;KillAll Finder（需要重启文件夹才能看到）

步骤一：查看ruby版本

1.首先查看ruby的版本(目的:检测是否安装,因为pod是基于rudy安装的) ruby -v

步骤二：检测rudy的源

2.查看源(目的:检测rudy的源) gem sources -l

步骤三：移除rudy自带的源

3.移除源(目的:移除rudy自带的源) gem sources --remove https://rubygems.org/

步骤四：替换成国内的源

4.更换源(目的:替换成国内的源) gem sources --add https://gems.ruby-china.com/

步骤五：检测是否替换成功

5.查看是否更新成功(目的:检测是否替换成功) gem sources -l

步骤六：安装cocoapod

6.安装cocoapod(目的:安装pod) sudo gem install -n /usr/local/bin cocoapods

第6部常见的问题：
第一：系统自带的ruby版本过低，2024.4.13，当时ruby 2.6.10p210 (2022-04-12 revision 67958)版本.需要升级2.7才能下载cocoapod，但是在网上无法查到那个命令能升级系统自带的ruby版本。所以只能在2.6的基础上升级drb和activesupport
下面的两个报错就是升级上面两个drb和activesupport。

ERROR: Error installing cocoapods: The last version of drb (>= 0) to support your Ruby & RubyGems was 2.0.6. Try installing it with gem install drb -v 2.0.6 and then running the current command again drb requires Ruby version >= 2.7.0. The current ruby version is 2.6.10.210.

sudo gem install drb -v 2.0.6

ERROR: While executing gem ... (Gem::FilePermissionError) You don't have write permissions for the /Library/Ruby/Gems/2.6.0 directory. admin@admins-Mac-mini ~ % sudo gem install activesupport -v 6.1.7.7

sudo gem install activesupport -v 6.1.7.7

在这里插入图片描述

步骤七：下载第三方本地库

7.安装本地库(目的:下载pod第三方索引文件) git clone https://github.com/CocoaPods/Specs.git ~/.cocoapods/repos/master

第7步常见问题：
第一：看人品

看人品

在这里插入图片描述
第二：无法连接
在这里插入图片描述

可以打开下载库的文件路径，叫同事复制他的文件过来，然后自己pod update 一下就可以了。

安装路径地址：/Users/fenghanxu(用户名文件夹名称)/.cocoapods/repos
在这里插入图片描述
有空自己备份一下到百度网盘：下次自己下载替换就可以了。
在这里插入图片描述

步骤八：搜索第三方

8.搜索一下 pod search AFNetworking

按q退出

安装完成

第三：没有安装xcode
请添加图片描述

如果是全新的电脑按照上面的步骤安装一般都不会有问题的,但有些电脑可能可能安装下来的系统是旧版本, 系统自带的ruby也是旧版本, 安装cocoapod新版兼容旧版的ruby,所以出现一系列的问题,这个时候建议,先安装homebrew, 使用homebrew安装cocoapod.homebrew我的文章有另外的教程100%成功.

所需工具的安装路径

CocoaPods: /usr/local/bin/pod
在这里插入图片描述
Ruby(红宝石):系统自带 /usr/bin/ruby

2022之后苹果安装的系统不带rudy,需要自行下载

在这里插入图片描述
CocoaPods库:``/Users/fenghanxu/.cocoapods/repos
在这里插入图片描述

RVM(Ruby Version Manager):非必要安装
在这里插入图片描述

Homebrew:非必要安装
终端输入 brew --prefix查看地址,已经安装回输出/usr/local
请添加图片描述

工具说明：

CocoaPods:是一个用于管理 iOS 和 macOS 项目中第三方库依赖关系的工具。它需要使用 Ruby 来运行，因此你需要确保在你的系统上安装了适当的 Ruby 版本。

Ruby(红宝石): Rudy是一个流行的HTTP代理工具,系统自带(2022年后安装的苹果系统不自带rudy),为了支持一些系统工具和任务而预先安装的,路径 : /usr/bin/ruby 安装cocoapod前必须先安装ruby红宝石

RVM(Ruby Version Manager):RVM 是一个 Ruby 版本管理工具，它允许你在同一台计算机上安装多个不同版本的 Ruby，并且可以在这些版本之间进行切换。RVM是用来方便管理红宝石ruby工具的,要管理ruby工具不一定只要RVM,还有Homebrew (所以安装CocoaPods不一定需要安装RVM,也不一定要用Homebrew,mac系统自带的ruby既不是RVM和Homebrew下安装的,只是方便管理)

Homebrew:方便地安装和管理许多开发工具，包括 CocoaPods。也就是说安装CocoaPods可以使用Ruby的命令来安装(前提是安装了ruby),也可以使用Homebrew的命令来安装,这个时候就需要安装Homebrew.所以有时候搜索安装CocoaPods各有不同的安装方法:例如:使用Homebrew安装的命令如下:

1.安装 Homebrew：如果你还没有安装 Homebrew，可以在终端中运行以下命令来安装 Homebrew：安装不成功最好需要科学上网

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

2.安装 CocoaPods：一旦安装了 Homebrew，你可以使用以下命令来安装 CocoaPods：

brew install cocoapods

命令 - pod

更新本地的cocoapod库

pod repo update

只安装第三方,不更新仓库

pod install --no-repo-update

查看cocoapod版本(检测cocoapod是否安装)

pod --version

在这里插入图片描述

更新cocoapod的执行版本(sudo 最高权限)

sudo gem install cocoapods -v 1.13.0

在这里插入图片描述

删除 卸载 cocoapod

1.卸载cocoapod

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

2.删除cocoapod的依赖库

gem list --local | grep cocoapods

请添加图片描述

3.遍历删除依赖库

for i in $( gem list --local --no-version | grep cocoapods );
do
sudo gem uninstall $i;
done

请添加图片描述

4.输入密码: ********

在这里插入图片描述

更新第三方但跳过更新本地 pod spec 仓库

你只想更新 DOUAudioStreamer 这个库到它在 Podfile 中约束条件下的最新版本，但跳过更新本地 pod spec 仓库，并且显示详细日志信息，便于调试或查看完整过程

pod update DOUAudioStreamer --verbose --no-repo-update

命令 - HomeBrew

查看HomeBrew版本和检测是否安装

brew -v

HomeBrew安装

如果你还没有安装 Homebrew，可以在终端中运行以下命令来安装 Homebrew：安装终端确保FQ,因为下面使用国外的原

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

如果不行就使用国内的源(100%成功)
mac 安装HomeBrew(100%成功)

更新brew版本：

brew update

查找homebrew的安装路径

which brew

在这里插入图片描述
在这里插入图片描述

Homebrew帮助信息：

brew -h

看Homebrew命令：

brew help

命令 - Rudy

查看Rudy安装路径

gem environment

请添加图片描述
请添加图片描述

遇到的问题

1.网络问题：有梯子最好，不然看人品

在这里插入图片描述
解决办法：网络问题，如果有梯子就很好解决，如果没有梯子就 不停pod install 直到下载完为止。
问题解决

2.[!] CocoaPods was not able to update the master repo. If this is an unexpected issue and persists you can inspect it running pod repo update --verbose

2022.04.01
在这里插入图片描述
这个bug的由来：
当时同事说我的 pod ‘RealmSwift’ 本地太低的。
太低的原因是本地的pod库里面的RealmSwift版本是10.24.2，同事的是10.25.0的。所以我需要更新一下本地的pod库，更新到10.25.0，命令是pod repo update。
在这里插入图片描述
需要我用 pod repo update 更新一下，结果终端输入命令之后就产生这个问题。
产生这个原因：
1.网络问题
2.cocoapod版本太低。
当时我用 pod update --verbose --no-repo-update 看到pod版本
在这里插入图片描述
解决办法：我当时安装的时候由于没有梯子，用的是国内的源，现在有梯子了，把它切换成原本(国外)的源。下面是操作步骤。

gem sources -l

//查看源头，显示的是https://gems.ruby-china.org/

gem sources --remove https://gems.ruby-china.org/

//删掉现有的

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

//加入原版的

gem sources -l

//查看源头，显示的是https://rubygems.org/

pod --version

//查看cocoapods版本 返回1.1.1

gem update cocoapods

pod --version

// 查看cocoapods版本返回1.3.1

cd   到ios的项目里面

pod update --verbose

在项目的 podFile 所在的目录下更新 pod，成功了
在这里插入图片描述

获取打开sourceThree就能够看到数据的变化
在这里插入图片描述问题解决

3.Failed to extract git version from git --version (“xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun\n”) (RuntimeError)

在这里插入图片描述
解决办法:
输入

git --version

输入之后返回下面红色方框的内容,说明没有安装 Xcode 命令行工具
在这里插入图片描述
安装 Xcode 命令行工具

xcode-select --install

请添加图片描述
请添加图片描述
问题解决.

4.error: RPc failed; curl 92 HTTP/2 stream 5 was not closed cleanly: CANCEL (err 8)

使用下面的命令安装包错：

git clone https://github.com/CocoaPods/Specs.git ~/.cocoapods/repos/master

包错内容
在这里插入图片描述
2024.6.15日买了台新电脑，使用命令安装本地库(目的:下载pod第三方索引文件) - repos 失败，上网查过很多资料，都说可能是电脑的问题，最后把云端网盘的repos文件拖拽过来，使用命令pod repo update --verbose更新一下就解决问题了。

搜索一下 pod search AFNetworking成功了

2024.06.21 来到新公司用一台全新的mac，用同样的命令安装cocoapod索引库，网络顺畅的很，一装就成功了，所以证明是网络的问题

5.安装cocoapods失败(该问题已经解决系统ruby2.6的问题,升级drb和activesupport上面有答案)

出现该问题使用gem系统自带的rudy下载，上面gem安装有解决办法，使用两个命令安装打个补丁就解决了

就算解决，但是不推荐使用gem安装，现在用homebrew安装也没有问题

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

2024.3.8。使用旧系统13.6.4。 系统自带的rudy。 安装cocoapod失败,可能是系统旧的原因.因为在23年安装过,完全一样的药方都没有问题的.

fenghanxu@MacBook-Pro-Naxos ~ % sudo gem install -n /usr/local/bin cocoapods

Password:
Fetching i18n-1.14.4.gem
Building native extensions. This could take a while...
ERROR:  Error installing cocoapods:
	ERROR: Failed to build gem native extension.

    current directory: /Library/Ruby/Gems/2.6.0/gems/ffi-1.16.3/ext/ffi_c
/System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/bin/ruby -I /System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0 -r ./siteconf20240308-2520-1csh8t2.rb extconf.rb
checking for ffi.h... *** extconf.rb failed ***
Could not create Makefile due to some reason, probably lack of necessary
libraries and/or headers.  Check the mkmf.log file for more details.  You may
need configuration options.

Provided configuration options:
	--with-opt-dir
	--without-opt-dir
	--with-opt-include
	--without-opt-include=${opt-dir}/include
	--with-opt-lib
	--without-opt-lib=${opt-dir}/lib
	--with-make-prog
	--without-make-prog
	--srcdir=.
	--curdir
	--ruby=/System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/bin/$(RUBY_BASE_NAME)
	--with-ffi_c-dir
	--without-ffi_c-dir
	--with-ffi_c-include
	--without-ffi_c-include=${ffi_c-dir}/include
	--with-ffi_c-lib
	--without-ffi_c-lib=${ffi_c-dir}/lib
	--enable-debug
	--disable-debug
	--enable-system-libffi
	--disable-system-libffi
	--with-libffi-config
	--without-libffi-config
	--with-pkg-config
	--without-pkg-config
/System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/mkmf.rb:467:in `try_do': The compiler failed to generate an executable file. (RuntimeError)
You have to install development tools first.
	from /System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/mkmf.rb:585:in `block in try_compile'
	from /System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/mkmf.rb:534:in `with_werror'
	from /System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/mkmf.rb:585:in `try_compile'
	from /System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/mkmf.rb:1109:in `block in have_header'
	from /System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/mkmf.rb:959:in `block in checking_for'
	from /System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/mkmf.rb:361:in `block (2 levels) in postpone'
	from /System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/mkmf.rb:331:in `open'
	from /System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/mkmf.rb:361:in `block in postpone'
	from /System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/mkmf.rb:331:in `open'
	from /System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/mkmf.rb:357:in `postpone'
	from /System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/mkmf.rb:958:in `checking_for'
	from /System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/mkmf.rb:1108:in `have_header'
	from extconf.rb:10:in `system_libffi_usable?'
	from extconf.rb:46:in `<main>'

To see why this extension failed to compile, please check the mkmf.log which can be found here:

  /Library/Ruby/Gems/2.6.0/extensions/universal-darwin-22/2.6.0/ffi-1.16.3/mkmf.log

extconf failed, exit code 1

Gem files will remain installed in /Library/Ruby/Gems/2.6.0/gems/ffi-1.16.3 for inspection.
Results logged to /Library/Ruby/Gems/2.6.0/extensions/universal-darwin-22/2.6.0/ffi-1.16.3/gem_make.out

6.error: RPC failed; curl 55 Failed sending data to the peer

在这里插入图片描述
无论重复使用 pod install命令安装N次都无法成功，原因是安装CocoaLumberjack需要用到外 网，终端FQ就可以下载成功了，我之前写过一篇文章：https://blog.csdn.net/weixin_38716347/article/details/138206748该如何做。

在这里插入图片描述

7.无法安装最新的第三方版本

2024.4.22 项目下载 pod 'Alamofire', 最高版本失败的问题

请添加图片描述
请添加图片描述
请添加图片描述
说明项目的工程有问题，应该注释也是没有问题能下载下来，就是因为9.0的问题，控制了下载第三方的最高版本，如果注释了，应该默认下载最高版本,最后确实新建的工程有问题,看下面新建工程的过程
请添加图片描述
请添加图片描述

另外提一下，当时以为下来不了最新的版本是因为本地的repo库太旧，需要更新索引，所以使用。pod repo update --verbose 进行更新
请添加图片描述

未解决问题

1.使用homebrew安装ruby失败

2024.6.15因为使用homebrew安装cocoapod成功了，所以安装不了rudy也无所谓，目前这个问题，解决不了也无所谓

在这里插入图片描述

fenghanxu@MacBook-Pro-Naxos ~ % brew install ruby

==> Downloading https://ghcr.io/v2/homebrew/portable-ruby/portable-ruby/blobs/sha256:02180ca8b8295422ae84921bcf034b7ee8ce5575488bd5e6a37a192e53cd5d34
Already downloaded: /Users/fenghanxu/Library/Caches/Homebrew/portable-ruby-3.1.4.el_capitan.bottle.tar.gz
Error: Checksum mismatch.
Expected: 02180ca8b8295422ae84921bcf034b7ee8ce5575488bd5e6a37a192e53cd5d34
  Actual: 80b813a26d9fff8f933c5dadfb78d5c714d35a28d3f0c229db3b21fb246e9115
 Archive: /Users/fenghanxu/Library/Caches/Homebrew/portable-ruby-3.1.4.el_capitan.bottle.tar.gz
To retry an incomplete download, remove the file above.
Error: Failed to install Homebrew Portable Ruby (and your system version is too old)!

无法安装 Homebrew Portable Ruby（并且您的系统版本太旧）
当时2024.03.08最新系统是macOS 15 我新装的系统是。13.6.4 使用 brew install ruby命令 ,可能电脑的旧系统已经无法更新,最新的rudy.但我当时记得2023年的时候用系统自带的rudy,然后安装cocoapod是没有问题

# objective-c # swift # ios # xcode
Logo
AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

cover

上海AI实验室 Intern Lumina U2 上线 AtomGit AI，昇腾千卡训练提效 1.85 倍

avatar AtomGit开源社区
cover

本周 G-Star 开源项目推荐

avatar AtomGit开源社区
cover

逾百高校火热竞逐中国电信星辰杯算子开发挑战赛‌，赛事奖金追加热度持续攀升

avatar AtomGit开源社区