Skip to main content
이 문서에서는 TAK 편집기를 설정하기 위해 따라야 할 단계를 제공합니다. Visual Studio Code를 이미 설치하고 최신 TAK CLI를 다운로드했으며 TAK 편집기 확장을 설치했다고 가정합니다. 그렇게 하지 않았다면 자세한 내용은 개요 페이지를 참조하세요. 상위 수준에서 설정 프로세스에는 다음 단계가 포함됩니다.
  1. 확장에서 TAK CLI 경로를 설정합니다.
  2. Visual Studio Code에서 폴더 또는 워크스페이스를 엽니다.
    • 여기서 번들이 생성되고 편집됩니다.
이 확장의 대부분의 기능은 VS Code 명령 팔레트에서 실행되는 명령을 통해 액세스할 수 있습니다. 명령 팔레트는 Windows에서 Ctrl+Shift+P, macOS에서 Cmd+Shift+P를 눌러 액세스할 수 있습니다. 이 인터페이스에 익숙해지는 것이 권장되며, 이 가이드 전체에서 자주 사용됩니다.

TAK CLI 경로 설정

시스템에 TAK CLI가 다운로드되면 확장 설정에서 경로를 설정해야 합니다. 확장은 백그라운드에서 TAK CLI를 실행하여 번들 생성과 같은 다양한 작업을 수행합니다. 이는 VS Code에서 명령을 실행하거나 VS Code 사용자 설정에서 경로를 수동으로 설정하여 수행할 수 있습니다(설정 ID: TAK.editor.commandLineTool.path). 명령을 통해 경로를 설정하려면:
  1. 명령 팔레트를 엽니다(Windows에서 Ctrl+Shift+P 또는 macOS에서 Cmd+Shift+P).
  2. “Set TAK CLI”를 검색하고 “Touch Adaptation Kit: Set TAK Command Line Tool (TAK CLI) Path” 명령을 선택합니다. 명령 팔레트에서 Set TAK CLI 명령 선택의 스크린샷
  3. 파일 선택기가 열립니다. TAK CLI가 다운로드된 위치로 이동하고 실행 파일(Windows에서 tak.exe, macOS에서 tak)을 선택합니다. TAK CLI 실행 파일을 선택하는 파일 선택기의 스크린샷

폴더 또는 워크스페이스 열기

번들에서 작업하려면 Visual Studio Code에서 폴더 또는 워크스페이스를 열어야 합니다. 게임의 번들이 포함될 부모 디렉터리로 생각하세요. 폴더를 열려면 창의 왼쪽 상단에 있는 “File” 메뉴를 클릭하고 “Open Folder”를 선택합니다. 번들을 만들려는 위치(또는 번들이 포함된 기존 폴더)로 이동하고 “Select Folder”를 클릭합니다. 워크스페이스를 열려면 “File”을 클릭한 다음 “Open Workspace from File”을 선택합니다. 이를 위해서는 시스템에 기존 워크스페이스 파일(확장자가 .code-workspace인)이 있어야 한다는 점에 유의하세요. 워크스페이스 파일이 없는 경우 “File” 메뉴에서 “Add Folder to Workspace…”를 선택하고 원하는 폴더를 추가하여 하나를 만들 수 있습니다. 그런 다음 “File”을 클릭하고 “Save Workspace As…”를 선택하여 워크스페이스를 저장할 수 있습니다.

문제 해결

상태 표시줄 항목(“TAK Editor” 레이블 포함)이 창의 왼쪽 하단 모서리에 나타나 확장의 상태를 표시합니다. 이를 통해 TAK CLI 경로가 올바르게 설정되어 있고 확장이 CLI와 통신할 수 있는지 신속하게 확인할 수 있습니다. 모든 설정이 올바르면 상태 표시줄 항목은 체크 표시와 함께 워크스페이스에서 발견된 터치 적응 번들 수(있는 경우)를 표시합니다. OK 상태를 나타내는 상태 표시줄 항목의 스크린샷 상태 표시줄 항목이 오류를 표시하는 경우, 마우스를 위에 가져가서 오류에 대한 자세한 내용을 볼 수 있습니다. 이는 일반적으로 창의 오른쪽 하단 모서리에 자세한 정보와 함께 나타나는 알림을 동반합니다. 일반적인 문제는 다음과 같습니다.

TAK CLI 경로가 설정되지 않음

TAK CLI 경로가 설정되지 않았음을 나타내는 상태 표시줄 항목의 스크린샷 이는 CLI 경로가 확장 설정에 설정되지 않았을 때 발생합니다. 실제로 확장이 처음 설치되면 이것이 기본 상태입니다. 이 문제를 해결하려면 이전 섹션의 단계에 따라 경로를 설정하세요. 알림에서 “Set TAK CLI” 버튼을 클릭하거나 상태 표시줄 항목을 클릭하고 “Set TAK Command Line Tool” 옵션을 선택하여 경로를 설정할 수도 있습니다.

TAK CLI 경로가 존재하지 않음

TAK CLI 경로가 존재하지 않음을 나타내는 상태 표시줄 항목의 스크린샷 이는 제공된 경로가 존재하지 않을 때 발생합니다. CLI가 처음 설정된 위치에서 이동되거나 삭제된 경우 또는 설정에서 수동으로 입력되었는데 오타가 있는 경우 발생할 수 있습니다. 이 문제를 해결하려면 이전 섹션의 단계에 따라 경로를 다시 할당하세요.

TAK CLI 실행 불가능

TAK CLI가 실행 불가능함을 나타내는 상태 표시줄 항목의 스크린샷 이는 제공된 경로가 실행 파일이 아닐 때 발생합니다. 파일 선택기에서 잘못된 파일이 선택되었거나 파일이 실행 가능으로 표시되지 않은 경우(예: macOS에서 실행 권한이 없음) 발생할 수 있습니다. 이 문제를 해결하려면 경로를 다시 할당하세요. macOS: 경로가 올바르게 설정되었지만 CLI가 실행 가능으로 표시되지 않은 경우 파일에 실행 권한을 할당해야 합니다. 확장이 변경 사항을 인식하려면 VS Code를 다시 시작해야 할 수 있습니다.

TAK CLI 버전을 확인할 수 없음

TAK CLI 버전을 확인할 수 없음을 나타내는 상태 표시줄 항목의 스크린샷 이는 확장이 CLI를 시작하고 버전을 확인할 수 없을 때 발생할 수 있으며, 이는 CLI 버전이 너무 오래되었거나 CLI로 잘못된 실행 파일이 선택되었기 때문일 수 있습니다. 이 문제를 해결하려면 최신 버전의 CLI가 다운로드되었는지 확인하고 경로를 다시 설정하세요.

TAK CLI 버전이 오래됨

TAK CLI 버전이 오래되었음을 나타내는 상태 표시줄 항목의 스크린샷 이는 확장이 CLI를 시작하고 버전을 확인할 수 있지만 버전이 오래된 경우 발생합니다. 확장이 최근에 업데이트되어 최신 버전의 TAK CLI가 필요한 경우 발생할 수 있습니다. 이 문제를 해결하려면 최신 버전의 CLI를 다운로드하고 경로를 다시 설정하세요.

다음 단계

[!div class=“nextstepaction”] 새 터치 적응 번들 만들기
마지막 수정일 2026년 8월 13일