構成ファイルを使ってビルドごとに構成を変更する
Incredibuildの設定の一部を、個々のビルドに対して上書きすることができます。これは、コ構成ファイルの中にIncredibuildの設定セットを作成することで実行されます。ビルドを実行する際には、これらのファイルを参照することが可能です。
異なるユースケースをサポートするために、複数の構成ファイルを作成し、使用することができます。
これは現在、Visual Studioとの統合向けにコマンドラインからビルドを実行する場合にサポートされています。
利用可能な設定
項目 | 説明 | 許容値 |
---|---|---|
/freecompletedtasks | 大規模プロジェクトで使用し、メモリ性能を向上させる | オン¦オフ |
/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を有効にしてローカルキャッシュを使用します。 |
オン¦オフ |
*これらのパラメータは、Incredibuild の buildconsole コマンドを使ってビルドを実行する場合にのみサポートされます。
構成ファイルの作成
構成ファイルは、ビルドの実行に使用する Incredibuild コマンド(buildconsole または ibconsole)によって若干異なります。サンプルファイルである「file: C:\Program Files (x86)\Incredibuild\ConfigFiles\Sample.ib_config.rsp.」から始めることをお勧めします。
注意: このサンプルは、buildconsoleを使用していることを前提としています。ibconsoleを使用している場合は、/usemsbuild、/pemode、/predictedexecution32bitfallback、および/ForceEnglishMSBuildOutputを削除してください。
/freecompletedtasks=off
/maxconcurrentpdbs=12
/multithreadedfilesyncthreads=8
/maxparallellinktargets=1
/predictedexecution32bitfallback=off
/ForceEnglishMSBuildOutput=off
/usemsbuild=64
/avoidlocal=off
/maxcpus=0
/pemode=2
/buildcacheremoteserver=127.0.0.1:50222
/buildcachelocal=on
サンプル ファイルには便宜上すべてのパラメーターが含まれていますが、構成ファイルにすべてのパラメーターを含める必要はありません。上の表に基づき、ファイルを必要に応じて編集します。
ビルド中の構成ファイルの使用
構成ファイルは、正しい名前が付けられ、正しい場所にコピーされていれば、自動的に使用されます。
コマンドラインでビルドを実行する場合
-
構成ファイルは、プロジェクトファイルやソリューションファイルと同じ場所に配置することができます。
-
このファイルをソリューション ファイルと同じ場所に配置すると、そのソリューション内のすべてのプロジェクトで使用されます。
-
プロジェクトまたはソリューションと同じ名前(拡張子は.ib_config.rsp)になるよう、構成ファイルの名前を変更します。
Visual Studio IDEでビルドを実行する場合
-
構成ファイルをソリューション ファイルと同じ場所に配置します。このファイルは、そのソリューションのすべてのプロジェクトで使用されます。
-
ソリューションと同じ名前の構成ファイル(拡張子は.ib_config.rsp)になるよう、名前を変更します。