Choose your operating system:
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\