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 <SwiftFramework/Teacher.h>
去訪問。
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 <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
,然后編譯生成靜態庫
找到這兩個靜態庫,并且合并靜態庫,合并后靜態庫取名為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}"
喜歡的老鐵給個??!