Gestion des projets avec GIT

L'intégration de GIT dans Studio nécessite la version de la mise à jour redistribuable Microsoft Visual C++ 2015 3 x86. Consultez la page Prérequis logiciels.

Authentification auprès de GIT

Les méthodes d'authentification dans Studio diffèrent selon les méthodes utilisées pour cloner un référentiel GIT, HTTPS ou SSH. Consultez cette page pour voir lequel vous devez utiliser si vous travaillez avec GitHub.

Remarque :

• Les informations d’identification GIT que vous fournissez dans Studio sont stockées dans le gestionnaire des informations d’identification Windows.
• L'intégration GIT (GIT) à Studio ne prend actuellement pas en charge l'authentification à deux facteurs. Pour contourner ce problème, utilisez une méthode d'authentification unique (SSO) avec un jeton personnel ou la méthode d'authentification d'accès de base.

Le guide actuel détaille les étapes d'authentification auprès d'un référentiel GitHub, mais l'intégration de Git dans Studio ne se limite pas à ce seul service.

Sur HTTPS

Lorsque vous clonez un référentiel GIT distant ou copiez le projet en cours dans un référentiel GIT existant à l'aide de HTTPS pour la première fois, vous devez fournir vos identifiants de GIT. Vous devez les entrer dans les champs Utiliser les identifiants (Use Credentials) :

Vous pouvez vous authentifier en utilisant les éléments suivants :

• Nom d'utilisateur et mot de passe dans leurs champs spécifiques ;
• Nom d'utilisateur dans le champ Utilisateur (User), et jeton GIT dans le champ Jeton (Token) ;

Suivez les étapes détaillées sur cette page pour générer un jeton GIT pour votre référentiel GitHub.

Sur SSH

Lorsque vous clonez un référentiel ou copiez le projet en cours dans un référentiel GIT existant à l'aide de SSH pour la première fois, vous avez la possibilité d'utiliser une clé privée :

Ajoutez le chemin de clé privée et le mot de passe, puis cliquez sur Ouvrir pour cloner votre référentiel GIT distant. Consultez les étapes détaillées ici pour générer une clé SSH pour votre référentiel GitHub.

Échec de l'authentification

Sur HTTPS

Si le mot de passe ou le nom d’utilisateur a été mal tapé lors du clonage d’un référentiel GIT en utilisant la méthode HTTPS, la fenêtre Entrer les informations d’identification s’affiche avec le message Échec de l’authentification:

Entrez les informations d’identification Utilisateur (User) et Mot de passe (Password) correctes et réessayez. Vous pouvez par exemple également utiliser Git Bash pour cloner votre référentiel à distance et ainsi vérifier si le nom d’utilisateur et le mot de passe sont corrects.

Sur l’image suivante, nous avons essayé de cloner un référentiel sur HTTPS, mais avons entré un mot de passe incorrect. La fenêtre Git Bash signale que les informations d’identification n'étaient pas les bonnes.

Sur SSH

La fenêtre Saisir les informations d’identification suivante s’affiche lorsque l’authentification échoue sur SSH :

Entrez la clé privée et le mot de passe corrects et réessayez. Vous pouvez également utiliser Git Bash, par exemple, pour cloner votre dépôt à distance et ainsi vérifier si le jeton et/ou le mot de passe sont corrects.

Sur l’image suivante, nous avons essayé de cloner un référentiel sur SSH, mais n’avions pas de clés SSH publiques configurées sur notre compte.

Clonage d'un référentiel GIT distant

1. Dans l'onglet Équipe (Team), sélectionnez Cloner le référentiel (Clone Repository). La fenêtre Cloner un référentiel GIT distant (Clone a remote GIT repository) est affichée.
2. Choisissez Cloner avec HTTPS (Clone with HTTPS) ou Utiliser SSH (Use SSH).
3. Entrez l'URL du référentiel (Repository URL) et choisissez un Répertoire d'extraction (Check out directory) vide.
4. Cochez la case Utiliser les identifiants (Use Credentials) ou Utiliser la clé (Use Key) pour ajouter votre nom d'utilisateur de Git ou Chemin d'accès à la clé privée (Private Key Path), ainsi que le mot de passe.
5. Cliquez sur Ouvrir (Open), Studio ouvre le projet dans le panneau Concepteur (Designer).
6. Dans la fenêtre Ouvrir (Open), sélectionnez un fichier project.json à ouvrir dans Studio.

Après avoir cloné un référentiel GIT dans un répertoire de travail local, le sous-répertoire .git est créé et contient les métadonnées GIT nécessaires. Les métadonnées comprennent des sous-répertoires pour les objets, références et fichiers modèle. En outre, un fichier HEAD est également créé, qui désigne la validation actuellement extraite.

Ajout d'un projet à GIT

La fonctionnalité Init. de GIT (GIT Init) ajoute le projet actuel à un référentiel GIT local. Accédez à la commande de l'onglet Équipe (Team) ou à la barre d'état.

1. Créez ou ouvrez un projet dans Studio. Cliquez sur l'onglet Démarrer (Start) > Équipe (Team). L'onglet Équipe (Team) est affiché.

2. Cliquez sur le bouton Init. de GIT (GIT Init), puis sélectionnez un chemin d'accès où le référentiel doit être initialisé. L'emplacement peut être le même que le projet ou le dossier parent. La fenêtre Valider les modifications (Commit changes) s'ouvre.

   
   

   

   
   
3. La section Fichiers modifiés (Modified Files) affiche les fichiers du projet devant être ajoutés au référentiel Git. Décochez la case en regard de ceux que vous ne souhaitez pas ajouter ou utilisez Sélectionner tout (Select All), Ne rien sélectionner (Select None).

4. Cochez la case Afficher les fichiers sans version pour ajouter des fichiers sans version à la liste.

   Écrivez un Message de validation. Cliquez sur le bouton Valider pour valider les modifications dans le référentiel GIT local.

Lorsqu’un projet est ajouté à GIT, le menu contextuel du panneau Projet comprend des options spécifiques à GIT. Pour plus d’informations, voir Options de menu contextuel pour GIT.

Validation et transmission dans GIT

1. Dans la même fenêtre Valider les modifications (Commit Changes), cliquez sur le bouton Valider et transmettre (Commit and Push) pour valider les modifications et les transmettre au référentiel distant. Cette fenêtre Gérer les référentiels distants (Manage Remotes) est affichée. La fenêtre est également disponible depuis la barre d'état.

   
   

   

   
   
2. Dans la section Nom (Name), ajoutez le nom du référentiel distant.
3. Dans la section URL (URL), ajoutez l'URL distante.

Pour apporter des modifications aux référentiels ajoutés, il suffit de cliquer sur une entrée, de modifier le nom et l'URL, puis de cliquer sur le bouton Mettre à jour (Update). Lorsque vous avez terminé, cliquez sur Ajouter (Add), puis sur Enregistrer (Save). La boîte de message suivante s'ouvre. Cela implique que le référentiel local n'est pas synchronisé avec le distant.

• Cliquez sur le bouton Overwrite remote content (Remplacer le contenu du référentiel distant) pour transmettre les versions locales de fichiers au référentiel distant et remplacer les fichiers à cet emplacement.
• Cliquez sur le bouton Recevoir (rebaser) pour recevoir les fichiers distants et rebaser la branche actuelle.
• Cliquez sur le bouton Annuler (Cancel) pour ignorer toute l'opération.

Le nombre de modifications non poussées et les fichiers nouvellement ajoutés sont visibles dans la barre d'état. Cliquez sur l'icône pour ouvrir la fenêtre Valider les modifications, ou sur l'icône pour transmettre les changements.

Remarque : si vous modifiez un fichier depuis un projet ajouté au contrôle de code source d’un éditeur externe, votre modification sera visible dans le panneau Projet et dans la barre d’état uniquement après avoir cliqué sur Actualiser dans le panneau Projet.

Modification de la dernière validation

L'intégration de Studio à GIT est également fournie avec une option Modifier la validation (Amend Commit) pour modifier la dernière validation effectuée, avant que la transmission ne soit effectuée.

1. Cliquez avec le bouton droit sur un fichier modifié dans le panneau Projet (Project) et sélectionnez Valider (Commit). La fenêtre Valider les modifications (Commit Changes) est affichée.

   
   

   

   
   
2. Sélectionnez la case Modifier la validation. Le dernier message de validation s’affiche, ainsi que les fichiers validés. Pour afficher les modifications entre le fichier actuel et la dernière validation, utilisez l’option Afficher les modifications.
3. Modifiez le message de validation et sélectionnez les fichiers à inclure. Cliquez sur le bouton Valider et transmettre (Commit and Push) ou sur Valider (Commit).

Annulation des modifications en attente

Studio est fourni avec l'option d'annulation des modifications qui ont été apportées aux fichiers avec version, avant de les valider et de les transmettre au référentiel distant.

Après avoir effectué des modifications dans le fichier d'un référentiel local, cliquez sur Annuler (Undo) dans le menu contextuel de GIT pour ouvrir la fenêtre Annuler les modifications en attente (Undo Pending Changes).

Cochez la case en regard des fichiers et cliquez sur Annuler (Undo). Les fichiers sont désormais revenus à l'état avant que les modifications n'aient été effectuées.

Remarque : l'annulation ne couvre pas les fichiers non versionnés. Si vous créez des fichiers, puis sélectionnez Annuler (Undo), les fichiers ne sont pas supprimés du projet. Une fois ajoutés à l'arborescence du projet, les nouveaux fichiers y restent, sauf s'ils sont supprimés manuellement.

Copie d'un projet dans GIT

Le bouton Copier dans GIT (Copy to GIT) en mode Studio Backstage et dans la barre d'état permet de copier le projet actuel dans un référentiel GIT existant.

Pour ce faire, ouvrez ou créez d'abord un projet dans Studio. Dans l'onglet Équipe (Team), sélectionnez Copier dans GIT (Copy to GIT) et choisissez un dossier de référentiel GIT existant sur votre machine. Le projet est ajouté au référentiel GIT local et la boîte de message Copier dans GIT (Copy to GIT) s'ouvre.

• Sélectionnez Oui (Yes) pour ouvrir le projet depuis le nouvel emplacement. La fenêtre Valider les modifications (Commit changes) s'ouvre. Écrivez un Message de validation (Commit message) et cliquez sur Valider et transmettre (Commit and Push) ou simplement sur Valider (Commit).
• Sélectionnez Non (No) pour revenir à l'interface utilisateur de Studio.

Création et gestion de branches

1. Dans le panneau Projet (Project), cliquez avec le bouton droit sur le nœud du projet ou sur le fichier inclus, ou sur l'icône dans la barre d'état et sélectionnez Gérer les branches (Manage Branches). La fenêtre Gérer les branches (Manage Branches) est affichée.

   
   

   

   
   
2. Ajoutez une branche en cliquant sur le bouton . Écrivez un nom pour la branche dans la section Nom (Name). Cliquez sur Ajouter (Add), puis sur Enregistrer (Save). La branche est ajoutée à la liste.

Cliquez avec le bouton droit sur n'importe quelle branche pour afficher les options de branches Git :

• L'option Extraire la branche (Checkout branch) bascule vers la branche sélectionnée.
• L'option Rebaser (Rebase) rebase la branche actuelle sur la branche sélectionnée.
• L'option Fusionner (Merge) fusionne la branche sélectionnée sur la branche actuelle.

Pour fusionner une branche dans le maître d'un référentiel distant GIT, la branche maîtresse doit être extraite dans Studio. Ensuite, vous devez fusionner la branche modifiée dans le maître.

Pour basculer entre les branches, cliquez sur l'icône dans la barre d'état pour ouvrir la liste avec toutes les branches récemment extraites. Cliquez sur un élément pour basculer la branche.

Résolution des conflits

L'intégration de GIT à Studio est fournie avec une fonctionnalité de résolution des conflits qui peuvent survenir lors de l'exécution de la commande Rebase ou Push, disponible dans la fenêtre Valider les modifications (Commit Changes).

Chaque fois que Studio détecte un conflit entre le fichier local et celui trouvé dans le référentiel distant, la fenêtre Résoudre les conflits (Solve conflicts) est affichée.

La fenêtre est similaire à Diff de fichiers (File Diff), indiquant les différences entre la version Distante (Remote) du fichier et la version Locale (Local).

Le tableau suivant décrit les options disponibles dans la fenêtre Résoudre les conflits.

Option	Description
Choisir celui de gauche	Sélectionnez le fichier de gauche représentant celui du référentiel distant à transmettre.
Choisir celui de droite	Sélectionnez le fichier de droite représentant celui du référentiel local à transmettre.
Enregistrer	Cliquez sur Enregistrer après avoir choisi le fichier de gauche ou de droite.
Annuler (Cancel)	Annulez l'opération et quittez la fenêtre Résoudre les conflits (Solve conflicts).
Précédent	Accède à la modification précédente dans les fichiers comparés.
Suivant	Accède à la modification suivante dans les fichiers comparés.
Tout réduire	Réduit tous les nœuds dans les fichiers .xaml.
Tout développer	Développe tous les nœuds dans les fichiers .xaml.

Déconnexion de GIT

Option Déconnecter (Disconnect) du mode Studio Backstage. > L'onglet Équipe (Team) est disponible pour les fichiers avec version dans les deux cas suivants :

1. Un processus est initialisé en tant que référentiel GIT local. Créez un processus, utilisez Initialisation de GIT (GIT Init) pour l'ajouter à un référentiel GIT local, puis utilisez Déconnecter (Disconnect) pour supprimer la balise de sous-version.
2. Vous pouvez supprimer celle-ci en cliquant sur Déconnecter (Disconnect) pour un référentiel GIT qui comprend les projets parent et enfants.
3. Si vous déconnectez un projet enfant, le référentiel GIT entier qui contient le projet ouvert est déconnecté du contrôle de code source. Une boîte de message est affichée dans Studio et nécessite votre confirmation avant que l'action de connexion ne soit effectuée.

Modification de la signature

La modification de la signature de validation dans GIT peut être effectuée depuis l’onglet Équipe > Modifier la signature. Remplissez votre nom et votre adresse e-mail, puis cliquez sur OK.

Utilisation de GIT avec un serveur proxy

L'intégration de GIT dans Studio prend en charge la modification des commandes pour accéder aux référentiels distants si l'accès à Internet se fait via un serveur proxy. Cela peut être fait de deux manières : soit configurée au niveau de la machine dans la fenêtre Paramètres du proxy (Proxy Settings), soit en modifiant les commandes git.

Les détails proxy configurés dans la fenêtre Paramètres Proxy sont pris en compte, sans qu’il soit nécessaire de les saisir dans le fichier .gitconfig.

Pour configurer les détails proxy avec les commandesgit, ajoutez-les aux fichiers de configuration GIT sous la forme suivante :

[http "https://domain.com"] proxy = http://proxyUsername:[e-mail]:port

Les fichiers de configuration GIT se trouvent aux emplacements suivants :

• Fichier config : %ProgramData%\Git
• Fichier .gitconfig : %UserProfile%
• Fichier config local au niveau du projet, par exemple : %UserProfile%\Desktop estproject\.git.