基本概念
基本概念这里参照了奔狂的蜗牛_文章里的内容。
什么是SDK
软件开发工具包(缩写:SDK,英语全称:Software Development Kit),一般都是一些软件工程师为特定的软件包、软件框架、硬件平台、操作系统等建立应用软件时的开发工具的集合。
在OC的开发中,我们涉及到的一般是静态库(.a)或者动态库(.framework)。(注:不是所有的.framework就一定是动态库)
静态库与动态库的区别?
静态库:链接时完整地拷贝至可执行文件中,被多次使用就有多份冗余拷贝。表现形式为 .a和.framework。动态库:链接时不复制,程序运行时由系统动态加载到内存,供程序调用,系统只加载一次,多个程序共用,节省内存。 表现形式为 .dylib和.framework。注意:动态库只能苹果使用,如果项目中使用了动态库不允许上架(如:jspatch)
a与.framework有什么区别?
.a是一个纯二进制文件,.framework中除了有二进制文件之外还有资源文件。 .a文件不能直接使用,至少要有.h文件配合(微信的SDK就是这种形式),.framework文件可以直接使用。 .a + .h + sourceFile = .framework。 建议用.framework。再者 静态方式开发,一直是iOS SDK开发的主流方式
一、准备工作
1、创建一个目录
用于将后面开发的文件统一管理在此目录下。我这里命名为HLTestSDK-library
。
2、创建一个Workspace
放在HLTestSDK-library
目录下。
用于管理SDK和SDK测试的工程。这里命名为HLTestSDK-workspace
。
2.1、快捷键创建:control
+ command
+ n
2.2、手动创建如图:

3、创建SDK工程也放在HLTestSDK-library
目录下。
命名为HLTestSDK
。
3.1、快捷键创建:shift
+ command
+ n
3.2、手动创建如图:



4.创建一个测试工程也放在HLTestSDK-library
目录下。
用于测试SDK,命名为HLTestSDK-test
。
4.1、快捷键创建:shift
+ command
+ n
4.2、手动创建如图:



至此我们准备工作已经做完。
查看
HLTestSDK-library
是否如下图:
查看
HLTestSDK-workspace.xcworkspace
是否如下图:
二、在HLTestSDK
中添加测试类
主要用于后面演示暴露头文件和测试用,如图:


三、创建一个AggreGate文件关联SDK
命名为HLTestSDK-aggregate
。




脚本内容如下,可直接复制
#!/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}"
拷贝关联后如图:

四、配置SDK基础设置及暴露给外部调用的头文件
1.配置SDK支持最低版本

2.配置SDK支持设备

3.配置SDK为静态库(重点)

4.配置
Enable Bitcode

5.配置SDK
Bulid Configuration


6.配置
Other Linker Flags
,添加-ObjC


7.配置
Build Active Architecture Only

设置为yes表示它只编译当前的architecture版本
设置为no表示会编译所有的版本
为了提高编译速度:
一般debug的时候可以选择设置为yes,release的时候要改为no,以适应不同设备。
8.SDK暴露头文件给第三方访问


9.配置
Perform Single-Object Prelink
为YES

五、测试




如果控制台打印了
Hello SDK
,表示你已入门SDK开发了!
六、SDK项目中的资源文件Bundle(可选)
SDK开发过程中可能会使用到图片等资源,这些资源我们需要使用Bundle来管理。
1、创建Bundle
最简单的方式就是:在桌面上创建一个空的文件夹,然后文件名称修改为.bundle
结尾,那么系统就把这个文件转变成bundle文件,然后拖入你的SDK项目中。
2、向Bundle中添加资源
选中Bundle文件
- 右键
- 显示包内容
- 将资源文件拖入即可
3、SDK中使用资源
我们用图片资源演示
/**
* 从Bundle中获取图片
* @param bundleName bundle名称
* @param imageName 图片名称
*/
+ (UIImage *)imageWithBundle:(NSString *)bundleName imageName:(NSString *)imageName
{
if ([UIScreen mainScreen].scale == 3) {
imageName = [NSString stringWithFormat:@"%@@3x", imageName];
} else {
imageName = [NSString stringWithFormat:@"%@@2x", imageName];
}
// 静态库 url 的获取
NSURL *url = [[NSBundle mainBundle] URLForResource:bundleName withExtension:@"bundle"];
if (!url) {
// 动态库 url 的获取
url = [[NSBundle bundleForClass:[self class]] URLForResource:bundleName withExtension:@"bundle"];
}
if (!url) {
return nil;
}
NSBundle *bundle = [NSBundle bundleWithURL:url];
UIImage *image = [UIImage imageNamed:imageName inBundle:bundle compatibleWithTraitCollection:nil];
return image;
}
七、SDK开发中其他扩展(可选)
- 获取当前显示的
ViewController
/**
* 获取当前显示的 UIViewController
*/
+ (UIViewController *)findCurrentShowingViewController {
//获得当前活动窗口的根视图
UIViewController *vc = [UIApplication sharedApplication].keyWindow.rootViewController;
UIViewController *currentShowingVC = [self findCurrentShowingViewControllerFrom:vc];
return currentShowingVC;
}
+ (UIViewController *)findCurrentShowingViewControllerFrom:(UIViewController *)vc
{
// 递归方法 Recursive method
UIViewController *currentShowingVC;
if ([vc presentedViewController]) {
// 当前视图是被presented出来的
UIViewController *nextRootVC = [vc presentedViewController];
currentShowingVC = [self findCurrentShowingViewControllerFrom:nextRootVC];
} else if ([vc isKindOfClass:[UITabBarController class]]) {
// 根视图为UITabBarController
UIViewController *nextRootVC = [(UITabBarController *)vc selectedViewController];
currentShowingVC = [self findCurrentShowingViewControllerFrom:nextRootVC];
} else if ([vc isKindOfClass:[UINavigationController class]]){
// 根视图为UINavigationController
UIViewController *nextRootVC = [(UINavigationController *)vc visibleViewController];
currentShowingVC = [self findCurrentShowingViewControllerFrom:nextRootVC];
} else {
// 根视图为非导航类
currentShowingVC = vc;
}
return currentShowingVC;
}
-
Xcode13+: 工程目录中没有 products 路径了
点击顶部菜单Product > Show Build Folder in Finder
打开编译后的路径,Release-iphoneos 中的库就是编译后的库文件。
网友评论