iOS 静态库和 bundle

2024-04-09 19:10:30 阅读数 3218

开源库
公开源代码，能看到具体实现，如SDWebImage，AFNetworking
闭源库
不公开源代码，是经过编译后的二进制文件，看不到具体实现，主要分为静态库和动态库
静态库和动态库的区别
1、形式上
静态库是.a 和 .framework。动态库是.dylib和 .framework ，xcode8 为.tbd ，本质是.dylib
2、使用上：
静态库，链接时，会被完整的复制到可执行文件中，如果多个APP 使用了同一个静态库，就会有多次拷贝，会占用更多的内存。
动态库，链接时不复制，程序运行时由系统动态的加载到内存，供程序调用，系统只加载一次，多个程序共用，节省内存。
静态库的使用场景
1、制作SDK - 软件开发工具包。
- 如“百度地图”，它想让开发者在程序中集成百度地图，但是百度又不想公开自己的技术
- 百度将自己的核心代码编译成静态库，对外暴露统一的接口，开发者集成静态库，并且调用静态库即可集成

2、公司在开发项目时的核心代码

公司一般在开发一个项目时，肯定有一部分代码是核心代码
如果任何人都可以拿到这个核心代码，那么一旦有人离职，公司的核心代码就会被泄露，那么如何防止这种情况的发生
公司一般都会抽出一部分核心团队成员，专门开发这部分核心代码。开发完成后，将核心代码编译成静态库给其他的程序员调用。
创建静态库
在创建静态库时，有以下两种选择

image.png

看一下 framework 和 Static Library 的区别

framework 既可以制作静态库，也可以制作动态库。
Static Library 制作静态库
framework 实际上为一站式分享方案，其实是一个文件夹，其中包含代码签名，头文件，二进制执行文件，静态资源文件等，
static Library 的产出物只是一个.a 文件，为二进制执行文件。分享给别人的时候，头文件，静态文件需要另外提供
staticLibrary 需要设置头文件搜索路径，framework 不需要

对外部代码依赖库的区别

staticLibrary 能够只引用外部库的头文件，调用外部库的公开方法，而不引入其库实现，实现与引用库的分离部署
framework 要引用一个外部库，就必须要将此外部库的实现放入framework内编译才行。如果想要达到StaticLibrary 的效果，可以使用运行时方式调用。

运行环境的区别

staticLibrary 共享其运行环境，假如其运行环境中包含库中的一个类，会发生代码冲突，必须隔离其中一方的此类，然后共享此类。
framework，与其运行环境隔离，假如其运行环境中包含库中同一个类，不会发生冲突，同名的两个类会在各自的环境中独立运行，互不干扰，哪怕是单利类

如何选择两种库

假如不想在同一个APP中包含多份三方库（减小包大小），可以使用staticLibrary，库本身和APP共享第三方。但是产出物的结构可能会比较乱
假如不想考虑和APP的代码冲突问题，库本身独立使用需要的库，想提供比较好的库结构，可以使用framework。假如库本身和APP都使用了同一个三方库，会存在两份三方库，会增加包大小。

framework 的结构

image.png

制作 .framework 静态库（闭源库）

xcode打开，command+shift+N，新建framework 工程

image.png
下面是framework 工程

image.png
配置工程，选择工程名-》General，选择支持的系统和平台

image.png
非必选属性设置
build settings > Dead Code Stripping -> NO ， Link with Standard Libraries -> NO
有的博客里说要将这两个属性设置为NO，但在xcode7以后不需要再把它们设置为NO。
Dead Code Stripping ，如果开启此项，就会对代码的“dead”，“unreachable” 的代码过滤，能起到一定的优化作用，但是优化效果一般，对于比较小的项目甚至没有什么优化提现。Dead Code Stripping 是对程序编译出的可执行二进制文件中没有被实际使用的代码进行剥离，也就是消除无效代码。
Link with Standard Libraries 如果激活此设置，那么编译器在链接过程中会自动使用通过标准库的链接器。如果使用NO，需要配置Other Linker Flags 来指定链接器。

image.png

Generate Debug Symbols 在release 模式下设置为NO，debug 模式下设置为YES，是为了framework瘦身，为了进行代码调试，如果设置为NO，debug模式将不能进行断点调试，大约可以减少30%体积（非必选）

image.png

必选配置
Build Settings >>Build Active Architecture Only -> NO，如果设置为YES，会导致编译器只生成当前CPU架构，这个适合在debug 模式下测试使用。
如果设置为NO，模拟器编译后生成的framework 同时包含x86_64 和 i386 架构。真机包含 armv7,arm64 架构。
静态库配置
Build Settings >> Mach-O Type >> Static Library
对于Mach-O type 有两种类型 Static Library 是静态库，Relocatable Object File 是动态库。

image.png

可测试后再配置
Build Settings -> Excluded Architectures,在模拟器模式下选择该项，添加arm64 架构，如果不设置此项，在xcode12 生成的模拟器版本 framework 会多一个arm64架构，这和真机模式下的架构有所冲突，会导致合并不成功。真机模式下不要添加此项。

image.png

公开头文件
把你想要对外公开的.h 文件放到public 中，不想公开的就放在project 中。然后不要忘记在framework名称.h里面导入你公开的头文件。

image.png

创建bundle 文件

第一种直接创建文件夹，修改后缀名为.bundle
bundle 文件是静态的，不参与项目的编译，而xib 是文本文件，编译后要被序列化为二进制的nib 文件，使用的时候将nib 文件反序列化就可以使用了。如果你的bundle 里没有xib 文件，只需要创建文件夹，修改后缀名就可以。如果你的bundle里打算包含xib 文件，那么就必须使用第二种方法，创建工程的形式将xib 序列化为nib 文件。
创建工程的形式
iOS 创建bundle（xcode 13） https://www.jianshu.com/writer#/notebooks/21593564/notes/57586788

在framework 中添加bundle 资源

将上文中创建的bundle 文件拖入到framework工程，拖入后 copy bundle resources 中会自动引入。

image.png

command +B编译工程，在debug 和release 模式下分别选择真机和模拟器，在这里我用于测试，所以选的debug 模式，如果只为了测试也可以只选择真机或者模拟器。两个都选的话，后期要合并。
上文中提到，在模拟器中要添加 arm64（上文有步骤，也可以亲自测试后再添加），防止合并中起冲突。
编译后 command +, 此图为模拟器中的framework，可以查看它支持的架构
lipo -info “绿色框地址”，i386，x86_64

image.png

同样的方式在真机下编译，查看架构

image.png

合并两个静态库，将合并后的输出路径替换掉其中一个路径（模拟器或真机下的 framework 路径）
合并命令lipo -create "模拟器路径" “真机路径” -output "真机路径" （此处路径都是以上截图绿色框路径）

image.png

此处我替换的是模拟器路径，所以将替换后的framework拿出来就行了，也可以测试一下合并后支持的架构

image.png

在项目工程中导入framework

直接拖入工程

image.png

如果framework中包含了分类，那么要在使用framework的工程里配置一下
build settings里为Other Linker Flags 添加 -ObjC

image.png

如果framework有bundle 资源，选择添加copy files

image.png

项目工程中使用，在用的地方导入 framework 的头文件，就可以使用公开的头文件和方法

image.png

工程和 framework 中使用bundle 资源

    NSString *bundlePath = [[NSBundle mainBundle] pathForResource:@"LHNetwork.framework/HLNetworkSource" ofType:@"bundle"];
    
    NSLog(@"bundlePath = %@",bundlePath);
    
    NSBundle *bundle = [NSBundle bundleWithPath:bundlePath];
    NSString *pic1 = [bundle pathForResource:@"bill_head_bg@2x" ofType:@"png"];
    
    NSLog(@"pic1 = %@",pic1);
    
    UIImage *image = [UIImage imageWithContentsOfFile:pic1];
    
    NSLog(@"image = %@",image);

还有一种，framework 中不用引入bundle，直接把bundle 导入项目工程，手动拖入就行

image.png

那么在工程和 framework中就可以用以下方式使用bundle中资源

    NSString *bundlePath = [[NSBundle mainBundle] pathForResource:@"HLNetworkSource" ofType:@"bundle"];

    NSLog(@"bundlePath = %@",bundlePath);

    NSBundle *bundle = [NSBundle bundleWithPath:bundlePath];

    NSString *imagePath = [bundle pathForResource:@"bill_head_bg@2x" ofType:@"png"];

    NSLog(@"imagePath = %@",imagePath);

    UIImage *image = [UIImage imageWithContentsOfFile:imagePath];

    NSLog(@"image = %@",image);

    imageView.image = image;

另一种将framework 导入工程的方式

直接将xxx.framework SDK拖入工程不太方便测试，在工程中看不到源代码，我们可以把framework的工程文件导入，就是创建的framework工程

image.png

至于导入的方式，可以参考我的另一篇文章多工程联编
这样很方便的修改和调试。

注意

有的博客说，在上架App Store的时候，会有报错。可能需要把info.plist文件中的Excutable file删除，大家可以试一下，我没有实际操作。

补充说明，设备CPU架构

image.png

参考文章：
https://blog.csdn.net/jingcheng345413/article/details/54969324
https://www.cnblogs.com/mtystar/p/6082363.html