iOS 项目中 CocoaPods 配置和使用

文章版本

1.0.0 初始版2018.10.12
1.0.1 初始版2020.11.16，增加可能出现的问题

Mac 版本

10.13.6

CocoaPods 说明

CocoaPods 是 Swift 和 Objective-C 的依赖项管理器。
CocaPods 是使用 Ruby 构建的。
它通过 Gem 安装，因为 Gem 是 Ruby 语言的包管理器。

CocoaPods 安装

ruby -v
sudo gem install -n /usr/local/bin cocoapods
pod --version

使用该命令「ruby -v」可查看当前使用的 Mac 上的 Ruby 版本。

现在安装 CocoaPods 需 Ruby 版本大于 2.2.2。如果自身 Mac 上的 Ruby 比这小，就需要安装对应的 Ruby 环境，可自行查找方法。
或者需要安装国内镜像的：https://gems.ruby-china.com/
如果 Ruby 版本大于 2.2.2，可直接开始安装。

输入命令「sudo gem install -n /usr/local/bin cocoapods」开始安装，在输入命令后会需要输入密码，对应输入即可。

上面命令执行完后，执行命令「pod --version」查看是否安装成功，如果出现对应的 CocoaPods 版本，成功。
如执行命令后显示：1.8.3

CocoaPods 的使用

终端 cd 到根目录

获取项目的根目录



框出的部分就是项目的根目录，双击，拷贝根目录。
打开「终端」，cd 到根目录。
例如根目录是 /Users/rx/Documents/study/ViewTest
那么，命令就是 「cd /Users/rx/Documents/study/ViewTest」

创建 Podfile 文件

然后，在该目录下创建 Podfile 文件，执行命令

pod init

命令执行成功后，可以看到，根目录出现了一个以 Podfile 命名的文件，如下图：

打开 Podfile 文件

接着，在终端输入命令「open Podfile」打开 Podfile 文件，

open Podfile

命令执行成功后，可以看到 Podfile 窗口出现，如下图

添加依赖

pod 'AFNetworking', '~> 3.0'

在 Podfile 文件中写上对应库的相关命令，例如添加 AFNetworking 库，在文件中添加命令「pod 'AFNetworking', '~> 3.0'」。其中有一些说明，如下图：

安装依赖

在 Podfile 添加完依赖后，回到终点执行命令

pod install

后续项目的打开

安装完成后，关闭当前项目，在 Finder 中去到该项目根目录，此后，都使用 「项目名.xcworkspace」（即 .xcoworkspace 为后缀的）文件打开该项目。
如下图所示：

可能存在的问题

ERROR: Error installing cocoapods:
ERROR: Failed to build gem native extension.

一个可能性：确认 Xcode 是安装完成的

---

参考链接

CocoaPods 官网
https://cocoapods.org/
CocoaPods 安装方法 - 2019.10.11
https://www.jianshu.com/p/f43b5964f582
Cocoapods 整理（一）—— 安装 Cocoapods
https://segmentfault.com/a/1190000011428874
Mac安装Ruby版本管理器RVM
https://vic.kim/2019/05/21/Mac%E5%AE%89%E8%A3%85Ruby%E7%89%88%E6%9C%AC%E7%AE%A1%E7%90%86%E5%99%A8RVM/