接上篇文章ios如何使用cocoapods-packager打包生成静态库的简单例子,本文讲述一种比较复杂情况的SDK开发打包流程。我们的SDK中引用了活体检测的三方SDK,包括.a文件,.Framework文件, .bundle文件,相当于我们的SDK是对别人的SDK的二次封装。
(一)、将第三方的库引入到工程中
这里的引入和以前在app工程中引入有些不太一样,并不需要手动的将三方库拖入到工程中,我是按照如下步骤做的:
1)将三方sdk的文件拷贝到Classes物理目录下
2)在工程的pod/xxx.podspec文件中配置对三方sdk的引用,
s.vendored_libraries = 'huotiDetectionSdk/Classes/ThirdSdk/*.a','huotiDetectionSdk/Classes/ThirdSdk/OpenCV/*.a'
//以上是对三方sdk中.a文件的配置
s.vendored_frameworks = 'huotiDetectionSdk/Classes/ThirdSdk/OpenCV/xxx.framework'
//以上是对三方sdk中.framework文件的配置
s.xcconfig = { 'USER_HEADER_SEARCH_PATHS' => 'huotiDetectionSdk/Classes/ThirdSdk/*.{h}' }
//以上是对三方sdk中头文件的配置
s.resource_bundles = {
'huotiDetectionSdk' => ['huotiDetectionSdk/Classes/ThirdSdk/xxxx.bundle']
}
//以上是对三方sdk中bundle资源文件的配置
s.source_files = 'huotiDetectionSdk/Classes/*','huotiDetectionSdk/Classes/**/*'
//以上是对我们自己开发的SDK中源码的配置,但是这里边需要加上三方sdk的路径,否则会打包出错;加上三方sdk的路径之后,在pod install的时候会出现警告,不用管。
3)另外该活体检测sdk还需要其他一些配置,如bitcode=No等,这些配置需要在podspec中配置,s.pod_target_xcconfig = { 'ENABLE_BITCODE' => 'NO' }
4)活体检测依赖的系统库在podspec文件中的配置:
s.libraries ='c++'
s.frameworks ='CoreMotion'
5)配置完.podspec文件之后,命令行进入到Example目录下,执行pod install之后,我们会看到三方的活体检测sdk就出现在了我们的工程目录下;如果没有出现,请关闭xcode,再重新打开即可。
(二)、我们二次封装的SDK如何使用该活体检测三方sdk呢?
1)在Classes目录下,新建了object-c的mysdk.h和mysdk.m类,该类中加入对活体检测sdk的api调用。
2)配置podspec文件:
s.source_files ='huotiDetectionSdk/Classes/*','huotiDetectionSdk/Classes/**/*'
s.public_header_files ='huotiDetectionSdk/Classes/*.h'
//上述两个配置s.public_header_files这个是公开给APP层使用的头文件,在本工程中,这里只有mysdk.h;
s.source_files是配置的源代码,这里把mysdk.m和活体检测sdk的路径都包含了进去
3)在Example工程中,调用mysdk.h中公开的某个API。
4)命令行进入Example目录下,pod install
5)然后选中Example工程的target,run跑起来,这个时候会发现程序编译没问题,但是会出现运行时crash。分析后得出结论是,活体检测sdk中的.bundle资源文件没有被正确引用。因此需要在Example工程,将活体检测sdk的.bundle文件再次加入,并且在Example工程中,同样需要配置活体检测sdk要求的一些配置,比如bitcode=no,Privacy - Photo Library Usage Description的声明等。再次跑起来Example工程,发现可以正常使用了。
6)上述是对sdk开发的一种联调模式的运行,接下来讲述利用cocoapods-package打包出来framework,在新的App工程中使用我们二次封装的framework。
(三)、打包Framework静态库
1)命令行进入到工程目录下,先pod lib lint huotiDetectionSdk.podspec --allow-warnings --use-libraries --verbose验证下podspec是否有问题,如果有问题--verbose参数会打印出详细的错误信息
2)验证通过后,将代码提交到远程版本库,并且打tag,git tag 0.1.3,push origin 0.1.3,这里注意tag号必须是递增的,如果是把以前的tag号删除了,再使用也是不行,因为有缓存;tag号需要鱼podspec中的版本号一致,这个开头的链接文章中讲过。
3)执行打包命令pod package huotiDetectionSdk.podspec --force --no-mangle
4)打包成功的话,会在物理目录下看到
5)xcode新建一个APP工程,将huotiDetectionSdk.framework拖入到工程中,并且将活体检测sdk的.a,.framework, .bundle文件都拖入到工程中(活体检测sdk的.h文件可以不提供),并且配置活体检测sdk需要的工程配置。
注:从上面我们可以总结出来,当开发的SDK中使用了其它的三方sdk(本文中是指活体检测三方sdk),那么打包出来的静态库,在提供给外部使用的时候,需要将该三方sdk的库文件,资源文件,以及工程配置等都同时提供。
(四)通过这两篇文章,相信开发SDK的打包和联调的过程都已经囊括了,我在这个过程中也遇到了很多问题,但搞定之后回过头看,其实也不难。重点应该是在如何设计SDK上。
网友评论