CocoaPods安装步骤详解 - 2024

引言

CocoaPods的安装，如果有VPN就一直开启，会让整个流程非常顺畅。

在现代 iOS 开发中，依赖管理变得越来越重要，CocoaPods 成为开发者们首选的依赖管理工具。它不仅可以简化库的安装与更新，还能帮助开发者更高效地管理项目中的第三方依赖。在这篇博客中，我们将详细介绍如何配置 CocoaPods 环境，从安装 CocoaPods 到创建和管理 Podfile，再到安装和更新库，确保你能顺利地将 CocoaPods 集成到你的 iOS 项目中。无论你是 iOS 开发的新手还是经验丰富的开发者，了解 CocoaPods 的使用都将为你的开发流程带来便利。

一. 安装Xcode

首先需要从App Store下载Xcode开发工具，这一步非常简单，直接从苹果商店下载即可。

二. 安装Homebrew

在Mac上安装Homebrew的步骤非常简单。只需要在终端中运行以下命令即可：

bash 复制代码

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

这条命令会下载Homebrew的安装脚本并执行它。安装过程中可能会要求你输入密码，并且会将Homebrew安装到/user/local目录下。

安装完成后，我们可以通过运行以下命令来验证Homebrew是否安装成功：

bash 复制代码

brew doctor

如果Homebrew安装成功，brew doctor命令会输出一些信息，告诉你Homebrew当前的状态，并检查潜在问题。如果一切顺利，你应该会看到"Your system is ready to brew."的消息。

三. 安装Ruby

CocoaPods就是用Ruby编写的，因此我们需要安装Ruby，通常Mac电脑会自带Ruby我们可以使用ruby -v来查看ruby版本。

bash 复制代码

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，需要执行下面三行命令：

bash 复制代码

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

source ~/.bashrc

source ~/.bash_profile

安装成功后我们会收到下面的提示，表示安装成功：

安装成功后执行命令查看，rvm版本：

bash 复制代码

wangguosong@wangguosongdeMacBook-Pro-2 ~ % rvm -v 
rvm 1.29.12 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io]

查看可使用的ruby版本：

bash 复制代码

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：

bash 复制代码

rvm install ruby-3.3.1

如果成功则直接设置ruby的默认版本：

Swift 复制代码

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。

首先安装 openssl@3:

bash 复制代码

brew install openssl@3

安装rbenv和ruby-build：

Swift 复制代码

brew install rbenv ruby-build

设置rbenv环境并重启Shell：

bash 复制代码

echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(rbenv init -)"' >> ~/.zshrc
source ~/.zshrc

安装Ruby3.3.1并指定openssl@3：

bash 复制代码

RUBY_CONFIGURE_OPTS="--with-openssl-dir=/opt/homebrew/opt/openssl@3" rbenv install 3.3.1

切换到新的Ruby版本：

bash 复制代码

rbenv global 3.3.1

之后我们就可以使用rbenv来管理Ruby版本。

七. 更换源

首先查看Ruby镜像的当前内容：

bash 复制代码

wangguosong@wangguosongdeMacBook-Pro-2 ~ % gem sources -l
*** CURRENT SOURCES ***

https://gems.ruby-china.com/

如果不是ruby-china则执行下面代码删除源镜像并添加新镜像，再次验证：

bash 复制代码

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

bash 复制代码

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

bash 复制代码

wangguosong@wangguosongdeMacBook-Pro-2 ~ % gem sources -l
*** CURRENT SOURCES ***

https://gems.ruby-china.com/

八. 安装CocoaPods

执行命令安装CocoaPods到指定目录，过程中需要输入电脑密码：

bash 复制代码

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需要使用下面命令选择

Swift 复制代码

sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer

九. 安装本地库

到上一步为止，其实我们已经可以正常使用Cocoapods了，但是为了方便起见通常我们会安装一份pods仓库到本地。

原来安装本地库的方法为pod setup，但先执行该命令会直接提示"Setup completed"：

bash 复制代码

wangguosong@wangguosongdeMacBook-Pro-2 ~ % pod setup
Setup completed

新的方法直接克隆仓库到本地目录：

bash 复制代码

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

对于没有VPN的同学可以使用国内镜像：

bash 复制代码

git clone https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git  ~/.cocoapods/repos/trunk

十. 使用CocoaPods

接下来我们只需要在已经创建好Profile文件的项目中执行 pod update，或者pod install:

bash 复制代码

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编程之旅。如果在使用中有任何问题，也可以通过博客联系到我嗷。