텍스트 편집기

텍스트 편집기는 기기 측 스크립트 프로젝트와 일반 텍스트 파일을 편집하는 데 사용합니다. 개발 프로젝트를 열면 테스트 기기에 연결하여 스크립트를 직접 실행, 중지, 디버그하고 암호화 결과물 또는 중앙 제어 패키지를 만들 수도 있습니다.

텍스트 편집기 열기

자주 사용하는 진입점은 다음과 같습니다.

파일 관리자에서 텍스트 파일을 두 번 클릭하거나 파일을 마우스 오른쪽 버튼으로 클릭한 뒤 텍스트 편집을 선택합니다.
기기 목록에서 기기를 마우스 오른쪽 버튼으로 클릭하고 기기 파일 찾아보기를 선택한 다음 기기의 텍스트 파일을 엽니다.
개발 디렉터리에서 프로젝트 폴더를 마우스 오른쪽 버튼으로 클릭하고 프로젝트 열기를 선택한 다음 프로젝트 트리에서 파일을 클릭합니다.
기기 목록에서 기기를 마우스 오른쪽 버튼으로 클릭하여 임시 Lua 파일을 만들고 짧은 스크립트를 빠르게 테스트합니다.

자주 사용하는 편집 작업

저장을 클릭하여 현재 변경 사항을 파일에 기록합니다.
다시 불러오기를 클릭하여 원래 위치에서 파일 내용을 다시 읽습니다.
탭을 마우스 오른쪽 버튼으로 클릭하여 파일 관리자에서 보기, 이름 변경 또는 경로 복사를 실행할 수 있습니다.
아래쪽 상태 표시줄에서 행과 열, 들여쓰기, 인코딩, 줄 끝과 파일 유형을 확인할 수 있습니다. 잘 모르겠다면 기본값을 유지하면 됩니다.
미니맵 버튼을 클릭하여 오른쪽 코드 미니맵을 표시하거나 숨길 수 있습니다.

파일을 연 뒤 다른 작업에서 파일이 수정되었다면 저장할 때 덮어쓸지 확인합니다. 저장하지 않은 탭을 다시 불러오거나 닫을 때도 현재 변경 사항이 사라질 수 있다는 메시지가 표시됩니다.

개발 테스트 기기 설정

온라인 실행과 디버그를 시작하기 전에 개발 테스트 기기를 설정해야 합니다. 기기는 이미 가져온 상태이고 온라인이어야 하며 XXTouch에서 정상적으로 접근할 수 있어야 합니다. 오프라인 기기에서는 파일을 찾아보거나 실행 또는 디버그할 수 없습니다.

자주 사용하는 진입점은 다음과 같습니다.

기기 목록에서 대상 기기를 마우스 오른쪽 버튼으로 클릭하고 개발 테스트 기기로 설정을 선택합니다.
텍스트 편집기 왼쪽 위에서 기기 버튼을 클릭하여 테스트 기기 선택을 열고 대상 기기를 선택합니다.

설정이 끝나면 텍스트 편집기에 현재 테스트 기기가 표시되고 기기 파일 찾아보기, 샘플 작업대 열기, 실행, 중지, 디버그 등의 작업을 사용할 수 있습니다.

기기를 바꾸려면 다른 기기를 다시 선택하면 됩니다. 온라인 연결이 더 이상 필요하지 않다면 같은 위치에서 테스트 연결 해제를 클릭할 수 있습니다.

온라인 실행

개발 프로젝트 또는 프로젝트 내부 파일을 연 뒤 실행을 클릭합니다. 텍스트 편집기는 저장해야 할 내용을 먼저 저장한 다음 현재 프로젝트를 테스트 기기로 보내 실행합니다. 실행 중에는 아래쪽 로그 영역에서 출력을 볼 수 있습니다.

일반적으로 개발 프로젝트의 스크립트 파일 또는 직접 실행할 수 있는 .lua 파일을 실행할 수 있습니다. 일반 텍스트 파일, 인식되지 않는 프로젝트 또는 진입점이 없는 프로젝트에서는 현재 파일은 실행할 수 없습니다라는 메시지가 표시됩니다.

자주 표시되는 상태는 다음과 같습니다.

실행 중: 스크립트가 시작되었거나 기기 실행을 기다리고 있습니다.
중지 중: 기기로 중지 요청을 보내고 있습니다.
아직 로그가 없습니다: 로그 연결은 정상이지만 기기에서 아직 출력이 없습니다.
개발 기기를 선택하세요: 테스트 기기를 아직 설정하지 않았습니다.
현재 파일은 실행할 수 없습니다: 현재 탭이 실행 가능한 프로젝트에 속하지 않거나 인식 가능한 진입점이 없습니다.
저장하지 못해 실행을 중지했습니다: 현재 파일이 정상적으로 저장되지 않아 실행을 계속하지 않습니다.

스크립트를 종료하려면 중지를 클릭합니다.

온라인 디버그

디버그를 클릭하면 디버그 모드로 프로젝트를 시작합니다. 실행 중 변수, 호출 스택과 분기 문제를 찾을 때 적합합니다.

자주 사용하는 작업은 다음과 같습니다.

편집기 왼쪽의 줄 번호 영역에서 중단점을 설정하거나 해제합니다.
계속, 프로시저 단위 실행, 한 단계씩 코드 실행, 프로시저 나가기로 스크립트 실행을 제어합니다.
호출 스택에서 스크립트가 어느 함수 계층에서 멈췄는지 확인합니다. 항목을 클릭하면 편집기가 해당 위치로 이동합니다.
변수 패널에서 현재 중지 위치에서 볼 수 있는 변수를 확인합니다. 마우스 오른쪽 버튼 메뉴에서 변수 값을 복사하거나 수정할 수 있습니다.
디버그 콘솔에 한 줄짜리 Lua 코드를 입력합니다. 스크립트가 일시 정지된 동안 식을 실행할 수 있습니다.
연결 해제를 클릭하여 현재 디버그 연결을 종료합니다.

디버그 패널에는 디버깅 중이 아님, 실행 중, 일시 중지됨, 디버그 세션이 종료되었습니다 등의 상태가 표시됩니다. 디버그를 지원하는 프로젝트와 기기에서만 시작할 수 있습니다. 현재 프로젝트를 디버그할 수 없다는 메시지가 표시되면 먼저 일반 실행으로 프로젝트 진입점이 올바른지 확인하세요.

프로젝트 설정

프로젝트를 열면 텍스트 편집기 제목 표시줄에 프로젝트 설정 진입점이 표시됩니다. 여기에서 프로젝트 이름, 프로젝트 ID, 버전, 설명, 제외 경로, 공용 라이브러리와 샘플 작업대 설정을 관리할 수 있습니다.

프로젝트 설정을 수정한 뒤 저장을 클릭합니다. 스크립트 내용만 편집한다면 매번 프로젝트 설정을 열 필요는 없습니다. 프로젝트 이름, 배포 정보, 리소스 경로 또는 색상 선택 설정을 조정해야 할 때만 열면 됩니다.

프로젝트 결과물

텍스트 편집기의 프로젝트 작업에서는 다음 결과물 생성 기능도 제공합니다.

암호화: 배포에 적합한 암호화 결과물을 만듭니다. 완료되면 저장 위치가 표시되며 프로젝트 트리 또는 파일 관리자에서 확인하고 다운로드할 수도 있습니다.
중앙 제어 패키지: 프로젝트를 중앙 제어 서버의 스크립트 디렉터리에서 설치하고 관리할 수 있는 스크립트 패키지로 만듭니다. 패키징을 지원하는 프로젝트 유형에서만 사용할 수 있습니다.

결과물을 만들기 전에 열린 프로젝트 파일을 모두 저장하고 개발 테스트 기기에서 한 번 실행하여 검증하는 것이 좋습니다.

버튼을 사용할 수 없다면 일반적으로 현재 탭이 프로젝트에 속하지 않거나, 프로젝트 유형이 해당 작업을 지원하지 않거나, 프로젝트가 아직 작업 가능한 상태로 저장되지 않은 경우입니다.

AI 자동 완성

AI 자동 완성은 텍스트 편집기의 추가 기능입니다. 활성화하면 입력하는 동안 편집기에 AI가 생성한 흐린 인라인 제안이 표시됩니다.

사용하려면 먼저 전역 설정을 완료합니다.

시스템 설정 → AI 공급자를 엽니다.
프로필 추가를 클릭하고 프로필 이름, AI 서비스, 모델과 API Key를 입력합니다. 키가 필요 없는 호환 서비스를 사용한다면 API Key를 비워 둘 수 있습니다.
모델 이름을 확인해야 하면 모델 가져오기를 클릭하거나 모델 이름을 직접 입력할 수 있습니다.
시스템 설정 → 텍스트 편집기를 엽니다.
AI 프로필에서 방금 만든 프로필을 선택합니다.
AI 자동 완성을 활성화하고 설정 저장을 클릭합니다.

활성화한 뒤 지원되는 텍스트 파일에서 입력하면 편집기에 회색 자동 완성 제안이 표시됩니다. 자주 사용하는 조작은 다음과 같습니다.

Tab을 눌러 현재 제안을 적용합니다.
Esc를 눌러 현재 제안을 무시합니다.
Alt + Backslash를 눌러 자동 완성을 직접 실행합니다.
후보가 여러 개이면 Alt + [/Alt + ]로 후보를 전환합니다.

시스템 설정 → 텍스트 편집기에서 다음 옵션을 추가로 조정할 수 있습니다.

자동 완성 선호 사항: AI가 따르기를 원하는 코드 스타일이나 프로젝트 규칙을 입력합니다.
활성화할 파일 확장자: AI 자동 완성을 실행할 파일을 제한하고 사용자 지정 확장자도 추가할 수 있습니다.
자동 완성 컨텍스트: 현재 파일 외에 XXTouch 문서 또는 프로젝트 파일을 추가하여 스크립트 프로젝트에 더 적합한 제안을 만들 수 있습니다.

자동 완성이 나타나지 않는다면 AI 공급자 프로필을 추가했는지, AI 자동 완성을 활성화했는지, 현재 파일 확장자가 적용 범위에 있는지, 모델/API Key를 사용할 수 있는지 먼저 확인하세요. 프로젝트를 연 뒤 프로젝트 파일이 크게 변경되었다면 AI 자동 완성 컨텍스트 새로 고침을 클릭하여 현재 프로젝트 내용을 다시 읽을 수 있습니다.