Hopp til innholdet
Bekreftet

Bygg og test lokalt

En live forhåndsvisningssandkasse for UI-plugins og et mønster for frakoblet testing av library- og dbs-plugins, begge kjørt fra pluginens egen mappe.

Hver plugin-mappe under plugins/@xuda.io/ bygges med Vite (npm run dev / npm run build inne i pluginens egen mappe), og hver type har sitt eget mønster for å prøve pluginen ut før den lastes opp noe sted.

UI-plugins: live forhåndsvisning i plugin-sandbox

@xuda.io/plugin-sandbox er en liten pakke som tegner en live konfigurator for én UI-plugin: en nedtrekksliste per egenskap og et forhåndsvisningsfelt som tegnes på nytt når du endrer dem. En UI-plugins tests/index.html kobler den direkte mot pluginens egen kildekode, uten byggetrinn:

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) tar kjøretidsmodulen, egenskapsskjemaet og HTML-en pluginen skal forhåndsvises mot. Kjør npm run dev i pluginens mappe (Vite serverer tests/ som rot, ifølge pluginens vite.config.js) for å åpne den.

Library- og dbs-plugins: et frakoblet testskript

En plugin der arbeidet skjer i server.mjs tester seg selv med et vanlig Node-skript i stedet for en nettleser-sandkasse. xuda-library-plugin-xlsx er mønsteret å følge: server.mjs eksporterer et internals-objekt med de rene funksjonene sine (normalize_book, render_book, load_workbook, apply_operations, cell_value_of, ...), og tests/local.mjs importerer { internals } og kjører dem direkte, uten drive, uten AI og uten plattformtilkobling:

run it
npm run test:local

som kjører node ./tests/local.mjs (se pluginens package.json scripts.test:local). Å skrive den testede logikken som navngitte eksporter på internals er det som gjør dette mulig. En server.mjs som beholder alt som ueksporterte lokale funksjoner, har ingenting et testskript kan kalle.

plugin_tester/

plugin_tester/ i roten av depotet er en eldre tester: index.html starter en hel xuda-runtime-slim.js-side mot _default/xu-single-page-markup, og index.js er en jQuery-basert pluginkjører (func.UI.widgets, $(el), fields_ret = get_fields_data(...)) som kaller et ppi.xuda.io-plugin-API. Formen (jQuery, xu-single-page, et ppi.xuda.io-endepunkt, leter etter runtime/index.js i stedet for runtime.mjs) stemmer ikke med manifestet, typene og kjøretidssignaturen fn(plugin_name, element, properties) som er dokumentert på de andre sidene i denne delen, og ingen av pluginene under plugins/@xuda.io/ refererer til den. Den ser ut til å komme fra før dagens plugin-sandbox-arbeidsflyt, og er ikke den vedlikeholdte måten å teste en plugin lokalt på.