命令列上的 MSBuild - C++

一般情況下,建議您使用 Visual Studio 設定專案屬性,並叫用 MSBuild 系統。 不過,您可以直接從命令提示字元使用MSBuild工具。 組建流程是由專案檔中的資訊所控制 ( .vcxproj) 您可以建立和編輯。 專案檔案會根據組建階段、條件和事件來指定組建選項。 此外,您可以指定零個以上的命令列 選項 引數。

msbuild.exe [ project_file ] [ 選項 ]

使用 /target (或 /t) 並 /Property (或 /p) 命令列選項來覆寫專案檔中所指定的特定屬性和目標。

專案檔的基本功能是指定 目標,也就是套用至專案的特定作業,以及執行該作業所需的輸入和輸出。 專案檔可以指定一或多個目標,其中可以包含預設目標。

每個目標都包含一 或多個工作的序列。 每項工作都是以包含一個可執行命令的 .NET Framework 類別表示。 例如, CL 工作包含 cl.exe 命令。

工作 參數 是類別工作的屬性,通常代表可執行命令的命令列選項。 例如, FavorSizeOrSpeed 工作的參數 CL 會對應至 /os/ot 編譯器選項。

額外的工作參數支援 MSBuild 基礎結構。 例如,工作 Sources 參數會指定可供其他工作使用的一組工作。 如需 MSBuild 工作的詳細資訊,請參閱工作參考

大部分的工作都需要輸入和輸出,例如檔案名、路徑、字串、數值或布林值參數。 例如,一般輸入是要編譯之 .cpp 來源檔案的名稱。 重要的輸入參數是指定組建設定和平臺的字串,例如「Debug |Win32」。 輸入和輸出是由專案中 ItemGroup 包含的一個或多個使用者定義 XML Item 元素所指定。

專案檔也可以指定使用者定義的屬性ItemDefinitionGroup專案。 屬性和專案形式的名稱/值組,可用來做為組建中的變數。 配對的名稱元件會定義 ,而值元件則會宣告 宏值。 您可以使用 $ (名稱) 標記法來存取屬性宏,並使用% (名稱) 標記法來存取專案宏。

專案檔中的其他 XML 元素可以測試宏,然後有條件地設定任何宏的值,或控制組建的執行。 宏名稱和常值字串可以串連以產生結構,例如路徑和檔案名。 在命令列上, /property 選項會設定或覆寫專案屬性。 無法在命令列上參考專案。

MSBuild 系統可有條件地在另一個目標之前或之後執行目標。 此外,系統也可以根據目標所使用的檔案是否比它發出的檔案還要新來建立目標。

如需 MSBuild 的詳細資訊,請參閱:

本節內容

詞彙 定義
逐步解說:使用 MSBuild 建立 c + + Project 示範如何使用MSBuild建立 Visual Studio c + + 專案。
如何:在 MSBuild 專案中使用組建事件 示範如何指定在組建中的 particuler 階段所發生的動作:組建開始之前;開始連結步驟之前:或在組建結束之後。
如何:將自訂群組建步驟新增至 MSBuild 專案 示範如何將使用者定義的階段加入至組建序列。
如何:將自訂群組建工具新增至 MSBuild 專案 示範如何建立組建工具與特定檔案的關聯。
如何:將自訂工具整合至 Project 屬性 示範如何將自訂工具的選項加入至專案屬性。
如何:修改目標 Framework 和平臺工具組 示範如何針對多個架構或工具組編譯專案。

另請參閱

從命令列使用 MSVC 工具組