在iOS项目中,经常使用
cocoadpods
来进行依赖管理以及三方库引入等。引入的三方库一般会有几种形式:一、在Pods
目录下可以直接看到源代码的开源库,如AFNetworking
,Masonry
等常见开源库。二、在Pods
目录下拉取的项目文件只能看到对应的头文件
和资源文件
的闭源库,如AlipaySDK
和WechatOpenSDK
等,这种三方库一般涉及到商业逻辑和安全性方面的考量,不能开源。其中,AlipaySDK
是以.framework
的形式提供给用户,WechatOpenSDK
则提供.a
的文件形式。本文说明了iOS
中动静态库的一些基本概念,以及系统描述了如何创建一个自定义.a
或者.framework
库,并通过cocoapods
的形式供三方厂商使用。
静态库和动态库的区别和使用场景
iOS
项目中经常使用到的三方库有.a
文件、.framework
文件或者.dylib
文件。
.framework
Framework
是iOS/MacOS
平台下的一种打包方式,将编译生成的二进制文件、头文件、资源文件统一打包。最后生成的文件可以是静态库
也可以是动态库
,iOS8以后允许创建自定义的framework。但是,使用到的系统的framework是动态库,而自己创建的自定义framework
则是静态库。
.dylib
.dylib
为动态库。
.a
.a
是纯二进制文件,可以将不希望别人看到的源文件封装起来。提供给三方使用时,需要与.h
文件配合使用。
动态库与静态库区别
动态库在编译中不会被拷贝到目标程序中,只有程序真正运行起来,才会被加载使用。像系统的的UIKit.framework
等动态库,iPhone中的每个app都会用到,但并不会都拷贝一份到各自的app,而是共用系统中的一份。这样就会减少App的大小,同时,如果系统升级,也方便对整个库进行替换,不需要每个app都打包一遍。
静态库则刚好和动态库相反,编译的时候会被直接拷贝一份,复制到目标程序中,这样最终编译出来的ipa包体积会增大。但是,其优点是使用方便。
在iOS8之前,系统并没有开放自定义的framework
开发,创建的framework
其实也是静态文件。iOS8之后,可以创建自定义的framework
动态库,但是跟系统提供的还是有区别,整个库文件依然会被复制到iOS的目标App中。所以,对于我们来说,自定义的framework
其实也是一个升级版的静态库。
在我们实际开发自己的SDK时,使用framework
和.a
文件都是比较常用的方式。两者的主要区别是framework
将头文件、资源文件、二进制文件都打包在一起,方便使用。而.a
文件则只是一个纯静态文件,需要同时配合.h
头文件来使用。如下则是AlipaySDK-iOS
与WechatOpenSDK
分别使用.framework
与.a
的两种形式。
AlipaySDK-iOS | WechatOpenSDK |
---|---|
CocoaPods库创建及使用
我们要开发SDK
供三方厂家使用,则面临许多问题需要解决。如:SDK
中可能会依赖其他的三方库,而客户的项目中也可能会包含同样的三方库;集成过程可能会比较复杂;版本控制问题。并且,在开发过程中SDK
也是要不断地运行和测试的,如果使用最原始的方法,不断地导出再导入到Demo项目中,整个开发过程会变得非常复杂和繁琐。
所以我们开发方式也选取目前iOS中最常用的三方库和框架管理工具:CocoaPods
。创建一个我们自己的CocoaPods
库进行开发和发布SDK项目。
CocoaPods与git库关系和结构
平时我们会在两个地方找到cocopods三方库的集成说明,一个是github
等开源网站上,会看到源码中包含有.podspec
文件,并一般会在README.md
文件中有集成说明。另一个则是在一些三方厂商的说明文档中,如微信开放平台
、JPush
等官方文档。
在github
中,我们看到的是源码和pod配置文件所在位置。我们真正使用pod install
下载安装三方库的时候,其源码文件则是从CocoaPods
官方库中下载的。
CocoaPods 官方库、私有库、本地库
- 官方库
CocoaPods
官方库是CocoaPods
维护的一个官方仓库,我们所使用的大部分三方库都是从官方库中下载下来的。
- 私有库
我们也可以不将开发好的库提交到CocoaPods
官方库,而是存放在自己的私有仓库中。这样,可以自由控制访问权限,一般公司项目进行组件化开发时候比较常用。在Podfile
中,只需要添加私有库的source源即可。如下:
source 'https://github.com/yourPrivateRepo/yourPrivateSpecs.git'
target 'YourApp' do
pod 'YourPrivateLibrary', '~> 1.0'
end
- 本地库
本地库则是pod库在本地磁盘上存放,在项目中使用时,直接在Podfile
中添加本地路径。如下:
target 'YourApp' do
pod 'YourLocalLibrary', :path => '/path/to/your/local/library'
end
CocoaPods库
创建
使用命令创建SDK
项目库
pod lib create DemoSDK
接下来会有几个问题需要挨个输入,根据各自的配置进行输入。
接着会自动创建项目以及demo项目,并自动运行Pod install
并打开项目文件。生成的项目结构如下所示:
在这里,由于我电脑的配置,创建好的.podspec
文件中s.homepage
、.author
以及s.source
默认使用了我的github
账号的相关信息。
.podspec
文件对于pod
库的创建至关重要,根据不同的需求来修改配置相关的参数来实现最终需求。
CocoaPods库中隐藏源码,只上传编译完成后的framework
库
创建完SDK
项目文件后,因为我们的项目是要给三方厂商使用,不管是使用私有库还是共有库提供给对方,都不能将自己的源码暴露出来。所以我们目前最大的需求就是不能将SDK
源码暴露,只能提供最终编译好的.a
或者.framework
文件。
要实现类似AlipaySDK
和WechatOpenSDk
只提供二进制文件,不暴露源码,需要满足两个条件
。
- 将源码上传到git私有库中。
这个很好理解,如果项目git仓库本身是公开的,则源码也就是无法隐藏了。
- 修改
.podspec
文件参数,去掉s.source_files
参数,并添加s.vendored_frameworks
字段。
s.source_files
参数指定了源文件在本地的路径,在.podspec
文件中去掉s.source_files
字段后,则使用pod trunc push
命令不会将源文件上传到CocoaPods
官方库中。
如果使用git私有库给第三方使用,则第三方厂商必须有用这个仓库的访问权限才可以使用。如果这种情况下也需要对第三方厂商隐藏源文件,则最好创建一个新的私有库,只存放最终生成的
.a
文件和.framework
以及.podspec
文件,然后将这个仓库对需要的厂商开放访问或者直接将这个仓库开源。