Pack 명령
pack 명령은 레이아웃을 터치 적응 번들(takx)에 패키지화할 때 사용합니다.
이 번들은 serve 명령을 통해 로컬 테스트에 사용하거나 Microsoft 계정 담당자가 Xbox 게임 스트리밍을 통해 사용자를 위해 제출할 수 있습니다.
다음 표에서는 pack 명령과 사용할 수 있는 다른 옵션을 보여줍니다.
| 옵션 | 설명 |
|---|---|
--layout-path <layout-path> |
번들에 포함할 루트 레이아웃 디렉터리의 경로입니다. 이 매개 변수는 필수입니다. |
--out--output-path <output-path> |
패키지된 Touch 적응 번들에 대한 출력 파일을 지정합니다. 일반적으로 .takx 파일입니다. 이 매개 변수는 필수입니다. |
--asset-path <asset-path> |
번들에 포함할 루트 자산 디렉터리의 경로입니다. 번들에 자산이 없는 경우 이 매개 변수는 필요하지 않습니다. |
--context file <context-file> |
번들에 포함할 컨텍스트 파일의 경로입니다. 번들에 컨텍스트가 없는 경우 이 매개 변수는 필요하지 않습니다. |
--default-layout <default-layout> |
기본 레이아웃의 이름입니다. 레이아웃 경로에 있는 파일 중 하나의 이름과 일치해야 합니다. |
--version <version> |
1.0.0.0과 같은 터치 적응 번들의 콘텐츠 버전. 타이틀을 위해 Microsoft에 제출된 각 터치 적응 번들에는 제출된 이전 터치 적응 번들보다 의미상 더 큰 버전 번호가 있어야 합니다. takx-version 명령은 기존 번들 버전을 검사하는 데 사용할 수 있습니다. 게임이 스트리밍되는 동안 사용 중인 터치 적응 번들의 버전 번호는 XGameStreamingGetTouchBundleVersion을 호출하여 얻을 수 있습니다. |
--version-name <version-name> |
"DLC 1"과 같은 터치 적응 번들의 콘텐츠 버전 이름입니다. 버전 번호와 달리 버전 이름은 선택 사항이며 형식에 대한 요구 사항이 없습니다. takx-version 명령은 기존 번들 버전을 검사하는 데 사용할 수 있습니다. 게임이 스트리밍되는 동안 사용 중인 터치 적응 번들의 버전 이름은 XGameStreamingGetTouchBundleVersion을 호출하여 얻을 수 있습니다. |
--no-asset-optimization |
효율적인 스토리지 및 통신을 위한 자산이 최적화되지 않도록 합니다. 설정된 경우 자산이 수정되지 않습니다. |
--no-verify |
생성된 터치 적응 번들이 유효하고 확인되지 않았는지 확인합니다. |
--language <language> |
제작된 번들에 포함할 언어의 IETF 언어 태그입니다. 이 매개 변수를 여러 번 지정하면 제공된 모든 언어가 포함됩니다. 매개 변수를 지정하지 않으면 원본 디렉터리에 있는 모든 레이아웃과 자산이 번들에 포함됩니다. |
예제
다음 코드 예제를 사용하여 터치 적응 번들에 레이아웃을 패키징합니다.
레이아웃 경로의 모든 레이아웃을 1.0.0.0 버전의 단일 터치 적응 번들로 묶습니다.
C:\>tak pack --layout-path C:\tmp\layouts --out C:\tmp\MyGameLayouts.takx --version 1.0.0.0
Building touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'
Verifying touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'.
Verification complete. 0 error(s) and 0 warning(s) found.
레이아웃 경로의 모든 레이아웃을 단일 터치 적응 번들로 묶습니다. 게임에서 특정 레이아웃을 요청하기 전에 사용자에게 표시될 레이아웃 introLayout을(를) 설정합니다.
C:\>tak pack --layout-path C:\tmp\layouts --out C:\tmp\MyGameLayouts.takx --default-layout introLayout
Building touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'
Verifying touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'.
Verification complete. 0 error(s) and 0 warning(s) found.
자산 최적화 없이 레이아웃 경로의 en-us 레이아웃만 단일 터치 적응 번들로 압축합니다.
C:\>tak pack --layout-path C:\tmp\layouts --out C:\tmp\MyGameLayouts.takx --language en-us --no-asset-optimization
Building touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'
Verifying touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'.
Verification complete. 0 error(s) and 0 warning(s) found.
레이아웃 경로의 en-us 및 es-us 레이아웃만 단일 터치 적응 번들로 압축합니다.
C:\>tak pack --layout-path C:\tmp\layouts --out C:\tmp\MyGameLayouts.takx --language en-us --language es-us
Building touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'
Verifying touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'.
Verification complete. 0 error(s) and 0 warning(s) found.