기술 자료

Unity 엔진

Unity 엔진

어셈블리 에셋 생성

다양한 종류의 어셈블리 에셋을 생성하여 어셈블리를 커스터마이즈합니다.
읽는 시간 3분최근 업데이트: 10일 전

다음 두 가지 특수 에셋을 사용하여 어셈블리를 생성하고 정의할 수 있습니다.
  • 어셈블리 정의(
    .asmdef
    ) 에셋은 스크립트가 포함된 폴더의 루트에 배치되어 새 어셈블리를 정의합니다.
  • 어셈블리 정의 레퍼런스(
    .asmref
    ) 에셋은 스크립트가 포함된 폴더의 루트에 배치되어 해당 스크립트를 기존 어셈블리에 포함합니다.

어셈블리 정의 만들기

어셈블리 정의를 생성하려면:
  1. 프로젝트(Project) 창에서 어셈블리에 포함할 스크립트가 포함된 폴더를 찾습니다.
  2. 폴더(메뉴: Assets > Create > Skripting > Assembly Definition을 선택합니다.
  3. 에셋에 이름을 할당합니다. 기본적으로 어셈블리 파일은 에셋에 할당한 이름을 사용하지만,
    인스펙터

    ?

    창에서 이름을 변경할 수 있습니다.
Unity 프로젝트의 스크립트를 다시 컴파일하여 새 어셈블리를 생성합니다. 그런 다음 새 어셈블리 정의의 프로퍼티를 편집할 수 있습니다.
새로운 어셈블리는 어셈블리 정의와 동일한 폴더에 있는 모든 스크립트와 자체 어셈블리 정의 또는 레퍼런스 파일이 없는 하위 폴더에 있는 스크립트를 포함합니다. Unity 해당하는 경우 이전 어셈블리에서 스크립트를 제거합니다.

어셈블리 정의 레퍼런스 생성

어셈블리 정의 레퍼런스를 생성하려면:
  1. 프로젝트(Project) 창에서 참조된 어셈블리에 포함할 스크립트가 포함된 폴더를 찾습니다.
  2. 폴더(메뉴: Assets > Create > Skripting > Assembly Definition Reference)를 선택합니다.
  3. 에셋에 이름을 할당합니다.
    Unity 프로젝트의 스크립트를 다시 컴파일하여 새 어셈블리를 생성합니다. 완료되면 새 어셈블리 정의 레퍼런스의 프로퍼티를 편집할 수 있습니다.
  4. 새 어셈블리 정의 레퍼런스 에셋을 선택하여 해당 프로퍼티를 인스펙터에서 확인합니다.
  5. 타겟 어셈블리 정의 에셋을 참조하도록 Assembly Definition 프로퍼티를 설정합니다.
  6. Apply를 클릭합니다.
이제 참조된 어셈블리는 어셈블리 정의 레퍼런스와 동일한 폴더에 있는 모든 스크립트와 자체 어셈블리 정의 또는 레퍼런스 파일이 없는 하위 폴더에 있는 스크립트를 포함합니다. Unity 해당하는 경우 이전 어셈블리에서 스크립트를 제거합니다.

플랫폼별 어셈블리 생성

특정 플랫폼용 어셈블리를 생성하려면 다음 단계를 따르십시오.
  1. 어셈블리 정의를 생성합니다.
  2. 새 어셈블리 정의를 선택하여 해당 속성을 인스펙터에서 확인합니다.
  3. Platforms 섹션에서 Any Platform 옵션을 선택하고 Any Platform을 제외하거나 선택 해제할 특정 플랫폼을 선택하고 포함할 특정 플랫폼을 선택합니다.
  4. Apply를 클릭합니다.
타겟 플랫폼용으로 프로젝트를 빌드할 때 어셈블리가 이 설정에 따라 포함되거나 제외됩니다.

에디터 코드용 어셈블리 생성

에디터 어셈블리를 사용하면
Editor
라는 이름의 최상위 폴더가 아니라 프로젝트의 모든 곳에 에디터 스크립트를 넣을 수 있습니다.
프로젝트에 에디터 코드가 포함된 어셈블리를 생성하려면 다음 단계를 따르십시오.
  1. 에디터 스크립트가 포함된 폴더에 플랫폼별 어셈블리를 생성합니다.
  2. 에디터 플랫폼만 포함합니다.
  3. 에디터 스크립트가 포함된 추가 폴더가 있는 경우 해당 폴더에 어셈블리 정의 레퍼런스 에셋을 생성하고 이 어셈블리 정의를 참조하도록 설정합니다.

테스트 어셈블리 생성

테스트 어셈블리는 Unity 테스트를 포함할 것으로 예상하는 어셈블리입니다. 테스트를 테스트 어셈블리에 넣으면 다음과 같은 이점이 있습니다.
  • 테스트 코드를 사용자에게 전송할 애플리케이션 코드와는 별도로 유지하므로 필요한 경우에만 테스트 코드를 컴파일할 수 있습니다.
  • 테스트 어셈블리의 모든 테스트는 자동으로 Test Framework 패키지에 표시되며, 이를 통해 Test Runner 창에서 실행할 수 있습니다.
Unity는 nunit.framework.dll에 대한 어셈블리 레퍼런스와 UnityEngine.TestRunner 및 UnityEditor.TestRunner에 대한 어셈블리 정의 레퍼런스가 있는 경우 모든 어셈블리를 테스트 어셈블리로 자동으로 식별합니다.
Test Framework 패키지 설치 및 테스트 어셈블리 생성에 대한 지침은 Unity Test Framework 문서를 참조하십시오. 에디터 UI를 사용하여 관련 레퍼런스가 미리 정의된 어셈블리 정의 파일을 생성하거나, 인스펙터 창 을 통해 또는 JSON 파일을 직접 편집하여 레퍼런스를 수동으로 구성할 수 있습니다.
참고
테스트 어셈블리는 일반 빌드 파이프라인의 일부로 컴파일되지 않으므로 테스트 어셈블리에 배치된 코드는 표준 프로젝트 빌드에서 제외됩니다. Test Runner 창을 통해 플레이어에서 플레이 모드 테스트를 실행할 때만 테스트 어셈블리 코드가 플레이어 빌드에 포함됩니다. 프로젝트 빌드에 예기치 않게 컴파일되지 않는 프로덕션 코드가 있는 경우 두 번 확인하여 테스트 어셈블리에 없는지 확인합니다.

추가 리소스