Editor de texto

El editor de texto sirve para editar proyectos de scripts para dispositivos y archivos de texto normales. Al abrir un proyecto de desarrollo, también puede conectarse a un dispositivo de pruebas para ejecutar, detener y depurar scripts directamente, y generar artefactos cifrados o paquetes para el control central.

Abrir el editor de texto

Accesos habituales:

• Haz doble clic en un archivo de texto del Gestor de archivos o abre su menú contextual y selecciona editarlo.
• Abre el menú contextual de un dispositivo en la lista, selecciona explorar sus archivos y abre un archivo de texto del dispositivo.
• En Directorio de desarrollo, abre el menú contextual de la carpeta de un proyecto, selecciona Abrir proyecto y haz clic en un archivo del árbol.
• Abre el menú contextual de un dispositivo en la lista y crea un archivo Lua temporal para probar rápidamente un fragmento de script.

Operaciones de edición habituales

• Haz clic en Guardar para escribir los cambios actuales en el archivo.
• Haz clic en Volver a leer para volver a cargar el contenido desde su ubicación original.
• Abre el menú contextual de una pestaña para ver el archivo en el Gestor de archivos, cambiarle el nombre o copiar su ruta.
• La barra de estado inferior muestra la fila y la columna, la sangría, la codificación, el fin de línea y el tipo de archivo; si no estás seguro, conserva los valores predeterminados.
• Haz clic en el botón de miniatura para mostrar u ocultar la miniatura del código de la derecha.

Si otra operación modifica el archivo después de abrirlo, al guardarlo aparecerá una confirmación de sobrescritura. Al volver a leerlo o cerrar una pestaña sin guardar, también se advertirá de la posible pérdida de los cambios actuales.

Configurar el dispositivo de pruebas de desarrollo

Antes de ejecutar o depurar en línea, debes configurar un dispositivo de pruebas de desarrollo. El dispositivo debe estar importado, en línea y ser accesible normalmente por XXTouch; un dispositivo sin conexión no puede explorar archivos, ejecutar ni depurar.

Accesos habituales:

1. Abre el menú contextual del dispositivo deseado en la lista y selecciona Establecer como dispositivo de pruebas de desarrollo.
2. Haz clic en el botón de dispositivo de la esquina superior izquierda del editor de texto, abre Seleccionar dispositivo de pruebas y elige el dispositivo.

Después de configurarlo, el editor de texto mostrará el dispositivo de pruebas actual y ofrecerá operaciones como Explorar archivos del dispositivo, Abrir Espacio de trabajo de muestras, Ejecutar, Detener y Depurar.

Para cambiar de dispositivo, selecciona otro; cuando ya no quieras trabajar en línea, haz clic en Desconectar pruebas en el mismo lugar.

Ejecutar en línea

Después de abrir un proyecto de desarrollo o un archivo del proyecto, haz clic en Ejecutar. El editor de texto guardará primero el contenido necesario y enviará e iniciará el proyecto actual en el dispositivo de pruebas. Durante la ejecución puedes consultar la salida en el área de registros inferior.

Normalmente se pueden ejecutar los archivos de script de un proyecto de desarrollo o los archivos .lua ejecutables directamente. Para un archivo de texto normal, un proyecto no reconocido o un proyecto sin entrada, se mostrará El archivo actual no se puede ejecutar.

Estados habituales:

• En ejecución: el script se ha iniciado o está esperando a que el dispositivo lo ejecute.
• Deteniendo: se está enviando una solicitud de detención al dispositivo.
• Sin registros: la conexión de registros funciona, pero el dispositivo no ha producido ninguna salida por ahora.
• Selecciona un dispositivo de desarrollo: aún no se ha configurado un dispositivo de pruebas.
• El archivo actual no se puede ejecutar: la pestaña actual no pertenece a un proyecto ejecutable o no contiene una entrada reconocible.
• Error al guardar; ejecución detenida: el archivo actual no se guardó correctamente y la ejecución no continuará.

Para terminar el script, haz clic en Detener.

Depurar en línea

Haz clic en Depurar para iniciar el proyecto en modo de depuración. Es útil para localizar problemas en variables, pilas de llamadas y ramas durante la ejecución.

Operaciones habituales:

• Establece o quita puntos de interrupción en el área de números de línea de la izquierda del editor.
• Usa Continuar, Paso a paso, Entrar y Salir para controlar la ejecución del script.
• Consulta en la pila de llamadas en qué nivel de función se detuvo el script; al hacer clic en una entrada, el editor saltará a la ubicación correspondiente.
• Consulta en el panel de variables las variables visibles en la posición pausada; abre el menú contextual para copiar o modificar sus valores.
• Introduce Lua de una sola línea en la consola de depuración; las expresiones se pueden ejecutar mientras el script está pausado.
• Haz clic en Desconectar depuración para finalizar la conexión de depuración actual.

El panel de depuración muestra estados como Sin depurar, En ejecución, Pausado y Depuración finalizada. Solo los proyectos y dispositivos compatibles con la depuración pueden iniciarla; si se indica que el proyecto actual no se puede depurar, ejecuta primero el proyecto normalmente para confirmar que la entrada sea correcta.

Configuración del proyecto

Al abrir un proyecto, la barra de título del editor de texto ofrece la opción Configuración del proyecto. Desde ahí puedes mantener el nombre, el ID, la versión, la descripción, las rutas ignoradas, las bibliotecas comunes y la configuración del Espacio de trabajo de muestras.

Después de modificar la configuración del proyecto, haz clic en Guardar. Si solo editas el contenido del script, no necesitas abrir la configuración cada vez; entra en ella únicamente cuando debas cambiar el nombre del proyecto, la información de publicación, las rutas de recursos o la configuración del selector de color.

Artefactos del proyecto

Las operaciones del proyecto del editor de texto también permiten generar artefactos:

• Cifrar: genera un artefacto cifrado apto para distribuir o desplegar. Al terminar, se indicará dónde guardarlo; también puedes verlo o descargarlo desde el árbol del proyecto o el Gestor de archivos.
• Paquete para el control central: empaqueta el proyecto como un paquete de scripts que se puede instalar y administrar en el directorio de scripts del control central. Solo está disponible para tipos de proyecto compatibles con el empaquetado.

Antes de generar un artefacto, se recomienda guardar todos los archivos abiertos del proyecto y realizar una ejecución de verificación con el dispositivo de pruebas de desarrollo.

Si el botón no está disponible, normalmente se debe a que la pestaña actual no pertenece a un proyecto, el tipo de proyecto no admite la operación o el proyecto aún no se ha guardado en un estado operativo.

Autocompletado con IA

El autocompletado con IA es una función adicional del editor de texto. Al activarlo, el editor muestra durante la escritura sugerencias fantasma generadas por IA.

Para usarlo, completa primero la configuración global:

1. Abre Configuración del sistema → Proveedor de IA.
2. Haz clic en Añadir configuración e introduce el nombre de la configuración, el servicio de IA, el modelo y la clave de API. La clave de API se puede dejar vacía al usar un servicio compatible sin contraseña.
3. Si necesitas confirmar el nombre del modelo, haz clic en Obtener modelos o introdúcelo manualmente.
4. Abre Configuración del sistema → Editor de texto.
5. Selecciona la configuración recién creada en Configuración de IA.
6. Activa Autocompletado con IA y haz clic en Guardar configuración.

Después de activarlo, el editor mostrará automáticamente sugerencias grises al escribir en archivos de texto compatibles. Operaciones habituales:

• Pulsa Tab para aceptar la sugerencia actual.
• Pulsa Esc para ignorar la sugerencia actual.
• Pulsa Alt + Backslash para activar manualmente el autocompletado.
• Si aparecen varios candidatos, pulsa Alt + [ / Alt + ] para cambiar de candidato.

Puedes seguir ajustando estas opciones en Configuración del sistema → Editor de texto:

• Preferencias de autocompletado: escribe el estilo de código o las convenciones del proyecto que quieres que respete la IA.
• Extensiones de archivo compatibles: limita los archivos que activan el autocompletado con IA y permite añadir extensiones personalizadas.
• Contexto del autocompletado: además del archivo actual, puedes incluir Documentación de XXTouch o Archivos del proyecto para adaptar mejor las sugerencias al proyecto de scripts.

Si no aparecen sugerencias, comprueba que se haya añadido una configuración de proveedor de IA, que Autocompletado con IA esté activado, que la extensión del archivo actual sea compatible y que el modelo o la clave de API estén disponibles. Después de abrir un proyecto, si sus archivos han cambiado mucho, haz clic en Actualizar contexto del autocompletado con IA para que vuelva a leer el contenido actual.