BuildGraph 使用

此页面提供了 BuildGraph 脚本的使用示例。

Windows
MacOS
Linux

BuildGraph 作为 AutomationTool 的一部分实现,可直接在 Windows 上从虚幻引擎 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\
Select Skin
Light
Dark

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback