Premiers pas avec le plugin eclipse

Bonjour le monde

Pour créer un plug-in Hello World pour Eclipse, cliquez sur : FichierNouveauAutre…

[![Plug-in Eclipse Sélection d’un nouveau projet][1]][1]

Sélectionnez Projet de plug-in et cliquez sur Suivant >

[![Plug-in Eclipse Sélection du projet de plug-in][2]][2]

L’assistant Nouveau projet de plug-in vous guidera à travers les options de création d’un nouveau plug-in.

Entrez un nom de projet (comme HelloWorld) et cliquez sur Suivant >

[![Plug-in Eclipse Nouveau plug-in][3]][3]

Sur la page Contenu, vous pouvez définir l’ID, la Version, le Nom et le Vendeur du plug-in.

La version sera 1.0.0.qualifier par défaut. Vous pouvez laisser cela tel quel, mais il est préférable de le changer en quelque chose de significatif. Le [wiki eclipse][4] recommande une syntaxe comme vYYYYMMDD (année, mois jour).

[![Contenu du plug-in Eclipse][5]][5]

Sur la page Modèles, vous pouvez choisir de créer votre plug-in à partir de n’importe quel modèle en le sélectionnant et en cliquant sur Suivant >. Vous pouvez également combiner ces modèles en choisissant Assistant de plug-in personnalisé, ou créer un nouveau plug-in sans modèle en décochant la case devant Créer un plug-in à l’aide de l’un des modèles.

[![Sélection de modèle de plug-in Eclipse][6]][6]

Pour le modèle Hello, World Command, il existe des paramètres supplémentaires : le nom du package, le nom de la classe du gestionnaire et le texte de la boîte de message.

[![Paramètres Hello World du plug-in Eclipse][7]][7]

Lorsque le plug-in est créé, vous pouvez l’exécuter en cliquant avec le bouton droit sur plugin.xmlExécuter en tant queApplication Eclipse

Cela lancera une nouvelle instance d’Eclipse (avec son propre espace de travail) qui aura votre plug-in chargé.

[![Plug-in Eclipse Exécuter en tant qu’application Eclipse][8]][8]

Ce plug-in Hello World aura apporté 3 contributions à l’interface graphique d’Eclipse :

1. Un exemple de menu (avec exemple de commande) :

[![Entrée de menu du plug-in Eclipse][10]][10]

Plugin.xml :

<extension
      point="org.eclipse.ui.menus">
   <menuContribution
         locationURI="menu:org.eclipse.ui.main.menu?after=additions">
      <menu
            label="Sample Menu"
            mnemonic="M"
            id="HelloWorld.menus.sampleMenu">
         <command
               commandId="HelloWorld.commands.sampleCommand"
               mnemonic="S"
               id="HelloWorld.menus.sampleCommand">
         </command>
      </menu>
   </menuContribution>
</extension>

2. Une icône de barre d’outils :

[![Icône de la barre d’outils du plug-in Eclipse][9]][9]

Plugin.xml :

<extension
      point="org.eclipse.ui.menus">
   <menuContribution
         locationURI="toolbar:org.eclipse.ui.main.toolbar?after=additions">
      <toolbar
            id="HelloWorld.toolbars.sampleToolbar">
         <command
               commandId="HelloWorld.commands.sampleCommand"
               icon="icons/sample.gif"
               tooltip="Say hello world"
               id="HelloWorld.toolbars.sampleCommand">
         </command>
      </toolbar>
   </menuContribution>
</extension>

3. Un raccourci clavier (Ctrl+6)

Plugin.xml :

<extension
      point="org.eclipse.ui.bindings">
   <key
         commandId="HelloWorld.commands.sampleCommand"
         contextId="org.eclipse.ui.contexts.window"
         sequence="M1+6"
         schemeId="org.eclipse.ui.defaultAcceleratorConfiguration">
   </key>
</extension>

Lors de l’activation de l’un de ces 3, la classe Handler sera exécutée :

Plugin.xml :

<extension
      point="org.eclipse.ui.commands">
   <category
         name="Sample Category"
         id="HelloWorld.commands.category">
   </category>
   <command
         name="Sample Command"
         categoryId="HelloWorld.commands.category"
         id="HelloWorld.commands.sampleCommand">
   </command>
</extension>
<extension
      point="org.eclipse.ui.handlers">
   <handler
         commandId="HelloWorld.commands.sampleCommand"
         class="helloworld.handlers.SampleHandler">
   </handler>
</extension>

SampleHandler.java :

package helloworld.handlers;

import org.eclipse.core.commands.AbstractHandler;
import org.eclipse.core.commands.ExecutionEvent;
import org.eclipse.core.commands.ExecutionException;
import org.eclipse.ui.IWorkbenchWindow;
import org.eclipse.ui.handlers.HandlerUtil;
import org.eclipse.jface.dialogs.MessageDialog;

/**
 * Our sample handler extends AbstractHandler, an IHandler base class.
 * @see org.eclipse.core.commands.IHandler
 * @see org.eclipse.core.commands.AbstractHandler
 */
public class SampleHandler extends AbstractHandler {

    @Override
    public Object execute(ExecutionEvent event) throws ExecutionException {
        IWorkbenchWindow window = HandlerUtil.getActiveWorkbenchWindowChecked(event);
        MessageDialog.openInformation(
                window.getShell(),
                "HelloWorld",
                "Hello, Eclipse world");
        return null;
    }
}

Lorsque la classe Handler est exécutée, MessageBox affichera :

[![Boîte de message du plug-in Eclipse][11]][11]

C’est tout ce que fait le plug-in Hello World.

Si vous souhaitez créer un plug-in avec plus de fonctionnalités, vous auriez pu choisir un modèle qui correspond le mieux à vos besoins ou créer un plug-in via l’assistant de plug-in personnalisé pour combiner ces modèles :

[![Sélection de modèle de plug-in Eclipse][12]][12]

[1] : https://i.stack.imgur.com/JkKGu.png [2] : https://i.stack.imgur.com/xVsaN.png [3] : https://i.stack.imgur.com/zekJu.png [4] : https://wiki.eclipse.org/Version_Numbering#When_to_change_the_qualifier_segment [5] : https://i.stack.imgur.com/R0jHf.png [6] : https://i.stack.imgur.com/iZ2Ha.png [7] : https://i.stack.imgur.com/yby5R.png [8] : https://i.stack.imgur.com/NNdVA.png [9] : https://i.stack.imgur.com/VFCLx.png [10] : https://i.stack.imgur.com/efGq4.png [11] : https://i.stack.imgur.com/kTHZq.png [12] : https://i.stack.imgur.com/tM4be.png

Installation ou configuration

En supposant que [Eclipse IDE for Java Developers][1] est installé, démarrez Eclipse, cliquez sur “Help” -> “Install New Software…

[![entrez la description de l’image ici][2]][2]

Sélectionnez “–Tous les sites disponibles–” dans “Travailler avec :”, et accédez à “Outils de développement de plug-ins Eclipse”. Sélectionnez “Eclipse Plug-in Development Environment” en cochant la case en face.

[![entrez la description de l’image ici][3]][3]

Cliquez sur “Suivant” pour laisser Eclipse vérifier les dépendances nécessaires. Cliquez à nouveau sur “Suivant” pour lancer l’installation.

Une fois cela terminé, redémarrez Eclipse.

[1] : https://www.wikiod.com/fr/eclipse/premiers-pas-avec-eclipse#Installation et configuration [2] : http://i.stack.imgur.com/yDWzj.png [3] : http://i.stack.imgur.com/Xjdqn.png