以累加方式建置

  • 發行項

當您建置大型專案時，很重要的一點是，如果先前建置的元件仍是最新，就不會重建。 如果每次都建置所有目標，每次建置會花很長的時間才能完成。 若要啟用累加建置 (在這些建置中，只會重建先前尚未建置過的目標，或是已過期的目標)，Microsoft Build Engine (MSBuild) 可以比較輸入檔案的時間戳記，與輸出檔案的的時間戳記，然後判斷是要跳過、建置還是部分重建目標。 不過，在輸入和輸出之間必須有一對一的對應。 您可以使用轉換，讓目標可以找出這種直接對應。 如需轉換的詳細資訊，請參閱轉換。

指定輸入和輸出

如果專案檔中指定了輸入和輸出，您就可以累加方式來建置目標。

指定目標的輸入和輸出

  • 使用 Target 項目的 Inputs 和 Outputs 屬性。 例如：

    <Target Name="Build"
    Inputs="@(CSFile)"
    Outputs="hello.exe">

MSBuild 可以比較輸入檔案的時間戳記與輸出檔案的時間戳記，然後判斷是要跳過、建置還是部分重建目標。 在下列範例中，如果 @(CSFile) 項目清單中的任何檔案比 hello.exe 檔案新，MSBuild 將會執行目標，否則將會予以略過:

<Target Name="Build"
    Inputs="@(CSFile)"
    Outputs="hello.exe">

    <Csc
        Sources="@(CSFile)"
        OutputAssembly="hello.exe"/>
</Target>

當目標中指定輸入和輸出時，可能每個輸出對應到唯一的一個輸入，或者是輸出和輸入之間不能有直接對應。 例如，在先前的 Csc 工作中，輸出 hello.exe 無法對應至任何單一輸入 - 它相依於全部的輸入。

注意

輸入和輸出之間沒有直接對應的目標，一律會比每個輸出對應只能對應到一個輸入的目標更常建置，因為 MSBuild 無法判斷某些輸入變更的情況下，哪些輸出需要重建。

您可以識別輸出和輸入之間有直接對應的工作，例如 LC 工作，最適合進行累加建置，而不像 Csc 和 Vbc 之類的工作，它們會從許多輸入產生一個輸出組件。

範例

下列範例使用為假定說明系統建置說明檔的專案。 專案的運作方式是將來源的 .txt 檔案轉換成中繼 .content 檔案，然後與 XML 中繼資料檔案結合以產生說明系統所使用的最終 .help 檔案。 專案會使用下列假定的工作︰

  • GenerateContentFiles︰將 .txt 檔案轉換為 .content 檔案。

  • BuildHelp︰結合 .content 檔案和 XML 中繼資料檔案，建置最終的 .help 檔案。

專案會使用轉換來為 GenerateContentFiles 工作建立輸入與輸出之間的一對一對應。 如需詳細資訊，請參閱轉換。 此外，Output 項目設定為自動使用來自 GenerateContentFiles 工作的輸出，作為 BuildHelp 工作的輸入。

這個專案檔同時包含 Convert 和 Build 目標。 GenerateContentFiles 和 BuildHelp 工作分別放在 Convert 和 Build目標，以便能以累加方式建置每個目標。 藉由使用 Output 項目，GenerateContentFiles 工作的輸出會放在 ContentFile 項目清單，在這裡它們可以作為 BuildHelp 工作的輸入。 這樣使用 Output 項目，會自動提供一個工作的輸出作為另一個工作的輸入，您便不需要以手動方式在每個工作列出個別項目或項目清單。

注意

雖然 Convert 目標可以以累加方式建置，該目標的所有輸出永遠必須作為 Build 目標的輸入。 當您使用 Output 元素時，MSBuild 會自動提供一個目標的所有輸出，作為另一個目標的輸入。

<Project DefaultTargets="Build"
    xmlns="http://schemas.microsoft.com/developer/msbuild/2003" >

    <ItemGroup>
        <TXTFile Include="*.txt"/>
        <XMLFiles Include="\metadata\*.xml"/>
    </ItemGroup>

    <Target Name = "Convert"
        Inputs="@(TXTFile)"
        Outputs="@(TXTFile->'%(Filename).content')">

        <GenerateContentFiles
            Sources = "@(TXTFile)">
            <Output TaskParameter = "OutputContentFiles"
                ItemName = "ContentFiles"/>
        </GenerateContentFiles>
    </Target>

    <Target Name = "Build" DependsOnTargets = "Convert"
        Inputs="@(ContentFiles);@(XMLFiles)"
        Outputs="$(MSBuildProjectName).help">

        <BuildHelp
            ContentFiles = "@(ContentFiles)"
            MetadataFiles = "@(XMLFiles)"
            OutputFileName = "$(MSBuildProjectName).help"/>
    </Target>
</Project>

相關內容