Git pour TIA Portal et le code automate
Sur cette page
AnyAutomation Studio intègre la prise en charge de Git de sa base d'éditeur. Le contrôle de version passe par la vue Contrôle de code source et non par une fenêtre séparée ; vous indexez, validez et synchronisez vos modifications sans quitter l'espace de travail. Ouvrez un dossier qui est un dépôt Git, et le contrôle de code source s'active automatiquement.
Vue Contrôle de code source
Ouvrez la vue Contrôle de code source depuis la barre d'activité (la bande d'icônes verticale tout à gauche) ou avec Ctrl+Shift+G. La vue liste chaque modification du dépôt ouvert, et c'est là que vous effectuez l'essentiel du travail Git au quotidien.
L'icône de la barre d'activité affiche un petit badge de comptage dès que le dépôt contient des modifications en attente, pour que vous voyiez d'un coup d'œil qu'il y a du travail à valider.
Ouvrir un dépôt
Le contrôle de code source suit le dossier ouvert dans l'espace de travail :
- Ouvrez le dossier de votre projet avec Fichier → Ouvrir le dossier (Ctrl+K Ctrl+O)
- Si le dossier est un dépôt Git, la vue Contrôle de code source se remplit automatiquement
- Si le dossier n'est pas encore un dépôt, la vue Contrôle de code source propose Initialiser le dépôt
Vous pouvez aussi cloner un dépôt : ouvrez la palette de commandes (Ctrl+Shift+P), lancez Git : Cloner, puis indiquez l'URL du dépôt et un dossier cible.
Indexer et valider
La vue Contrôle de code source regroupe vos modifications en Modifications indexées et Modifications (non indexées).
- Survolez un fichier et cliquez sur l'icône + pour l'indexer, ou indexez toutes les modifications avec le + de l'en-tête du groupe Modifications
- Cliquez sur l'icône - pour désindexer un fichier
- Chaque fichier affiche un indicateur d'état d'une lettre : M (modifié), A (ajouté), D (supprimé), U (non suivi), R (renommé)
- Saisissez votre message de commit dans la zone de message en haut de la vue
- Cliquez sur la coche Valider (ou appuyez sur Ctrl+Enter dans la zone de message) pour valider les modifications indexées
Si rien n'est indexé au moment du commit, l'éditeur propose de valider toutes les modifications. Utilisez le menu ... (Autres actions) en haut de la vue pour les commandes associées, comme Tout valider, Commit indexé (modifier) et Remiser (stash).
Filtrer les modifications
Chaque en-tête de groupe de la vue Contrôle de code source, par exemple Modifications ou Modifications indexées, affiche une icône de filtre comme première icône. Cliquez dessus et saisissez une partie d'un nom de fichier : la liste n'affiche que les modifications dont le nom correspond. Cliquez de nouveau sur l'icône de filtre pour fermer le filtre et voir toutes les modifications. Vous pouvez aussi lancer Contrôle de code source : Filtrer les modifications depuis la palette de commandes (Ctrl+Shift+P).
Importer des modifications dans TIA Portal
Tant que Studio est connecté à un projet TIA, chaque modification de la vue Contrôle de code source affiche une icône Importer dans TIA Portal comme première icône. Cliquez dessus pour importer le fichier modifié dans le projet connecté. L'import fonctionne exactement comme Importer la sélection dans la vue Import / Export : vous choisissez l'automate cible si nécessaire, les fichiers des appareils HMI classiques vont vers leur appareil, et les éléments protégés restent inchangés.
La même commande se trouve dans le menu contextuel d'une modification (clic droit > Importer dans TIA Portal). Pour importer plusieurs modifications à la fois, sélectionnez-les dans la liste (clic avec Ctrl ou Maj) et cliquez sur l'icône de l'une des lignes sélectionnées, ou choisissez la commande dans le menu contextuel d'une ligne sélectionnée. Les fichiers supprimés sont ignorés, de même que les fichiers d'un type que l'import ne prend pas en charge (par exemple un README.md) et les fichiers WinCC Unified, que vous importez avec Importer des fichiers HMI... ; un message vous indique combien ont été ignorés. Les modifications avec un conflit de fusion n'affichent pas l'icône : résolvez d'abord le conflit, puis vous pourrez importer le fichier.
C'est pratique lorsque l'assistant IA modifie des fichiers dans un dossier sous Git : les fichiers modifiés apparaissent dans le contrôle de code source, et vous les intégrez au projet à partir de là en un clic.
Générer un message de commit avec l'IA
Une fois les modifications indexées, cliquez sur l'icône étincelle (Génère un message de validation) dans la zone de message de commit pour rédiger un message à partir de vos modifications. Cette fonction utilise l'intégration de messages de commit GitHub Copilot intégrée à l'éditeur et nécessite que GitHub Copilot soit configuré ; elle est distincte des fournisseurs du chat IA. Relisez et modifiez la proposition, puis validez.
Afficher les modifications (diff)
Cliquez sur n'importe quel fichier modifié dans la vue Contrôle de code source pour ouvrir l'éditeur de diff dans la zone d'édition centrale. L'éditeur de diff affiche le contenu précédent et votre contenu actuel côte à côte (ou en ligne ; changez la disposition depuis la barre d'outils de l'éditeur). Dans l'éditeur de diff, vous pouvez indexer ou annuler des zones modifiées individuelles grâce aux commandes de la marge.
Branches et synchronisation
La branche actuelle s'affiche à gauche de la Barre d'état (la barre tout en bas de la fenêtre).
- Cliquez sur le nom de la branche pour changer de branche ou créer une nouvelle branche depuis le sélecteur qui apparaît
- L'indicateur de synchronisation à côté du nom de la branche montre de combien de commits vous êtes en avance ou en retard sur la branche amont ; cliquez dessus pour faire un pull puis un push (synchroniser)
- Lancez Git : Push, Git : Pull, Git : Fetch, Git : Merge et d'autres opérations de branche depuis la palette de commandes (Ctrl+Shift+P), ou depuis le menu ... en haut de la vue Contrôle de code source
Sortie Git
Lorsqu'une commande Git s'exécute, sa sortie brute est écrite dans le canal Git de la vue Sortie (dans le panneau du bas). Ouvrez le panneau, sélectionnez Git dans la liste déroulante, et vous pouvez lire exactement quelles commandes ont été exécutées et les erreurs éventuelles qu'elles ont renvoyées, utile lorsqu'une opération ne se comporte pas comme prévu.
Historique et annotations
La consultation de l'historique des commits, de l'historique des fichiers et du blame par ligne dépend des extensions installées. L'éditeur de base propose la vue Chronologie (dans l'Explorateur), qui montre l'historique des commits du fichier ouvert, ainsi que des indicateurs de modification dans la marge de l'éditeur. Des vues plus riches de graphe de commits, de blame et de pull requests sont fournies par des extensions Git que vous pouvez ajouter depuis la marketplace ; décrivez ces fonctions selon l'extension que vous installez, car elles ne font pas partie de l'expérience intégrée.
Explication IA dans l'infobulle du blame
Lorsque l'annotation Git blame de l'éditeur est activée, elle peut ajouter une courte explication IA de la raison d'une modification. Ouvrez les paramètres, recherchez AI Explanation (sous Git Blame) et activez-le. Il est désactivé par défaut. Survolez ensuite l'annotation blame en fin de ligne : à côté de l'auteur, de la date et du message du commit apparaît une courte explication produite par le modèle IA sélectionné, qui résume l'intention de ce commit. Pour la produire, le message du commit et la modification de ce commit sur le fichier actuel sont envoyés à votre modèle, cela ne fonctionne donc que si vous êtes connecté à un fournisseur d'IA ; si le paramètre est désactivé, l'infobulle reste inchangée.