Git-based Version Control
Les dépôts de type Git sont créés en dehors d’Altium Designer, et le contenu d’un dépôt Git local de travail est accessible en ouvrant les fichiers depuis son dossier hôte. La gestion des dépôts Git distants et locaux de travail s’effectue généralement via les systèmes de l’entreprise et des outils Git externes, tandis que les opérations au niveau des fichiers (Commit, Push, Update, etc.) sont gérées dans l’environnement d’édition d’Altium Designer.
Ajouter au contrôle de version Git
En tant que système de contrôle de version distribué, Git utilise un flux de travail différent de celui de SVN, bien que la différence soit minime lorsque l’on travaille avec des fichiers de projet établis dans Altium Designer. En bref, Git applique le transfert de données entre plusieurs dépôts, plutôt que de se concentrer sur la dépendance à une cible de dépôt unique.
► Consultez le site web de Git pour plus d’informations et Version Control Essentials pour une vue d’ensemble des principes applicables.
Un système Git VCS repose généralement sur un serveur Git distant centralisé pouvant héberger plusieurs dépôts Git selon les besoins. La nature rapide et légère de Git se prête à la pratique consistant à créer un dépôt distant pour chaque projet, qui peut ensuite être cloné (copié) comme dépôt de travail pour tout utilisateur travaillant sur le projet. Les fichiers mis à jour dans le dépôt Git de travail d’un utilisateur sont ensuite « poussés » vers le dépôt distant sur le serveur Git afin d’assurer la synchronisation.
La méthode utilisée pour établir un projet Altium Designer dans un système Git dépendra de l’infrastructure et des pratiques de l’entreprise et impliquera des outils et des processus externes à Altium Designer. Une fois qu’un projet se trouve dans le système de contrôle de version et est disponible comme dépôt local de travail, travailler avec un Git VCS dans Altium Designer est toutefois pratiquement identique au travail avec un SVN VCS.
Ajouter un projet à Git
À titre d’exemple, un projet Altium Designer existant peut être ajouté à un dépôt Git local à l’aide des outils de base en ligne de commande Git. Avec cette approche, le dossier du projet devient le dépôt Git local (de travail), et celui-ci est lié puis finalement mis à jour vers un dépôt Git distant disponible.
Ici, les outils sont utilisés pour :
- Créer (initialize) le dépôt Git de travail dans le dossier du projet.
-
Ajouter les fichiers du projet au contrôle de version Git. Le spécificateur de fichier
*.*ajoute des fichiers mais pas des dossiers. -
Spécifier la référence de lien vers le dépôt Git distant partagé sur un serveur web.
PCrepoest un alias local désigné de l’URL du dépôt distant.
Projet en cours d’ajout à un dépôt Git local
Lorsque le projet est ouvert dans Altium Designer, l’état de ses fichiers dans les panneaux Projects et Storage Manager est Scheduled for Addition (
). Une fois validés dans le dépôt de travail, les fichiers passent à l’état Ahead of Server (
) puisqu’ils ne sont pas encore sous contrôle de version dans le dépôt Git distant.
Fichiers planifiés pour ajout et en avance sur le serveur
La commande Push mettra à jour les fichiers du dépôt local vers le serveur Git distant, qui pourra demander des identifiants valides pour le dépôt ciblé – un processus ponctuel.
Les fichiers sont mis à jour après la demande d’identifiants valides
Le projet Altium Designer, désormais entièrement sous contrôle de version Git, devient accessible aux autres utilisateurs depuis le dépôt Git distant. Un autre utilisateur peut par exemple cloner le dépôt sur sa machine locale, puis finalement pousser ses fichiers modifiés vers le dépôt distant dans le cadre d’un flux de travail collaboratif.
Cloner un dépôt Git
Un projet local qui a été ajouté au contrôle de version Git peut être modifié par Altium Designer depuis le dossier local du projet (le dépôt de travail), puis les modifications validées sont mises à jour vers le dépôt Git distant. Le dépôt local et le dépôt distant sont liés et finalement synchronisés par une commande PushVCS.
D’autres utilisateurs souhaitant collaborer à la conception peuvent accéder au projet en clonant le dépôt Git distant vers un dépôt local de travail. Bien que l’approche d’accès aux fichiers depuis un dépôt Git distant varie selon les systèmes et méthodes de l’entreprise, une manière simple de cloner le contenu d’un dépôt distant vers un dépôt local de travail consiste à utiliser la commande Git git clone [remote repository URL] [target working repository folder], comme illustré dans l’image ci-dessous.
Les modifications validées sont mises à jour vers le dépôt Git distant
Le processus répliquera le dépôt distant partagé sous forme de dépôt local de travail et extraira automatiquement la dernière révision (HEAD) depuis la branche master. Les fichiers peuvent ensuite être modifiés, enregistrés et validés dans le VCS dans Altium Designer, puis finalement poussés de nouveau vers le dépôt Git distant.
Connexion à un dépôt Git existant
Altium Designer n’offre aucun contrôle pour créer un nouveau dépôt Git ou se connecter à un dépôt existant. Cependant, vous pouvez vous connecter efficacement à un dépôt existant de ce type par d’autres moyens (qui constituent la technique traditionnelle privilégiée par les utilisateurs de Git). Pour ce faire :
- Créez votre dépôt Git distant, ou accédez au dépôt externe de votre entreprise dans lequel vos projets Altium Designer sont stockés.
- Clonez le dépôt pour créer votre dépôt Git local de travail.
- Ouvrez un projet Altium Designer depuis le dépôt local.
Altium Designer reconnaîtra que le projet est sous contrôle de version dans un dépôt basé sur Git, et fournira les états liés au VCS ainsi que les commandes/fonctions permettant de travailler avec les fichiers (y compris Commit (vers le dépôt Git local de travail) et Push (du dépôt Git local vers le dépôt Git distant)).
AI-localized