Le panneau de contrôle de code source

Le panneau Contrôle de code source fournit un workflow Git complet dans Studio. Le panneau est disponible chaque fois qu'un projet qui appartient à un référentiel Git est ouvert. Il est ancré à la gauche du concepteur avec d'autres panneaux (Explorer, Activities, Snippets, etc.).

Le panneau Contrôle de code source fonctionne uniquement avec les référentiels Git. Les projets gérés avec TFS et SVN sont toujours gérés à partir de l'onglet Équipe en arrière-plan.

La première fois que vous ouvrez le panneau, vous êtes invité à initialiser un référentiel Git local. Cette étape est obligatoire et est effectuée automatiquement en sélectionnant le bouton Initialiser le référentiel.

Le panneau contient deux sections distinctes :

1. Modifications : répertorie tous les fichiers qui ont été modifiés, ajoutés, supprimés ou renommés dans l'arborescence de travail et héberge les contrôles de validation.
2. Graphique : affiche l'historique de validation du référentiel sous forme de graphique visuel interactif.

En cliquant sur chaque en-tête de section, vous réduisez ou développez la section correspondante. Lorsqu’une section est réduite, son en-tête affiche le nombre d’éléments qu’elle contient, ce qui vous permet de surveiller l’activité en un coup d’œil.

La section Modifications

La section Modifications répertorie toutes les modifications de fichier en attente, séparées en groupes indexés et non indexés.

Chaque entrée de fichier comporte une lettre de statut codée en couleur (M - modifié, A - ajouté, S - supprimé, R - renommé, N - non suivi).

Passez la souris sur un fichier ou cliquez avec le bouton droit pour accéder aux options spécifiques au fichier :

• Ouvrez Fichier pour ouvrir le fichier dans le panneau Concepteur.
• Ignorer les modifications pour rétablir le fichier à son dernier état confirmé.
• Indexer ou désindexer.
• Ajoutez à .gitignore pour exclure le fichier du suivi futur.
• Révélez dans l'Explorateur de fichiers pour ouvrir l'emplacement du fichier sur votre machine.
• Révélez dans la vue Explorateur pour ouvrir le panneau Explorateur.

Utilisez le champ Message pour écrire votre message de validation. Après avoir écrit votre message, sélectionnez Valider ou utilisez le raccourci clavier CTRL + Entrée. Si aucun fichier n’est explicitement indexé lorsque vous validez, toutes les modifications sont automatiquement indexées.

Sélectionnez la flèche à côté du bouton Valider pour accéder à plus d'options :

• Valider : valide les modifications indexées localement.
• Valider (modifier) : ajoute les modifications indexées à la validation la plus récente.
• Valider et transmettre : valide puis transmet vers la branche distante.
• Valider et synchroniser : valide les modifications indexées, puis effectue un pull et un push pour synchroniser avec la branche distante.

Sélectionnez le bouton Actualiser en haut de la section Modifications pour recharger la section.

Vous pouvez également sélectionner le bouton Plus d'options pour :

• Accédez aux opérations Pull, Push et Récupérer tous les dépôts distants.
• Indexez toutes les modifications.
• Ouvrez la fenêtre Gérer les branches.

Un badge d'avance/retard à côté du nom de la branche dans la barre d'outils affiche le nombre de validations que votre branche locale a d'avance ou de retard sur la branche de suivi à distance.

La section Graphique

La section Graphique affiche l'historique de validation de votre référentiel sous forme de graphique visuel multi-voies. La section affiche jusqu'à 200 validations, avec des libellés de branche et de balise, des lignes de branche codées en couleur et des courbes de Bézier pour illustrer les connexions de fusion.

Sélectionnez le bouton Filtre de branche pour basculer entre les validations à afficher :

• Automatique : validations sur la branche actuelle.
• Tous : validations sur toutes les branches.
• Valide uniquement sur une branche spécifique.

Des boutons distincts vous permettent d’accéder à des fonctions telles que :

• Récupérer tous les dépôts distants : télécharge les modifications distantes sans les fusionner.
• Pull : télécharge et fusionne les modifications distantes dans la branche actuelle.
• Push : charge les modifications locales confirmées vers la branche distante.

Vous pouvez également actualiser la section à partir du bouton dédié.

Chaque ligne dans la section Graphique représente une validation. Lorsque vous passez la souris sur une validation, vous pouvez voir l'auteur de validation, la date, le message et le SHA abrégé. Vous pouvez également copier le SHA complet dans le presse-papiers.

Les fichiers qui ont été modifiés sont répertoriés sous la liste Fichiers modifiés. Faites un clic droit sur un fichier dans la liste et sélectionnez Comparer avec la validation précédente pour ouvrir une vue différentielle dans le concepteur.

Faire un clic droit sur une validation vous donne accès aux options suivantes :

• Extraire la validation : extrait le référentiel à la validation sélectionnée.
• Extraire la branche : passe à la branche associée à la validation sélectionnée.
• Appliquer une sélection de modifications : applique les modifications de la validation à la branche actuelle.
• Rétablir la validation : crée une nouvelle validation qui annule les modifications introduites par la validation sélectionnée.
• Réinitialiser Soft : déplace le pointeur de branche vers la validation sélectionnée, conservant toutes les modifications ultérieures indexées.
• Réinitialiser Hard : déplace le pointeur de branche vers la validation sélectionnée et ignore toutes les modifications ultérieures.
• Comparer avec l'arbre de travail : ouvre une comparaison entre la validation et vos fichiers locaux actuels.
• Comparer avec la validation précédente : ouvre une comparaison entre la validation et sa validation parent.
• Copier le SHA de la validation : copie le SHA de la validation complet dans le presse-papiers.

En cliquant sur un fichier n'importe où dans le panneau Contrôle de code source (dans la zone Modifications ou dans une ligne de validation développée dans la zone Graphique), vous ouvrez la vue différentielle.