/Build (devenv.exe)
使用指定的方案組態檔來建置方案或專案。
語法
devenv SolutionName /Build [SolnConfigName [/Project ProjName [/ProjectConfig ProjConfigName]] [/Out OutputFilename]]
引數
SolutionName
必要。 方案檔的路徑和名稱,相對於解決方案的目錄。
SolnConfigName
選擇性。 用來建置 SolutionName 中所指定方案的方案組態名稱 (例如
Debug
或Release
)。 如果有多個方案平台可供使用,您也必須指定平台 (例如Debug|Win32
)。 如果未指定這個引數或其為空字串 (""
),則工具會使用方案的作用中組態。/Project
ProjName選擇性。 方案中專案檔的路徑和名稱。 您可以輸入從 SolutionName 資料夾到專案檔的相對路徑、專案的顯示名稱,或專案檔的完整路徑和名稱。
/ProjectConfig
ProjConfigName選擇性。 在建置指定的專案時要使用的專案組建組態名稱 (例如
Debug
或Release
)。 如果有多個方案平台可供使用,您也必須指定平台 (例如Debug|Win32
)。 如果指定這個參數,則會覆寫 SolnConfigName 引數。/Out
OutputFilename選擇性。 您要將工具的輸出傳送到其中的檔案名稱。 如果檔案已經存在,工具就會將輸出附加至檔案結尾。
備註
/Build
參數會執行與整合式開發環境內之 [建置方案] 功能表命令相同的函式。請以雙引號括住包含空格的字串。
建置的摘要資訊 (包括錯誤) 可顯示在命令視窗中,或使用
/Out
參數指定的任何記錄檔中。/Build
參數只會建置自上次建置後已變更的專案。 若要建置方案中所有的專案,請改為使用 /rebuild。如果您收到錯誤訊息,指出專案組態無效,請確定您已指定方案平台或專案平台 (例如
Debug|Win32
)。
範例
下列命令會使用 MySolution
內的 Debug
專案組建組態來建置專案 CSharpWinApp
。
devenv "%USERPROFILE%\source\repos\MySolution.sln" /build Debug /project "CSharpWinApp\CSharpWinApp.csproj" /projectconfig Debug
並清除所有組建檔案:
devenv "%USERPROFILE%\source\repos\MySolution.sln" /clean
建置安裝專案
若要建置安裝程式 (.msi
檔案),您需要具有.vdproj
專案檔的安裝程序專案,但若要建置安裝程式,您必須先套用可設定特定登錄機碼的因應措施。 從 Visual Studio 開發人員命令提示字元中,從 Common7\IDE\CommonExtensions\Microsoft\VSI\DisableOutOfProcBuild 資料夾執行可執行檔DisableOutOfProcBuild.exe。 如果沒有此因應措施,您可能會收到錯誤: ERROR: An error occurred while validating. HRESULT = '8000000A'
。 此命令會影響目前的使用者,因此針對組建代理程式案例,請務必從執行組建的相同帳戶執行它。 如需詳細資訊,請參閱 相同資料夾中README.txt 檔案。
此外,在 Visual Studio 中,您可以根據Release
組態建立新的組態Setup
,然後選取安裝程式專案作為要建置的專案。 根據預設,安裝程式專案不會包含在預設組態中, Debug
以及 Release
。 定義組態后 Setup
,下列命令會建置專案 WindowsFormsApp1
及其相關聯的安裝專案以產生 .msi
檔案:
devenv WindowsFormsApp1.sln /build Setup
如果解決方案已使用 發行 組態建置,此命令只會建置安裝程序專案。