ビルド イベントの指定

ビルド開始前、リンク プロセス前、ビルド終了後に実行するコマンドを指定する目的で、ビルド イベントを使用できます。

ビルド イベントは、ビルド プロセスにおいてビルドがこれらのポイントに正常に達した場合にのみ実行されます。 ビルドでエラーが発生した場合、ビルド後イベントは発生しません。リンク段階前にエラーが発生した場合、リンク前イベントもビルド後イベントも発生しません。 また、ファイルをリンクする必要がない場合、リンク前イベントは発生しません。 リンク手順が含まれないプロジェクトでも、リンク前イベントを利用できません。

ファイルをビルドする必要がない場合、ビルド イベントは発生しません。

ビルド イベントに関する全般情報については、「カスタム ビルド ステップとビルド イベントについて」を参照してください。

ビルド イベントを指定するには

1. ソリューション エクスプローラーで、ビルド イベントを指定するプロジェクトを選択します。

2. プロジェクトの [プロパティ ページ] ダイアログ ボックスを開きます。 詳しくは、「Visual Studio で C++ コンパイラとビルド プロパティを設定する」をご覧ください。

3. [ビルド イベント] フォルダーで、ビルド イベント プロパティ ページを選択します。

4. ビルド イベントに関連付けられたプロパティを指定します。

   • [コマンド ライン] で、コマンド プロンプトの場合と同様にコマンドを指定します。 有効なコマンドまたはバッチ ファイルと必要な入力ファイルまたは出力ファイルがあればそれを指定します。 後続のコマンドがすべて確実に実行されるように、バッチ ファイル名の前に call バッチ コマンドを指定します。

     MSBuild マクロを利用すれば、複数の入力ファイルと出力ファイルを数式で指定できます。 ファイルの場所またはファイル セットの名前を指定する方法については、「Common macros for build commands and properties」 (ビルドのコマンドとプロパティの共通マクロ) を参照してください。

     '%' は MSBuild に予約されている文字であるため、環境変数を指定する場合、エスケープ文字 % をそれぞれ、16 進数エスケープ シーケンス %25 に変更してください。 たとえば、%WINDIR% を %25WINDIR%25 に変更します。 MSBuild は %25 シーケンスをそれぞれ % 文字に変更し、それから環境変数にアクセスします。

   • [説明] には、このイベントの説明を入力します。 このイベントが発生したとき、[出力] ウィンドウにこの説明が表示されます。

   • [ビルドから除外] には、イベントを実行しない場合、[はい] を指定します。

関連項目

カスタム ビルド ステップとビルド イベントについて
ビルドのコマンドとプロパティの共通マクロ
ビルドのカスタマイズのトラブルシューティング