Eclipse Sirius を使って配布用プラグインを作成するまでを解説

1. Eclipse Sirius in 30 min.
Dec. 12, 2019, 18:30〜19:00
view5 LLC
田中 (a.tanaka@view5.co.jp, akira.odp@gmail.com)

2. 目次
• 準備作業
• 手順概要
• Ecore モデル作成
• Genmodel からのコード生成
• もう一つの Eclipse インスタンス起動
• ビューポイントモデル（odesignファイル）作成
 多分途中までになると思います・・・ 30分で出来るところまで
2

3. 準備作業
• Eclipse のインストールは次のいずれかの方法で行います
• Eclipse Modeling Tools のダウンロード＆解凍・インストール
• 現在の最新リリース版は 2019-09（もうすぐ12月のリリースが出ますが、動作確認出来ているこちらでお願いしま
す）
• https://www.eclipse.org/downloads/packages/
• Eclipse のインストーラをダウンロードした場合も Modeling Tools をインストールします
• Eclipse Modeling Tools に Sirius Specifier Environment をインストール
• Help -> Install New Software … から 2019-09 のリポジトリを選択し、Modeling フォルダ配下にあるのでチェック
マークをつけてインストールしてください
• ObeoDesigner のダウンロード＆解凍・インストール
• https://www.obeodesigner.com/en/download から Community 版をダウンロード
• 違いは、前者が Eclipseとしての最新版、後者が商用ソフトウェアの Community 版
3

4. 手順概要
1. 最初に、どのような問題領域について「何をどのようなダイアグラムで表現したいのか」をノートやホワイト
ボードなどを使って考えます。そして、そこからモデルの基の概念を抜き出しておきます。
2. File | New | Project -> Eclipse Modeling Framework | Ecore Modeling Project によりプロジェクトを作成し、
Ecore モデルを作成します。この時、ついでにテスト用モデルデータも作成します（ダイナミックインスタン
スという機能を利用します）。
 Ecore モデルは MOF モデル相当で、書きだしたモデルの基の概念を要素とし関連付けたものです（後で例を示します）
そしてこれはモデリング言語を定義していることになっています
3. Ecore モデルが完成すると、同時に genmodel が出来ています。これをメインエディタエリアに専用木構造エ
ディタで表示し、ルートの右クリックから、モデルコード、Editコード、Editorコードを生成します。
4. Run -> Run Configuration から、もう一つの Eclipse インスタンスを起動します。
5. ビューポイントモデル（odesignファイル）を作成し、サンプルモデルをダイアグラム表示出来るようにしま
す。
6. ツールとして完成させるには、パレットの作成の他、画面に現れない設定等も行います。
7. 完成後は、プラグインとしてexportしたり、ビルド作業を行い独立したアプリケーションにしたりしますが、
本日は30分なので出来るところまで。
4

5. Ecore モデル作成
• Ecore モデルは Ecore Diagram Editor のパレットにあるモデル要素だけで記述します
（MOF モデル相当なので、UML Class図のサブセットに相当します）
• 最も簡単なボックスとライン（NodeとEdge or Link）から構成される例として、JR東日本
の山手線（ループ型）＋中央線（直線型）の混在モデル（但し山手線の枠内）です。駅
がNodeで路線がLinkです。
駅 線路
モデル
from
to名前
路線型
（山手線か中央線か両方か）
東京新宿
5

6. 6

7. サンプルモデルを作成します
• Ecore モデルのルート要素を右クリックし、ダ
イナミックインスタンスを作成します。
• 作成された Model.xmi に適当なデータを追加
します。
7

8. サンプルモデルを作成します
8

9. Genmodel からのコード生成
• genmodel 自体またはルートパッケージの右
クリックから Generate All を選びます。
9

10. もう一つの Eclipse インスタンス起動
• 作成したプラグインを
組み込んだEclipseインス
タンスを起動します。
10

11. もう一つの Eclipse インスタンス起動
11

12. ビューポイント仕様（odesignファイル）作成
• 新たな workspace に、Sirius の Modeling Project を作成し、サンプルとして作成した
Model.xmi をインポートします。
• Viewpoint Specification Project を新規作成し、そのなかの odesign ファイルを編集します。
12

13. ビューポイント仕様（odesignファイル）作成
13

14. ビューポイント仕様が出来たら
• サンプルプロジェクトの右クリックからビューポイントを選びます
14

15. モデルの可視化（ダイアグラム表示）
• Model（ルート要素）を
基準としたダイアグラム
を作成します
15

16. 16

17. パレットの設定
• odesignファイルに section を
設け、その配下に必要な項目
を追加してゆきます。
17

18. 18

19. 簡単なツールの配布方法
• 新たな Eclipse インスタンスで作成し
た my.project.design プロジェクトを、
最初の Eclipse インスタンス側にイン
ポート（既存プロジェクトのインポー
ト）します。
• ワークスペースには最初に作成した３
つのプラグインと合わせて４つのプラ
グインが含まれることになります。
• 全部のプラグインプロジェクトを
export します（右図を参照）。
• 出来上がったプラグインを配布し利用
者側で Eclipse 内の dropins フォルダに
入れてもらいます。これが最も単純な
配布方法です。
19

20. ツール作りで重要なデータ
• 今回の例題では次の２つだけです。
• “trainmap.ecore”
• “project.odesign”
• .ecoreファイル
• ポータビリティがあります。つまり、このファイルをコピーして別のプロジェクトで再
利用（そのまま使ったり、修正を加えて使ったり）出来ます。
• ”trainmap.genmodel” にはプロジェクト固有の情報が追加されるためコピペは出来ません。
• .odesignファイル
• ポータブルではありませんが、マッピング定義は将来ないし別のプロジェクトで参考に
なる場合があります（一種のパターンに対応している場合など）。
• チームでも個人でも、再利用推進という意味で、これらファイルをカタログ化して管理
するのが良さそうです。
20

21. リファレンス
• Eclipse Sirius
• ホームページ: https://www.eclipse.org/sirius/
• Get Started: https://www.eclipse.org/sirius/getstarted.html
• GALLERY: https://www.eclipse.org/sirius/gallery.html
• チュートリアル
• StarterTutorial: https://wiki.eclipse.org/Sirius/Tutorials/StarterTutorial
• AdvancedTutorial: https://wiki.eclipse.org/Sirius/Tutorials/AdvancedTutorial
• CompartmentsTutorial: https://wiki.eclipse.org/Sirius/Tutorials/CompartmentsTutorial
• Mindstorms: https://wiki.eclipse.org/Sirius/Tutorials/Mindstorms
• ドキュメンテーション
• https://www.eclipse.org/sirius/doc/3.1.x/index.html
• Sirius 適用例
• UML-Designer: https://github.com/ObeoNetwork/UML-Designer
21