Hoppa till innehållet
Verifierad

Bygg och testa lokalt

En sandlåda med liveförhandsgranskning för UI-plugins och ett testmönster utan uppkoppling för biblioteks- och dbs-plugins, båda körda från pluginens egen mapp.

Varje pluginmapp under plugins/@xuda.io/ byggs med Vite (npm run dev / npm run build i pluginens egen katalog), och varje typ har sitt eget mönster för att prova pluginen innan den laddas upp någonstans.

UI-plugins: liveförhandsgranskning i plugin-sandbox

@xuda.io/plugin-sandbox är ett litet paket som ritar en live-konfigurator för en UI-plugin: en rullgardinsmeny per egenskap och en förhandsgranskningsruta som ritas om när du ändrar dem. En UI-plugins tests/index.html kopplar upp den direkt mot pluginens egen källkod, utan något bygge:

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 körmiljömodulen, egenskapsschemat och den HTML som pluginen ska förhandsgranskas mot. Kör npm run dev i pluginens mapp (Vite serverar tests/ som rot, enligt pluginens vite.config.js) för att öppna den.

Biblioteks- och dbs-plugins: ett testskript utan uppkoppling

En plugin vars arbete sker i server.mjs testar sig själv med ett vanligt Node-skript i stället för en webbläsarsandlåda. xuda-library-plugin-xlsx är mönstret att följa: server.mjs exporterar ett internals-objekt med sina rena funktioner (normalize_book, render_book, load_workbook, apply_operations, cell_value_of, ...), och tests/local.mjs importerar { internals } och kör dem direkt, utan drive, utan AI och utan anslutning till plattformen:

run it
npm run test:local

vilket kör node ./tests/local.mjs (se pluginens package.json scripts.test:local). Att skriva den testade logiken som namngivna exporter på internals är det som gör det här möjligt; en server.mjs som håller allt som oexporterade lokala funktioner har inget som ett testskript kan anropa.

plugin_tester/

plugin_tester/ i kodbasens rot är en äldre testare: index.html startar en hel xuda-runtime-slim.js-sida mot markup av typen _default/xu-single-page, och index.js är en jQuery-baserad plugin-körare (func.UI.widgets, $(el), fields_ret = get_fields_data(...)) som anropar ett plugin-API på ppi.xuda.io. Dess form (jQuery, xu-single-page, en slutpunkt på ppi.xuda.io, letar efter runtime/index.js i stället för runtime.mjs) stämmer inte med manifestet, typerna och körmiljösignaturen fn(plugin_name, element, properties) som beskrivs på det här avsnittets andra sidor, och ingen av pluginsen under plugins/@xuda.io/ hänvisar till den. Den ser ut att vara äldre än det nuvarande arbetssättet med plugin-sandbox, snarare än det underhållna sättet att testa en plugin lokalt.