将 Swift 桥接到 Objective-C
学习如何通过自动生成的 Objective-C 生成头文件,让 Objective-C 代码访问 Swift 代码。
将 Swift 桥接到 Objective-C 是 CoddyKit 上的免费 Objective-C iOS Development for Legacy & Enterprise Apps 课时。 这是第 2 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Objective-C iOS Development for Legacy & Enterprise Apps 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Objective-C iOS Development for Legacy & Enterprise Apps 课程共包含 4 节课。
本课时的部分内容尚未翻译,以英文显示。
Swift to Obj-C: The Bridge
Welcome! In mixed-language projects, you often need Swift code to talk to Objective-C code. This lesson focuses on making your modern Swift classes and methods accessible to older Objective-C files.
This "bridging" allows you to gradually introduce Swift into an existing Objective-C codebase or have parts of your app written in different languages.
The Auto-Generated Header
When you add Swift files to an Objective-C project, Xcode automatically generates a special header file for you. It's named ProductModuleName-Swift.h.
This header acts as a translator, exposing your Swift code to the Objective-C world. You don't create it; Xcode does all the work! You just need to import it.
Exposing Swift Classes
For an Objective-C file to "see" a Swift class, that Swift class must inherit from NSObject. This is a fundamental requirement for Objective-C compatibility.
Without inheriting from NSObject, your Swift class won't appear in the auto-generated bridging header.
Using @objc for Visibility
The @objc attribute explicitly marks a Swift declaration (class, method, property, initializer) as available to Objective-C.
- Classes that inherit from
NSObjectand are notfinalautomatically expose their members. - You might need
@objcfor specific members if your class doesn't inherit fromNSObject(e.g., via a protocol) or for properties/methods that require KVC/KVO compatibility.
A Simple Swift Class
Here's a Swift class, MySwiftGreeter, that inherits from NSObject. Its name property and greet() method will be automatically exposed to Objective-C.
We can optionally use @objc(MySwiftGreeter) to specify the Objective-C name, though it's often inferred.
import Foundation
class MySwiftGreeter: NSObject {
@objc var name: String
@objc init(name: String) {
self.name = name
super.init()
}
@objc func greet() -> String {
return "Hello from Swift, \(name)!"
}
}Importing the Swift Header
To use your Swift classes in an Objective-C file, you simply need to import the auto-generated bridging header. Replace ProductModuleName with your project's actual module name.
This import should be in your Objective-C .m implementation file, not in a .h header file, to avoid circular dependencies and unnecessary exposure.
// In MyObjectiveCFile.m
#import "YourProjectName-Swift.h"
// Now you can use MySwiftGreeter
// ...Using Swift in Obj-C
Once the bridging header is imported, your Objective-C code can create instances of Swift classes and interact with their exposed properties and methods, just like any other Objective-C object.
Note: This code snippet shows how it would look in a project. Running it directly requires a full Xcode project setup with both Swift and Objective-C files.
#import <Foundation/Foundation.h>
#import "MyProjectName-Swift.h" // Your project's auto-generated header
int main(int argc, const char * argv[]) {
@autoreleasepool {
// Create an instance of the Swift class
MySwiftGreeter *greeter = [[MySwiftGreeter alloc] initWithName:@"Coddy"];
// Call a method on the Swift object
NSString *greeting = [greeter greet];
NSLog(@"%@", greeting);
// Access a property
NSLog(@"Greeter's name: %@", greeter.name);
}
return 0;
}Swift & Obj-C Type Map
When bridging, Swift types are automatically mapped to their closest Objective-C equivalents:
- Swift
Stringmaps toNSString* - Swift
Int,Double,Boolmap toNSNumber* - Swift
Arraymaps toNSArray* - Swift
Dictionarymaps toNSDictionary*
This allows seamless data exchange between the two languages.
Customizing Obj-C Names
Sometimes, Swift's inferred Objective-C name for a class or method might not be ideal, or it might conflict. You can provide a custom Objective-C name using @objc(NewName).
This is especially useful if you need to match existing Objective-C naming conventions or avoid clashes with existing Objective-C symbols.
import Foundation
@objc(LegacyGreeter) // Renames MySwiftGreeter to LegacyGreeter for Obj-C
class MySwiftGreeter: NSObject {
@objc var name: String
@objc(initWithPersonName:) // Custom name for initializer
init(name: String) {
self.name = name
super.init()
}
@objc(sayHello) // Custom name for method
func greet() -> String {
return "Hello from Swift, \(name)!"
}
}Bridging Limitations
Not all Swift features can be directly exposed to Objective-C. Keep these limitations in mind:
- Swift Structs & Enums: Unless they have raw values and conform to
@objc, they aren't directly visible. - Generics: Swift generics are not exposed.
- Global Functions: Only methods within
NSObject-derived classes are bridged. - Tuples: Swift tuples have no Objective-C equivalent.
Focus on classes, methods, and properties that mirror Objective-C's object model.
Bridging Knowledge Check
Which of the following is REQUIRED for a Swift class to be accessible from Objective-C code via the auto-generated bridging header?
Bridging Swift to Obj-C
You've learned how to make your Swift code available to Objective-C! Key takeaways:
- Xcode generates a
ProductModuleName-Swift.hheader. - Swift classes must inherit from
NSObjectto be seen by Objective-C. - The
@objcattribute explicitly exposes members or renames them. - Swift types like
String,Array, andDictionaryare automatically mapped to theirNScounterparts.
This bridging is crucial for maintaining and evolving mixed-language iOS projects!
常见问题解答
「将 Swift 桥接到 Objective-C」课时是免费的吗?
是的 — 「将 Swift 桥接到 Objective-C」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Objective-C iOS Development for Legacy & Enterprise Apps 课程的其余内容,请升级到 CoddyKit PRO。 Objective-C iOS Development for Legacy & Enterprise Apps 课程共包含 4 节课。
「将 Swift 桥接到 Objective-C」这节课中我会学到什么?
学习如何通过自动生成的 Objective-C 生成头文件,让 Objective-C 代码访问 Swift 代码。 你通过在浏览器中直接运行的动手代码来练习 Objective-C iOS Development for Legacy & Enterprise Apps,全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Objective-C iOS Development for Legacy & Enterprise Apps 需要有经验吗?
无需任何先前经验。CoddyKit 上的 Objective-C iOS Development for Legacy & Enterprise Apps 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 2 节课,共 4 节。
「将 Swift 桥接到 Objective-C」课时需要多长时间?
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。
我能在这节 Objective-C iOS Development for Legacy & Enterprise Apps 课中编写并运行代码吗?
能。每节 Objective-C iOS Development for Legacy & Enterprise Apps 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 将 Objective-C 桥接到 Swift
- 将 Swift 桥接到 Objective-C
- 创建 Objective-C 框架
- 处理桥接过程中的可空性与类型映射