文档

Unity 引擎

Unity 引擎

Unity 中的条件编译

Overview如何在 Unity 脚本使用条件编译以及When使用条件编译。
阅读时间4 分钟最后更新于 6 天前

Unity 对 C# 语言的 Support 包括使用指令,这些指令允许您根据 ON 是否定义了某些脚本符号,有选择地在编译中包含或排除代码。ON 这些指令在 C# 中的工作原理的更多信息,请参阅 Microsoft ON C# 预处理器指令的文档。
Unity 具有一范围预定义符号,可以在脚本中使用它们来选择性地包含或排除编译中的代码部分。例如,在 Windows 独立平台的项目构建中定义的符号为
UNITY_STANDALONE_WIN
。您可以检查此符号是否使用特殊类型的
if
语句定义:
#if UNITY_STANDALONE_WIN Debug.Log("Standalone Windows");#endif
#if
和
#endif
前面的哈希(
#
)角色表示这些语句是在编译过程中处理的指令,而不是在运行时处理的指令。在前面的示例中,调试线包含在Project的 Windows 独立平台版本中以供编译。在 Unity Editor 或OtherTarget版本中编译When,会完全省略。这与使用常规 if 语句不同,后者可能仅在运行时绕过某些代码段的执行。
您可以使用
#elif
和
#else
指令来检查多个条件:
#if UNITY_EDITOR Debug.Log("Unity Editor");#elif UNITY_IOS Debug.Log("Unity iOS");#else Debug.Log("Any other platform");#endif
有几个预定义符号可用于根据选定的平台、Editor 版本和 Other System Environment 情况有选择地编译或省略代码。有关 Unity 预定义符号的完整列表,请参阅 Unity 脚本符号参考。
还可以使用 Editor、通过脚本或通过资源文件定义自己的脚本符号。有关更多信息,请参阅自定义脚本符号。
注意
脚本符号也称为定义符号、预处理器定义或仅定义。

指令的替代方案

预处理器指令并非总是有条件包含或排除代码的最合适或最可靠的方法。此处列出了其他方法。

**属性**Conditional`

您可以使用 C#
Conditional
属性,这是一种更干净、不易报错的函数剥离方式。有关更多信息,请参阅 ConditionalAttribute 类。常见的 Unity 回调(例如
Start()
、
Update()
、
LateUpdate()
、
FixedUpdate()
、
Awake()
)不受此属性影响,因为它们直接从引擎调用,并且出于性能原因,不会考虑它们的帐户。

程序Assembly Definition约束

在高关卡中进行条件编译的建议方法是将脚本组织在具有关联 Assembly Definition 文件的程序集内。如果要有条件包含或排除的代码位于程序集内,则可以配置 Assembly Definition 的 Define 约束,例如,仅当项目中存在给定版本的包时,才编译代码。

条件执行

您可以使用标准
if
语句强制执行已编译代码的条件执行,而不是条件编译。例如,Unity 的
UNITY_64
脚本符号对于 64 位架构而言是不可靠的测试,因此最好执行以下操作:
if (IntPtr.Size == 4){ // 32 bit code}else{ // 64-bit code}

其他资源