Editor de texto

O editor de texto serve para editar projetos de scripts no dispositivo e arquivos de texto comuns. Depois de abrir um projeto de desenvolvimento, ele também pode se conectar a um dispositivo de teste para executar, parar e depurar scripts diretamente, além de gerar artefatos criptografados ou pacotes do controle central.

Abrir o editor de texto

Entradas comuns:

• clique duas vezes em um arquivo de texto no gerenciador de arquivos ou clique com o botão direito no arquivo e escolha editar o texto;
• clique com o botão direito em um dispositivo na lista, escolha navegar pelos arquivos do dispositivo e abra um arquivo de texto nele;
• clique com o botão direito em uma pasta de projeto no 开发目录, escolha 打开项目 e clique em um arquivo na árvore do projeto;
• clique com o botão direito em um dispositivo na lista para criar um arquivo Lua temporário e testar rapidamente um pequeno trecho de script.

Operações comuns de edição

• Clique em 保存 para gravar as alterações atuais no arquivo.
• Clique em 重新读取 para recarregar o conteúdo do arquivo de sua localização original.
• Clique com o botão direito em uma guia para visualizar ou renomear o arquivo no gerenciador de arquivos ou copiar seu caminho.
• A barra de status inferior mostra linha e coluna, indentação, codificação, fim de linha e tipo de arquivo; mantenha os padrões se não tiver certeza.
• Clique no botão de miniatura para mostrar ou ocultar a miniatura do código à direita.

Se o arquivo for alterado por outra operação depois de aberto, será solicitada confirmação para substituí-lo ao salvar. Ao recarregar ou fechar uma guia não salva, também será exibido um aviso de que as alterações atuais podem ser perdidas.

Configurar um dispositivo de desenvolvimento e teste

Antes de executar ou depurar online, configure um dispositivo de desenvolvimento e teste. O dispositivo precisa ter sido importado, estar online e ser acessível normalmente pelo XXTouch; dispositivos offline não podem ter seus arquivos navegados, nem executar ou depurar scripts.

Entradas comuns:

1. Clique com o botão direito no dispositivo de destino na lista e escolha 设为开发测试设备.
2. Clique no botão de dispositivo no canto superior esquerdo do editor de texto, abra 选择测试设备 e escolha o dispositivo de destino.

Depois da configuração, o editor de texto exibirá o dispositivo de teste atual e oferecerá operações como 浏览设备文件, 打开样本工作台, 运行, 停止 e 调试.

Para trocar de dispositivo, selecione outro; quando não precisar mais da conexão, clique em 断开测试 no mesmo local.

Executar online

Depois de abrir um projeto de desenvolvimento ou um arquivo do projeto, clique em 运行. O editor de texto salvará primeiro o conteúdo pendente e depois enviará o projeto atual ao dispositivo de teste e o iniciará. Durante a execução, consulte a saída na área de logs abaixo.

Normalmente, podem ser executados arquivos de script dentro de um projeto de desenvolvimento ou arquivos .lua executáveis diretamente. Arquivos de texto comuns, projetos não reconhecidos e projetos sem ponto de entrada exibem 当前文件不能运行.

Status comuns:

• 运行中: o script foi iniciado ou aguarda a execução pelo dispositivo.
• 停止中: uma solicitação de parada está sendo enviada ao dispositivo.
• 暂无日志: a conexão de logs está normal, mas o dispositivo ainda não produziu saída.
• 请选择开发设备: nenhum dispositivo de teste foi configurado.
• 当前文件不能运行: a guia atual não pertence a um projeto executável ou não tem um ponto de entrada reconhecível.
• 保存失败，已停止运行: o arquivo atual não foi salvo; a execução não continuará.

Para encerrar o script, clique em 停止.

Depurar online

Clique em 调试 para iniciar o projeto no modo de depuração. Isso é útil para localizar problemas em variáveis, pilhas de chamadas e ramificações durante a execução.

Operações comuns:

• defina ou remova pontos de interrupção na área dos números de linha à esquerda do editor;
• use 继续, 单步, 进入 e 跳出 para controlar a execução do script;
• consulte em qual função o script está parado na pilha de chamadas; ao clicar em um item, o editor irá para a posição correspondente;
• consulte no painel de variáveis as variáveis visíveis na posição pausada atual; clique com o botão direito para copiar ou alterar um valor;
• digite uma linha de Lua no console de depuração; quando o script estiver pausado, você poderá executar expressões;
• clique em 断开调试 para encerrar a conexão de depuração atual.

O painel de depuração mostra status como 未调试, 运行中, 已暂停 e 调试已结束. A depuração só pode ser iniciada com projetos e dispositivos compatíveis; se o projeto atual não puder ser depurado, use primeiro a execução normal para confirmar se o ponto de entrada está correto.

Configuração do projeto

Depois de abrir um projeto, a barra de título do editor de texto oferecerá a entrada 项目配置. Nela, mantenha o nome, o ID, a versão, a descrição, os caminhos ignorados, as bibliotecas públicas e a configuração do Sample Workbench do projeto.

Depois de alterar a configuração do projeto, clique em 保存. Se estiver apenas editando o conteúdo de scripts, não é necessário abrir a configuração do projeto sempre; entre nela somente quando precisar ajustar o nome, as informações de publicação, os caminhos de recursos ou a configuração de captura de cores.

Artefatos do projeto

As operações de projeto do editor de texto também oferecem geração de artefatos:

• 加密: gera um artefato criptografado adequado para distribuição ou implantação. Ao terminar, o local para salvar será solicitado; também é possível visualizá-lo e baixá-lo na árvore do projeto ou no gerenciador de arquivos.
• 中控包: empacota o projeto como um pacote de scripts que pode ser instalado e gerenciado no diretório de scripts do controle central. Essa operação só está disponível para tipos de projeto compatíveis com empacotamento.

Antes de gerar artefatos, recomendamos salvar todos os arquivos de projeto abertos e concluir uma execução de verificação no dispositivo de desenvolvimento e teste.

Se um botão estiver indisponível, normalmente a guia atual não pertence a um projeto, o tipo de projeto não oferece suporte à operação ou o projeto ainda não foi salvo em um estado operável.

Preenchimento com AI

O preenchimento com AI é um recurso adicional do editor de texto. Quando ativado, o editor mostra sugestões translúcidas geradas por AI durante a digitação.

Para usá-lo, conclua primeiro a configuração global:

1. Abra 系统配置 → AI 供应商.
2. Clique em 添加配置 e preencha o nome da configuração, o serviço de AI, o modelo e a API Key. A API Key pode ficar vazia ao usar um serviço compatível sem chave.
3. Para confirmar o nome do modelo, clique em 获取模型 ou informe-o manualmente.
4. Abra 系统配置 → 文本编辑器.
5. Selecione a configuração recém-criada em AI 配置.
6. Ative AI 补全 e clique em 保存设置.

Depois de ativado, o editor mostrará automaticamente sugestões de preenchimento em cinza ao digitar em arquivos de texto compatíveis. Operações comuns:

• pressione Tab para aceitar a sugestão atual;
• pressione Esc para ignorar a sugestão atual;
• pressione Alt + Backslash para acionar o preenchimento manualmente;
• quando houver várias opções, pressione Alt + [ / Alt + ] para alternar entre elas.

Você pode continuar ajustando estas opções em 系统配置 → 文本编辑器:

• 补全偏好: informe o estilo de código ou os hábitos do projeto que você quer que a AI siga.
• 适用文件扩展名: limite os arquivos que acionam o preenchimento com AI; também é possível adicionar extensões personalizadas.
• 补全上下文: além do arquivo atual, adicione XXTouch 文档 ou 项目文件 para aproximar as sugestões do projeto de scripts.

Se nenhuma sugestão aparecer, verifique se uma configuração de fornecedor de AI foi adicionada, se AI 补全 está ativado, se a extensão do arquivo atual está no escopo compatível e se o modelo/API Key está disponível. Depois de abrir o projeto, se os arquivos do projeto tiverem mudado significativamente, clique em 刷新 AI 补全上下文 para que o preenchimento leia novamente o conteúdo atual do projeto.