Rakenna ja testaa paikallisesti
Live-esikatseluhiekkalaatikko UI-lisäosille ja offline-testimalli kirjasto- ja dbs-lisäosille, molemmat ajetaan lisäosan omasta kansiosta.
Jokainen plugins/@xuda.io/-kansion lisäosakansio rakentuu Vitellä (npm run dev / npm run build lisäosan omassa kansiossa), ja jokaisella tyypillä on oma mallinsa lisäosan kokeilemiseen ennen kuin se ladataan mihinkään.
UI-lisäosat: plugin-sandboxin live-esikatselu
@xuda.io/plugin-sandbox on pieni paketti, joka renderöi live-konfiguraattorin yhdelle UI-lisäosalle: pudotusvalikko jokaiselle ominaisuudelle ja esikatselualue, joka renderöityy uudelleen muutosten myötä. UI-lisäosan tests/index.html kytkee sen suoraan lisäosan omaan lähdekoodiin, ilman rakennusvaihetta:
initializeUiPlugin(el, plugin, properties, previewHtml) ottaa ajonaikaisen moduulin, ominaisuusskeeman ja HTML:n, jota vasten lisäosaa esikatsellaan. Aja npm run dev lisäosan kansiossa (Vite palvelee tests/-kansiota juurena lisäosan vite.config.js:n mukaan) avataksesi sen.
Kirjasto- ja dbs-lisäosat: offline-testiskripti
Lisäosa, jonka työ tapahtuu tiedostossa server.mjs, testaa itsensä tavallisella Node-skriptillä selaimen hiekkalaatikon sijaan. xuda-library-plugin-xlsx on malli, jota seurata: server.mjs vie internals-objektin puhtaine funktioineen (normalize_book, render_book, load_workbook, apply_operations, cell_value_of, ...), ja tests/local.mjs tuo { internals }:n ja käyttää niitä suoraan, ilman drivea, tekoälyä tai alustayhteyttä:
mikä ajaa node ./tests/local.mjs (katso lisäosan package.json scripts.test:local). Testattavan logiikan kirjoittaminen nimettyinä vienteinä internals:iin tekee tämän mahdolliseksi; server.mjs, joka pitää kaiken viemättöminä paikallisina funktioina, ei tarjoa testiskriptille mitään kutsuttavaa.
plugin_tester/
Repon juuren plugin_tester/ on vanhempi testaaja: index.html käynnistää täyden xuda-runtime-slim.js-sivun _default/xu-single-page-merkintää vasten, ja index.js on jQuery-pohjainen lisäosa-ajaja (func.UI.widgets, $(el), fields_ret = get_fields_data(...)), joka kutsuu ppi.xuda.io-lisäosa-API:a. Sen muoto (jQuery, xu-single-page, ppi.xuda.io-päätepiste, haku tiedostoa runtime/index.js eikä runtime.mjs) ei vastaa tämän osion muilla sivuilla dokumentoitua manifestia, tyyppejä ja fn(plugin_name, element, properties) -ajonaikaista allekirjoitusta, eikä mikään plugins/@xuda.io/-kansion lisäosa viittaa siihen. Se vaikuttaa edeltävän nykyistä plugin-sandbox-työnkulkua eikä olevan ylläpidetty tapa testata lisäosaa paikallisesti.