Siirry sisältöön
Tarkistettu

Lisäosan manifesti

Kuusi tiedostoa, jotka lisäosa voi toimittaa, kukin eri sisääntulopiste, sekä manifesti, joka kirjaa, mitkä niistä ovat olemassa.

Lisäosan manifesti ei ole tiedosto, jonka kirjoitat. Alusta laskee sen hetkellä, kun lisäosa ladataan: validate_plugin() etsii levyltä täsmälleen kuutta tiedostonimeä, kirjaa, mitkä niistä ovat olemassa (ja löytyikö kukin paketin juuresta vai kansiosta dist/) ja tallentaa tuloksen doc.manifest:ksi lisäosan katalogidokumenttiin. Kaikki sen jälkeen, ajonaikainen lataaja, asennuksen suostumusnäkymä ja koontinäytön asetuspainike, lukee tuota manifestia sen sijaan, että tutkisi pakettia itse.

Kuusi tiedostoa

Lisäosa toimittaa niistä sen, mitä sen tyyppi tarvitsee. plugins/@xuda.io/xuda-ui-plugin-moment/src sisältää vain index.mjs:n ja runtime.mjs:n; plugins/@xuda.io/xuda-library-plugin-xlsx sisältää index.mjs:n ja server.mjs:n; plugins/@xuda.io/xuda-dbs-plugin-couchdb sisältää index.mjs:n ja server.mjs:n.

Juuri vai dist/

validate_plugin() etsii kunkin tiedoston ensin paketin juuresta, sitten kohdasta dist/<file>. Kumpi tahansa sijainti täyttää manifestin, joten Vitellä rakennettu lisäosa (useimmat plugins/@xuda.io/-kansion lisäosat) toimittaa lähdekoodin kansiossa src/ ja antaa rakennuksen kirjoittaa manifestitiedostot kansioon dist/.

CSS latautuu vain dist-kansiosta

runtime.css (ja mikä tahansa muu manifestin CSS) poimitaan vain, kun sitä vastaava .mjs löytyi kansiosta dist/, ei koskaan paketin juuresta. Ajonaikainen ympäristö tarkistaa manifest[resource].dist && manifest[resource].css ennen tyylitiedoston hakemista, joten lisäosa, jolla on juuritason runtime.mjs ja juuritason style.css, läpäisee validoinnin (exist: true molemmilla), mutta ajonaikainen ympäristö ei koskaan lataa CSS:ää. Toimita dist/-kansion kautta, jos lisäosan tyylitiedoston on oikeasti latauduttava.

Mihin manifestia käytetään

  • UI-lisäosan lataaminen. Ajonaikainen ympäristö kieltäytyy ajamasta UI-lisäosaa lainkaan, ellei manifesti osoita sekä runtime.mjs:n että index.mjs:n olevan paikalla; sitten se tuo index.mjs:n properties:a varten, ratkaisee jokaisen ominaisuuden arvon (mukaan lukien xu-exp:-lausekesidonnat) elementin attribuutteja vasten, tuo runtime.mjs:n ja kutsuu fn:ää.
  • Asennuksen suostumusnäkymä. Manifestin sisältö muuttuu suoraan lauseiksi, jotka käyttäjä lukee ennen asennusta: server.mjs:n toimittaminen sanoo "Runs its own code on Xuda servers, inside your project"; runtime.mjs:n toimittaminen sanoo "Runs its own code inside your published app, in the browser of everyone who uses it"; studio.mjs ja setup.mjs saavat myös omat rivinsä.
  • Koontinäytön Asetukset-painike. Lisäosan asetusnäkymä näkyy vain, kun manifest['index.mjs'].exist on tosi ja kyseinen moduuli ei ole tyhjä, tai kun lisäosalla on riippuvuus, jolla on oma asetuksensa.