Přeskočit na obsah
Ověřeno

Verzování

Verze pluginu se porovnává jako prostý řetězec mezi katalogovým dokumentem a tím, co má projekt nainstalováno. Neexistuje žádné porovnávání rozsahů semver.

Verze pluginu žije na dvou místech: v doc.version na katalogovém dokumentu (poslední nahraná verze) a v app_plugins_purchased[plugin_name].version v každém projektu, který ho nainstaloval (verze, kterou projekt skutečně má). Nic je automaticky nesynchronizuje.

Odkud verze pochází

upload_plugin nastavuje doc.version různě podle toho, kde balíček leží:

  • Zdroj balíčku npm: čte se přímo z registru pomocí getPackageManifest(plugin_name), takže je to to, co vytvořil npm version, když autor naposledy spustil npm publish. Každý vlastní plugin má v package.json skript pub: npm version patch --force && npm publish --access public.
  • Zdroj balíčku xuda_hosted (bez publikování do npm, pracovní kopii zabalí a hostuje sama platforma): doc.version je to, co přišlo v požadavku, nebo 0.1.0, pokud nepřišlo nic.

install_plugin zkopíruje doc.version do záznamu app_plugins_purchased projektu v okamžiku instalace. Pozdější upload_plugin, který zvýší verzi katalogového dokumentu, se nedotkne projektů, které už nainstalovaly starší verzi. Ty si ponechají nainstalovanou verzi, dokud ji něco nepřepíše novou instalací.

Jak se zobrazí zastaralá instalace

Žádná automatická aktualizace neexistuje. Existuje vizuální porovnání: štítek verze na kartě pluginu porovná app_plugins_purchased[plugin_name].version (co je nainstalováno) s version katalogového dokumentu (nejnovější) a nainstalované číslo zobrazí zeleně, když se shodují, a jantarově, když ne. Nic přeinstalování nevynutí. Novější verzi stáhne až to, že vlastník (nebo instalující) znovu spustí install_plugin ve stejném projektu, tedy stejné volání jako při první instalaci.

Aktualizace pluginu, který vlastníte

Tlačítko Aktualizovat pomocí AI v přehledu, které se na kartě pluginu zobrazuje jeho vlastníkovi, samo verzi nezvyšuje. Otevře asistenta Zeptat se AI přednastaveného s metadata: { plugin_action: 'modify', plugin_name, widget_type: plugin.plugin_type } a výzvou jmenující plugin (updateWithAi() v Tab_plugins.vue). Ta řídí AI tvůrce pluginů (ai_module.create_plugin_via_ai, stejný generátor, který volá přímo utils/create_plugin_via_ai.mjs), aby upravil kód pluginu a znovu ho nahrál. Právě toto nahrání posune doc.version.

Aktualizace kódu nebo npm nevstupuje znovu do kontroly

upload_plugin bere každou aktualizaci, kde je visibility už 'private' nebo je nastaveno skip_publish_review, jako soukromou změnu kódu: stávající visibility a publish_stat pluginu přenese beze změny a znovu ho neodešle ke kontrole marketplace. Přechod ze soukromého na veřejný je vždy jen publish_plugin, samostatná, výslovná akce. Viz publikování.