IncrediBuildのビルド設定
選択したキットのビルド設定を指定するには、[Projects ] > [Build Settings] に移動します。
IncrediBuild のビルドステップおよびクリーンアップステップを指定できます。
IncrediBuild のビルドステップ
IncrediBuild を使用するには、[Add Build Step ] > [IncrediBuild for Linux ] または [IncrediBuild for Windows] を選択します。
IncrediBuild は、すでに定義済みのビルドステップを順に処理することで、ビルドステップを自動的に検出します。初期のビルドステップ設定は IncrediBuild のビルドステップの一部となるため、普段使用しているビルドツールは引き続き使用できますが、IncrediBuild のビルド高速化機能やグラフィカルなビルドモニターという追加の利点も得られます。
「Target and configuration 」グループで、ビルドコマンドの構築に使用されるコマンドヘルパーと引数を指定します。
ビルドエラーおよび警告は解析され、「Issues」に表示されます。
「Keep original jobs number 」を選択すると、IncrediBuild が「-j 」コマンドラインスイッチを上書きするのを防ぐことができます。このスイッチは、Qt Creator によって実行されるビルドツールが並列で実行するプロセス数を制御します。IncrediBuild によって設定されるデフォルト値は 200 です。
指定する分散制御の設定は、Linux を使用しているか Windows を使用しているかによって異なります。
Linux での分散制御設定
Linuxでのビルドでは、以下の設定を指定できます。
- Nice value -20 から 19 までの数値
- Force remote
allow_remoteタスクをリモートのHelperに強制的に割り当てます。 - Alternate tasks preference
Windows での分散制御設定
Windows ビルドでは、以下の設定を指定できます:
| 設定 | 値 |
|---|---|
| Profile.xml | 分散ジョブ内のプロセスを「自動インターセプトインターフェース」がどのように処理するかを定義します。Visual Studio や Make および Build ツールによるビルドでは必要ありませんが、これらのビルドで各パッケージに含まれていないプロセスを使用する場合、構成オプションを追加するために使用できます。Dev Tools によるビルドで分散可能なプロセスを構成するには、この設定が必要です。 |
| Avoid local task execution | イニシエーターマシン上のリソースを解放します。イニシエーターの CPU 使用率が高くなり、ビルドのボトルネックとなっている場合、分散処理に有効です。 |
| Maximum CPUs to utilize in the build | ビルドで使用するリモートコアの最大数を指定します。対応するグローバル設定を上書きします。 |
| Newest allowed helper machine OS Oldest allowed helper machine OS | ビルドにヘルパーとして参加を許可するヘルパーマシンにインストールされているオペレーティングシステムの最新バージョンと最古のバージョンを指定します。 |
| Build title | ビルド出力テキストの冒頭に表示されるカスタムヘッダー行を指定します。このタイトルは、ビルド履歴およびビルドモニターの表示にも使用されます。 |
| Save IncrediBuild monitor file | ビルドの進行状況ファイル（.ib_mon ）のコピーを、指定された場所に書き込みます。フォルダ名のみが指定された場合、IncrediBuild はファイル名として GUID を生成します。保存された.ib_mon ファイルの場所を示すメッセージが、ビルド出力の最後に追加されます。 |
| Suppress STDOUT | 標準出力には何も書き込みません。 |
| Output Log file | ビルド出力をファイルに書き込みます。 |
| Show Commands in output | IncrediBuild がファイルのビルドに使用するコマンドラインを表示します。 |
| Show Agents in output | 各ファイルのビルドに使用されたエージェントを表示します。 |
| Show Time in output | ビルドされた各ファイルの開始時刻と終了時刻を表示します。 |
| Hide IncrediBuild Header in output | ビルド出力から IncrediBuild のヘッダーを非表示にします。 |
| Internal IncrediBuild logging level | このビルドにおける IncrediBuild の内部ロギングレベルを上書きします。出力やユーザーがアクセス可能なログには影響しません。主に、IncrediBuild サポートの協力を得て問題をトラブルシューティングするために使用されます。 |
| Set an Environment Variable | ビルドのコンテキストにおける環境変数を設定または上書きします。 |
| Stop on errors | エラーが発生するとすぐに実行を停止します。これは Visual Studio ビルドでのデフォルトの動作ですが、Make および Build ツール、あるいは Dev Tools ビルドではデフォルトではありません。 |
| Additional Arguments | 最終的なビルドコンソールコマンドラインに連結される引数。 |
| Open Build Monitor | ビルドが開始されると、ビルドの進行状況をグラフィカルに表示するIncrediBuildビルドモニターを開きます。 |
IncrediBuild のクリーン手順
IncrediBuild を使用してビルドする場合、Clean Steps 内の clean コマンドに対して引数やターゲットを追加できます。
ビルドのエラーと警告は解析され、「Issues」に表示されます。
「プロジェクトのキットを有効にする」、「クリーンステップを追加する」、「ビルド用にプロジェクトを設定する」、「実行用にプロジェクトを設定する」、「プロジェクトを開く」、「プロジェクトのビルドと実行」、および「IncrediBuild」も参照してください 。
Copyright © The Qt Company Ltd. and other contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
