iOS SDK(一):工程创建 & 接口测试

本文章涉及 Framework 为静态库。
涉及内容:

  • SDK工程:指创建并编译 Framework 的工程;
  • Demo工程:指测试测试 Framework 的Demo工程;

一、创建工程文件夹

创建一个文件夹 NiceSDK ,用于存放SDK工程,方便管理。

创建工程文件夹

二、创建 SDK 工程

创建SDK工程,存放到上面创建的NiceSDK

1、Xcode > File > New > Project

创建SDK工程1

2、iOS > Framework > Next

创建SDK工程2

3、填写工程名 > 修改包名 > 设置使用语言 > Next
后面生成的 framework 文件,就是此处设置的工程名;当然工程名、包名开发过程中都可在Xcode上进行修改。

创建SDK工程3

4、选择存放位置 > Create
此处我选择第一步创建的文件夹 NiceSDK

创建SDK工程4

三、设置 SDK 工程

1、设置支持最小iOS版本和支持设备


设置SDK工程1

2、 设置为静态库类型
Mach-O Type 设置为 Static Library

Mach-O Type

3、 Other Linker Flags 添加 -ObjC
如果SDK工程有使用分类(Category),则需要添加这个设置
经Xcode12.3上实测,只有当 SDK 工程使用了分类(categories),且 Demo 工程使用了这个 SDK ,Demo 工程才需要添加这个设置。如果 Demo 工程不使用这样的静态库,就算 Demo 工程自己有使用分类(categories), Demo 工程也无需添加这个设置。

-ObjC

4、关于指令值设置
最新版Xcode(我当前Xcode版本12.3)默认支持支持的真机指令集为 arm64 和 armv7,无需额外设置


指令集设置

如图,选择 Any iOS Device 为真机,可构建出真机 Framework;选择 iOS Simulator 中任意一个,为模拟器,可构建出模拟器 Framework。


选择真机/模拟器

可以使用 lipo 命令工具对生成的真机 Framework 和模拟器 Framework 进行指令集合并。

5、设置完成,关闭工程。

四、创建 Demo 工程

创建这个 Demo 工程用来测试 SDK。
1、Xcode > File > New > Project

创建Demo工程1

2、iOS > App > Next

创建Demo工程2

3、填写工程名 > 修改包名 > 设置使用语言 > Next


创建Demo工程3

4、选择存放位置 > Create
此处我选择第一步创建的文件夹 NiceSDK

创建Demo工程4

五、设置 Demo 工程

1、移除 SceneDelegate
由于苹果在 iOS13 以上使用 SceneDelegate 来支持应用多场景,因此Xcode11 以上创建 APP工程会默认生成 SceneDelegate。因为我们不需要这个,因此移除。

(1)为 AppDelegate 添加 window 属性:


AppDelegate 添加 window 属性

(2)移除 AppDelegate.m 中这两个方法


移除方法

(3)移除 SceneDelegate 文件


移除 SceneDelegate 文件

(4)移除 Info.plist 中的 Application Scene Manifest 项目


移除Application Scene Manifest

2、Other Linker Flags 添加 -ObjC
一般静态库都有使用分类(categories),因此Demo工程需要添加这个设置


-ObjC

3、关闭 Bitcode
因为 NiceSDK 可能会集成其他家的SDK,当其它家的SDK不支持 Bitcode 时,我们就需要将关闭 Bitcode。


Bitcode

4、设置完成,关闭工程。

五、xcworkspace

这两个就是创建的SDK工程和Demo工程,现在创建xcworkspace将他们关联起来,开发的时候就可以联调了。


SDK & Demo 工程

1、创建 xcworkspace


创建 xcworkspace1

名字可自由取名,存放放到NiceSDK下,方便管理

创建 xcworkspace2

2、关联工程
将 NiceSDK.xcodeproj 和 Demo.xcodeproj 拖进 xcworkspace 目录空间即可:


关联

六、接口开发

1、创建接口文件


创建文件1
创建文件2
创建文件3
创建文件4

2、创建接口
为方便管理,这里使用单例模式。
创建一个 test 接口,用来测试 SDK。

NiceSDKAPI.h

#import <Foundation/Foundation.h>

NS_ASSUME_NONNULL_BEGIN

@interface NiceSDKAPI : NSObject

+ (instancetype)shareInstance;

- (void)test;

@end

NS_ASSUME_NONNULL_END

NiceSDKAPI.m

#import "NiceSDKAPI.h"

@implementation NiceSDKAPI

+ (instancetype)shareInstance{
    static NiceSDKAPI *instance = nil;
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        instance = [[NiceSDKAPI alloc]init];
    });
    return instance;
}

- (instancetype)init
{
    self = [super init];
    if (self) {
        
    }
    return self;
}

- (void)test{
    NSLog(@"NiceSDK test interface");
}

@end

2、头文件暴露
对外暴露头文件,用于外部使用 SDK 的接口
1、我们将 NiceSDK.h 当做SDK对外的总的.h 文件,因此新创建的需要对外暴露的 .h 文件,可以将 import 写这里,这样外部在调用时,只需要 import NiceSDK.h 这个文件。

NiceSDK.h

#import <Foundation/Foundation.h>
// SDK 对外暴露的 .h 写这里
#import "NiceSDKAPI.h"

//! Project version number for NiceSDK.
FOUNDATION_EXPORT double NiceSDKVersionNumber;

//! Project version string for NiceSDK.
FOUNDATION_EXPORT const unsigned char NiceSDKVersionString[];

// In this header, you should import all the public headers of your framework using statements like #import <NiceSDK/PublicHeader.h>

2、工程设置需要暴露的头文件
只需要将需要对外暴露的 .h 文件添加到 public 中即可:


public

3、编译SDK
根据实际需要,选择好真机类型或模拟器类型,点击三角按钮,即可开始编译


编译SDK

4、测试SDK
将上面生成的 SDK 导入 Demo 工程中,调用 test 接口进行测试。

(1)Demo工程导入SDK
将文件放到 Demo 工程的 SDK 具体文件夹下


29.png

将 SDK 文件夹导入


30.png
31.png

(2)调用SDK代码

ViewController.m

#import "ViewController.h"

// 导入 NiceSDK
#import <NiceSDK/NiceSDK.h>

@interface ViewController ()

@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    // Do any additional setup after loading the view.
    
    // 调用 SDK test 接口
    [[NiceSDKAPI shareInstance]test];
}

(3)在模拟器上的运行结果:


运行结果

至此,我们成功创建了SDK工程和Demo工程,并成功测试了第一个SDK接口。

看懂请随手点赞,朋友们!🌹🌹🌹

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

推荐阅读更多精彩内容