2019-01-31 15:44:30 -05:00
|
|
|
|
INTSourceChangelist:3356804
|
2016-12-19 13:09:22 -05:00
|
|
|
|
Availability:Public
|
|
|
|
|
|
Title:BuildGraph 使用
|
2016-08-15 23:04:53 -04:00
|
|
|
|
Crumbs: %ROOT%, Programming, Programming/Development, Programming/Development/BuildGraph
|
2016-12-19 13:09:22 -05:00
|
|
|
|
Description:此页面为您展示如何使用 BuildGraph 脚本。
|
|
|
|
|
|
version:4.13
|
2016-08-15 23:04:53 -04:00
|
|
|
|
parent:Programming/Development/BuildGraph
|
|
|
|
|
|
type:Overview
|
2016-12-19 13:09:22 -05:00
|
|
|
|
related:Programming/Development/InstalledBuildReference
|
2019-01-31 15:44:30 -05:00
|
|
|
|
tags:Programming
|
2016-08-15 23:04:53 -04:00
|
|
|
|
tags:BuildGraph
|
|
|
|
|
|
|
|
|
|
|
|
[VAR:TopicCompact]
|
|
|
|
|
|
[OBJECT:TopicCompact]
|
|
|
|
|
|
[PARAM:image]
|
2016-12-19 13:09:22 -05:00
|
|
|
|

|
2016-08-15 23:04:53 -04:00
|
|
|
|
[/PARAM]
|
|
|
|
|
|
[PARAM:icon]
|
|
|
|
|
|
(convert:false)
|
|
|
|
|
|
[/PARAM]
|
|
|
|
|
|
[PARAM:title]
|
2016-12-19 13:09:22 -05:00
|
|
|
|
%Programming/Development/BuildGraph/Usage:title%
|
2016-08-15 23:04:53 -04:00
|
|
|
|
[/PARAM]
|
|
|
|
|
|
[PARAM:description]
|
2016-12-19 13:09:22 -05:00
|
|
|
|
%Programming/Development/BuildGraph/Usage:description%
|
2016-08-15 23:04:53 -04:00
|
|
|
|
[/PARAM]
|
|
|
|
|
|
[PARAM:path]
|
2016-12-19 13:09:22 -05:00
|
|
|
|
[RELATIVE:Programming/Development/BuildGraph/Usage]
|
2016-08-15 23:04:53 -04:00
|
|
|
|
[/PARAM]
|
|
|
|
|
|
[/OBJECT]
|
|
|
|
|
|
[/VAR]
|
|
|
|
|
|
|
|
|
|
|
|
[TOC(start:1 end:3)]
|
|
|
|
|
|
|
2016-12-19 13:09:22 -05:00
|
|
|
|
BuildGraph 作为 AutomationTool 的一部分实现,可直接在 Windows 上从虚幻引擎 4 解决方案运行,或通过命令行的`Engine/Build/BatchFiles/RunUAT.bat` 批处理文件运行。在 Mac 或 Linux 上,可使用 `Engine/Build/BatchFiles/RunUAT.sh` 外壳脚本运行。如您需要了解如何从命令行使用 BuildGraph,请参考我们提供的使用命令范例。
|
2016-08-15 23:04:53 -04:00
|
|
|
|
|
2019-01-31 15:44:30 -05:00
|
|
|
|
(#ShowingOptions&Nodes)
|
2016-12-19 13:09:22 -05:00
|
|
|
|
## 显示选项和节点
|
2016-08-15 23:04:53 -04:00
|
|
|
|
|
2016-12-19 13:09:22 -05:00
|
|
|
|
显示 BuildGraph 脚本中可用的所有节点和选项:
|
2016-08-15 23:04:53 -04:00
|
|
|
|
|
|
|
|
|
|
BuildGraph -Script=Engine/Build/Graph/Examples/AllExamples -ListOnly
|
|
|
|
|
|
|
2019-01-31 15:44:30 -05:00
|
|
|
|
(#SettinganOption)
|
2016-12-19 13:09:22 -05:00
|
|
|
|
## 设置选项
|
2016-08-15 23:04:53 -04:00
|
|
|
|
|
2016-12-19 13:09:22 -05:00
|
|
|
|
设置脚本中定义的选项:
|
2016-08-15 23:04:53 -04:00
|
|
|
|
|
|
|
|
|
|
BuildGraph -Script=Engine/Build/Graph/Examples/Properties.xml -ListOnly -Set:CommandLineProperty=ABCDEF
|
|
|
|
|
|
|
2019-01-31 15:44:30 -05:00
|
|
|
|
(#SeeingNodeExecution)
|
2016-12-19 13:09:22 -05:00
|
|
|
|
## 查看节点执行
|
2016-08-15 23:04:53 -04:00
|
|
|
|
|
2016-12-19 13:09:22 -05:00
|
|
|
|
查看节点对目标进行的执行:
|
2016-08-15 23:04:53 -04:00
|
|
|
|
|
|
|
|
|
|
BuildGraph -Script=Engine\Build\Graph\Examples\AllExamples.xml -Target="All Examples" -ListOnly
|
|
|
|
|
|
|
2019-01-31 15:44:30 -05:00
|
|
|
|
(#CleaningPreviousBuilds)
|
2016-12-19 13:09:22 -05:00
|
|
|
|
## 清理老旧构建
|
2016-08-15 23:04:53 -04:00
|
|
|
|
|
2016-12-19 13:09:22 -05:00
|
|
|
|
清理老旧构建并执行特定目标:
|
2016-08-15 23:04:53 -04:00
|
|
|
|
|
|
|
|
|
|
BuildGraph -Script=Engine\Build\Graph\Examples\AllExamples.xml -Target="Property Examples" -Clean
|
|
|
|
|
|
|
2019-01-31 15:44:30 -05:00
|
|
|
|
(#WritingoutanXMLSchema)
|
2016-12-19 13:09:22 -05:00
|
|
|
|
## 写出 XML 模式
|
2016-08-15 23:04:53 -04:00
|
|
|
|
|
2016-12-19 13:09:22 -05:00
|
|
|
|
写出包含所有注册任务的 XML 模式:
|
2016-08-15 23:04:53 -04:00
|
|
|
|
|
|
|
|
|
|
BuildGraph -Schema=Engine\Build\Graph\Schema.xsd
|
|
|
|
|
|
|
2019-01-31 15:44:30 -05:00
|
|
|
|
(#GeneratingaPreprocessedScript)
|
2016-12-19 13:09:22 -05:00
|
|
|
|
## 生成预处理脚本
|
2016-08-15 23:04:53 -04:00
|
|
|
|
|
2016-12-19 13:09:22 -05:00
|
|
|
|
输出预处理版本的脚本(用于调试):
|
2016-08-15 23:04:53 -04:00
|
|
|
|
|
|
|
|
|
|
BuildGraph -Script=Engine\Build\Graph\Examples\AllExamples.xml -Target="All Examples" -ListOnly -Preprocess=D:\Preprocessed.xml
|
|
|
|
|
|
|
2019-01-31 15:44:30 -05:00
|
|
|
|
(#ExportingaPreprocessedGraphtoJSON)
|
2016-12-19 13:09:22 -05:00
|
|
|
|
## 将预处理图表导出为 JSON
|
2016-08-15 23:04:53 -04:00
|
|
|
|
|
2016-12-19 13:09:22 -05:00
|
|
|
|
将预处理图表导出为 JSON(以便在构建系统上进行动态配置):
|
2016-08-15 23:04:53 -04:00
|
|
|
|
|
|
|
|
|
|
BuildGraph -Script=Engine\Build\Graph\Examples\AllExamples.xml -Target="All Examples" -Export=D:\ExportedGraph.json
|
|
|
|
|
|
|
2019-01-31 15:44:30 -05:00
|
|
|
|
(#ExecutingaSingleNode)
|
2016-12-19 13:09:22 -05:00
|
|
|
|
## 执行单个节点
|
2016-08-15 23:04:53 -04:00
|
|
|
|
|
2016-12-19 13:09:22 -05:00
|
|
|
|
在构建系统上执行单个节点(同时从共享存储传输中间物,或将中间物传输至共享存储):
|
2016-08-15 23:04:53 -04:00
|
|
|
|
|
2016-12-19 13:09:22 -05:00
|
|
|
|
BuildGraph -Script=Engine\Build\Graph\Examples\AllExamples.xml -Target="All Examples" -Clean -SingleNode=”Manipulate Some Files” -SharedStorage=P:\Network-Share\Unique-Job-12345\
|