iOS之深入解析构建静态库

Posted Forever_wj

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了iOS之深入解析构建静态库相关的知识,希望对你有一定的参考价值。

一、.a 文件静态库打包

  • ① 打开 Xcode 创建一个新的 Static Library 工程,取名 MyStaticLibrary:

  • ② 创建工程完毕后,系统自动创建了一个同名类:

  • 添加一个方法用于测试:
	#import <Foundation/Foundation.h>
	
	@interface MyStaticLibrary : NSObject
	
	+ (void)test;
	
	@end

	@implementation MyStaticLibrary

	+ (void)test {
	    NSLog(@"Hello");
	}
	
	@end
  • ③ Command + B 运行工程进行打包,运行完毕后,在工程中 Products 文件夹下的 libMyStaticLibrary.a 文件由红色变成了黑色。右键 show in finder 可以在其目录下找到它,这就是打包好的 .a 静态文件。

  • ④ 公开接口头文件:
    • targets -> Build Phases -> Copy Files -> “+” 添加你需要公开的头文件,可以多添加几个类:

    • 公开头文件后,Command + B 重新运行打包,会得到一个 include 文件夹和一个 .a 静态库:

  • ⑤ 新建一个可运行的工程,把这两个打包好的文件拖入项目测试:

    • 选择 iPhone 8 模拟器运行,执行程序,可以看到日志输出没有问题,即打包 .a 静态库大功告成。
    • 别高兴的太早,当把模拟器切换成 iPhone5 运行时,编译直接不通过,报错如下:
	warning:ignoring file /Users/ydw/Desktop/Demo/Demo/libMyStaticLibrary.a file was built for archive which is not the architecture being link(i386):/Users/ydw/Desktop/Demo/Demo/libMyStaticLibrary.a
	Undefined symbols for architecture i386:
	"_OBJ_CLASS_$_MyStaticLibrary",referenced form:
	objc-class-ref in AppDelegate.o
	symbol(s) not found for architecture i386
	error:linker command failed with exit code 1 (use -v to see invocation)
    • Undefined symbols for architecture i386 的意思是 libMyStaticLibrary.a 静态库不支持 i386 架构,即 32 位模拟器。iPhone5 模拟器正好是 i386 架构,打包的静态库不支持。但是 iPhone8 模拟器运行却没有问题,这说明打包的静态库支持 iPhone7 模拟器的 cpu 架构 x86_64。那么,如何查看静态库所支持的架构呢?
  • ⑥ 终端查看静态库所支持的架构:终端 -> cd 进入库文件路径 -> lipo -info 库名,可以看到静态库仅支持 x86_64 架构,所以运行 iPhone5 模拟器时,编译会报错:
	 lipo -info /Users/ydw/Desktop/Demo/Demo/libMyStaticLibrary.a
	 Non-fat file:/Users/ydw/Desktop/Demo/Demo/libMyStaticLibrary.a is architecture x86_64
  • ⑦ 设置适配所有模拟器架构:
    • project -> buildSeting -> Build Active Architecture Only 设为 NO,Valid Architectures 添加 arm7、arm7s 等架构,注意工程 ios Deployment Target 设置为较低版本,如 8.0,不然不会有 i386。

    • 设置完成后,重新 Command + B 运行打包静态库文件(这时你可随便选一个模拟器),按照上述的终端查看其支持的架构,可以看到终端输出的结果是同时支持 i386 和 x86_64,这也就意味着同时支持所有模拟器:
	[Debug-iphonesimulator] $ lipo -info libMyStaticLibrary.a
	Architecture in the fat file: libMyStaticLibrary.a are i386 x86_64
    • 到这里打包 .a 静态库已经告一段落,但是按上述流程打包的只能在模拟器上跑,真机是不能运行的,因为 iOS 真机设备跟模拟器的架构又不一样,继续处理。
  • ⑧ 打包支持真机架构的静态库
    • 所有流程都跟上面的一样,只是运行打包时要选择真机运行,如下图可以选择 Xcode 识别的真机,也可以选择 Generic ios Devices,当然不要忘记了设置支持所有真机机型架构: Build Active Architecture Only 设为 NO。
    • 看下打包出来的 .a 文件,终端查看结果如下:
	[Debug-iphoneos] $ lipo -info libMyStaticLibrary.a
	Architecture in the fat file: libMyStaticLibrary.a are armv7 armv64
    • 可以看到同时支持 armv7 和 arm64,也就是支持所有 iOS 设备。好了到此打包 .a 静态库算是告一段落。
  • ⑨ 如果要同时支持模拟器和真机,请使用命令合成 .a 静态库:
	lipo -create \\[name1.a 所在路径\\] \\[name2.a 所在路径\\] -output \\[newname.a\\]

二、.frameworke 文件静态库打包

  • ① Xcode 创建一个新的工程 MyFrameworkLib,选择工程如下:

  • 创建完成后可以看到,工程本身自带一个 MyFrameworkLib.h 文件,这是类似一个主头文件一样的东西:

  • ② 创建需要测试的类:
	#import <Foundation/Foundation.h>
	
	@interface MyFramework : NSObject
	
	+ (void)test;
	
	@end
	
	@implementation MyFramework
	
	+ (void)test {
	    NSLog(@"Hello");
	}
	
	@end
  • ③ 设置支持所有模拟器架构或真机架构(和打包 .a 第 ① 步骤一样);
  • ④ 公开头文件:target -> Build Phases -> Headers -> 把需要公开的头文件从 project 拖入 Public:

  • ⑤ 设置打包的是静态库:
    • 因为动态库也可以是以 framework 形式存在,所以需要设置,否则默认打出来的是动态库(注意:如果要上线 AppSotre,一定要改成静态库,否则审核通不过);
    • target -> BuildSetting -> 搜索关键字 mach-> Mach-o Type 设为 Static Library(这个默认选项是动态的);

  • ⑥ 选中真机或模拟器运行设备打包(与打包 .a 一样),完成后 Products 文件夹下的 MyFrameworkLib.framework 文件由红色变成了黑色,右键 show in finder 显示如下:

    • MyFrameworkLib.framework 拖入项目便可直接使用。此外还要补充的一点是,打包静态库的时候还需注意打包的是测试版(Debug)还是发布版(Release),这个根据自己的需求决定,那么如何进行设置呢?
  • ⑦ 设置打包静态库的测试版和发布版(.a 和 .frameworke)
    • product -> scheme -> Edit scheme -> Run -> 选择 Debug 或 Release:

    • 如果要同时支持多种架构,和 .a 类似,需要设置 Build Activ Architecture Only = NO 和 iOS Deployment Target:

  • 如果要同时支持模拟器和真机,和 .a 类似,使用命令合成 framework 库,将生成的 MyLib 替换掉任何一个里面的 MyFrameworkLib 文件。
	lipo -create [.framework/] [.framework/] -output newname

以上是关于iOS之深入解析构建静态库的主要内容,如果未能解决你的问题,请参考以下文章

iOS之深入解析静态Pod与动态Pod

iOS之深入解析构建动态库与framework动态更新

iOS之深入解析插件化架构

HarmonyOS之深入解析编译构建的配置和代码混淆

iOS之深入解析CocoaPods的GitLab CI与组件自动化构建与发布

iOS之深入解析Cocoapods的工作原理与源码分析