iOS打包framework静态库

制作 .framework 静态库的步骤:

1、将需要打包成 Framework 的模块导入到项目中,设置最低支持的 iOS 版本,编译项目保证不报错。
111.png

2、创建一个新的静态库的 Target。
221.png
222.png
223.png

3、在 TARGETS 中选中新建的静态库 Target,Build Phases 里配置文件。
224.png
225.png

4、把 Podfile 中所有库注释掉然后 pod install,然后删除 Podfile 文件同级别目录下其它所有 pods 相关的文件。

5、使用 .xcodeproj(注意不是workspace)打开项目,选中工程的 Target,在 Build Phases 下删除 Check Pods Manifest.lock 和 Copy Pods Resources。
226.png

6、打开 Podfile文件中前面注释的库,在下面为静态库 Target 添加第三方库,然后 pod install。
227.png

7、选择静态库 Target,在 Build Settings 中搜索 mach,将 Mach-O Type 改为 Static Library;搜索 Other C Flags,添加命令“-fembed-bitcode”,同样的设置在PROJECT中,如果不进行以上操作,别人在集成你的framework时可以编译,也可以真机测试。唯独在打包时会发出警告并打包失败,警告为framework不支持bitcode。
228.png
231.png
232.png

8、最后编译即可生成静态库。

打包framework注意事项:

如果有storyboard、xib,需要在对应的视图控制器中添加以下代码:

- (instancetype)initWithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil {
    NSBundle *bundle = [NSBundle bundleWithURL:[[NSBundle mainBundle] URLForResource:@"你的静态库名称" withExtension:@"framework"]];
    if (bundle) {
        // 如果是storyboard
        UIStoryboard *storyboard = [UIStoryboard storyboardWithName:@"你的storyboard名称(例如Main)" bundle:bundle];
        self = [storyboard instantiateViewControllerWithIdentifier:@"你在storyboard中设置的此视图控制器的id"];
        return self;

        // 如果是xib
        self = [super initWithNibName:@"当前控制器的名称" bundle:bundle];
        return self;
    }
    return [super initWithNibName:nibNameOrNil bundle:nibBundleOrNil];
}

如果需要加载图片:

NSBundle *bundle = [NSBundle bundleWithURL:[[NSBundle mainBundle] URLForResource:@"Frameworks" withExtension:@"framework"]];
NSString *bundlePath = [bundle resourcePath];
UIImage *img = [UIImage imageWithContentsOfFile:[bundlePath stringByAppendingString:@"/aaa.png"]];

使用图片宏:

#define Bundle_With_Framework(name) [NSBundle bundleWithURL:[[NSBundle mainBundle] URLForResource:name withExtension:@"framework"]]
#define Framework_Bundle Bundle_With_Framework(@"Frameworks")
#define ImageNamed(name) Framework_Bundle ? [UIImage imageWithContentsOfFile:[[Framework_Bundle resourcePath] stringByAppendingString:[NSString stringWithFormat:@"/%@", name]]] : [UIImage imageNamed:name]
self.img.image = ImageNamed(@"gg.jpg");

定义一个资源管理宏:

#define Debug_Env 0    // 开发环境
#define Release_Env 1  // 打包环境

#if Release_Env

#define MR_Bundle [NSBundle bundleWithURL:[[NSBundle mainBundle] URLForResource:@"StaticLibrary" withExtension:@"framework"]]
#define MR_BundleWith(res) [[MR_Bundle resourcePath] stringByAppendingPathComponent:res]
#else

#define MR_Bundle [NSBundle mainBundle]
#define MR_BundleWith(res) res
#endif

这个资源管理宏也可以写得更方便些:

#define Framework_Bundle [[NSBundle mainBundle] URLForResource:@"MRFramework" withExtension:@"framework"]

#define MR_Bundle Framework_Bundle ? [NSBundle bundleWithURL:Framework_Bundle] : [NSBundle mainBundle]
#define MR_BundleWith(res) Framework_Bundle ? [[[NSBundle bundleWithURL:Framework_Bundle] resourcePath] stringByAppendingPathComponent:res] : res

加载图片时:[UIImage imageNamed:MR_BundleWith(@"picture.png")]
加载 storyboard 时:[UIStoryboard storyboardWithName:@"Storyboard" bundle:MR_Bundle];

如果静态库中有 ClassA.h、ClassB.h、ClassC.h 三个头文件,如果只对外暴露 ClassA.h,那么 ClassA.h 中就不能引用 ClassB 和 ClassC,只能在 ClassA.m 中引用。

合并最终的静态库:

模拟器 iPhone5s 以下是 i386 架构,iPhone5s 及以上是 x86_64 架构。
真机iPhone5s 以下是 armv7 架构,iPhone5s 及以上是 arm64 架构。

终端 cd 到生成的 framework 文件夹中,使用命令 lipo -info framework名,可以看到打出的库是 x86_64 架构的。

Framework.png

如果想同时支持 i386 和 x86_64,设置:
Build Settings —> Architectures —> Build Active Architecture Only —> NO。

架构设置.png
架构查看.png

模拟器选择真机,编译之后会生成真机的 framework ,架构是 armv7 和 arm64。

真机编译.png

以上真机和模拟器的 framework都是 DEBUG 模式下的,打开 Scheme,选为 Release 模式再编译两次(真机和模拟器):

Scheme.png

使用命令:lipo -create path1 path2 -output 合成文件名
可以将真机和模拟器两个 framework 合成为一个。其中 path1 和 path2 都是下图中红圈中的文件:

合成.png

注意,一般是 debug 真机跟 debug 模拟器合成,release 真机跟 release模拟器合成,debug 和 release 不要混合,当然,两个模拟器或者两个真机合成会失败。最终会分别有一个 debug 下和 release 下的 framework。

framework静态库使用步骤:

1、将静态库拖入工程,然后在 Build Phases —> Copy Bundle Resources 中添加该静态库。

333.png

2、如果静态库中有分类(Category),则需要在 Build Settings —> Other Linker Flags 中添加 -ObjC 或 -all_load,如果静态库调用 pods 中的第三方库崩溃,则添加$(inherited)。(-ObjC链接所有OC文件,-all_load是链接所有文件,-force_load文件路径是链接指定路径文件,多个静态库文件冲突时使用-force_load,$(inherited)的含义
334.png

3、如果静态库中引用了AFNetworking等第三方库,需要工程也导入这这些库,否则会报头文件找不到的错误。
4、如果使用者导入静态库头文件报警告 missing submodule ,说明静态库中有头文件找不到。如果打包工程名和某个类的名称相同,也会报这个警告,只需要把这个类名改成其它名称即可。

参考《iOS静态库》《打包Framework并引用CocoaPods管理》
一般打包了静态库之后,还需要制作说明文档,文档制作可参考《安装和使用AppleDoc》《使用AppleDoc自动生成项目文档》

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

推荐阅读更多精彩内容