ターゲットのビルド順序

あるターゲットへの入力が別のターゲットの出力に依存する場合は、ターゲットを並べ替える必要があります。これらの属性を使用して、ターゲットを実行する順序を指定できます。

InitialTargets。この Project 属性は、コマンドラインまたは DefaultTargets 属性でターゲットが指定されている場合でも、最初に実行されるターゲットを指定します。
DefaultTargets。この Project 属性は、コマンドラインでターゲットが明示的に指定されていない場合に実行されるターゲットを指定します。
DependsOnTargets。この Target 属性は、このターゲットを実行する前に実行する必要があるターゲットを指定します。
BeforeTargets と AfterTargets. これらの Target 属性は、指定したターゲットの前または後に、このターゲットを実行することを指定します。

一般に、宣言の順序に依存して、他のタスクの前に実行されるタスクを指定しないでください。

ビルド内の後続のターゲットが依存している場合でも、ビルド中にターゲットが 2 回実行されることはありません。ターゲットが実行されると、ビルドへのその貢献が完了します。

ターゲットは、 Condition 属性を持つことができます。指定した条件が falseに評価された場合、ターゲットは実行されず、ビルドには影響しません。条件の詳細については、「条件」を参照してください。

初期ターゲット

InitialTargets 要素の属性は、ターゲットがコマンドラインまたは DefaultTargets 属性で指定されている場合でも、最初に実行されるターゲットを指定します。最初のターゲットは、通常、エラーチェックに使用されます。

InitialTargets属性の値には、ターゲットのセミコロン区切りの順序付きリストを指定できます。次の例では、 Warm ターゲットが実行され、 Eject ターゲットが実行されることを指定します。

<Project InitialTargets="Warm;Eject">

インポートされたプロジェクトは、独自の InitialTargets 属性を持つことができます。すべての初期ターゲットはまとめて集計され、順番に実行されます。

詳細については、「方法: 最初にビルドするターゲットを指定する」を参照してください。

既定のターゲット

DefaultTargets 要素の属性は、コマンドラインでターゲットが明示的に指定されていない場合にビルドされるターゲットを指定します。

DefaultTargets属性の値は、既定のターゲットのセミコロン区切りの順序付きリストにすることができます。次の例では、 Clean ターゲットが実行され、 Build ターゲットが実行されることを指定します。

<Project DefaultTargets="Clean;Build">

コマンドラインの -target スイッチを使用して、既定のターゲットをオーバーライドできます。次の例では、 Build ターゲットが実行され、 Report ターゲットが実行されることを指定します。この方法でターゲットを指定すると、既定のターゲットはすべて無視されます。

msbuild -target:Build;Report

初期ターゲットと既定のターゲットの両方が指定され、コマンドラインターゲットが指定されていない場合、MSBuild は最初に初期ターゲットを実行してから、既定のターゲットを実行します。

インポートされたプロジェクトは、独自の DefaultTargets 属性を持つことができます。最初に検出された DefaultTargets 属性によって、実行される既定のターゲットが決まります。

詳細については、「方法: 最初にビルドするターゲットを指定する」を参照してください。

最初のターゲット

初期ターゲット、既定のターゲット、またはコマンドラインターゲットがない場合、MSBuild は、プロジェクトファイルまたはインポートされたプロジェクトファイルで最初に検出されたターゲットを実行します。

ターゲットの依存関係

ターゲットは、相互の依存関係を記述できます。 DependsOnTargets属性は、ターゲットが他のターゲットに依存していることを示します。たとえば、

<Target Name="Serve" DependsOnTargets="Chop;Cook" />

は、 Serve ターゲットが Chop ターゲットと Cook ターゲットに依存することを MSBuild に通知します。 MSBuild は、Chop ターゲットを実行し、Cook ターゲットを実行する前にServe ターゲットを実行します。

注

SDK の標準ターゲットでは、そのターゲットの依存関係であるターゲットの一覧 (DependsOn、$(BuildDependsOn) など) を含む多数の$(CleanDependsOn) プロパティを定義します。たとえば、

<Target Name="Build" DependsOnTargets="$(BuildDependsOn)">

プロジェクトをカスタマイズするには、「DependsOnの拡張」の説明に従って、ビルドプロセスを拡張する追加のカスタムターゲットでプロパティをオーバーライドできます。

BeforeTargets と AfterTargets

BeforeTargets属性とAfterTargets属性を使用して、ターゲットの順序を指定できます。

次のスクリプトについて考えてみましょう。

<Project DefaultTargets="Compile;Link">
    <Target Name="Compile">
        <Message Text="Compiling" />
    </Target>
    <Target Name="Link">
        <Message Text="Linking" />
    </Target>
</Project>

Optimize ターゲットの後、Compile ターゲットの前に実行される中間ターゲット Linkを作成するには、Project要素内の任意の場所に次のターゲットを追加します。

<Target Name="Optimize" AfterTargets="Compile">
    <Message Text="Optimizing" />
</Target>

または、次のように順序を指定します。

<Target Name="Optimize" BeforeTargets="Link">
    <Message Text="Optimizing" />
</Target>

同じターゲットでとBeforeTargetsのAfterTargetsを指定することは役に立ちません。次のセクションで説明するように、最初に検出されたターゲットのみが新しいターゲットを実行します。