Git est un logiciel de gestion de versions décentralisé. Un logiciel de gestion de versions vous permet de garder plusieurs versions de vos logiciels, ce qui vous permet de revenir à une ancienne version si vous le souhaitez. Il vous permet aussi de développer plusieurs branches, par exemple pour tester une nouvelle fonctionnalité. Il est impensable de ne pas utiliser un logiciel de gestion de versions quand on développe un projet.
Si vous l'associez à GitHub, vous pourrez partager les différentes versions de vos développements avec d'autres personnes et avoir des sauvegardes facilement récupérables.
GitHub permet de partager son code avec d'autres développeurs qui travaillent sur le même projet. Toutes les informations sur les versions de Git sont enregistrées sur GitHub. Pour ce cours, GitHub va permettre à l'enseignant de voir l'avancement de votre travail.
Pour utiliser GitHub, si vous ne l'avez pas déjà fait, il faut vous créer un compte. Allez à https://github.com/.
Créez ensuite un dépôt public sur GitHub pour le projet : allez dans Github et créez un dépôt (clic sur "+" et "New Repository") du même nom que le projet, par exemple tp0Xxxxx (Xxxxx est votre nom). Ecrivez une description du dépôt. Ne créez pas de fichier README, .gitignore ou autre fichier directement dans le dépôt pour éviter des conflits lors du premier push de votre code.
Notez l'URL du dépôt (du type https://github.com/<nom GitHub>/tp0Xxxxx.git). Vous pouvez le retrouver en cliquant sur "Code" et sur "HTTPS".
Il vous faut maintenant un token pour accéder à GitHub depuis un IDE ou une ligne de commande. Si vous avec déjà un tel token, utilisez-le. Sinon, sur le site de GitHub il faut maintenant générer un token :
Vous devez déjà avoir effectué au moins un commit du projet avant d'attacher le dépôt GitHub au projet.
Certains fichiers ne doivent pas être suivis par Git, ni poussés sur GitHub, soit parce qu'ils sont particuliers à chaque développeur, soit parce qu'ils sont générés à chaque build du projet et donc prennent de la place inutilement et ralentissent les opérations.
Le fichier .gitignore indique les modèles des fichiers qui ne seront pas suivis par Git. Pour les modèles, vous pouvez, par exemple, consulter ce site : https://www.atlassian.com/git/tutorials/saving-changes/gitignore. Ce fichier peut déjà être créé à la racine de votre projet (ça dépend de la version de NetBeans ; pour le voir, allez sur l'onglet "Files", à côté de l'onglet "Projects").
Pour un projet Maven, il faut au minimum y mettre cette ligne (target est le répertoire où sont rangés les fichiers créés lors d'un build : classes compilées, fichiers jar, ...) :
/target/
Si votre repository GitHub contient ce répertoire target et que vous n'avez pas de fichier .gitignore, créez ce fichier à la racine du projet .