CocoaPods详细使用步骤

最新推荐文章于 2025-09-07 02:44:01 发布

原创最新推荐文章于 2025-09-07 02:44:01 发布 · 546 阅读

本内容遵循CC 4.0 BY-SA版权协议

标签

#OC

本文介绍了CocoaPods的基本概念及其在iOS开发中的重要作用，并详细阐述了如何安装和配置CocoaPods，包括Ruby环境的设置、CocoaPods的安装步骤及注意事项。此外，还提供了在项目中集成第三方框架的具体操作流程。

在安装CocoaPods前，首先需要安装Ruby环境，因为CocoaPods和Ruby一起才能正常工作。
- Mac系统自带Ruby环境,但是可能不是最新版本,需要升级到最新版本
- 下载最新的RubyGem版本,详见 https://rubygems.org/pages/download/
  - RubyGem是Ruby的包管理框架，也叫做gem，作用是可以在你的系统上简单地下载、安装和使用Ruby软件包
- 以RubyGem的2.6.8版本为例 rubygems-2.6.8，需要提前下载

使用终端进入到已下载的 rubygems-2.6.8 文件路径

 终端命令 : cd /Users/zhangjie/Desktop/rubygems-2.6.8

安装最新的RubyGem (需要管理权限,终端命令前要加 sudo)
- 需要输入开机密码
```
终端命令 : sudo ruby setup.rb
```
查看RubyGem是否是刚刚安装的最新版本
```
终端命令 : gem -v
```
查看当前Mac系统上Ruby的源
```
 终端命令 : gem source -l
```
- 如果你们看到是 https://rubygems.org/ 或者其它的,需要先移除.然后使用新Ruby源替换.
```
*** CURRENT SOURCES ***

https://rubygems.org/
```

移除默认的Ruby源

 终端命令 : gem sources --remove https://rubygems.org/

添加新的 https://gems.ruby-china.org/ Ruby源替换默认的Ruby源
- 替换默认的Ruby源的原因 : 安装 CocoaPods 时,国内有堵墙.
```
终端命令 : gem sources --add https://gems.ruby-china.org/
```
  - 查看替换之后的Ruby源
```
终端命令 : gem source -l
```
  - 正确的Ruby源
```
*** CURRENT SOURCES ***

https://gems.ruby-china.org/
```
安装CocoaPods到客户端
- 初次安装可能需要点儿时间,所以要保证网速和耐心等待
```
终端命令 : sudo gem install -n /usr/local/bin cocoapods
```
查看CocoaPods的版本信息
- 能够得到版本信息,说明安装成功
```
终端命令 : pod --version
```
下载CocoaPods的信息
- 超过25000个第三方框架的信息,初次安装需要很长的时间,所以要保证网速和耐心等待
- CocoaPods将它的信息下载到 ~/.cocoapods 路径下
```
终端命令 : pod setup
```
下载CocoaPods的信息结束之后,搜索一个你们最熟悉的第三方框架.
- 如果可以搜索出来,说明安装已经成功了!
```
终端命令 : pod search AFNetworking
```

进入到项目目录

 终端命令 : cd /Users/zhangjie/Desktop/CocoaPods集成第三方框架演练

搜索要集成的第三方框架

 终端命令 : pod search AFNetworking

在Podfile文件中,配置想要集成的第三方框架

 # 项目最低支持的iOS操作系统版本
 platform :ios, '9.0'

 # 项目名称
 target 'CocoaPods集成第三方框架演练' do

 # 要集成的框架
 pod 'AFNetworking'
 pod 'SDWebImage'

 # 结束
 end

删除框架

删除已经集成的框架时,只需要把框架名使用#注释掉即可

# 项目最低支持的iOS操作系统版本
platform :ios, '9.0'

# 项目名称
target 'CocoaPods集成第三方框架演练' do

# 要集成的框架
pod 'AFNetworking'

# 删除已经集成的框架
# pod 'SDWebImage'

# 结束
end