web-dev-qa-db-fra.com

Qu'est-ce qu'une version dans GitHub?

  • C'est quoi exactement?
  • À quoi sert-il?
  • Quelle est l'étendue de l'utilisation?
  • Comment est-il habituellement utilisé?
gitgithubreleasegithub-api
19
Ernst Ernst

De GitHub officiel :

Les versions sont la manière de GitHub d'empaqueter et de fournir des logiciels à vos utilisateurs. Vous pouvez le considérer comme un remplacement de l'utilisation des téléchargements pour fournir des logiciels.

Avec les versions , vous pouvez fournir des liens vers des fichiers binaires, ainsi que des notes de version décrivant vos modifications.

À leur base, Les versions sont basées sur Git tags . Les balises marquent un point spécifique dans l'historique de votre projet, elles sont donc un excellent moyen d'indiquer une version. Les versions sont classées par date de balise de la manière suivante:

  • S'il s'agit d'un tag annoté , la date de l'objet tag est utilisée.
  • Si c'est un balise légère , alors la date de l'objet commit est utilisée.

Pour plus d'informations sur l'affichage de vos balises existantes, consultez tilisation des balises .

17
Ernst Ernst

Je voudrais sauvegarder cette explication officielle de personnes qui l'utilisent déjà pour voir comment cela fonctionne.

Définition

Comme mentionné dans " À propos des versions "

Les versions sont la manière de GitHub d'empaqueter et de fournir des logiciels à vos utilisateurs. Vous pouvez le considérer comme un remplacement de l'utilisation des téléchargements pour fournir des logiciels.

Une version est un conteneur d'un ou plusieurs actifs, associé à une balise annotée git (puisque git Push --follow-tags ne pousse que les balises annotées )

Il remplace depuis juillet 2013 un ancien système "GitHub Download" qui commençait à être abusé (les gens y stockaient tout et n'importe quoi) ) et supprimé en décembre 2012.
En forçant une indirection (tag => release => actif), GitHub a rendu cette fonctionnalité plus gérable.

Usage

Une version GitHub est utilisée:

  • pour éviter de stocker de gros fichiers générés construits à partir du projet dans un système de contrôle source comme git.
  • par les utilisateurs d'un référentiel pour télécharger le "résultat final", c'est-à-dire la "livraison" déjà construite pour eux à partir d'un contenu de référentiel git, même s'ils n'ont pas git.

Exemple

Un exemple de projet utilisant des versions serait git pour les versions Windows .
Dans le cas de git pour Windows , cela est utile étant donné que vous voudrez peut-être installer git en premier lieu, et que vous pourriez ne pas avoir le bon outil -set pour compiler ses sources.

Prise en compte de l'API

Comme l'illustre l'API GitHub V3 Release , une version est pas une balise.
Lorsque vous créez une version , vous aurez besoin du nom d'une balise, mais cela créera une version vide (associée à cette balise)

À partir d'une version, vous pouvez y télécharger un ou plusieurs actifs .

Les données sur les actifs sont attendues sous leur forme binaire brute.

POST https://<upload_url>/repos/:owner/:repo/releases/:id/assets?name=foo.Zip

Remarque: GitLab prend également en charge la "version" depuis GitLab 8.2 (novembre 2015) .

11
VonC