引言
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@3
2. 安装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编程之旅。如果在使用中有任何问题,也可以通过博客联系到我嗷。