Version: 6000.3
语言: 中文
Unity 中的程序集简介
引用程序集

创建程序集资产

装配定义 (.asmdef) 资源允许您通过将新装配放置在包含脚本一段代码,允许您创建自己的组件、触发游戏事件、随时间修改组件属性以及以您喜欢的任何方式响应用户输入。更多信息
请参阅术语表
.

装配定义参考 (.asmref) 资源允许您将一组脚本文件显式包含在预先存在的程序集中。

创建装配定义资产

要创建装配定义资产,请执行以下作:

  1. “项目”窗口中,找到包含要包含在程序集中的脚本的文件夹。
  2. 在文件夹中创建程序集定义资产(菜单:资产>创建>脚本>程序集定义)。
  3. 为资产分配名称。默认情况下,装配文件使用您分配给资产的名称,但您可以在检查器一个 Unity 窗口,显示有关当前选定游戏对象、资产或项目设置的信息,允许您检查和编辑值。更多信息
    请参阅术语表
    窗。

Unity 会重新编译项目中的脚本以创建新程序集。然后,您可以编辑新程序集定义的属性

新程序集包括与程序集定义位于同一文件夹中的所有脚本,以及没有自己的程序集定义或引用文件的任何子文件夹中的脚本。Unity 会从其先前的程序集中删除脚本(如果适用)。

创建装配定义参考资产

要创建装配定义参考资产:

  1. “项目”窗口中,找到包含要包含在引用程序集中的脚本的文件夹。

  2. 在文件夹中创建程序集参考资产(菜单:“资源”>“创建>脚本”>“程序集定义参考”)。

  3. 为资产分配名称。

    Unity 会重新编译项目中的脚本以创建新程序集。完成后,您可以编辑新程序集定义参考的属性

  4. 选择新的装配定义引用资产以在检查器中查看其属性。

    “检查器”窗口显示选定装配定义参考资产的属性。
    “检查器”窗口显示选定装配定义参考资产的属性。
  5. 设置“装配定义”属性以引用目标“装配定义”资产。

  6. 单击应用

引用的程序集现在包括与程序集定义引用位于同一文件夹中的所有脚本,以及没有自己的程序集定义或引用文件的任何子文件夹中的脚本。Unity 会从其以前的程序集中删除脚本(如果适用)。

创建特定于平台的程序集

要为特定平台创建装配,请执行以下作:

  1. 创建装配定义资产

  2. 选择新的程序集定义资产以在检查器中查看其属性。

    “检查器”窗口显示“程序集定义”资产“平台”属性,其中选择了“任何平台”,并选择了“tvOS”作为要排除的平台。
    检查器窗口显示程序集定义资产的平台属性,其中选择了任何平台,并选择了 tvOS 作为要排除的平台。
  3. 选中“任何平台”选项,然后选择要排除的特定平台。或者,您可以取消选中“任何平台”并选择要包含的特定平台。

  4. 单击应用

当您为平台构建项目时,将根据所选平台包含(或排除)程序集。

为编辑器代码创建程序集

编辑器程序集允许您将编辑器脚本放在项目中的任何位置,而不仅仅是在名为Editor.

若要在项目中创建包含编辑器代码的程序集,请执行以下作:

  1. 在包含编辑器脚本的文件夹中创建特定于平台的程序集
  2. 仅包括编辑器平台。
  3. 如果你有其他包含编辑器脚本的文件夹,请在这些文件夹中创建程序集定义引用资产,并将其设置为引用此程序集定义。

创建测试程序集

测试程序集是 Unity 期望包含测试的程序集。将测试放入测试程序集中具有以下好处:

  • 它们将测试代码与您将交付给用户的应用程序代码分开,因此只能在需要时编译测试代码。
  • 测试程序集中的任何测试都会自动对测试框架包可见,这使得它们可以从测试运行程序测试框架包(以前称为测试运行程序)是一个 Unity 工具,可在编辑模式和播放模式下测试代码,也可以在目标平台(如独立平台、Android 或 iOS)上测试代码。更多信息
    请参阅术语表
    窗。

如果任何程序集具有对 nunit.framework.dll程序集引用以及对 UnityEngine.TestRunnerUnityEditor.TestRunner程序集定义引用,则 Unity 会自动将其标识为测试程序集。

有关安装测试框架包和创建测试程序集的说明,请参阅 Unity 测试框架文档。您可以使用编辑器UI创建预定义相关引用的程序集定义文件,也可以通过“检查器”窗口或直接编辑JSON文件手动配置引用。

注意:测试程序集不会作为常规生成管道的一部分进行编译,因此放置在测试程序集中的任何代码都将从标准项目生成中排除。只有当你通过 测试运行程序(Test Runner) 窗口在播放器中运行播放模式测试时,你的测试程序集代码才会包含在播放器中。如果生产代码意外未编译到项目生成中,请仔细检查以确保它不在测试程序集中。

其他资源

Unity 中的程序集简介
引用程序集