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}"

相关代码下载

喜欢的老铁给个⭐️！