Cocoapods代码管理

转载:刘坤的博客
只要是做代码开发,就会遇到代码管理的问题,IOS也不例外。比如你写了一个用于网络图片加载的公共组件EGOImageLoading. 然后这个组件在10个project中被使用。某一天你对这个组件做了一些优化或bug修复,怎么把代码同步到所有工程呢。普通程序员:手动一个一个拷贝到每个工程。文艺程序员:pod update

cocoapods是什么
作为一个objc代码的程序员,应该都听过cocoapods,如果你还没听过,那可以说out了。
每种语言发展到一个阶段,就会出现相应的依赖管理工具, 或者是中央代码仓库。比如

Java: maven,
IvyRuby: gems
Python: pip, easy_install
Nodejs: npm

那么cocoapods就是objc代码的依赖管理工具。cocoapods非常适合代码的集中管理,和工程依赖的管理。比如以前我要添加ASIHttpRequest到工程中,我需要:

  • 1、将ASIHttpRequest下载到本地
  • 2、解压后把对应的代码拖到工程中去
  • 3、在target中的build settings添加对应的framework: CFNetwork, SystemConfiguration, MobileCoreServices, CoreGraphics, zlib.

这些体力活虽然简单,但毫无技术含量并且浪费时间,而且很容易漏加framework,导致报错排查。使用cocoapods之后,我们就可以在配置文件中加一行 pod 'ASIHTTPRequest', '~> 1.8.2', 然后pod install就行了啊,如果ASI有新版本1.8.3发布,那么我就改成pod 'ASIHTTPRequest', '~> 1.8.3',然后pod update
就行了。

cocoapods安装和使用简介

cocopods安装非常简单,本来想略去这一部分的,但还是贴一下命令吧,如果不明白网络上搜索一搜一大把。
sudo gem install cocoapodspod setup

使用也比较简单,cd到你的工程的根目录
$projectPath
cd $projectPathpod init

这个命令就会再工程根目录下面生成一个Podfile文件,podfile用文本编辑就行了,我给出一个例子


platform :ios, "5.0"
target "TestPod" do
pod 'ASIHTTPRequest', '~> 1.8.2'
pod 'CocoaLumberjack', '~> 1.8.1'
pod 'libextobjc', '~> 0.4'
pod 'FMDB', '~> 2.2'end

然后再使用pod install
就可以把这些开源控件安装了。安装完,这些控件都放在一个Pods的工程中,然后会用xcode的workspace来管理这个工程和你自己的工程。以后就打开yourproject.xcworkspace
就行了。
搜索公共组件

$ pod search ASIHttpRequest

-> ASIHTTPRequest (1.8.2)
Easy to use CFNetwork wrapper for HTTP requests, Objective-C, Mac OS X and iPhone.
pod 'ASIHTTPRequest', '~> 1.8.2'
- Homepage: http://allseeing-i.com/ASIHTTPRequest
- Source:   https://github.com/pokeb/asi-http-request.git
- Versions: 1.8.2, 1.8.1 [master repo]
- Sub specs:
    - ASIHTTPRequest/Core (1.8.2)
    - ASIHTTPRequest/ASIWebPageRequest (1.8.2)
    - ASIHTTPRequest/CloudFiles (1.8.2)
    - ASIHTTPRequest/S3 (1.8.2)

cocoapods的工作流程简介

  • 1.cocoapods代码库列表
    上面讲了pod可以搜索对应的开源组件库,是如何搜索的呢,难道是联网在线搜索的?
    当然不是的,cocoapods有一个git仓库专门保存了github上一些有名的开源组件的podspec文件。cocoapods会把它clone到你本地的~/.cocoapods/repo/master
    路径下。当你pod search 一个内容时,就在这个本地目录下进行搜索。这里我们就洞悉了cocoapods是如何管理中心仓库的了,就放在你的~/.cocoapods/repo
    目录下啊,了解这个就便于后面我们创建自己的私有的代码中心仓库,在后面会介绍如何创建自己的私有库。

  • 2.pod如何安装代码
    pod install
    改为pod install --verbose
    之后就可以看到这个过程cocoapods做了什么

  • 2.1首先会更新你的本地中心仓库
    Updating spec repositories
    这个过程可能会很慢,当然我们可以忽略这个过程。
    pod install --no-repo-update

  • 2.2然后下载源代码到本地
    cocoapods会预先从github上把代码拉下来放到缓存里,缓存的目录~/Library/Caches/Cocoapods
    ,知道这个是有作用的,方便清理缓存。
    下载到缓存目录后把代码拷贝的你工程目录下的对应目录下:如$projectPath/Pods/ASIHTTPRequest

  • 2.3Generating Pods project
    创建或更新Pods工程,cocoapods会创建一个Pods的project来管理这些代码,Pods工程会把公共组件代码编译为静态库文件.a给你的工程使用。

  • 2.4配置workspace
    创建一个workspace管理Pods工程和你原本的工程。并通过xcconfig配置文件配置编译参数到你的原本工程中去。

cocoapods私有库管理

  • 1.配置podspec

cocoapods是如何知道一个开源组件需要引入哪些代码,需要添加哪些framework和lib,需要哪些资源文件的呢。
这些信息都配置在podspec文件中。如果你打开cocoapods的本地中心仓库文件来看的话,会发现保存的都是podspec文件。首先生成一个podspec文件,在工程目录下:
pod spec create [spec_name]

关于podspec怎么写,cocoapods官网上的guide写的非常详细啦,当你要写的时候参考这写就行了:Podspec Syntax Reference这里给出一个我自己写的示例,我写的组件叫BBFoundation:

Pod::Spec.new do |s| 
s.name = "BBFoundation" #名称 
s.version = "0.0.4" #版本号 
s.summary = "有大量的类别和UI组件方便构建工程" #描述 s.homepage = "http://example.com/projects/BBFoundation" #描述页面 
s.license = 'MIT' #版权声明 
s.author = { "liukun" => "765409243@qq.com" } #作者 s.platform = :ios, '5.0' #支持的系统 
s.source = { :git => "git@example.com:BBFoundation.git", :tag => "0.0.4" } #源码地址 
s.source_files = 'BBFoundation/**/*.{h,m}' #源码 
s.frameworks = 'CoreGraphics', 'CoreFoundation' #framework s.libraries = 'z', 'bz2.1.0' #lib 
s.requires_arc = true #是否需要arc
end
  • 2.测试pod是否能成功

有了上面的podspec,我们就可以测试这个配置是否可以正确使用了啊。正好可以使用cocoapods的本地pod功能。
比如我的BBFoundation的代码放在~/Code/BBFoundation
路径下,podspec文件是BBFoundation.podspec
.首先我们吧source路径改成本地的,就是把上面一段代码中的s.source改下:
s.source = { :git => "$HOME/Code/BBFoundation", :tag => "0.0.4" }

然后在测试的工程的Podfile中加入
pod 'BBFoundation', :podspec =>
'$HOME/Code/BBFoundation/BBFoundation.podspec'

然后pod install --no-repo-update
测试下安装. 如果能够安装成功,并且在你的测试工程中能够成功引用代码并编译成功,那就没问题啦。

  • 3.添加私有中心仓库

上面一步已经完成了自己创建组件并本地使用pod进行依赖管理的功能了。但是用起来似乎还是不够完美。我们想和github上的第三方库同样的使用方法啊,像这样简单的:
pod 'BBFoundation' '~> 0.0.4'

我们就需要添加自己的中心仓库了。添加过程也比较简单的:
3.1创建一个git仓库作为中心仓库
直接在~/.cocoapods/repo
目录下面创建一个目录MyPrivatePods,放自己的podspec

cd ~/.cocoapods/repo
mkdir MyPrivatePods
cd MyPrivatePods
mkdir BBFoundation
cd BBFoundation
mkdir 0.0.4
cd 0.0.4cp ~/Code/BBFoundation/BBFoundation.podspec .

上面的命令创建了3个文件夹,是因为cocoapods规定了中心代码库的文件结构树是这样的:

repo
|—— Spec repo name  //就是中心仓库的名称,如MyPrivatePods
    |—— [SPEC_NAME]  //就是组件的名称
        |—— [SPEC_VERSION]  //组件的版本号
            |—— [SPEC_NAME].podspec    //组件的spec配置文件

这个时候试试pod search BBFoundation
就会发现,可以搜索到自己建立的私有控件了。
下面为了保持这个仓库可以共享,我们就把它用git托管起来,最好是放在git server上,那么别人可以添加你的私有中心库了哈:

cd ~/.cocoapods/repo/MyPrivatePods
git init
git add .
git commit -am 'init commit'
git remote add origin git@example.com:MyPrivatePods.git
git push origin master

这个时候就可以共享你自己的私有中心仓库了,其他人可以通过以下命令把这个仓库添加到他的本地:
pod repo add reponame git@example.com:MyPrivatePods.git

cocoapods代码托管的使用意义
讲了这么多,好像一直在讲这个怎么用,怎么设置,但是没有讲它到底能够给我们带来多少好处。使用过java的maven的可能可以理解它的好处。
如果你像我们一样拥有多个app, 这其中每个app都要依赖于某个基于业务逻辑的公共模块。就可以像如下图处理工程之间的依赖:


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

推荐阅读更多精彩内容