在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 地址
对应的IP 地址,有4个IP,我选择第一个。
step2、替换系统的host文件 点击Finder-》顶部菜单栏“前往”-〉前往文件夹,输入 /etc/hosts
最好是将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 ***
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相关的类库:
就说明Cocoapods已经彻底安装成功了,恭喜你!🎉