Share via


ビルド イベントの指定

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

ビルド イベントは、ビルド処理でこれらのポイントにビルドが正常に到達した場合にだけ実行されます。ビルドでエラーが発生した場合、ビルド後のイベントは発生しません。リンク フェーズより前にエラーが発生した場合は、リンク前のイベントとビルド後のイベントのどちらも発生しません。また、ファイルをリンクする必要がない場合、リンク前のイベントは発生しません。リンク前のイベントは、リンク ステップを含まないプロジェクトでは使用できません。

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

ビルド イベントの概要については、「カスタム ビルド ステップとビルド イベントについて」を参照してください。

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

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

  2. プロジェクトの [プロパティ ページ] ダイアログ ボックスを開きます。詳細については、「プロジェクト設定の変更」を参照してください。

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

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

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

      MSBuild マクロを使用して、複数の入力ファイルおよび出力ファイルをシンボルで指定できます。ファイルの場所、またはファイル セットの名前を指定する方法詳細情報:「ビルドのコマンドとプロパティのマクロ」を参照してください。

      '%' 文字は MSBuild によって予約されているため、環境変数を指定する場合は、各 % エスケープ文字を 16 進数の %25 エスケープ シーケンスに置き換えてください。たとえば、%WINDIR%%25WINDIR%25 に置き換えます。MSBuild は、環境変数にアクセスする前に、各 %25 シーケンスを % 文字に置き換えます。

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

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

参照

関連項目

カスタム ビルド ステップとビルド イベントについて

ビルドのカスタマイズのトラブルシューティング

その他の技術情報

ビルドのコマンドとプロパティのマクロ