Ugrás a tartalomhoz
Ellenőrizve

Verziószámozás

A bővítmény verziója egyszerű szövegösszehasonlítás a katalógusdokumentum és a projektben telepített változat között, szemver-tartományokat nem használ a rendszer.

A bővítmény verziója két helyen él: a katalógusdokumentum doc.version mezőjében (a legutóbb feltöltött verzió), valamint minden, a bővítményt telepítő projekt app_plugins_purchased[plugin_name].version mezőjében (az a verzió, amely a projektben ténylegesen megvan). Semmi nem tartja ezeket automatikusan szinkronban.

Honnan származik a verzió

Az upload_plugin a doc.version értékét attól függően állítja be, hogy hol található a csomag:

  • npm csomagforrás: közvetlenül a registryből olvassa ki a getPackageManifest(plugin_name) hívással, vagyis az lesz, amit az npm version előállított, amikor a szerző utoljára futtatta az npm publish parancsot. Minden első féltől származó bővítmény package.json fájljában van egy pub szkript erre: npm version patch --force && npm publish --access public.
  • xuda_hosted csomagforrás (nincs npm-publikálás, a munkapéldányt becsomagolja és tárolja maga a platform): a doc.version az, amit a kérésben elküldtek, vagy 0.1.0, ha semmit nem küldtek.

Az install_plugin a telepítés pillanatában átmásolja a doc.version értékét a projekt app_plugins_purchased bejegyzésébe. Egy későbbi upload_plugin, amely megemeli a katalógusdokumentum verzióját, nem érinti azokat a projekteket, amelyek már egy korábbit telepítettek: azok megtartják a telepített verziót, amíg valami az újat rá nem telepíti.

Hogyan jelenik meg az elavult telepítés

Nincs automatikus frissítés. Ami van, az egy vizuális összehasonlítás: a bővítménykártya verziójelvénye összeveti az app_plugins_purchased[plugin_name].version értékét (a telepítettet) a katalógusdokumentum version mezőjével (a legfrissebbel), és a telepített számot zölden jeleníti meg, ha egyeznek, borostyánsárgán, ha nem. Semmi nem kényszeríti az újratelepítést: az újabb verziót az hozza be, ha a tulajdonos (vagy egy telepítő) ugyanabban a projektben ismét lefuttatja az install_plugin hívást, ugyanazt, amelyet az első telepítéskor is használtak.

Saját bővítmény frissítése

A dashboard Frissítés AI-val gombja, amelyet a bővítmény kártyáján a tulajdonosa lát, maga nem emeli meg a verziót. Megnyitja a Kérdezze meg az AI-t asszisztenst előre kitöltve a metadata: { plugin_action: 'modify', plugin_name, widget_type: plugin.plugin_type } értékkel és a bővítményt megnevező üzenettel (updateWithAi() a Tab_plugins.vue fájlban). Ez az AI bővítményépítőt hajtja (ai_module.create_plugin_via_ai, ugyanaz a generátor, amelyet a utils/create_plugin_via_ai.mjs közvetlenül hív), hogy módosítsa a bővítmény kódját és újra feltöltse; a doc.version értékét ez a feltöltés lépteti.

A kód- vagy npm-frissítés sosem kerül újra felülvizsgálatra

Az upload_plugin minden olyan frissítést privát kódmódosításnak tekint, ahol a visibility már 'private', vagy a skip_publish_review be van állítva: a bővítmény meglévő visibility és publish_stat értékét érintetlenül viszi tovább, ahelyett, hogy újra beküldené piactéri felülvizsgálatra. A privátból nyilvánosba váltás kizárólag a publish_plugin, egy különálló, kifejezett művelet; lásd a közzétételt.