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:
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:
č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.