美文网首页 ios零碎记录iOS开发常用iOS学习交流
xcode制作iOS静态库SDK<包含第三方.a或者.fr

xcode制作iOS静态库SDK<包含第三方.a或者.fr

作者: 踏遍青山 | 来源:发表于2017-03-16 14:39 被阅读7829次
原本不打算在分开发一遍这个的,应该是包含在这篇Flash Air ANE for iOS 集成最新版本的友盟统计SDK.framework功能中的,但是由于ANE的开发需求一般太少,这个静态库如何包含第三方SDK静态库又是我在开发ANE扩展库中遇到的一个大问题,折腾了好几天才解决了这个问题。而且网上问的人很多,且大多都没有给出解决方案,所以还是单独拎出一篇记录一下。
制作工具xcode版本 8.2.1

一. 简单介绍

一般制作静态库的方法及静态库和动态库的详细介绍,偷个懒借鉴一下别人的iOS静态库SDK制作,我觉得这篇不管从原理还是制作方法说的都是很详细的。32个赞!


二. 使用.a文件制作静态库

在<一>的基础上我们可能有额外的两个需求:1就是将第三方的静态库(*.a)打包进我们自己的静态库中,2.将第三方静态库(.framework)打包进我们自己的静态库中。首先来说一下1的实现方式,我们以百度统计的SDK为例子,将百度统计的功能集成到我们自己的静态库中去:

2.1 创建一个静态库项目,选择Static Library (生成.a的静态库,如果选择Framework即生成.framework的静态库也可以是动态库 具体怎么区分请参见<1.>)


2.1-1.png

2.2将静态库拖入到项目中,并勾选Add to Targets到库中。


2.2-1.png
2.2-2.png

2.3 添加百度SDK所需要依赖的系统库,这里添加的.dylib如果使用新的.tbd编译会报错,简单的处理就是还替换添加.dylib的库<在Link Binary withLibaraies中点击加号->Add Other...->Shift + Command + G组合键->输入/usr/lib->找到需要添加的库 如图 2,3>


2.3-1
2.3-2
2.3-3
2.4 设置Build setting如下 2.4-1

2.5 分别设置编译库运行环境Debug/Release,并分别选择编译Target Device为模拟器/Generic iOS device,运行生成两个版本的静态库.a文件:


2.5-1
2.5-2
2.5-3
2.5-4
2.5-5

2.6 通过lipo -create //debug.a //release.a -output universal.a命令将两个静态库合成一个静态库适用于不同的编译环境:这就制作完成了可以用了。

2.5-1
2.5-2

三.Framework、.a、.dylib/.tbd三种格式的说明

另外一种情况比较特殊的情况就是将第三方的.framework的库包含进我们的静态库中,首先了解一下.framework和.a的静态库之间的区别:

  1. Framework
    Framework的英文释意是框架,主要由Headers、binary文件、.bundle这三部分构成,除此之外还有Info.plist和Modules,后两者主要记录Framework的版本之类的信息,一般都会删掉,不做讨论

a).Headers
包含我们在制作Framework的时候暴露的头文件,所有被暴露的.h都放在这里。
b).binary文件
整个Framework的核心,所有代码都被编译成了这样一坨二进制文件,这里要注意的是添加的依赖库不会被编译进来,用的时候还需要重新link其他依赖库。
c).bundle
资源文件都打包放在这里。在制作Framework的时候不可以把图片直接放在项目中,否则制作好之后图片是一张一张的出现在项目中非常乱,需要新建一个bundle将图片放进去,这里的bundle提供整个SDK的图片资源。
注意:图片放进bundle之后不可以用[UIImage ImageWithName:]读取图片。要先找到bundle包再拿图片。
其实Framework既可以是静态库也可以是动态库,这取决于编译成的Mach-O(就是那个二进制文件)是动态库还是静态库,Framework本质上并不是一个库,它是苹果为了方便开发者提供了一种库的打包方式,Framework会将Mach-O文件、头文件和资源包全都包含进来,不需要你再手动整理,我们也可以通过Xcode来制作framework动态库使用。
所以总结:Framework是库的打包形式,既可以是动态库也是静态库。

  1. .a静态库
    这类静态库与Framework基本类似,不同的是在打包成.a文件的同时,还需要提供头文件,使用时相较于Framework比较麻烦,(例如微信支付SDK使用的是.a,不同的是支付宝SDK是以framework的形式打包的)。.a这样打包不够方便,而Framework编译完成暴露的头文件都已经放好了。
  1. .dylib/.tbd 动态库
    这类动态库我们也经常用,基本上都是系统提供的,一般不能自己制作,就算你通过其他方式制作使用,也肯定不能上架的,这里没什么好讲的。
  1. ** 如果将第三方SDK的framework包含在自己的静态库中,一种方法就是打包的时候不打包进自己的静态库中,然后在调用静态库的时候再在程序中引入第三方的SDK即可**,iOS静态库SDK制作也有提到具体如何操作,.framewrok的库确实无法整体直接打包进静态库中。没有办法直接整体打包,那么有没有办法间接的引入呢?

四.艰辛路程

因为我们公司有一个外包的Flash Air跨平台的游戏项目<安卓,iOS,Windows>,公司想集成一个App统计的功能,统计一下用户数量活跃度之类的。这时候需要用到一个ANE扩展库的功能,具体干嘛的有兴趣的可以去百度上Google一下,如果也有这方面的需求可以参考我的另一篇:Flash Air ANE for iOS 集成最新版本的友盟统计SDK.framework功能,简单来说就是通过在Air端提供的桥接接口,在Air端通过调用桥接的接口间接调用iOS端库中的方法,实现方式类似与OC的代理方法一样。

  1. 我们在调研的时候遇到的问题

a).现在主流的第三方都不在提供ANE的扩展库,这意味着你想用的话必须自己去生成<ShareSDK 还有提供>。
b).现在网上有关ANE的资料大多都比较老大多停留在14年左右,GitHub上的库基本都是13 14年的,也能依稀看的到Flash Air开发逐渐的没落。
c).开发上遇到的难题:因为制作ane需要两个最重要的文件一个是.a的静态库一个是Flash制作的接口swc文件,.a的库是需要封装好第三方的功能,因为我们公司统一使用的是友盟的,而友盟新版本的SDK已经变成.framework的形式,而且我问了他们客服,已经不提供.a的静态库了。经过几天的折腾发现确实只能将.a的静态库包含进ANE的扩展库中,而使用.framework是无法包含进去的<至少是我自己调研出来的结果,有些方法确实可以将framework打包进ane中,但是API接口无法调用>。所以就遇到了头疼的问题,怎么把别人的framework打包进我的.a静态库中?然后我才能去合成我的ane扩展库。

  1. 通过framework的介绍:Framework的英文释意是框架,主要由Headers、binary文件、.bundle这三部分构成,其实framework就是在.a静态库基础上的更上一层封装,包含了资源,二进制文件,和头文件并生成统一格式方便用户调用有点类似<.dylib和.tbd>,并不是重新生成的另外一种形式,只是对老的格式进行了一层更规范的封装,统一管理资源文件 头文件和库的二进制文件。所以如果你需要的.a文件其实就在.framework文件中,以友盟为例:手动把二进制文件改成.a的后缀,带上头文件,然后调用他吧...
    4.2-1
  1. 所以想要把framework打包进你的静态库中去的话,你只需要两步->四.2->


. 正文



五. 将第三方.framework集成到自己的静态库里

好像直接指定步骤很多人做出来的静态库不能用>_<...,所以我还是来把将第三方.framework集成到自己的静态库里写一个完整的流程吧。大家对照做看看有哪些步骤做错了。

1 .这里我已友盟的SDK作为例子,首先去友盟官网下载最新版本的SDK 友盟官网,解压根据如下路径找到二进制文件

1.png

2 . 将UMMobClick的二进制文件改成.a的后缀名,并且拖到Header里,顺便给Header改个响亮的名字UMMobClick

2.png

3 .开始制作我们自己的静态库的项目,将UMMobClick文件夹拖进项目里面,注意勾选Coby...和Add to target选项,完成之后如下:

3
4.png
5

4 . 导入UMMobClick的依赖库

6

5 . 写好我们需要调用的API和实现,这里我只做一个调用开启UM统计的接口和:

7
8

6 .生成我们需要的静态库文件

1.生成模拟器的静调库,选中一个模拟器设置Build Active Architecture Only = NO,设置Edit Scheme ->Run->Build configuration ->Debug.Command + B编译生成静态库


9
10
11

2,同理选中真机,Edit Scheme ->Run->Build configuration ->Release


12.png

7 .合并两个版本的静态库:

1.右键静态库->Show in Finder


13

2.将两个库拖到桌面


14
3.运行命令lipo -create /Users/collegepre/Desktop/Products/Debug-iphonesimulator/libUMMobStaticLib.a /Users/collegepre/Desktop/Products/Release-iphoneos/libUMMobStaticLib.a -output libUMMobStaticLib.a
15png

4.将生成的静态库和头文件拖入一个文件夹


16

8 .验货...

1.创建一个测试程序拖入上面创建好的静态库.


17

2.导入依赖库


18.png
3.调用接口
19

4.运行查看结果


20.png
5.结果OK,

六.Demo地址

demo地址Demo传送门

七.如若转载请注明出处,

如果有不正确的地方欢迎留言指出。

对你有帮助的话,请点个赞吧!

相关文章

网友评论

  • 沃小沃:如果打包的.a里包含动态库framework怎么办
  • brilliance_Liu:您好,请问下,我自己做的SDK引用了比如Masony,我打包成.a,别人工程引用我的.a,为何不能直接引用masony?别人工程单独添加masony又会报重复引用错误。请问我的.a,别人如何能直接引用masony这种第三方呢?需要把masony的所有头文件都暴露出来吗?
    踏遍青山:@小羊孩子 嗯 也可以
    小羊孩子:@踏遍青山 先可以不把masonry添加进SDK中,让用到工程的人添加masonry 吧?
    踏遍青山:嗯 你得把需要引用的头文件暴露出来
  • 沃小沃:亲问下,我打包的一个静态库包括bundle,然后集成一个demo里 bundle里的图片是可以显示的,当我二次打包静态库,这个静态库包含第一次打包的.a和bunle 再次集成到demo 但是原来bundle里的图片就不显示了,请问下这个该怎么解决
  • 306b537b47af:楼主最后一步是将第三方.framework集成到自己的.a静态库中,如果是集成到自己的framework静态库中是否能成功?
    踏遍青山:按道理肯定是可以的.framework也是在.a的基础上封装了一层
    zoufee:同问,求楼主赐教
  • Tang杰:你好,我按照你的步骤添加七牛播放SDK打包没报错,使用打好的.a
    Tang杰:@踏遍青山 这是我自己添加进去的七牛库 已经打包到.a了的
    踏遍青山:@Tang杰 PLPlayer _PLPlayerOption,这两个不是UM的类,你看看你自己看看是不是打包进去了, 打包进去也可以添加好依赖库。
    Tang杰:错误:
    Undefined symbols for architecture x86_64:
    "_OBJC_CLASS_$_PLPlayer", referenced from:
    objc-class-ref in libUMMobStaticLib.a(UMMobStaticLib.o)
    "_OBJC_CLASS_$_PLPlayerOption", referenced from:
    objc-class-ref in libUMMobStaticLib.a(UMMobStaticLib.o)
    "_PLPlayerOptionKeyTimeoutIntervalForMediaPackets", referenced from:
    -[UMMobStaticLib showPlayerToView:] in libUMMobStaticLib.a(UMMobStaticLib.o)
    ld: symbol(s) not found for architecture x86_64
    clang: error: linker command failed with exit code 1 (use -v to see invocation)
    求指点
  • 沃小沃:请问下我要打包.a文件里需要导入 的.framework 里除了header和二进制文件还有其他文件,也需要导入到工程里去吗
    逆袭之前:@踏遍青山 info.plist
    踏遍青山:比如哪些呢?
  • Multa:你好,我正在尝试把下载的xxx.framwork 转变成 head.h+.a方式来进行Myframwork制作,但是在这之前,我随意写了一个demo,使用此xxx.framwork demo可以正常运行,之后我把xxx.framework转变成了head.h+.a的形态 拖进项目里,设置好了header searchpath 和librarysearchpath,demo可以Build Success 但是Run的时候,刚Run起来,直接崩溃,没有任何报错,您这知道这是为何么,是不是现在这种方法不可行了,我拆分成.a形态和往项目拖的时候 应该没有问题
    Multa:@踏遍青山 是一个ziparchive的库,解压缩的,依赖库也添加了,全局没有断点,是一进程序就崩的那种,因为我需要在这个库上面再封一层,所以必须使用.a,这样的话 可能您这个方法并不是适用所有framwork转变到.a架构
    踏遍青山:我拿友盟试了下 是可以运行的,功能也没问题。你可以确认一下是否把依赖库都添加进去了,或者这个库有什么其他要求你就完全按照他的要求集成就好了。没有报错信息的话你可以把所有的断点去掉应该就能看到错误信息了。没有错误信息实在不好判断你集成的问题在哪。
  • wokenshin:楼主你好, 我在自己的framework中使用到了AFN,fmdb 等第三方库。如果我在add进自己framework的时候 不勾选 target,那么在使用我的framework的时候,项目里面就必须有这些三方库,不然就回报错。
    如果我勾选了 target,那么我的项目中就不能有这些第三方库,不然也会报错 提示 duplicate symbol。
    综上,我像知道 能不能让自己framework中的第三方库代码 和 项目中的第三方库代码完全独立呢?我问了一些朋友 说的是 修改自己sdk中的第三方库类名,还有相关的宏等。这样做工作了好大,还有更简单的方式吗?
    wokenshin:@Multa 嗯 是的,我目前也是这样做的。多谢
    Multa:木有更简单的方式了,一般来说 相对统一才是正道吧,我觉得放在项目里最合适,framwork的体积也可以减小,还可以保证项目中代码没问题,就是如果更新第三方以后,你的framwork代码需要做更改,但是你不觉得 这个工作量更小点么
  • 被偏爱的总有恃无恐:第2.5步,如果只设置编译库运行环境为Release,并分别选择编译Target Device为模拟器/Generic iOS device,运行生成两个版本的静态库.a文件,是否可以,对项目有什么影响?
    颠倒的结尾:@踏遍青山 请问一下为什么模拟器是选Debug,真机选Release。而不是要在Release模式下分别选真机跟模拟器,然后再在Debug模式下分别选择真机跟模拟器。最后将四个文件合并呢?
    踏遍青山:分别生成debug和release的静态文件是为了后面,将两种模式下静调库合成一个通用型的。如果你只需要Debug那就设置debug模式,设备选择模拟器生成即可。如果你只需要release那就设置Release模式,设备选择iOS device生成即可。不是太明白你用Release版本生成对应两种设备生成静态库的想法是什么。
  • 史思恒o_0:我在.a静态库导入了两个framework的文件, 生产.a文件后导入我自己的SDK,结果还是报错:framework not found SecurityGuardSDK for architecture arm64,这个有方法解决吗,大神?
    踏遍青山:1.不能直接导入.framework,制作步骤参照上文的<五、>。
    2.如何已经是按照上面的操作制作完成之后再导入的话,报这个错可能是没有添加这两个framework的依赖库。
  • 1104af63469b:请问xxx.embeddedframework.zip这种类型的库是怎么生成的?
    半岛夏天:xxx.embeddedframework 压缩完就成了xxx.embeddedframework.zip
    踏遍青山:没有使用过,不太清楚。
  • 粑粑又被注册了嘛:你好,想问下,自己开发的.framework里面包含其他第三方的.a这样审核能通过吗
    粑粑又被注册了嘛:@踏遍青山 那我还放心一些,谢谢哈
    踏遍青山:没问题的 已成功上线多个。
  • the_uncle:您好,我在制作.a静态库的时候,想把另外一个.a静态库给打包进去,遇到了问题.我在网上搜了很多讨论,基本说的都是最终需要把两个.a都引入到工程中才可以.只看到您这篇文章说是可以的,我按照您的文章操作了一很多遍,最终测试我制作的.a时,一直有文件找不到,想和您讨论一下,方便加下我qq:782558223,帮忙讨论一下吗?不胜感激 @踏遍青山
  • abcwuwuwu:感谢分享!
  • MissPeng:framework build 成功,写demo调用 生成framework中的对象时 返回 nil ,这是什么原因呢?
    踏遍青山:@MissPeng :+1:
    MissPeng:多谢解答 我把类引用的地方改为Embed link 就好了 不知道什么原因
    踏遍青山::flushed: 如果导入静态库之后,调用代码没报错说明静态库是没问题的,生成对象返回nil我觉得你可以检查一下调用的代码,或者检查一下你封装在静态库里的初始化方法是否初始化返回对象了
  • e6057ca73f88:ANE 使用Framework 的话,必须要 转换成 .a 才能使用吗? 直接用 framework 有成功案例吗?
    我的大名叫小爱:@e6057ca73f88 我自己做的framework (打包好的)可以直接上传cocoapods。 但是下载的第三方的比如说友盟的 framework 已经加入到文件夹中,将podspec文件修改 vendored_frameworks的时候 ,死活找不到。framework文件 , 网上查了下 好像是 这个文件目录不受信任。如果要是能够知道友盟framework的生成路径的话 。就可以跟我们自己做framework一样上传到私有库了。但是现在想想没必要 很多第三方的framework都已经支持cocoapod 只做依赖管理那就相当的爽了
    e6057ca73f88:@踏遍青山 折腾了两天,有些库能行,成功有些死活不行,改成.a 倒是都行.
    踏遍青山:@e6057ca73f88 折腾了不少天 没弄成功
  • 乐不可支的敏丫丫:demo 链接失效了啊
    踏遍青山:已更新!
  • 不辣先生:我打包framework没选定生成静态库,在导入的时候添加embed framework也可以用,我就想问楼主,如果给别人当sdk接入,别人产品上线会不会被拒?是不是所有sdk都只能明确打包为静态库,用户接入后上架才可以通过?
    不辣先生:@踏遍青山 给打包的sdk瘦身有什么好方法么?
    踏遍青山:你意思是你打包成动态库了么?静态库SDK给别人接入上架应该是不受影响的,动态库因为我们没用过也没测试过不能妄下评论。
  • 码农甲:你这样 并没有 把 百度统计跟你的库 打包在一起吧 我用你的库 还是需要单独引用百度统计的库,或者 需要把百度统计库和你的库放在同一个文件夹
    踏遍青山:@一只名叫心蓝的猫 .a的静调库是可以直接打包进自己的静调库里面的 不需要再单独引用
    码农甲:@踏遍青山 肯定需要的啊 你尝试过吗 你看看你打出的静态库多少
    踏遍青山:不需要..你只要把framework里的二进制文件后缀改成.a后缀然后拖进你的库里面,再打包就能将.a的静态库打包进你自己封装的库里面了,参考四.2
  • 1045cbb65fe0:我现在有个问题,我已经把xxx.framework改为.a文件的形式,再封装为新的.a静态库了。现在在项目中一起导入新的.a静态库和xxx.framework编译会报错,这种问题有方法解决吗?
    踏遍青山:已更新完整制作流程,请参考
    拾酥:找了一天的资料,就这个靠谱
    踏遍青山:肯定会报错吧,你两个库重复导入了 .framework和生成的.a都包含了同一个库,你这种程序中还需要调用.framework中的API的话,应该通过你生成的.a静态库里去调用.framework中的API.

本文标题:xcode制作iOS静态库SDK<包含第三方.a或者.fr

本文链接:https://www.haomeiwen.com/subject/qacrnttx.html