TAK 편집기 설정
이 문서에서는 TAK 편집기를 설정하기 위해 따라야 하는 단계를 설명합니다. 이미 Visual Studio Code를 설치했고, 최신 TAK CLI를 다운로드했으며, TAK 편집기 확장을 설치했다고 가정합니다. 그렇지 않은 경우 개요 페이지에서 자세한 내용을 참고하세요.
개략적으로 설정 프로세스에는 다음 단계가 포함됩니다.
- 확장에서 TAK CLI 경로를 설정합니다.
- 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)에서 경로를 수동으로 설정함으로써 수행할 수 있습니다.
명령을 통해 경로를 설정하는 방법은 다음과 같습니다.
명령 팔레트(Windows에서
Ctrl+Shift+P또는 macOS에서Cmd+Shift+P)를 엽니다."TAK CLI 설정"을 검색하고 "터치 적응 키트: TAK 명령줄 도구(TAK CLI) 경로 설정" 명령을 선택합니다.
파일 선택기가 열립니다. TAK CLI가 다운로드된 위치로 이동하여 실행 가능한 파일 선택(Windows에서
tak.exe, macOS에서tak)을 선택합니다.
폴더 또는 작업 영역 열기
번들에서 작업하려면 Visual Studio Code에서 폴더 또는 작업 영역을 열어야 합니다. 작업 영역은 게임의 번들이 포함되는 부모 디렉터리로 여깁니다.
폴더를 열려면 창의 왼쪽 위 모서리에 있는 "파일" 메뉴를 클릭하고 "폴더 열기"를 선택합니다. 번들(또는 번들이 포함된 기존 폴더)을 만들려는 위치로 이동하고 "폴더 선택"을 클릭합니다.
작업 영역을 열려면 "파일"을 클릭한 다음 "파일에서 작업 영역 열기"를 선택합니다. 이렇게 하려면 기존 작업 영역 파일(.code-workspace 확장명 포함)이 컴퓨터에 있어야 합니다. 작업 영역 파일이 없는 경우 "파일" 메뉴에서 "작업 영역에 폴더 추가..."를 선택하고 원하는 폴더를 추가하여 만들 수 있습니다. 그런 다음 "파일"을 클릭하고 "작업 영역을 다른 이름으로 저장..."을 선택하여 작업 영역을 저장할 수 있습니다.
문제 해결
창의 왼쪽 아래 모서리에 상태 표시줄 항목("TAK 편집기" 레이블 포함)이 표시되어 확장의 상태를 나타냅니다. 이를 통해 TAK CLI 경로가 올바르게 설정되었는지, 확장이 CLI와 통신할 수 있는지를 빠르게 파악할 수 있습니다.
모든 항목이 올바르게 설정되면 상태 표시줄 항목에 확인 표시가 나타나고 작업 영역에 있는 터치 적응 번들(있는 경우)이 표시됩니다.
상태 표시줄 항목에 오류가 표시되면 마우스로 가리켜 오류에 대한 자세한 내용을 볼 수 있습니다. 일반적으로 이와 함께 창의 오른쪽 아래 모서리에 추가 정보가 포함된 알림이 표시됩니다.
일반적인 문제는 다음과 같습니다.
TAK CLI 경로가 설정되지 않음
이 문제는 확장 설정에서 CLI 경로가 설정되지 않았을 때 발생합니다. 실제로 확장이 처음 설치될 때는 기본 상태입니다. 이를 해결하려면 이전 섹션의 단계에 따라 경로를 설정합니다.
알림에서 "TAK CLI 설정" 단추를 클릭하거나 상태 표시줄 항목을 클릭한 다음 "TAK 명령줄 도구 설정" 옵션을 선택하여 경로를 설정할 수도 있습니다.
TAK CLI 경로가 없음
이 문제는 제공된 경로가 없을 때 발생합니다. 이 문제는 CLI가 처음 설정된 위치에서 이동 또는 삭제되거나 설정에 수동으로 입력되면서 오타가 생긴 경우에 발생할 수 있습니다. 이 문제를 해결하려면 이전 섹션의 단계에 따라 경로를 다시 할당합니다.
TAK CLI 실행 가능하지 않음
이 문제는 제공된 경로가 실행 가능한 파일이 아닌 경우에 발생합니다. 이 문제는 파일 선택기에서 잘못된 파일을 선택했거나 파일이 실행 가능한 파일로 표시되지 않은 경우(예: macOS에서 실행 권한 없음) 발생할 수 있습니다. 이 문제를 해결하려면 경로를 다시 할당합니다.
macOS: 경로가 올바르게 설정되었지만 CLI가 실행 가능한 파일로 표시되지 않은 경우 파일에 실행 권한이 할당되어야 합니다. 확장이 변경 사항을 인식할 수 있도록 VS Code를 다시 시작해야 할 수 있습니다.
TAK CLI 버전이 확인되지 않음
이 문제는 확장이 CLI를 시작할 수 없고 아마도 CLI 버전이 너무 오래되어 해당 버전을 확인할 수 없거나, 잘못된 실행 가능한 파일이 CLI로 선택되는 경우에 발생할 수 있습니다. 이 문제를 해결하려면 CLI의 최신 버전이 다운로드되었는지 확인하고 경로를 다시 설정합니다.
TAK CLI 버전이 오래됨
이 문제는 확장이 CLI 버전을 시작하고 확인할 수 있지만 버전이 최신이 아닌 경우에 발생합니다. 이 문제는 확장이 최근에 업데이트되었고 TAK CLI 최신 버전이 필요한 경우에 발생할 수 있습니다. 이 문제를 해결하려면 CLI의 최신 버전을 다운로드하고 경로를 다시 설정합니다.