Byg og test lokalt
En live forhåndsvisnings-sandbox til UI-plugins og et offline testmønster til library- og dbs-plugins, begge kørt fra pluginets egen mappe.
Hver plugin-mappe under plugins/@xuda.io/ bygges med Vite (npm run dev / npm run build
i pluginets egen mappe), og hver type har sit eget mønster til at prøve pluginet af,
før det uploades noget sted.
UI-plugins: live forhåndsvisning i plugin-sandboxen
@xuda.io/plugin-sandbox er en lille pakke, der viser en live konfigurator for ét UI-plugin: en
rullemenu pr. egenskab og et forhåndsvisningsfelt, der tegnes igen, når du ændrer dem. Et UI-plugins
tests/index.html kobler den direkte på pluginets egen kildekode, uden et build-trin:
initializeUiPlugin(el, plugin, properties, previewHtml) tager runtime-modulet, egenskabsskemaet
og den HTML, pluginet skal forhåndsvises mod. Kør npm run dev i pluginets mappe
(Vite serverer tests/ som rod, ifølge pluginets vite.config.js) for at åbne den.
Library- og dbs-plugins: et offline testscript
Et plugin, hvis arbejde foregår i server.mjs, tester sig selv med et almindeligt Node-script i stedet for en
browser-sandbox. xuda-library-plugin-xlsx er mønstret at følge: server.mjs eksporterer et
internals-objekt med sine rene funktioner (normalize_book, render_book, load_workbook,
apply_operations, cell_value_of, ...), og tests/local.mjs importerer { internals } og
afprøver dem direkte, uden drev, uden AI og uden forbindelse til platformen:
hvilket kører node ./tests/local.mjs (se pluginets package.json scripts.test:local). At skrive
den afprøvede logik som navngivne eksporter på internals er det, der gør dette muligt; en server.mjs,
der beholder alt som ueksporterede lokale funktioner, har intet, et testscript kan kalde.
plugin_tester/
plugin_tester/ i repoets rod er en ældre tester: index.html starter en fuld
xuda-runtime-slim.js-side mod _default/xu-single-page-markup, og index.js er en
jQuery-baseret plugin-kører (func.UI.widgets, $(el), fields_ret = get_fields_data(...)),
der kalder et ppi.xuda.io-plugin-API. Dens form (jQuery, xu-single-page, et ppi.xuda.io-endpoint,
leder efter runtime/index.js frem for runtime.mjs) passer ikke til det manifest, de typer og den
fn(plugin_name, element, properties)-runtimesignatur, der er beskrevet på dette afsnits andre sider,
og ingen af plugins under plugins/@xuda.io/ refererer til den. Den ser ud til at være ældre end
den nuværende plugin-sandbox-arbejdsgang og ikke den vedligeholdte måde at teste et plugin lokalt på.