iOS SDK(framework) 开发

• 该文章纯属记录练手经历，若有不对的地方望大家随时指出。

一、创建sdk项目。

command + shift + N

image.png

二、创建自己需要封装在framework里的类。

image.png

三、创建一个AggreGate文件关联SDK，这样每次只要编译demo，就能自动生成framework文件并直接跳到文件目录。

image.png

image.png

添加自动生成framework的脚本文件

image.png

脚本内容如下，可直接复制，什么都不用改

#!/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}"

四、配置项目基础设置及暴露给外包调用的头文件

image.png

image.png

image.png

image.png

• 在主头文件中导入需要暴露给外部的文件

  
  
  image.png

• 选中项目文件，编译即可自动生成framework，并自动跳到相关文件夹

  
  
  image.png

五、为SDK添加图片资源，使得SDK内的方法也能使用图片。

• 创建一个新项目command + shift + N

  
  
  image.png

编译通过后，会生成一个.bundle文件

image.png

• show in finder，就能够找到该文件。

六、使用SDK和图片资源

• 在framework中使用图片

UIImage *img = [UIImage imageNamed:@"SFImage.bundle/nodata.png" inBundle: [NSBundle bundleForClass:[self class]] compatibleWithTraitCollection:nil];
UIImageView* loginImageView = [[UIImageView alloc]initWithImage:img];

然后编译framework，将新的framework和bundle文件一起拖到demo中。

image.png

在需要用到的地方导入头文件，有可能没有索引，需要强敲

 #import "SFBlankView.framework/Headers/UIView+ToastExtension.h"

这个时候运行demo,会报错，'xxx.h'file not found'，解决这个问题只需要到BuildSetting里面,Framework Search Paths 双击,新增 $(PROJECT_DIR)/SFBlankView（你的framework的名字） （作用是指明我的framework放在了此文件夹）

• 接下来重新编译项目，不报错了，但是运行项目就崩溃，控制台输出 unrecognized selector sent to instance ，找不到某个方法。

解决方法如下

image.png

至此，就可以愉快的运行了