ソリューションのビルド

ReSharper ビルドを開始

デフォルトでは、ReSharper ビルドは無効になっています。有効にするには、次のいずれかの操作を行います。

• ReSharper オプション Alt+R, O のツール | ビルド | 一般ページに移動し、ビルドセクションで ReSharper ビルドを使用するを選択します。

• Build & Run ウィンドウ (ReSharper | Windows | ビルドラン ) を開き、設定 をクリックして ReSharper ビルドを使用するを選択します。

ReSharper ビルドが有効になっている場合、ソリューションを構築するにはいくつかの方法があります。

• Visual Studio ビルドコマンド（ビルド | ソリューションのビルド Ctrl+Shift+B など）のいずれかを使用します。これらのコマンドとショートカットはすべて、ReSharper ビルドによって上書きされます。

• ビルド をクリックするか、ビルドと実行ウィンドウのツールバーのドロップダウンメニューにある他のビルドコマンドを選択します。

• 特定のプロジェクトをビルド、リビルド、クリーンするには、ビルドと実行ウィンドウでプロジェクトを右クリックし、コンテキストメニューで対応するコマンドを選択します。

ReSharper は、すべての Visual Studio バージョンで動作する独自の NuGet 復元機能も提供します。デフォルトでは、ReSharper は各ビルドの前にすべての関連する NuGet パッケージが復元されるようにしますが、ReSharper オプション Alt+R, O のツール | ビルド | 一般ページで対応するチェックボックスをオフにすることで無効にできます。自動復元が無効になっている場合は、ビルドと実行ウィンドウのツールバーで NuGet パッケージを復元する をクリックすることで、いつでも手動で実行できます。

NuGet リストアは、このオプションページで有効になっている場合、ログを出力に書き込みます。また、ReSharper オプション Alt+R, O のツール | NuGet リストラページで、ログメッセージレベルを構成し、リストアのログ情報を表示することもできます。

ビルドプロセス

ReSharper ビルドを初めて実行すると、構成に応じて複数の並列プロセスを使用してすべてのプロジェクトがビルドされます。すべてのビルド管理はアウトプロセスで行われるため、ビルドの実行中も Visual Studio は応答性を維持します。

次回ソリューションをビルドするとき、ReSharper はサポートされているビルド項目が変更されたプロジェクトのみをビルドします。変更が他のプロジェクトで使用されているパブリックタイプに影響する場合は、依存プロジェクトも再構築されます。

変更の影響を受けないプロジェクトは、すべての追加ビルドロジックを含めて完全にスキップされます。スキップされたプロジェクトに対してビルド前およびビルド後のイベントおよび / または BeforeBuild と AfterBuild MSBuild のターゲット(英語)を実行する場合は、ReSharper オプション Alt+R, O のツール | ビルド | 一般ページで対応するチェックボックスを使用します。

ReSharper ビルドは、MSBuild のタスク、ターゲット、プロジェクトへの入力と出力の依存関係グラフを維持し、ファイルシステムの変更を効率的に監視します。ビルドを開始すると、ReSharper ビルドは、MSBuild を呼び出すことなく、タイムスタンプが最新であるかどうかを知っています。タイムスタンプが最新の場合、プロジェクトはスキップされます。

デフォルトでは、ReSharper ビルドは Visual Studio 設定で指定されたものと同じ MSBuild バージョンを使用し、6 つのプロセスを並行して実行します。必要に応じて、MSBuild バージョンを明示的に指定し、ReSharper オプション Alt+R, O のツール | ビルド | 一般ページでプロセス数を変更できます。

ビルドプロセスと概要はビルドと実行ウィンドウに表示されます。

ソリューションのすべてのプロジェクトはグリッド内に視覚化され、それぞれが特定の色で表示されます。プロジェクトの上にマウスを移動すると、状態を説明するツールチップが表示されます。色はプロジェクトのビルド状態を表します。

• 濃い灰色 — プロジェクトはクリーンアップされるか、ビルドされません。

• 灰色 — プロジェクトは、ソリューションビルドから除外されているか、特定のプロジェクトに対してのみビルドを実行し、関連のないプロジェクトがビルドされていないという 2 つの理由のいずれかでビルドされていません。

• ライトブルー — プロジェクトは前回の実行でビルドされたものであり、変更はありません。

• 青 — プロジェクトは前回の実行でビルドされ、変更はありません。それが参照するプロジェクトには、プライベートな変更のみがあります。

• 緑 — プロジェクトが変更されたか、依存プロジェクトの 1 つに公開の変更があった場合、警告なしで正常に再構築されました。

• 黄色 — プロジェクトが変更されたか、依存プロジェクトの 1 つに公開の変更があった場合、警告付きで正常に再構築されました。

• 赤 — プロジェクトが変更されたか、依存プロジェクトの 1 つに公開の変更があったため、プロジェクトのビルドが失敗しました。

現在のビルドをキャンセルする必要がある場合は、メインメニューから ReSharper | ビルド | ビルドをキャンセルするを選択します。

ビルド結果を分析する

ビルドが完了すると、ReSharper はビルド結果ウィンドウにビルドエラー (およびオプションで警告) を表示します。

デフォルトでは、ビルドエラーがある場合にのみ結果が表示されます。必要に応じて、ReSharper オプション Alt+R, O のツール | ビルド | 一般ページでビルド結果を表示する ... セレクターを使用して、警告付きで結果を表示したり、結果を常に表示したり、まったく表示しないようにしたりできます。

ビルド結果ウィンドウでは、次のいずれかの方法でビルド出力をさらに調べることができます。

• グループ化セレクタの複数のオプションの 1 つを使用して結果をグループ化する便利な方法を選択します。

• ビルドエラーがある場合、これらのエラーのみがウィンドウに表示されます。コンパイルの警告も表示したい場合は、ツールバーの警告を表示 をクリックします。

• 前へ / 次へ ボタンまたは Shift+F8/F8 ショートカットを使用して、ビルドメッセージ間を移動します。

• エラーまたは警告の原因となったコードをプレビューするには、プレビューの表示 をクリックするか、Ctrl+P を押します。ウィンドウの左側または下部にあるプレビューペインでは、エラーと警告が赤または青の波線でハイライトされます。

• エラーまたは警告をダブルクリックして、エディターで対応するコード行に移動します。

ReSharper ビルドの構成

ReSharper | オプション | ツール | ビルドの ReSharper オプションページで ReSharper ビルドを設定することができます。

ReSharper オプション Alt+R, O の環境 | 製品と機能ページで ReSharper ビルドチェックボックスをオフにすると、ReSharper ソリューションビルダーを無効にすることができます。

サポートされているビルドアイテム

再ビルドするかどうかを決定するために以前にビルドされたプロジェクトの変更を評価するとき、ReSharper は最も一般的な MSBuild アイテムタイプのビルド項目をチェックします。

タイプ None および上記にリストされていない他のタイプのビルドアイテムの変更は、デフォルトで無視されます。プロジェクトビルドが他のカスタムビルドアイテムタイプに依存している場合、これらのタイプの名前は .csproj/.vbproj ファイルの AvailableItemName に登録する必要があります。例:

サポートされているプロジェクトタイプと ReSharper ビルドの制限

ReSharper ビルドは、MSBuild ベースのほとんどの .NET プロジェクトタイプと言語 (C#、VB.NET、F#、C++) をサポートします。ただし、次の制限があります。

• MSBuild 以外のプロジェクト。ReSharper ビルドは、MSBuild ベースではないプロジェクトタイプでは機能しません。これには、Web サイト (フォルダーベースのプロジェクト、MVC Web アプリケーションではない)、WinJS アプリケーション、および DNX アプリケーションが含まれます。ソリューションにこれらのタイプのプロジェクトがある場合、ソリューションビルド全体が標準の MSBuild ビルドプロセスにフォールバックします。

• カスタムビルドステップ。通常、カスタムビルドステップ（C++ プロジェクトのビルド前後のステップを含む）は、バッチファイルを呼び出すのと同じです。たとえば、ファイルを出力ディレクトリにコピーするためにいくつかのコマンドラインが実行されます。ReSharper ビルドに関する限り、これらはブラックボックスです。カスタムビルドステップで何が起こっているのかわからないため、入力と出力を追跡できません。さらに、プロジェクトがスキップされると、ビルドステップが実行されず、ビルドで問題が発生する可能性があります（これが、デフォルトで ReSharper ビルドが無効になっている主な理由です）。

  ただし、カスタム MSBuild ターゲットとタスクは、タイムスタンプの変更を監視できる入力と出力のリストを使用して増分ビルドをサポートしている限り、ReSharper ビルドで動作します。ReSharper ビルドで良好な結果を得るには、単純なカスタムビルドステップをカスタムターゲットに変換することを強くお勧めします。

  カスタムビルドステップを置き換えることができない場合は、ヒューリスティックを適用せずに、プロジェクトを「常にビルド」する必要があるプロジェクトのリストに追加できます。つまり、プロジェクトは常に MSBuild に渡され、MSBuild の標準の増分ビルドプロセスが実行されます。これは、ReSharper オプション Alt+R, O のツール | ビルド | ヒューリスティックページで構成できます。