/Build (devenv.exe)
使用指定的方案組態檔建置方案或專案。
語法
devenv SolutionName /Build [SolnConfigName [/Project ProjName [/ProjectConfig ProjConfigName]] [/Out OutputFilename]]
參數
SolutionName
必填。 方案檔的路徑和名稱,相對於解決方案的目錄。
SolnConfigName
自選。 方案組態的名稱(例如
Debug
或Release
),用來建置 SolutionName中名為 的方案。 如果有多個解決方案平臺可供使用,您也必須指定平臺(例如,Debug|Win32
)。 如果這個自變數未指定或空字串 (""
),此工具會使用解決方案的使用中組態。/Project
ProjName自選。 方案內項目檔的路徑和名稱。 您可以從 SolutionName 資料夾輸入相對路徑至專案檔、項目的顯示名稱,或是項目檔的完整路徑和名稱。
/ProjectConfig
ProjConfigName自選。 建置具名專案時要使用的專案建置組態名稱(例如
Debug
或Release
)。 如果有多個解決方案平臺可用,您也必須指定平臺(例如,Debug|Win32
)。 如果指定此參數,它會覆寫 SolnConfigName 自變數。/Out
OutputFilename自選。 您要傳送工具輸出的檔案名。 如果檔案已經存在,此工具會將輸出附加至檔案的結尾。
言論
/Build
參數會執行與整合開發環境 (IDE) 內 建置解決方案 選單命令相同的功能。以雙引弧括住包含空格的字串。
組建的摘要資訊,包括錯誤,可以顯示在命令視窗中,或是任何以
/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
如果解決方案已使用 Release 組態來建置,此命令只會建置安裝程序專案。