Creazione e gestione delle release

La funzionalità Releases di GitHub aiuta a preparare e fornire agli utenti versioni stabili del software. La si può considerare come un annuncio ufficiale di una nuova versione.

È fondamentale per i progetti che devono distribuire binari compilati, documentazione o snapshot specifici del codice sorgente.

Ogni Release di GitHub è direttamente associata a un tag Git. Un tag contrassegna un punto specifico nella cronologia del repository, in genere un numero di versione come v1.0.0.

• I tag forniscono un riferimento permanente e immutabile a un commit.
• Le release aggiungono metadati dettagliati (come note di rilascio e asset) a questo tag.

Prima di creare una release, verifichi di aver eseguito il push su GitHub del tag desiderato!

Le note di rilascio sono descrizioni che spiegano cosa è stato aggiunto, migliorato o corretto in una versione specifica. Sono fondamentali per comunicare le modifiche agli utenti.

• Utilizzi un linguaggio chiaro e conciso.
• Evidenzi le funzionalità principali e le correzioni dei bug.
• La formattazione Markdown è supportata per il testo avanzato.

Gli asset della release sono file che può allegare a una release, rendendoli disponibili per il download. Possono includere:

• Binari compilati (ad es. .exe, .dmg)
• Codice sorgente compresso (.zip, .tar.gz)
• File di documentazione o installer

Riuniscono in un unico luogo tutto ciò di cui gli utenti hanno bisogno per quella specifica versione.

Per creare una release:

1. Acceda al repository su GitHub.
2. Faccia clic su 'Releases' (spesso nella barra laterale destra o nella scheda 'Code').
3. Faccia clic sul pulsante 'Draft a new release'.

Si aprirà un modulo in cui definire i dettagli della release.

Nella pagina di creazione della release:

• Scelga un tag Git esistente oppure ne crei uno nuovo.
• Fornisca un titolo della release (ad es. 'Version 1.0.0 - Initial Release').
• Scriva le note di rilascio dettagliate.

Può contrassegnarla come 'pre-release' (per i test) oppure pubblicarla direttamente.

GitHub può aiutarla a generare automaticamente le note di rilascio!

Facendo clic su 'Generate release notes', GitHub analizzerà i commit e le pull request unite dall'ultimo tag di release e suggerirà un riepilogo. Potrà quindi modificarlo e perfezionarlo.

Quando le note di rilascio sono pronte, può caricare gli asset.

Trascini semplicemente i file nell'area dedicata oppure faccia clic per cercarli. GitHub li caricherà e appariranno come file scaricabili nella pagina della release.

Gli errori possono capitare! Può sempre modificare o eliminare una release.

• Nella pagina 'Releases', trovi la release che desidera modificare.
• Faccia clic sull'icona a forma di matita per modificare oppure sull'icona del cestino per eliminare.

La modifica consente di cambiare le note, il titolo o gli asset. L'eliminazione rimuove la release da GitHub, ma il tag Git sottostante rimane.

Quali delle seguenti sono componenti o caratteristiche essenziali di una Release di GitHub?

Ha imparato a creare e gestire le Releases di GitHub!

• Le release forniscono snapshot formali e versionati del progetto.
• Si basano sui tag Git e includono note di rilascio e asset opzionali.
• È possibile creare, modificare ed eliminare le release tramite l'interfaccia utente di GitHub.

Questo aiuta gli utenti a trovare e scaricare facilmente versioni stabili del software.