#内容
既存のEclipseプラグインプロジェクトを自身でビルドしインストールするまでの手順をまとめます。
プロジェクトはあるはずなのにお目当てのプラグインがマーケットプレースでの検索でヒットしない場合や、既存のプラグインを修正して利用したい場合等を念頭においています。
#環境
- Windows8.1
- Jdk11
- ビルドに利用するEclipseのVersion: 2019-03
- プラグインをインストールするEclipseのVersion: 2018-12
- ビルドするプラグイン: DBViewer Plugin
#プラグイン開発用プラグインのインストール
Eclipse PDEをインストールします。
Java用のPleiades All in One Eclipseを利用している場合など、インストール済みの場合はこのステップは飛ばします。
#既存のEclipseプラグインプロジェクトのダウンロード
任意のプロジェクトをダウンロード or Pullし、任意のディレクトリに展開します。
今回はGitHub上のDBViewer Pluginを使用しています。
zipファイルをダウンロードし「C:\app\project\dbviewer-master」に解凍しました。
#既存のEclipseプラグインプロジェクトのインポート
先ほどのステップで入手したプロジェクトをEclipseにインポートします。
-
「File > Import > General > Existing Project into Workspace」を選択し「Next >」。
-
「Select root directory:」にて先ほどの手順でプロジェクトを展開したディレクトリを指定し「Finish」。
「Project Explorer」でインポートしたプロジェクトを確認できるようになります。
プロジェクト直下「plugin.xml」の「Overview」にて「Testing > Launch an Eclipse application」を実行するなどしてプラグインの動作確認が行えます。
#プロジェクトのビルド
ここから先は、基本的に「Help > Welcome」にて表示されるページ「Tutorials > Create an Eclipse plug-in」の以下「赤枠」の順に作業すればＯＫです。
featureを作成する
「Plug-in Development」パースペクティブにて「feature」を作成します。
-
「File > New > Feature Project」にて必要事項を入力し「Next > 」。赤枠以外はデフォルトとしました。
-
対象のプラグインを選択し「Finish」。
「Project Explorer」で追加した「feature」を確認できるようになります。
「feature.xmlをダブルクリック > Information」にて、任意で「Feature Description」や「License Agreement」を記入し、保存します。
update siteを作成する
「Plug-in Development」パースペクティブにて「update site」を作成します。
ここではファイルサーバー上の共有ディレクトリ等を「update site」とすることを想定しています。
-
「File > New > Project > Plug-in Development > Update Site Project」にて「Project Name:」と「Location:」を記入し「Finish」。
-
「Project Explorer」で追加した「update site」を確認できます。「site.xmlをダブルクリック > Archives」にて、任意で「Description:」等を記入し、保存します。
-
「site.xml」の「Site Map」にて、「New Category」をクリックします。追加されたcategoryに対して任意の「ID」「Name」を記入し、保存します。
-
引き続き「site.xml」の「Site Map」にて、先ほど追加したcategoryを選択し、「Add Feature」をクリックします。ポップアップ上で「featureを作成する」手順にて作成した「feature」を選択し「Add」の後、保存します。
ビルド&update siteへの公開
いよいよビルドです。「update siteを作成する」手順４で作成した「site.xml > Site Map」の「feature」を選択し「Build All」。
ビルドが完了すると以下のように「update site」の「features」ディレクトリと「plugins」ディレクトリにjarが作成されます。
#インストール
対象のEclipseを起動しプラグインをインストールします。
-
「Help > Install New Software」において「update site」のURLを記入し、「Add」をクリックすると、先ほどビルドしたプラグインが表示されます。チェックを付けて「Next >」
-
「Install Detail」にて「Next >」
-
ライセンスを確認し「I accept ～」を選択し「Finish」（今回はインストールできることの確認のみ行うためライセンスは記入していません。）
インストール完了後に再起動すると、インストールしたプラグインが使用できるようになっています。
参考資料
Eclipseにおいて「Help > Welcome」にて表示されるページ「Tutorials > Create an Eclipse plug-in」