Zum Inhalt springen
Geprüft

Lokal bauen und testen

Eine Live-Vorschau-Sandbox für UI-Plugins und ein Offline-Testmuster für Library- und dbs-Plugins, beide aus dem eigenen Ordner des Plugins gestartet.

Jeder Plugin-Ordner unter plugins/@xuda.io/ wird mit Vite gebaut (npm run dev / npm run build im eigenen Verzeichnis des Plugins), und jede Art hat ihr eigenes Muster, um das Plugin auszuprobieren, bevor es irgendwohin hochgeladen wird.

UI-Plugins: die Live-Vorschau der plugin-sandbox

@xuda.io/plugin-sandbox ist ein kleines Paket, das einen Live-Konfigurator für ein UI-Plugin darstellt: ein Dropdown pro Eigenschaft und einen Vorschaubereich, der sich beim Ändern neu rendert. Die tests/index.html eines UI-Plugins verdrahtet es direkt gegen den eigenen Quellcode des Plugins, ohne Build-Schritt:

tests/index.html
import * as plugin from "../src/runtime.mjs";
import { properties } from "../src/index.mjs";
import { initializeUiPlugin } from "@xuda.io/plugin-sandbox";

initializeUiPlugin($("body")[0], plugin, properties, `<div>12 27 2024 8:30</div>`)

initializeUiPlugin(el, plugin, properties, previewHtml) nimmt das Runtime-Modul, das Eigenschaftsschema und das HTML, gegen das das Plugin in der Vorschau gezeigt wird. Führe npm run dev im Ordner des Plugins aus (Vite liefert tests/ als Root aus, gemäß der vite.config.js des Plugins), um sie zu öffnen.

Library- und dbs-Plugins: ein Offline-Testskript

Ein Plugin, dessen Arbeit in server.mjs stattfindet, testet sich mit einem schlichten Node-Skript statt mit einer Browser-Sandbox. xuda-library-plugin-xlsx ist das Muster, dem du folgen kannst: server.mjs exportiert ein internals-Objekt mit seinen reinen Funktionen (normalize_book, render_book, load_workbook, apply_operations, cell_value_of, ...), und tests/local.mjs importiert { internals } und ruft sie direkt auf, ohne Drive, ohne KI, ohne Plattformverbindung:

run it
npm run test:local

Das führt node ./tests/local.mjs aus (siehe scripts.test:local in der package.json des Plugins). Die getestete Logik als benannte Exporte an internals zu schreiben, macht das erst möglich. Eine server.mjs, die alles als nicht exportierte lokale Funktionen belässt, hat nichts, was ein Testskript aufrufen könnte.

plugin_tester/

plugin_tester/ im Stammverzeichnis des Repos ist ein älterer Tester: index.html startet eine komplette xuda-runtime-slim.js-Seite gegen _default/xu-single-page-Markup, und index.js ist ein jQuery-basierter Plugin-Runner (func.UI.widgets, $(el), fields_ret = get_fields_data(...)), der eine ppi.xuda.io-Plugin-API aufruft. Seine Form (jQuery, xu-single-page, ein ppi.xuda.io-Endpunkt, Suche nach runtime/index.js statt runtime.mjs) passt nicht zum Manifest, den Arten und der Runtime-Signatur fn(plugin_name, element, properties), die auf den anderen Seiten dieses Abschnitts dokumentiert sind, und keines der Plugins unter plugins/@xuda.io/ verweist darauf. Es wirkt, als stamme es aus der Zeit vor dem aktuellen Plugin-Sandbox-Ablauf, statt der gepflegte Weg zu sein, ein Plugin lokal zu testen.