ターゲットのビルド順序

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

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

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

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

ターゲットは、属性を持つことができます。指定した条件がに評価された場合、ターゲットは実行されず、スキップされたと見なされます。スキップされたターゲットの動作の詳細については、ターゲットのビルド順序の決定を参照してください。条件の詳細については、「条件」を参照してください。

初期ターゲット

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

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

<Project InitialTargets="Warm;Eject">

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

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

既定のターゲット

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

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

<Project DefaultTargets="Clean;Build">

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

msbuild -target:Build;Report

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

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

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

最初のターゲット

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

ターゲットの依存関係

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

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

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

注

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

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

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

BeforeTargets と AfterTargets

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

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

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

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

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

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

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

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