# Guide de démarrage rapide

Ce tutoriel présente le plan de travail et donne un aperçu rapide des étapes nécessaires à la création d'applications simples. Vous trouverez de plus amples informations, illustrées par des images, dans le guide d'utilisation du plan de travail.

Guide de démarrage rapide du plan de travail

Tâche | Description

Créer un projet simple

1. Sélectionnez Fichier > Nouveau > Projet....
2. Dans l'assistant Nouveau projet, sélectionnez Simple > Projet puis cliquez sur Suivant.
3. Dans la zone Nom du projet, entrez le nom du nouveau projet.

4. Précisez l'emplacement du projet ou gardez celui par défaut.

5. Cliquez sur Terminer.

Créer un dossier

1. Assurez-vous qu'un ou plusieurs projets existent.
2. Sélectionnez Fichier > Nouveau > Dossier.
3. Dans la zone Dossier de l'assistant Nouveau dossier, entrez le nom à attribuer au nouveau dossier.
4. Cliquez sur Terminer.

Créer un fichier

1. Assurez-vous qu'un ou plusieurs projets existent.
2. Sélectionnez Fichier > Nouveau > Fichier.
3. Dans la zone Nom du fichier de l'assistant Nouveau fichier, entrez le nom du nouveau fichier.
4. Cliquez sur Terminer.

Importer des ressources

1. Cliquez sur Fichier > Importer.
2. Sélectionnez la source de l'importation.
3. Cliquez sur Suivant.
4. Sélectionnez l'emplacement de la ressource à importer en suivant les étapes indiquées dans l'assistant de l'application.
5. Cliquez sur Terminer.

Exporter des ressources

1. Cliquez sur Fichier > Exporter.
2. Sélectionnez la source de l'exportation.
3. Cliquez sur Suivant.
4. Sélectionnez l'emplacement de la ressource à exporter en suivant les étapes indiquées dans l'assistant de l'application.
5. Cliquez sur Terminer.

Créer un projet Java : exemple JUnit

1. Pour télécharger le code source de JUnit, allez sur la page http://www.eclipse.org/downloads/ et rechercher la version d'Eclipse avec laquelle vous travaillez.
2. Faites défiler la section Plug-in des exemples et téléchargez l'archive des exemples.
3. Extrayez le contenu du fichier zip dans un répertoire.
4. Dans Eclipse, sélectionnez Fichier > Nouveau > Projet....
5. Sélectionnez Projet Java puis cliquez sur Suivant.
6. Dans la zone Nom du projet, entrez JUnit.
7. Cliquez sur Terminer.
8. Dans la vue Packages, assurez-vous que le projet JUnit est sélectionné.
9. Sélectionnez l'option de menu Fichier > Importer.
10. Sélectionnez le fichier zip puis cliquez sur Suivant.
11. Cliquez sur le bouton Parcourir en regard de la zone Fichier zip puis recherchez et sélectionnez <ExamplesDownloadPath>eclipse/plugins/org.eclipse.jdt.ui.examples.projects_3.0.0/archive/junit/junit381src.jar.

12. Dans l'assistant d'importation, sous la liste de la hiérarchie, cliquez sur Sélectionner tout.

13. Une fois que le projet JUnit apparaît dans la zone de destination Dossier, cliquez sur Terminer.

14. Dans l'indicateur de progression de l'importation, notez que les ressources sont compilées lors de leur importation dans le plan de travail. Cela est dû au fait que l'option Compiler automatiquement est sélectionnée dans la page des préférences du plan de travail. Vous êtes alors invité à remplacer les fichiers .classpath et .project dans le projet JUnit. Ceci est dû au fait que la ressource .classpath a été créée pour vous lorsque vous avez créé le projet JUnit. Vous pouvez remplacer ces fichiers.
    Dans la vue Packages, développez le projet JUnit pour afficher les packages JUnit.

Créer une classe Java : exemple JUnit

1. Dans la vue Packages, cliquez avec le bouton droit de la souris sur le projet JUnit puis sélectionnez Nouveau > Package.
2. Dans la zone Nom, entrez test comme nom de votre nouveau package.
3. Cliquez sur Terminer.
4. Dans la vue Packages, sélectionnez le nouveau package test puis cliquez sur Nouvelle classe Java dans la barre d'outils. Assurez-vous que JUnit apparaît dans la zone Dossier source et que le nom test apparaît dans la zone Package.
5. Dans la zone Nom, entrez MyTestCase.
6. A côté de la zone Superclasse, cliquez sur le bouton Parcourir.
7. Dans la zone Choisissez un type de la boîte de dialogue Sélection de la superclasse, entrez Test pour restreindre la liste des superclasses disponibles.
8. Sélectionnez la classe TestCase et cliquez sur OK.
9. Cochez la case Constructeurs de la superclasse.
10. Cliquez sur Terminer.
11. Le nouveau fichier s'affiche dans l'éditeur. Dans la vue Structure, sélectionnez la nouvelle classe MyTestCase. Ouvrez le menu contextuel et sélectionnez Source > Remplacer/implémenter les méthodes.
12. Dans la boîte de dialogue Remplacement des méthodes, cochez les cases setUp() et tearDown() puis cliquez sur OK.
13. Modifiez le corps de setUp() en container= new Vector();.
14. Container et Vector sont soulignés par une marque de mise en évidence des erreurs car ils ne peuvent pas être résolus. Une ampoule apparaît sur la barre de marqueurs. Placez le curseur dans Vector et appuyez sur les touches Ctrl+1 (ou sélectionnez Editer > Correctif rapide dans la barre de menus). Choisissez Importer 'Vector' (java.util). L'instruction d'importation manquante est ajoutée.
15. Placez le curseur dans Container et appuyez sur Ctrl+1. Sélectionnez Créer la zone 'container' pour ajouter la nouvelle zone.
16. Dans la vue Structure, sélectionnez la classe MyTestCase. Ouvrez le menu contextuel et sélectionnez Source > Générer les méthodes Getter et Setter.
17. La boîte de dialogue Génération des méthodes Getter et Setter propose de créer les méthodes getContainer et setContainer. Sélectionnez les deux propositions et cliquez sur OK. Les méthodes getter et setter du conteneur de zone sont ajoutées.
18. Sauvegardez le fichier.
19. Le formatage du code généré peut être configuré dans Fenêtre > Préférences > Java > Style de code > Module de formatage de code. Si vous utilisez un préfixe ou un suffixe pour les noms de zone, vous pouvez l'indiquer en sélectionnant Fenêtre > Préférences > Java > Style de code > Zones, afin que les getter et setter générés suggèrent des noms de méthodes sans préfixe, ni suffixe.

Lancer un programme Java : exemple JUnit

1. Dans la vue Packages, recherchez find junit.textui.TestRunner.java et cliquez deux fois dessus pour l'ouvrir dans un éditeur.
2. Dans la vue Structure, notez que la classe TestRunner possède une icône signalant qu'elle définit une méthode main.
3. Cliquez avec le bouton droit de la souris sur TestRunner.java dans la vue Packages, puis sélectionnez Exécuter > Application Java.
4. Sélectionnez Exécuter > Exécuter.... La boîte de dialogue Configurations de lancement s'affiche et la configuration de TestRunner est sélectionnée.
5. Dans la boîte de dialogue Configurations de lancement, sélectionnez l'onglet Arguments et entrez junit.samples.VectorTest dans la zone d'arguments du programme.
6. Cliquez sur Exécuter. Cette fois, le programme s'exécute correctement et indique le nombre de tests effectués.
7. Passez à la perspective Débogage. Dans la vue Débogage, notez qu'un processus du dernier lancement de programme a été enregistré lors de l'exécution du programme.
8. Cliquez sur Exécuter dans la barre d'outils du plan de travail. La liste contient les programmes déjà lancés. Ils peuvent être relancés en les sélectionnant dans l'historique.
9. A l'aide du menu contextuel de la vue Débogage (ou à l'aide des boutons correspondants de la barre d'outils), sélectionnez Supprimer tous les programmes terminés pour effacer les données de la vue indiquant les processus de lancement terminés.

Créer un plug-in

1. Sélectionnez Fichier > Nouveau > Projet.
2. Sélectionnez Projet de plug-in et cliquez sur Suivant.
3. Dans la zone Nom du projet, entrez le nom du projet puis cliquez sur Suivant.
4. Dans la page Contenu du plug-in, définissez les données à l'aide desquelles le fichier plugin.xml sera initialisé, y compris la version et le nom du plug-in.
5. Sélectionnez un modèle disponible puis cliquez sur Suivant.
6. Personnalisez l'extension puis cliquez sur Terminer.

Lancer un plan de travail d'exécution Eclipse pour tester un plug-in

1. Sélectionnez Exécuter > Exécuter....
2. Dans la boîte de dialogue Configuration du lancement, attribuez un nom à votre configuration dans la zone Nom.
3. Dans la zone Données de l'espace de travail, cliquez sur Parcourir pour définir l'espace de travail qu'utilisera le plan de travail d'exécution. Ce dernier ne doit pas être installé au même emplacement que l'espace de travail de l'instance hôte.
4. Dans le champ Exécuter une application, sélectionnez l'application Eclipse par défaut org.eclipse.ui.ide.workbench.
5. Cliquez sur Exécuter.

Une seconde instance de plan de travail d'affiche. Elle est constituée par les plug-in de l'espace de travail et par ceux qui ont été sélectionnés dans la page de préférences Plateforme cible. Vous pouvez tester le plan de travail d'exécution à l'aide de l'environnement JRE de votre choix, qui ne doit pas obligatoirement correspondre à celui dans lequel les plug-in sont compilés dans l'espace de travail. Vous pouvez également spécifier n'importe quel argument VM adapté au test.

Générer automatiquement des compilations

1. Sélectionnez Fenêtre > Préférences.
2. Sélectionnez la catégorie Général dans la sous-fenêtre de gauche.
3. Sélectionnez Compiler automatiquement.
4. Cliquez sur OK.

Générer manuellement des compilations

1. Dans la vue Navigateur de la perspective Ressource, sélectionnez un ou plusieurs projets.
2. Cliquez à l'aide du bouton droit de la souris sur l'option Compiler un projet dans le menu en incrustation.

Démarrage rapide de CVS

Remarque : Un serveur CVS doit avoir été configuré sur la machine hôte pour pouvoir créer un emplacement de référentiel correct dans le plan de travail.

Tâche | Description

Création d'un emplacement de référentiel CVS

1. Sélectionnez Fenêtre > Afficher la vue > Autre....
2. Sélectionnez CVS > Référentiels CVS.
3. Cliquez sur Ajouter un référentiel CVS.
4. Entrez les informations requises pour vous identifier et vous connecter à l'emplacement du référentiel.
5. Cliquez sur Terminer.

Connexion et configuration de CVS avec SSH

1. Sélectionnez Fenêtre > Préférences.
2. Sélectionnez Equipe > CVS > Méthode de connexion SSH2.
3. Sélectionnez l'onglet Général, cliquez sur Ajouter une clé privée et ajoutez une clé privée à la liste.
4. Indiquez un mot de passe pour votre clé privée et enregistrez-le sur votre ordinateur.

Si vous ne disposez pas d'une paire de clés :

1. Sélectionnez Fenêtre > Préférences.
2. Sélectionnez Equipe > CVS > Méthode de connexion SSH2.
3. Sélectionnez l'onglet Gestion des clés.
4. Si votre serveur prend en charge la version 1 du protocole, sélectionnez Générer une clé RSA. Pour la version 2, sélectionnez Générer une clé DSA. Une clé publique et une clé privée vont être générées. La clé publique s'affiche dans la zone de texte en lecture seule.
5. Copiez la clé publique sur votre serveur. Si ce dernier exécute un serveur OpenSSH, cliquez sur Exporter via sftp. Dans le cas contraire, copiez et collez la clé publique dans le fichier distant ~/.ssh/authorized_keys.

Réservation d'un projet à partir d'un référentiel CVS

1. Placez-vous dans la perspective de recherche de référentiel CVS.
2. Dans la vue Référentiels CVS, développez l'emplacement du référentiel.
3. Développez HEAD, puis sélectionnez les dossiers à ajouter en tant que projets dans le plan de travail.
4. Dans le menu, sélectionnez l'une des options suivantes pour les dossiers sélectionnés :
   - Réserver, afin de réserver chacun des dossiers sélectionnés, en tant que projet dans l'espace de travail local, à l'aide du même nom que celui du dossier du référentiel.
   - Réserver en tant que..., afin de réserver les dossiers sélectionnés dans un projet configuré personnalisé de l'espace de travail local.

Synchronisation avec le référentiel et mise à jour ou validation des modifications

1. Dans la vue Navigateur, sélectionnez les ressources à synchroniser.
2. Cliquez à l'aide du bouton droit de la souris sur Equipe > Synchroniser avec le référentiel.
3. Dans la vue Synchronisation, cliquez avec le bouton droit de la souris sur la ressource et sélectionnez l'une des options suivantes :
   - Valider, si vous souhaitez écraser la version CVS actuelle et enregistrer votre version dans le référentiel.
   - Mettre à jour, si vous souhaitez mettre à jour votre espace de travail avec la version stockée dans le référentiel.