기술 자료

Unity 엔진

Unity 엔진

어셈블리 포함 조건부

스크립팅 심볼을 사용하여 어셈블리를 컴파일에서 조건부로 포함하거나 제외합니다.
읽는 시간 3분최근 업데이트: 9일 전

프리 프로세서 심볼을 사용하여 어셈블리가 컴파일되고 애플리케이션의 빌드에 포함되는지 여부를 제어할 수 있습니다(에디터의 플레이 모드 포함). 어셈블리 정의 옵션의 Define Constraints 목록과 함께 어셈블리를 사용하기 위해 정의해야 하는 심볼을 지정할 수 있습니다.
  1. 어셈블리의 어셈블리 정의를 선택하여 해당 속성을
    인스펙터

    ?

    에서 확인합니다.
  2. 제약 정의 섹션에서 + 버튼을 클릭하여 제약 목록에 새 기호를 추가합니다.
  3. 심볼 이름을 입력합니다.
  4. Apply를 클릭합니다.
제약 정의에 사용할 수 있는 스크립팅 심볼에 대한 자세한 내용은 제약 정의를 참조하십시오.

Unity 및 프로젝트 패키지 버전을 기반으로 심볼 정의

프로젝트가 특정 버전의 Unity 또는 패키지를 사용하는지에 따라 어셈블리에 다른 코드를 컴파일해야 하는 경우 항목을 버전 정의 리스트에 추가할 수 있습니다. 이 목록에는 기호를 정의해야 하는 시기 규칙이 명시되어 있습니다. 버전 번호의 경우 특정 버전 또는 다양한 버전으로 평가되는 논리 표현식을 지정할 수 있습니다.
심볼을 조건부로 정의하려면:
  1. 어셈블리에 대한 어셈블리 정의 에셋을 선택하여 해당 속성을 인스펙터에서 확인합니다.
  2. 버전 정의 섹션에서 + 버튼을 클릭하여 목록에 항목을 추가합니다.
  3. 프로퍼티 설정:
    • 자원 경우: 이 기호를 정의하려면 Unity 또는 설치해야 하는 패키지 또는 모듈을 선택합니다.
    • 버전: 특정 버전 또는 다양한 버전으로 평가하는 표현식입니다. 구문 규칙에 대한 버전 정의 표현식을 참조하십시오.
    • 설정 정의: 버전 조건이 충족되는 시점을 정의하는 스크립팅 기호입니다.
    버전 표현식 결과는 표현식이 평가되는 버전을 보여 줍니다. 결과가 잘못된 값으로 표시되면 표현식 구문이 잘못됩니다.
  4. Apply를 클릭합니다.
어셈블리 정의에 정의된 심볼은 해당 정의를 위해 생성된 어셈블리의 스크립트에만 해당합니다.
참고
Version Defines 리스트를 사용하여 정의된 심볼을 **Define Constraints**로 사용할 수 있습니다. 즉, 특정 패키지의 특정 버전이 프로젝트에 설치된 경우에만 어셈블리를 사용하도록 지정할 수 있습니다.

버전 정의 표현식

표현식을 사용하여 정확한 버전 또는 다양한 버전을 지정할 수 있습니다.
버전 표현식은 수학적 간격 표기법을 사용합니다. 여기서 대괄호
[]
는 범위가 엔드포인트를 포함한다는 것을 나타내고 괄호
()
는 범위가 엔드포인트를 제외한다는 것을 나타냅니다.
다음 표는 구문을 나타냅니다.

표현식

에 평가

[1.3,3.4.1]
1.3.0 <= x <= 3.4.1
(1.3.0,3.4)
1.3.0 < x < 3.4.0
[1.1,3.4)
1.1.0 <= x < 3.4.0
(0.2.4,5.6.2-preview.2]
0.2.4 < x <= 5.6.2.-preview.2
[2.4.5]
x = 2.4.5
2.1.0-preview.7
x >= 2.1.0-preview.7
참고
표현식에 공백이 허용되지 않습니다. 와일드카드 문자는 지원되지 않습니다.

Unity 버전 관리 체계

Unity의 현재 버전과 어셈블리 정의를 지원하는 모든 버전은 세 부분인
MAJOR.MINOR.REVISION
(예:
6000.0.33f1
) 버전 지정자를 사용합니다.
  • MAJOR
    버전은 Unity
    2022.x.z
    및 이전 버전의 릴리스 연도 또는 Unity 6(
    6000.x.z
    ) 이후의 주요 기술 버전을 나타내는 4자리 값입니다.
  • MINOR
    버전은 타겟 릴리스 분기(예:
    1
    ,
    2
    ,
    3
    또는
    4
    )입니다.
  • REVISION
    지정자는 다음과 같은 형식을 가진 세 부분으로 구성됩니다.
    RRzNN
    :
    • RR
      는 1자리 또는 2자리 수정 번호입니다.
    • z
      는 릴리스 유형을 나타내는 문자입니다.
      • a
        = 알파 출시
      • b
        = 베타 출시
      • f
        = 일반 공개 공개
      • c
        = 중국 출시 버전(f와 동등)
      • p
        = 패치 출시
      • x
        = 실험적 출시
    • NN
      는 1자리 또는 2자리 증분 숫자입니다.
릴리스 타입 지정자는 다음과 같이 비교됩니다.
a < b < f = c < p < x
알파 릴리스는 베타 릴리스보다 앞선 것으로 간주되며 이는 노멀 (
f
) 또는 중국 (
c
) 릴리스보다 앞선 것으로 간주됩니다. 패치 릴리스는 항상 리비전 번호가 동일한 일반 릴리스 또는 중국 릴리스보다 늦고 실험적인 릴리스는 다른 릴리스 타입보다 늦습니다. 실험적인 릴리스에서는 끝에 증분 숫자를 사용하지 않습니다.
다음의 예제 표현식은 모든 6000.0 또는 6000.1 Unity 버전을 포함하지만 6000.2 이상 버전은 포함하지 않습니다.
[6000.0,6000.2)

패키지 및 모듈 버전 번호

패키지 및 모듈 버전 지정자는
MAJOR.MINOR.PATCH-LABEL
라는 시맨틱 버전 지정 형식을 따르는 네 부분으로 구성됩니다. 처음 세 부분은 항상 숫자이지만 레이블은 문자열입니다. 프리뷰에서 Unity 패키지는 문자열,
preview
또는
preview.n
, 즉
n > 0
를 사용합니다.
다음 예제 표현식은 3.2 버전과 6.1 버전(포함)의
MAJOR.MINOR
패키지의 모든 버전을 포함합니다.
[3.2,6.1]

추가 리소스