Le site GitHub permet héberger des projets de développement en gérant différentes versions des projets, permettant ainsi le travail collaboratif.

Pour cette activité, vous allez utiliser GitHub comme un outil de revue de code afin de faire remonter des propositions de corrections qui pourront être acceptées ou non.

La première étape consiste à installer l'extension de GitHub sous Visual Studio.

Normalement l'extension est déjà proposée dans Visual Studio et il suffit de l'installer. Pour cela :

• ouvrez Visual Studio ;
• allez dans le menu Extensions > Gérer les extensions.
• Dans la fenêtre qui s'ouvre, partie gauche, sélectionnez En ligne (normalement sélectionné par défaut).
• Au centre, vous devriez voir (à priori en premier), GitHub Extension for Visual Studio (dans le cas où elle n'apparaît pas, utilisez la méthode suivante depuis le site ).

• Cliquez sur Télécharger.

En bas de la fenêtre, vous allez obtenir le message Vos changements vont être planifiés. Les modifications commenceront quand toutes les fenêtres Microsoft Visual Studio seront fermées..

• Cliquez sur Fermer puis fermez Visual Studio. Le programme VSIX Installer va se lancer pour installer l'extension.
  • Cliquez sur Modify pour accepter les termes de la linec et instaler l'extension Github.

Si au lancement de Visual Studio, une fenêtre s'ouvre, proposant la ou les versions Visual Studio installées, laissez tout coché et cliquez sur Install.

Vous allez tester l'extension Github avec le projet Calculs que vous avez corrigé dans l'activité 1.

• Affichez l'onglet qui permet de gérer le travail en équipe avec le menu Affichage > Team Explorer.

L'onglet apparaît à droite. Deux options sont proposées : Azure DevOPs et GitHub.

• sélectionnez la 2ème option GitHub ;
• Cliquez sur Connecter.

Dans la fenêtre qui s'ouvre, vous allez créer votre compet Github (à moins que vous n'en avoir déjà un compte Github) :

• cliquez sur s'inscrire, tout en bas de la fenêtre.

• Dans le navigateur, vous êtes redirigé vers le site GitHub avec en haut, le menu suivant :

• Cliquez sur Team puis, dans la nouvelle page, cliquez sur Sign up for free.
• Sur la page d'inscription, entrez vos informations (en les notant pour ne pas les oublier) :
  • le Username est libre mais ne doit pas déjà être pris (un message vous signale si le username est accepté.
  • Cliquez ensuite sur Vérifier et résolvez l'énigme anti-robot pour avoir ensuite accès au bouton create account.
  • Cliquez alors sur ce bouton.

Vous allez alors recevoir un mail pour contrôler votre adresse mail. Pensez à cliquer dans le mail, sur Verify email address.

Votre compte Github est maintenant créé.

• Revenez dans le logiciel Visual Studio, au niveau de la fenêtre GitHub,
• maintenant vous pouvez cliquer sur Se connecter avec votre navigateur. Dans le navigateur, vous allez tomber sur cette page.
• Cliquez sur Authorize github. Vous avez reçu un mail dans lequel vous devez cliquer sur Verify email adress qui va rediriger vers GitHub. Vous pouvez cliquer sur l'icône de GitHub, en haut à gauche, pour arriver à votre page d'accueil du compte.

De retour dans Visual Studio, allez cette fois dans l'onglet Modification Git (s'il n'est pas présent, affichez le avec le menu Affichage > Modification Git).

• Cliquez sur Créer un dépôt Git.
• Vous obtenez la fenêtre suivante :

Il y a aussi la partie Créer un dépôt GitHub qui contient déjà le nom de votre compte ainsi que le nom du propriétaire (à priori le même).

Le nom du dépôt est prérempli avec le nom du projet : laissez ce nom. Vous pouvez si vous voulez ajouter une description.

• Décochez la case Dépôt privé et cliquez sur Créer et envoyer (push).

Si vous avez le message vous demandant de configurer votre compte, cliquez sur le lien pour renseigner votre nom et adresse de courriel :

• Revenez à l'onglet Team Explorer et cliquez sur la maison pour aller à l'accueil.
• Remarquez en bas de l'onglet, différentes commandes (dont Requêtes de tirage qui sera utilisé plus tard) et en milieu d'onglet, le lien pour aller sur le dépôt (repository) sur GitHub. Cliquez sur le lien.
• Vous accédez maintenant au site Github et vous voyez dépôt créé :

Le projet a bien été transféré. Remarquez les informations mentionnées dans la barre au-dessus des fichiers :

• 2 commits : 2 transferts ont été réalisés (si vous cliquez dessus, vous verrez qu'en fait, cela concerne le projet et les fichiers spécifiques à git).
• 1 branch : pour le moment il n'y a que la branche “master” qui est la branche principale. Vous verrez que pour proposer des correctifs, on travaillera sur une autre branche dans laquelle le projet sera copié, et ce n'est que si les correctifs conviennent, qu'ils seront intégrés (merge) à la branche “master”.

• Prenez connaissance de l'URL de votre projet que vous pouvez communiquer à un autre développeur afin que celui-ci puisse télécharger le code de votre projet :

• Pour récupérer le projet d'un autre développeur déposé sur GitHub, il faut récupérer l'adresse du dépôt en ligne.
• Dans Visual Studio, fermez le projet en cours, avec le menu Fichier > Fermer la solution.
• Vous retrouvez la fenêtre qui permet d'ouvrir un projet ou d'en créer un.
• Sélectionnez Cloner un dépôt.
• Dans la zone de l'emplacement du dépôt, collez l'adresse que vous avez récupérée. Elle doit forcément se terminer par .git. La zone du chemin local se remplit automatiquement mais attention, l'idée est d'enregistrer le clone dans un autre dossier que le projet d'origine. Donc pensez à changer le chemin.
• Ensuite, cliquez sur Cloner.
• Si vous n'êtes pas dans l'onglet “Explorateur de solutions”, cliquez dessus.
• Cliquez sur le bouton (encadré en rouge) Passer entre les solutions et les vues disponibles.
• Vous retrouvez le projet qui a été cloné.
• Double cliquez sur Calculs.sln pour ouvrir la solution.
• Vous retrouvez l'arborescence classique d'un projet.
• Ouvrez Program.cs en double cliquant dessus.
• Le code apparait dans la fenêtre principale.