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 <SwiftFramework/Teacher.h>去访问。
ps：Public和Private区实际上都是暴露给外部的，只是访问路径不一样。而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类，可以使用它去调用Teacher的API
6.在OC工程要调用SwiftFramework的Teacher的功能的时候
#import <SwiftFramework/SwiftFramework-Swift.h>
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
Person *p = [Person new];
[p talk]; // 打印10
}
@end
公司里面就会有这种场景，把想要隐藏的一定要隐藏，把该暴露的东西暴露出来。附上相关demo
二、创建Swift静态库并使用，同时适用于OC与Swift的工程
学会swift制作静态库
创建两个静态库工程 MySwiftA和 MySwiftB，然后编译生成静态库
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.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}"
喜欢的老铁给个⭐️！
网友评论