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 导入系统的依赖库（如果有的话）

1、完成前面的配置和开发工作后，运行一下项目，发现报错了：

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

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

2、还有可能有一种编译报错：

error: ***.framework' in the Link Binary With Libraries build phase is using platform filters which is not supported in the legacy build system.

有两种解决办法：

project Setting中修改为“New Build System”
Build Phases 中 link binary with Libaries 中对应报错的framework 的Platforms 修改为macOS + iOS

四、合成

开发完成之后，要给别人使用此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

完成调用。