iOS开发SDK总结 - 一个方便开发的SDK工程结构

开发SDK常常遇到的一些问题

  • 怎么在SDK工程里创建一个demo方便自我调试,并且能打断点调试
  • 怎么让SDK与demo共用一套资源,避免多个地方重复引入资源
  • SDK中要用到第三方库怎么办,怎么避免demo和SDK多次引入第三方库

开发环境

  • Xcode 11.4.1
  • macOS 10.15.4

下面是我总结的开发步骤

1、创建一个Framework工程

创建一个Framework工程,做SDK相关配置,这里不再赘述。我这里创建的名称是ZHTestSDK

2、在该工程里面创建一个demo工程
  • 创建demo目的:验证我们写的SDK代码,更重要的是能打断点调试

  • 新建一个target,创建一个Single View App,我这里创建的demo名称是ZHTestSDKDemo


    D879B6ED-FD0B-41B5-BA24-C8A27C970488.png

    A61BB99E-0D42-4A59-9293-902B367E7AC0.png
  • 创建完后是这样的


    355658DA-90EA-44BB-8EC2-20356CA04D99.png
  • 在demo中引入我们的SDK


    292A7727-A66A-451A-8974-22DA8B6BA58F.png
  • demo中使用我们要SDK中的东西
    比如SDK中有个ZHImageView类可供SDK外部使用,demo ViewController中的代码

#import <ZHTestSDK/ZHTestSDK.h>

ZHImageView *imageView = [[ZHImageView alloc] initWithFrame:CGRectMake(100, 200, 200, 200)];
[self.view addSubview:imageView];

3、使用资源,建立bundle
  • 创建一个bundle,这里名字为ZHTestSDKResource类型是bundle的target


    AABB487D-6FFB-4225-AB55-39E50116F61B.png
  • bundle设置,把支持的平台设置成iOS,要支持其他平台,自行设置,然后就是要设置支持的系统最低版本


    287CDE0A-BEAC-45D1-9FC9-A1EB2550A0FF.png
  • 建完之后,工程目录中多了一个ZHTestSDKResource文件夹,注意:资源不会放到这个文件夹里


    6C31E9D6-9F4D-4F3B-B67A-5FE980317C09.png
  • 接下来编译我们的bundle,然后在products中找到bundle,然后右击,show in folder,找到这个bundle


    9961B798-EAD5-4E60-A669-05A9E5DBC02C.png
  • 然后我们将文件中的bundle拖入到工程中,只用引入到demo中即可,不用copy


    AB906C35-54C1-4837-9848-D42F6F0BE96F.png
  • 引入后的工程目录是这样的


    19F225AF-00BF-4CD2-A8E9-BCD32EB324E3.png
  • 向bundle中引入资源(以支持iOS的bundle为例),这里引入了一个名为"123.png"的图片,注意:我们需要将资源拖入到bundle下,而不是跟bundle同名的文件夹下,引入资源后是这样的:


    F3D31689-4DD5-4109-A05E-C203D006D2B5.png
4、使用bundle中的资源
  • 使用mainBundle获取我们自己bundle的路径
  • 通过路径创建我们自己的bundle
  • 通过我们自己的bundle获取需要的资源的路径,有了资源路径自然就能拿到资源了
    下面我写了一个工具的代码.m 文件内容:
#import "ZHHelper.h"

@interface ZHHelper()

/// 资源bundle
@property (nonatomic, strong) NSBundle *resourceBundle;

@end

@implementation ZHHelper

/// 单例
+ (instancetype)shared {
    static ZHHelper *_helper = nil;
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        _helper = [[ZHHelper alloc] init];
    });
    return _helper;
}

/// 通过资源名获取资源路径
/// @param name 资源名称
/// @param type 资源类型
- (NSString *)resourcePathWithName:(NSString *)name ofType:(NSString *)type {
    return [self.resourceBundle pathForResource:name ofType:type];
}

#pragma mark - setter / getter

- (NSBundle *)resourceBundle {
    if (!_resourceBundle) {
        NSString *bundlePath = [[NSBundle mainBundle] pathForResource:@"ZHTestSDKResource" ofType:@"bundle"];
        _resourceBundle = [NSBundle bundleWithPath:bundlePath];
    }
    return _resourceBundle;
}

@end

5、引用第三方库

我这里采用pod的形式引入第三方库,以引入SDWebImage为例

  • 首先建立pod,这里就不多说了,如果建立了bundle target,podfile文件里也有这个target,删掉它
  • 在pod中引入SDWebImage,SDK 和 demo 两个target都要引入,然后pod install,这样在SDK和demo中都可以用SDWebImage了,pod中的代码:
platform :ios, '9.0'

target 'ZHTestSDK' do
  use_frameworks!
  pod 'SDWebImage'

end

target 'ZHTestSDKDemo' do
  use_frameworks!
  pod 'SDWebImage'
  
end
  • 这样引入的优缺点
    优点:1.可以让SDK和接入SDK方公用一套第三方代码,避免代码过度冗余;2.减小包体体积
    缺点:1.接入方必须引入第三方库; 2.当接入方之前已经引用了某个第三方库,然后再接入SDK,SDK用的第三方库版本和接入方使用的版本不一致,可能会导致其中一方要修改代码
6、打包

打包时,要注意bundle也是SDK一部分,bundle不要放到Framework内部,他两文件结构平级就可以,否则通过上面的方式会读取不到

7、源码地址

https://github.com/zhengzhanghai/ZHTestSDK

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 200,045评论 5 468
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,114评论 2 377
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 147,120评论 0 332
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,902评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,828评论 5 360
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,132评论 1 277
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,590评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,258评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,408评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,335评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,385评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,068评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,660评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,747评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,967评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,406评论 2 346
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,970评论 2 341