GUI Modeler - SNIper

Guide d'installation et d'utilisation de WinCVS

 

Version <1.10>

 

 

 

Historique des Révisions

Date

Version

Description

Auteur

24/01/2002

<1.0>

Création

ISI3_BE1

20/02/2002

<1.1>

Mise à jour en fonction des différentes remarques

ISI3_BE1

 

 

 

 

 

 

 

 

 

Table des matières

1.     Introduction                                                                                                                                                                              4

1.1      Objectif                                                                                                                                                                          4

1.2      Portée                                                                                                                                                                            4

1.3      Références                                                                                                                                                                    4

2.     Inscription sur Sourceforge                                                                                                                                                    4

3.     Installation                                                                                                                                                                                4

4.     Configuration                                                                                                                                                                            4

4.1      SFSetup                                                                                                                                                                         4

4.2      Ssh                                                                                                                                                                                 4

5.     Utilisation de WinCVS                                                                                                                                                            4

5.1      Première utilisation                                                                                                                                                      4

5.2      Editer un fichier                                                                                                                                                            5

5.2.1    Personne n’édite encore ce fichier                                                                                                                  5

5.2.2    Quelqu’un édite déjà ce fichier                                                                                                                        5

5.3      Modification d’un fichier                                                                                                                                           5

5.4      Validation des modifications                                                                                                                                     5

5.5      Annulation des modifications                                                                                                                                   5

5.6      Ajout d’un nouveau fichier au projet                                                                                                                       5

5.7      Mise à jour des fichiers                                                                                                                                              5

5.8      Fenêtre de WinCVS                                                                                                                                                     6

6.     Conseils d’utilisation                                                                                                                                                               6


Guide d'installation et d'utilisation de WinCVS

1.                  Introduction

1.1               Objectif

Ce document présente la phase d'installation ainsi que les conseils d'utilisation du logiciel WinCVS version 1.2.

1.2               Portée

Gestion de configuration des fichiers sources lors du développement de l'application SNIper.

1.3               Références

Documentation du site de Sourceforge :

http://sourceforge.net/docman/display_doc.php?docid=766&group_id=1

 

2.                  Inscription sur Sourceforge

Les fichiers source de l'application seront gérés sur Sourceforge par l'intermédiaire de CVS. Pour "participer" au projet, vous devez tout d'abord vous inscrire sur le site en tant que développeur officiel. A partir de là, vous devez nous donner votre nom de développeur pour que l'on puisse vous intégrer au projet.

 

3.                  Installation

-          Installez d'abord la version 1.2 du logiciel WinCVS disponible gratuitement à l’adresse http://sourceforge.net/project/showfiles.php?group_id=10072&release_id=24467. Nous avons choisi la version 1.2 plutôt que la version 1.3 car cette dernière (v 1.3) n’est qu’en version beta et nécessite Python pour être exécutée.

-          WinCVS a besoin de TCL/tk pour exécuter certains scripts. Il faut donc l'installer. Ceci est disponible à l’adresse http://prdownloads.sourceforge.net/tcl/tcl84a3.zip.

 

4.                  Configuration

La configuration doit commencer par l'installation de ssh. Ceci est disponible dans le programme de configuration de CVS nommé SFSetup. Ce programme est disponible à l’adresse http://sfsetup.sourceforge.net. Ce programme installera et configurera ssh, puis mettra à jour WinCVS pour qu'il prenne en compte ssh.

4.1               SFSetup

Ce programme vous demandera votre nom de développeur sur Sourceforge (cf. 2‎2-Inscription sur Sourceforge) puis le nom du projet ("isisniper").

4.2               Ssh

Pour pouvoir utiliser cvs par la suite, vous devez exécuter la commande suivante :

                ssh –l user_name cvs.isisniper.sourceforge.net

Le mot de passé que vous avez saisi lors de votre inscription sur Sourceforge vous sera demandé. Cette exécution va se conclure par une interdiction. Ceci est "normal".

A partir de là, vous pourrez utiliser WinCVS avec Sourceforge.

 

5.                  Utilisation de WinCVS

Pour chaque action concernant les fichiers, WinCVS vous demandera votre mot de passe Sourceforge. A chaque fois, une fenêtre MS-DOS doit s’ouvrir (ou être dans la barre des tâches) et vous demander votre mot de passe. C’est la fenêtre « ssh ». Entrez votre mot de passe Sourceforge et la fenêtre MS-DOS va se fermer.

5.1               Première utilisation

Lors de la première utilisation de CVS, vous devez récupérer tous les fichiers concernant le projet. Pour cela, vous devez faire un « checkout » (menu Create -> Checkout module). Le logiciel vous demande alors le nom du module concerné. Entrez « sniper./ ». Dans l’onglet « Globals », cochez l’option « Checkout readonly ». Ainsi, quand vous récupèrerez des fichiers, ils ne seront pas modifiables directement (pour éviter les conflits).

Vous pouvez maintenant valider. Le mot de passe Sourceforge vous sera demandé. A partir de là, dans la fenêtre de WinCVS, les fichiers du projet sont copiés sur votre ordinateur.

5.2               Editer un fichier

5.2.11.1.1Personne n’édite encore ce fichier

Comme dit précédemment, vous ne pourrez pas éditer un fichier automatiquement. Vous devez spécifier au serveur CVS que vous prenez ce fichier en écriture.

 

Pour cela, sélectionnez le ou les fichiers désirés. Vérifiez que personne n’édite ce fichier. Pour cela, dans la barre menu, allez dans « Trace » puis appuyez sur l’option « Editors of selection ». Si personne n’édite ce fichier, Aappuyez ensuite sur le bouton représentant un crayon. Le mot de passe vous sera demandé. A partir de là, vous possédez les droits d’écriture sur le fichier. Cependant, si un autre développeur souhaite modifier ce fichier, il ne saura pas que vous en faites autant. Si quelqu’un est en train d’éditer ce fichier, ne le prenez pas en écriture en même temps. Cela entraînerait des conflits de version.

 

Aussi, il est nécessaire de « locker » le fichier sur le serveur. Pour cela, re-sélectionnez le fichier que vous avez pris en écriture puis appuyez sur le bouton représentant une clé (complètement à gauche). Le mot de passe sera demandé.

Maintenant, si un autre développeur souhaite éditer ce même fichier, un message lui dira que vous avez déjà ce fichier en mode édition.

5.2.21.1.1Quelqu’un édite déjà ce fichier

Au moment d’éditer le fichier (appuie sur le bouton représentant un crayon), un message indiquant qu’un autre développeur modifie ce fichier apparaît. N’apportez pas de modifications au fichier dans ce cas. Contactez plutôt le développeur concerné pour poursuivre.

5.3               Modification d’un fichier

Dès que vous modifiez un fichier géré par CVS, l’icône associé à ce fichier sur CVS devient rouge. Cela signifie que vous y avez apporté des modifications.

5.4               Validation des modifications

Vous avez effectué des modifications sur un fichier et vous souhaitez les publiées. Sélectionnez le(s) fichier(s) concerné(s). Appuyez sur le bouton droit de la souris et cliquez sur « commit selection ». Une boîte de dialogue apparaît vous demandant d’entrer un commentaire. Celui-ci est nécessaire pour connaître rapidement les modifications apportées « globalement » au(x) fichier(s).

Validez et le mot de passe vous sera (encore) demandé. Après cela, les fichiers sur le serveur seront mis à jour.

5.5               Annulation des modifications

Si vous avez fait des modifications « inutiles » et que vous souhaitez les annuler, sélectionnez le(s) fichiers(s) concerné(s). Appuyez sur le bouton représentant une gomme (à côté du crayon). Le mot de passe vous sera demandé. Après cela, les modifications que vous avez apportées au(x) fichier(s) seront annulées (sur le serveur et sur votre ordinateur).

5.6               Ajout d’un nouveau fichier au projet

Si vous créez un fichier et que vous souhaitez l’ajouter au projet, sélectionnez-le. Appuyez ensuite sur le bouton représentant un « plus » rouge sur fond blanc. Il existe le même juste à côté, mais avec « 01 » en dessous. Cela ne servira pas dans notre projet.

5.7               Mise à jour des fichiers

Il est nécessaire de mettre à jour les fichiers régulièrement, pour travailler sur la dernière version de ceux-ci. Pour cela, cliquez avec le bouton droit de la souris sur la racine de l’arborescence (isisniper) à gauche de la fenêtre WinCVS. Dans le menu déroulant, cliquez sur l’option « update selection ». Une boîte de dialogue apparaît. Validez directement. Le mot de passe vous sera demandé. Après cela, les fichiers de votre ordinateur seront mis à jour avec la dernière version des fichiers contenus sur le serveur.

5.8               Fenêtre de WinCVS

Voici la présentation de la fenêtre principale de l’outil WinCVS :

 

 

6.                  Conseils d’utilisation

-          Pour n’importe quelle action sur les fichiers, mise à jour, prise en écriture, … vous devez être connecté à Internet.

-          A chaque fois que vous désirez travailler sur un ou des fichiers, pensez à faire une mise à jour de ceux que vous avez sur votre ordinateur, pour travailler sur la dernière version de tous les fichiers (cf. 5.7‎5.7-Mise à jour des fichiers).

-          Avant de prendre un fichier en écriture, pensez à vérifier que personne ne possède déjà ces droits (cf. 5.2‎5.2-Editer un fichier).

-          Dès que vous prenez un fichier en édition, pour le modifier, pensez à le locker. Ainsi, les autres utilisateurs auront un message leur indiquant que vous l’éditez.