> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

이 문서를 사용하여 Touch Adaptation Kit(TAK)을 사용해 터치 컨트롤 레이아웃을 만들고 검증하세요.

## takxconfig.json 및 .takx 파일

tak.exe 명령줄 도구가 다루는 주요 파일 유형은 unpacked 번들 구성 파일(`takxconfig.json`) 또는 패키지된 번들(`.takx`) 파일입니다.
실행 중인 명령에 따라 이러한 파일 유형 중 하나는 항상 사용 가능하며 전체 터치 번들을 나타냅니다. 이전 버전과의 호환성 및 일부 이너 루프 시나리오를 더 쉽게 하기 위해 `--layout-path`와 같은 레거시 인수는 여전히 지원되며 `takxconfig.json`의 콘텐츠를 재정의합니다.

### 속성

`$schema` - *string*. 터치 번들 구성 파일용 JSON 스키마. 선택된 스키마 버전에 따라 `https://raw.githubusercontent.com/microsoft/xbox-game-streaming-tools/main/touch-adaptation-kit/schemas/takxconfig/v1/takxconfig.json`과 유사한 형태여야 합니다.

`version` - *string*. 번들의 4파트(예: 1.0.0.0) 버전 번호.

`versionName` - *string*, *optional*. 번들 버전에 대한 설명적 이름.

`layouts` - *object*. 번들의 layouts 옵션을 정의하는 객체. 그 안의 `path` 속성은 레이아웃이 위치한 상대 경로를 지정합니다.

`assets` - *object*, *optional*. 번들의 assets 옵션을 정의하는 객체. 그 안의 `path` 속성은 자산이 위치한 상대 경로를 지정합니다.

`context` - *object*, *optional*. 번들의 context 옵션을 정의하는 객체. 그 안의 `path` 속성은 컨텍스트 파일이 위치한 상대 경로를 지정합니다.

`languages` - *object*, *optional*. 번들의 languages 옵션을 정의하는 객체. 그 안의 `items` 속성은 번들이 지원하는 언어를 지정하는 배열입니다.

### 샘플

```json theme={null}
{
  "$schema": "https://raw.githubusercontent.com/microsoft/xbox-game-streaming-tools/main/touch-adaptation-kit/schemas/takxconfig/v1/takxconfig.json",
  "layouts": {
    "path": "./layouts"
  },
  "assets": {
    "path": "./assets"
  },
  "context": {
    "path": "./context.json"
  },
  "languages": [
    "en",
    "en-US"
  ],
  "version": "2.0.0.0"
}
```

`takxconfig.json` 파일을 사용한 전체 샘플은 [저희 GitHub](https://github.com/microsoft/xbox-game-streaming-tools/tree/main/touch-adaptation-kit/samples)를 참조하세요.

### 요구 사항

파일의 버전은 .json 파일의 `$schema` 속성으로 지정됩니다. 이는 사용할 수 있는 특정 속성 세트를 지정하고 일부 편집기에서 IntelliSense를 활성화합니다.

앞의 속성은 최신 지원 스키마 버전에 유효합니다. 이전 스키마 속성은 [저희 GitHub](https://github.com/microsoft/xbox-game-streaming-tools/tree/main/touch-adaptation-kit/schemas)를 참조하세요.

## 명령

XBOX Game Streaming을 사용하여 타이틀을 플레이할 때 터치 컨트롤이 의도한 대로 작동하는지 확인하려면 다음 표에 표시된 명령을 사용하세요.

| 명령                                                                                                                                    | 설명                                                             |
| ------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| [create](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-create-command)             | 터치 적응 번들의 소스 콘텐츠를 만들거나 기존 번들에 레이아웃을 추가합니다.                     |
| [convert](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-convert-command)           | 레거시 레이아웃 세트 파일을 서비스가 지원하는 최신 형식 표준에 맞는 레이아웃 파일로 변환합니다.         |
| [license](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-license-command)           | Touch Adaptation Kit 명령줄 도구의 최종 사용자 사용권 계약(EULA)을 표시하거나 수락합니다. |
| [notice](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-notice-command)             | 이 소프트웨어에 통합된 타사 자료에 대한 정보를 표시합니다.                              |
| [pack](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-pack-command)                 | 소스 콘텐츠 세트에서 터치 적응 번들을 빌드합니다.                                   |
| [serve](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command)               | 클라이언트 애플리케이션이 다운로드하여 사용할 수 있도록 터치 적응 번들을 제공합니다.                |
| [settings](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-settings-command)         | 애플리케이션 설정을 보고 지정합니다.                                           |
| [takx-version](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-takx-version-command) | 터치 적응 번들의 버전과 포함된 레이아웃의 최대 스키마 버전을 확인합니다.                      |
| [unpack](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-unpack-command)             | 기존 터치 적응 번들을 구성 요소 파일로 언팩합니다.                                  |
| [verify](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-verify-command)             | 터치 적응 번들의 내용이 유효한지 확인합니다.                                      |
| [version](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-version-command)           | Touch Adaptation Kit 명령줄 도구의 버전 정보를 표시합니다.                     |

## 옵션

모든 명령에 적절한 플래그를 적용하려면 다음 표의 정보를 사용하세요.

| 옵션                   | 설명                                                                                                                                              |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `-v`, `--verbosity`  | 명령의 출력 상세 수준을 설정합니다. 이러한 플래그에 대한 유효한 값은 `Critical`, `Debug`, `Error`, `Information`, `None`, `Trace`, `Warning`입니다. 기본 상세 수준은 `Information`입니다. |
| `--version`          | 버전 정보를 표시합니다.                                                                                                                                   |
| `--accept-license`   | 명령을 실행하기 전에 애플리케이션의 사용권 계약을 수락합니다. 자동화에 유용합니다.                                                                                                  |
| `--reset-appId`      | 시스템과 연결된 애플리케이션 ID를 재설정합니다.                                                                                                                     |
| `-?`, `-h`, `--help` | 도움말과 사용법 정보를 표시합니다.                                                                                                                             |

## 참고 항목

[터치 시작하기](/build/core-features/common/game-streaming/game-streaming-getting-started-with-touch)
[웹 콘텐츠 테스트 애플리케이션(CTA)](/build/core-features/common/game-streaming/game-streaming-web-content-test-application)
[TAK CLI 다운로드 방법](https://aka.ms/get-takcli)
