eclipse-plugin Tutoriel
Démarrer avec eclipse-plugin
Recherche…
Remarques
Cette section fournit une vue d'ensemble de ce qu'est eclipse-plugin et pourquoi un développeur peut vouloir l'utiliser.
Il devrait également mentionner tous les grands sujets dans eclipse-plugin, et établir un lien avec les sujets connexes. La documentation de eclipse-plugin étant nouvelle, vous devrez peut-être créer des versions initiales de ces rubriques connexes.
Installation ou configuration
En supposant que vous ayez installé Eclipse IDE pour les développeurs Java , démarrez Eclipse, cliquez sur " Aide " -> " Installer un nouveau logiciel ... "
Sélectionnez " --Tous les sites disponibles " dans " Travailler avec " et accédez à " Outils de développement des plug-ins Eclipse ". Sélectionnez " Environnement de développement de plug-in Eclipse " en cochant la case en regard de celui-ci.
Cliquez sur " Suivant " pour laisser Eclipse vérifier les dépendances nécessaires. Cliquez à nouveau sur " Suivant " pour lancer l'installation.
Une fois cette opération terminée, redémarrez Eclipse.
Bonjour le monde
Pour créer un plug-in Hello World pour Eclipse, cliquez sur: Fichier ➜ Nouveau ➜ Autre ...
Sélectionnez Projet de plug-in et cliquez sur Suivant>
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>
Sur la page Contenu , vous pouvez définir l' ID , la version , le nom et le fournisseur 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 changer cela pour quelque chose de significatif. Le wiki eclipse recommande une syntaxe comme vYYYYMMDD (année, mois jour).
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 Plug-in personnalisé ou pour créer un nouveau plug-in sans modèle en désélectionnant la case à cocher devant Créer un plug-in à l'aide de l'un des modèles .
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.
Lorsque le plug-in est créé, vous pouvez l'exécuter en cliquant avec le bouton droit de la souris sur plugin.xml ➜ Exécuter en tant qu'application Eclipse
Cela lancera une nouvelle instance d'Eclipse (avec son propre espace de travail) sur laquelle votre plug-in sera chargé.
Ce plug-in Hello World aura apporté 3 contributions à l'interface graphique d'Eclipse:
1. Un exemple de menu (avec exemple de commande):
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:
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 affiche:
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 avez peut-être choisi un modèle qui correspond le mieux à vos besoins ou créé un plug-in via l' assistant de plug-in personnalisé pour combiner ces modèles:
