swift制作framework靜態(tài)庫
swift工程化實踐（一）
swift工程化實踐（二）

一、Swift Framework與OC交互

在我們普通的Swift工程里，創(chuàng)建OC的類就會提示讓你創(chuàng)建一個 ProjectName-bridge-header.h頭文件，這個文件的作用是把OC的代碼暴露給swift。

而在我們Swift Framework工程里去創(chuàng)建OC的類是不會提示咱們?nèi)?chuàng)建ProjectName-bridge-header.h頭文件的，這是因為Swift Framework工程默認有一個FrameworkName.h頭文件，它的作用和ProjectName-bridge-header.h頭文件的作用是一樣的，就無需另外創(chuàng)建bridge-header。

新建一個Swift Framework名稱叫SwiftFramework

編譯后出現(xiàn)源文件

可以看出 FrameworkName.h頭文件是用來管理一組頭文件用的。

此時我創(chuàng)建一個OC的Teacher類，創(chuàng)建一個Swift的Person類(引用了Teacher)。

OC工程訪問SwiftFramework第一種方式(完全暴露Teacher.h)：在SwiftFramework.h去 #import "Teacher.h"

這是Framework常報的錯誤，只需要把Teacher.h移動到public區(qū)即可。因為其中module.modulemap文件里umbrella header "SwiftFramework.h" 中的header代表的就是Headers目錄。

OC工程訪問SwiftFramework第二種方式(不完全暴露Teacher.h)：通過重寫.modulemap去聲明子module

1.SwiftFramework.h不導入"Teacher.h"
2.創(chuàng)建module.modulemap，聲明子module去導入"Teacher.h"

創(chuàng)建module.modulemap

3.創(chuàng)建.xcconfig，讓這個重寫的.modulemap生效

創(chuàng)建`.xcconfig`

4..xcconfig生效

此時就會出現(xiàn)一個問題：
我的這部分OC代碼我不想暴露給當前的SwiftFramework工程，那要怎么做呢？

將Teacher.h移動到Private區(qū)

新建一個名為module.private.modulemap

module.private.modulemap

讓這個PrivateModule生效

將原有的module.modulemap做出如下修改：

在使用import SwiftFramework就不能訪問Teacher類，而import SwiftFramework_Private是可以用的。

而對于使用SwiftFramework的使用者來說，（OC工程）可以通過#import <SwiftFramework/Teacher.h>去訪問。

ps：Public和Private區(qū)實際上都是暴露給外部的，只是訪問路徑不一樣。而Project區(qū)則是完全隱藏的。

ps

分析 ProjectName-Swift.h

為什么OC代碼訪問Swift代碼是通過 ProjectName-Swift.h ？

來看看 SwiftFramework-Swift.h 到底有什么內(nèi)容

ProjectName-Swift.h 把Swift暴露給OC的代碼重新翻譯了，作為OC能夠識別的頭文件。

當我們Swift代碼被@objc修飾時，編譯器就會把這段代碼看做是OC的代碼，編譯的時候就會按照OC的方式編譯并且放到Mach-O中，Mach-O有一個專門的section區(qū)域存放OC加載的符號信息。

我在編譯生成.o(重定位符號表)的過程中只需要頭文件，在linker的過程中才通過符號信息(比如talk函數(shù)符號所代表的匯編)去找Mach-O中對應的代碼。

分析至此呢就會有第三種訪問方式。

OC工程訪問SwiftFramework第三種方式(完全不暴露Teacher.h)：通過面向協(xié)議編程的方式

1.首先聲明一個協(xié)議和中間類
讓遵循AnimalProtocol的OC類都擁有這些函數(shù)特性并可以將類信息保存之中間類中去

2.讓OC類遵循這個協(xié)議，并實現(xiàn)對應的方法，在OC類load的時候?qū)⒃擃愖赃M中間類保存

3.創(chuàng)建一個SwiftToObjecive.h文件，用于把Swift協(xié)議和中間類暴露給OC（原理有提到是在 分析 ProjectName-Swift.h）

那么 SwiftToObjecive.h的內(nèi)容應該如何暴露呢？讓系統(tǒng)給我們生成，直接復制粘貼即可（熟練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協(xié)議）
    private static var animal: Animal.Type!
    
    // 把OC的類注冊進來
    @objc public static func registerAnimalType(type: Animal.Type) {
        animal = type
    }
    
    // Swift來調(diào)用
    func createAnimal() -> Animal {
        return Zoo.animal.init()
    }
}

編譯后，找到SwiftFramework-Swift.h并打開

于是SwiftToObjective.h的內(nèi)容如下：
SwiftToObjective.h是給OC的類(比如Teacher.m)編譯成 .o 來使用的

注意：我們并不是要把協(xié)議和中間類暴露給使用SwiftFramework的OC工程，所以記得把 public 還原成internal

4.不要忘了我們最初的目的是將 Teacher.h 完全不暴露出去，并且SwiftToObjective.h添加進Build Phases -> Headers

5.最后暴露的只有Person類，可以使用它去調(diào)用Teacher的API

6.在OC工程要調(diào)用SwiftFramework的Teacher的功能的時候

#import <SwiftFramework/SwiftFramework-Swift.h>

@implementation ViewController

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

公司里面就會有這種場景，把想要隱藏的一定要隱藏，把該暴露的東西暴露出來。附上相關demo

二、創(chuàng)建Swift靜態(tài)庫并使用，同時適用于OC與Swift的工程

學會swift制作靜態(tài)庫
創(chuàng)建兩個靜態(tài)庫工程 MySwiftA和 MySwiftB，然后編譯生成靜態(tài)庫

MySwiftA

MySwiftB

找到這兩個靜態(tài)庫，并且合并靜態(tài)庫，合并后靜態(tài)庫取名為libTeacher.a

合并靜態(tài)庫命令：

$ cd 靜態(tài)庫輸出路徑
$ libtool -static -o libTeacher.a /Users/linwenjun/Desktop/StaticFramework/MySwiftA/MySwiftA.framework/MySwiftA /Users/linwenjun/Desktop/StaticFramework/MySwiftB/MySwiftB.framework/MySwiftB

這個就是合并之后的靜態(tài)庫

合并之后這兩個東西我都可以不要了，直接刪除掉了

如何使用libTeacher.a呢？

新建一個OC工程名為App，將libTeacher.a和MySwiftA.framework和MySwiftB.frameworkcopy到主工程目錄下

App目錄

將libTeacher.a導入到App工程里
ps: 將.framework導入到App是沒有用的，因為我們原本刪除的文件已經(jīng)合并到libTeacher.a

那我們應該告訴編譯器如何訪問到.framework里的module.modulemap（它是管理一組頭文件的）就能導入對應的頭文件了，并且需要搜索那兩個FrameworkPaths

于是乎創(chuàng)建一個.xcconfig把參數(shù)配置上去

xcconfig

讓.xcconfig文件生效

xcconfig生效

OC類就可以訪問靜態(tài)庫的公開的API了：

Swift類就可以訪問靜態(tài)庫的公開的API了：

注意：我的Xcode版本是13.3.1，在以前的版本的話，Swift訪問類要訪問到靜態(tài)庫的公開的API還需要添加2步操作：

1.把Modules里的文件全部移動到上一層目錄

2.配置.xcconfig的參數(shù)

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

相關代碼下載

喜歡的老鐵給個??！