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 :

This tutorial only applies to StudioX v2020.10 and v2021.4. For newer versions of StudioX see Managing projects with GIT in the StudioX guide.

While there are various version control software available, this guide uses Bitbucket and GitHub Desktop as examples.

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.
• Always do a Pull request to synchronize any changes from the repository prior to beginning work on a project.
• Always do a Commit and a Push when you finish working on a project to make sure your changes are uploaded to the repository.
• For more in-depth GitHub guides, visit the GitHub Dekstop documentation portal.
• For more guides related working the Sourcetree app, visit Atlassian's documentation porta.

<details>

<summary>GitHub Desktop</summary>

Télécharger et installer GitHub Desktop

To begin using GitHub Desktop you need to download, install, and configure it on your machine. To do so, visit GitHub's guide on how to download and install their software.

Configurer GitHub Desktop sur votre machine

If you don't already have an account, create one and log in to the GitHub Desktop application.

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

To begin using Sourcetree, you need to download, install, and configure it on your machine. To do so, visit Atlassian's guide on how to download and install their software.

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>