.framework 静态库制作

一、前言

应用uni-app开发Hybrid APP过程中，若框架本身无法实现，则需要通过封装原生插件的方式实现。此篇博文主要讲解.framework静态库制作及功能验证。原生插件实现后，可通过《跨平台应用开发进阶(六) ：uni-app实现原生插件集成》博文查看。

二、.framework 静态库制作

打开Xcode，点击File-New-target..，选择iOS菜单下的Framework，命名为FrameworkTest。

在FrameworkTest工程里面新建Test类，.h文件暴露一个方法test，.m写入test方法的实现。

test.h

#import <Foundation/Foundation.h>

NS_ASSUME_NONNULL_BEGIN

@interface Test : NSObject

- (void)test;

@end

NS_ASSUME_NONNULL_END

test.m

#import "Test.h"

@implementation Test

- (void)test
{
    NSLog(@"test method");
}

@end

把Test.h头文件设置为public，点击FrameworkTest，在Build Phases选项下面，把Test.h文件拖入到public里面。

注⚠️：这一步确保任何使用你的库的用户均可以获取该头文件。
显然，所有包含在你的公共头文件中的头文件必须是对外公开的，这一点非常重要。否则，开发者在使用你的库时会得到编译错误。如果Xcode在读取公共头文件时不能读到你忘记设为public的头文件，这实在是太令人沮丧了。

选中FrameworkTest这个target，在General选项卡设置Mach-O类型为static library。

点击FrameworkTest的Edit scheme，设置Run里面的Build Configuration为Release。

在编译目标上选择Any iOS Device(arm64)，按下Command+B进行编译。

在Xcode的Products目录，选择Show Build Folder in Finder，可以看到静态库已经生成了（若项目中未看到Products 目录，可参考第四部分解决。）。Release-iphoneos代表的是真机的静态库，Release-iphonesimulator代表的是模拟器的静态库。

三、.framework 静态库功能验证

新建一个项目命名为iOSProject，在iOSProject目录点击add files…，添加上一步生成的模拟器的静态库。

在ViewController的头文件中增加头文件引入

#import <FrameworkTest/Test.h>

在ViewController的viewDidLoad方法里面写入代码，代码可以在模拟器正常运行。

Test *obj = [[Test alloc] init];
[obj test];

四、延伸阅读： Xcode13 新建项目 Products 目录显示方法

首先打开项目，然后进入到项目目录并打开project.pbxproj文件

1. show in Finder 找到项目在电脑上的位置；
2. 右键点击xxx.xcodeproj -> 选择显示包内容；
3. 右键点击project.pbxproj -> 选择Xcode等工具打开文件；

搜索productRefGroup 关键字，搜索结果可能有多个，每个项目的键值不一样具体看自己的项目。注意看productRefGroup的注释 为/* Products */ 才是我们要修改的

mainGroup = ACA41EDA27868EE700DFCFA8;
productRefGroup = ACA41EE427868EE700DFCFA8 /* Products */;

将上面 mainGroup 对应的值复制给 productRefGroup的值，如下：

mainGroup = ACA41EDA27868EE700DFCFA8;
productRefGroup = ACA41EDA27868EE700DFCFA8 /* Products */;

保存 project.pbxproj文件，Xcode将自动刷新，这时候 Products 目录就出现了。

五、拓展阅读

• 《iOS专栏》
• 《跨平台应用开发进阶(六) ：uni-app实现原生插件集成》