Vai al contenuto
Verificata

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 con getPackageManifest(plugin_name), quindi è ciò che npm version ha prodotto l'ultima volta che l'autore ha eseguito npm publish. Il package.json di ogni plugin proprietario ha uno script pub per 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, oppure 0.1.0 se 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.

Un aggiornamento di codice o npm non rientra mai in revisione

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.