Créer et gérer des versions

La fonctionnalité Publications de GitHub vous aide à regrouper et à fournir aux utilisateurs des versions stables de votre logiciel. Considérez-la comme l’annonce officielle d’une nouvelle version.

Elle est essentielle pour les projets qui doivent distribuer des fichiers binaires compilés, de la documentation ou des instantanés précis du code source.

Chaque publication GitHub est directement associée à une balise Git. Une balise marque un point précis de l’historique de votre dépôt, généralement un numéro de version comme v1.0.0.

• Les balises fournissent une référence permanente et immuable vers une validation.
• Les publications ajoutent à cette balise des métadonnées détaillées, comme les notes de publication et les fichiers associés.

Avant de créer une publication, vérifiez que vous avez envoyé la balise souhaitée vers GitHub !

Les notes de publication décrivent ce qui est nouveau, amélioré ou corrigé dans une version donnée. Elles sont essentielles pour communiquer les changements à vos utilisateurs.

• Utilisez un langage clair et concis.
• Mettez en avant les fonctionnalités importantes et les corrections de bogues.
• La mise en forme Markdown est prise en charge pour produire du texte enrichi.

Les fichiers associés à une publication sont des fichiers que vous pouvez joindre à une publication afin de les rendre disponibles au téléchargement. Il peut s’agir de :

• Fichiers binaires compilés (par exemple, .exe, .dmg)
• Code source compressé (.zip, .tar.gz)
• Fichiers de documentation ou programmes d’installation

Ils fournissent au même endroit tout ce dont les utilisateurs ont besoin pour cette version précise.

Pour créer une publication :

1. Accédez à votre dépôt sur GitHub.
2. Cliquez sur « Publications » (souvent dans la barre latérale droite ou sous l’onglet « Code »).
3. Cliquez sur le bouton « Rédiger une nouvelle publication ».

Un formulaire s’ouvre pour vous permettre de définir les détails de votre publication.

Sur la page de création de la publication, vous allez :

• Choisir une balise Git existante ou en créer une nouvelle.
• Fournir un titre de publication (par exemple, « Version 1.0.0 - Publication initiale »).
• Rédiger vos notes de publication détaillées.

Vous pouvez la marquer comme « prépublication » (pour les tests) ou la publier directement.

GitHub peut vous aider à générer automatiquement les notes de publication !

En cliquant sur « Générer les notes de publication », GitHub analyse les validations et les demandes d’extraction fusionnées depuis la dernière balise de publication, puis propose un résumé. Vous pouvez ensuite le modifier et le perfectionner.

Une fois vos notes de publication prêtes, vous pouvez téléverser des fichiers associés.

Faites simplement glisser les fichiers dans la zone prévue à cet effet ou cliquez pour les parcourir. GitHub les téléversera et ils apparaîtront comme des fichiers téléchargeables sur la page de votre publication.

Les erreurs arrivent ! Vous pouvez toujours modifier ou supprimer une publication.

• Sur la page « Publications », recherchez la publication que vous souhaitez modifier.
• Cliquez sur l’icône en forme de crayon pour la modifier ou sur l’icône de corbeille pour la supprimer.

La modification vous permet de changer les notes, le titre ou les fichiers associés. La suppression retire la publication de GitHub, mais la balise Git sous-jacente demeure.

Lesquels des éléments ou caractéristiques suivants sont essentiels pour une publication GitHub ?

Vous avez appris à créer et à gérer des publications GitHub !

• Les publications fournissent des instantanés officiels et versionnés de votre projet.
• Elles reposent sur des balises Git et incluent des notes de publication ainsi que des fichiers associés facultatifs.
• Vous pouvez créer, modifier et supprimer des publications depuis l’interface GitHub.

Cela aide les utilisateurs à trouver et à télécharger facilement les versions stables de votre logiciel.