iOS打包framework - Swift完整项目打包Framework,嵌入OC项目使用

场景说明:

-之前做的App,使用Swift框架语言,混合编程,内含少部分OC代码。

-需要App整体功能打包成静态库,完整移植到另一个App使用,该App使用OC。

-所以涉及到一个语言互转的处理,以及一些AppDelegate的代码减除变化。

--------------------------------打包篇-------------------------------****

实现步骤:

一、新建 Project - Framework&Library - Cocoa Touch Framework,Next 语言选择Swift

image

建立完成,会看到默认生成的一个 xxx.h 和 Info.plist 文件(只看红框内)。

image

解释一下这两个文件:

1⃣️xxx.h 文件的作用是整个包对外提供的入口头文件,除了正常定义参数属性之外,还有

1、提供 Swift项目内引用的OC文件的import引用,注意,这里引用之前必须在Build Phrases的Headers内暴露到 Public,见步骤六

2、提供 第三方文件的import引用,这里的第三方管理,我们依然选择使用Pods管理,下文会具体描述。

以上两部完成后,举例效果图:

image

2⃣️info.plist ****文件的作用就如同正常项目的plist文件作用,用来定义或添加一些属性。

二、添加文件,这里可以自己新建,或者从已有项目拷贝过来都可以。

这里要注意一下:由于打包类库工程不是一个完整项目工程,所以并没有AppDelegate等文件,所以涉及到这些的文件要额外处理,或改代码,或适当改变功能。

注意:工程如果有桥接文件,是不能拷贝过来的,否则编译不通过。

原因见步骤五。

三、如果有第三方类库引用,添加第三方库文件,有几个注意点:(没有第三方可以跳过这步)

a、第三方库依然使用Pods进行管理,添加方法同正常项目一样。

b、引用的时候,我们需要添加 【use_frameworks!】来告诉pod 生成动态库文件Framework类型,这样做的好处是在正式项目用到本类库的时候,如果两者第三方库有引用冲突,可以根据冲突类库,对本类库引入的这些依赖库进行移除。

image

但有时第三方类库只有 .a 类型的,怎么办?

解决:如果第三方库只有.a类型,就需要手动把库文件拷贝到项目,而不能通过pod添加,否则在往步骤1内的头文件添加import时会找不到文件,造成报错。

四、以上三部做完,本类库的雏形基本已经具备了,参考如下:

image

红框1:自己的业务代码
红框2:类库原有文件
红框3:添加的资源文件
红框4:引入的第三方,pod管理

PS:这里涉及到一个资源文件的问题,比如图片、视频、音频等的处理。

之前正常项目的做法可能是这样,

1:直接用Assets.xcassets

2:新建resources文件夹,存放图片

但这里,需要注意一点:

对于方法1,这样做是无效的,我们可以新建一个bundle文件,将图片移植过来。

对于方法2,我们可以在本地,直接修改添加后缀.bundle实现

然后另一个重点就是路径问题:

由于类库的资源文件,当我们在正式项目使用时,查找的路径文件不是针对项目,而是针对类库的路径,所以我们这里引用的资源文件路径都要改变一下,而且类库里的其他xib、storyboard文件引用路径都需要更改一下。

修改办法就是:在代码的引用处添加前缀。

定义前缀:

image

如图:

resourceRooturl是xib、storyboard文件前缀路径。

resourceImagesRooturl是图片文件前缀路径。(需要添加一层/images.bundle/)

这个路径怎么来的呢?

Frameworks/XXXX.framework/ 其中XXXX就是你建立的类库名称。

如何引用呢:在代码引用的地方,这样改动

image
image

注意:这里我说的只是针对Framework包里使用图片的路径需要修改。如果外部项目需要使用包内的图片资源,暂未测试,理论上不需要修改。

五、文件都基本添加完毕,可以尝试build一下了

理论上:

只要类库xxx.h文件内,对于使用的oc头文件和第三方头文件,都添加正常引用申明了,就不会有问题。

而且一般报错,也都是因为这里没做好或遗漏的缘故。

此外:如果项目都是纯swift文件(没有混编使用oc文件),这里xxx.h文件只需要导入第三方头文件即可(如果有使用第三方,没有的话基本什么都不用做)。

=======================这里解释一下,xxx.h文件为什么要这样做:=================

因为正常情况下,如果我们swift项目引入了oc文件,我们必须通过一个桥接文件来处理两者之间的转换,而我们在新建类库包的时候,是禁止桥接文件存在的,即使你添加了,也会永远编译不过,打包不了。

所以这里就用到这个 xxx.h 头文件了。

我们可以通过这个文件来实现两者之间的转换,前提就是必须先将oc的.h暴露出来,否则即使你import,也会报错找不到.h 文件。

(这里有个问题,如果oc文件过多,这里需要暴露的就很多,而这里太多的话,一个是不美观,第二是后面项目引用本类库都是能看到这些文件的。所以,能不能通过一个文件,来装载这些所有文件,达到只需要一个文件暴露就行的效果,如果有人实现了,欢迎指导一下,不甚感激。)

六、暴露文件给外部使用

到这里基本就快完成了,那么我们打包的目的就是给外部使用,怎么暴露文件出来呢?

image

1、将我们要暴露的swift文件拖到Public内即可。

2、将需要暴露的swift文件的访问权限申明为public属性。

image

两步缺一不可。

七、编译通过,查看这里

image

红框内就是最终我们得到的Framework包。

右击本地查看,会看到本类库以及对应的依赖第三方库包,后面在其他项目引用的时候,这些都是需要的(需要一起拷贝添加)。

PS:如果没有引用第三方,这里只需要本类库包即可。

** ------------------------------引用篇------------------------------**

1、我们新建一个空的工程,由于我的业务需要,这里工程语言选择OC。

2、新建Framework文件夹,拷贝之前所有的framework包到文件夹内。

3、在工程Targets-General-EmbeddedBinaries内添加Frameworks包

image
image
image

4、由于我的类库包是基于swift建立的,这里oc使用的话,必须设置一个属性:

image

5、由于我们自己的工程都有自己的第三方库引用,这里如果发现两者之间有冲突或重复引用,解决如下:

a:如果pod引用内,没有标注  use_frameworks!    我们先加上这句话,并pod update,目地是保持两边引用的第三方类库都是Framework类型。

b:移除刚才添加过来中的重复类库,比如AFN

6、添加完,我们就可以在新项目使用类库集成的功能了

这边引用的时候有点特殊:

我们只需要把一个文件import即可,而不需要把每一个需要使用的swift文件import。

举例如图:

image

这个文件是系统帮我们自动生成的一个转换文件,我们要暴露的文件,系统都已经帮我们自动转换后储存在这个文件内,很强大,有么有!!!

比如:我的登录页面 login.swift文件暴露给外部,需要提供入口,我们使用的时候,是不需要import login.swift的,即使你想import,也会发现找不到!!

如果你点进去红框文件,会发现类似这样的内容:

image

所以我们使用的时候,头部只需要import一个文件,下面使用的时候,该使用哪个类就使用哪个类。

前提就是:在打包的时候,你已经把这个文件 添加到Public里了,并且申明了public属性,否则是找不到该文件的。

最后,把我过程中遇到的一些问题纪录一下

引用集成时遇到的坑:

==================================报错1:==================================

dyld: Library not loaded: @rpath/AFNetworking.framework/AFNetworking

这里是因为只引用了之前的类库本身,没有将类库自身的依赖库一并引用过来,

解决办法:

方法1:

image

方法2:

按照我的引用篇-步骤3去做,在general处,全部添加,就不会报这个问题。

==================================报错2:==================================

dyld: Library not loaded: @rpath/libswiftCore.dylib

解决办法:

按照我的引用篇-步骤4去做 ,设置属性为Yes。

Xcode8升级之后属性名称有所变化:

参考我这篇博文

==================================报错3:==================================

Unknown class in Interface Builder file .... image not found 等

解决办法:

参考我这篇博文

==================================报错4:==================================

load storyboard 或xib 崩溃

解决办法:

是因为打包的地方引用文件路径没有改动,需要加上类库前缀路径,详见打包篇-步骤四。

** -----------------------打包合并真机和模拟器------------------------**

详细内容有点多:

参考我这篇博文

若还有其他问题欢迎留言。

enjoy~~

原文:https://www.cnblogs.com/yajunLi/p/5987687.html
作者:那一抹风情

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,716评论 4 364
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,558评论 1 294
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,431评论 0 244
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,127评论 0 209
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,511评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,692评论 1 222
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,915评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,664评论 0 202
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,412评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,616评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,105评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,424评论 2 254
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,098评论 3 238
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,096评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,869评论 0 197
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,748评论 2 276
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,641评论 2 271

推荐阅读更多精彩内容