MSBuild 目標

發行項
03/01/2013

目標會以特定順序將各項工作集合在一起成為群組，並允許建置程序納入為較小的單位。例如，可能有個目標正在刪除輸出目錄中的所有檔案並準備進行建置，而同時另一個目標則在編譯專案的輸入並放入空目錄中。如需工作的詳細資訊，請參閱 MSBuild 工作。

在專案檔中宣告目標

目標會於專案檔中使用 Target 項目宣告。例如，下列 XML 會建立名為 Construct 的目標，這個目標接著會使用 Compile 項目集合呼叫 Csc 工作。

<Target Name="Construct">
    <Csc Sources="@(Compile)" />
</Target>

目標與 MSBuild 屬性一樣，可以重新定義。例如：

<Target Name="AfterBuild" >
    <Message Text="First occurrence" />
</Target>
<Target Name="AfterBuild" >
    <Message Text="Second occurrence" />
</Target>

如果 AfterBuild 執行，則該命令只會顯示「第二次出現的項目」。

目標建置順序

如果某個目標的輸入相依於其他目標的輸出，則必須將目標排序。有幾個方法可以指定目標的執行順序。

初始目標
預設目標
第一個目標
目標相依性
BeforeTargets 和 AfterTargets (MSBuild 4.0)

在建置期間一個目標只能執行一次，即使組建中的後續目標對此目標具有相依性亦是如此。一旦執行目標後，其對於組建的貢獻便已完成。

如需目標建置順序的詳細資訊，請參閱目標建置順序。

目標批次處理

目標項目可能具有 Outputs 屬性，後者會以 %(中繼資料) 格式指定中繼資料。如果有，MSBuild 會為每個唯一中繼資料值執行目標一次，將具有中繼資料值的項目進行分組或批次處理。例如：

<ItemGroup>
    <Reference Include="System.Core">
      <RequiredTargetFramework>3.5</RequiredTargetFramework>
    </Reference>
    <Reference Include="System.Xml.Linq">
      <RequiredTargetFramework>3.5</RequiredTargetFramework>
    </Reference>
    <Reference Include="Microsoft.CSharp">
      <RequiredTargetFramework>4.0</RequiredTargetFramework>
    </Reference>
</ItemGroup>
<Target Name="AfterBuild"
    Outputs="%(Reference.RequiredTargetFramework)">
    <Message Text="Reference:
      @(Reference->'%(RequiredTargetFramework)')" />
</Target>

依 Reference 項目的 RequiredTargetFramework 中繼資料對這些項目進行批次處理。此目標的輸出如下所示：

Reference: 3.5;3.5
Reference: 4.0

目標批次處理很少用於實際組建中，工作的批次處理則較常見。如需詳細資訊，請參閱MSBuild 批次處理。

累加建置

累加建置是最佳化的建置，如此才不會執行擁有最新輸出檔 (相對於其對應的輸入檔) 的目標。目標項目 (Element) 可以有 Inputs 和 Outputs 屬性，分別表示目標預期做為輸入的項目 (Item) 以及目標會產生為輸出的項目 (Item)。

如果所有輸出項目都是最新的，MSBuild 會略過目標，如此能夠大幅改善建置速度。這稱為目標的累加建置。如果只有部分檔案是最新的，MSBuild 則會執行該目標，但是略過最新的項目。這稱為目標的部分累加建置。如需詳細資訊，請參閱累加建置。

Share via