INTSourceChangelist:3356804
Availability:Public
Title:BuildGraph の使用方法
Crumbs: %ROOT%, Programming, Programming/Development, Programming/Development/BuildGraph
Description:BuildGraph の使用方法を説明します。
version:4.13
parent:Programming/Development/BuildGraph
type:Overview
related:Programming/Development/InstalledBuildReference
tags:Programming
tags:BuildGraph

[VAR:TopicCompact]
[OBJECT:TopicCompact]
	[PARAM:image]
		![%Programming/Development/BuildGraph/Usage%](usage_topic.png)
	[/PARAM]
	[PARAM:icon]
		![](%ROOT%/reference_icon.png)(convert:false)
	[/PARAM]
	[PARAM:title]
		%Programming/Development/BuildGraph/Usage:title%
	[/PARAM]
	[PARAM:description]
		%Programming/Development/BuildGraph/Usage:description%
	[/PARAM]
	[PARAM:path]
		[RELATIVE:Programming/Development/BuildGraph/Usage]
	[/PARAM]
[/OBJECT]
[/VAR]

[TOC(start:1 end:3)]

BuildGraph は、AutomationTool の一部として実装されます。これは、Windows の Unreal Engine 4 ソリューションから直接実行することができます。 
または、コマンドラインから `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" -Clean

## XML スキーマ

すべての登録されたタスクを含む 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\