A bővítmény manifestje
Hat fájl, amelyet egy bővítmény szállíthat, mindegyik más belépési pont, és a manifest, amely rögzíti, melyik létezik közülük.
A bővítmény manifestje nem olyan fájl, amelyet Ön ír. A platform számítja ki abban a pillanatban, amikor a bővítményt feltöltik: a validate_plugin() pontosan hat fájlnevet keres a lemezen, rögzíti, melyik létezik (és hogy mindegyiket a csomaggyökérben vagy a dist/ alatt találta-e), és az eredményt doc.manifest néven menti a bővítmény katalógusdokumentumán. Minden további rész, a futtatókörnyezet betöltője, a telepítési hozzájáruló képernyő, az irányítópult beállítási gombja, ezt a manifestet olvassa, nem magát a csomagot vizsgálja.
A hat fájl
A bővítmény azokat szállítja ezek közül, amelyekre a típusának szüksége van. A plugins/@xuda.io/xuda-ui-plugin-moment/src csak az index.mjs és runtime.mjs fájlt tartalmazza; a plugins/@xuda.io/xuda-library-plugin-xlsx az index.mjs és server.mjs fájlt; a plugins/@xuda.io/xuda-dbs-plugin-couchdb az index.mjs és server.mjs fájlt.
Gyökér vagy dist/
A validate_plugin() mindegyik fájlt először a csomaggyökérben keresi, majd a dist/<file> helyen. Bármelyik hely kielégíti a manifestet, így a Vite-tal épített bővítmény (a plugins/@xuda.io/ alatti legtöbb) a forrást a src/ alatt szállítja, és az építése írja a manifestfájlokat a dist/ mappába.
A runtime.css (és bármely más manifest-CSS) csak akkor érvényesül, ha a hozzá tartozó .mjs a dist/ alatt volt megtalálva, a csomaggyökérből soha. A futtatókörnyezet a manifest[resource].dist && manifest[resource].css feltételt ellenőrzi, mielőtt lekérné a stíluslapot, így a gyökérszintű runtime.mjs és gyökérszintű style.css fájlú bővítmény átmegy az érvényesítésen (mindkettőn exist: true), de a futtatókörnyezet sosem tölti be a CSS-t. Ha azt szeretné, hogy a stíluslap ténylegesen betöltődjön, a dist/ mappán keresztül szállítson.
Mire használják a manifestet
- UI bővítmény betöltése. A futtatókörnyezet egyáltalán nem hajt végre UI bővítményt, hacsak a manifest nem mutatja, hogy a
runtime.mjsés azindex.mjsis jelen van; ekkor importálja azindex.mjsfájlt apropertiesértékért, feloldja minden tulajdonság értékét (azxu-exp:kifejezéskötésekkel együtt) az elem attribútumai alapján, importálja aruntime.mjsfájlt, és hívja azfnfüggvényt. - A telepítési hozzájáruló képernyő. A manifest jelenléte közvetlenül azokká a mondatokká alakul, amelyeket a felhasználó a telepítés előtt olvas: a
server.mjsszállítása azt mondja, hogy „Saját kódot futtat a Xuda szervereken, a projektjén belül"; aruntime.mjsszállítása azt, hogy „Saját kódot futtat a publikált alkalmazásán belül, mindenki böngészőjében, aki használja"; astudio.mjsés asetup.mjsis kap saját sort. - Az irányítópult Beállítás gombja. A bővítmény beállítási képernyője csak akkor jelenik meg, ha a
manifest['index.mjs'].existigaz, és ez a modul nem üres, vagy a bővítménynek van függősége saját beállítással.