Naar de inhoud springen
Geverifieerd

Versiebeheer

De versie van een plug-in is een gewone stringvergelijking tussen het cataloogdocument en wat een project heeft geïnstalleerd. Er is geen semver-bereikvergelijking.

De versie van een plug-in staat op twee plekken: doc.version in het cataloogdocument (de laatst geüploade versie) en app_plugins_purchased[plugin_name].version bij elk project dat hem heeft geïnstalleerd (de versie die dat project werkelijk heeft). Niets houdt die automatisch gelijk.

Waar de versie vandaan komt

upload_plugin zet doc.version op een andere manier, afhankelijk van waar het pakket staat:

  • Pakketbron npm: rechtstreeks uit het register gelezen met getPackageManifest(plugin_name), dus het is wat npm version opleverde toen de auteur voor het laatst npm publish draaide. De package.json van elke first-party plug-in heeft hiervoor een pub-script: npm version patch --force && npm publish --access public.
  • Pakketbron xuda_hosted (zonder npm publish: de werkkopie wordt ingepakt en door het platform zelf gehost): doc.version is wat er in het verzoek is meegestuurd, of 0.1.0 als er niets is meegestuurd.

install_plugin kopieert doc.version op het moment van installeren naar het app_plugins_purchased-item van het project. Een latere upload_plugin die de versie van het cataloogdocument ophoogt, raakt projecten die een eerdere versie al hebben geïnstalleerd niet aan. Zij houden de versie die ze hebben geïnstalleerd totdat iets de nieuwe versie eroverheen installeert.

Hoe een verouderde installatie zichtbaar wordt

Er is geen automatische update. Wat er wel is, is een visuele vergelijking: het versielabel op de plug-inkaart vergelijkt app_plugins_purchased[plugin_name].version (wat is geïnstalleerd) met de version van het cataloogdocument (de nieuwste). Het geïnstalleerde nummer wordt groen getoond als ze gelijk zijn en oranje als dat niet zo is. Niets dwingt de herinstallatie af: de eigenaar (of een installeerder) die install_plugin opnieuw op hetzelfde project draait, haalt de nieuwere versie binnen, met dezelfde aanroep als bij een eerste installatie.

Een plug-in bijwerken die van jou is

De dashboardknop Update with AI, die de eigenaar op de kaart van een plug-in ziet, verhoogt de versie zelf niet. Hij opent de Vraag-het-AI-assistent (Ask AI), vooraf gevuld met metadata: { plugin_action: 'modify', plugin_name, widget_type: plugin.plugin_type } en een prompt waarin de plug-in wordt genoemd (updateWithAi() in Tab_plugins.vue). Die stuurt de AI-plug-inbouwer aan (ai_module.create_plugin_via_ai, dezelfde generator die utils/create_plugin_via_ai.mjs rechtstreeks aanroept) om de code van de plug-in te bewerken en opnieuw te uploaden. Die upload is wat doc.version ophoogt.

Een code- of npm-update gaat nooit opnieuw door de beoordeling

upload_plugin behandelt elke update waarbij visibility al 'private' is, of waarbij skip_publish_review is gezet, als een privé codewijziging: de bestaande visibility en publish_stat van de plug-in blijven ongewijzigd behouden in plaats van dat hij opnieuw ter beoordeling voor de marketplace wordt ingediend. Van privé naar openbaar gaan kan alleen via publish_plugin, een aparte, expliciete actie. Zie publiceren.