白黒羊

RiderでPlantUMLを使ってUnityのためのクラス図を書く

2019/04/29

Riderでもクラス図を書きたい！

クラス図を書くにはVisual Studioを使わないといけないのかなと思っていたのですが、Riderでも書けたのでメモしておきます。
Unityプロジェクトでの使用を考えていますがUnity以外でももちろん使えます。

PlantUMLのインストール

(Windows) [File] > [Settings] > [Plugins]
(Mac) [JetBrains Rider] > [Preferences] > [Plugins]
「PlantUML Integration」の「Install」をクリックします。

Riderを再起動しろと言ってくるので表示にしたがって再起動してください。

Rider EAPでPlantUMLを使ってみる – Qiita

Graphviz

ダウンロード

Graphviz はグラフデータ構造を可視化するツールです。
PlantUMLの可視化に使うのでダウンロードしましょう。
Graphviz – Graph Visualization Softwareの「Download」からStable版をダウンロードします。
私はWindowsを使っているので、.msiファイルをダウンロードしてインストールしました。
他のOSからのインストールの方法も記載がありました。

dot.exeの設定

PlantUMLの「Graphviz dot executable」の設定

右上の赤枠のところに今インストールしたファイル群に含まれる「dot.exe」を指定します。

Windows で Graphviz のインストール

PlantUML Config

お好みですが見た目を良い感じにするために下記リンクのようなことを「PlantUML Config」欄に書いておきます。

plantuml の style をモダンにする — Think Abstract

PlantUMLの起動

「PlantUML」ウィンドウを開く

[View] > [Tool Windows] > [PlantUML] でPlantUMLウィンドウを開きます。

PlantUMLファイルを開くまでは使い方（英語）が表示されているので、それを読んでから使います。

新規.pumlファイルの追加

まずは、[File] > [Settings] を開き、 [Editor] > [File Templates] > [Other languages] にPlantUMLファイルを追加してあげます。

PlantUMLファイルを追加する設定

左上の [+] ボタンを押して「Name」を「PlantUML」、「extension」を[puml」にします。
pumlのテンプレートを持っていれば、その下の空間に書いておくと自動で表示されるので便利です。
私は何を書けば良いのかわからなかったので、とりあえず始まりと終わりのコマンドだけ書いておきました。
この設定ができたら [Save] を押して [settings] ウィンドウを閉じます。

そして、Riderの「Explorer」Viewのモードが「Unity」だと「Assets」フォルダと「Packages」フォルダしか表示してくれないので、「FileSystem」モードに切り替えます。

「Explorer」の表示モードを「FileSystem」に切り替える

今回はUnityのプロジェクトフォルダ直下に「UML」フォルダを作り、その中にPlantUMLファイルを入れることにしました。
この辺のフォルダ構成はたぶんもっと適切な方法がある気がします。知りたいです。
作った「UML」フォルダを [右クリック] > [Add] > [PlantUML] でPlantUMLファイルを作ります。

新規PlantUMLファイルを追加する
@startuml

class Object {
 +equals()
}

class ArrayList {
 -Object[] elementData
 +size()
}

class Dummy {
 -field1
 #field2
 ~method1()
 +method2()
}

Object <|-- ArrayList

@enduml

この辺のPlantUMLファイルのUnityでのゲーム設計用テンプレートないのかな……。
クラス図作っていくうちにできていくのか……。

これを書くと、PlantUMLウィンドウにクラス図が表示されました。やった！！

PlantUMLウィンドウに表示されるクラス図

画像として保存もできるので便利です。

最後に

ここまででようやくクラス図を書く準備ができただけなので、これから実際に書き方を勉強して書くことになります。

また、Riderでは「@startuml」「@enduml」には色付けてくれるのですが、「misc files」扱いになってしまうので、.pumlファイルのシンタックスハイライトはできませんでした。
大人しく「VisualStudio」+「Reshaper」使うとかJetBrains使うにしても「IntelliJ IDEA」にするとかが楽そう（結局）。

クラス図を書く上での参考リンク集