主要介绍了在一个项目中同时使用Swift和Objective-C代码的方法,在一个工程中同时使用Swift和Objective-C混合语言编程的方法.html
Swift 与 Objective-C 的兼容能力使你能够在同一个工程中同时使用两种语言。你能够用这种叫作 mix and match 的特性来开发基于混合语言的应用,能够用 Swfit 的最新特性实现应用的一部分功能,并没有缝地并入已有的 Objective-C 的代码中。ios
Mix and Match 概述编程
Objective-C 和 Swift 文件能够在一个工程中并存,无论这个工程本来是基于 Objective-C 仍是 Swift。你能够直接往现有工程中简单地添加另外一种语言的源文件。这种天然的工做流使得建立混合语言的应用或框架 target,与用单独一种语言时同样简单。swift
混合语言的工做流程只有一点点区别,这取决于你是在写应用仍是写框架。下面描述了普通的用两种语言在一个 target 中导入模型的状况,后续章节会有更多细节。app
在同个应用的 target 中导入框架
若是你在写混合语言的应用,可能须要用 Swift 代码访问 Objective-C 代码,或者反之。下面的流程描述了在非框架 target 中的应用。函数
将 Objective-C 导入 Swiftui
在一个应用的 target 中导入一些 Objective-C 文件供 Swift 代码使用时,你须要依赖与 Objective-C 的桥接头文件(bridging header)来暴露给 Swift。当你添加 Swift 文件到现有的 Objective-C 应用(或反之)时,Xcode 会自动建立这些头文件。spa
若是你赞成,Xcode 会在源文件建立的同时生成头文件,并用 product 的模块名加上 -Bridging-Header.h 命名。关于 product 的模块名,详见 Naming Your Product Module。翻译
你应该编辑这个头文件来对 Swift 暴露出 Objective-C 代码。
在同一 target 中将 Objective-C 代码导入到 Swift 中
1) 在 Objective-C 桥接头文件中,import 任何你想暴露给 Swift 的头文件,例如:
#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 类同样。
let myCell = XYZCustomCell()
myCell.subtitle = "A custom cell"
将 Swift 导入 Objective-C
向 Objective-C 中导入Swift 代码时,你依赖 Xcode 生成的头文件来向 Objective-C 暴露 Swift 代码。这是自动生成 Objective-C 头文件,它包含了你的 target 中全部 Swift 代码中定义的接口。能够把这个 Objective-C 头文件看做 Swift 代码的 umbrella header。它以 product 模块名加 -Swift.h 来命名。关于 product 的模块名,详见Naming Your Product Module。
你不须要作任何事情来生成这个头文件,只须要将它导入到你的 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 代码:
target 中任何 Swift 文件将会对 Objective-C .m 源文件可见,包括这个 import 语句。关于在 Objective-C 代码中使用 Swift 代码,详见 Using Swift from Objective-C。
导入到 Swift | 导入到 Swift | |
---|---|---|
Swift 代码 | 不须要import语句 | #import |
Objective-C 代码 | 不须要import语句;须要 Objective-C `umbrella头文件 | #import "Header.h" |
在同个 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 头文件,例如:
Swift 将会看到全部你在 umbrella header 中公开暴露出来的头文件,框架 target 中的全部 Swift 文件均可以访问你 Objective-C 文件的内容,不须要任何 import 语句。
将 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 源文件去。
这个 import 语句所包含的 Swift 文件均可以被同个框架 target 下的 Objective-C .m 源文件访问。关于在 Objective-C 代码中使用 Swift 代码,详见 Using Swift from Objective-C。
导入到 Swift | 导入到 Swift | |
---|---|---|
Swift 代码 | 不须要import语句 | #import |
Objective-C 代码 | 不须要import语句;须要 Objective-C `umbrella头文件 | #import "Header.h" |
在 Objective-C 中使用 Swift
当你将 Swift 代码导入 Objective-C 文件以后,用普通的 Objective-C 语法使用 Swift 类。
MySwiftClass *swiftObject = [[MySwiftClass alloc] init];
[swiftObject swiftMethod];
Swift 的类或协议必须用 @Objective-C attribute 来标记,以便在 Objective-C 中可访问。这个 attribute 告诉编译器这个 Swift 代码能够从 Objective-C 代码中访问。若是你的 Swift 类是 Objective-C 类的子类,编译器会自动为你添加 @Objective-C attribute。详见 Swift Type Compatibility。
你能够访问 Swift 类或协议中用 @Objective-C attribute 标记过东西,只要它和 Objective-C 兼容。不包括一下这些 Swift 独有的特性:
•Generics - 范型
•Tuples - 元组
•Enumerations defined in Swift - Swift 中定义的枚举
•Structures defined in Swift - Swift 中定义的结构体
•Top-level functions defined in Swift - Swift Swift 中定义的顶层函数
•Global variables defined in Swift - Swift 中定义的全局变量
•Typealiases defined in Swift - Swift 中定义的类型别名
•Swift-style variadics - Swift风格可变参数
•Nested types - 嵌套类型
•Curried functions - 柯里化后的函数
例如带有范型类型做为参数,或者返回元组的方法不能在 Objective-C 中使用。
为了不循环引用,不要将 Swift 代码导入到 Objective-C 头文件中。可是你能够在 Objective-C 头文件中前向声明(forward declare)一个 Swift 类来使用它,然而,注意不能在 Objective-C 中继承一个 Swift 类。
在 Objective-C 头文件中引用 Swift 类
这样前向声明 Swift 类:
@class MySwiftClass;
@interface MyObjective-CClass : NSObject
- (MySwiftClass *)returnSwiftObject;
/* ... */
@end
Product 模块命名
Xcode 为 Swift 代码生成的头文件的名称,以及 Xcode 建立的 Objective-C 桥接头文件名称,都是从你的 product 模块名生成的。默认你的 product 模块名和 product 名同样。然而,若是你的 product 名有特殊字符(nonalphanumeric,非数字、字母的字符),例如点号,那么它们会被下划线(_)替换以后做为你的 product 模块名。若是 product 名以数字开头,那么第一个数字会用下划线替换掉。
你能够给 product 模块名提供一个自定义的名称,Xcode 会用这个名称来命名桥接的和自动生成的头文件。你只须要在修改在build setting 中的 Product Module Name 便可。
问题解决提示
•把 Swift 和 Objective-C 文件看做相同的代码集合,并注意命名冲突; •若是你用框架,确保 Build Setting > Pakaging > Defines Module 设置为 Yes; •若是你使用 Objective-C 桥接头文件,确保在 Build Settings 中 Objective-C 桥接头文件的 build setting 是基于 Swfit 编译器,即 Code Generation 含有头文件的路径。这个路径必须是头文件自身的路径,而不是它所在的目录; •Xcode 使用你的 product 模块名,而不是 target 名来命名 Objective-C 桥接头文件和为 Swift 自动生成的头文件。详见 Naming Your Product Module; •为了在 Objective-C 中可用, Swift 类必须是 Objective-C 类的子类,或者用 @Objective-C 标记; •当你将 Swift 导入到 Objective-C 中时,记住 Objective-C 不会将 Swift 独有的特性翻译成 Objective-C 对应的特性。详见列表Using Swift from Objective-C; •若是你在 Swift 代码中使用你本身的 Objective-C 类型,确保先将对应的 Objective-C 头文件导入到你的 Swift 代码中,而后才将 Swift 自动生成的头文件 import 到 Objective-C .m 源文件中来访问 Swift 代码。