Swift App

混入OC/C/C++代码

办法一

运用桥接文件。

办法二

运用.modulemap

1. Swift App项目，引进OC/C/C++文件。
2. 创立文件名有必要为module 后缀为.modulemap的文件。

3. 装备工程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 *
}

5. 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文件

1. 创立文件名有必要为module 后缀为.modulemap的文件。
2. 装备工程BuildSetting的Swift Compiler - Search Paths选项，值为module.modulemap文件地点的目录途径或其上层目录途径，此处可为：

${SRCROOT}/SwiftMixSDK/ObjcSources
${SRCROOT}/SwiftMixSDK

3. 装备module.modulemap内容

module ObjcInFramwork {
    header "ObjcClassA.h"
    header "ObjcClassB.h"
    export *
}

4. 运用

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头文件。

1. 装备 Frame Target的build Phases，使得OC头文件揭露

或

2. 在Swift Framework外接.h文件import需求揭露的OC头文件

3. 运用

import UIKit
import SwiftMixSDK
class ViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        SwiftMixTest.mixTest()
        ObjcClassA.description()
        ObjcClassB.description()
    }
}

4. 编译终究产品对外露出的头文件

或

办法二

自定义Swift Framework的.modulemap文件。

1. 自定义module.modulemap文件；此处的文件名不强制module，但主张用module，由于编译器终究会合并自定义的文件，终究导出module.modulemap文件。
2. 装备 Frame Target的build Setting，保证Define Module 为 YES; Module Map File 为自定义.modulemap文件的途径。

3. 装备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

4. 运用

import UIKit
import SwiftMixSDK.ObjcInFramwork
class ViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        SwiftMixTest.mixTest()
        ObjcClassA.description()
        ObjcClassB.description()
    }
}

5. 编译终究产品对外露出的头文件

小结

综上能够看出，两种办法编译的终究产品存在差异：

办法一会露出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，即可调用。