Unity 스크립팅 API 안내서
이 문서에서는 Unity의 스크립팅 API에 대한 기본 개념과 사용법을 한국어로 쉽게 설명합니다. 특히 어셈블리 정의와 관련된 내용을 다룹니다.
어셈블리 정의란?
어셈블리 정의는 Unity 프로젝트 내의 스크립트 구성을 관리하는 데 도움을 주는 자산(asset)입니다. 특정 폴더 내에서 스크립트가 서로 어떻게 연결되고 작동하는지를 정의하는 역할을 합니다.
어셈블리 정의 레퍼런스
어셈블리 정의 레퍼런스는 어셈블리 정의에 대한 참조를 설정합니다. 이 에셋을 폴더에 생성한 후, 참조하는 어셈블리 정의가 위치한 폴더에 스크립트를 포함시키면 됩니다. 새로운 어셈블리를 생성할 필요는 없습니다.
- 자체 어셈블리 정의가 없는 경우: 자식 폴더의 스크립트도 자동으로 포함됩니다.
프로퍼티 설명
| 프로퍼티 | 설명 |
|---|---|
| Use GUID | Unity가 어셈블리 정의 레퍼런스를 직렬화하는 방식을 제어합니다. 이 옵션을 활성화하면 GUID를 사용하여 레퍼런스를 저장합니다. |
| Assembly Definition | 참조된 어셈블리 정의 에셋을 나타냅니다. |
| AssemblyDefinitionReferenceImporter | 어셈블리 정의 프로퍼티와 관련이 있는 정보입니다. |
| Assembly Definition File Format | 어셈블리 정의 파일의 포맷에 대한 정보입니다. |
활용 예제
예제 1: 어셈블리 정의 생성
- 프로젝트 폴더 내에서 오른쪽 클릭합니다.
Create메뉴에서Assembly Definition을 선택합니다.- 새로 생성된
Assembly Definition파일에 이름을 지정합니다.
예제 2: 어셈블리 정의 참조 설정
- 어셈블리 정의 레퍼런스 파일을 생성할 폴더로 이동합니다.
- 해당 폴더에서 오른쪽 클릭하고
Create를 선택한 후Assembly Definition Reference를 선택합니다. - 아래의 속성에서 참조할 어셈블리 정의를 선택합니다.
예제 3: GUID 사용하기
Use GUID옵션을 활성화하여 어셈블리 정의의 이름이 변경되어도 기존 참조가 유효하도록 합니다. 이를 통해 프로젝트 관리가 더 수월해집니다.
이렇게 어셈블리 정의와 어셈블리 정의 레퍼런스를 활용하면 Unity 프로젝트에서 스크립트를 효과적으로 관리하고, 팀원 간의 협업을 원활하게 할 수 있습니다.