Éditeur de texte

L'éditeur de texte sert à modifier les projets de scripts des appareils et les fichiers texte ordinaires. Après l'ouverture d'un projet de développement, il peut également se connecter à un appareil de test pour exécuter, arrêter et déboguer directement les scripts, ainsi que générer des artefacts chiffrés ou un paquet du centre de contrôle.

Ouvrir l'éditeur de texte

Accès courants :

• Double-cliquez sur un fichier texte dans le gestionnaire de fichiers ou cliquez dessus avec le bouton droit et choisissez l'édition du texte.
• Dans la liste des appareils, cliquez avec le bouton droit sur un appareil, choisissez de parcourir ses fichiers, puis ouvrez un fichier texte de l'appareil.
• Dans 开发目录, cliquez avec le bouton droit sur le dossier d'un projet et choisissez 打开项目, puis cliquez sur un fichier dans l'arborescence.
• Dans la liste des appareils, cliquez avec le bouton droit sur un appareil et créez un fichier Lua temporaire pour tester rapidement un petit extrait de script.

Opérations d'édition courantes

• Cliquez sur 保存 pour réécrire les modifications dans le fichier courant.
• Cliquez sur 重新读取 pour recharger le contenu depuis son emplacement d'origine.
• Cliquez avec le bouton droit sur un onglet pour afficher le fichier dans le gestionnaire de fichiers, le renommer ou copier son chemin.
• La barre d'état inférieure affiche la ligne et la colonne, l'indentation, l'encodage, la fin de ligne et le type de fichier ; en cas de doute, conservez les valeurs par défaut.
• Cliquez sur le bouton de miniature pour afficher ou masquer la miniature du code à droite.

Si une autre opération modifie le fichier après son ouverture, une confirmation de remplacement apparaît lors de l'enregistrement. Le rechargement ou la fermeture d'un onglet non enregistré affiche également un avertissement signalant une perte possible des modifications.

Définir l'appareil de développement et de test

Avant d'exécuter ou de déboguer en ligne, définissez l'appareil de développement et de test. Il doit avoir été importé, être en ligne et être accessible normalement par XXTouch ; un appareil hors ligne ne peut pas parcourir les fichiers, exécuter ou déboguer.

Accès courants :

1. Dans la liste des appareils, cliquez avec le bouton droit sur l'appareil cible et choisissez 设为开发测试设备.
2. Cliquez sur le bouton d'appareil en haut à gauche de l'éditeur, ouvrez 选择测试设备, puis choisissez l'appareil cible.

Une fois défini, l'éditeur affiche l'appareil de test courant et propose 浏览设备文件, 打开样本工作台, 运行, 停止 et 调试.

Pour changer d'appareil, sélectionnez-en un autre au même endroit ; lorsque vous n'avez plus besoin de la connexion, cliquez sur 断开测试 au même endroit.

Exécution en ligne

Après avoir ouvert un projet de développement ou un fichier du projet, cliquez sur 运行. L'éditeur enregistre d'abord les contenus nécessaires, transmet le projet courant à l'appareil de test et le démarre. La zone de journaux en bas affiche la sortie pendant l'exécution.

Les contenus exécutables sont généralement les fichiers de script du projet ou des fichiers .lua exécutables directement. Les fichiers texte ordinaires, projets non reconnus ou projets sans point d'entrée affichent 当前文件不能运行.

États courants :

• 运行中 : le script a démarré ou attend l'exécution sur l'appareil.
• 停止中 : la demande d'arrêt est en cours d'envoi à l'appareil.
• 暂无日志 : la connexion aux journaux fonctionne, mais l'appareil n'a temporairement rien produit.
• 请选择开发设备 : aucun appareil de test n'est encore défini.
• 当前文件不能运行 : l'onglet courant n'appartient pas à un projet exécutable ou aucun point d'entrée reconnaissable n'est disponible.
• 保存失败，已停止运行 : l'enregistrement du fichier courant a échoué et l'exécution ne se poursuit pas.

Pour terminer un script, cliquez sur 停止.

Débogage en ligne

Cliquez sur 调试 pour démarrer le projet en mode débogage. Ce mode sert à localiser les problèmes de variables, de pile d'appels et de branches pendant l'exécution.

Opérations courantes :

• Cliquez dans la zone des numéros de ligne à gauche de l'éditeur pour définir ou supprimer un point d'arrêt.
• Utilisez 继续, 单步, 进入 et 跳出 pour contrôler l'exécution du script.
• Consultez dans la pile d'appels la fonction où le script est arrêté ; cliquez sur une entrée pour y déplacer l'éditeur.
• Le panneau des variables affiche les variables visibles à la position suspendue ; le clic droit permet de copier ou modifier une valeur.
• Saisissez une ligne de Lua dans la console de débogage pour évaluer une expression lorsque le script est suspendu.
• Cliquez sur 断开调试 pour terminer la connexion de débogage courante.

Le panneau de débogage affiche les états 未调试, 运行中, 已暂停 et 调试已结束. Seuls les projets et appareils compatibles avec le débogage peuvent démarrer celui-ci ; si le projet courant ne peut pas être débogué, commencez par une exécution ordinaire pour vérifier son point d'entrée.

Configuration du projet

Après l'ouverture d'un projet, la barre de titre de l'éditeur de texte propose l'entrée 项目配置. Elle permet de gérer le nom du projet, l'ID du projet, la version, la description, les chemins ignorés, la bibliothèque commune et la configuration de l'espace de travail des échantillons.

Cliquez sur 保存 après toute modification de la configuration. Pour modifier uniquement le contenu d'un script, il n'est pas nécessaire d'ouvrir cette configuration à chaque fois ; ouvrez-la seulement pour ajuster le nom du projet, les informations de publication, les chemins de ressources ou les paramètres du sélecteur de couleur.

Artefacts du projet

Les opérations du projet dans l'éditeur proposent également la génération d'artefacts :

• 加密 : génère un artefact chiffré adapté à la distribution ou au déploiement. L'emplacement d'enregistrement est indiqué à la fin ; l'artefact est également consultable et téléchargeable depuis l'arborescence ou le gestionnaire de fichiers.
• 中控包 : conditionne le projet en paquet de scripts installable et gérable dans le répertoire des scripts du centre de contrôle. Cette opération n'est disponible que pour les types de projets compatibles.

Avant de générer un artefact, enregistrez tous les fichiers du projet ouverts et vérifiez une fois l'exécution avec l'appareil de développement et de test.

Si un bouton est indisponible, l'onglet courant n'appartient généralement pas à un projet, le type de projet ne prend pas en charge l'opération ou le projet n'a pas encore été enregistré dans un état exploitable.

Complétion par IA

La complétion par IA est une fonction supplémentaire de l'éditeur de texte. Lorsqu'elle est activée, l'éditeur affiche des suggestions fantômes générées par l'IA pendant la saisie.

Pour l'utiliser, terminez d'abord sa configuration dans les paramètres globaux :

1. Ouvrez 系统配置 → AI 供应商.
2. Cliquez sur 添加配置 et renseignez le nom de la configuration, le service d'IA, le modèle et la clé API. Avec un service compatible sans authentification, la clé API peut rester vide.
3. Pour vérifier le nom du modèle, cliquez sur 获取模型 ou saisissez-le manuellement.
4. Ouvrez 系统配置 → 文本编辑器.
5. Dans AI 配置, sélectionnez la configuration créée.
6. Activez AI 补全, puis cliquez sur 保存设置.

Après activation, une suggestion grise apparaît automatiquement lors de la saisie dans les fichiers texte pris en charge. Opérations courantes :

• Appuyez sur Tab pour accepter la suggestion courante.
• Appuyez sur Esc pour l'ignorer.
• Appuyez sur Alt + Backslash pour déclencher manuellement la complétion.
• S'il existe plusieurs propositions, appuyez sur Alt + [ / Alt + ] pour passer de l'une à l'autre.

Vous pouvez continuer à ajuster ces options dans 系统配置 → 文本编辑器 :

• 补全偏好 : indiquez le style de code ou les habitudes du projet que l'IA doit respecter.
• 适用文件扩展名 : limitez les fichiers qui déclenchent la complétion et ajoutez des extensions personnalisées.
• 补全上下文 : en plus du fichier courant, ajoutez XXTouch 文档 ou 项目文件 afin d'adapter les suggestions au projet de script.

Si aucune suggestion n'apparaît, vérifiez d'abord qu'une configuration de fournisseur d'IA a été ajoutée, que AI 补全 est activé, que l'extension du fichier courant est prise en charge et que le modèle et la clé API sont utilisables. Après l'ouverture d'un projet ayant subi des changements importants, cliquez sur 刷新 AI 补全上下文 pour que la complétion relise le contenu courant du projet.