Texteditor

Der Texteditor bearbeitet Geräteskriptprojekte und normale Textdateien. Nach dem Öffnen eines Entwicklungsprojekts kann er außerdem ein Testgerät verbinden, Skripte ausführen, stoppen und debuggen sowie verschlüsselte Artefakte oder Zentralenpakete erzeugen.

Texteditor öffnen

Häufige Einstiege:

• Doppelklicken Sie im Dateimanager auf eine Textdatei oder wählen Sie nach einem Rechtsklick die Textbearbeitung.
• Klicken Sie in der Geräteliste mit der rechten Maustaste auf ein Gerät, durchsuchen Sie die Gerätedateien und öffnen Sie dort eine Textdatei.
• Klicken Sie im 开发目录 mit der rechten Maustaste auf einen Projektordner, wählen Sie 打开项目 und klicken Sie anschließend im Projektbaum auf eine Datei.
• Klicken Sie in der Geräteliste mit der rechten Maustaste auf ein Gerät und erstellen Sie eine temporäre Lua-Datei, um einen kurzen Skriptabschnitt schnell zu testen.

Häufige Bearbeitungsaktionen

• Klicken Sie auf 保存, um die aktuellen Änderungen in die Datei zu schreiben.
• Klicken Sie auf 重新读取, um den Dateiinhalt am ursprünglichen Speicherort erneut zu laden.
• Klicken Sie mit der rechten Maustaste auf einen Tab, um die Datei im Dateimanager anzuzeigen, umzubenennen oder ihren Pfad zu kopieren.
• Die Statusleiste unten zeigt Zeile/Spalte, Einrückung, Kodierung, Zeilenende und Dateityp. Lassen Sie im Zweifel die Standardwerte bestehen.
• Mit der Minimap-Schaltfläche können Sie die Code-Minimap rechts ein- oder ausblenden.

Wenn eine Datei nach dem Öffnen durch einen anderen Vorgang geändert wurde, erscheint beim Speichern eine Überschreibbestätigung. Beim erneuten Laden oder Schließen eines ungespeicherten Tabs wird ebenfalls vor möglichem Datenverlust gewarnt.

Entwicklungstestgerät festlegen

Wählen Sie vor Online-Ausführung und Debugging ein Entwicklungstestgerät aus. Das Gerät muss importiert, online und über XXTouch erreichbar sein; Offline-Geräte können weder Dateien durchsuchen noch ausführen oder debuggen.

Häufige Einstiege:

1. Klicken Sie in der Geräteliste mit der rechten Maustaste auf das Zielgerät und wählen Sie 设为开发测试设备.
2. Klicken Sie oben links im Texteditor auf die Geräteschaltfläche, öffnen Sie 选择测试设备 und wählen Sie das Zielgerät.

Danach zeigt der Texteditor das aktuelle Testgerät und bietet Aktionen wie 浏览设备文件, 打开样本工作台, 运行, 停止 und 调试.

Wählen Sie zum Wechseln ein anderes Gerät aus. Wenn die Verbindung nicht mehr benötigt wird, klicken Sie an derselben Stelle auf 断开测试.

Online ausführen

Öffnen Sie ein Entwicklungsprojekt oder eine darin enthaltene Datei und klicken Sie auf 运行. Der Texteditor speichert zunächst erforderliche Änderungen, sendet das aktuelle Projekt an das Testgerät und startet es. Die Ausgabe sehen Sie während des Laufs im Protokollbereich unten.

Ausführbar sind normalerweise Skriptdateien in einem Entwicklungsprojekt oder direkt ausführbare .lua-Dateien. Bei normalen Textdateien, unbekannten Projekten oder Projekten ohne Einstieg erscheint 当前文件不能运行.

Häufige Statuswerte:

• 运行中: Das Skript wurde gestartet oder wartet auf die Ausführung durch das Gerät.
• 停止中: Eine Stoppanforderung wird an das Gerät gesendet.
• 暂无日志: Die Protokollverbindung ist aktiv, aber das Gerät hat noch keine Ausgabe erzeugt.
• 请选择开发设备: Es wurde noch kein Testgerät festgelegt.
• 当前文件不能运行: Der aktuelle Tab gehört zu keinem ausführbaren Projekt oder enthält keinen erkannten Einstieg.
• 保存失败，已停止运行: Die Datei konnte nicht gespeichert werden; der Lauf wird nicht fortgesetzt.

Klicken Sie zum Beenden des Skripts auf 停止.

Online debuggen

Klicken Sie auf 调试, um das Projekt im Debugmodus zu starten. So lassen sich Variablen, Stackframes und Verzweigungen während der Ausführung untersuchen.

Häufige Aktionen:

• Setzen oder entfernen Sie Breakpoints im Zeilennummernbereich links im Editor.
• Steuern Sie die Ausführung mit 继续, 单步, 进入 und 跳出.
• Sehen Sie im Aufrufstapel, in welcher Funktion das Skript angehalten ist. Durch Anklicken eines Eintrags springt der Editor dorthin.
• Prüfen Sie im Variablenfenster die am Haltepunkt sichtbaren Variablen. Per Rechtsklick können Sie Werte kopieren oder ändern.
• Geben Sie im Debugkonsolenfenster eine einzelne Lua-Zeile ein und werten Sie sie bei angehaltenem Skript aus.
• Klicken Sie auf 断开调试, um die aktuelle Debugverbindung zu beenden.

Das Debugfenster zeigt Statuswerte wie 未调试, 运行中, 已暂停 und 调试已结束. Nur unterstützte Projekte und Geräte können debuggt werden. Wenn das Projekt nicht debugbar ist, prüfen Sie zunächst den Einstieg mit einem normalen Lauf.

Projektkonfiguration

Nach dem Öffnen eines Projekts bietet die Titelleiste des Texteditors 项目配置. Dort können Sie Projektname, Projekt-ID, Version, Beschreibung, ignorierte Pfade, gemeinsam genutzte Bibliotheken und Sample-Workbench-Einstellungen pflegen.

Klicken Sie nach Änderungen an der Projektkonfiguration auf 保存. Für reine Skriptänderungen müssen Sie die Konfiguration nicht jedes Mal öffnen; verwenden Sie sie nur für Projektname, Veröffentlichungsdaten, Ressourcenpfade oder Pipetteneinstellungen.

Projektartefakte

Die Projektaktionen des Texteditors bieten außerdem die Artefakterzeugung:

• 加密: erzeugt ein verschlüsseltes Artefakt für Verteilung oder Bereitstellung. Nach Abschluss wird der Speicherort angezeigt; Sie können es auch im Projektbaum oder Dateimanager anzeigen und herunterladen.
• 中控包: paketiert das Projekt als Skriptpaket zur Installation und Verwaltung im Skriptverzeichnis der Zentrale. Dies ist nur für unterstützte Projekttypen verfügbar.

Speichern Sie vor der Artefakterzeugung alle geöffneten Projektdateien und prüfen Sie den Lauf einmal mit dem Entwicklungstestgerät.

Wenn eine Schaltfläche deaktiviert ist, gehört der aktuelle Tab meist nicht zu einem Projekt, der Projekttyp unterstützt die Aktion nicht oder das Projekt wurde noch nicht in einem bearbeitbaren Zustand gespeichert.

KI-Autovervollständigung

Die KI-Autovervollständigung ist eine optionale Funktion des Texteditors. Nach der Aktivierung zeigt der Editor beim Tippen von der KI erzeugte Geistervorschläge.

Konfigurieren Sie sie zuerst in den globalen Einstellungen:

1. Öffnen Sie 系统配置 → AI 供应商.
2. Klicken Sie auf 添加配置 und geben Sie Profilname, KI-Dienst, Modell und API Key ein. Bei kompatiblen schlüssellosen Diensten kann der API Key leer bleiben.
3. Klicken Sie bei Bedarf auf 获取模型, um Modellnamen abzurufen, oder geben Sie den Namen manuell ein.
4. Öffnen Sie 系统配置 → 文本编辑器.
5. Wählen Sie das soeben erstellte Profil unter AI 配置 aus.
6. Aktivieren Sie AI 补全 und klicken Sie auf 保存设置.

Nach der Aktivierung zeigt der Editor beim Tippen in unterstützten Textdateien graue Vorschläge an. Häufige Aktionen:

• Drücken Sie Tab, um den aktuellen Vorschlag zu übernehmen.
• Drücken Sie Esc, um den aktuellen Vorschlag zu verwerfen.
• Drücken Sie Alt + Backslash, um die Vervollständigung manuell auszulösen.
• Bei mehreren Vorschlägen wechseln Sie mit Alt + [ / Alt + ] zwischen ihnen.

Diese Optionen können Sie unter 系统配置 → 文本编辑器 weiter anpassen:

• 补全偏好: Beschreiben Sie den Codestil oder die Projektgewohnheiten, die die KI befolgen soll.
• 适用文件扩展名: Legen Sie fest, welche Dateitypen die KI-Autovervollständigung auslösen, und fügen Sie eigene Erweiterungen hinzu.
• 补全上下文: Beziehen Sie neben der aktuellen Datei XXTouch 文档 oder 项目文件 ein, damit Vorschläge besser zum Skriptprojekt passen.

Wenn keine Vorschläge erscheinen, prüfen Sie, ob ein KI-Anbieterprofil hinzugefügt und AI 补全 aktiviert ist, ob die Dateierweiterung zulässig ist und ob Modell/API Key funktionieren. Nach größeren Projektänderungen können Sie 刷新 AI 补全上下文 anklicken, damit die Vervollständigung den Projektinhalt neu einliest.