---
title: 向包添加测试
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/zh-cn/engine/6000.0/manual/packages-list/cus-pkg-development/cus-tests
latest_url: https://docs.unity.com/zh-cn/engine/7000.0/manual/packages-list/cus-pkg-development/cus-tests.md
last_updated: 2026-10-30
generated_at: 2026-11-18T10:57:47.635Z
locale: zh-cn
---

# 向包添加测试

> 在 Development 期间使用测试验证行为。

与Any类型的Development一样，最好将测试添加到包。必须执行三件事才能设置包的 ON 测试：

1. 创建 C# 测试文件并将[它们放在 Tests Folder 下](#location)。
2. 创建[测试 asmdef 文件](#files)。
3. 为包[启用测试](#tests)。

## 测试文件的位置##location-of-test-files

您可以将测试文件添加到包的 Tests Folder 的 `Editor` 和 `Runtime` 子文件夹中。例如，带有测试的 Simple 包可能如下所示：

```lang-plain
<package-root>
  ├── package.json
  ├── Editor
  │ ├── <company-name>.<package-name>.Editor.asmdef
  │     └── EditorExample.cs
  ├──运行时
  │     ├── <company-name>.<package-name>.asmdef
  │     └── RuntimeExample.cs
  └── Tests
        ├── Editor
        │ ├── <company-name>.<package-name>.Editor.Tests.asmdef
        │    └── EditorExampleTest.cs
        └── Runtime
             ├── <company-name>.<package-name>.Tests.asmdef
             └── RuntimeExampleTest.cs
```

每个子文件夹必须包含一个`.asmdef`文件，该文件提供对 Editor 和运行时程序集的引用。程序Assembly Definition文件还提供了对测试程序程序集文件的引用。有关更多信息，请参阅 [Assembly Definition 文件](#files)。

## 用于测试的 Assembly Definition 文件##assembly-definition-files-for-tests

使用 [Test Framework](https://docs.unity3d.com/Packages/com.unity.test-framework@latest/) 包可创建或编辑 Assembly Definition 文件。有关更多信息，请参阅[创建测试程序集](https://docs.unity3d.com/Packages/com.unity.test-framework@latest/index.html?subfolder=/manual/workflow-create-test-assembly.html)。

虽然可以选择直接编辑程序Assembly Definition文件，但需要make添加以下引用：

| **属性**                      | **Type（类型）** | **描述**                                                                                                                                 |
| --------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| **name**                    | 字符串          | 没有文件扩展名的程序集的 Name。                                                                                                                     |
| 参考：                         | 字符串数组        | 对 Editor 和运行时时程序集的引用。Assembly Definition 文件需要不同的引用，具体取决于测试类型 ON：- 对于 Editor 测试，请添加包的 Editor 和 运行时 程序集的引用。- 对于运行时时测试，仅添加对包的运行时时程程序集的引用。 |
| **optionalUnityReferences** | 字符串数组        | Unity 引用的列表必须包含用于将程序集标记为测试程序集的`"TestAssemblies"`。这会将对`nunit.framework.dll`和`UnityEngine.TestRunner.dll`库的引用添加到 Assembly Definition。    |
| **includePlatforms**        | 字符串数组        | 对于 Editor 测试，此平台列表必须包含 `"Editor"` 平台。                                                                                                  |

> **Tip:**
>
> 还可以在 Inspector 中编辑 Assembly Definition 文件。请参阅[程序集定义](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/assembly-definition-files.md)以了解更多信息。

### Editor 文件示例##editor-file-example

Editor 测试`.asmdef`文件如下所示：

```lang-json
{
  "name": "MyCompany.MyPackage.Editor.Tests",
  "references": [
    "MyPackage.Editor",
    "MyPackage"
  ],
  "optionalUnityReferences": [
    "TestAssemblies"
  ],
  "includePlatforms": [
    “Editor”
  ],
  "excludePlatforms": []
}
```

### 运行时文件示例##runtime-file-example

运行时测试`.asmdef`文件如下所示：

```lang-json
{
  "name": "MyCompany.MyPackage.Tests",
  "references": [
    "MyPackage"
  ],
  "optionalUnityReferences": [
    "TestAssemblies"
  ],
  "includePlatforms": [],
  "excludePlatforms": []
}
```

## 为包启用测试##enabling-tests-for-a-package

对于嵌入式式包，不需要显式Enable测试，因为嵌入式包正在Development中。

但是，对于其他类型的依赖项，您需要将可[测试项](/engine/6000.0/manual/packages-list/managing-packages-manifest/upm-manifest-prj.md#testables)属性添加到 Project 清单，并添加具有要运行的测试的包的名称。这包括Project的直接和间接依赖关系。例如：

```lang-json
{
  "dependencies": {
    "com.unity.some-package":"1.0.0",
    "com.unity.other-package":"2.0.0",
    "com.unity.yet-another-package":"3.0.0"
  },
  "testables": ["com.unity.some-package", "com.unity.other-package"]
}
```

此示例为 Unity 的 [Test Framework](https://docs.unity3d.com/Packages/com.unity.test-framework@latest) 包中的 **COM. unity.*some-包***&#x548C; **COM. Unity.*Other-包***&#x6DFB;加测试。

> **Note:**
>
> 您可能需要再次导入包，因为 Test Framework 并不总是能立即获取对 `testables` 属性的更改。
