Modification du code

Pour modifier le code du projet, il faut créer une branche dans laquelle on va enregistrer nos modifications. À la fin du développement, on pourra demander l'intégration dans la branche principale via une demande de fusion.

Création d'une branche

Le plus simple

La méthode la plus simple est d'utiliser gitlab.insa-rouen.fr pour la création de la branche. Pour cela, il suffit de se rendre sur un ticket du projet et de cliquer sur le chevron à droite du bouton bleu: Créer une demande de fusion. On va pouvoir créer une branche (on fera la demande de fusion plus tard) en conservant le nom proposé pour la nouvelle branche et en indiquant comme source main.

Nous pouvons ensuite nous positionner dans cette branche avec:

git pull
git checkout 42-toto

Le mode manuel

Il faut choisir un nom pour cette branche, elle ne doit pas contenir d'espace. On préconise de créer une branche par tâche (en reprenant l'ID sur Gilab). Voici un exemple pour une branche créée pour résoudre la demande "42" concernant de la fonctionnalité "toto". La source de toutes les branches doit être la branche main.

git branch main
git checkout -b 42-toto

On va également envoyer cette branche sur le serveur gitlab:

git push --set-upstream origin 42-toto

À partir de maintenant, tous les modifications que vous ferez seront enregistrées dans cette nouvelle branche.

Modification

Vous pouvez faire maintenant toutes les modifications souhaitées. Au niveau des messages de commit, veiller à respecter les conventions de commit

Fin des modifications

Avant d'envoyer vos modifications, il faut vérifier que les tests se déroulent correctement:

./oto.sh test

Il faut vérifier que toutes vos modifications sont bien enregistrées:

git status

Puis envoyer vos modifications vers le serveur gitlab:

git push

Demande de fusion

Si l'étape précédente s'est déroulée sans erreur, vous allez pouvoir demander la fusion de vos modifications dans la branche de développement. Il vous reste à faire la demande de fusion de votre branche avec la branche principale (dev) via l'interface web gitlab.insa-rouen.fr en utilisant le bouton Demande de fusion. Par défaut, la branche sera supprimée après la fusion faite.

Après la fusion, vous pouvez resynchroniser votre dépot avec le dépot du serveur:

git pull

===== Retour sur la branche par défaut ===== Vous pouvez revenir à la branche dev avec la commande:

git checkout dev

Vous pouvez également voir la liste des branches:

git branch

Et supprimer une branche (si besoin):

git branch -d 42-toto

Resynchronisation avec la branche dev

Si besoin, vous pouvez resynchroniser (merge) votre branche avec la dernière version de la branche de développement (dev):

git checkout dev
git pull
git checkout 42-toto
git merge dev