Ugrás a tartalomhoz
Ellenőrizve

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 CSS csak a dist mappából töltődik be

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 az index.mjs is jelen van; ekkor importálja az index.mjs fájlt a properties értékért, feloldja minden tulajdonság értékét (az xu-exp: kifejezéskötésekkel együtt) az elem attribútumai alapján, importálja a runtime.mjs fájlt, és hívja az fn fü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.mjs szállítása azt mondja, hogy „Saját kódot futtat a Xuda szervereken, a projektjén belül"; a runtime.mjs szá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"; a studio.mjs és a setup.mjs is 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'].exist igaz, és ez a modul nem üres, vagy a bővítménynek van függősége saját beállítással.