Gå til indhold
Bekræftet

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:

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) 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:

run it
npm run test:local

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å.