iOS 静态库 和 bundle

• 开源库
  公开源代码，能看到具体实现，如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

• 创建SDK需要的目录和文件

image.png

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

image.png

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

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

image.png

image.png

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

image.png

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

image.png

image.png

在项目工程中导入framework

• 直接拖入工程

image.png

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

image.png

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

image.png

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