Pack 명령

pack 명령은 레이아웃을 터치 적응 번들(takx)로 패키징하는 데 사용됩니다. 이 번들은 serve 명령을 통해 로컬 테스트에 사용할 수 있거나, XBOX Game Streaming을 통해 사용자에게 제공되도록 Microsoft 계정 담당자가 제출할 수 있습니다. 다음 표는 pack 명령과 함께 사용할 수 있는 다양한 옵션을 보여줍니다.

옵션	설명
`--layout-path <layout-path>`	번들에 포함할 루트 레이아웃 디렉터리 경로. 이 매개 변수는 필수입니다.
`--out` `--output-path <output-path>`	패키지된 터치 적응 번들의 출력 파일을 지정합니다. 일반적으로 .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.

참고 항목

Touch Adaptation Kit 명령줄 도구(tak.exe)

GDK and Game Engines Integration

Steam porting guide

Game Principles

Core Features

Console Features

예제

참고 항목

​예제

​참고 항목

예제

참고 항목