CocoaPods安装步骤详解 - 2024
引言
CocoaPods的安装，如果有VPN就一直开启，会让整个流程非常顺畅。
在现代 iOS 开发中，依赖管理变得越来越重要，CocoaPods 成为开发者们首选的依赖管理工具。它不仅可以简化库的安装与更新，还能帮助开发者更高效地管理项目中的第三方依赖。在这篇博客中，我们将详细介绍如何配置 CocoaPods 环境，从安装 CocoaPods 到创建和管理 Podfile，再到安装和更新库，确保你能顺利地将 CocoaPods 集成到你的 iOS 项目中。无论你是 iOS 开发的新手还是经验丰富的开发者，了解 CocoaPods 的使用都将为你的开发流程带来便利。
一. 安装Xcode
首先需要从App Store下载Xcode开发工具，这一步非常简单，直接从苹果商店下载即可。
二. 安装Homebrew
在Mac上安装Homebrew的步骤非常简单。只需要在终端中运行以下命令即可：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
这条命令会下载Homebrew的安装脚本并执行它。安装过程中可能会要求你输入密码，并且会将Homebrew安装到/user/local目录下。
安装完成后，我们可以通过运行以下命令来验证Homebrew是否安装成功：
brew doctor
如果Homebrew安装成功，brew doctor命令会输出一些信息，告诉你Homebrew当前的状态，并检查潜在问题。如果一切顺利，你应该会看到“Your system is ready to brew.”的消息。
三. 安装Ruby
CocoaPods就是用Ruby编写的，因此我们需要安装Ruby，通常Mac电脑会自带Ruby我们可以使用ruby -v来查看ruby版本。
wangguosong@wangguosongdeMacBook-Pro-2 ~ % ruby -v
ruby 2.6.10p210 (2022-04-12 revision 67958) [universal.arm64e-darwin24]通常系统自带的Ruby版本会相对较低，不足以支持安装Cocoapods，如果我们之间安装可能会收到以下错误：
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.
四. 安装RVM
有些教程会引导大家使用RVM来安装或者升级Ruby，需要执行下面三行命令：
curl -L get.rvm.io | bash -s stable
source ~/.bashrc
source ~/.bash_profile安装成功后我们会收到下面的提示，表示安装成功：
安装成功后执行命令查看，rvm版本：
wangguosong@wangguosongdeMacBook-Pro-2 ~ % rvm -v
rvm 1.29.12 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io]查看可使用的ruby版本：
wangguosong@wangguosongdeMacBook-Pro-2 ~ % rvm list known
# MRI Rubies
[ruby-]1.8.6[-p420]
[ruby-]1.8.7[-head] # security released on head
[ruby-]1.9.1[-p431]
[ruby-]1.9.2[-p330]
[ruby-]1.9.3[-p551]
[ruby-]2.0.0[-p648]
[ruby-]2.1[.10]
[ruby-]2.2[.10]
[ruby-]2.3[.8]
[ruby-]2.4[.10]
[ruby-]2.5[.8]
[ruby-]2.6[.6]
[ruby-]2.7[.2]
[ruby-]3[.0.0]
ruby-head
五. 将Ruby更新到指定版本
执行命令安装指定版本的Ruby：
rvm install ruby-3.3.1如果成功则直接设置ruby的默认版本：
rvm use 3.3.1 --default六. 安装rbenv&ruby-build（代替RVM）
如果执行第五步遇到问题，反复出现@openssl@1.1的问题：
Error running 'requirements_osx_brew_libs_install autoconf automake libtool pkg-config coreutils libyaml libksba readline zlib openssl@1.1',
please read /Users/wangguosong/.rvm/log/1730338821_ruby-4.0.0/package_install_autoconf_automake_libtool_pkg-config_coreutils_libyaml_libksba_readline_zlib_openssl@1.1.log
Requirements installation failed with status: 1.
建议使用rbenv和ruby-build来代替RVM。
1. 首先安装 openssl@3:
brew install openssl@32. 安装rbenv和ruby-build：
brew install rbenv ruby-build
3. 设置rbenv环境并重启Shell：
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(rbenv init -)"' >> ~/.zshrc
source ~/.zshrc
4. 安装Ruby3.3.1并指定openssl@3：
RUBY_CONFIGURE_OPTS="--with-openssl-dir=/opt/homebrew/opt/openssl@3" rbenv install 3.3.1
5. 切换到新的Ruby版本：
rbenv global 3.3.1
之后我们就可以使用rbenv来管理Ruby版本。
七. 更换源
首先查看Ruby镜像的当前内容：
wangguosong@wangguosongdeMacBook-Pro-2 ~ % gem sources -l
*** CURRENT SOURCES ***
https://gems.ruby-china.com/如果不是ruby-china则执行下面代码删除源镜像并添加新镜像，再次验证：
gem sources --remove https://rubygems.org/gem sources --add https://gems.ruby-china.com/wangguosong@wangguosongdeMacBook-Pro-2 ~ % gem sources -l
*** CURRENT SOURCES ***
https://gems.ruby-china.com/八. 安装CocoaPods
执行命令安装CocoaPods到指定目录，过程中需要输入电脑密码：
wangguosong@wangguosongdeMacBook-Pro-2 ~ % sudo gem install -n /usr/local/bin cocoapods
Password:
Fetching rexml-3.3.9.gem
Fetching nanaimo-0.4.0.gem
....如果安装了多个Xcode需要使用下面命令选择
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer九. 安装本地库
到上一步为止，其实我们已经可以正常使用Cocoapods了，但是为了方便起见通常我们会安装一份pods仓库到本地。
原来安装本地库的方法为pod setup，但先执行该命令会直接提示“Setup completed”：
wangguosong@wangguosongdeMacBook-Pro-2 ~ % pod setup
Setup completed新的方法直接克隆仓库到本地目录：
git clone https://github.com/CocoaPods/Specs.git ~/.cocoapods/repos/trunk对于没有VPN的同学可以使用国内镜像：
git clone https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git ~/.cocoapods/repos/trunk十. 使用CocoaPods
接下来我们只需要在已经创建好Profile文件的项目中执行 pod update，或者pod install:
wangguosong@wangguosongdeMacBook-Pro-2 MeMe % ls
MeMe MeMeTests Podfile.lock
MeMe.xcodeproj MeMeUITests Pods
MeMe.xcworkspace Podfile Profile
wangguosong@wangguosongdeMacBook-Pro-2 MeMe % pod update
Update all pods
Updating local specs repositories
Analyzing dependencies
Downloading dependencies
Installing MJRefresh (3.7.9)
Generating Pods project
Integrating client project
Pod installation complete! There are 2 dependencies from the Podfile and 2 total pods installed.
结语
CocoaPods的安装步骤很多，如果一切顺利很快就会安装完成，但对于新手或者不熟悉的同学可能会花费一天甚至更多的时间，本篇博客总结了CocoaPods安装的详细步骤以及遇到问题的解决方案，希望能够帮助大家顺利安装CocoaPods开启iOS编程之旅。如果在使用中有任何问题，也可以通过博客联系到我嗷。