iOS最新制作Framework总结

人月神话-Lee

已于 2023-07-06 17:17:57 修改

阅读量2k

点赞数

分类专栏： iOS 文章标签： ios xcode macos

于 2022-11-29 12:02:00 首次发布

本文链接：https://blog.csdn.net/FreakCoder_Lee/article/details/128095318

版权

iOS 专栏收录该内容

5 篇文章 1 订阅

订阅专栏

文章提纲.png

去年为公司开发了自己的SDK供外部客户使用，一直没来得及写个总结，最近时间稍微宽松点，写两篇文章总结一下iOS中Framework制作的流程。本文不会介绍iOS中静态库、动态库的基础知识，只是图文详解iOS中Framework的制作。（开发工具为Xcode14.0）

一、 Framework牛刀小试

1、新建一个iOS Project（Static Library制作大同小异，不在本文讨论范围内），随意取个中意的名字LMBaseKit。
新建Framework.png

如果上面不是选择iOS系统，而是macOS或者其它的系统，可在Xcode中【Targets】->【Build Settings】->【Base SDK】中切换为iOS系统，如下图所示。
修改Base SDK.png

修改Mach-O Type为Static Library（静态库）
修改Mach-O Type.png

2、导入或者新建几个类文件，公开需要给外部调用的头文件。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-kQHR4LZQ-1669694129987)(https://upload-images.jianshu.io/upload_images/284350-480ea38c1c30cb85.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)]

如上图所示在Xcode中【Targets】->【Build Phases】->【Headers】下Project中选择需要公开的头文件拖入到Public下面。比如此处简单写了三个类LMBaseKitManager、LMNetworkManager、LMLogManager，把前两个公开了。修改头文件权限类型还有一个方法，如下图所示。
改头文件权限类型.png

3、把Public中的头文件导入到项目头文件里（项目同名的头文件，系统自动生成）
导入头文件.png

4、创建Aggregate Target，如下图所示。Aggregate，翻译过来就是聚合的意思，在这里我们可以理解为模拟器和真机的聚合，即生成的Framework可供模拟器跟真机都可使用，而不用分别打模拟器和真机的独立包。
创建Aggregate.png

选中上图生成的LMBaseKitAggregate，为其添加依赖。
添加依赖.png

点击Target Dependencies下方的“+”，选中最开始创建的Framework对应的Target，点击“add”即可。
添加依赖.png

5、修改Target的Scheme
修改Scheme.png

分别把两个Target的Run模式的Build Configuration改为Release。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-3VXf8IT5-1669694129993)(https://upload-images.jianshu.io/upload_images/284350-aed6709e201600a0.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)]

6、创建打包脚本。选中聚合Target，点击左上角的“+”，选中New Run Script Phase。
添加打包脚本.png

在Run Script中添加如下脚本。脚本的作用是将模拟器包和真机包合并成一个聚合包，并将聚合包放在项目根目录下的Products文件夹中。

    if [ "${ACTION}" = "build" ]
then
INSTALL_DIR=${SRCROOT}/Products/${PROJECT_NAME}.framework
 
DEVICE_DIR=${BUILD_ROOT}/${CONFIGURATION}-iphoneos/${PROJECT_NAME}.framework
 
SIMULATOR_DIR=${BUILD_ROOT}/${CONFIGURATION}-iphonesimulator/${PROJECT_NAME}.framework
 
 
if [ -d "${INSTALL_DIR}" ]
then
rm -rf "${INSTALL_DIR}"
fi
 
mkdir -p "${INSTALL_DIR}"
 
cp -R "${DEVICE_DIR}/" "${INSTALL_DIR}/"
#ditto "${DEVICE_DIR}/Headers" "${INSTALL_DIR}/Headers"
 
lipo -create "${DEVICE_DIR}/${PROJECT_NAME}" "${SIMULATOR_DIR}/${PROJECT_NAME}" -output "${INSTALL_DIR}/${PROJECT_NAME}"
 
#open "${DEVICE_DIR}"
open "${SRCROOT}/Products"
fi

脚本.png

7、生成Framework。先选择Framework对应的Target分别在模拟器跟真机上都run一遍。这里分别选择了iPhone 14跟Any iOS Device（也可选择自己的真机）。

然后选中聚合Target也运行一遍，就生成了Framework啦，并在Finder中打开了。
生成Framework.png

8、检查Framework有效性。打开电脑终端，进入到所在目录。利用lipo命令输出.framework下的LMBaseKit文件信息。如下所示：lipo -info LMBaseKit，显示为fat file，则表明是模拟器和真机的聚合包。fat file，顾名思义，胖文件。相应的，非聚合包就是瘦文件，则输出Non-fat file: LMBaseKit is architecture: arm64之类的
检测Framework.png

9、使用Framework。创建一个测试项目LMBaseKitDemo，把上面生成的LMBaseKit.framework导入项目中，在AppDelegate导入framework的头文件。在模拟器跟真机上分别运行，都可达到预期效果。至此，一个完整的Framework算是制作完成。
真机效果.png

简单开启一下SDK的日志功能。
模拟器效果.png

二、Framework外部依赖第三方库

自定义Framework有时可能需要借助其它优秀的第三方库。自己的Framework使用第三方库分两种情况：外部依赖、内部依赖。通常我们建议那些最常用的第三库使用外部依赖，比如AFNetworking、高德地图SDK等。接下来，以外部依赖高德SDK为例，说明一下自定义Framework时如何引入第三库。

1、在上面的LMBaseKit项目中导入高德地图SDK，注意要取消勾选Add to targets，这是最关键的一步
导入第三方库.png