BuildConsole (Visual Studio)

BuildConsole を実行するためのコマンドラインが長すぎて、スクリプトで明示的に指定できない場合に使用します。

デフォルトでは、プロジェクトで出力ファイルのビルドに失敗するとビルドを停止しますが、このオプションを使って残りのビルドを継続することができます。

ビルド中の場合は、現時点までのビルドの出力を表示し、ビルドが終了するまで表示し続けます。ビルドを実行していない場合は、当該マシンで開始した最後のビルドの出力をすべて表示します。

値 (ON / OFF) が必須です。

ブラウズ情報の設定については、Agent Settings を参照してください。

• 値を引用符 (”) で囲みます。

• コンマで区切って複数の構成を指定できます。

• 値は大文字と小文字を区別しません。

cl.exe のコマンドラインに表示されるように、1 つまたは複数のコマンドをスペースで区切って入力します。

例：BuildConsole MyProj /cl_add="/O2 /FA"

cl.exe のコマンドラインに表示されるように、1 つまたは複数のコマンドをスペースで区切って入力します

例: BuildConsole MyProj /cl_rem="/Z7 /Zd /Zi /ZI"

• 値を引用符 (”) で囲みます。

• コンマで区切って複数のソース ファイルを指定できます。

VS 2010 のみが対象です。

<output filename> は必須です。

cl.exe のコマンドラインに表示されるように、1 つまたは複数のコマンドをスペースで区切って入力します。

例: BuildConsole MyProj /link_add="/map:MyProj.map"

filename を指定しない場合は「IB_<target-name>.log」という名前のファイルがカレント ディレクトリに作成されます。

<Level> は、以下のいずれかになります。Minimal、Basic、Intermediate、Extended、Detailed.

これより新しい OS を搭載した Agent はビルドに参加できません。設定可能な値は8.1、10です。

これより古い OS を搭載した Agent はビルドに参加できません。利用可能な値は8.1、10です。

• フォルダ名のみ指定した場合は該当ファイル名の GUID が生成されます。

• .ib_mon ファイルの保存場所がビルド出力の最後に追加されます。

コマンドの例:

BuildConsole dcom.sln /rebuild /cfg="debug|win32" /msbuildargs="/detailedsummary" /usemsbuild

このオプションを指定すると、Initiator マシンの .NET 環境を Helper マシンに仮想化しません。様々な OS が混在する環境で .NET の互換性がない場合に使用します。

• /Clean と併用すると指定した構成のみクリーンアップできます。

• Rebuild と併用すると指定した構成のみリビルドできます。

/pemode=0は投機的実行を無効にします。

/pemode=2 は投機的実行を完全に有効にします。

• プロジェクトと構成の組み合わせが複雑な場合に有効です。

• /Preset コマンドオプションは、/cfg と/prj の両方のオプションを変換します。

• 値を引用符 (”) で囲むことができます。

• 「/prj」オプションのない .sln ファイルで BuildConsole を実行すると、指定したソリューション構成上でコマンドが実行されます。

• ワイルドカード(「*」と「?」) を使って複数のプロジェクトを指定することができます。

• コンマで区切って複数のソース ファイルを指定できます。この場合、すべてのプロジェクトを同じ構成でビルドします。

• 例えば、ソリューション/ワークスペース内のすべての構成をビルドする場合は次のコマンドを入力します。BuildConsole MyWksp /prj="*"

複数の変数を設定/上書きしたい場合は /SETENV を複数回使用します。

デフォルトではビルドモニターの出力ディスプレイの通りにビルド結果を書き込みます。

値を引用符 (”) で囲みます。

• このオプションをグローバルに設定するには、[Agent Settings] ダイアログで [Visual Studio Builds] > [Advanced] に移動して [Use environment variables instead of IDE paths] のチェックボックスをオンにします。

• devenv.exe の「/useenv」オプションを使ってインスタンス化された Visual Studio IDE ウィンドウからビルドを開始した場合は常に「/useenv」が使用されます。

デフォルトでは Devenv でビルドが行われます。このオプションを使うと、MSBuild でビルドが実行され、/msbuildargs を使って特定の MSBuild フラグを追加できるようになります。

これにより、VS 2022以降では64bit MSBuildが、それ以前のバージョンでは32bit MSBuildが自動的に使用されます。

この自動検出を無視し、使用するバージョンを手動で指定するには、=32 または =64 を追加します（例：/usemsbuild=32）。

<Version>には以下のいずれかを指定します。

• vc10 (VS2010 用)

• vc11 (VS2012 用)

• vc12 (VS2013 用)

• vc14 (VS2015 用)

• vc15 (VS2017用)

• vc16 (VS2019 用)

• vc17 (VS2022 用)