Preskočiť na obsah
Overené

Zostavenie a lokálne testovanie

Živý náhľad v sandboxe pre pluginy UI a offline vzor testovania pre pluginy library a dbs, oboje spúšťané z vlastného priečinka pluginu.

Každý priečinok pluginu pod plugins/@xuda.io/ sa zostavuje cez Vite (npm run dev / npm run build vo vlastnom adresári pluginu) a každý druh má vlastný vzor na vyskúšanie pluginu skôr, než sa niekam nahrá.

UI plugins: the plugin-sandbox live preview

@xuda.io/plugin-sandbox je malý balík, ktorý vykresľuje živý konfigurátor pre jeden plugin UI: rozbaľovací zoznam pre každú vlastnosť a panel náhľadu, ktorý sa pri zmene prekresľuje. tests/index.html pluginu UI ho zapojí priamo proti vlastnému zdroju pluginu, bez kroku zostavenia:

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) berie modul runtime, schému vlastností a HTML, voči ktorému sa plugin zobrazí. Spustite npm run dev v priečinku pluginu (Vite obsluhuje tests/ ako koreň podľa vite.config.js pluginu) a otvorí sa.

Library and dbs plugins: an offline test script

Plugin, ktorého práca prebieha v server.mjs, sa testuje obyčajným skriptom Node, nie sandboxom v prehliadači. xuda-library-plugin-xlsx je vzor, ktorý treba nasledovať: server.mjs exportuje objekt internals so svojimi čistými funkciami (normalize_book, render_book, load_workbook, apply_operations, cell_value_of, ...) a tests/local.mjs importuje { internals } a priamo ich vyskúša, bez drive, bez AI, bez pripojenia k platforme:

run it
npm run test:local

čo spúšťa node ./tests/local.mjs (pozri scripts.test:local v package.json pluginu). Napísanie testovanej logiky ako pomenovaných exportov v internals je to, čo to umožňuje; server.mjs, ktorý všetko drží ako neexportované lokálne funkcie, nemá nič, čo by testovací skript mohol volať.

plugin_tester/

plugin_tester/ v koreni repozitára je starší tester: index.html zavedie celú stránku xuda-runtime-slim.js voči značkovaniu _default/xu-single-page a index.js je bežec pluginov založený na jQuery (func.UI.widgets, $(el), fields_ret = get_fields_data(...)), ktorý volá API pluginov ppi.xuda.io. Jeho tvar (jQuery, xu-single-page, koncový bod ppi.xuda.io, hľadanie runtime/index.js namiesto runtime.mjs) nezodpovedá manifestu, druhom a signatúre runtime fn(plugin_name, element, properties) zdokumentovaným na ostatných stránkach tejto sekcie a žiadny z pluginov pod plugins/@xuda.io/ naň neodkazuje. Vyzerá to, že predchádza súčasnému pracovnému postupu s plugin-sandbox, a nie je udržiavaným spôsobom lokálneho testovania pluginu.