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 metgetPackageManifest(plugin_name), dus het is watnpm versionopleverde toen de auteur voor het laatstnpm publishdraaide. Depackage.jsonvan elke first-party plug-in heeft hiervoor eenpub-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.versionis wat er in het verzoek is meegestuurd, of0.1.0als 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.
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.