Code-Snippets erstellen

Erstellen

Normalerweise muss eine Datei der „Code-Snippet-Vorlage“ .snippet direkt eine Tabelle zurückgeben, zum Beispiel:

return {
    name = '测试片段';  -- Name des Code-Snippets
    description = '用于测试各选择器的功能';  -- Beschreibung des Code-Snippets
    arguments = {  -- Liste der Code-Snippet-Auswähler
        {  -- Auswähler 1
            type = 'app',  -- Typ des Auswählers
            title = '选择应用',  -- Titel des Auswählers
            subtitle = '请选择一个应用',  -- Untertitel des Auswählers
            default = 'com.xxtouch.XXTExplorer',  -- Standardwert des Auswählers
        },
        {  -- Auswähler 2
            type = 'loc',
            title = '选择地理位置',
            subtitle = '请随便选择一个地理位置',
            default = xui.get("com.darwindev.XXTExplorer", "location1"),
            -- Im .snippet-Code-Snippet können alle von .xui unterstützten APIs verwendet werden
        },
        {  -- Auswähler 3

        },
        -- ...
    };
    generator = function (...)  -- Generator mit variablen Argumenten
        -- Parameter verarbeiten und erzeugtes Ergebnis zurückgeben
        local result
        return result
    end;
}

Root-Ebene

Schlüssel	Typ	Beschreibung
name	Zeichenfolge	Name des Code-Snippets
description	Zeichenfolge	Beschreibung des Code-Snippets
arguments	Array	Liste der Code-Snippet-Auswähler
generator	Funktion	Code-Snippet-Generator
output	Zeichenfolge	Name der eigenständigen Ausgabedatei des Code-Snippets

name und description sind der Anzeigename bzw. die Anzeigebeschreibung der Code-Snippet-Vorlage und werden im Dateimanager sowie am Einstiegspunkt der Code-Snippets angezeigt.

arguments ist ein Array mit einem oder mehreren Wörterbüchern für Auswählerparameter. Die App erstellt anhand der darin festgelegten Reihenfolge eine Auswahlwarteschlange und fordert den Benutzer nacheinander zu den Auswahlvorgängen auf. Nach Abschluss der Warteschlange übergibt die App die Rückgabewerte der Auswähler als variable Argumente an den Generator generator, ruft ihn auf und gibt schließlich dessen Rückgabewert an den Aufrufer zurück.

Eine Code-Snippet-Vorlage .snippet kann eigenständig verwendet werden. Damit sie eigenständig verwendet werden kann, legen Sie das Feld output fest; der von generator erzeugte Ergebnissetext wird in der durch output bezeichneten Datei im selben Verzeichnis gespeichert.

Wörterbuch für Auswählerparameter

Schlüssel	Typ	Beschreibung
type	Zeichenfolge	Typ des Auswählers
title	Zeichenfolge	Titel des Auswählers, unter der Auswählerseite angezeigt
subtitle	Zeichenfolge	Untertitel des Auswählers, unter der Auswählerseite angezeigt
default	Basistyp	Standardwert des Auswählers

Eine ausführliche Beschreibung des Wörterbuchs für Auswählerparameter der einzelnen Auswählertypen finden Sie in den folgenden Abschnitten.

In XUI verwenden

Wenn die Code-Snippet-Vorlage .snippet in der XUI-Komponente TitleValue verwendet wird, kann die Auswahlwarteschlange aus XUI heraus geöffnet und das Ergebnis im Konfigurationseintrag der XUI-Komponente gespeichert werden. Das .snippet kann außerdem alle von XUI unterstützten APIs wie xui.get/xui.set/xpp.bundle_path aufrufen.

Im Code-Editor verwenden

Legen Sie die Code-Snippet-Vorlage .snippet im Verzeichnis snippets des Home-Verzeichnisses ab, damit sie im Code-Editor der App aufgerufen werden kann. Tippen Sie oben rechts im Tastaturwerkzeug auf die Sternschaltfläche, um schnell ein Code-Snippet zu erzeugen und in den bearbeiteten Code einzufügen.

Als eigenständige Datei verwenden

Legen Sie für die Code-Snippet-Vorlage .snippet das Feld output fest und speichern Sie das Snippet im Verzeichnis lua/scripts des Home-Verzeichnisses. Dann können Sie es direkt in der App antippen, um die Auswahlwarteschlange zu starten; der von generator erzeugte Ergebnissetext wird in der durch output bezeichneten Datei im selben Verzeichnis gespeichert.