在Objective-C的SDK内部采用Swift混编(上)

4,045 阅读3分钟

装模作样写个前言

背景:拥有悠久历史的大型SDK,这个历史当然是Objective-C。又当然这个是没有问题的,而且每天都在服务上千万用户,但是不巧的是Apple出了一个StoreKit2,按理说每年苹果爸爸都要出很多API,这很正常。但是又不巧的是它只支持 Swift 编写,而且这样的API我估计只会成为常态,所以 Swift 化已经刻不容缓了。

结果:半夜执笔

温馨提示:本文实例代码已上传github,附录于(下)中。

编译环境:Xcode13.0 Swift5.5 arm64

如有不正,请在评论区告知我。

一、我们的SDK长什么样子?

SDK也就是我们所说的 Framework,其实大同小异,主要的不同点在于:

  • Headers 目录所包含的外放文件,其中可能包括:接口头文件,版本文档等供他人快速对接的工具。

  • Modules 目录包含的 module.modulemap 文件,其中包括一个最重要的外放头文件例如: yourProductName.h。

为什么会产生这两个文件呢?

  1. Headers 文件主要是我们内部判断放出哪几个文件,设置为 Public,来让外人可以看到。(PS: 其实就是不能完全暴露我们的代码,以及没那么杂乱,方便他人对接

  2. Modules 文件主要是接入 SDK 需要使用到的,与设置的 Target 名称有关。(PS: 这个与我们的混编大大相关

二、先让SDK跑起来

|没混编的SDK长这样的:

.//文件结构
├── PrefixHeader.pch  公共头文件,预编译
├── SWSDK.h  初始头文件-Public
├── TestOC.h   对外实际头文件 -Public
├── TestOC.m
├── TestOC2.h  内部实际功能文件 -Private
└── TestOC2.m
 
 
//modulesmap文件
framework module SWSDK {
  umbrella header "SWSDK.h"
 
  export *
  module * { export * }
}

下面展示一下我们的两个 OC 类,各有分工,请记住他们的名称。

//TestOC.m文件
#import "TestOC.h"
#import "TestOC2.h"
@implementation TestOC
 
+ (void) run  {
	NSLog(@"%s",__func__);
    [TestOC2 run];
}
 
 
//TestOC2.m文件
#import "TestOC2.h"
 
@implementation TestOC2
+ (void)run {
    NSLog(@"%s",__func__);
}
@end

到这里我们还是无法运行的,我们要修改SWSDK.h 使之可以访问开放文件

  • modulemap 是外部工程进入SDK的入口,作为入口的 SWSDK.h 文件目前空空如也。

  • 我们需要将 TestOC 导入SWSDK.h中,我们也需要将 TestOC.h 设置为 Public ,对外可见。

  • 设置为Public, Build Phases → Headers, 将 TestOC.h 从 Project 拖入 Public ,后方可如下图所示 import。

#import <Foundation/Foundation.h>
// In this header, you should import all the public headers of your framework using statements like #import <SWSDK/PublicHeader.h>
// 在此标头中,您应该使用 #import <SWSDK/PublicHeader.h> 之类的语句导入框架的所有公共标头
#import <SWSDK/TestOC.h>
//! Project version number for SWSDK.
FOUNDATION_EXPORT double SWSDKVersionNumber;
 
//! Project version string for SWSDK.
FOUNDATION_EXPORT const unsigned char SWSDKVersionString[]

我们可以在 AppDelegate.m 文件中继续操作:

#import "AppDelegate.h"
#import <SWSDK/SWSDK.h>
@interface AppDelegate ()
@end
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [TestOC run];
    return YES;
}
//输出
2021-11-04 16:58:42.893981+0800 TestDemo[834:85483] +[TestOC run]
2021-11-04 16:58:42.894028+0800 TestDemo[834:85483] +[TestOC2 run]

| 到这里,SDK内部的OC部分成功运行,但是没有达到我们的目的:在内部与 Swift 混编,终于在外部工程使用 OC 调用。

下一篇跳转这里