Mac安装Cocoapods 绝对成功(2025.5)

提要

刚开始学习iOS开发时用到了Cocoapods,安装时踩了许多坑,现在总结一下之前的安装经验

1. 先安装Homebrew

个人建议选 阿里巴巴源

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

这样你就可以使用国内源了,再也不用痛苦了

可能遇到的问题:

安装Homebrew时总是报错(Failed to connect to raw.githubusercontent.com port 443: Connection refused)

原因:

由于某些你懂的因素,导致GitHub的raw.githubusercontent.com域名解析被污染了。

解决办法:

1.1 在 https://www.ipaddress.com/ 查询 raw.githubusercontent.com 的真实IP。

1.2 修改hosts

sudo vim /etc/hosts

添加如下内容:

199.232.28.133 raw.githubusercontent.com

199.232.28.133换成你查到的ip

2. 把Ruby官方镜像改为国内镜像

2.1 更新一下gem版本

注:这里需要科学上网

sudo gem update --system

2.2 修改镜像

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

2.3 检查一下

gem sources -l

终端显示为如下即为成功,注:确保只有 gems.ruby-china.com 才为成功

*** CURRENT SOURCES ***
https://gems.ruby-china.com/

3. 通过Homebrew安装ruby最新版

3.1 为了避免后面的步骤错误,先卸载一下ruby

brew uninstall ruby

brew cleanup

rvm uninstall ruby

rvm clean all

3.2 通过 Homebrew 安装 ruby

brew install ruby

3.4 使用以下命令查看 ruby 版本

ruby -v

如果成功安装之后使用命令查看 ruby 版本发现仍然是 Mac 自带的版本,类似如下

ruby 2.6.3p62 (2019-04-16 revision 67580) [universal.x86_64-darwin20]

3.5 此时只需把最新的 ruby 可执行文件导入全局变量 PATH 中即可,使用如下命令:

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

source ~/.zshrc

3.6 再次查看 ruby 版本

ruby -v

显示以下类似命令行即为成功

ruby 3.2.2 (2023-03-30 revision e51014f9c0) [x86_64-darwin22]

4. 用brew安装Cocoapods

4.1 可能有遗留,先卸载一下

brew uninstall cocoapods

brew cleanup

4.2 检查一下

brew list --formula | grep cocoapods

没有任何输出就表示卸载完成

4.3 安装

brew install cocoapods

4.4 安装完setup一下

pod setup

如果显示

Setup completed

Oh, yeah. 完成!

5.更新Cocoapods镜像源(可选)

5.1 移除原镜像源

pod repo remove master

5.2 添加国内镜像源

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

5.3 更新镜像源

pod repo update

最后

如果我的文章对你有帮助,麻烦你点一下左边的赞。如果你有好的想法或建议都可以给我留言,我会及时回复,希望可以和你们一起进步!

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容