Swift进阶-工程化实践(二)

swift制作framework静态库
swift工程化实践(一)
swift工程化实践(二)

一、Swift Framework与OC交互

在我们普通的Swift工程里,创建OC的类就会提示让你创建一个 ProjectName-bridge-header.h头文件,这个文件的作用是把OC的代码暴露给swift。

而在我们Swift Framework工程里去创建OC的类是不会提示咱们去创建ProjectName-bridge-header.h头文件的,这是因为Swift Framework工程默认有一个FrameworkName.h头文件,它的作用和ProjectName-bridge-header.h头文件的作用是一样的,就无需另外创建bridge-header。

新建一个Swift Framework名称叫SwiftFramework

编译后出现源文件

可以看出 FrameworkName.h头文件是用来管理一组头文件用的。

此时我创建一个OC的Teacher类,创建一个Swift的Person类(引用了Teacher)。

OC工程访问SwiftFramework第一种方式(完全暴露Teacher.h):在SwiftFramework.h#import "Teacher.h"

这是Framework常报的错误,只需要把Teacher.h移动到public区即可。因为其中module.modulemap文件里umbrella header "SwiftFramework.h" 中的header代表的就是Headers目录。

OC工程访问SwiftFramework第二种方式(不完全暴露Teacher.h):通过重写.modulemap去声明子module

1.SwiftFramework.h不导入"Teacher.h"
2.创建module.modulemap,声明子module去导入"Teacher.h"

创建module.modulemap

3.创建.xcconfig,让这个重写的.modulemap生效

创建`.xcconfig`

4..xcconfig生效

此时就会出现一个问题:
我的这部分OC代码我不想暴露给当前的SwiftFramework工程,那要怎么做呢?

Teacher.h移动到Private

新建一个名为module.private.modulemap

module.private.modulemap

让这个PrivateModule生效

将原有的module.modulemap做出如下修改:

在使用import SwiftFramework就不能访问Teacher类,而import SwiftFramework_Private是可以用的。

而对于使用SwiftFramework的使用者来说,(OC工程)可以通过#import 去访问。

ps:PublicPrivate区实际上都是暴露给外部的,只是访问路径不一样。而Project区则是完全隐藏的。

ps

分析 ProjectName-Swift.h

为什么OC代码访问Swift代码是通过 ProjectName-Swift.h

来看看 SwiftFramework-Swift.h 到底有什么内容

ProjectName-Swift.h 把Swift暴露给OC的代码重新翻译了,作为OC能够识别的头文件。

当我们Swift代码被@objc修饰时,编译器就会把这段代码看做是OC的代码,编译的时候就会按照OC的方式编译并且放到Mach-O中,Mach-O有一个专门的section区域存放OC加载的符号信息。

我在编译生成.o(重定位符号表)的过程中只需要头文件,在linker的过程中才通过符号信息(比如talk函数符号所代表的汇编)去找Mach-O中对应的代码。

分析至此呢就会有第三种访问方式。

OC工程访问SwiftFramework第三种方式(完全不暴露Teacher.h):通过面向协议编程的方式

1.首先声明一个协议和中间类
让遵循AnimalProtocol的OC类都拥有这些函数特性并可以将类信息保存之中间类中去

2.让OC类遵循这个协议,并实现对应的方法,在OC类load的时候将该类注册进中间类保存

3.创建一个SwiftToObjecive.h文件,用于把Swift协议和中间类暴露给OC(原理有提到是在 分析 ProjectName-Swift.h

那么 SwiftToObjecive.h的内容应该如何暴露呢?让系统给我们生成,直接复制粘贴即可(熟练OC的自己敲吧)。

先把需要暴露的代码用public修饰

import Foundation

@objc(AnimalProtocol) // 给OC使用时就叫 AnimalProtocol
public protocol Animal {
    init()
    func walk(withStep: Int) // 走了几步
}


// 中间类
@objc(Zoo)
public class Zoo: NSObject { // internal是当前SwiftFramework可见
    // 用来保存OC的类(遵循swift协议)
    private static var animal: Animal.Type!
    
    // 把OC的类注册进来
    @objc public static func registerAnimalType(type: Animal.Type) {
        animal = type
    }
    
    // Swift来调用
    func createAnimal() -> Animal {
        return Zoo.animal.init()
    }
}

编译后,找到SwiftFramework-Swift.h并打开

于是SwiftToObjective.h的内容如下:
SwiftToObjective.h是给OC的类(比如Teacher.m)编译成 .o 来使用的

注意:我们并不是要把协议和中间类暴露给使用SwiftFramework的OC工程,所以记得把 public 还原成internal

4.不要忘了我们最初的目的是将 Teacher.h 完全不暴露出去,并且SwiftToObjective.h添加进Build Phases -> Headers

5.最后暴露的只有Person类,可以使用它去调用TeacherAPI

6.在OC工程要调用SwiftFrameworkTeacher的功能的时候

#import 

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    Person *p = [Person new];
    [p talk]; // 打印10
}
@end

公司里面就会有这种场景,把想要隐藏的一定要隐藏,把该暴露的东西暴露出来。附上相关demo

二、创建Swift静态库并使用,同时适用于OC与Swift的工程

学会swift制作静态库
创建两个静态库工程 MySwiftAMySwiftB,然后编译生成静态库

MySwiftA
MySwiftB

找到这两个静态库,并且合并静态库,合并后静态库取名为libTeacher.a

合并静态库命令:

$ cd 静态库输出路径
$ libtool -static -o libTeacher.a /Users/linwenjun/Desktop/StaticFramework/MySwiftA/MySwiftA.framework/MySwiftA /Users/linwenjun/Desktop/StaticFramework/MySwiftB/MySwiftB.framework/MySwiftB

这个就是合并之后的静态库

合并之后这两个东西我都可以不要了,直接删除掉了

如何使用libTeacher.a呢?

新建一个OC工程名为App,将libTeacher.aMySwiftA.frameworkMySwiftB.frameworkcopy到主工程目录下

App目录

libTeacher.a导入到App工程里
ps: 将.framework导入到App是没有用的,因为我们原本删除的文件已经合并到libTeacher.a

那我们应该告诉编译器如何访问到.framework里的module.modulemap(它是管理一组头文件的)就能导入对应的头文件了,并且需要搜索那两个FrameworkPaths

于是乎创建一个.xcconfig把参数配置上去

xcconfig

.xcconfig文件生效

xcconfig生效

OC类就可以访问静态库的公开的API了:

Swift类就可以访问静态库的公开的API了:

注意:我的Xcode版本是13.3.1,在以前的版本的话,Swift访问类要访问到静态库的公开的API还需要添加2步操作:

1.把Modules里的文件全部移动到上一层目录

2.配置.xcconfig的参数

// clang 访问到.modulemap
OTHER_CFLAGS  = "-fmodule-map-file=${SRCROOT}/MySwiftA.framework/module.modulemap" "-fmodule-map-file=${SRCROOT}/MySwiftB.framework/module.modulemap"

// 告诉swiftc编译器 访问到 Modules
SWIFT_INCLUDE_PATHS = "${SRCROOT}/MySwiftA.framework/Modules" "${SRCROOT}/MySwiftB.framework"

// 搜索导入的.framework
FRAMEWORK_SEARCH_PATHS = "${SRCROOT}"

相关代码下载

喜欢的老铁给个⭐️!

你可能感兴趣的:(Swift进阶-工程化实践(二))