iOS 跨平台代码中条件编译
在 iOS 开发中，跨平台代码的条件编译是构建通用框架和组件的常见需求。当你需要针对不同的 Apple 系统平台进行代码适配时，#if canImport(UIKit) && !os(watchOS) 和 #if os(iOS) 这两种条件编译写法各有适用场景。本文将深入解析它们的本质区别，并提供清晰的选用指南。
背景：Apple 生态中的 UI 框架分布
要理解这两种写法的区别，首先需要了解 Apple 各系统中 UI 框架的分布：
| 系统平台 | 原生 UI 框架 | UIKit 支持情况 | 编译条件 |
|---|---|---|---|
| iOS (iPhone) | UIKit | 原生支持 | os(iOS) |
| iPadOS | UIKit | 原生支持 | os(iOS) (编译时与 iOS 相同) |
| tvOS | UIKit | 原生支持 | os(tvOS) |
| macOS | AppKit | 通过 Catalyst (Mac Catalyst) 支持 | os(macOS) 或 targetEnvironment(macCatalyst) |
| watchOS | WatchKit | 不支持 UIKit | os(watchOS) |
关键点：
- 虽然 iPadOS 是独立的操作系统，但在编译时仍使用
os(iOS)宏- UIKit 是 iOS、iPadOS、tvOS 的原生框架，但通过 Mac Catalyst 也可以在 macOS 上运行
- watchOS 完全不支持 UIKit
两种写法的本质逻辑分析
#if os(iOS)：基于系统类型的精确判断
这种写法检查编译目标是否为 iOS 系统（包含 iPhone 和 iPad）。
#if os(iOS)
// 这里的代码会在 iOS 和 iPadOS 设备上编译
#endif
优点：
- 逻辑简单直观，可读性高
- 对于 iOS/iPadOS 平台的功能非常合适
缺点：
- 不包含 tvOS（尽管 tvOS 也支持 UIKit）
- 不包含 macOS Catalyst（它支持 UIKit 但系统不是 iOS）
#if canImport(UIKit) && !os(watchOS)：基于框架可用性的智能适配
这种写法首先检查能否导入 UIKit 框架，然后主动排除 watchOS。
#if canImport(UIKit) && !os(watchOS)
// 这里的代码会在所有支持 UIKit 的平台上编译
// 包括：iOS、iPadOS、tvOS、macOS Catalyst
#endif
优点：
- 最大兼容性：覆盖所有支持 UIKit 的系统（iOS、iPadOS、tvOS、macOS Catalyst）
- 面向未来：如果 Apple 推出新系统支持 UIKit，此条件自动适配
- 明确排除：
!os(watchOS)让意图更清晰，即使canImport(UIKit)在 watchOS 上已经返回 false
缺点：
- 比
os(iOS)稍复杂，但可读性依然优秀
实际代码示例
通用 UIKit 扩展（推荐使用 canImport 写法）
// 适配所有支持 UIKit 的平台，排除 watchOS
#if canImport(UIKit) && !os(watchOS)
import UIKit
// 这是一个所有 UIKit 平台都能用的通用扩展
extension UIViewController {
func showAlert(title: String, message: String) {
let alert = UIAlertController(
title: title,
message: message,
preferredStyle: .alert
)
alert.addAction(UIAlertAction(title: "OK", style: .default))
present(alert, animated: true)
}
}
#endif
iOS/iPadOS 专属功能（使用 os(iOS) 写法）
// 仅针对 iOS 和 iPadOS 系统
#if os(iOS)
import UIKit
// 适用于 iOS/iPadOS 的功能
extension UIDevice {
var isPhone: Bool {
return userInterfaceIdiom == .phone
}
var isPad: Bool {
return userInterfaceIdiom == .pad
}
func triggerHapticFeedback(style: UIImpactFeedbackGenerator.FeedbackStyle) {
let generator = UIImpactFeedbackGenerator(style: style)
generator.impactOccurred()
}
}
#endif
运行时设备类型判断
由于编译时无法通过 os(iPadOS) 判断，需要在运行时区分设备类型：
#if os(iOS)
import UIKit
// 运行时判断设备类型
func deviceSpecificBehavior() {
switch UIDevice.current.userInterfaceIdiom {
case .phone:
// iPhone 专属逻辑
print("Running on iPhone")
case .pad:
// iPad 专属逻辑
print("Running on iPad")
default:
break
}
}
#endif
总结
掌握这两种条件编译写法的适用场景，能帮助你编写更清晰、更健壮的跨平台代码，提升代码的可维护性和可读性。如果考虑未来兼容性，使用基于框架可用性的判断（canImport）比基于系统版本的判断（os()）更具前瞻性。未来 Apple 推出新系统但支持 UIKit，代码无需修改就能适配。
