- 网上的教程有很多,但是自己在安装和使用的过程中,总会遇到各式各样的问题。
在这里将我自己的安装与使用过程与大家分享一下。
一、介绍
- 简单的说,CocoaPods 就是一个第三方开源库的管理工具,就像 Java 的 Maven。至于它的原理,这里就不说了。(画外音:其实原理我也不知道 😂 )
- 开发中经常会用到一些第三方,使得开发简便,比如:AFNetWorking、SDWebImage、FMDB 等等。不借助工具的话,需要手动将开源库的源代码复制到项目、添加它的依赖框架、设置 -ObjC 等参数,如果有更新还要及时的手动更新。这些操作没有技术含量,而且浪费时间,还容易漏添报错。
- 使用 CocoaPods 可以避免这些繁琐的操作,只需几行命令就可以添加、移除、更新需要的第三方。
二、安装
#######1.查看当前 Ruby( Mac 默认安装了 Ruby 环境)
gem sources -l
终端返回信息如下:
*** CURRENT SOURCES ***
https://rubygems.org/
2.移除当前 Ruby 默认源,换成淘宝的(默认源用的是亚马逊云服务,被墙了)
gem sources --remove https://rubygems.org/
gem sources -a https://ruby.taobao.org/
gem sources -l
终端返回如下信息说明替换成功
*** CURRENT SOURCES ***
https://ruby.taobao.org/
3.安装 CocoaPods
sudo gem install cocoapods
pod setup
⚠️ 当初新买个 Mac 自带的系统是 OS X EL Capitan,按照网上教程无论怎么安装都报错。要注意:系统版本为10.11以后的安装命令如下:
sudo gem install -n /usr/local/bin cocoapods
pod setup
- pod setup 过程中可能报错,可能是 gem 版本太低,需要更新 gem
sudo gem update --system
完成后会提示:
Latest version currently installed. Aborting.
⚠️ 建议 gem 过一段时间最好更新一下,否则导入第三方可能会出现版本问题。公司前一段让我做直播功能,我用七牛的 PLCameraStreamingKit,官方最新版本是1.8.1,我倒入时总是会缺少几个文件对应的方法,卡了我好久,后来发现是 gem 版本太低,只能导入1.6.3的版本。
- pod setup 过程会比较久,网速慢的小伙伴要经历漫长的等待😆
终端中出现如下信息,说明 CocoaPods 正在下载
Setting up CocoaPods master repo
- 强迫症患者可以进到下载目录,查看进度
cd ~/.cocoapods
du -sh *
825M repos(我现在的是825M)
- 直到出现下面的信息,大功告成
Setup completed
三、使用
- 进到需要集成 CocoaPods 的项目目录(直接 cd 空格,将项目直接拖到终端即可)
- 创建 Podfile,方法很多,可以直接 pod init,按照目录中生成的 Podfile 文件格式填写。不过我更习惯下面的操作:
vim Podfile
- 编辑如下内容:('test'为项目名、'~> 3.0'为版本号,若不写,默认下载最新的)
platform :ios, '8.0'
target 'test' do
pod 'AFNetworking', '~> 3.0'
end
- 保存退出后
pod install
- 添加新的第三方后,可以
pod update
- 有时 pod install 或者 pod update 会卡在 Analyzing dependencies 好久,是因为这两个命令执行时会更新 CocoaPods 的 spec 仓库,替换为如下命令可跳过这一步
pod install --verbose --no-repo-update
pod update --verbose --no-repo-update
- 当需要在 Swift 中 使用 CocoaPods 时,需要使用框架来代替静态库。即在 Podfile 文件中加入
use_frameworks!
如果没有这一句,pod install 会报错。