dart pub publish su pub.dev

Quando il package è pronto, un solo comando lo invia al mondo. La pubblicazione rende la libreria disponibile su pub.dev, così chiunque può usarla come dipendenza. 🌍

Si imposta una versione chiara in pubspec.yaml seguendo il versionamento semantico. I numeri di major, minor e patch indicano agli utenti esattamente l'entità delle modifiche.

Ogni release richiede una voce corrispondente nel proprio CHANGELOG. Gli utenti lo leggono per decidere se e come eseguire l'upgrade, quindi è bene descrivere chiaramente le modifiche.

Un package pubblicato deve includere un file LICENSE. Questo indica i diritti legali degli utenti e pub.dev riconosce automaticamente le licenze open source più comuni.

Si esegue publish con il flag dry-run per convalidare tutto senza caricare nulla. In questo modo vengono segnalati file mancanti o avvisi quando correggerli è ancora semplice.

La prima pubblicazione apre un browser per eseguire l'accesso. pub.dev associa il caricamento al proprio account, a cui in seguito è possibile aggiungere altri utenti autorizzati al caricamento.

Quando la simulazione non rileva problemi, si rimuove il flag per procedere alla pubblicazione. Il comando publish carica i file e rende disponibile la versione nel giro di pochi secondi.

Una volta pubblicata, una versione non può essere eliminata: può solo essere ritirata per scoraggiarne il nuovo utilizzo. Controlli attentamente i file, perché un errore rimane nella cronologia.

Tenga segreti e file superflui fuori dal caricamento. Dart ignora i file corrispondenti al suo .gitignore, quindi una buona gestione dei commit mantiene pulito l'archivio pubblicato.

Pubblichi con un publisher verificato associato a un dominio di sua proprietà. Il badge rafforza la fiducia e raggruppa tutti i suoi pacchetti sotto un'unica identità. 🛡️

Per ogni aggiornamento, incrementi la versione, aggiunga una voce al CHANGELOG, esegua nuovamente i controlli e poi pubblichi di nuovo. Lo stesso ciclo senza intoppi si ripete per tutta la vita.

Qual è il primo passaggio sicuro da eseguire prima di caricare effettivamente il pacchetto?

Ha imparato a gestire la versione, creare il changelog, aggiungere una licenza, eseguire un dry-run e infine eseguire dart pub publish. Il suo pacchetto ora fa parte dell'ecosistema. 🎉