欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

iOS创建framework静态库(SDK&组件化)

程序员文章站 2024-03-22 21:52:16
...

一、创建

1、新建项目

打开Xcode,菜单:File – New – Project…,选择iOS – Framework – Next,取名比如MySDK,保存。

iOS创建framework静态库(SDK&组件化)

2、修改Schemes

菜单 Project – Scheme – Edit Scheme…,Debug 改成 Release

iOS创建framework静态库(SDK&组件化)

3、修改版本号和最低适配的iOS系统版本

iOS创建framework静态库(SDK&组件化)

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

iOS创建framework静态库(SDK&组件化)

添加一个方法,用于测试

//  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

iOS创建framework静态库(SDK&组件化)

2.1、第三方库冲突

如果在外界的工程里也用到了MJRfresh怎么办,framework里也有就编译报错。此时如果只是引用并没有修改第三方,而且外界也用到了这个第三方,那么在把这个第三方拖进工程的时候就不要选 Add to targets !!!

iOS创建framework静态库(SDK&组件化)

有时候我们为了需求会修改第三方源码,但是又不能被外界的第三方替换了,此时可以勾选 Add to targets 把第三方打进framework,前提是要把第三方的类和文件重命名!!

2.2、第三方库为静态库

有的第三方是静态库的形式,无法修改源码,比如微信,也可直接拖进工程,根据需求勾选 Add to targets

iOS创建framework静态库(SDK&组件化)

但如果第三方库也是framework的形式怎么办呢?可以把它拆包,以我这个framework为例:

iOS创建framework静态库(SDK&组件化)

framework包的内部结构如上,我们需要把Headers整个文件夹和framework同名的静态文件复制出来,并把这个静态库文件加个后缀.a,如下把这个文件夹导入工程即可。

iOS创建framework静态库(SDK&组件化)

3、设置公开头文件

在当前target的 Build Phases 的Headers里有三个分组,默认创建的文件都在 Project 分组里,即非公开的,如果要给外面使用,就把头文件拖到 Public 分组里

iOS创建framework静态库(SDK&组件化)

创建完工程,会自动生成一个和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 导入系统的依赖库(如果有的话)

完成前面的配置和开发工作后,运行一下项目,发现报错了:

iOS创建framework静态库(SDK&组件化)

这是因为 compatibility_version 是动态库才会用到的,需要去 Build Settings 里删掉对应的版本号:

iOS创建framework静态库(SDK&组件化)

这两个都要删除,重新运行,编译通过。

四、合成

开发完成之后,要给别人使用此framework,就要打出包,分别选择device和模拟器,运行

iOS创建framework静态库(SDK&组件化)

对Products的framework右键 Show in Finder,找到文件所在位置:

iOS创建framework静态库(SDK&组件化)

如下,真机和模拟器都对应的生成了一个framework:

iOS创建framework静态库(SDK&组件化)

要把这两个framework合成一个,才能给别人使用,否则就只能在真机或模拟器环境下使用。

合并其实就是合并的framework包里的静态库文件:

iOS创建framework静态库(SDK&组件化)

查看当前静态库支持的设备:

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

iOS创建framework静态库(SDK&组件化)

导入刚打出的 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

完成调用。