Version: 2023.2
언어: 한국어
패키지 레이아웃
패키지용 샘플 생성

패키지에 테스트 추가

모든 종류의 개발과 마찬가지로 패키지에 테스트를 추가하는 것이 좋습니다.패키지에 테스트를 설정하려면 다음 세 가지를 수행해야 합니다.

  1. C# 테스트 파일을 만든 후 Tests 폴더에 넣습니다.
  2. 테스트를 위해 asmdef 파일을 만듭니다.
  3. 패키지에 대해 테스트를 활성화합니다.

테스트 파일의 위치

테스트 파일을 EditorRuntime 하위 폴더에 있는 패키지의 Tests 폴더에 추가할 수 있습니다. 예를 들어 테스트가 포함된 간단한 패키지는 다음과 같이 보일 수 있습니다.

<package-root>
  ├── package.json
  ├── Editor
  │     ├── <company-name>.<package-name>.Editor.asmdef
  │     └── EditorExample.cs
  ├── Runtime
  │     ├── <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 파일을 포함해야 합니다. 어셈블리 정의 파일은 테스트 어셈블리 파일에 대한 레퍼런스도 제공합니다. 자세한 내용은 테스트용 어셈블리 정의 파일을 참조하십시오.

테스트용 어셈블리 정의 파일

어셈블리 정의 파일을 직접 편집할 수 있습니다. 다음의 레퍼런스를 추가해야 합니다.

속성 타입 설명
name String 파일 확장자가 없는 어셈블리 이름입니다.
references 문자열 배열 Editor 및 Runtime 어셈블리에 대한 레퍼런스입니다.어셈블리 정의 파일에는 테스트 유형에 따라 다른 레퍼런스가 필요합니다.
- Editor 테스트의 경우 패키지의 Editor 및 Runtime 어셈블리에 레퍼런스를 추가합니다.
- Runtime 테스트의 경우 패키지의 Runtime 어셈블리에만 레퍼런스를 추가합니다.
optionalUnityReferences 문자열 배열 이 Unity 레퍼런스 리스트에는 어셈블리를 테스트 어셈블리로 표시하기 위해 "TestAssemblies"가 포함되어야 합니다.이는 nunit.framework.dllUnityEngine.TestRunner.dll 라이브러리에 대한 레퍼런스를 어셈블리 정의에 추가합니다.
includePlatforms 문자열 배열 Editor 테스트의 경우 이 플랫폼 리스트는 "Editor" 플랫폼을 포함해야 합니다.

: 인스펙터에서 어셈블리 정의 파일을 편집할 수도 있습니다. 자세한 내용은 어셈블리 정의를 참조하십시오.

에디터 파일 예시

에디터 테스트 .asmdef 파일은 다음과 같이 표시됩니다.

{
  "name": "MyCompany.MyPackage.Editor.Tests",
  "references": [
    "MyPackage.Editor",
    "MyPackage"
  ],
  "optionalUnityReferences": [
    "TestAssemblies"
  ],
  "includePlatforms": [
    "Editor"
  ],
  "excludePlatforms": []
}

런타임 파일 예시

런타임 테스트 .asmdef 파일은 다음과 같이 표시됩니다.

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

패키지용 테스트 활성화

내장된 패키지의 경우에는 내장된 패키지가 개발 중이므로 테스트를 명시적으로 활성화할 필요가 없습니다.

하지만 다른 종속성 타입의 경우에는 testables 속성을 프로젝트 매니페스트에 추가하고 실행할 테스트가 있는 패키지의 이름을 추가해야 합니다. 여기에는 프로젝트의 직접 및 간접 종속성이 포함됩니다. 예를 들어 다음과 같습니다.

{
  "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 패키지에 com.unity.some-packagecom.unity.other-package 패키지에 대한 테스트를 추가합니다.

참고:테스트 프레임워크가 testables 속성에 대한 변경 사항을 즉시 식별하지 못할 때도 있기 때문에 패키지를 다시 임포트해야 할 수 있습니다.

패키지 레이아웃
패키지용 샘플 생성