iOS 记录制作包含bundle和pod组件的framework的过程

简单记录一下制作framework过程

网上有很多关于制作framework的教程,大家可以多看看教程,吸收下各种问题,错误越多经验越丰富

一:从最开始的地方讲起

1:选择创建一个framework的项目


image.png

2:xcode里部分设置的说明


image.png

image.png

image.png

3:添加framework代码


image.png

image.png
注意:在framework中的资源不能像平常一样使用,他们的资源并不在同一个bundle下,在framework中可以使用这个方法获取当前的bundle:NSBundle *mainBundler = [NSBundle bundleForClass:[self class]]; 然后加载资源要通过这bundle进行加载
因为这样,所有在Storyboard中设置图片就出现不会显示的问题,那样怎样去解决?

4:在framework中添加资源bundle
新建一个bundle的target


image.png

image.png

image.png

添加资源到bundle


image.png

因为bundle只支持macOS,这里在xcode中修改
image.png

5:编译bundle,然后添加到framework中


image.png

将bundle添加到framework中


image.png

在代码中使用bundle中的资源,最好建一个单独的类,去加载资源
image.png

6:回到framework中,我们开始编译生成framework,在编译之前,需要将framework中需要暴露的头文件设置一下
设置需要暴露的头文件


image.png

并在Framework.h头文件中,把需要暴露的头文件包含进去


image.png

xcode会因为你选择的模拟器、真机,打包出不同架构的包,为了合并打包出来的framework,需要用到编译脚本


image.png

脚本内容,网上很多

# Type a script or drag a script file from your workspace to insert its path.
set -e
set +u
#避免递归调用这个脚本。
if [[ $SF_MASTER_SCRIPT_RUNNING ]]
then
exit 0
fi
set -u
export SF_MASTER_SCRIPT_RUNNING=1

#常量
SF_TARGET_NAME=${PROJECT_NAME}
UNIVERSAL_OUTPUTFOLDER=${BUILD_DIR}/${CONFIGURATION}-universal

#构建Target
if [[ "$SDK_NAME" =~ ([A-Za-z]+) ]]
then
SF_SDK_PLATFORM=${BASH_REMATCH[1]}
else
echo "Could not find platform name from SDK_NAME: $SDK_NAME"
exit 1
fi

if [[ "$SF_SDK_PLATFORM" = "iphoneos" ]]
then
echo "Please choose iPhone simulator as the build target."
exit 1
fi

IPHONE_DEVICE_BUILD_DIR=${BUILD_DIR}/${CONFIGURATION}-iphoneos

#生成其他(非虚拟机)平台
xcodebuild -project "${PROJECT_FILE_PATH}" -target "${TARGET_NAME}" -configuration "${CONFIGURATION}" -sdk iphoneos BUILD_DIR="${BUILD_DIR}" OBJROOT="${OBJROOT}/DependentBuilds" BUILD_ROOT="${BUILD_ROOT}" CONFIGURATION_BUILD_DIR="${IPHONE_DEVICE_BUILD_DIR}/arm64" SYMROOT="${SYMROOT}" ARCHS='arm64' VALID_ARCHS='arm64' $ACTION

xcodebuild -project "${PROJECT_FILE_PATH}" -target "${TARGET_NAME}" -configuration "${CONFIGURATION}" -sdk iphoneos BUILD_DIR="${BUILD_DIR}" OBJROOT="${OBJROOT}/DependentBuilds" BUILD_ROOT="${BUILD_ROOT}"  CONFIGURATION_BUILD_DIR="${IPHONE_DEVICE_BUILD_DIR}/armv7" SYMROOT="${SYMROOT}" ARCHS='armv7 armv7s' VALID_ARCHS='armv7 armv7s' $ACTION

#复制framework结构的universal folder(先清空)
rm -rf "${UNIVERSAL_OUTPUTFOLDER}"
mkdir -p "${UNIVERSAL_OUTPUTFOLDER}"
cp -R "${BUILD_DIR}/${CONFIGURATION}-iphonesimulator/${PROJECT_NAME}.framework" "${UNIVERSAL_OUTPUTFOLDER}/${PROJECT_NAME}.framework"

#把这些架构(architectures)搅碎融合到一起
lipo -create  "${BUILD_DIR}/${CONFIGURATION}-iphonesimulator/${PROJECT_NAME}.framework/${PROJECT_NAME}" "${BUILD_DIR}/${CONFIGURATION}-iphoneos/arm64/${PROJECT_NAME}.framework/${PROJECT_NAME}" "${BUILD_DIR}/${CONFIGURATION}-iphoneos/armv7/${PROJECT_NAME}.framework/${PROJECT_NAME}" -output "${UNIVERSAL_OUTPUTFOLDER}/${PROJECT_NAME}.framework/${PROJECT_NAME}"
image.png

第一次编译出错,貌似在模拟器下真机的arm64架构framework无法生成,这里把脚本改改

set -e
set +u
#避免递归调用这个脚本。
if [[ $SF_MASTER_SCRIPT_RUNNING ]]
then
exit 0
fi
set -u
export SF_MASTER_SCRIPT_RUNNING=1

#常量
SF_TARGET_NAME=${PROJECT_NAME}
UNIVERSAL_OUTPUTFOLDER=${BUILD_DIR}/${CONFIGURATION}-universal

#构建Target
if [[ "$SDK_NAME" =~ ([A-Za-z]+) ]]
then
SF_SDK_PLATFORM=${BASH_REMATCH[1]}
else
echo "Could not find platform name from SDK_NAME: $SDK_NAME"
exit 1
fi

if [[ "$SF_SDK_PLATFORM" = "iphoneos" ]]
then
echo "Please choose iPhone simulator as the build target."
#exit 1  注释这里,让脚本可以在真机下编译
fi

IPHONE_DEVICE_BUILD_DIR=${BUILD_DIR}/${CONFIGURATION}-iphoneos

#生成其他(非虚拟机)平台
xcodebuild -project "${PROJECT_FILE_PATH}" -target "${TARGET_NAME}" -configuration "${CONFIGURATION}" -sdk iphoneos BUILD_DIR="${BUILD_DIR}" OBJROOT="${OBJROOT}/DependentBuilds" BUILD_ROOT="${BUILD_ROOT}" CONFIGURATION_BUILD_DIR="${IPHONE_DEVICE_BUILD_DIR}/arm64" SYMROOT="${SYMROOT}" ARCHS='arm64' VALID_ARCHS='arm64' $ACTION

xcodebuild -project "${PROJECT_FILE_PATH}" -target "${TARGET_NAME}" -configuration "${CONFIGURATION}" -sdk iphoneos BUILD_DIR="${BUILD_DIR}" OBJROOT="${OBJROOT}/DependentBuilds" BUILD_ROOT="${BUILD_ROOT}"  CONFIGURATION_BUILD_DIR="${IPHONE_DEVICE_BUILD_DIR}/armv7" SYMROOT="${SYMROOT}" ARCHS='armv7 armv7s' VALID_ARCHS='armv7 armv7s' $ACTION

#复制framework结构的universal folder(先清空)
rm -rf "${UNIVERSAL_OUTPUTFOLDER}"
mkdir -p "${UNIVERSAL_OUTPUTFOLDER}"
cp -R "${BUILD_DIR}/${CONFIGURATION}-iphonesimulator/${PROJECT_NAME}.framework" "${UNIVERSAL_OUTPUTFOLDER}/${PROJECT_NAME}.framework"

#把这些架构(architectures)搅碎融合到一起
lipo -create  "${BUILD_DIR}/${CONFIGURATION}-iphonesimulator/${PROJECT_NAME}.framework/${PROJECT_NAME}" "${BUILD_DIR}/${CONFIGURATION}-iphoneos/${PROJECT_NAME}.framework/${PROJECT_NAME}" -output "${UNIVERSAL_OUTPUTFOLDER}/${PROJECT_NAME}.framework/${PROJECT_NAME}"

用上面的脚本编译可以生成真机下的framework


image.png

然后在模拟器下编译一遍,得到真机和模拟器合并的framework


image.png

7:创建一个demo工程,测试framework


image.png

将framework添加到工程,因为framework默认是动态链接库,点击Embedded Binaries将framework链接到demo中


image.png

在demo项目中使用framework
image.png

点击按钮


image.png

至此,一个简单的framework已经制作完毕,接下来在framework中添加pop组件

8:framework中使用pod组件
在项目根目录下创建podFile文件,target指定到framework上,pod install


image.png

image.png

在framework中增加masonry引用代码


image.png

再次编译出错,pop第三方库没有找到
image.png

我们修改run script,只有在安装的时候才执行script,此时去编译通过,按照上面的打包步骤,我们需要选择真机编译,再选择模拟器编译
image.png

9:在demo项目中添加framework需要的库
上面的framework已经打包完成,在demo项目中运行,会报以下错误,因为framework依赖第三方库Masonry,我们需要在demo中也同样依赖Masonry


image.png

修改podFile文件,然后pod install


image.png

重新运行demo项目
image.png

gitHub地址:https://github.com/wfx6701961/testMakeFramework.git

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容