GitHub Releases: come distribuire un’applicazione Windows Forms

 

In GitHub è possibile associare a un repository uno o più file da distribuire agli utenti, ad esempio un file eseguibile (.exe) oppure un archivio .zip contenente il programma e tutte le librerie necessarie al suo funzionamento.

È consigliabile non inserire questi file direttamente nel repository tramite commit, poiché sono file generati dalla compilazione e non fanno parte del codice sorgente. La sezione Releases è invece progettata proprio per pubblicare le versioni dell'applicazione e mettere a disposizione degli utenti i file da scaricare.

Dopo aver aperto il repository di proprio interesse, selezioniamo la sezione Releases, situata nella parte destra della pagina, sotto la sezione About, come mostrato nella figura 1. 

Figura 1 - La voce Releases

Dopo aver fatto clic su tale voce, verrà aperta una nuova pagina (figura 2), dalla quale sarà possibile inserire le informazioni relative alla nuova release e caricare il file ZIP contenente l'applicazione.

In particolare, saranno disponibili i seguenti campi:

Title, per specificare il nome della release.

Release notes, per inserire una descrizione della versione pubblicata, ad esempio le nuove funzionalità introdotte o le correzioni apportate.

Attach binaries by dropping them here or selecting them, per aggiungere il file ZIP contenente l'applicazione, comprensivo del file eseguibile (.exe), delle librerie (.dll) e degli altri file necessari al corretto funzionamento del programma. È possibile trascinare il file nell'area indicata oppure selezionarlo dal proprio computer.

Figura 2 - La voce releases.

È importante impostare anche il campo Tag, indicando un identificativo della versione, ad esempio v1.0, v1.1 oppure v2.0. Il tag consente di associare la release a una specifica versione del codice sorgente presente nel repository.

Dopo aver compilato tutti i campi, facciamo clic sul pulsante verde Publish release. Al termine dell'operazione verrà visualizzata una pagina di riepilogo contenente tutte le informazioni della release appena pubblicata, compreso il file ZIP allegato, come mostrato nella figura 3.

Figura 3 - La pagina di riepilogo

Ritornando alla pagina principale del repository, nella sezione Releases (figura 4) sarà visibile la release appena pubblicata. Da questa sezione gli utenti potranno consultare le informazioni inserite nelle Release notes e scaricare il file ZIP contenente l'applicazione.

 

Figura 4 - Il file aggiunto alla sezione releases

Conclusioni 

In questo articolo abbiamo visto come pubblicare una release in GitHub e allegare un file ZIP contenente l'applicazione, comprensivo del file eseguibile (.exe), delle librerie (.dll) e degli altri file necessari al suo funzionamento.

La sezione Releases rappresenta il metodo consigliato per distribuire le diverse versioni del programma, consentendo agli utenti di scaricare facilmente i file necessari senza includerli direttamente nel repository del codice sorgente.

Quando possibile, è consigliabile rendere disponibili sia il codice sorgente del progetto sia un pacchetto eseguibile o di installazione, così da soddisfare le esigenze sia degli sviluppatori sia degli utenti finali.