使用CocoaPod打包
brownfeng 关注
2017.03.28 21:04* 字数 1424 阅读 2341评论 41喜欢 10
前段时间将两个sdk都转向了cocoapod进行开发和打包.
1 基于pod命令创建SDK
具体的pod命令如下:
调用以后terminal中会需要填写以下问题,一般选择创建Demo,其他选项根据需求填写:
2 默认podspec文件的内容结构
podspec内容是ruby.用sublime设置成ruby可以看到语法高亮.
podspec中重要的几个内容解释如下:
s.source
中是表示使用pod package
打包时候pod去寻找的打包的路径,podspec默认使用git commit tag作为路径,也可以修改成本地路径/Users/pp/Desktop/MyCustomLib
,如果当前没有设置:tag
,打包时候默认使用当前git commit的head节点(如果部分修改内容没有commit,那么使用git package
不会将未commit的内容进行打包).s.source_files
表示具体的源码的路径,这里注意源码一般放到Classes
文件夹目录下,而且实体文件中不要有非源码内容放到Classes
文件夹.Classes文件夹的所有内容都要Add Targets To: MyCustomLib
.不要Classes
文件夹或子文件夹中部分内容被remove referrence
.s.resource_bundles
中的资源.系统会自动将MyCustomLib/Assets
文件夹下的内容,cocoapod会将我们把Assets
中的内容自动打包成MyCustomLib.bundle
.这里也可以使用简单的方式- 1 在
Assets
文件夹中放入我们自己写好的MyCustomLib.bundle
,bundle中是我们使用的资源. - 2 使用
s.resource = 'MyCustomLib/Assets/*'
.最后会将这些资源打入framework中. - 3 在Example中手动引用我们自己创建的*.bundle资源文件.
- 1 在
s.public_header_files
用来指定需要对外部暴露的头文件的位置s.frameworks
和s.libraries
,表示当前sdk依赖的系统的framework和类库s.dependency
表示当前podspec类库对外部第三方库的依赖.如果使用pod package
打包sdk时候,这里的dependency会被自动添加前缀,防止重复引用冲突.而且这里的依赖只能是pod库(公有或者私有)的内容.s.subspec
用来引入我们sdk依赖的自己的framework或者.a等静态库
3 提交pod到私有pod库
一般我们提交源码到公有或者私有pod库时候,首先需要修改s.source
,修改成git路径:
然后根据实际情况修改s.version
,然后git的要提交的commit打上tag(tag与s.version的版本一致).
注意pod install或者pod package都是通过git的commit索引或者tag来找源码的.因此对外发布时候一定要在s.version中指定tag的标签,在git中给定的commit打上tag.
4 验证pod库是否满足pod要求
pod lib lint BZLib.podspec --allow-warnings --verbose
5 将sdk打包
需要安装cocoapods-packager
.
然后执行pod package MyCustomLib.podspec --force --verbose
.通过这个命令打包时候会自动将podspec中dependency的第三方库进行重命名.这样打出来的是MyCustomLib.framework
.前面资源文件都在MyCustomLib.framework/Reources/MyCustomLib.bundle
里面可以手动把这个bundle拖出去.
前面提到过使用pod package打包时候需要注意.pod会根据当前podspec中的
s.source
的地址去查找当前sdk源文件的地址.如果使用的s.source = { :git => 'https://github.com/brownfeng/MyCustomLib.git', :tag => s.version.to_s }
,那么就会去git中拉取最后一个tag对应commit的源码.如果使用的s.source = { :git => '/Users/pp/Desktop/MyCustomLib'}
,那么会使用当前sdk中git 的HEAD位置的commit的源码进行打包编译.(如果源码有修改,一定要先git commit,然后再打包)
6 注意问题
1 重点问题一: Example中依赖某些类库
举例说明,如果MyCustomLib.podspec
中依赖s.dependency 'AFNetworking', '~> 2.3'
,此时在Example中也需要使用AFNetworking,那么这里千万不要在Example中引入AFNetworking
的源码,请在podfile中添加pod AFNetworking
.
2 重点问题二: SDK中依赖的第三方库无法使用BITCODE
在Example的podfile底部添加以下语句:
3 重点问题三: SDK中调用资源的问题
由于最后打包时候有可能打出来的包是动态库,那么建议通过如下方式调用资源
4 podfile的依赖路径
对于podfile,常见的库的地址引用写法如下:
用AFNetworking
举例:
5 私有库的依赖问题
公有库的依赖问题很方便,这里就不解释了.
如果自己的某个sdk的podspec文件中的dependency
并未上传到公有或者私有pod库中.紧紧是使用的本地的podspec库.那么此时不能使用pod package
打包成功.但是可以通过编写podfile
方式,在Example中集成sdk.具体在podfile
中需要手动写入需要引入的podspec的地址,而且两者有引入的顺序要求.
举例说明, 如果我们有一个主工程Downloader
,它使用一个子库Player
,这个Player
子库依赖另外一个库FFMpegPlayer
.在Player
的podspec中的依赖只能写成s.dependency = 'FFMpegPlayer'
(虽然有可能FFMpegPlayer库并没有提交到公有或者私有pod库中,这种写法是满足的).同时在我们的Example Downloader
的podfile
中需要按照顺序
写入引入的库:
一定要注意顺序!!!!!
注意,这里如果要使用
pod package
打包Player
库会失败.
参考文档
http://www.jianshu.com/p/8af475c4f717
http://stackoverflow.com/questions/16905112/cocoapods-dependency-in-pod-spec-not-working
http://feihu.me/blog/2016/unittest-for-framework-in-big-project/