iOS开发 制作Framework详情 遇到问题及注意细节

一、制作.framework配置

截屏2021-10-14 11.29.39.png

选择TARGETS进行相关配置

TARGETS  >>>  General  >>>  Deployment Info  版本支持修改iOS9.0

TARGETS  >>>  Build Settings  >>>  BaseSDK  改成 iOS
TARGETS  >>>  Build Settings  >>> Supported Platforms 改成 iOS

// 是否只编译当前激活的设备架构 选择NO表示编译所有架构
TARGETS  >>>  Build Settings  >>> Build Active Architecture Only 改成 NO
TARGETS  >>>  Build Settings  >>>  Excluded Architectures   Release 下添加 arm64

// 选择生成静态库
TARGETS  >>>  Build Settings  >>>  Mach-O Type 改为 Static Library
TARGETS  >>>  Build Settings  >>> Other Linker Flags   添加 -Objc

直接查找就行!

截屏2021-10-14 11.31.19.png
截屏2021-10-14 11.05.22.png
截屏2021-10-14 11.06.08.png

接下来把你要做的功能拖进来,最好不要以文件夹的方式,可以再项目中自己建文件夹把需要的文件拖进来。具体试试就知道了。

.framework需要暴露在外面的文件需要加入到Build Phases 下 Headers 的 public中,在CustomFramework.h文件中写上需要暴露的文件

截屏2021-10-14 11.54.30.png
截屏2021-10-14 11.53.37.png

如果需要用到NSBundle存放图片或XIB文件进行第二步:

二、制作NSBundle配置

截屏2021-10-14 11.38.37.png

再TARGETS 中选择创建的NSBundle文件进行配置

TARGETS  >>>  General  >>>  Deployment Info  版本支持修改iOS9.0

TARGETS  >>>  Build Settings  >>>  BaseSDK  改成 iOS
TARGETS  >>>  Build Settings  >>> Supported Platforms 改成 iOS

TARGETS  >>>  Build Settings  >>> Enable Bitcode  改成  NO
TARGETS  >>>  Build Settings  >>>  COMBINE_HIDPI_IMAGES  改为NO

截屏2021-10-14 11.40.13.png

把资源文件添加到NSBundle文件中,直接拖过去就行

截屏2021-10-14 11.41.37.png

现在来看左侧的Products文件下ImageBundle.bundle文件是红色的,
在运行工程那选择ImageBundle 然后 Command + B 编辑,编译后ImageBundle.bundle文件就生成了

截屏2021-10-14 11.42.19.png
截屏2021-10-14 11.43.21.png

在文件夹下找到ImageBundle.bundle文件,然后拖到Framework工程下,这一步很关键,要不然.framework就没有资源文件

截屏2021-10-14 11.46.50.png

获取bundle文件资源,获取路径CustomFramework.framework/CustomAlertBundle.bundle,不然获取不到


+ (NSBundle *)customAlertBundle{
    return [NSBundle bundleWithPath:[[NSBundle mainBundle] pathForResource:@"CustomFramework.framework/CustomAlertBundle.bundle" ofType:@""]];
}
+ (UINib *)loadNibWithName:(NSString *)name {
    return [[[NSBundle customAlertBundle] loadNibNamed:name owner:nil options:nil] lastObject];
}

+ (UIImage *)imageName:(NSString *)name{
    
    UIImage *image = [UIImage imageNamed:name inBundle:[NSBundle customAlertBundle] compatibleWithTraitCollection:nil];

    return  image;
}

二、添加生成Framework的脚本 创建Aggregate

截屏2021-10-14 11.44.13.png

在TARGETS中选择创建的Aggregate文件

TARGETS  >>>  Build Phases  >>>  左上角+ >>>  New Run Script Phase

截屏2021-10-14 11.45.09.png
截屏2021-10-14 11.47.37.png

把下面这段添加进去,制作.framework,

#!/bin/sh
#要build的target名
TARGET_NAME=${PROJECT_NAME}
if [[ $1 ]]
then
TARGET_NAME=$1
fi
UNIVERSAL_OUTPUT_FOLDER="${SRCROOT}/${PROJECT_NAME}/"

#创建输出目录,并删除之前的framework文件
mkdir -p "${UNIVERSAL_OUTPUT_FOLDER}"
rm -rf "${UNIVERSAL_OUTPUT_FOLDER}/${TARGET_NAME}.framework"

#分别编译模拟器和真机的Framework
xcodebuild -target "${TARGET_NAME}" ONLY_ACTIVE_ARCH=NO -configuration ${CONFIGURATION} -sdk iphoneos BUILD_DIR="${BUILD_DIR}" BUILD_ROOT="${BUILD_ROOT}" clean build
xcodebuild -target "${TARGET_NAME}" ONLY_ACTIVE_ARCH=NO -configuration ${CONFIGURATION} -sdk iphonesimulator BUILD_DIR="${BUILD_DIR}" BUILD_ROOT="${BUILD_ROOT}" clean build

#拷贝framework到univer目录
cp -R "${BUILD_DIR}/${CONFIGURATION}-iphonesimulator/${TARGET_NAME}.framework" "${UNIVERSAL_OUTPUT_FOLDER}"

lipo "${BUILD_DIR}/${CONFIGURATION}-iphonesimulator/${TARGET_NAME}.framework/${TARGET_NAME}" -remove arm64 -output "${BUILD_DIR}/${CONFIGURATION}-iphonesimulator/${TARGET_NAME}.framework/${TARGET_NAME}"


#合并framework,输出最终的framework到build目录
lipo -create -output "${UNIVERSAL_OUTPUT_FOLDER}/${TARGET_NAME}.framework/${TARGET_NAME}" "${BUILD_DIR}/${CONFIGURATION}-iphonesimulator/${TARGET_NAME}.framework/${TARGET_NAME}" "${BUILD_DIR}/${CONFIGURATION}-iphoneos/${TARGET_NAME}.framework/${TARGET_NAME}"

#删除编译之后生成的无关的配置文件
dir_path="${UNIVERSAL_OUTPUT_FOLDER}/${TARGET_NAME}.framework/"
for file in ls $dir_path
do
if [[ ${file} =~ ".xcconfig" ]]
then
rm -f "${dir_path}/${file}"
fi
done
#判断build文件夹是否存在,存在则删除
if [ -d "${SRCROOT}/build" ]
then
rm -rf "${SRCROOT}/build"
fi
rm -rf "${BUILD_DIR}/${CONFIGURATION}-iphonesimulator" "${BUILD_DIR}/${CONFIGURATION}-iphoneos"
#打开合并后的文件夹
open "${UNIVERSAL_OUTPUT_FOLDER}"

在运行那选择如上图所示, Command + B 编译,去文件夹下查找发现CustomFramework.framework文件已经生成。
直接编译则生成Debug模式的Framework,Archive则生成Release模式的Framework


截屏2021-10-14 11.46.50.png

Framework制作基本完成,把.framework拖进工程,如果.framework中用到了分类,需要在demo中设置

// demo中设置,不然.framework中无法使用分类
TARGETS  >>>  Build Settings  >>> Other Linker Flags   添加 -all_load

TARGETS  >>>  Build Phases  >>> Link Binary With Libraries  添加生成的.framework文件

// 如果不使用NSBundle使用图片xib,不需要添加
TARGETS  >>>  Build Phases  >>> Copy Bundle Resources   添加生成的.framework文件
截屏2021-10-14 11.49.19.png

结语: .framework库中尽量不用xib,具体开发中也能出现各种问题,尽量不用分类,可以创建方法工具类代替

demo地址:

推荐阅读更多精彩内容