ツイートはてブ LINE Pocket

プロジェクトの依存関係ダイアグラムを調べる

ReSharper を使用すると、ソリューションアーキテクチャを視覚的に表現して、ソリューション内のプロジェクトの依存関係を調べることができます。

アーキテクチャビューが新しいエディタータブで開き、プロジェクトの依存関係を視覚的に調べたり、ソリューションの現在の状態を以前に取得したスナップショットと比較したりできます。

プロジェクトの依存関係ダイアグラムを開く

ソリューションエクスプローラーでは、1 つまたは複数のプロジェクト、1 つまたは複数のソリューションフォルダー、ソリューションノードを選択します。
選択項目を右クリックして、プロジェクトの依存関係ダイアグラムを表示するを選択するか、メインメニューで ReSharper | アーキテクチャー | プロジェクトの依存関係ダイアグラムを表示するを選択します。
アーキテクチャビューが新しいドキュメントタブで開き、最初に選択したアイテムの依存関係が表示されます。
最初に選択された項目は、アーキテクチャビューの左部分でもチェックされ、すべての解決項目がリストされます。他の項目をチェックすることができます: ダイアグラムに表示され、対応するリンクが追加されます。
必要に応じて、ツールバーのグループ化セレクタを使用して項目のグループ化を変更できます。
- なし - すべてのプロジェクトはグループ化せずに表示されます。
- ソリューションフォルダー - プロジェクトはソリューションフォルダーごとにグループ化されています。
- ファイル構造 - プロジェクトとソリューションフォルダーは、ファイルシステム構造によってグループ化されています。

プロジェクト間のリンクを理解する

ReSharper は、次の 2 つのステップでダイアグラムを作成します。

プロジェクト参照に基づいて依存関係ダイアグラムを作成します。
このステップは、ダイアグラムを開くと自動的に実行され、大規模なソリューションでもほとんど時間がかかりません。
結合(英語)分析を実行して、参照プロジェクトの使用数を計算します。
この手順はリソースを大量に消費し、最大で数分かかる場合がありますが、バックグラウンドで実行されます。分析の進行状況は、アーキテクチャビューの上部にあるステータスバーに反映されます。
結合解析の状態は、カップリング分析を有効にするボタンの状態に対応しています。結合分析はリソースを大量に消費するプロセスであり、大規模なソリューションのパフォーマンスに影響を与える可能性があります。ダイアグラムの操作中にラグが発生した場合は、このボタンを使用して結合分析を無効にし、必要に応じてダイアグラムを調整してから、分析を再度有効にすることができます。分析アルゴリズムは、最初に表示されたプロジェクトの結合を計算し、次にビューから隠されたプロジェクトを処理します。

ダイアグラム内のプロジェクト間のリンクは、次の方法で表示できます。

線種	意味
黒い実線	2 つのノード間にプロジェクト参照があることを示します。これらの行は、結合(英語)分析が進行中または無効になっている場合に使用されるため、プロジェクト間の使用回数は不明です。
特定の幅の青い実線	この参照のカップリング解析は終了しており、参照プロジェクトに少なくとも 1 つの使用箇所が存在します。線の太さは、参照先プロジェクトの型が参照元プロジェクトで使用されている回数を表します。参照の上にマウスを移動すると、この番号がツールチップに表示されます。
点線	結合分析が終了すると表示され、次のいずれかを意味します。あるプロジェクトから別のプロジェクトへのプロジェクト参照があり、`using` ディレクティブがある場合がありますが、コンパイル時の使用箇所はありません。この参照は安全に削除できます。これを行うには、線を右クリックして安全な削除リファレンスを選択します 2 つのプロジェクトは、現在表示されていない他の参照プロジェクトを介してリンクされています。
緑の実線	参照はスナップショットにはありませんが、ソリューションには存在します。差分の表示ボタンがオンの場合のみ表示されます。
赤い実線	参照はスナップショットに存在しますが、解決策にはありません。差分の表示ボタンがオンの場合のみ表示されます。

アイテムの表示と非表示

左側の対応するアイテムのチェックボックスを使用して、ダイアグラムの特定のソリューションアイテム（プロジェクト、フォルダー、ソリューションフォルダー）を表示または非表示にできます。

ダイアグラム領域から直接アイテムを表示 / 非表示にする方法もいくつかあります。

ダイアグラム内のいくつかの項目を選択して他の項目を非表示にするには、選択する項目をクリックしてから Ctrl を選択し、右クリックして選択範囲 | 選択したモジュールのみを表示するを選択します。
2 つのリンクされたアイテムを選択するには、それらの間のリンクを右クリックして選択範囲 | 選択したモジュールのみを表示するを選択します。
項目を非表示にするには、ダイアグラムで項目を選択して Delete を押します。
特定のアイテムに焦点を当てるもう 1 つの方法は、依存プロジェクトまたは参照プロジェクトを表示し、他のすべてのアイテムを非表示にすることです。これを行うには、1 つ以上のアイテム（プロジェクトまたはグループ化アイテム）を選択し、選択範囲を右クリックしてこれを表示 / これらおよび依存 / 参照を選択します。これらのコマンドは、無関係なアイテムのみを非表示にし、現在非表示になっている参照 / 依存ノードを追加しないことに注意してください。
特定のプロジェクトによって参照または依存するすべてのアイテムを表示するには、これらのアイテムが現在表示されていなくても、1 つ以上のアイテムを選択して選択範囲 | 参照 / 依存モジュールを追加するを選択します。

必要に応じて、元に戻すをクリックするか、Ctrl+Z を押して、ダイアグラムの変更（表示 / 非表示のプロジェクト）を段階的に取り消すことができます。元に戻すコマンドを逆にするには、やり直しをクリックするか、Ctrl+Y を押します。

ダイアグラムをパンおよびズームする

ダイアグラムをパンおよびズームするには、ダイアグラム領域の左上隅にあるコントロールを使用します。または、タッチパッド、スクロールバーを使用してダイアグラムをパンするか、ダイアグラムアイテムの外側のダイアグラム領域の任意の場所をクリックして、ハンドカーソルが表示されている間にドラッグすることもできます。マウスホイールを使用してズームすることもできます。

ダイアグラムのアイテムを再配置する

ダイアグラムのレイアウトは自動的に計算されますが、必要に応じて変更できます。すべてのアイテムを移動できます。アイテムを移動するには、まずアイテムをクリックして選択し、次にクロスカーソルが表示されている状態でクリックしてドラッグします。

ダイアグラムでプロジェクトをグループ化する

グループ化セレクターを使用すると、ソリューションフォルダーまたはファイルシステム構造ごとにプロジェクトをグループ化できます。グループ化は、左側の部分とダイアグラムの両方に適用されます。

必要に応じて、次のいずれかの方法で、ダイアグラムのグループ化項目を折りたたんで展開できます。

グループ化アイテムの左上隅にある下向き矢印をクリックします。折りたたむと、記号が上矢印に変わり、クリックしてアイテムを展開できます。
ダイアグラム内のグループ化項目を選択し、Ctrl + Left Arrow と Ctrl + Right Arrow を押します。
ツールバーのツリーを折りたたむとツリーの展開をクリックして、すべてのグループ化項目を折りたたんだり展開したりします。

プロジェクト参照を分析する

あるプロジェクトの型の別のプロジェクトでの使用方法の詳細については、プロジェクト間の対応するリンクを選択して Alt+F7 を押すか、右クリックして使用箇所を表示を選択してください。ReSharper は検索結果ウィンドウでの使用箇所を示します。

特定の参照の結合解析が終了し、ReSharper が未使用として (点線で) ハイライトされた場合、ダイアグラムから切り替えて未使用の参照を削除する必要はありません。選択して Control+Shift+R を押すか、右クリックして選択するだけです。リファクタリング。次に Alt+Delete を押すか、安全なアセンブリ参照の削除をクリックします。

考えられるアーキテクチャの問題を検出する

ソリューションアーキテクチャのベストプラクティスに従おうとしている場合、アプリケーションはおそらく、相互に通信する個別のレイヤーを持つレイヤー構造(英語)を持っています。

可能なパスを表示するボタンを使用すると、グループ化だけでなく、レイヤー間の通信の観点からも、アプリケーションレイヤーが正しく設計されているかどうかを確認できます。要するに、ボタンがオンになっていると、2 つの特定のプロジェクトの間に、現在ビューに隠れている他の参照プロジェクトからなるパスがあるかどうかを確認できます。これらのパスは緑色の点線で示されています。このボタンは、現在表示されているプロジェクトのうちの 2 つをリンクする隠れた中間プロジェクトがある場合にのみ有効になります。

その動作を説明するために、次の例を考えてみましょう。

大きなソリューションを持っており、対応するソリューションフォルダーによって表される「サービス」アーキテクチャレイヤーを分析しているとします。興味を持っている 2 つのプロジェクト、隠されているプロジェクト
2 つのプロジェクトにはプロジェクト間の直接の参照はありませんが、可能なパスを表示するボタンを有効にすると、これらのプロジェクト間に他のプロジェクトがあることがわかります。
これらの 2 つのプロジェクトがどのように相互に依存するかを確認するには、パスリンクを右折してパスの表示を選択します。仲介プロジェクトがダイアグラムに表示され、すべてが別のレイヤーにあることがわかります。

この情報に基づいて、アプリケーション構造を再作成する必要があるかもしれないことがわかります。

ダイアグラムをファイルにエクスポートする

依存関係を調べている任意の時点で、次のツールバーボタンを使用してダイアグラムをファイルにエクスポートできます。

ダイアグラムのエクスポートをクリックします。開いた「名前を付けて保存」ダイアログで、「ファイルの種類 :」セレクターを使用してダイアグラムをエクスポートする方法を選択できます。

PNG — ダイアグラムの現在のビューを PNG イメージにエクスポートします。
XML 用紙仕様 — 大きなダイアグラムを印刷するために使用できる XPS 形式でダイアグラムをエクスポートします。
GraphML — ダイアグラムを GraphML 形式でエクスポートします。これは、外部分析や ReSharper へのインポートに使用できます。

ダイアグラムのインポート

ReSharper からエクスポートした、または別のツールからエクスポートした GraphML 形式のダイアグラムがある場合は、それをインポートできます。これを行うには、メインメニューから ReSharper | アーキテクチャー | ダイアグラムのインポートを選択するか、プロジェクトまたは型の依存関係ダイアグラムでダイアグラムのインポートをクリックしてから、ダイアグラムを含む *.graphml ファイルを選択します。

保存されたスナップショットを現在のソリューションの状態と比較する

いつでも、ソリューションの現在の状態のスナップショットをファイルに保存し、将来の参照に使用できます。これを行うには、ツールバーの「アーキテクチャグラフの保存」をクリックし、スナップショットファイルの保存場所を選択します。

メインメニューで ReSharper | アーキテクチャー | 保存済みと比較…を選択し、ダイアグラムスナップショットファイル .argr を選択することにより、保存されたスナップショットを後でロードして調査できます。

スナップショットが新しいエディタータブで開き、ソリューションの現在の状態とスナップショットに保存された状態の違いを確認できます。

依存関係ダイアグラムがファイルから開かれた場合、差分の表示ボタンが使用可能になり、デフォルトでオンになります。このボタンを使用して、スナップショットと現在のソリューションの状態の違いを表示または非表示にできます。

アーキテクチャビューのツールバーコントロール

コントロール	名前	説明
	グループ化	このリストを使用して、To Do アイテムをグループ化するための条件を選択します。いくつかのオプションが提供されます。なし - すべてのプロジェクトはグループ化せずに表示されます。ソリューションフォルダー - プロジェクトはソリューションフォルダーごとにグループ化されています。ファイル構造 - プロジェクトとソリューションフォルダーは、ファイルシステム構造によってグループ化されています。
	元に戻す	ダイアグラムの変更（表示 / 非表示のプロジェクト）を段階的に元に戻します。
	やり直し	最後の元に戻す操作を元に戻します。
	カップリング解析のオン / オフを切り替える	このトグルボタンを使用すると、バックグラウンドで実行されるカップリング(英語)分析を有効または無効にできます。デフォルトでは、このボタンはオンになっており、新しいダイアグラムを開くとすぐに分析が開始されます。結合分析はリソースを大量に消費するプロセスであり、大規模なソリューションのパフォーマンスに影響を与える可能性があります。ダイアグラムの操作中に遅延が発生した場合は、このボタンを使用して結合分析を無効にし、必要に応じてダイアグラムを調整してから、分析を再度有効にすることができます。分析アルゴリズムは、最初に表示されたプロジェクトの結合を計算し、次にビューから隠されたプロジェクトを処理します。
	推移的な参照を隠す / 表示する	このトグルボタンを使用すると、プロジェクト間の推移的な参照を表示できます。これらはデフォルトで非表示になっており、アーキテクチャー構造を失うことなくダイアグラムを簡素化します。たとえば、プロジェクト参照 `A > B > C` および `A > C` がある場合、このボタンを使用すると `A > C` 参照が非表示になります。
	アーキテクチャグラフを保存する	依存関係のスナップショットをファイルに保存します。詳細については、プロジェクトの依存関係ダイアグラムを調べるを参照してください。
	差分の表示	このボタンは、ビューに表示されるスナップショットが現在のソリューションと異なる場合にのみ有効です。ボタンをクリックして、スナップショット内のソリューションの状態を現在の状態と比較します。
	ツリーを折りたたむ	ダイアグラム内のすべての要素を折りたたみます。
	ツリーの展開	ダイアグラム内のすべての要素を展開します。
	可能なパスを表示する	ボタンがオンの場合、2 つの特定のプロジェクト間に、現在ビューから非表示になっている他の参照プロジェクトで構成されるパスがあるかどうかを確認できます。これらのパスは緑色の点線で示されています。このボタンは、現在表示されている 2 つのプロジェクトをリンクする非表示の中間プロジェクトがある場合にのみ有効になります。詳細については、考えられるアーキテクチャ上の問題の検出を参照してください。
	PNG にエクスポート	ダイアグラムの可視部分を PNG イメージファイルとして保存するには、このボタンをクリックします。