Tutoriel : Travailler avec le contrôle de code source

Le contrôle de version, également connu sous le nom de contrôle de code source, est la pratique consistant à assurer le suivi et la gestion des modifications apportées au code logiciel ou aux fichiers au sein d'un projet. Les systèmes de contrôle de version sont des outils logiciels qui aident les équipes à gérer les modifications apportées à un projet au fil du temps.

Le logiciel de contrôle de version permet de consigner les modifications apportées et assure aux membres de l'équipe de toujours exploiter la dernière version en date. Il devrait vous aider à développer et à livrer plus rapidement vos projets, en améliorant la visibilité et en aidant les équipes à collaborer. Les modifications sont stockées dans un type de base de données spécifique, appelé référentiel. Si une erreur est commise lors d'une modification, vous pouvez effectuer une comparaison avec les versions antérieures du projet StudioX, afin de corriger l'erreur tout en réduisant au strict minimum les perturbations occasionnées à l'ensemble des membres de l'équipe.

Remarque : Ce tutoriel s'applique uniquement à StudioX v2020.10 et v2021.4. Pour les versions plus récentes de StudioX, voir Gérer les projets avec GIT dans le guide StudioX.

Il existe de nombreux logiciels de contrôle de version  ; ce guide prend comme exemples Bitbucket et GitHub Desktop.

Créer des référentiels

Demandez à votre administrateur ou chef d'équipe de créer des référentiels pour vous. L'une des bonnes pratiques en la matière consiste à avoir deux référentiels :

• Un référentiel personnel pour stocker vos projets StudioX personnels, auxquels il est peu probable que d'autres utilisateurs aient besoin d'accéder.
• Un référentiel partagé avec l'équipe, pour les projets StudioX auxquels tous les membres de votre équipe ou organisation sont susceptibles de devoir accéder.

Conseils et ressources

• Ne travaillez qu'avec une seule branche (par exemple, la branche maîtresse).
• Ne créez pas de branches supplémentaires ni de demandes pull sans raison légitime. Celles-ci peuvent compliquer le processus d'utilisation du contrôle de version.
• Avant de commencer à travailler sur un projet, effectuez toujours une demande pull pour synchroniser les modifications apportées au référentiel.
• Faites toujours un Commit et un Push lorsque vous avez fini de travailler sur un projet pour vous assurer que vos modifications sont chargées vers le référentiel.
• Pour accéder à des guides GitHub plus détaillés, consultez le portail de documentation GitHub Desktop.
• Pour plus de guides liés à l'utilisation de l'application Sourcetree, consultez le portail de documentation Atlassian.

<details>

<summary>GitHub Desktop</summary>

Télécharger et installer GitHub Desktop

Pour commencer à utiliser GitHub Desktop, vous devez le télécharger, l'installer et le configurer sur votre machine. Pour ce faire, consultez le guide de GitHub sur la façon de télécharger et d'installer leur logiciel.

Configurer GitHub Desktop sur votre machine

Si vous n'avez pas encore de compte, créez-en un et connectez-vous à l'application GitHub Desktop.

Pour connecter un référentiel à votre projet local :

1. Ouvrez l'application GitHub Desktop.
2. Cliquez sur le menu Fichier (File) et sélectionnez Cloner le référentiel (Clone repository).

3. Dans la fenêtre qui s'affiche :

   • Cliquez sur l'onglet GitHub.com.
   • Entrez le nom du référentiel.
   • Entrez votre chemin de dossier \Documents\UiPath dans le champ Chemin local (Local path).

4. Cliquez sur Cloner (Clone) une fois que tout est configuré.

   
   

   

   
   

Travailler avec des projets

Répercuter toutes les modifications apportées au référentiel

Avant de créer un nouveau projet ou d'apporter des modifications à un projet existant dans StudioX, assurez-vous que tous les projets sont fermés dans StudioX (le moyen le plus sûr est de s'assurer que toutes les instances de StudioX sont fermées)

1. Ouvrez l'application GitHub Desktop.

2. Choisissez le référentiel contenant le projet sur lequel vous travaillez.

   
   

   

   
   
3. Cliquez sur le menu Référentiel (Repository) en haut et sélectionnez Transmettre (Pull).

Créer un nouveau projet

Pour créer un nouveau projet StudioX qui utilise le contrôle de version :

1. Créez une tâche dans StudioX.

2. Dans le champ Emplacement (Location), accédez au dossier qui représente le référentiel approprié (référentiel personnel ou partagé avec l'équipe).

   
   

   

   
   

Cela place le projet dans son propre dossier, à la racine du référentiel.

Remarque :

Pour les projets existants, si vous souhaitez déplacer le projet vers le contrôle de version, le dossier peut être

déplacé manuellement dans le dossier du référentiel.

Valider les modifications

Vous pouvez enregistrer (valider) dans le référentiel en ligne les modifications effectuées sur votre ordinateur local, aussi souvent que nécessaire.

1. Fermez le projet dans StudioX.
2. Ouvrez l'application GitHub Desktop.

3. Choisissez le référentiel contenant le projet StudioX pour lequel vous souhaitez valider des modifications.

   
   

   

   
   
4. Saisissez dans le champ Résumé (Summary) un bref résumé des modifications apportées.

5. Cliquez sur le bouton Valider (Commit).

   
   

   

   
   
6. Cliquez sur le menu Référentiel (Repository) en haut et sélectionnez Transmettre (Pull).

7. Cliquez sur le bouton Transmettre l'origine (Push origin) pour envoyer vos modifications dans le référentiel.

   
   

   

   
   

<details>

<details>

<summary>Bitbucket</summary>

Télécharger et installer l'application Sourcetree

Pour commencer à utiliser Sourcetree, vous devez le télécharger, l'installer et le configurer sur votre machine. Pour ce faire, consultez le guide d'Atlassian sur la façon de télécharger et d'installer leur logiciel.

Travailler avec des projets

Répercuter toutes les modifications apportées au référentiel

Avant de créer un nouveau projet ou d'apporter des modifications à un projet existant dans StudioX, assurez-vous que tous les projets sont fermés dans StudioX (le moyen le plus sûr est de s'assurer que toutes les instances de StudioX sont fermées)

1. Ouvrez l'application Sourcetree.
2. Cliquez sur Distant (Remote) en haut.

3. Sélectionnez le référentiel contenant le projet sur lequel vous travaillez en cliquant sur Cloner (Clone).

   
   

   

   
   

Créer un nouveau projet

Pour créer un nouveau projet StudioX qui utilise le contrôle de version :

1. Créez une tâche dans StudioX.

2. Dans le champ Emplacement (Location), accédez au dossier qui représente le référentiel approprié (référentiel personnel ou partagé avec l'équipe).

   
   

   

   
   

Cela place le projet dans son propre dossier, à la racine du référentiel.

Remarque :

Si des projets existants doivent être déplacés vers le contrôle de version, le dossier peut être

déplacé manuellement dans le dossier du référentiel.

Valider les modifications

Vous pouvez enregistrer (valider) dans le référentiel en ligne les modifications effectuées sur votre ordinateur local, aussi souvent que nécessaire.

1. Fermez le projet dans StudioX.
2. Ouvrez l'application Sourcetree.
3. Assurez-vous que le référentiel contenant le projet StudioX est sélectionné.
4. Cliquez sur l'icône + en regard des fichiers que vous souhaitez valider pour les ajouter à la liste.
   
   

   

   
   
5. Cochez la case Transmettre immédiatement les modifications à l'origine/au maître (Push changes immediately to origin/master).

6. Tapez un message et cliquez sur Valider (Commit) dans le coin inférieur droit.

   
   

   

   
   

<details>