Текстовый редактор

Текстовый редактор предназначен для редактирования проектов скриптов на устройстве и обычных текстовых файлов. После открытия проекта разработки он также подключается к тестовому устройству, запускает, останавливает и отлаживает скрипты, а также создаёт зашифрованные артефакты или пакеты консоли.

Открытие текстового редактора

Основные способы:

• Дважды щёлкните текстовый файл в файловом менеджере или выберите редактирование текста в его контекстном меню.
• Щёлкните устройство правой кнопкой в списке устройств, выберите просмотр файлов устройства и откройте текстовый файл на устройстве.
• Щёлкните папку проекта правой кнопкой в 开发目录, выберите 打开项目, затем нажмите файл в дереве проекта.
• Щёлкните устройство правой кнопкой в списке и создайте временный файл Lua для быстрого тестирования небольшого фрагмента скрипта.

Основные операции редактирования

• Нажмите 保存, чтобы записать текущие изменения в файл.
• Нажмите 重新读取, чтобы заново загрузить содержимое из исходного места.
• Щёлкните вкладку правой кнопкой, чтобы просмотреть файл в файловом менеджере, переименовать его или скопировать путь.
• В строке состояния снизу видны строка и столбец, отступы, кодировка, окончания строк и тип файла; если не уверены, оставьте значения по умолчанию.
• Кнопка миниатюры показывает или скрывает миниатюру кода справа.

Если после открытия файл изменён другой операцией, при сохранении появится запрос на перезапись. При перечитывании или закрытии несохранённой вкладки также появится предупреждение о возможной потере изменений.

Настройка устройства разработки и тестирования

Перед запуском и отладкой на устройстве нужно выбрать устройство разработки и тестирования. Оно должно быть импортировано, подключено к сети и доступно через XXTouch; для офлайн-устройства просмотр файлов, запуск и отладка недоступны.

Основные способы:

1. В списке устройств щёлкните нужное устройство правой кнопкой и выберите 设为开发测试设备.
2. Нажмите кнопку устройства в левом верхнем углу текстового редактора, откройте 选择测试设备 и выберите цель.

После выбора редактор показывает текущее тестовое устройство и предлагает действия 浏览设备文件, 打开样本工作台, 运行, 停止 и 调试.

Чтобы сменить устройство, выберите другое; когда подключение больше не нужно, нажмите 断开测试 там же.

Запуск на устройстве

Откройте проект разработки или файл проекта и нажмите 运行. Редактор сначала сохранит необходимые изменения, затем передаст проект тестовому устройству и запустит его. Вывод во время работы отображается в области логов снизу.

Обычно запускаются файлы скриптов в проекте разработки или отдельные запускаемые файлы .lua. Для обычного текста, нераспознанного проекта или проекта без входа показывается 当前文件不能运行.

Типичные состояния:

• 运行中: скрипт запущен или ожидает выполнения на устройстве.
• 停止中: устройству отправляется запрос остановки.
• 暂无日志: подключение к логам исправно, но устройство ещё ничего не вывело.
• 请选择开发设备: тестовое устройство ещё не задано.
• 当前文件不能运行: вкладка не относится к запускаемому проекту или вход не распознан.
• 保存失败，已停止运行: текущий файл не сохранён, поэтому запуск не продолжается.

Чтобы завершить скрипт, нажмите 停止.

Отладка на устройстве

Нажмите 调试, чтобы запустить проект в режиме отладки и исследовать переменные, стек вызовов и ветвления.

Основные действия:

• устанавливать и снимать точки останова в области номеров строк слева;
• управлять выполнением с помощью 继续, 单步, 进入 и 跳出;
• просматривать в стеке вызовов, на какой функции остановился скрипт; щелчок по элементу переносит редактор к нужному месту;
• просматривать доступные в текущей точке остановки переменные; контекстное меню позволяет скопировать или изменить значение;
• вводить однострочный Lua в консоли отладки и выполнять выражения, пока скрипт приостановлен;
• нажать 断开调试, чтобы завершить текущее соединение.

Панель отладки показывает состояния 未调试, 运行中, 已暂停 и 调试已结束. Отладку можно запускать только для совместимых проектов и устройств; если проект не поддерживается, сначала проверьте его вход обычным запуском.

Конфигурация проекта

После открытия проекта в заголовке текстового редактора доступна 项目配置. Здесь можно изменить имя, ID, версию, описание, игнорируемые пути, общие библиотеки и настройки рабочей области образцов.

После изменения конфигурации проекта нажмите 保存. Для обычного редактирования скрипта открывать её каждый раз не нужно; используйте её при изменении имени, сведений о публикации, путей ресурсов или параметров выбора цвета.

Артефакты проекта

В операциях проекта текстового редактора также доступны:

• 加密: создаёт зашифрованный артефакт для распространения или развёртывания. После завершения показывается место сохранения; файл можно открыть или скачать из дерева проекта или файлового менеджера.
• 中控包: упаковывает проект в пакет скрипта, который можно установить и управлять им в каталоге скриптов консоли. Доступно только для поддерживаемых типов проектов.

Перед созданием артефакта сохраните все открытые файлы проекта и проверьте запуск на устройстве разработки и тестирования.

Если кнопка недоступна, текущая вкладка обычно не относится к проекту, тип проекта не поддерживает операцию или проект ещё не сохранён в пригодном состоянии.

Автодополнение AI

Автодополнение AI — дополнительная функция текстового редактора. После включения при вводе отображаются призрачные подсказки, созданные AI.

Для использования сначала настройте функцию в общих параметрах:

1. Откройте 系统配置 → AI 供应商.
2. Нажмите 添加配置 и укажите имя конфигурации, сервис AI, модель и API Key. Для совместимых сервисов без ключа API Key можно оставить пустым.
3. При необходимости проверить имя модели нажмите 获取模型 или введите его вручную.
4. Откройте 系统配置 → 文本编辑器.
5. В AI 配置 выберите созданную конфигурацию.
6. Включите AI 补全 и нажмите 保存设置.

После включения в подходящих текстовых файлах редактор автоматически показывает серые подсказки. Основные действия:

• нажмите Tab, чтобы принять подсказку;
• нажмите Esc, чтобы отклонить подсказку;
• нажмите Alt + Backslash, чтобы вызвать автодополнение вручную;
• при нескольких вариантах переключайтесь клавишами Alt + [ / Alt + ].

Эти параметры можно изменить в 系统配置 → 文本编辑器:

• 补全偏好: стиль кода и правила проекта, которым должен следовать AI.
• 适用文件扩展名: ограничивает файлы, для которых запускается автодополнение AI; можно добавить свои расширения.
• 补全上下文: кроме текущего файла можно добавить XXTouch 文档 или 项目文件, чтобы подсказки лучше учитывали проект скрипта.

Если подсказки не появляются, проверьте конфигурацию поставщика AI, включение AI 补全, расширение текущего файла и доступность модели/API Key. После значительных изменений проекта откройте проект и нажмите 刷新 AI 补全上下文, чтобы перечитать его содержимое.