CocoaPods简介
每种语言发展到一个阶段,就会出现相应的依赖管理工具,例如Java语言的Maven,node.js的npm。随着iOS开发者的增多,业界也出现了为iOS程序提供依赖管理的工具,它的名字叫做:CocoaPods。
CocoaPods项目的源码在Github上管理。该项目开始于2011年8月12日,经过多年发展,现在已经成为iOS开发事实上的依赖管理标准工具。开发iOS项目不可避免地要使用第三方开源库,CocoaPods的出现使得我们可以节省设置和更新第三方开源库的时间。
在没有使用CocoaPods以前,我需要:
把这些第三方开源库的源代码文件复制到项目中,或者设置成git的submodule。
对于这些开源库通常需要依赖系统的一些framework,我需要手工地将这些framework一一增加到项目依赖中,比如通常情况下,一个网络库就需要增加以下framework: CFNetwork, SystemConfiguration, MobileCoreServices, CoreGraphics, zlib。
对于某些开源库,我还需要设置-licucore或者 -fno-objc-arc等编译参数管理这些依赖包的更新。
这些体力活虽然简单,但毫无技术含量并且浪费时间。
在使用CocoaPods之后,我只需要将用到的第三方开源库放到一个名为Podfile的文件中,然后执行pod install,CocoaPods就会自动将这些第三方开源库的源码下载下来,并且为我的工程设置好相应的系统依赖和编译参数。
一、CocoaPods 的安装
CocoaPods是用Ruby实现的,要想使用它首先需要有Ruby的环境。幸运的是macOS系统默认的已经可以运行Ruby了,因此我们只需要执行以下命令。
-
更换 Gem 的源
Gem是一个管理Ruby库和程序的标准包,它通过Ruby Gem(如 http://rubygems.org/ )源来查找、安装、升级和卸载软件包
// 移除掉原有的源(服务器在国外,速度较慢)
gem sources --remove https://rubygems.org
// 等有反应之后再敲入以下命令(添加国内的源https://gems.ruby-china.com/)
gem sources -a https://gems.ruby-china.com
// 验证是否替换成功
gem sources -l
-
更新升级 Gem 版本
Gem是管理Ruby库和程序的标准包,如果它的版本过低也可能导致安装失败,解决方案自然是升级Gem,执行下述命令即可:
// 更新升级gem
sudo gem update --system
//查看gem版本
gem -v
-
安装CocoaPods
// 安装CocoaPods(OS X 10.11以前)
sudo gem install cocoapods
// 安装CocoaPods(10.11后苹果升级了安全策略)
sudo gem install -n /usr/local/bin cocoapods
-
配置CocoaPods
所有的项目的podspec文件都托管在https://github.com/CocoaPods/Specs。 第一次执行pod setup时,CocoaPods 会将这些podspec索引文件更新到本地的 ~/.cocoapods/目录下,这个索引文件比较大,有 250M 左右。所以第一次更新时非常慢,一定要耐心的等。这步其实是 Cocoapods 在将它的信息下载到 ~/.cocoapods目录下,如果你等太久,可以试着新建一个终端 cd 到 ~/.cocoapods目录下,用du -sh *来查看下载进度。
//将CocoaPods 的信息下载到 ~/.cocoapods目录下(Setting up CocoaPods master repo 会卡在这里很久)
pod setup
//cd 到 ~/.cocoapods目录下
cd ~/.cocoapods
//查看下载进度
du -sh *
二、CocoaPods 的使用
使用时需要在你的项目根目录下新建一个名为Podfile的文件,将依赖的库名字依次列在文件中即可
-
进入工程文件夹
以TestCocoaPod项目为例子
//进入TestCocoaPods工程文件夹
cd /Users/iCoder/Desktop/TestCocoaPods
AAEC76BC-A3FA-4A18-BB63-E2D083BA8E5E.png
-
创建编辑一个Podfile文件
输入命令vim Podfile,要导入的第三方都要在这里面写上。进去后需要先按I键进入编辑状态,写完后按esc,然后按:wq就可以保存退出了
//输入命令vim Podfile 接着按一下I进入编辑模式
vim Podfile
F8F5E2ED-CAC5-47F8-9EEC-17520461CDB6.png
例如我们要导入AFNetworking,Podfile的格式如下
//ios小写 TestCocoaPods是你的工程名字
platform :ios,'8.0'
target 'TestCocoaPods' do
pod 'AFNetworking'
end
1BC72785-8334-42F1-A454-8C6B126D8863.png
//按下esc,再输入:wq保存退出
:wq
2D4CBD30-2493-48FC-B534-1D97E2B5ED26.png
-
执行安装命令
//执行pod install
pod install
20E1E3EF-C68D-47DB-8040-C184E703FC33.png
-
打开项目
之前我们一直是双击TestCocoaPods.xcodeproj打开项目,以后我们双击TestCocoaPods.xcworkspace打开即可
23E63860-8822-4E54-8021-3D171D860063.png
-
使用第三方
引入AFNetworking的头文件时,使用#import <AFNetworking.h>引入,使用#import "AFNetworking.h"不再有提示
BD14176A-DC7A-4FD6-BF5F-591927A5AC80.png
-
添加或删除第三方
如果使用过程中我还想添加/删除其他的第三方怎么办,只要在Podfile里面添加/删除,然后终端再执行pod install就可以了
例如我要将AFNetworking删除,添加pop库
打开工程,找到Podfile文件,删除pod 'AFNetworking',添加pod 'pop'
09353315-B7D6-46FC-A67C-66A11E364F3F.png
打开终端,cd到工程目录,执行pod install
//进入工程目录
cd /Users/iCoder/Desktop/TestCocoaPods
//导入
pod install
E21170E4-820B-4093-92E0-4C4490681468.png
三、常见问题
-
pod install,pod update速度慢
出现原因:你本地的repo库太长时间没有更新了
解决办法:
pod repo update
原因在于当执行以上两个命令的时候会升级CocoaPods的specs仓库,如果不想在install、update的时候升级specs库,可以使用参数忽略掉
pod install --no-repo-update
pod update --no-repo-update
-
导入Swift类库
导入Swift语言编写的类库时需要加use_frameworks!,下面以导入Alamofire为例:
platform :ios, '8.0'
use_frameworks!
pod 'Alamofire'
网友评论