iOS创建framework静态库(SDK&组件化)
一、创建
1、新建项目
打开Xcode,菜单:File – New – Project…,选择iOS – Framework – Next,取名比如MySDK,保存。
2、修改Schemes
菜单 Project – Scheme – Edit Scheme…,Debug 改成 Release
3、修改版本号和最低适配的iOS系统版本
4、配置 Build Settings
- Base SDK:iOS(基础系统)
- Build Active Architecture Only:NO(编译所有版本的Architecture)
- Dead Code Stripping:NO(不去除被定义但未被调用的代码,瘦身可用)
- Mach-O Type:Static Library 或 Relocatable Object File(静态库类型)
- Link With Standard Libraries:NO(编译器在链接时不自动使用标准库的链接器,需配置 Other Linker Flags 来指定链接器)
- Other Linker Flags:-ObjC(如果framework中包含类目,需要添加)
- Enable Bitcode:NO(根据具体项目需求)
- Debug Information Format:DWARF(不光能提高编译效率,友盟也能分析到静态库里奔溃的地方)
5、扩展
5.1 Mach-O Type的五种类型
- Executable:可执行二进制文件,应用的主要二进制
- Dynamic Library:动态链接库(又称DSO或DLL)
- Bundle:非独立二进制文件,显式加载;不能被链接的Dylib,只能在运行时使用dlopen( )加载,可当做macOS的插件
- Static Library:静态链接库
- Relocatable Object File:可重定位的目标文件,中间结果(包体积最小)
5.2 链接库
链接库可以分为静态库和动态库,静态库有.a和.framework类型的的文件,动态库有.dylib和.framework。系统的.framework是动态库,我们自己建立的.framework是静态库。
静态库:链接时完整地拷贝至可执行文件中,被多次使用就有多份冗余拷贝。
动态库:链接时不复制,程序运行时由系统动态加载到内存,供程序调用,系统只加载一次,多个程序共用,节省内存。
二、添加代码
1、个人代码
创建两个类 MyTools 和 MyBase
添加一个方法,用于测试
// MyTools.h
// MySDK
//
// Created by 于建祥 on 2020/7/27.
// Copyright © 2020 com.jzsec. All rights reserved.
#import <Foundation/Foundation.h>
NS_ASSUME_NONNULL_BEGIN
@interface MyTools : NSObject
+(void)firstMethod;
@end
NS_ASSUME_NONNULL_END
// MyTools.m
// MySDK
//
// Created by z on 2020/7/27.
// Copyright © 2020 com.jzsec. All rights reserved.
#import "MyTools.h"
@implementation MyTools
+(void)firstMethod
{
NSLog(@"MyTools First Method");
}
@end
2、导入第三方库
在开发过程中或多或少都会用到一些第三方库,其中又分为源码和静态库,纯源码的第三方还还说,直接拖进工程。比如我们拖进MJRfresh
2.1、第三方库冲突
如果在外界的工程里也用到了MJRfresh怎么办,framework里也有就编译报错。此时如果只是引用并没有修改第三方,而且外界也用到了这个第三方,那么在把这个第三方拖进工程的时候就不要选 Add to targets !!!
有时候我们为了需求会修改第三方源码,但是又不能被外界的第三方替换了,此时可以勾选 Add to targets 把第三方打进framework,前提是要把第三方的类和文件重命名!!
2.2、第三方库为静态库
有的第三方是静态库的形式,无法修改源码,比如微信,也可直接拖进工程,根据需求勾选 Add to targets
但如果第三方库也是framework的形式怎么办呢?可以把它拆包,以我这个framework为例:
framework包的内部结构如上,我们需要把Headers整个文件夹和framework同名的静态文件复制出来,并把这个静态库文件加个后缀.a,如下把这个文件夹导入工程即可。
3、设置公开头文件
在当前target的 Build Phases 的Headers里有三个分组,默认创建的文件都在 Project 分组里,即非公开的,如果要给外面使用,就把头文件拖到 Public 分组里
创建完工程,会自动生成一个和framework同名的头文件MySDK.h,此文件里是要import我们需要暴露的所有类的头文件。比如在里面:
#import <Foundation/Foundation.h>
//! Project version number for MySDK.
FOUNDATION_EXPORT double MySDKVersionNumber;
//! Project version string for MySDK.
FOUNDATION_EXPORT const unsigned char MySDKVersionString[];
// In this header, you should import all the public headers of your framework using statements like #import <MySDK/PublicHeader.h>
#import "MyTools.h"
此处不一定非要把Public分组里的文件都导入,可以导入一些常用的,否则用户把这个头文件已导入就会导入特别多的文件,防止编译出错或编译过慢。
三、编译
编译前还要在 General 的 frameworks and Libraries 导入系统的依赖库(如果有的话)
完成前面的配置和开发工作后,运行一下项目,发现报错了:
这是因为 compatibility_version 是动态库才会用到的,需要去 Build Settings 里删掉对应的版本号:
这两个都要删除,重新运行,编译通过。
四、合成
开发完成之后,要给别人使用此framework,就要打出包,分别选择device和模拟器,运行
对Products的framework右键 Show in Finder,找到文件所在位置:
如下,真机和模拟器都对应的生成了一个framework:
要把这两个framework合成一个,才能给别人使用,否则就只能在真机或模拟器环境下使用。
合并其实就是合并的framework包里的静态库文件:
查看当前静态库支持的设备:
lipo -info 静态库文件路径
比如:
~ $ lipo -info /Users/z/Desktop/Release-iphoneos/MySDK.framework/MySDK
Architectures in the fat file: /Users/z/Desktop/Release-iphoneos/MySDK.framework/MySDK are: armv7 arm64
~ $ lipo -info /Users/z/Desktop/Release-iphonesimulator/MySDK.framework/MySDK
Architectures in the fat file: /Users/z/Desktop/Release-iphonesimulator/MySDK.framework/MySDK are: i386 x86_64
- armv7 arm64 :真机
- i386 x86_64 :模拟器
合并指令:
lipo -create 真机路径 模拟器路径 -output 输出文件路径
比如:
lipo -create /Users/z/Desktop/Release-iphoneos/MySDK.framework/MySDK /Users/z/Desktop/Release-iphonesimulator/MySDK.framework/MySDK -output /Users/z/Desktop/result/MySDK
再用lipo -info命令查看输出的合并后新的文件:
~ $ lipo -info /Users/z/Desktop/result/MySDK
Architectures in the fat file: /Users/z/Desktop/result/MySDK are: armv7 i386 x86_64 arm64
这时候得到的是:armv7 i386 x86_64 arm64
我们拷贝一份真机下的包,然后将上步中得到的合并后的文件替换进去,最终就是兼容版本包。
五、使用
接下来我们新建一个工程来测试一下新打出的framework
导入刚打出的 MySDK.framework,并添加系统依赖库和第三方依赖库(第二步导入第三方未勾选 Add to targets的),在ViewController.m导入头文件,并调用:
#import <MySDK/MySDK.h>
- (void)viewDidLoad
{
[super viewDidLoad];
[MyTools firstMethod];
}
打印出
2020-07-27 18:22:07.009337+0800 UITest[4196:227471] MyTools First Method
完成调用。
下一篇: 申请邓白氏编码的流程
推荐阅读