程序Assembly Definition和包
Configure 程序集定义,以便 Editor 将包脚本编译为单独的程序集。
阅读时间2 分钟最后更新于 8 天前
必须将包内的脚本与 Assembly Definition 文件()关联。程序Assembly Definition文件是 Unity,相当于 .NET 生态系统中的 C# Project。必须在程序Assembly Definition文件中设置对Other程序集的显式引用(无论是在同一个包还是在External包中)。请参阅程序集定义以了解更多详细信息。
.asmdef使用这些约定来命名和存储 Assembly Definition 文件,以确保编译的程序集文件名遵循 .NET Framework 设计准则:
-
将 Editor 指定的代码存储在根 Editor Assembly Definition 文件下:
Editor/<company-name>.<package-name>.Editor.asmdef -
将运行时指定的代码存储在根运行时 Assembly Definition 文件下:
Runtime/<company-name>.<package-name>.asmdef -
为Editor器和运行时时脚本Configure相关的测试程序集:
Tests/Editor/<company-name>.<package-name>.Editor.Tests.asmdefTests/Runtime/<company-name>.<package-name>.Tests.asmdef
要更一般地查看推荐的包 Folder Layout,请参阅包 Layout。
示例文件
在此示例中,Assembly Definition 文件使用对其自身程序集的引用,以及属于包依赖关系 (HDRP) 一部分的程序集:
{ "name": "MyCompany.MyPackageName", "references": [ "MyCompany.MyPackageName.Tools", "MyCompany.MyPackageName.Planes", "Unity.RenderPipelines.HighDefinition.Runtime" ], "includePlatforms": [], "excludePlatforms": [], "allowUnsafeCode": false, "overrideReferences": false, "precompiledReferences": [], "autoReferenced": true, "defineConstraints": [], "versionDefines": [ { "name": "com.unity.render-pipelines.high-definition", "expression":"7.1.0", "define":"HDRP_7_1_0_OR_NEWER" }, { "name": "com.unity.modules.particlesystem", "expression":"1.0.0", "define":"USING_PARTICLE_SYSTEM" } ], "noEngineReferences": false}
有关 Assembly Definition 文件结构的细节,请参阅 Assembly Definition File Format。