BuildGraph は、AutomationTool の一部として実装されます。これは、Windows の Unreal Engine (UE) ソリューションから直接実行することができます。または、コマンドラインから Engine/Build/BatchFiles/RunUAT.bat バッチ ファイル経由で実行することができます。Mac や Linux では、Engine/Build/BatchFiles/RunUAT.sh シェル スクリプトで実行することができます。コマンドラインから BuildGraph を使用する方法について知りたい場合、
リファレンスとして記述したコマンドの使用例があります。
オプションとノードを表示する
BuildGraph スクリプトで利用可能なすべてのノードとオプションを表示させるには以下のようにします。
BuildGraph -Script=Engine/Build/Graph/Examples/AllExamples -ListOnlyオプションを設定する
スクリプトで定義されるオプションを設定するには以下のようにします。
BuildGraph -Script=Engine/Build/Graph/Examples/Properties.xml -ListOnly -Set:CommandLineProperty=ABCDEFノードの実行を見る
ターゲットに対してどのノードが実行されるかを見るには以下のようにします。
BuildGraph -Script=Engine\Build\Graph\Examples\AllExamples.xml -Target="All Examples" -ListOnly過去のビルドをクリーニング処理する
過去のビルドをクリーニング処理し、特定のターゲットを実行するには以下のようにします。
BuildGraph -Script=Engine\Build\Graph\Examples\AllExamples.xml -Target="Property Examples" -CleanXML スキーマ
すべての登録されたタスクを含む XML スキーマを書き出すには、以下のようにします。
BuildGraph -Schema=Engine\Build\Graph\Schema.xsdプリプロセスされたスクリプトを生成する
スクリプトのプリプロセスされたバージョンを出力する (デバッグに役立ちます) には以下のようにします。
BuildGraph -Script=Engine\Build\Graph\Examples\AllExamples.xml -Target="All Examples" -ListOnly -Preprocess=D:\Preprocessed.xmlプリプロセスされたグラフを JSON にエクスポートする
プリプロセスされたグラフを JSON にエクスポートするには以下のようにします (ビルド システムで動的コンフィギュレーションをするため)。
BuildGraph -Script=Engine\Build\Graph\Examples\AllExamples.xml -Target="All Examples" -Export=D:\ExportedGraph.json単一ノードを実行する
ビルド システムで単一ノードを実行する (中間ファイルを共有ストレージ間で転送しながら) には以下のようにします。
BuildGraph -Script=Engine\Build\Graph\Examples\AllExamples.xml -Target="All Examples" -Clean -SingleNode="Manipulate Some Files" -SharedStorage=P:\Network-Share\Unique-Job-12345