Naar de inhoud springen
Geverifieerd

Lokaal bouwen en testen

Een live previewsandbox voor UI-plugins en een offline testpatroon voor library- en dbs-plugins, beide vanuit de eigen map van de plugin.

Elke pluginmap onder plugins/@xuda.io/ bouwt met Vite (npm run dev / npm run build in de eigen map van de plugin), en elke soort heeft een eigen patroon om de plugin uit te proberen voordat hij ergens wordt geüpload.

UI-plugins: de live preview van plugin-sandbox

@xuda.io/plugin-sandbox is een klein pakket dat een live configurator toont voor één UI-plugin: een dropdown per eigenschap en een previewvenster dat opnieuw rendert als je ze wijzigt. De tests/index.html van een UI-plugin koppelt hem direct aan de eigen bron van de plugin, zonder buildstap:

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) neemt de runtimemodule, het eigenschappenschema en de HTML waartegen de plugin wordt bekeken. Voer npm run dev uit in de map van de plugin (Vite serveert tests/ als root, volgens de vite.config.js van de plugin) om hem te openen.

Library- en dbs-plugins: een offline testscript

Een plugin waarvan het werk in server.mjs gebeurt, test zichzelf met een gewoon Node-script in plaats van een browsersandbox. xuda-library-plugin-xlsx is het patroon om te volgen: server.mjs exporteert een object internals met zijn pure functies (normalize_book, render_book, load_workbook, apply_operations, cell_value_of, ...), en tests/local.mjs importeert { internals } en gebruikt ze direct, zonder drive, zonder AI en zonder verbinding met het platform:

run it
npm run test:local

Dat draait node ./tests/local.mjs (zie scripts.test:local in de package.json van de plugin). De logica die je test als benoemde exports op internals schrijven maakt dit mogelijk; een server.mjs die alles als niet-geëxporteerde lokale functies houdt, heeft niets wat een testscript kan aanroepen.

plugin_tester/

plugin_tester/ in de root van de repo is een oudere tester: index.html start een volledige pagina met xuda-runtime-slim.js op _default/xu-single-page-opmaak, en index.js is een op jQuery gebaseerde pluginrunner (func.UI.widgets, $(el), fields_ret = get_fields_data(...)) die een ppi.xuda.io-plugin-API aanroept. De vorm ervan (jQuery, xu-single-page, een ppi.xuda.io-endpoint, zoeken naar runtime/index.js in plaats van runtime.mjs) komt niet overeen met het manifest, de soorten en de runtimesignatuur fn(plugin_name, element, properties) die op de andere pagina's van deze sectie staan, en geen van de plugins onder plugins/@xuda.io/ verwijst ernaar. Het lijkt van vóór de huidige plugin-sandbox-workflow te zijn, en niet de onderhouden manier om een plugin lokaal te testen.