Premiers pas avec le plugin eclipse
Sur cette page
Bonjour le monde
Pour créer un plug-in Hello World pour Eclipse, cliquez sur : Fichier ➜ Nouveau ➜ Autre…
[![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.xml ➜ Exécuter en tant que ➜ Application 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