Swift App
混入OC/C/C++代碼
方法一
使用橋接文件。
方法二
使用.modulemap
-
Swift App
項目,引入OC/C/C++
文件。 - 創建文件名必須爲
module
後綴爲.modulemap
的文件。
- 配置工程
BuildSetting
的Swift Compiler - Search Paths
選項,值爲module.modulemap
文件所在的目錄路徑或其上層目錄路徑。
此處可爲:
${SRCROOT}/MixFrameworkTest
${SRCROOT}/MixFrameworkTest/ObjcInSwitApp
如果這裏的路徑配置不正確便會報錯:error build: No such module '*'
4.配置module.modulemap
內容
module OcInApp {
// 所引入頭文件相對於`.modulemap`的路徑; "./OcClassInApp.h"也可以
header "OcClassInApp.h"
export *
}
-
import
導入使用
import OcInApp
class ViewController: UIViewController {
override func viewDidLoad() {
super.viewDidLoad()
OcClassInApp.description()
}
}
混入OC Framework
如果引入的OC FrameWork
中含有Modules/module.modulemap
文件,則直接拖入Swift
工程中,使用import
引入並進行調用即可。
如果OC FrameWork
不支持modulemap
(沒有module.modulemap
文件),則有兩種方法:
方法一
建立橋接文件,按需導入頭文件
方法二
基於OC FrameWork/Modules/module.modulemap
路徑,創建module.modulemap
文件,並輸入以下內容並保存,之後便可使用import
引入並進行調用。
// 按需導入
framework module SameAsFrameWorkName { //必須與導入的`OC Framework`同名
header "A.h"
header "B.h"
header "b.h"
//..
export *
}
///遞歸導入
framework module SameAsFrameWorkName { //必須與導入的`OC Framework`同名
umbrella header "SameAsFrameWorkName.h" //SDK對外頭文件,包含SDK對外暴露的諸多.h文件
export *
module * { export * }
}
混入OC xcframework
與混入OC framework
操作基本一致,如果引入的OC xcframework
下不同的架構文件下的framework
中含有Modules/module.modulemap
文件,則直接拖入Swift
工程中,使用import
引入並進行調用即可。
如果OC xcframework
不支持modulemap
,也是有兩種方法:
方法一
建立橋接文件,按需導入頭文件。
方法二
對OC xcframework
下不同架構framework
,參考混入OC framework
的方法二,即可調用。
Swift Framework
當Swift Framework
,僅有Swift
類時,如果是需要SDK
外部使用的Class
或Method
,則只需要使用public
或open
修飾。
在Swift
工程導入Swift Framework
後,直接在Swift
的工程中使用即可。
import RadarSDK
class ViewController: UIViewController {
override func viewDidLoad() {
super.viewDidLoad()
RadarEntry.start()
}
}
注意:Swift Framework
中是不支持使用橋接文件的,不然的話會報錯:
混入OC/C/C++代碼
示例工程結構如下:
內部使用 OC
SDK
內部的Swift
類,不能直接使用OC
的代碼,並且不支持橋接文件。因此只能使用module.modulemap
文件
- 創建文件名必須爲
module
後綴爲.modulemap
的文件。 - 配置工程
BuildSetting
的Swift Compiler - Search Paths
選項,值爲module.modulemap
文件所在的目錄路徑或其上層目錄路徑,此處可爲:
${SRCROOT}/SwiftMixSDK/ObjcSources
${SRCROOT}/SwiftMixSDK
- 配置
module.modulemap
內容
module ObjcInFramwork {
header "ObjcClassA.h"
header "ObjcClassB.h"
export *
}
- 使用
import ObjcInFramwork
public class SwiftMixTest: NSObject {
public static func mixTest() {
ObjcClassA.description()
print("Swift MixIn OC")
}
}
外部使用OC
如果Swift Framework
外部需要調用混入的OC
,有兩種方法:
方法一
Swift Framework
外接.h
頭文件以#import <SwiftMixSDK/PublicHeader.h>
的方法對外公開需要使用的OC
頭文件。
- 配置
Frame Target
的build Phases
,使得OC
頭文件公開
或
- 在
Swift Framework
外接.h
文件import
需要公開的OC
頭文件
- 使用
import UIKit
import SwiftMixSDK
class ViewController: UIViewController {
override func viewDidLoad() {
super.viewDidLoad()
SwiftMixTest.mixTest()
ObjcClassA.description()
ObjcClassB.description()
}
}
- 編譯最終產物對外暴露的頭文件
或
方法二
自定義Swift Framework
的.modulemap
文件。
- 自定義
module.modulemap
文件;此處的文件名不強制module
,但建議用module
,因爲編譯器最終會合並自定義的文件,最終導出module.modulemap
文件。 - 配置
Frame Target
的build Setting
,保證Define Module
爲YES
;Module Map File
爲自定義.modulemap
文件的路徑。
- 配置
module.modulemap
內容
framework module SwiftMixSDK {
umbrella header "SwiftMixSDK.h"
export *
module * {export *}
module ObjcInFramwork {
header "/Users/*/Desktop/*/SwiftSDKExample/SwiftMixSDK/ObjcSources/ObjcClassA.h"
header "/Users/*/Desktop/*/SwiftSDKExample/SwiftMixSDK/ObjcSources/ObjcClassB.h"
export *
}
}
最終SDK
的modulemap
:
值得注意的是,此處的header
,只能使用絕對路徑,否則會出錯。 stackoverflow
此問題的QA
- 使用
import UIKit
import SwiftMixSDK.ObjcInFramwork
class ViewController: UIViewController {
override func viewDidLoad() {
super.viewDidLoad()
SwiftMixTest.mixTest()
ObjcClassA.description()
ObjcClassB.description()
}
}
- 編譯最終產物對外暴露的頭文件
小結
綜上可以看出,兩種方法編譯的最終產物存在差異:
方法一會暴露OC
頭文件的;方法二會隱藏OC
的頭文件。
多人協作開發Swift Framework
時,方法二會存在頻繁修改.modulemap
文件文件。因此實際開發中還得基於項目決定方案。
混入OC Framework
當OC Framework
不支持Module
時,有兩種方式混入OC Framework
。
方法一
通過使用.modulemap
文件,實現對OC Framework
調用。即:OC Framework
支持(自動或者手動)module
。
方法二
參考上述 混入OC/C/C++代碼 —— 內部使用OC ,創建module.modulemap
文件,配置相關Building Setting
。配置module.modulemap
內容如下:
module ObjcFramwork {
///相對於module.modulemap的相對路徑
umbrella header "../ObjcFramwork.framework/Headers/ObjcFramwork.h"
export *
module * { export * }
}
最後在Swift
文件中import ObjcFramwork
,即可調用。
混入OC xcframework
當OC xcframework
不支持Module
時,有兩種方式混入OC xcframework
。
方法一
對OC xcframework
下不同架構framework
,參考混入OC Framework
的方法一,進行操作後即可調用。
方法二
參考上述 混入OC/C/C++代碼 —— 內部使用OC ,創建module.modulemap
文件,配置相關Building Setting
;
這些操作與混入OC Framework
的方法二一致,唯一有區別在於:OC xcframework
包含多種架構的Framework
。
因此不能通過相對路徑直接引入,因爲不同架構路徑下的同一個頭文件會相互覆蓋而報錯;
如何解決呢?我們可以通過新建一個ObjcXCFramwork-umbrella.h
文件(可以是其它名稱),並在其中引入xcframework
的頭文件:
#import <MyTestSDK/MyTestSDK.h>
然後配置module.modulemap
內容如下:
module ObjcXCFramwork {
umbrella header "ObjcXCFramwork-umbrella.h"
export *
module * { export * }
}
最後在Swift
文件中import ObjcXCFramwork
,即可調用。