iOS架构之路04 -- 静态库.framwork的手动,脚本,资源文件打包

  • .framework中除了二进制文件之外还有资源文件,其包括.a + .h + sourceFile = .framework.framework是可以直接使用的;
  • 下面来制作一个.framework静态库;
第一步:新建一个.framework工程,命名为FMycategory
image.png
第二步:导入自己的代码的.h文件
  • FMyCategory工程创建成功后,默认会生成FMyCategory.h文件,且在FMyCategory.h文件导入自己代码的所有头文件,如下所示:
    image.png
  • 所有的代码文件与上一篇.a静态库制作的代码文件完全相同;
第三步:FMyCategory工程Build Setting配置
  • Mach-O Type 设置为Static Library
    image.png
  • Other Linker Flags 设置 -ObjC
    image.png
  • Architectures 编译架构设置
    image.png
  • 选择在Release模式下进行编译,target --> FMyCategory --> Edit Scheme
    image.png
  • 设置暴露给外界的头文件,Build Phases --> Headers
    image.png
第四步:创建Bundle 命名同工程名FMyCategoryBundle
Snipaste_2021-09-09_14-19-58.png
  • FMyCategoryBundle中导入图片资源文件;
  • 然后将导入工程中的图片拖到FMyCategoryBundle文件夹下;
    image.png
第五步:FMyCategoryBundleBuild Setting设置
  • Base SDK 设置为iOS
  • COMBINE_HIDPI_IMAGESNO,否则bundle中的图片就是tiff格式
  • Enable Bitcode设置为NO
  • 与.a静态库的Bundle设置类似;
  • FMyCategoryBundle也设置在Release模式下;
第六步:FMyCategory与FMyCategoryBundle的编译
  • 首先选中FMyCategory,选择真机进行编译;
  • 然后依然是FMyCategory,选择模拟器进行编译;
  • 最后选中FMyCategoryBundle,选择真机进行编译;
  • Product文件夹下会生成编译之后的文件,如下所示:
    image.png
  • 然后右击Show In Finder,文件目录结果如下:
    image.png
  • 可查看framework中目标文件的架构信息,首先查看真机的,命令行如下所示:
image.png
  • 然后查看模拟器的,命令行如下:
image.png
第七步:将真机与模拟器的目标文件合并
  • cd 到 Products文件路径下,执行lipo -create Release-iphoneos/FMyCategory.framework/FMyCategory Release-iphonesimulator/FMyCategory.framework/FMyCategory -output FMyCategory
  • 合并生成的目标文件,如下所示:
image.png
  • 用合并的目标文件去替换真机.framework中的目标文件;


    image.png
  • 最后将替换目标文件之后的真机.framework文件与.bundle文件一起提供给外界使用;

  • 上面阐述的是.framework的手动打包,下面来介绍.framework的脚本化打包

.framework的脚本化打包

  • 在代码工程FMycategory与资源bundleFMyCategoryBundle的基础上,且做好了相关配置,现在来创建脚本文件Script.sh,注意与FMycategory.xcodeproj的目录同级;

    image.png

  • 第一步:给Target -> FMycategory添加依赖FMyCategoryBundle,这样在编译FMycategory的时候同时编译FMyCategoryBundle

  • 第二步:编辑Script.sh脚本文件,如下所示:

#!/bin/sh

#  Script.sh
#  FMyCategory
#
#  Created by liyanyan33 on 2021/9/9.
#

#注意⚠️:脚本文件与FMyCategory.xcodeproj要在同一个目录

#要编译的target名
target_Name=FMyCategory
echo "target_Name=${target_Name}"

#工程名
project_name=$target_Name
echo "project_name=${project_name}"

#bundle工程名 FMyCategoryBundle
bundle_name=${project_name}Bundle

#打包模式 Debug/Release 默认为Release
development_mode=Release

#当前脚本文件所在路径 $(pwd)
script_dir=$(pwd)
echo "======脚本路径=${script_dir}======"

#工程路径
project_dir=${script_dir}
echo "======工程路径=${project_dir}======"

#编译之后的文件夹路径
build_dir=${script_dir}/Build
echo "======Build路径=${build_dir}======"

#真机编译后生成的.framework文件路径
device_dir=${build_dir}/${development_mode}-iphoneos/${project_name}.framework

#真机编译后生成目标文件路径
device_dir_target=${build_dir}/${development_mode}-iphoneos/${project_name}.framework/${project_name}
echo "======真机目标文件路径=${device_dir_target}======"

#模拟器编译后生成的目标文件路径
simulator_dir_target=${build_dir}/${development_mode}-iphonesimulator/${project_name}.framework/${project_name}
echo "======模拟器目标文件路径=${simulator_dir_target}======"

#目标文件夹路径(即包含目标.framework文件与bundle文件)
install_dir=${build_dir}/Products/${project_name}
echo "======目标文件夹路径=${install_dir}======"

#目标文件路径(合并)
install_dir_target=${build_dir}/Products/${project_name}/${project_name}.framework/${project_name}
echo "=====目标文件路径=${install_dir_Headers}======"

#图片资源路径 FMyCategoryBundle.bundle
bundle_dir=${build_dir}/${development_mode}-iphoneos/${bundle_name}.bundle
echo "======图片资源路径${bundle_dir}======"


#判断build文件夹是否存在,存在则删除
#rm -rf 表示删除一个目录中的一个或多个文件或目录
if [ -d "${build_dir}" ]
then
rm -rf "${build_dir}"
fi

#判断目标文件夹是否存在,存在则删除该文件夹
if [ -d "${install_dir}" ]
then
rm -rf "${install_dir}"
fi

#创建目标文件夹
mkdir -p "${install_dir}"

echo "======文件目录已经创建完成 开始生成.a 然后 合成 最终放到目标文件夹中"

#build编译之后首先clean以下
xcodebuild -target ${target_Name} -configuration ${development_mode} -sdk iphonesimulator clean
xcodebuild -target ${target_Name} -configuration ${development_mode} -sdk iphoneos clean

#build编译模拟器
xcodebuild -target ${target_Name} -configuration ${development_mode} -sdk iphonesimulator

#build编译真机
xcodebuild -target ${target_Name} -configuration ${development_mode} -sdk iphoneos

#将真机编译的.framwork 拷贝到 目标文件夹中
#使用 -R参数 可实现递归功能,即所有子目录中的文件与目录均拷贝
cp -R "${device_dir}" "${install_dir}"

#删除拷贝到目标文件夹中的.framework中的目标文件
if [ -f "${install_dir_target}" ]
then
rm -f "${install_dir_target}"
fi

#将图片资源bundle 拷贝 目标文件夹中
cp -R "${bundle_dir}" "${install_dir}"

#合并 真机与模拟器的.framework中的目标文件
lipo -create "${device_dir_target}" "${simulator_dir_target}" -output "${install_dir_target}"
echo "=====合并结束======"

# -f 判断合成目标文件是否存在
if [ -f "${install_dir_target}" ]
then
echo "======验证合并.a文件是否合并成功"
lipo -info "${install_dir_target}"
fi

#打开目标文件夹
open "${install_dir}"
  • 命令行执行脚本文件,执行成功后,本地工程路径如下所示:
image.png
.framwork的使用
  • 将上面通过脚本生成的打包文件夹FMyCategory直接拖拽到新建工程Test_FProject中,然后编写代码,直接运行成功,如下所示:
    image.png

推荐阅读更多精彩内容