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

本节包含内容:

  • 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)
时间: 2024-10-25 21:17:11

在同个工程中使用 Swift 和 Objective-C(Swift 2.0更新)-b的相关文章

在OC项目工程中混编Swift

1.创建一个OC项目工程,然后在Build Settings中找到如下字段,修改. 2.然后在项目中创建swift文件,如果系统提示是否需要创建桥接文件的时候,点击确定. 然后在Build Settings,查找swift, 如图所示,会显示两个文件,一个上桥接文件(在项目工程中可见), 另一个是swift编译的.h文件(在项目工程中不可见), 但是可以使用按住Option+点击的方式进入查看. 3. 新建的swift类必须继承自NSObject或其子类,(NSObject是所有类的子类). 否

iOS开发--Swift 如何完成工程中Swift和OC的混编桥接(Cocoapods同样适用)

由于SDK现在大部分都是OC版本, 所以假如你是一名主要以Swift语言进行开发的开发者, 就要面临如何让OC和Swift兼容在一个工程中, 如果你没有进行过这样的操作, 会感觉异常的茫然, 不用担心, 整个过程非常简单. 在已有的Swift工程中, 当你需要使用OC的类文件, 或者需要集成SDK时, 创建你需要的OC的类文件, 创建结束后, 会提示生成一个桥接头文件, 点击蓝色Create按钮. *OC工程也一样, 只是要进行相反的操作, 在需要创建OC文件的时候创建一个Swift的文件 *创

在一个工程中同时使用Swift和Objective-C

Swift 与 Objective-C 的兼容能力使你可以在同一个工程中同时使用两种语言.你可以用这种叫做 mix and match 的特性来开发基于混合语言的应用,可以用 Swfit 的最新特性实现应用的一部分功能,并无缝地并入已有的 Objective-C 的代码中. Mix and Match 概述 Objective-C 和 Swift 文件可以在一个工程中并存,不管这个工程原本是基于 Objective-C 还是 Swift.你可以直接往现有工程中简单地添加另一种语言的源文件.这种自

集成Reveal到你的从Xcode工程中

集成Reveal:将Reveal加入您的Xcode工程 将Reveal加入您的Xcode工程,使得您团队中的其他成员无需任何额外的配置,就可以使用Reveal. 警告: 永远不要将包含Reveal动态库文件的应用正式发布.Apple不允许将含有动态加载库文件的iOS应用发布到Apple商店中. 在Xcode中打开您的iOS工程. 启动Reveal并选择__Help → Show Reveal Library in Finder__,这将会打开Finder窗口,并显示一个名为*iOS-Librar

使用cocoapods来管理IOS工程中的第三方类库

cocoapods是非常优秀的IOS包管理工具,用来管理第三方组件, 完美解决第三方类库库更新, 相互间依赖等关系. 参考cocoapods主页. 安装 一般换成国内的source会比较方便. sudo gem install cocoapods //会被墙掉. gem sources --remove https://rubygems.org/ gem sources -a http://ruby.taobao.org/ gem sources -l sudo gem install coco

.net 工程中引用出现感叹号

在工程中引用出现感叹号,有两个原因 原因1:  这是由于之前引用的Dll文件不见了. 右键有感叹号的项,然后选择 "属性" 里边有一个路径属性 这个路径就是之前这个Dll文件的路径,现在这个文件不在了,你需要找到现在这个文件的路径 右键有感叹号的项,然后选择"移除" 右键"引用",选择添加引用,然后选择那个不在的dll的真实路径 其他的项用相同的方式处理 原因2:可能是引用的.Net版本高于了当前工程的.Net版本 更改所引用的工程文件的.Net

在Qt工程中加Boost

摘要: Boost是一个很强大的C++库,堪比STL,里面有很多非常优秀的类库.我不多介绍,详情见官网:http://www.boost.org/ 要在我们的Qt工程中把这个库加进去应该怎么做呢?我今晚试了一下. Boost是一个很强大的C++库,堪比STL,里面有很多非常优秀的类库.我不多介绍,详情见官网:http://www.boost.org/ 要在我们的Qt工程中把这个库加进去应该怎么做呢?我今晚试了一下. 我从网上下载了Boost压缩文件,下载地址:boost_1_52_0.tar.g

step4----->往工程中添加Spring的子项目spring IO Platform------->通过maven添加相关框架(pom.xml)

添加Spring IO Platform的目的: 避免自己的project的外部依赖(external dependencies)之间产生版本冲突问题.更多详细信息参见:Spring IO Platform概述 具体操作步骤: step1,往自己的工程中添加Spring IO Platform 编写project的pom.xml,添加如下代码,引入Spring IO Platform <dependencyManagement> <dependencies> <depende

step4---&gt;往工程中添加Spring框架----&gt;修改maven的配置文件pom.xml,向工程中添加spring框架的某些模块

1.本文内容: 本文介绍使用maven向自己的项目中添加各种框架的方法,即如何配置maven的pom.xml来让maven帮助管理这些框架(包括Spring.SpringMVC.hibernate框架等等). 2.使用maven向自己的工程中添加框架: 2.1概述 若想使用maven向自己的工程中添加三方框架(如Spring.SpringMVC等),需要先确保你的工程是maven工程,如果你还不知道该如何在myeclipse中建立一个maven web project,请参考相关教程. 2.2使