ShaderLab의 PackageRequirements 블록 레퍼런스

서브셰이더 또는 패스에 대한 패키지 요구 사항을 지정하려면 PackageRequirements 블록을 사용합니다. ShaderLab은 서브셰이더 또는 패스당 하나의 PackageRequirements 블록을 지원하지만, 각 블록은 여러 패키지 요구 사항을 지정할 수 있습니다.

렌더 파이프라인 호환성

구문

참고: PackageRequirements 블록을 제공하는 경우, 이 블록은 서브셰이더나 패스의 여타 모든 선언 전에 이루어져야 합니다.

여러 가지 방법으로 패키지 요구 사항을 선언할 수 있습니다. 각각 다른 동작을 제공합니다. 주요 차이점:

• “<package name>”: 서브셰이더나 패스가 모든 버전의 패키지와 작동하도록 지정합니다.
• “<package name>”: “<version restrictions>”: 서브셰이더나 패스가 패키지 버전의 하위 세트와만 작동하도록 지정합니다.
• “<package name>”: “unity=<version restrictions>”: 서브셰이더나 패스가 Unity 버전의 하위 세트와만 작동하며, 특정한 이름의 패키지를 요구하도록 지정합니다.
• “unity”:“<version restrictions>”: 서브셰이더나 패스가 Unity 버전의 하위 세트와만 작동하도록 지정합니다.

버전 구문

ShaderLab의 패키지 요구 사항에서 버전은 major.minor 또는 major.minor.patch 형식을 사용합니다. major.minor만 사용하는 경우 Unity는 patch에 0을 사용합니다. 패키지 버전에는 -preview가 -preview.0과 동등한 -preview 또는 -preview.n 포스트픽스도 포함할 수 있습니다. 미리보기 버전은 미리보기가 아닌 버전보다 먼저 제공되므로 1.2.3-preview.4는 1.2.2 이후, 1.2.3 이전에 제공됩니다.

여러 가지 방법으로 버전 범위를 지정할 수 있습니다. 각각 다른 동작을 제공합니다. 주요 차이점:

• <version>: 입력한 버전과 그 이후의 모든 버전이 포함됩니다. 예를 들어, 1.2.3은 1.2.3으로 시작하는 모든 버전을 포함합니다.
• [<version>]: 해당하는 정확한 버전을 지정합니다. 예를 들어, [1.2.3]에는 버전 1.2.3만 포함됩니다.
• [<version1>,<version2>]: <version1>과 <version2> 사이의 범위를 지정합니다. 대괄호와 둥근 대괄호를 사용하면 범위가 각각 버전에 포함되거나 제외됩니다. 열린 괄호는 <version1>에 영향을 주고 닫는 괄호는 <version2>에 영향을 줍니다. 예: [1.2.3,2.3.4)에는 1.2.3에서 2.3.3까지의 모든 버전이 포함됩니다.

단일 패키지에 대한 버전 범위를 지정할 수도 있습니다. 개별 범위에서 버전 범위 세트를 생성하려면 세미콜론을 구분자로 사용합니다. 예를 들어 [2.0,3.4.5];[3.7];4.0에는 버전 2.0.0–3.4.5, 버전 3.7.0, 버전 4.0.0 이상이 포함됩니다.

패키지의 버전을 설정할 때는 다음에 유의하십시오.

• 버전, 버전 범위와 버전 범위 세트에 추가 글자를 포함해서는 안 됩니다.
• 버전 범위는 비워둘 수 없습니다.
• 버전 범위 세트는 교차해서는 안 됩니다.
• 패키지 요구 사항은 공백을 구분합니다.

구문이 위의 내용을 준수하지 않으면 버전 제한이 유효하지 않습니다. 잘못된 패키지 요구 사항에 대한 자세한 내용은 오류 확인을 참조하십시오.

추가 리소스

• 패키지가 필요한 셰이더 설정
• 문제 해결 패키지 요구 사항 정의