虚幻引擎5文档已被迁移至 Epic开发者社区

AutomationTool 是一个主机程序和一组实用程序库，通过它可以使用C#来编制与虚幻引擎相关的无人值守过程脚本。我们在内部使用AutomationTool执行各种任务，包括构建、转化和运行游戏，运行自动化测试，和编制其他操作的脚本以在我们的Build Farm上运行。

AutomationTool的源代码以及在它下面运行的各种脚本都可以在 Engine/Source/Programs/AutomationTool 下找到。

AutomationTool的工作原理

自动化项目

AutomationTool运行时会查找所有自动化项目（以Visual Studio C#项目的形式保存，带有 .Automation.csproj 扩展名），编译它们，然后使用反射法找到要执行的相应命令。这些命令作为从 BuildCommand 基础类衍生的类实现，通过类名标识。

运行AutomationTool

你可以在Windows上通过Visual Studio调试程序运行命令，也可以从Windows、Mac和Linux上的命令行运行命令。

通过调试程序运行命令

要通过Visual Studio中的调试程序运行AutomationTool：

1. 右键点击AutomationTool项目，然后从情境菜单中选择 属性（Properties） 。

2. 选择 调试（Debug） 选项卡，然后在 启动选项 > 命令行参数： （Start Options > Command line arguments:） 字段中输入命令名称（我们在这个示例中使用 SampleCommand ）。

3. 在脚本中设置断点，然后按F5键（或点击Visual Studio工具栏中的 启动（Start） 按钮）。

从命令行运行命令（Windows）

要从命令行运行AutomationTool：

1. 打开一个命令提示符窗口。

2. 将工作目录改到 Engine/Build/BatchFiles 。

3. 在命令行中输入下列内容： RunUAT.bat SampleCommand

从终端运行命令（Mac/Linux）

要从终端运行AutomationTool：

1. 打开终端。

2. 将工作目录改到 Engine/Build/BatchFiles 。

3. 在命令行中输入下列内容： ./RunUAT.sh SampleCommand

命令行语法

AutomationTool命令行的一般语法：

RunUAT.bat Command1 [-Arg1 -Arg2...]Command2 [-Arg3 -Arg4…] ...

这里的两条命令将会依次运行。 -Arg1 和 -Arg2 会传递到 Command1 ，而 -Arg3 和 -Arg4 传递到 Command2 。

全局选项：

如果设置此选项，可使用下列环境变量来配置对于构建机器的Perforce支持。它们可以通过AutomationTool命令行按 VARNAME=VALUE 语法设置，也可以从当前会话继承。