使用CocoaPod打包 注意事项

使用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资源文件.
• 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/