iOS架构之路03 -- 静态库.a打包之包含资源文件

• 上两篇文章分别介绍了静态库.a的手动打包与脚本化打包，并没有涉及到资源文件，一般静态库中肯定会包含资源文件的，资源文件通常包括图片，xib，json数据，plist数据等等，这些资源文件在静态库打包的时候会统一放在一个Bundle文件中，下面我们就来尝试涉及资源文件的静态库打包制作；
• 在原来上一篇文章所建的工程基础上，进行如下操作：

第一步：给静态库添加一个同工程名的Bundle

• 添加名为MyCategoryBundle的Bundle
  image.png
• 选中targetMyCategoryBundle，往里面添加图片文件，然后将添加的图片文件全部拖到MyCategoryBundle文件夹下，如下所示：
  image.png

第二步：Bundle的Build Setting配置

• Base SDK 设置为iOS
  Snipaste_2021-09-08_18-00-12.png
• COMBINE_HIDPI_IMAGES 为NO，否则bundle中的图片就是tiff格式
  Snipaste_2021-09-08_18-01-34.png
• Enable Bitcode设置为NO
  image.png

第三步：新增业务代码

• 创建一个SFViewController控制器并添加子控件，引用Bundle中的图片文件，代码实现如下：

#import <UIKit/UIKit.h>

NS_ASSUME_NONNULL_BEGIN

@interface SFViewController : UIViewController

@end

NS_ASSUME_NONNULL_END

#import "SFViewController.h"

@interface SFViewController ()

@property (weak, nonatomic) IBOutlet UIImageView *icon;

@property(nonatomic,strong)UIImageView *im;

@end

@implementation SFViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    
    self.view.backgroundColor = [UIColor whiteColor];
    
    NSBundle *bundle = [NSBundle bundleWithPath:[[NSBundle mainBundle] pathForResource:@"MyCategoryBundle" ofType:@"bundle"]];
    NSString *path = [[bundle resourcePath] stringByAppendingPathComponent:@"sf_navBack_hl"];
    self.icon.image = [UIImage imageWithContentsOfFile:path];
    
    
    self.im = [[UIImageView alloc]initWithFrame:CGRectMake(100, 100, 100, 100)];
    self.im.image = [UIImage imageWithContentsOfFile:path];
    [self.view addSubview:self.im];
}
@end

• 注意图片的资源的访问不能直接访问了，必须先定位Bundle才能获取到目标图片文件；
• 再创建一个引用SFViewController的类SFLib，代码如下：

#import <Foundation/Foundation.h>
#import "SFViewController.h"

NS_ASSUME_NONNULL_BEGIN

@interface SFLib : NSObject

+ (SFViewController *)createVC;

@end

NS_ASSUME_NONNULL_END

#import "SFLib.h"

@implementation SFLib

+ (SFViewController *)createVC{
    SFViewController *vc = [[SFViewController alloc]init];
    return vc;
}

@end

• 将新增代码的.h文件手动导入，以及整个工程的文件结构如下：

image.png

第四步：编译target --> MyCategoryBundle

• 默认编译Release，所以选中MyCategoryBundle，进入Edit Scheme，如下所示：
  image.png
• 然后在真机状态下，进行编译，进入Products文件目录下可以看到Bundle文件MyCategoryBundle.bundle，如下所示：
  image.png

第五步：执行脚本文件Script.h

• 脚本执行完成后会 生成打包文件夹MyCategory但里面只包含.a文件与头文件，需要我们手动的将刚生成的MyCategoryBundle.bundle拷贝到打包文件夹下，如下所示：

image.png

• 最后可以将MyCategory提供给外界使用了；

• 上面生成的MyCategoryBundle.bundle是手动拷贝到打包文件夹MyCategory中，同样可以通过脚本来实现拷贝操作，需要进行以下两个操作：

• 第一个操作：给Target -> MyCategory添加依赖MyCategoryBundle，这样在编译MyCategory的时候同时编译MyCategoryBundle
  

  Snipaste_2021-09-09_11-34-03.png

• 第二个操作：修改脚本文件，如下所示：

#!/bin/sh

#  Script.sh
#  MyCategory
#
#  Created by liyanyan33 on 2021/9/8.
#  

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

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

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

#打包模式 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}======"

#真机编译后生成的头文件的文件夹路径
device_dir_include=${build_dir}/${development_mode}-iphoneos/include/${project_name}

#真机编译后生成的.a文件路径
device_dir_a=${build_dir}/${development_mode}-iphoneos/lib${project_name}.a
echo "======真机.a文件路径=${device_dir_a}======"

#模拟器编译后生成的.a文件路径
simulator_dir_a=${build_dir}/${development_mode}-iphonesimulator/lib${project_name}.a
echo "======模拟器.a文件路径=${simulator_dir_a}======"

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

#目标头文件的文件夹路径
install_dir_Headers=${build_dir}/Products/${project_name}/Headers
echo "=====目标头文件的文件夹路径=${install_dir_Headers}======"

#目标.a文件路径
install_dir_a=${build_dir}/Products/${project_name}/lib${project_name}.a
echo "=====目标.a文件路径=${install_dir}======"

#图片资源路径
bundle_dir=${build_dir}/${development_mode}-iphoneos/MyCategoryBundle.bundle


#判断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

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

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


#合并 真机与模拟器的.a文件
lipo -create "${device_dir_a}" "${simulator_dir_a}" -output "${install_dir_a}"

echo "=====合并结束======"


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

#打开目标文件夹
open "${install_dir}"

• 最后执行脚本文件，生成的打包文件夹MyCategory中包含.a文件，头文件夹Headers以及bundle文件MyCategoryBundle.bundle，可直接提供给外界使用，如下所示：
  image.png