作为大名鼎鼎的ios开发包管理工具,估计无人不知无人不晓,你不得不知道的事情是如果要升级cocoapods你得重新安装,即sudo gem install cocoapods, 若更改了Podfile(注1)需要更新库则使用pod update,此时会生成一个Podfile.lock( 注2)文件,此时所有使用的库的信息都将标注在此文件中,使用pod install即会安装各库。需要知道的是,大家使用的pod不仅可以是github上的cocoapod项目spec repo(注3)目录中的公共pod库,也可以使用私有的pod库。
注1 Podfile
维护xcode项目中各target的信息
①一般放在项目的根目录,若想放置在其他目录,则需要在Podfile最开始加一行具体工程的目录信息即可,如 xcodeproj "/Users/username/src/projname/projname.xcodeproj"。不过需要注意的是如果在Podfile中添加此句之前已经安装过pod库,则此时需要将工程的base configuration 中的各target的debug/release.xcconfig 修改到新的pod配置,否则会编译失败,还未找到最短路径,遇到这个问题的时候一般重建工程并重新安装pod库
②Podfile中包含3种对依赖的声明, pod 声明特定的依赖,podspec声明创建一份特定的podspec,而target用于限定依赖的作用域,其中podspec的格式如下:
podspec
podspec:name=>'QuickDialog'
podspec:path=>'/Documents/PrettyKit/PrettyKit.podspec'
第一条没有参数的podspec声明会将接下来的podspec声明结合起来声明一份podspec文件
而target 会定义一个新的静态库target并将其中定义的依赖限定在其作用域内,target会默认包含定义在block之外的依赖,除非使用:exclusive => true选项
Podfile会创建一个全局的名为:default的target(其会创建出libPods.a文件) ,这个target会链接到用户project中的第一个target(如果link_with 属性未指定值)
③若多个target想使用相同的pods依赖库,可以使用link_with关键字来实现,比如添加 link_with 'target1','target2'
④指定pod版本 pod 'podname','0.9' (亦可使用逻辑操作符,比如 > 0.1,或者optimistic操作符 ~> 0.1 即,0.1到1.0(不包括1.0),~0.1.2 即0.1.2到0.2(不包括0.2),~>0 即0到以上,实际就是所有版本,如果版本填入:head(不带引号),则代表使用'bleeding edge'版本,不过这样用的时候你自己需要知道自己在做什么以及会引发的后果
若想使用本地pod,可以使用:path,比如 pod 'AFNetworking',:path=>'~/Document/AFNetworking', 这样的话cocoapod会认为指定的目录为pod的根目录,并将其中的文件直接链接到Pods工程中。此目录可以是你偏爱的SCM的一份checkout,甚至可以是当前repo中的一个git submodule,且必须包含Pod文件的podspec(想知道podspec的信息以及怎样使用最新的pod或者本地pod可以参考 cocoapod本地包管理)
使用不同版本pod可选择不同版本的git
指定不同版本的git版本
需要注意的是这些版本需要满足其他pod 对其的依赖,同时podspec文件需要存在于repo根目录下
而如果要使用spec repo之外的podspec,比如可以使用如下可以通过HTTP访问的podsepc : pod'JSONKit',:podspec=>'https://example.com/JSONKit.podspec'
⑤版本冲突及解决,由于pods经常依赖于其他 pod,而多个pod分别依赖于不同版本的另一个pod,或者你想使用特定版本的某pod时会出现pod的版本冲突,如下:
⑥build配置 默认target的build配置中会添加所有的pod依赖,但为了debug目的或者 其他原因,可以只在一部分编译配置中添加这些依赖,比如 pod'PonyDebugger',:configurations=>['Release','App Store'] 或者 pod'PonyDebugger',:configuration=>['Release']
⑦subspec 安装特定pod时,默认会安装其中定义的所有subspecs,可以指定安装特定的subspec, 如 pod 'QueryKit/Attribute' 或者pod 'QueryKit',:subspecs=>['Attribute','QuerySet']
⑧target 配置
控制cocoapod生成project的设置,platform声明静态库build的平台,默认是ios 4.3,osx 10.6,xcodeproj声明链接哪个proj,如果未显式指定xcodeproj,会使用parent target的xcode project,而如果没有target显式指定project且Podfile同一目录下只有一个proj,则会使用该proj。也可以指定你自定义的build配置是否应该在Release或者 debug预设置之后被执行,这样的话需要为每个build配置与与:release或者:debug的联系定义hash
Workspace,Sources及Hooks声明可参考链接 Podfile
注2 Podfile.lock 这个文件的内容其实是标注当前使用的各个pod库的版本号,校验码等具体信息,安装各库的时候信息即从此处取。而它最大的作用其实是发挥在团队多人协作的时候,因为所有成员使用同一份Podfile.lock, 在pod install的时候,安装的各库都将分别是相同版本的
注3 spec repo 上维护着所有人都可使用的公共pod库,而很多时候也会用到私有 pod,要在你的项目中使用私有 pod,需要这样几步:创建私有repository,让Cocoapods知道到哪里去找到它并将podspecs添加到创建的私有repository中。
要创建私有 spec repo,你不需要fork Cocoapods/Specs Master repo,但需要保证团队中的每一个人都能访问到这个仓库,你的仓库的镜像应该是这样的结构
然后将你的私有仓库添加到Cocoapods Installation: $ pod repo add REPO_NAME SOURCE_URL 然后podspec添加到你的repo(操作前先确保你已经给你的源代码打上了tag并且分了version) $ pod repo push REPO_NAME SPEC_NAME.podspec