在同个工程中使用 Swift 和 Objective-C(Swift 2.0更新)

本节包含内容：

• Mix and Match 概述（Mix and Match Overview）

• 在同个应用的 target 中导入（Importing Code from Within the Same App Target）

• 在同个 Framework 的 target 中导入（Importing Code from Within the Same Framework Target）

• 导入外部 framework（Importing External Frameworks）

• 在 Objective-C 中使用 Swift（Using Swift from Objective-C）

• 为 Objective-C 接口重写 Swift 名称

• Product 模块命名（Naming Your Product Module）

• 问题解决提示（Troubleshooting Tips and Reminders）

Swift 与 Objective-C 的兼容能力使你能够在同一个工程中同时使用两种语言。你能够用这种叫作 mix and match 的特性来开发基于混合语言的应用，能够用 Swift 的最新特性实现应用的一部分功能，并没有缝地并入已有的 Objective-C 的代码中。
Mix and Match 概述

Objective-C 和 Swift 文件能够在一个工程中并存，无论这个工程本来是基于 Objective-C 仍是 Swift。你能够直接往现有工程中简单地添加另外一种语言的源文件。这种天然的工做流使得建立混合语言的应用或框架 target，与用单独一种语言时同样简单。

混合语言的工做流程只有一点点区别，这取决于你是在写应用仍是写框架。下面描述了普通的用两种语言在一个 target 中导入模型的状况，后续章节会有更多细节。

在同个应用的 target 中导入

若是你在写混合语言的应用，可能须要用 Swift 代码访问 Objective-C 代码，或者反之。下面的流程描述了在非框架 target 中的应用。

将 Objective-C 导入 Swift

在一个应用的 target 中导入一些 Objective-C 文件供 Swift 代码使用时，你须要依赖于 Objective-C 的桥接头文件（bridging header）来暴露给 Swift。当你添加 Swift 文件到现有的 Objective-C 应用（或反之）时，Xcode 会自动建立这些头文件。

若是你赞成，Xcode 会在源文件建立的同时生成头文件，并用 product 的模块名加上 -Bridging-Header.h 命名。关于 product 的模块名，详见 Naming Your Product Module。

你应该编辑这个头文件来对 Swift 暴露出 Objective-C 代码。

在同一 target 中将 Objective-C 代码导入到 Swift 中

1.在 Objective-C 桥接头文件中，import任何你想暴露给 Swift 的头文件，例如：

1 2 3

#import "XYZCustomCell.h" #import "XYZCustomView.h" #import "XYZCustomViewController.h"

2.确保在 Build Settings 中 Objective-C 桥接头文件的 build setting 是基于 Swfit 编译器，即 Code Generation 含有头文件的路径。这个路径必须是头文件自身的路径，而不是它所在的目录。

这个路径应该是你工程的相对路径，相似 Info.plist 在 Build Settings 中指定的路径。在大多数状况下，你不须要修改这个设置。

在这个桥接头文件中列出的全部 public 的 Objective-C 头文件都会对 Swift 可见。以后当前 target 的全部 Swift 文件均可以使用这些头文件中的方法，不须要任何 import 语句。用 Swift 语法使用这些 Objective-C 代码，就像使用系统自带的 Swift 类同样。

1 2	let myCell = XYZCustomCell() myCell.subtitle = "A custom cell"

将 Swift 导入到 Objective-C

当你在将 Swift 代码导入到 Objective-C 中时，你依赖于 Xcode 生成的头文件来将这些文件暴漏给 Objective-C。这个自动生成的文件是一个 Objective-C 头文件，它包含了你的 target 中全部 Swift 代码中定义的接口。能够把这个 Objective-C 头文件看做 Swift 代码的 umbrella header。头文件名称以 product 模块名加 -Swift.h 来命名。（关于 product 的模块名，详见Naming Your Product Module）。

默认状况下，生成的头文件包含了标记有public修饰符的 Swift 声明接口。它还包含那些打上，若是您的应用程序的目标有一个Objective-C的桥接头内部修改。标有private修饰符声明不会出如今所生成的报头。私人声明没有接触到Objective-C的，除非它们被明确标有@IBAction ，@IBOutlet，或@objc为好。若是您的应用程序的目标是编译测试启用，单元测试目标能够访问任何声明与内部修饰，仿佛他们与公众修饰符经过预先@testable的产品模块导入语句声明。

你不须要作任何事情来生成这个头文件，只须要将它导入到你的 Objective-C 代码来使用它。注意这个头文件中的 Swift 接口包含了它所使用到的全部 Objective-C 类型。若是你在 Swift 代码中使用你本身的 Objective-C 类型，确保先将对应的 Objective-C 头文件导入到你的 Swift 代码中，而后才将 Swift 自动生成的头文件导入到 Objective-C .m 源文件中来访问 Swift 代码。

在同一 target 中将 Swift 代码导入到 Objective-C 中

• 在相同 target 的 Objective-C .m 源文件中，用下面的语法来导入Swift 代码：

1	#import "ProductModuleName-Swift.h"

target 中任何 Swift 文件将会对 Objective-C .m 源文件可见，包括这个 import 语句。关于在 Objective-C 代码中使用 Swift 代码，详见 Using Swift from Objective-C。

在同个 Framework 的 target 中导入

若是你在写一个混合语言的框架，可能会从 Swift 代码访问 Objective-C 代码，或者反之。

将 Objective-C 导入 Swift

要将一些 Objective-C 文件导入到同个框架 target 的 Swift 代码中去，你须要将这些文件导入到 Objective-C 的 umbrella header 来供框架使用。

在同一 framework 中将 Objective-C 代码导入到 Swift 中

确保将框架 target 的 Build Settings > Packaging > Defines Module 设置为 Yes。而后在你的 umbrella header 头文件中导入你想暴露给 Swift 访问的 Objective-C 头文件，例如：

1	#import #import #import

Swift 将会看到全部你在 umbrella header 中公开暴露出来的头文件，框架 target 中的全部 Swift 文件均可以访问你 Objective-C 文件的内容，不须要任何 import 语句。

1 2	let myCell = XYZCustomCell() myCell.subtitle = "A custom cell"

将 Swift 导入 Objective-C

要将一些 Swift 文件导入到同个框架的 target 的 Objective-C 代码去，你不须要导入任何东西到 umbrella header 文件，而是将 Xcode 为你的 Swift 代码自动生成的头文件导入到你的 Obj .m 源文件去，以便在 Objective-C 代码中访问 Swift 代码。

在同一 framework 中将 Swift 代码导入到 Objective-C 中

确保将框架 target 的 Build Settings > Packaging 中的 Defines Module 设置为 Yes。用下面的语法将 Swift 代码导入到同个框架 target 下的 Objective-C .m 源文件去。

1 2	// OBJECTIVE-C #import

这个 import 语句所包含的 Swift 文件均可以被同个框架 target 下的 Objective-C .m 源文件访问。关于在 Objective-C 代码中使用 Swift 代码，详见 Using Swift from Objective-C。

导入外部 Framework

你能够导入外部框架，无论这个框架是纯 Objective-C，纯 Swift，仍是混合语言的。import 外部框架的流程都是同样的，无论这个框架是用一种语言写的，仍是包含两种语言。当你导入外部框架时，确保 Build Setting > Pakaging > Defines Module 设置为 Yes。

用下面的语法将框架导入到不一样 target 的 Swift 文件中：

1	import FrameworkName

用下面的语法将框架导入到不一样 target 的 Objective-C .m 文件中：

1	@import FrameworkName;

在 Objective-C 中使用 Swift

当你将 Swift 代码导入 Objective-C 以后，即可用常规的 Objective-C 语法来使用 Swift 类。

1 2	MySwiftClass *swiftObject = [[MySwiftClass alloc] init]; [swiftObject swiftMethod];

Swift 的类或协议必须用 @objc属性来标记，以便在 Objective-C 中可访问。这个 属性告诉编译器这块 Swift 代码能够从 Objective-C 代码中访问。若是你的 Swift 类是 Objective-C 类的子类，编译器会自动为你添加 @objc。详见 Swift Type Compatibility。

你能够访问在 Swift 类或协议中使用用@objc属性标记的任何对象，只要该对象与 Objective-C 兼容。不包括如下 Swift 独有的特性：

• 范型（Generics）

• 元组（Tuples）

• Swift 中定义的枚举不包括Int原始值类型（Enumerations defined in Swift without Int raw value type）

• Swift 中定义的结构体（Structures defined in Swift）

• Swift 中定义的顶层函数（Top-level functions defined in Swift）

• Swift 中定义的全局变量（Global variables defined in Swift）

• Swift 中定义的类型别名（Typealiases defined in Swift）

• Swift风格可变参数（Swift-style variadics）

• 嵌套类型（Nested types）

• 柯里化函数（Curried functions）

例如，使用范型类型做为参数，或者返回元组的方法将不能在 Objective-C 中使用。

注意 你不能在 Objective-C 继承一个 Swift 类。

在 Objective-C 头文件中引用 Swift 类

这样前向声明 Swift 类：

1 2 3 4 5 6 7

// OBJECTIVE-C // MyObjective-CClass.h @class MySwiftClass; @interface MyObjective-CClass : NSObject - (MySwiftClass *)returnSwiftObject; /* ... */ @end

为 Objective-C 接口重写 Swift 名称

Swift 编译器自动的将 Objective-C 代码做为常规 Swift 代码导入。它将 Objective-C 的类工厂方法做为 Swift 构造器导入，以及将 Objective-C 的枚举类型名称截断处理。

在你的代码中也许存在不可以被自动处理的边界状况。若是你须要更改导入到 Swift 中的 Objective-C 方法，枚举，或者可选 set 值，你可使用NS_SWIFT_NAME宏来自定义导入的声明。

类工厂方法

若是 Swift 编译器没法识别类工厂方法，你可使用NS_SWIFT_NAME宏，来正确导入构造器的 Swift 签名。例如：

1	+ (instancetype)recordWithRPM:(NSUInteger)RPM NS_SWIFT_NAME(init(RPM:));

若是 Swift 编译器错误的将一个方法识别为类工厂方法，你可使用NS_SWIFT_NAME宏，来正确导入构造器的 Swift 签名。例如：

1	(id)recordWithQuality:(double)quality NS_SWIFT_NAME(record(quality:));

枚举

默认状况下，Swift 将枚举值的名称前缀作截断来导入枚举。若是要自定义枚举值的名称，你可使用NS_SWIFT_NAME宏来传递 Swift 枚举值名称。例如：

1 2 3 4

typedef NS_ENUM(NSInteger, ABCRecordSide) {   ABCRecordSideA,   ABCRecordSideB NS_SWIFT_NAME("FlipSide"), };

Product 模块命名

Xcode 为 Swift 代码生成的头文件的名称，以及 Xcode 建立的 Objective-C 桥接头文件名称，都是从你的 product 模块名生成的。默认你的 product 模块名和 product 名同样。然而，若是你的 product 名有特殊字符（nonalphanumeric，非数字、字母的字符），例如点号，那么它们会被下划线（_）替换以后做为你的 product 模块名。若是 product 名以数字开头，那么第一个数字会用下划线替换掉。

你能够给 product 模块名提供一个自定义的名称，Xcode 会用这个名称来命名桥接的和自动生成的头文件。你只须要在修改在 build setting 中的 Product Module Name 便可。

问题解决提示

• 把 Swift 和 Objective-C 文件看做相同的代码集合，并注意命名冲突。

• 若是你使用了框架，确保在Packaging下的Defines Module编译设置被设置为 Yes。

• 若是你使用了 Objective-C 桥接头文件，确保 Swift 编译器中 Objective-C 桥接头文件的编译设置Code Generation有一个与项目相关的头文件的路径。这个路径必须是头文件自身的路径，而不是它所在的目录。

• Xcode 使用你的工程模块名，而不是以target的名称来命名 Objective-C 桥接头文件以及为 Swift 代码 自动生成的头文件。详见 Naming Your Product Module。

• 为了在 Objective-C 中可用， Swift 类必须是 Objective-C 类的子类，或者用 @objc 标记。

• 当你将 Swift 导入到 Objective-C 中时，记住 Objective-C 不会将 Swift 独有的特性转化成 Objective-C 对应的特性。详见列表 Using Swift from Objective-C。

• 若是你在 Swift 代码中使用你本身的 Objective-C 类型，确保先将对应的 Objective-C 头文件导入到你的 Swift 代码中，而后才将 Swift 自动生成的头文件导入到 Objective-C .m 源文件中来访问 Swift 代码。

• 用private修饰符标记的 Swift 声明不会出如今自动生成的头文件中。私有声明不会暴漏给 Objective-C，除非它们被明确标记有@IBAction，@IBOutlet或者@objc等。

• 对于应用 targets 而言，若是有 Objective-C 桥接头文件时，被internal修饰符标记的声明会出如今自动产生的头文件中。

• 对于框架 targets 而言，只有被public修饰符标记的声明才会出如今自动生成的头文件中。你仍然能够在框架中的 Objective-C 部分使用被internal修饰符标记的 Swift 方法和属性，只要它们声明所在的类继承自 Objective-C 类。关于访问级别修饰符的更多信息，请查看The Swift Programming Language中的访问控制(Access Control)