/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
スイッチを指定すると、統合開発環境 (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
プロジェクト ファイルを含む setup プロジェクトが必要ですが、ビルドするには、最初に特定のレジストリ キーを設定する回避策を適用する必要があります。 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 構成でビルドされている場合、このコマンドはセットアップ プロジェクトをビルドするだけです。