Versioni
La versione di un plugin è un semplice confronto tra stringhe fra il documento di catalogo e ciò che un progetto ha installato, non esiste alcuna corrispondenza a intervalli semver.
La versione di un plugin vive in due posti: doc.version nel documento di catalogo (l'ultima
versione caricata) e app_plugins_purchased[plugin_name].version in ogni progetto che lo ha
installato (la versione che quel progetto ha davvero). Nulla le mantiene sincronizzate in automatico.
Da dove arriva la versione
upload_plugin imposta doc.version in modo diverso a seconda di dove si trova il pacchetto:
- Sorgente del pacchetto
npm: letta direttamente dal registro congetPackageManifest(plugin_name), quindi è ciò chenpm versionha prodotto l'ultima volta che l'autore ha eseguitonpm publish. Ilpackage.jsondi ogni plugin proprietario ha uno scriptpubper questo:npm version patch --force && npm publish --access public. - Sorgente del pacchetto
xuda_hosted(nessuna pubblicazione npm coinvolta, la copia di lavoro viene impacchettata e ospitata dalla piattaforma stessa):doc.versionè ciò che è stato inviato nella richiesta, oppure0.1.0se non è stato inviato nulla.
install_plugin copia doc.version nella voce app_plugins_purchased del progetto al momento
dell'installazione. Un successivo upload_plugin che incrementa la versione del documento di
catalogo non tocca i progetti che hanno già installato una versione precedente: tengono la
versione che hanno installato finché qualcosa non installa quella nuova sopra.
Come viene segnalata un'installazione obsoleta
Non c'è alcun aggiornamento automatico. Esiste un confronto visivo: il badge della versione sulla
scheda del plugin confronta app_plugins_purchased[plugin_name].version (ciò che è installato) con
la version del documento di catalogo (l'ultima), mostrando il numero installato in verde quando
coincidono e in ambra quando non coincidono. Nulla impone la reinstallazione: è il proprietario (o chi
installa) che, rieseguendo install_plugin sullo stesso progetto, porta dentro la versione più
recente, con la stessa chiamata usata per una prima installazione.
Aggiornare un plugin di tua proprietà
Il pulsante Aggiorna con l'AI della dashboard, mostrato al proprietario sulla scheda di un
plugin, non incrementa la versione da solo. Apre l'assistente Chiedi all'AI già impostato con
metadata: { plugin_action: 'modify', plugin_name, widget_type: plugin.plugin_type } e un prompt che
nomina il plugin (updateWithAi() in Tab_plugins.vue), il quale guida il builder di plugin AI
(ai_module.create_plugin_via_ai, lo stesso generatore che chiama direttamente
utils/create_plugin_via_ai.mjs) a modificare il codice del plugin e a ricaricarlo; è quel
caricamento a far avanzare doc.version.
upload_plugin tratta come modifica di codice privata qualsiasi aggiornamento in cui visibility è
già 'private' oppure skip_publish_review è impostato: porta avanti invariati visibility e
publish_stat esistenti del plugin invece di sottoporlo di nuovo alla revisione del marketplace.
Passare da privato a pubblico è sempre e solo publish_plugin, un'azione separata ed esplicita; vedi
pubblicazione.