文档

Unity 引擎

Unity 引擎

有条件包含程序集

使用脚本符号可以有条件地从编译中包含或排除程序集。
阅读时间6 分钟最后更新于 6 天前

您可以使用预处理器符号来Control是否编译程序程序集并将其包含在应用程序程序的构建中(包括 Editor 中的播放模式)。您可以指定必须为程序集定义哪些符号才能与 Assembly Definition 选项中的 Define 约束列表一起使用:
  1. 选择程序集的 Assembly Definition 可在
    Inspector員

    ?

    中查看其 Properties。
  2. 在**定义约束**部分中,单击 + 按钮向约束列表添加新符号。
  3. 进入符号Name。
  4. 单击 Apply(应用)。
ON 有关可用于定义约束的脚本符号的更多信息,请参阅定义约束。

基于 Unity 和 Project 包版本定义符号

如果需要根据 Project 使用 Unity 的指定版本还是包的指定版本在程序集内编译不同的代码,可以向 Version Defines 列表添加条目。此列表指定了 When a symbol 应定义的 Rules。对于版本号,可以指定计算到指定的版本或版本范围的逻辑表达式。
要有条件定义符号:
  1. 选择程序集的 Assembly Definition 资源可在 Inspector 中查看其 Properties。
  2. 在 版本定义 部分中,单击 + 按钮向列表添加条目。
  3. 设置Properties:
    • 如果资源:选择 Unity 或必须安装的包或模块 Order 才能定义此符号。
    • 版本为:计算到指定的版本或版本范围的表达式。请参阅版本定义表达式以了解语法规则。
    • 设置定义:要在满足版本条件When定义的脚本符号。
    版本表达式结果显示表达式评估到的版本。如果结果显示无效,则表明表达式语法不正确。
  4. 单击 Apply(应用)。
程序Assembly Definition中定义的符号仅在为该定义创建的程序程序集脚本的作用作用域。
注意
可以使用使用 版本定义 列表作为 定义约束 定义的符号。这意味着可以指定仅When包的指定的版本也安装在Project中时才使用程序程序集。

版本定义表达式

可以使用表达式指定确切版本或版本范围。
版本表达式使用数学间隔表示法,其中方括号
[]
表示范围包括端点,括号
()
表示范围不包括端点。
表说明了语法:

表达式

评估到

[1.3,3.4.1]
1.3.0 <= x <= 3.4.1
(1.3.0,3.4)
1.3.0 < x < 3.4.0
[1.1,3.4)
1.1.0 <= x < 3.4.0
(0.2.4,5.6.2-preview.2]
0.2.4 < x <= 5.6.2.-preview.2
[2.4.5]
x = 2.4.5
2.1.0-preview.7
x >= 2.1.0-preview.7
注意
表达式中不允许有空格。不支持通角色。

Unity Versioning方案

Unity 的当前版本(以及支持程序集定义的所有版本)使用具有三个部分的版本标示器:
MAJOR.MINOR.REVISION
,例如
6000.0.33f1
。
  • MAJOR
    版本为四位数字,表示 Unity
    2022.x.z
    及更早版本的释放年份,或 Unity 6(
    6000.x.z
    )以后的主要技术版本。
  • MINOR
    版本是 Target 释放季度,例如
    1
    、
    2
    、
    3
    或
    4
    。
  • REVISION
    标识符具有自己的三个部分,格式为:
    RRzNN
    ,其中:
    • RR
      是一个或两个数字修订号
    • z
      是指示释放类型的字母:
      • a
        = Alpha 释放
      • b
        = beta 释放
      • f
        = 法线 public 释放
      • c
        = China 释放版本(相当于 f)
      • p
        = 补丁释放
      • x
        = 实验性释放
    • NN
      是一个或两个数字递增数量
发布类型指示符比较如下:
a < b < f = c < p < x
Alpha 释放被认为早于 Beta,即早于法线(
f
)或 China(
c
)释放。补丁发布本始终晚于具有相同修订号的法线或China发布,而实验性的性发布晚于AnyOther发布类型。请注意,实验性的性版本不会在结束使用递增数量。
以下示例表达式包括 Unity 的Any 6000.0 或 6000.1 版本,但不包括 6000.2 或更高版本中的Any版本:
[6000.0,6000.2)

包和模块版本本号

包和模块版本指示符有四个部分,遵循 Semantic Versioning Format:
MAJOR.MINOR.PATCH-LABEL
。前三部分始终是数字,但 Label 是字符串。Unity 预览包使用字符串、
preview
或
preview.n
(其中
n > 0
)。
以下表达式示例包括
MAJOR.MINOR
版本在 3.2 到 6.1(含)之间的包的所有版本:
[3.2,6.1]

其他资源