文档

Unity 引擎

Unity 引擎

Unity 链接器标记Rules参考

了解 Unity 链接器在每个Managed剥离关卡应用的标记Rules,以确定要剥离的代码程序集的哪些部分。
阅读时间4 分钟最后更新于 6 天前

Unity 链接器执行Static分析When,Rules集来确定 CIL 字节码的哪些部分作为版本的必要标记:
  • Root Marking Rules 确定 Unity 链接器如何识别和保留版本中的顶部关卡程序集。
  • 依赖关系标记规则决定了 Unity 链接器如何识别和保留根程序集所依赖的任何代码 ON。
Configurationd Managed 剥离关卡会更改 Unity 链接器使用的 Rules 设置。以下部分将介绍每个 Managed 剥离关卡中的标记规则。

根标记Rules

下表描述了 Unity 链接器如何识别程序集内不同程序集类型和 Managed 剥离级别的顶部关卡类型:

程序集类型

托管剥离级别的根标记规则

.NET 类和平台 SDK 和 UnityEngine 程序集最小值和低:
  • 预防性保留
最小、低、中等和高:
  • Any
    link.xml
    文件中定义的保留
具有 Scene 中引用类型的程序集最小值和低:
  • 程序程序集中的All类型和成员
中等和高:
  • 具有
    [RuntimeInitializeOnLoadMethod]
    或
    [Preserve]
    属性的所有方法。
  • Any
    link.xml
    文件中定义的保留
  • 在预编译、包、Unity Script或程序Assembly Definition程序集内派派生 MonoBehaviour 和 ScriptableObject 的All类型。
所有其他最低水平
  • 程序程序集中的All类型和成员
低和中等:
  • All public 类型和这些类型的 public 成员
中等和高:
  • 具有
    [RuntimeInitializeOnLoadMethod]
    或
    [Preserve]
    属性的所有方法。
  • Any
    link.xml
    文件中定义的保留
  • 在预编译、包、Unity Script或程序Assembly Definition程序集内派派生 MonoBehaviour 和 ScriptableObject 的All类型。
测试最小、低、中等和高:
  • 具有
    [UnityTest]
    属性的任何方法和具有 NUnit.Framework 中定义的属性的任何方法。

依赖关系项标记Rules

Unity 链接器识别程序程序集的根后,需要识别这些根ON依赖的Any代码。下表描述了 Unity 链接器如何识别程序集在不同 Managed 剥离级别上的根类型的依赖关系:

Rule Target

Managed 剥离级别的依赖关系标记规则

MonoBehaviour最小、低、中等和高:
  • Unity 链接器在标记 MonoBehavior 类型When标记该类型的All成员
ScriptableObject最小、低、中等和高:
  • Unity 链接器在标记 ScriptableObject 类型When标记该类型的All成员
属性最小值和低:
  • Unity 链接器标记程序程序集、类型或Other代码结构When,也会标记这些结构的AllAttributes。
中等和高:
  • Unity 链接器标记程序程序集、类型或Other代码结构When,仅属性类型也被标记时,才会标记这些结构的Attributes。
调试 Attributes最小值和低:
  • 启用脚本调试时,Unity 链接器会标记具有
    [DebuggerDisplay]
    属性的所有成员,即使当没有使用这些成员的代码路径时也是如此。
中等和高:
  • Unity 链接器始终删除调试Attributes,例如
    DebuggerDisplayAttribute
    和
    DebuggerTypeProxyAttribute
    。
.NET Facade 类库最小、低、中等和高:
  • 删除外观程序集,因为在运行时不需要它们。

其他资源