Swift条件编译命令

在 Swift 中，条件编译指令是控制代码是否编译的强大工具。它们根据不同的条件（如平台、操作系统版本、编译标志等）编译或跳过代码。这对于编写跨平台应用或在不同的构建配置下执行不同代码非常有用。

1、#if

用于开始一个条件编译块。只有当条件为真时，编译器才会编译代码块内的内容。

#if condition
    // 只有 condition 为真时，这部分代码才会被编译
#endif

示例：

#if DEBUG
    print("这是 Debug 模式")
#endif

如果在 Debug 配置下编译应用，DEBUG 将是一个有效的条件。

2、#else

用于条件编译的 #if 块之后，表示当 #if 条件不成立时执行的代码。

#if condition
    // condition 为真时执行
#else
    // condition 为假时执行
#endif

示例：

#if DEBUG
    print("Debug 模式")
#else
    print("Release 模式")
#endif

3、#elseif

用于在 #if 语句中添加更多的条件。如果前面的条件不成立，编译器会检查 #elseif 后面的条件。

#if condition1
    // 如果 condition1 为真
#elseif condition2
    // 如果 condition1 为假，但 condition2 为真
#else
    // 如果前面都为假
#endif

示例：

#if os(iOS)
    print("iOS 平台")
#elseif os(macOS)
    print("macOS 平台")
#else
    print("其他平台")
#endif

4、#endif

结束一个条件编译块。

#if condition
    // 代码块
#endif

5、#available

检查特定平台或操作系统的版本。适用于代码只在某些平台版本上编译时。

if #available(iOS 14, *) {
    // iOS 14 或更高版本支持的代码
} else {
    // 其他版本的代码
}

这是一种非常常见的条件编译方式，用于 API 可用性检查。

6、平台相关条件编译指令

Swift 提供了用于判断平台的条件编译标志。可以根据目标平台来控制代码的编译。

#if os(iOS)：当编译目标是 iOS 平台时

#if os(macOS)：当编译目标是 macOS 平台时

#if os(watchOS)：当编译目标是 watchOS 平台时

#if os(tvOS)：当编译目标是 tvOS 平台时

示例：

#if os(iOS)
    // 只有在 iOS 平台上才会执行这段代码
    print("这是 iOS 平台")
#elseif os(macOS)
    // 只有在 macOS 平台上才会执行这段代码
    print("这是 macOS 平台")
#endif

7、#if canImport

用于判断当前平台是否支持特定的框架。它有助于在平台上编译不支持某些库时使用替代方法。

#if canImport(UIKit)
    import UIKit
#endif

例如，可以使用 #if canImport(UIKit) 来确保只有在 iOS、iPadOS 或其他支持 UIKit 的平台上，才导入 UIKit 框架，避免在 macOS 或 watchOS 上因 UIKit 不可用而导致编译错误。

在实际应用中可能存在第三方包不支持的框架，但是Xcode导入的包无法过滤使用的系统，比如Watch系统不支持QuartzCore，就必须使用导入条件来处理不兼容的框架。

8、#if targetEnvironment

用于判断当前的运行环境，例如模拟器、测试环境等。

#if targetEnvironment(simulator)：判断是否在模拟器中编译

#if targetEnvironment(macCatalyst)：判断是否在 Mac Catalyst 环境中编译

示例：

#if targetEnvironment(simulator)
    print("当前运行在模拟器上")
#else
    print("当前运行在真实设备上")
#endif

9、#if DEBUG 和 #if RELEASE

这是 Xcode 的预定义宏，可以在不同的构建配置下执行不同的代码。通常用于区分 Debug 和 Release 模式。

#if DEBUG：仅在 Debug 配置下编译

#if RELEASE：仅在 Release 配置下编译

示例：

#if DEBUG
    print("Debug 模式")
#else
    print("Release 模式")
#endif

10、#error 和 #warning

#error 用于在编译时抛出错误并停止编译。

#warning 用于给开发者提示警告信息，通常不会停止编译，但能让开发者看到警告。

示例：

#error("这是一个必须修复的错误")

总结

条件编译指令是处理多平台支持、不同配置下代码行为的强大工具。通过使用条件编译，在同一代码库中根据不同平台、构建配置或运行环境来编译不同的代码。常见的指令包括 #if、#elseif、#else、#available 等，它们可以优化代码，并解决跨平台或不同配置下的编译问题。

相关文章

Xcode报错信息提示 No such module ‘QuartzCore’： https://fangjunyu.com/2025/02/18/xcode%e6%8a%a5%e9%94%99%e4%bf%a1%e6%81%af%e6%8f%90%e7%a4%ba-no-such-module-quartzcore/