iOS开发之安装CocoaPods详细流程

150 阅读4分钟

在iOS开发中,使用Cocoapods来管理第三方库是经常用到的操作,所以在准备iOS开发之前,一般都是要安装好Cocoapods,方便以后开发过程中来直接使用Cocoapods。下边是最近在安装Cocoapods过程中所经历的详细流程:

1、Ruby:

由于Cocoapods是基于Ruby的,所以需要用到Ruby,在Mac电脑的终端中,输入以下指令,可以查看ruby的版本:

ruby -v

一般系统自带的ruby版本比较低,需要升级,而升级ruby,则需要用到ruby的管理工具rvm。

2、rvm:

在终端中输入以下指令,可以安装rvm:

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

然后,再分别输入以下每行指令,初始化rvm:

source ~/.bashrc

source ~/.bash_profile

如果报错 curl: (7) Failed to connect to raw.githubusercontent.com port 443:

解决方案:

step1、打开网址 www.ipaddress.com/ 查询一下 raw.githubusercontent.com 对应的IP 地址

截屏2025-03-04 11.01.30.png 对应的IP 地址,有4个IP,我选择第一个。

step2、替换系统的host文件 点击Finder-》顶部菜单栏“前往”-〉前往文件夹,输入 /etc/hosts

截屏2025-03-04 10.58.21.png

最好是将hosts文件拖到桌面,点击桌面上的hosts文件,一般就会以文本编辑方式打开,在文本最后一行添加以下文字:

185.199.108.133 raw.githubusercontent.com

然后command+s保存一下,再拖回到/etc/hosts文件夹下替换掉原来的hosts文件。

step3、然后再执行

curl -sSL get.rvm.io | bash -s stable

就可以成功安装rvm了。

当我们安装成功rvm后,可以验证一下,输入以下指令,查看rvm的版本号:

rvm -v

注:显示如下(或者是其他版本)

rvm 1.29.3 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [rvm.io]

ruby的官方网址为

www.ruby-lang.org/en/download…

可以详细地去查看一下相关信息

然后,可以列出ruby可安装的版本信息:

rvm list known

然后,就可以安装一个版本的ruby了,这里有一点是非常关键,最好是选择最新的3.3.6版本,如果网速稍微慢一些的时候,可能需要漫长的等待。

rvm install 3.3.6

//上面rvm list known显示的最新版本是ruby-3.0.0,但是截止到标题日期最新版是[3.3.6 稳定版]

// 注意:安装过程中需要两次按下 Enter 键, 第二次按下后需要输入电脑访问密码(不可见,只管输入就行)

// 如果你电脑没有安装Xcode和Command Line Tools for Xcode以及Homebrew 会自动下载安装(需要漫长的等待),建议提前安装这三者。

踩过的坑:

最好不要直接安装3.0.0 安装3.0.0可能报各种问题 比如

Error running '__rvm_make -j8', please read /Users/andylym/.rvm/log/1736754447_ruby-3.0.0/make.log

如果出现这个问题可以尝试

brew install openssl@3rvm install ruby-3.3.6--with-openssl-dir='brew --prefix openssl'或者rvm install ruby-3.3.6--with-openssl-dir='brew --prefix openssl@3'

注意:安装过程中需要两次按下 Enter 键, 第二次按下后需要输入电脑访问密码(不可见,只管输入就行);

然后,设置为默认版本

rvm use 3.3.6 --default

修改 shell 配置文件:

确保 RVM 脚本被正确加载到 shell 配置文件中。对于 bash 用户,可以将以下行添加到 ~/.bashrc 文件中:

[[ -s "HOME/.rvm/scripts/rvm" ]] && source "HOME/.rvm/scripts/rvm"

保存文件后,重新加载配置文件:

source ~/.bashrc

再次验证ruby版本,为最新的3.3.6

ruby -v

ruby 3.3.6 (2024-11-05 revision 75015d4c1f) [arm64-darwin24]

另外,最好是要更换一下ruby的源:

gem sources -l #查看源

gem sources --remove rubygems.org/ #移除源

gem sources --add gems.ruby-china.com/ #添加源

如果更换好后,再次查看源,会显示以下信息:

*** CURRENT SOURCES ***

gems.ruby-china.com/

3、安装Cocoapods:

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

一般等待几分钟就可以安装好了,验证cocoapods是否安装成功:

pod --version

1.16.2

然后,安装本地库:

pod setup

注意

使用sudo gem命令安装最新版的MacOS Catalina系统命令行执行pod setup命令直接结束啦;需要我们手动安装本地库命令行执行以下操作

clone CocoaPods仓库

这里使用的是清华大学fork的CocoaPods仓库

git clone mirrors.tuna.tsinghua.edu.cn/git/CocoaPo… ~/.cocoapods/repos/trunk

也可以用gitee上的一个私人fork的仓库,这个仓库比清华的速度更快,但是有可能更新不及时 git clone gitee.com/mirrors/Coc… ~/.cocoapods/repos/trunk

上面两个CocoaPods仓库选择一个clone就行了

到这里CocoaPods已经安装完成了,执行下面命令查看是否完成

pod search AFNetworking

如果能搜索到AFNetworking相关的类库:

截屏2025-03-04 10.56.24.png 就说明Cocoapods已经彻底安装成功了,恭喜你!🎉