構成ファイルを使ってビルドごとに構成を変更する

Incredibuildの設定の一部を、個々のビルドに対して上書きすることができます。これは、コ構成ファイルの中にIncredibuildの設定セットを作成することで実行されます。ビルドを実行する際には、これらのファイルを参照することが可能です。

異なるユースケースをサポートするために、複数の構成ファイルを作成し、使用することができます。

これは現在、Visual Studioとの統合向けにコマンドラインからビルドを実行する場合にサポートされています。

利用可能な設定

項目	説明	許容値
/freecompletedtasks	大規模プロジェクトで使用し、メモリ性能を向上させる	オン¦オフ
/clangpathconvert	Clangでプロジェクトをビルドするときに使用します。この設定はClangに対応するようにパスを変換します。パスに特殊文字を使用している場合、またはその他の互換性の問題がある場合は、support@incredibuild.com までお問い合わせください。	Default=1 その他のオプションについては、カスタマーサポートにお問い合わせください。
/maxconcurrentpdbs	Incredibuild は、同時にビルドできる同じプロジェクトに属するファイルの数を制限しています。PDB ファイルの数を抑えてリンク時間を短縮することができます。詳細	整数
/maxfilesyncthreads	イニシエータとヘルパー間の 1 回のファイル転送に使用されるスレッドの最大数。	整数
/maxparallellinktargets	並列リンクの最大CPUコア数	整数
/forceenglishmsbuildoutput*	ビルドモニターの出力タブの情報を英語で表示します。	オン¦オフ
/usemsbuild*	MSBuildのバージョン（32ビットまたは64ビット）を強制的に使用します。	32\|64
/avoidlocal	エージェント設定のAvoid task execution on local machine when possible オプションを上書きします。	オン¦オフ
/maxcpus	ビルド設定の最大 CPU / コア数を上書きします。	整数
/pemode*	上書きとエージェントの投機的実行の設定。	0\|1\|2 0=disabled 1=build 2=rebuild
/buildcacheremoteserver	リモート/共有ビルドキャッシュに使用するサーバーを定義します。	IP:port
/buildcachelocal	Build Cacheを有効にしてローカルキャッシュを使用します。	オン¦オフ
/rootTaskAware	有効にすると、タスクにエラーがあるかどうかにかかわらず、Build Systemから Incredibuild にビルドステータスを継承します。いくつかのタスクでエラーが発生したもの、ビルドが正常に完了した場合、Build Monitorのビルドステータスはオレンジ色になります。	デフォルトでは無効化しています。有効化するために、/rootTaskAware=1に設定ます。

*IncredibuildのIBConsoleコマンドを使用してビルドを実行する場合、これらのパラメータはサポートされません。

構成ファイルの作成

構成ファイルは、ビルドの実行に使用する Incredibuild コマンド（buildconsole または ibconsole）によって若干異なります。サンプルファイルである「file: C:\Program Files (x86)\Incredibuild\ConfigFiles\Sample.ib_config.rsp.」から始めることをお勧めします。

すべてのコンフィグファイルの拡張子は.rspである必要があります。

注意： このサンプルは、buildconsoleを使用していることを前提としています。ibconsoleを使用している場合は、/usemsbuild、/pemode、/predictedexecution32bitfallback、および/ForceEnglishMSBuildOutputを削除してください。

コピー

/freecompletedtasks=off
/maxconcurrentpdbs=12
/maxfilesyncthreads=
/maxparallellinktargets=1
/ForceEnglishMSBuildOutput=off
/usemsbuild=64
/avoidlocal=off
/maxcpus=0
/pemode=2
/buildcacheremoteserver=127.0.0.1:50222  
/buildcachelocal=on

サンプルファイルには便宜上すべてのパラメーターが含まれていますが、構成ファイルにすべてのパラメーターを含める必要はありません。上の表に基づき、ファイルを必要に応じて編集します。

ビルド中の構成ファイルの使用

コンフィギュレーションファイルは、ビルドを実行する際に2通りの方法で使用可能です。

Automatic: ソリューションファイルと同じ場所に、ソリューションと同じ名前でコンフィグファイルを配置すると、そのソリューションでプロジェクトを実行するときに自動的に使用します。

同じソリューションに複数のコンフィグファイルを使用する場合（例：デバッグとリリース）、コマンドラインからソリューション名_cfg値で名前を付けます。

例えば、ソリューションがMySolution.ib_config.rspで、デバッグ用とリリース用で異なるコンフィギュレーションがある場合、次のような名前を使用します。

MySolution_Debug_x64.ib_config.rsp

MySolution.ib_config.rsp
Command Line： ビルドコマンドで設定ファイルを直接指定すると、そのファイルを使用します（VS IDEではサポートされていません）。

ビルドコマンドでコンフィグファイルを指定するには、フラグ@<相対もしくはフルパス>\yourconfigfile.rsp を追加します。例：@...˶configx64.rsp

使用例

ソリューションごとに異なるコンフィグファイルを使用する

ソリューションごとに固有のコンフィグファイルがある場合は、コンフィグファイルにソリューションと同じ名前を付け、同じフォルダに置きます。これは、そのソリューションのプロジェクトが自動的に実行されるたびに使用されます。

1つのソリューションに複数の設定ファイルを使用する

同じソリューションに複数のコンフィグファイルを使用する場合は、毎回ビルドコマンドでコンフィグファイルを指定する必要があります。

これは、複数のターゲット（例えばhelloworld_x86.rsp、helloworld_x64.rsp）に同じソリューションを使う場合に便利です。