< Précédent | Suivant >

Leçon 6 : Contrôle des sources

Le composant de contrôle des sources gère le stockage, l'extraction et le partage du code source et des autres artefacts des projets. La fonction de contrôle des sources de Rational Team Concert (SCM) s'adapte facilement à différents types de scénarios de développement et diffère sensiblement des systèmes de contrôle des source basés sur fichiers traditionnels. Commençons par étudier brièvement son mode d'utilisation.
Les utilisateurs de Rational Team Concert désirent utiliser le contrôle des sources pour suivre les modifications et les versions, que celles-ci soient destinées à être partagées avec l'équipe ou pas. Chaque utilisateur possède son propre espace de travail de référentiel qui renferme ses modifications, qui seront ou non partagées avec le reste de l'équipe. Le partage de ces modifications peut se faire après quelques heures, jours ou semaines, voire jamais. Dans tous les cas, vos modifications sont dans votre référentiel et c'est vous qui décidez si et quand vous voulez les partager avec l'équipe. Quand vous chargez votre espace de travail de référentiel, les fichiers et dossiers qu'il contient sont transférés dans l'espace de travail Eclipse de votre ordinateur. Lorsque vous transférez une modification de votre espace de travail Eclipse vers l'espace de travail du référentiel, vous restituez cette modification.

Le travail de l'équipe est enregistré dans un flux. Quand vous voulez partager vos modifications avec le reste de l'équipe, vous devez les distribuer depuis un espace de travail de référentiel vers un flux. Quand vous voulez incorporer les modifications réalisées par d'autres membres de l'équipe à votre propre travail, vous devez les accepter depuis le flux. Notez que vous pouvez aussi accepter des modifications directement depuis un autre espace de travail de référentiel, ce qui permet de partager des modifications de manière sélective entre équipiers. Par exemple, deux équipiers peuvent travailler ensemble sur la correction d'un défaut mineur ou, si un équipier commence une modification puis part en congé, un autre équipier peut alors continuer le travail puis le distribuer ensuite.

Flux de travaux d'un contrôle des sources

Toutes les modifications que vous réalisez dans votre espace de travail de référentiel sont suivis au moyen d'ensembles d'artefacts modifiés. Chaque ensemble d'artefacts modifiés comprend un ensemble de modifications explicites apportées à un ou plusieurs fichiers ou dossiers. Un ensemble d'artefacts modifiés peut aussi contenir un commentaire et le motif des modifications réalisées avec des références à l'élément de travail associé. La base de fichier source s'agrandit à mesure que les ensembles d'artefacts modifiés s'additionnent les uns aux autres. Chaque flux ou espace de travail de référentiel repose sur une suite d'ensembles d'artefacts modifiés.

Nous allons faire quelques changements et voir comment ces concepts peuvent s'utiliser dans le travail quotidien.

Création d'un espace de travail de référentiel

La première étape consiste à trouver le flux de votre zone d'équipe. Le flux est l'endroit où vous partagez le code avec l'équipe.
  1. Dans la vue Artefacts de l'équipe , développez la zone de projet Prelude, Contrôle des sources, puis Flux de l'équipe 1 pour afficher le composant. Si aucune entrée ne s'affiche dans Contrôle des sources, affichez le menu déroulant Personnaliser mon filtre que vous voyez dans la capture d'écran. Dans ce menu déroulant, vérifiez que l'option Toutes les zones d'équipe est sélectionnée.
    Remarque : Ces filtres personnalisés sont d'une grande utilité si vous êtes membre de plusieurs équipes.

    Les flux comme les espaces de travail de référentiel peuvent être partitionnés en différents composants. Dans la mesure où chaque composant possède un historique propre, il est intéressant de décomposer un programme en plusieurs composants pour les équipes qui développent des logiciels par couches dans lesquelles les éléments évoluent de manière relativement indépendante et se déploient séparément. Les flux et espaces de travail de référentiel les plus simples ne contiennent qu'un seul composant. Dans notre exemple, le flux de l'équipe 1 ne comprend qu'un seul composant (nommé Composant par défaut) qui contient les fichiers et les dossiers.

    Composant par défaut du flux de l'équipe 1

  2. Sélectionnez le flux de votre zone d'équipe nommé Flux de l'équipe 1 (Equipe 1).
  3. Cliquez à l'aide du bouton droit de la souris, puis cliquez sur Nouveau > Espace de travail de référentiel.
  4. Dans la zone Nom de l'espace de travail du référentiel de la page Nouvel espace de travail de référentiel de l'assistant Nouvel espace de travail de référentiel, entrez Chris sur Prelude et cliquez sur Terminer. Cette action permet de créer et de charger le nouvel espace de travail de référentiel dans votre espace de travail Eclipse. Le chargement est assez rapide puis le flux ne contient encore aucun code.
  5. Lorsqu'un espace de travail de référentiel est chargé, il s'affiche dans la vue Modifications en attente. Si la vue Modifications en attente ne s'affiche pas, cliquez sur Fenêtre > Afficher la vue > Modifications en attente.
  6. Facultatif : Si vous avez complété le tutoriel consacré aux invitations d'équipe, vous avez déjà créé un élément de travail quand vous avez initialisé une zone de projet. Réexécutez votre requête Ouvrir des éléments de travail et regardez l'élément de travail [Rejoindre une équipe] Créer un espace de travail de référentiel. Vous pouvez maintenant ouvrir cet élément de travail et l'exécuter, comme vous aviez accompli l'élément de travail Définir les membres de l'équipe un peu plus tôt.
Les espaces de travail de référentiel chargés sont particuliers ; quand vous modifiez un fichier ou un dossier chargé dans votre espace de travail Eclipse, ces modifications sont suivies et affichées dans la vue Modifications en attente. Cette vue vous permet de gérer ces modifications et d'exécuter des tâches courantes comme, par exemple :
  • restituer des modifications dans votre espace de travail de référentiel,
  • organiser les modifications sous la forme d'ensembles d'artefacts modifiés,
  • annuler des modifications,
  • associer des ensembles d'artefacts modifiés à des éléments de travail.

Vous en apprendrez davantage sur la vue Modifications en attente dans les prochaines sections car elle est au centre du travail quotidien d'un développeur.

Code de création

Lorsque vous rejoignez un flux, vous pouvez écrire un code et générer les artefacts pour votre projet.
Si vous souhaitez essayer des petits packages Java™ issus d'autres projets avec Rational Team Concert, vous pouvez importer ces projets maintenant dans votre espace de travail Eclipse à partir de la vue Packages en sélectionnant l'option Importer dans le menu contextuel. Si vous ne possédez aucune base de code intéressante pour démarrer, vous pouvez créer une application Java basique ou créer un projet ne contenant qu'un simple fichier texte.
  1. Pour savoir comment créer une simple application Java dans le client Jazz, cliquez sur Help > Aide-mémoire.
  2. Dans la boîte de dialogue Sélection d'un aide-mémoire, développez la catégorie Développement Java, puis cliquez sur Créer une application Hello World. Cliquez sur OK. L'aide-mémoire qui s'affiche dans la fenêtre du client Jazz vous explique comment créer une simple application Java. Pour plus d'informations, voir le document Eclipse Java Development User Guide.
    Remarque : Les auteurs de ce tutoriel on créé un projet de base en Java appelé Hello Prelude.

Soumission d'un code à Jazz Source Control

Lorsque vous avez importé ou créé manuellement un code dans votre espace de travail Eclipse, vous pouvez le restituer dans votre espace de travail de référentiel sur le serveur et partager le projet avec votre équipe.
La restitution d'un code consiste à le transférer depuis votre espace de travail Eclipse vers votre espace de travail de référentiel. Quand vous déplacez un code depuis votre espace de travail de référentiel vers le flux afin de le partager avec votre équipe, vous le distribuez. Vous pouvez modifier les préférences de Jazz Source Control pour spécifier une restitution automatique. Vous pouvez également travailler hors connexion et restituer un code plus tard quand vous vous reconnectez.

Pour restituer votre projet dans Jazz Source Control, procédez comme suit :

  1. Ouvrez la perspective Java. S'il ne s'agit pas de la perspective en cours, cliquez sur Fenêtre > Ouvrir la perspective > Java.
  2. Dans la vue Packages, sélectionnez le projet Hello Prelude.
  3. Cliquez à l'aide du bouton droit de la souris, puis cliquez sur Equipe > Partage du projet.
  4. Dans la page Partage du projet de l'assistant Partage du projet, sélectionnez Jazz Source Control et cliquez sur Suivant.
  5. Dans la page Sélectionner un composant, vérifiez que la connexion au référentiel chris@localhost est sélectionnée dans la liste déroulante située en haut. Vérifiez également que l'option Sélectionner un composant dans un espace de travail de référentiel existant est sélectionnée. Développez Chris sur Prelude puis sélectionnez Composant par défaut. Cliquez sur Suivant.
  6. Dans la page Révision des ressources ignorées, vérifiez ou indiquez les ressources à ignorer pour le partage. En principe, vous n'avez rien à changer. Cliquez sur Terminer. Votre code a été restitué dans votre espace de travail de référentiel mais n'a pas encore été distribué dans le flux.
  7. Facultatif : Passez à la vue Modifications en attente. Dans la perspective Java, cliquez sur Fenêtre > Afficher la vue > Modifications en attente. Cette fenêtre s'ouvre quand vous chargez et partagez un projet. Si vous développez le Composant par défaut, vous pouvez afficher un ensemble d'artefacts modifiés pour le projet que vous venez de partager. L'opération de partage a été suivie et les modifications correspondantes ont été automatiquement restituées dans l'espace de travail du référentiel.
  8. Facultatif : L'ensemble d'artefacts modifiés contient déjà le commentaire Partager les projets associé. Pour modifier le commentaire ou ajouter des commentaires à de futurs ensembles d'artefacts modifiés qui ne comportent pas de commentaires automatiquement associés, cliquez à l'aide du bouton droit de la souris sur l'ensemble d'artefacts modifiés, puis cliquez sur Editer le commentaire. Dans la sous-fenêtre d'édition, entrez le commentaire et cliquez sur Entrer.
  9. Facultatif : Pour naviguer dans la structure de répertoire du composant, dans la vue Modifications en attente, cliquez à l'aide du bouton droit de la souris sur le Composant par défaut, puis sur Afficher > Fichiers du référentiel. Les projets que vous venez de partager s'affichent dans la vue Fichiers du référentiel.
  10. Facultatif : Pour examiner l'historique de votre espace de travail de référentiel, dans la vue Modifications en attente, cliquez à l'aide du bouton droit de la souris sur le Composant par défaut, puis cliquez sur Afficher > Historique. La vue Historique répertorie l'ensemble d'artefacts modifiés initial remontant à la création du composant et le deuxième ensemble d'artefacts modifiés que vous venez de créer. Pour explorer le contenu d'un ensemble d'artefacts modifiés, cliquez deux fois sur l'un d'eux. La vue Explorateur des modifications s'ouvre et permet de parcourir les fichiers de l'ensemble d'artefacts modifiés.

Distribution de vos modifications dans votre équipe

Vous allez voir dans cette section l'ensemble des artefacts modifiés correspondant au code que vous avez créé. Vous devrez ensuite associer cet ensemble d'artefacts modifiés à un élément de travail existant. Pour finir, vous allez distribuer le code dans le flux.
Toutes les modifications que vous avez apportées sont stockées dans votre espace de travail de référentiel.

Pour distribuer les modifications et les mettre à disposition des membres de votre équipe, procédez comme suit :

  1. Dans la vue Modifications en attente, cliquez à l'aide du bouton droit de la souris sur un ensemble d'artefacts modifiés, puis cliquez sur Associer l'élément de travail
  2. Dans la boîte de dialogue Sélection d'éléments de travail, décochez la case Afficher uniquement mes affectations.
  3. Dans la zone Contenant l'ID ou le texte, tapez share. Les éléments de travail dont le récapitulatif contient le mot share s'affichent.
  4. Sélectionnez l'élément de travail Partager le code avec Jazz Source Control puis cliquez sur OK. Cette action permet de créer une connexion entre le code que vous avez créé et l'élément de travail que vous avez résolu.
  5. Pour distribuer et résoudre l'élément de travail, dans la vue Modifications en attente, procédez comme suit :
    1. Cliquez à l'aide du bouton droit de la souris sur l'ensemble d'artefacts modifiés, puis cliquez sur Distribuer et résoudre un élément de travail.
    2. Dans la boîte de dialogue Distribuer et résoudre, cochez la case Résoudre l'élément de travail.
    3. Dans la sous-fenêtre Ajouter un commentaire à l'élément de travail, entrez un commentaire à ajouter à l'élément de travail.
    4. Cliquez sur Terminer.
    L'élément de travail est résolu et votre code a été distribué de votre espace de travail de référentiel sur le serveur vers le flux de la zone d'équipe, désormais accessible au reste de l'équipe.
  6. Facultatif : Réactualisez la vue Historique. La vue indique à présent que l'ensemble d'artefacts modifiés a été associé à l'élément de travail.
  7. Facultatif : Dans la vue Artefacts de l'équipe, dans Flux de l'équipe 1, cliquez à l'aide du bouton droit de la souris sur le Composant par défaut, puis cliquez sur Afficher > Historique. La vue Historique affiche votre ensemble d'artefacts modifiés dans le flux.
  8. Facultatif : Dans la vue Historique, pour ouvrir l'élément de travail associé avec l'ensemble d'artefacts modifiés, cliquez à l'aide du bouton droit de la souris sur l'ensemble d'artefacts modifiés, puis cliquez sur Ouvrir les éléments de travail. L'élément de travail est résolu et contient un lien vers l'ensemble d'artefacts modifiés que vous avez créé pour ce travail.

Point de contrôle de la leçon

Cette leçon vous a appris les concepts de base de la fonction Jazz Source Control.
< Précédent | Suivant >

Commentaire

Etes-vous satisfait ? Envoyez vos commentaires sur Jazz.net (inscription requise) : Entrez vos remarques dans les forums ou soumettez un incident