【iOS开发】 iOS最新制作Framework总结

文章提纲.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、导入或者新建几个类文件,公开需要给外部调用的头文件。


公开头文件.png

如上图所示在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。


修改Scheme.png

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(也可选择自己的真机)。


run.png

然后选中聚合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

2、添加上面未加入Target的两个库的路径。如下图所示,注意如果是.a文件形式的第三方库则要加在Library Search Paths里。


添加Search Path.png

3、Framework内部导入第三方库需要用到的相应头文件。然后按照普通Framework的制作流程弄完导出就可以用了。


image.png

4、外部使用Framework。除了导入我们自定义的Framework(这里为LMBaseKit.framework)外;还要导入要依赖的第三方库以及第三库所需要的系统库,比如这里的高德SDK,像平时使用高德SDK一样正常接入。


使用framework.png

按需设置一些操作,比如此处第三库高德SDK,需在【Targets】->【Build Settings】->【Other Link Flags】中添加-ObjC。


添加必要设置.png

最后在测试项目中调用自定义Framework中高德定位相关的接口,得到预期结果。


调用.png

Framework内部依赖第三方库

自定义Framework时内部依赖第三方库比较简单,不是本文的重点,实际开发中很少这样操作。此处以自定义Framework内嵌AFNetworking为例说明一下如何处理。在自定义Framework工程中导入需要的第三方库的同时勾选上对应的Target就行。


内部依赖.png

然后在Framework工程中正常使用导入的第三库即可,此处用AFNetworking写了个get请求供外部使用。


内部依赖.png

正常导出自定义Framework后就可以直接使用了,而不需要额外再接入要依赖的第三库。如下所示,直接导入LMBaseKit.framework就可,而不用导入AFNetworking了。


内部依赖.png

下载好了神仙姐姐酷照~


神仙姐姐啦.png

最后附上代码地址,仅供参考。

你可能感兴趣的:(【iOS开发】 iOS最新制作Framework总结)