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 上从虚幻引擎 4 解决方案运行，或通过命令行的`Engine/Build/BatchFiles/RunUAT.bat` 批处理文件运行。在 Mac 或 Linux 上，可使用 `Engine/Build/BatchFiles/RunUAT.sh` 外壳脚本运行。如您需要了解如何从命令行使用 BuildGraph，请参考我们提供的使用命令范例。

(#ShowingOptions&Nodes)
## 显示选项和节点

显示 BuildGraph 脚本中可用的所有节点和选项：

	BuildGraph -Script=Engine/Build/Graph/Examples/AllExamples -ListOnly

(#SettinganOption)
## 设置选项

设置脚本中定义的选项：

	BuildGraph -Script=Engine/Build/Graph/Examples/Properties.xml -ListOnly -Set:CommandLineProperty=ABCDEF

(#SeeingNodeExecution)
## 查看节点执行

查看节点对目标进行的执行：

	BuildGraph -Script=Engine\Build\Graph\Examples\AllExamples.xml -Target="All Examples" -ListOnly

(#CleaningPreviousBuilds)
## 清理老旧构建

清理老旧构建并执行特定目标：

	BuildGraph -Script=Engine\Build\Graph\Examples\AllExamples.xml -Target="Property Examples" -Clean

(#WritingoutanXMLSchema)
## 写出 XML 模式

写出包含所有注册任务的 XML 模式：

	BuildGraph -Schema=Engine\Build\Graph\Schema.xsd

(#GeneratingaPreprocessedScript)
## 生成预处理脚本

输出预处理版本的脚本（用于调试）：

	BuildGraph -Script=Engine\Build\Graph\Examples\AllExamples.xml -Target="All Examples" -ListOnly -Preprocess=D:\Preprocessed.xml

(#ExportingaPreprocessedGraphtoJSON)
## 将预处理图表导出为 JSON

将预处理图表导出为 JSON（以便在构建系统上进行动态配置）：

	BuildGraph -Script=Engine\Build\Graph\Examples\AllExamples.xml -Target="All Examples" -Export=D:\ExportedGraph.json

(#ExecutingaSingleNode)
## 执行单个节点

在构建系统上执行单个节点（同时从共享存储传输中间物，或将中间物传输至共享存储）：

	BuildGraph -Script=Engine\Build\Graph\Examples\AllExamples.xml -Target="All Examples" -Clean -SingleNode=”Manipulate Some Files” -SharedStorage=P:\Network-Share\Unique-Job-12345\