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"
3.创建.xcconfig
,让这个重写的.modulemap
生效
4..xcconfig
生效
此时就会出现一个问题:
我的这部分OC代码我不想暴露给当前的SwiftFramework
工程,那要怎么做呢?
将Teacher.h
移动到Private
区
新建一个名为module.private.modulemap
让这个PrivateModule生效
将原有的module.modulemap
做出如下修改:
在使用import SwiftFramework
就不能访问Teacher
类,而import SwiftFramework_Private
是可以用的。
而对于使用SwiftFramework
的使用者来说,(OC工程)可以通过#import
去访问。
ps:Public
和Private
区实际上都是暴露给外部的,只是访问路径不一样。而Project
区则是完全隐藏的。
分析 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
类,可以使用它去调用Teacher
的API
6.在OC工程要调用SwiftFramework
的Teacher
的功能的时候
#import
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
Person *p = [Person new];
[p talk]; // 打印10
}
@end
公司里面就会有这种场景,把想要隐藏的一定要隐藏,把该暴露的东西暴露出来。附上相关demo
二、创建Swift静态库并使用,同时适用于OC与Swift的工程
学会swift制作静态库
创建两个静态库工程 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.a
和MySwiftA.framework
和MySwiftB.framework
copy到主工程目录下
将libTeacher.a
导入到App
工程里
ps: 将.framework导入到App
是没有用的,因为我们原本删除的文件已经合并到libTeacher.a
那我们应该告诉编译器如何访问到.framework里的module.modulemap
(它是管理一组头文件的)就能导入对应的头文件了,并且需要搜索那两个FrameworkPaths
于是乎创建一个.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}"
相关代码下载
喜欢的老铁给个⭐️!