기술 자료

Unity 엔진

Unity 엔진

명명 스크립트

컴파일러가 클래스를 식별하는 데 도움이 되는 스크립트의 이름을 지정합니다. 네임스페이스 사용하여 논리적으로 스크립트를 구성하고 클래스명 충돌을 방지합니다.
읽는 시간 3분최근 업데이트: 9일 전

스크립트 파일의 이름과 그 안에 선언된 클래스를 신중하게 선택해야 합니다. 적절한 파일 이름을 사용하고 네임스페이스 아래에 클래스를 정리하면 컴파일러가 오류 없이 클래스를 식별할 수 있습니다.

스크립트 파일 이름

스크립트를 생성할 때 입력하는 파일 이름은 그 안에 정의된 클래스의 이름에도 사용됩니다. 스크립트의 파일 이름을 그 안에 정의된 클래스의 이름과 일치시키는 것이 좋습니다.
빌트인 Unity 타입
MonoBehaviour
및
ScriptableObject
에서 파생된 스크립트의 경우 파일 이름이 일치하지 않더라도 Unity는 스크립트에 정의된 클래스 타입을 확인할 수 있지만 다음과 같은 제한 사항이 있습니다.
  • 스크립트에 여러 클래스가 정의된 경우 Unity 파일과 동일한 이름의 클래스를 선택합니다.
  • C#
    partial
    키워드를 사용하여 여러 파일에 걸쳐 하나의 MonoBehaviour 파생 클래스를 정의하는 경우
    partial
    클래스와 동일한 이름의 파일만 컴포넌트로 사용할 수 있습니다.
참고
클래스명을 특정 파일에 명확하게 매칭할 수 없는 경우 Unity 경고를 표시합니다.

클래스명 및 네임스페이스

명명 충돌은 프로젝트의 다른 부분에서 동일한 이름의 여러 클래스를 선언할 때 발생합니다. 명명 충돌의 가능성은 프로젝트의 규모와 기여자 수에 따라 증가합니다. 예를 들어 한 개발자는 메인 플레이어 캐릭터를 제어하는 코드를 작성하는 반면, 다른 개발자는 적을 위한 동등한 코드를 작성할 수 있습니다. 두 개발자가 메인 클래스
Controller
를 호출하도록 선택하면 컴파일러는 코드에서 어떤 클래스의
Controller
사용을 참조할 수 없게 됩니다.
클래스명 충돌을 방지하기 위해 C# 프로그래밍에서는 네임스페이스 클래스를 정리하는 것이 좋습니다. 네임스페이스는 클래스의 컬렉션이며, 클래스 이름에 접두사가 붙은 네임스페이스는 클래스를 참조하는 완전하고 명확한 방법을 제공합니다. 자세한 내용은 Microsoft의 네임스페이스 기술 자료를 참고하십시오.
아래 예시에서 클래스
Controller1
및
Controller2
는
Enemy
라는 네임스페이스의 구성원입니다.
네임스페이스 적 { public class Controller1 : MonoBehaviour { ... } public class Controller2 : MonoBehaviour { ... }}
전체 이름을 사용하여 이러한 클래스를 코드에서 명확하게 참조할 수 있습니다. 전체 이름은 네임스페이스와 클래스명, 이 경우 각각
Enemy.Controller1
및
Enemy.Controller2
입니다. 기존 클래스 선언 주변에 네임스페이스 선언을 추가하여 모든 클래스의 이름을 개별적으로 변경할 필요가 없습니다. 클래스가 다른 소스 파일에 있더라도 클래스가 발생하는 모든 위치에 네임스페이스 선언을 추가할 수 있습니다.
파일 상단에
using
지시문을 추가하여 네임스페이스 접두사를 반복적으로 입력하지 않아도 됩니다.
using Enemy;
이렇게 하면 컴파일러가 이 파일에서
Controller1
및
Controller2
에 대한 레퍼런스를 각각
Enemy.Controller1
및
Enemy.Controller2
로 확인합니다. 스크립트에서 다른 네임스페이스(예:
Player
)에서 동일한 이름의 클래스를 참조해야 하는 경우 네임스페이스 접두사를 지정해야 합니다. 충돌하는 클래스명이 포함된 네임스페이스 두 개가 같은 파일에 있는
using
지시문과 함께 임포트되면 컴파일러가 오류를 보고합니다.

여러 네임스페이스 대한 제한

Unity 네임스페이스 MonoBehaviour 또는 ScriptableObject 클래스와 관련된 특정 제한이 있습니다. 파일에 MonoBehaviour 또는 ScriptableObject 클래스에 대한 정의가 포함된 경우 해당 파일 내에서 여러 네임스페이스 사용할 수 없습니다.
Unity 콘솔에 다음과 같은 경고를 표시합니다.
MyClass 클래스는 동일한 파일의 여러 네임스페이스 존재할 수 없으며, 하나는 프리 프로세서 지시문으로 제외됩니다. 이 경우 파일을 별도의 파일로 이동하세요.
하나의 네임스페이스에 MonoBehaviour를 정의하는 파일과 같은 파일 내 다른 네임스페이스에 있는 다른 클래스가 있는 경우 Unity는 MonoBehaviour 클래스를 인식하지 못하고 게임 오브젝트에서 사용할 수 없습니다. 이 제한은 Unity 2020.1에서 임포트 및 컴파일 속도를 높이기 위해 도입되었기 때문에 이 제한이 도입되기 전에 작성된 일부 구형 에셋 스토어 패키지는 그 결과 잘못 작동할 수 있습니다. 이 문제와 관련된 문제를 수정하려면 각 네임스페이스의 클래스에 대한 코드를 분리하여 파일을 분리하십시오.

추가 리소스