iOS优雅开发SDK详细教程

基本概念

基本概念这里参照了奔狂的蜗牛_文章里的内容。

什么是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、手动创建如图：

1.创建Workspace.jpg

3、创建SDK工程也放在`HLTestSDK-library`目录下。

命名为HLTestSDK。
3.1、快捷键创建：shift + command + n
3.2、手动创建如图：

2.创建工程.jpg

3.创建Framework.jpg

4.创建Framework.jpg

4.创建一个测试工程也放在`HLTestSDK-library`目录下。

用于测试SDK，命名为HLTestSDK-test。
4.1、快捷键创建：shift + command + n
4.2、手动创建如图：

1.创建Workspace.jpg

5.创建测试工程.jpg

6.创建测试工程.jpg

至此我们准备工作已经做完。
查看HLTestSDK-library是否如下图：

7.HLTest-library目录.jpg

查看HLTestSDK-workspace.xcworkspace是否如下图：

8.HLTestSDK-workspace工作空间目录结构.jpg

二、在`HLTestSDK`中添加测试类

主要用于后面演示暴露头文件和测试用，如图：

9.在SDK中添加测试类.jpg

10.在SDK中添加测试类.jpg

三、创建一个AggreGate文件关联SDK

命名为HLTestSDK-aggregate。

11.创建Aggregate文件.jpg

12.创建Aggregate文件.jpg

13.创建Aggregate文件.jpg

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

脚本内容如下，可直接复制

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

拷贝关联后如图：

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

四、配置SDK基础设置及暴露给外部调用的头文件

1.配置SDK支持最低版本

16.配置SDK支持最低版本.jpg

2.配置SDK支持设备

17.配置SDK支持设备.jpg

3.配置SDK为静态库（重点）

18.配置SDK为静态库.jpg

4.配置Enable Bitcode

19.配置Enable Bitcode.jpg

5.配置SDK Bulid Configuration

20.配置SDK Bulid Configuration.jpg

21.配置SDK Bulid Configuration.jpg

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

22.配置Other Linker Flags.jpg

23.配置Other Linker Flags.jpg

7.配置Build Active Architecture Only

24.配置Build Active Architecture Only.jpg

设置为yes表示它只编译当前的architecture版本
设置为no表示会编译所有的版本
为了提高编译速度：
一般debug的时候可以选择设置为yes，release的时候要改为no，以适应不同设备。

8.SDK暴露头文件给第三方访问

25.SDK暴露头文件给第三方访问.jpg

26.SDK暴露头文件给第三方访问.jpg

9.配置Perform Single-Object Prelink为YES

27.配置Perform Single-Object Prelink.jpg

五、测试

28.测试.jpg

29.测试.jpg

30.测试.jpg

31.测试.jpg

如果控制台打印了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 中的库就是编译后的库文件。

最后编辑于：2022.08.10 16:12:44

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 215,539评论 6赞 497
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 91,911评论 3赞 391
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 161,337评论 0赞 351
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 57,723评论 1赞 290
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 66,795评论 6赞 388
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 50,762评论 1赞 294
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 39,742评论 3赞 416
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 38,508评论 0赞 271
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 44,954评论 1赞 308
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 37,247评论 2赞 331
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 39,404评论 1赞 345
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 35,104评论 5赞 340
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 40,736评论 3赞 324
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 31,352评论 0赞 21
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 32,557评论 1赞 268
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 47,371评论 2赞 368
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 44,292评论 2赞 352