CocoaPods的安装和使用教程

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'

四、参考资料

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,847评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,208评论 1 292
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,587评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,942评论 0 205
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,332评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,587评论 1 218
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,853评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,568评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,273评论 1 242
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,542评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,033评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,373评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,031评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,073评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,830评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,628评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,537评论 2 269

推荐阅读更多精彩内容