Unity 中的条件编译
Overview如何在 Unity 脚本使用条件编译以及When使用条件编译。
阅读时间4 分钟最后更新于 6 天前
Unity 对 C# 语言的 Support 包括使用指令,这些指令允许您根据 ON 是否定义了某些脚本符号,有选择地在编译中包含或排除代码。ON 这些指令在 C# 中的工作原理的更多信息,请参阅 Microsoft ON C# 预处理器指令的文档。
Unity 具有一范围预定义符号,可以在脚本中使用它们来选择性地包含或排除编译中的代码部分。例如,在 Windows 独立平台的项目构建中定义的符号为 。您可以检查此符号是否使用特殊类型的语句定义:
UNITY_STANDALONE_WINif#if UNITY_STANDALONE_WIN Debug.Log("Standalone Windows");#endif
#if#endif#您可以使用 和 指令来检查多个条件:
#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# 属性,这是一种更干净、不易报错的函数剥离方式。有关更多信息,请参阅 ConditionalAttribute 类。常见的 Unity 回调(例如 、、、、)不受此属性影响,因为它们直接从引擎调用,并且出于性能原因,不会考虑它们的帐户。
ConditionalStart()Update()LateUpdate()FixedUpdate()Awake()程序Assembly Definition约束
在高关卡中进行条件编译的建议方法是将脚本组织在具有关联 Assembly Definition 文件的程序集内。如果要有条件包含或排除的代码位于程序集内,则可以配置 Assembly Definition 的 Define 约束,例如,仅当项目中存在给定版本的包时,才编译代码。
条件执行
您可以使用标准语句强制执行已编译代码的条件执行,而不是条件编译。例如,Unity 的脚本符号对于 64 位架构而言是不可靠的测试,因此最好执行以下操作:
ifUNITY_64if (IntPtr.Size == 4){ // 32 bit code}else{ // 64-bit code}