共用方式為


使用 MSBuild 同時建置多個專案

您可以使用 MSBuild 來平行快速地建立多個專案。 要平行執行組建,您會使用多核心或多處理器電腦的下列設定:

  • 在命令提示字元中的 /maxcpucount 轉換。

  • 在 MSBuild 工作的 BuildInParallel 工作參數。

注意事項注意事項

在命令列的 /verbosity (/v) 參數也會影響到建置效能。如果針對疑難排解使用的組建記錄資訊詳細等級設定為詳細或診斷,建置效能可能會降低。如需詳細資訊,請參閱使用 MSBuild 取得建置記錄MSBuild 命令列參考

/maxcpucount 參數

如果您使用簡寫為 /maxcpucount 參數或 /m , MSBuild 可建立MSBuild.exe 指定數目的處理序同時執行。 這些處理序也稱為「背景工作處理序」。每個背景工作處理序都會使用不同的核心或處理器 (如可用) 來建置專案,而同時可能也有其他可用的處理器正在建置其他專案。 例如,將此參數設值為 "4" 時, 會使 MSBuild 建立四個背景工作處理序來建置專案。

如果您引入 /maxcpucount 參數但未指定值, MSBuild 會使用電腦上的處理器最大數目。

如需這個參數的詳細資訊,在 MSBuild 3.5 中的簡介,請參閱 MSBuild 命令列參考

下列範例會指示 MSBuild 使用三個背景工作處理序。 如果您使用此組態, MSBuild 可以同時建立三個專案。

msbuild.exe myproj.proj /maxcpucount:3

BuildInParallel 工作參數

BuildInParallel 是 MSBuild 工作上的選擇性布林值參數。 BuildInParallel 設為 true (預設值) 時,就會產生多個背景工作處理序,以同時建置任何數目的專案。 為使 /maxcpucount 參數正確運作,其值必須設為大於 1,且系統必須至少是雙核心或有兩個以上的處理器。

以下是取自於 microsoft.common.targets 的範例,示範如何設定 BuildInParallel 參數。

<PropertyGroup>
    <BuildInParallel Condition="'$(BuildInParallel)' == 
        ''">true</BuildInParallel>
</PropertyGroup>
<MSBuild
    Projects="@(_MSBuildProjectReferenceExistent)"
    Targets="GetTargetPath"
    BuildInParallel="$(BuildInParallel)"
    Properties="%(_MSBuildProjectReferenceExistent.SetConfiguration); 
        %(_MSBuildProjectReferenceExistent.SetPlatform)"
    Condition="'@(NonVCProjectReference)'!='' and 
        ('$(BuildingSolutionFile)' == 'true' or 
        '$(BuildingInsideVisualStudio)' == 'true' or 
        '$(BuildProjectReferences)' != 'true') and   
        '@(_MSBuildProjectReferenceExistent)' != ''"
    ContinueOnError="!$(BuildingProject)">
    <Output TaskParameter="TargetOutputs" 
        ItemName="_ResolvedProjectReferencePaths"/>
</MSBuild>

請參閱

概念

使用多個處理器來建置專案

撰寫能夠辨識多處理器的記錄器

其他資源

調整過的 C++ 建置平行處理原則部落格