Sestavení a testování lokálně
Živý náhled v sandboxu pro pluginy UI a offline testovací vzor pro pluginy library a dbs, oboje spouštěné z vlastní složky pluginu.
Každá složka pluginu pod plugins/@xuda.io/ se sestavuje přes Vite (npm run dev / npm run build
uvnitř vlastního adresáře pluginu) a každý druh má vlastní vzor, jak plugin vyzkoušet,
než se někam nahraje.
Pluginy UI: živý náhled plugin-sandbox
@xuda.io/plugin-sandbox je malý balíček, který vykreslí živý konfigurátor jednoho pluginu UI: rozbalovací
seznam pro každou vlastnost a panel náhledu, který se při změně překresluje. Soubor tests/index.html pluginu UI
ho napojí přímo na zdroj pluginu, bez kroku sestavení:
initializeUiPlugin(el, plugin, properties, previewHtml) bere modul runtime, schéma
vlastností a HTML, proti kterému se plugin zobrazí. Spusťte npm run dev ve složce pluginu
(Vite obsluhuje tests/ jako kořen, podle vite.config.js pluginu) a náhled se otevře.
Pluginy library a dbs: offline testovací skript
Plugin, jehož práce probíhá v server.mjs, se testuje prostým skriptem Node, ne prohlížečovým
sandboxem. xuda-library-plugin-xlsx je vzor, který následovat: server.mjs exportuje objekt
internals se svými čistými funkcemi (normalize_book, render_book, load_workbook,
apply_operations, cell_value_of, ...) a tests/local.mjs importuje { internals } a
přímo je procvičuje, bez disku, bez AI a bez připojení k platformě:
což spustí node ./tests/local.mjs (viz scripts.test:local v package.json pluginu). Zapsat
procvičovanou logiku jako pojmenované exporty v internals je to, co to umožňuje; server.mjs,
který drží vše jako neexportované lokální funkce, nemá nic, co by testovací skript mohl volat.
plugin_tester/
plugin_tester/ v kořeni repozitáře je starší tester: index.html spustí celou stránku
xuda-runtime-slim.js nad značkami _default/xu-single-page a index.js je
spouštěč pluginů založený na jQuery (func.UI.widgets, $(el), fields_ret = get_fields_data(...)),
který volá API pluginů ppi.xuda.io. Jeho tvar (jQuery, xu-single-page, koncový bod ppi.xuda.io,
hledání runtime/index.js místo runtime.mjs) neodpovídá manifestu, druhům a
signatuře runtime fn(plugin_name, element, properties) popsaným na ostatních stránkách této sekce
a žádný z pluginů pod plugins/@xuda.io/ na něj neodkazuje. Vypadá, že předchází
současnému postupu s plugin-sandbox, ne že by byl udržovaným způsobem lokálního testování pluginu.