eclipse-plugin チュートリアル
eclipse-pluginを使い始める
サーチ…
備考
このセクションでは、eclipse-pluginの概要と、開発者がそれを使用する理由について概説します。
eclipse-plugin内の大きなテーマについても触れ、関連するトピックにリンクしてください。 eclipse-pluginのドキュメンテーションは新しいので、これらの関連トピックの初期バージョンを作成する必要があります。
インストールまたはセットアップ
Java IDEのEclipse IDEがインストールされていると仮定して、 Eclipseを起動し、「 ヘルプ 」 - >「 新しいソフトウェアのインストール... 」をクリックします。
「 すべての使用可能なサイト 」を「 作業者： 」で選択し、「 Eclipseプラグイン開発ツール 」にナビゲートします 。 「 Eclipse Plug-in Development Environment 」を選択すると、その前のチェックボックスがチェックされます。
「 次へ 」をクリックして、Eclipseが必要な依存関係をチェックするようにします。もう一度[ 次へ]をクリックしてインストールを開始してください。
完了したら、Eclipseを再起動します。
こんにちは世界
Eclipse用のHello Worldプラグインを作成するには、 ファイル ➜ 新規 ➜ その他をクリックします。
「 プラグイン・プロジェクト」を選択し、「 次へ」>
新規プラグイン・プロジェクト・ウィザードは、新しいプラグインを作成するためのオプションをガイドします。
プロジェクト名（HelloWorldなど）を入力し、[ 次へ ]をクリックします。
[ コンテンツ]ページでは、プラグインのID 、 バージョン 、 名前 、およびベンダーを設定できます。
バージョンはデフォルトで1.0.0.qualifierになります。これをそのままにしておくことはできますが、これを意味のあるものに変更する方が良いでしょう。 eclipse wikiでは、 vYYYYMMDD （年、月の日）のような構文を推奨しています。
[ テンプレート]ページで、任意のテンプレートからプラグインを作成するかどうかを選択し、[ 次へ> ]をクリックしてプラグインを作成することができます。または、 カスタム・プラグイン・ウィザードを選択してこれらのテンプレートを組み合わせることも、テンプレートなしで新しいプラグインを作成することもできます。 テンプレートの1つを使用してプラグインを作成するの前のチェック・ボックスを選択解除します。
Hello、Worldコマンドテンプレートには、パッケージ名、ハンドラクラス名、メッセージボックスのテキストという追加の設定があります。
プラグインが作成されると、あなたはplugin.xmlの ➜ として実行 ➜Eclipseのアプリケーションを右クリックして、それを実行することができます
これにより、プラグインがロードされるEclipseの新しいインスタンス（独自のワークスペースを持つ）が起動します。
このHello Worldプラグインは、Eclipse GUIに3つの貢献をしました：
1.サンプルメニュー（サンプルコマンド付き）：
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.ツールバーのアイコン：
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.キーショートカット（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>
これら3つのいずれかをアクティブにすると、Handlerクラスが実行されます。
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;
}
}
Handlerクラスが実行されると、MessageBoxに次の情報が表示されます。
これは、Hello Worldプラグインのすべてです。
より多くの機能を備えたプラグインを作成する場合は、ニーズに最も適したテンプレートを選択するか、 カスタムプラグインウィザードを使用してプラグインを作成して、これらのテンプレートを組み合わせることができます。
