条件编译

Unity 对 C# 的支持包括 编译指令（directives） 的使用，您可以根据某些 宏定义（Scripting Symbols） 是否已定义 ，选择性地包含或排除某些代码的编译。

有关这些指令在 C# 中如何工作的更多信息，请参阅 C# 预处理器指令 。

Unity 提供了一系列内置宏定义，您可以在脚本中使用它们，选择性地包含或排除某些代码的编译。

例如，在 Windows 独立平台的项目构建中设置的宏定义是 UNITY_STANDALONE_WIN。您可以使用一种特殊类型的 if 语句检查此符号是否已定义：

#if UNITY_STANDALONE_WIN

  Debug.Log("Standalone Windows");

#endif

位于if 和 endif 前面的字符# 表示这些语句是编译过程中处理的指令，而不是运行时处理的指令。

在上述示例中，Debug 行仅在项目的 Windows 独立平台构建中被编译。在 Unity 编辑器或其他平台构建的编译时，它会被完全忽略。这与常规使用的 if .. then .. else 语句不同，后者仅在运行时绕过某些代码的执行。完整示例请参阅下文。

Unity 有一些内置的宏定义，根据所选 平台、编辑器版本 和 其他 系统环境场景，您可以选择性地编译或省略代码。有关这部分内置宏定义的详细信息，请参阅下文。

您还可以通过资源文件、通过脚本，或使用编辑器界面自定义宏，以便控制部分代码的编译。更多信息请参阅 自定义宏。

注意：Scripting symbols（宏定义） 有时也被称为 “define symbols”、“preprocessor defines” 或简称 “defines”。

平台宏定义

Unity 会根据编辑环境和构建目标平台自动定义某些宏。具体如下：

编辑器版本宏定义

Unity 会根据您当前使用的编辑器版本自动定义某些宏。

假设版本号为 X.Y.Z__（例如 2019.4.14），Unity 会公开以下三种格式的全局宏定义：UNITY_X、UNITY_X_Y 和 UNITY_X_Y_Z__。

以下是 Unity 2019.4.14 中提供的宏定义示例：

您还可以根据编译或执行某部分代码所需的最低 Unity 版本，选择性地编译代码。按照上述相同的版本格式 ( X.Y ) ，Unity 会提供一个格式为 UNITY_X_Y_OR_NEWER 的全局 #define 。您可以用它来实现版本条件编译。

此外，团结引擎还包含以下版本宏定义：

以某一个版本为分界线，可以使用例如 TUANJIE_X_Y_OR_NEWER 的宏定义。

其他宏定义

Unity 定义的其他宏定义如下：

测试预编译代码

下面是如何使用预编译代码的示例。该示例根据为目标构建选择的平台打印一条消息。

首先，通过 File > Build Settings 选择要测试代码的平台。随后将显示 Build Settings 窗口；从此处选择目标平台。

选择要测试预编译代码的平台，然后单击 Switch Platform 向 Unity 告知您所需的目标平台。

创建脚本并复制/粘贴以下代码：

using UnityEngine;
using System.Collections;

public class PlatformDefines : MonoBehaviour {
  void Start () {

    #if UNITY_EDITOR
      Debug.Log("Unity Editor");
    #endif

    #if UNITY_IOS
      Debug.Log("iOS");
    #endif

    #if UNITY_STANDALONE_OSX
      Debug.Log("Standalone OSX");
    #endif

    #if UNITY_STANDALONE_WIN
      Debug.Log("Standalone Windows");
    #endif

  }          
}

如果您需要测试代码，请点击 Play Mode 。根据您选择的平台在 Unity 控制台中查看相关消息，以确认代码是否正常运行。例如，如果您选择了 iOS ，则应在控制台中看到消息 “Unity iOS”。

在 C# 中，可使用 CONDITIONAL 属性，这是一种更简洁、更不容易出错的函数剥离方式。请参阅 ConditionalAttribute 类以了解更多信息。 请注意，常见的 Unity 回调（例如：Start()、Update()、LateUpdate()、FixedUpdate()、Awake()）不受此属性的影响，因为它们是直接从引擎调用的，并且出于性能原因，此属性不会考虑它们。

除了基本的 #if 编译器指令外，还可在 C# 中使用多路测试：

#if UNITY_EDITOR

    Debug.Log("Unity Editor");

#elif UNITY_IOS

    Debug.Log("Unity iOS");

#else

    Debug.Log("Any other platform");

#endif