Preskočiť na obsah
Overené

Verzie

Verzia pluginu sa porovnáva ako obyčajný reťazec medzi dokumentom v katalógu a tým, čo má projekt nainštalované, porovnávanie rozsahov semver neexistuje.

Verzia pluginu sa nachádza na dvoch miestach: v doc.version na dokumente v katalógu (najnovšia nahraná verzia) a v app_plugins_purchased[plugin_name].version v každom projekte, ktorý plugin nainštaloval (verzia, ktorú projekt skutočne má). Nič tieto dve hodnoty automaticky nesynchronizuje.

Odkiaľ sa verzia berie

upload_plugin nastavuje doc.version rôzne podľa toho, kde balík leží:

  • Zdroj balíka npm: verzia sa číta priamo z registra cez getPackageManifest(plugin_name), takže je to to, čo vytvoril npm version, keď autor naposledy spustil npm publish. Každý plugin od Xuda má v package.json skript pub, ktorý to robí: npm version patch --force && npm publish --access public.
  • Zdroj balíka xuda_hosted (bez publikovania na npm, pracovná kópia sa zbalí a hostuje priamo platformou): doc.version je to, čo prišlo v požiadavke, alebo 0.1.0, ak nič neprišlo.

install_plugin skopíruje doc.version do záznamu app_plugins_purchased projektu v okamihu inštalácie. Neskoršie upload_plugin, ktoré zvýši verziu dokumentu v katalógu, sa projektov, ktoré už starší plugin nainštalovali, nedotkne. Tie si ponechajú nainštalovanú verziu, kým ju niečo neprepíše novou inštaláciou.

Ako sa zobrazí zastaraná inštalácia

Automatická aktualizácia neexistuje. Existuje len vizuálne porovnanie: odznak verzie na karte pluginu porovnáva app_plugins_purchased[plugin_name].version (nainštalované) s version dokumentu v katalógu (najnovšia) a nainštalované číslo zobrazí zelenou, ak sa zhodujú, a oranžovou, ak nie. Nič nenúti k opätovnej inštalácii. Novšiu verziu stiahne až vlastník (alebo inštalujúci), ktorý znova spustí install_plugin na tom istom projekte, rovnakým volaním ako pri prvej inštalácii.

Aktualizácia pluginu, ktorý vlastníte

Tlačidlo Aktualizovať pomocou AI, ktoré sa vlastníkovi zobrazuje na karte pluginu, samo verziu nezvyšuje. Otvorí asistenta Opýtať sa AI s predvyplneným metadata: { plugin_action: 'modify', plugin_name, widget_type: plugin.plugin_type } a výzvou s názvom pluginu (updateWithAi() v Tab_plugins.vue). Tá spustí AI tvorcu pluginov (ai_module.create_plugin_via_ai, ten istý generátor, ktorý priamo volá utils/create_plugin_via_ai.mjs), ktorý upraví kód pluginu a znova ho nahrá. Až toto nahratie posunie doc.version.

Aktualizácia kódu alebo npm nikdy znova neprechádza kontrolou

upload_plugin považuje každú aktualizáciu, pri ktorej je visibility už 'private' alebo je nastavené skip_publish_review, za súkromnú zmenu kódu: existujúce visibility a publish_stat pluginu prenesie bezo zmeny a neodošle ho znova na kontrolu do marketplace. Prechod zo súkromného na verejný je vždy len publish_plugin, samostatná, výslovná akcia; pozrite si publikovanie.