此页面由 Cloud Translation API 翻译。

RunUtil

public class RunUtil
extends Object implements IRunUtil

java.lang.Object 中
↳	com.android.tradefed.util.RunUtil

用于执行操作的辅助方法的集合。

摘要

字段
`public static final String`	`INHERITIO_PREFIX`
`public static final String`	`RUNNABLE_NOTIFIER_NAME`

公共构造函数
`RunUtil()` 创建要使用的新 `RunUtil` 对象。
`RunUtil(boolean inheritEnvVars)`

公共方法
`void`	`allowInterrupt(boolean allow)` 允许/禁止在当前线程上运行中断。
`static IRunUtil`	`getDefault()` 获取对默认 `RunUtil` 对象的引用。
`void`	`interrupt(Thread thread, String message, ErrorIdentifier errorId)` 中断指定线程上正在进行/即将进行的运行操作。
`void`	`interrupt(Thread thread, String message)` 中断指定线程上正在进行/即将进行的运行操作。
`boolean`	`isInterruptAllowed()` 提供 RunUtil 的中断状态。
`static void`	`linkFile(File destRoot, String relToRoot, File target)` 将 `target` 关联至 `destRoot` 下的某个地点。
`Process`	`runCmdInBackground(Redirect redirect, command)` 接受命令参数的备用 `runCmdInBackground(String)` 方法采用 `ERROR(/List)` 格式。
`Process`	`runCmdInBackground( command)` 接受命令参数的备用 `runCmdInBackground(String)` 方法采用 `ERROR(/List)` 格式。
`Process`	`runCmdInBackground( command, OutputStream output)` 使用 `ERROR(/OutputStream)` 运行命令会记录命令的输出。
`Process`	`runCmdInBackground(String... command)` 用于异步执行系统命令的辅助方法。
`Process`	`runCmdInBackground(Redirect redirect, String... command)` 用于异步执行系统命令的辅助方法。
`boolean`	`runEscalatingTimedRetry(long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)` 多次阻塞并执行操作，直到成功。
`boolean`	`runFixedTimedRetry(long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)` 多次阻塞并执行操作，直到成功。
`boolean`	`runFixedTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)` 多次阻塞并执行操作，直到成功。
`CommandStatus`	`runTimed(long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)` 阻塞并执行操作，如果所需时间超过指定时间，则取消。
`CommandResult`	`runTimedCmd(long timeout, OutputStream stdout, OutputStream stderr, String... command)` 用于执行系统命令的辅助方法，如果执行时间超过指定时间，则中止。并将输出重定向到文件（如果已指定）。
`CommandResult`	`runTimedCmd(long timeout, String... command)` 用于执行系统命令，并在用时超过指定值时中止的辅助方法。
`CommandResult`	`runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)` 用于执行系统命令，并在用时超过指定值时中止的辅助方法。
`CommandResult`	`runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)` 用于执行系统命令，并在用时超过指定值时中止的辅助方法。
`CommandResult`	`runTimedCmdSilently(long timeout, String... command)` 用于执行系统命令，并在用时超过指定值时中止的辅助方法。
`CommandResult`	`runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command)` 用于执行系统命令，并在用时超过指定值时中止的辅助方法。
`CommandResult`	`runTimedCmdWithInput(long timeout, String input, File stdoutFile, File stderrFile, String... command)` 用于执行系统命令的辅助方法，如果执行时间超过指定时间，则中止。并将输出重定向到文件（如果已指定）。
`CommandResult`	`runTimedCmdWithInput(long timeout, String input, String... command)` 一种辅助方法，用于执行需要 stdin 输入的系统命令，并在该命令时中止花费的时间超过指定的时间。
`CommandResult`	`runTimedCmdWithInput(long timeout, String input, command)` 一种辅助方法，用于执行需要 stdin 输入的系统命令，并在该命令时中止花费的时间超过指定的时间。
`CommandResult`	`runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)` 用于执行需要从文件重定向 Stdin 的系统命令的帮助程序方法，以及如果耗时超过指定时间，则中止。
`CommandResult`	`runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)` 用于执行系统命令的辅助方法，如果执行时间超过指定时间，则中止。并将输出重定向到文件（如果已指定）。
`CommandResult`	`runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)` 用于执行系统命令，并在用时超过指定值时中止的辅助方法。
`CommandResult`	`runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)` 使用缓存执行系统命令的辅助方法。
`boolean`	`runTimedRetry(long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)` 多次阻塞并执行操作，直到成功。
`boolean`	`runTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)` 多次阻塞并执行操作，直到成功。
`CommandStatus`	`runTimedWithOutputMonitor(long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)` 阻塞并执行操作，如果所需时间超过指定时间，则取消。
`void`	`setEnvVariable(String name, String value)` 设置在运行系统命令时使用的环境变量。
`void`	`setEnvVariablePriority(IRunUtil.EnvPriority priority)` 决定是否在创建进程时取消设置环境变量的级别更高比设置更重要
`void`	`setInterruptibleInFuture(Thread thread, long timeMs)` 在等待一段时间后设为可中断。
`void`	`setLinuxInterruptProcess(boolean interrupt)` 允许使用 Linux 的“kill”功能通过 #runTimed 方法运行的进程超时。
`void`	`setRedirectStderrToStdout(boolean redirect)` 将标准错误流设置为在运行系统时重定向到标准输出流命令。
`void`	`setWorkingDir(File dir)` 设置系统命令的工作目录。
`void`	`sleep(long time)` 帮助程序方法在给定时间内休眠，忽略所有异常。
`static String`	`toRelative(File start, String target)`
`void`	`unsetEnvVariable(String key)` 取消设置环境变量，以便系统命令在没有此环境变量的情况下运行。环境变量可能继承自父级进程，因此我们需要删除 `ProcessBuilder.environment()` 中的环境变量

字段

INHERITIO_PREFIX

public static final String INHERITIO_PREFIX

RUNNABLE_NOTIFIER_NAME

public static final String RUNNABLE_NOTIFIER_NAME

公共构造函数

RunUtil

public RunUtil ()

创建要使用的新 RunUtil 对象。

RunUtil

public RunUtil (boolean inheritEnvVars)

参数
`inheritEnvVars`	`boolean`

公共方法

allowInterrupt（允许中断）

public void allowInterrupt (boolean allow)

允许/禁止在当前线程上运行中断。如果允许，请运行当前线程可通过 interrupt(Thread, String) 方法从其他线程中断。

参数
`allow`	`boolean`：是否允许在当前线程上运行运行中断。

getDefault

public static IRunUtil getDefault ()

获取对默认 RunUtil 对象的引用。

这对于想要使用 IRunUtil 而不进行自定义的调用者非常有用。建议确实需要自定义 IRunUtil 实例的调用方（即，需要调用 setEnvVariable(String, String) 或 setWorkingDir(File)创建自己的副本。

返回
`IRunUtil`

中断

public void interrupt (Thread thread, 
                String message, 
                ErrorIdentifier errorId)

中断指定线程上正在进行/即将进行的运行操作。在指定的线程将抛出 RunInterruptedException。

参数
`message`	`String`：`RunInterruptedException` 的消息。
`errorId`	`ErrorIdentifier`：表示已知中断原因。

中断

public void interrupt (Thread thread, 
                String message)

中断指定线程上正在进行/即将进行的运行操作。在指定的线程将抛出 RunInterruptedException。

参数
`message`	`String`：`RunInterruptedException` 的消息。

isInterruptAllowed

public boolean isInterruptAllowed ()

提供 RunUtil 的中断状态。

返回
`boolean`	如果运行可以中断，则为 true，否则为 false。

链接文件

public static void linkFile (File destRoot, 
                String relToRoot, 
                File target)

将 target 关联至 destRoot 下的某个地点。

如果目标文件或符号链接已存在于 destRoot 下，则相应文件不会关联。

参数
`destRoot`	`File`：该目的地的根目录。
`relToRoot`	`String`：从目标目录到根目录的相对路径。
`target`	`File`：要链接的目标文件。

抛出
	如果目标文件未能链接，则会发生此错误。

运行 CmdInBackground

public Process runCmdInBackground (Redirect redirect, 
                 command)

接受命令参数的备用 runCmdInBackground(String) 方法采用 ERROR(/List) 格式。

参数
`redirect`	`Redirect`：要应用于 `ProcessBuilder` 的 `ERROR(/Redirect)`。
`command`	：包含指定的系统命令和可选的实参的 `ERROR(/List)` 执行

返回
`Process`	已执行命令的 `Process`

运行 CmdInBackground

public Process runCmdInBackground ( command)

接受命令参数的备用 runCmdInBackground(String) 方法采用 ERROR(/List) 格式。

参数
`command`	：包含指定的系统命令和可选的实参的 `ERROR(/List)` 执行

返回
`Process`	已执行命令的 `Process`

运行 CmdInBackground

public Process runCmdInBackground ( command, 
                OutputStream output)

使用 ERROR(/OutputStream) 运行命令会记录命令的输出。 stdout 和 stderr 会合并在一起。

参数
`command`	：要运行的命令
`output`	`OutputStream`：用于保存输出的 OutputStream

返回
`Process`	运行命令的 `Process`

运行 CmdInBackground

public Process runCmdInBackground (String... command)

用于异步执行系统命令的辅助方法。

将在启动命令后立即返回。

参数
`command`	`String`：指定的系统命令和 exec 的可选参数

返回
`Process`	已执行命令的 `Process`

运行 CmdInBackground

public Process runCmdInBackground (Redirect redirect, 
                String... command)

用于异步执行系统命令的辅助方法。

将在启动命令后立即返回。

参数
`redirect`	`Redirect`：要应用于 `ProcessBuilder` 的 `ERROR(/Redirect)`。
`command`	`String`：指定的系统命令和 exec 的可选参数

返回
`Process`	已执行命令的 `Process`

runEscalatingTimedRetry 返回

public boolean runEscalatingTimedRetry (long opTimeout, 
                long initialPollInterval, 
                long maxPollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

多次阻塞并执行操作，直到成功。

以指数方式增加操作尝试之间的等待时间。这旨在用于执行轮询服务器等操作时，可以给服务器留出恢复时间暂时无法使用。

参数
`opTimeout`	`long`：单次操作尝试的最长等待时间（以毫秒为单位）
`initialPollInterval`	`long`：两次操作尝试之间的初始等待时间
`maxPollInterval`	`long`：两次操作尝试之间的最长等待时间
`maxTime`	`long`：继续尝试操作的大致总时长上限
`runnable`	`IRunUtil.IRunnableResult`：要执行的 `IRunUtil.IRunnableResult`

返回
`boolean`	如果操作在 maxTime 过期之前成功完成，则为 `true`

runFixedTimed 重试

public boolean runFixedTimedRetry (long opTimeout, 
                long pollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

多次阻塞并执行操作，直到成功。

参数
`opTimeout`	`long`：单次操作尝试的最长等待时间（以毫秒为单位）
`pollInterval`	`long`：两次操作尝试之间的初始等待时间
`maxTime`	`long`：继续尝试操作的大致总时长上限
`runnable`	`IRunUtil.IRunnableResult`：要执行的 `IRunUtil.IRunnableResult`

返回
`boolean`	如果操作在 maxTime 过期之前成功完成，则为 `true`

runFixedTimedRetryWithOutputMonitor

public boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, 
                long idleOutputTimeout, 
                long pollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

多次阻塞并执行操作，直到成功。还会监控活动的输出流，如果在指定时间内未观察到任何流活动，则取消。如果将 idilOutputTimeout 值设为零，则不会发生音频流监控。

参数
`opTimeout`	`long`：单次操作尝试的最长等待时间（以毫秒为单位）
`idleOutputTimeout`	`long`：输出流上输出等待的最长时间（以毫秒为单位）
`pollInterval`	`long`：两次操作尝试之间的初始等待时间
`maxTime`	`long`：继续尝试操作的大致总时长上限
`runnable`	`IRunUtil.IRunnableResult`：要执行的 `IRunUtil.IRunnableResult`

返回
`boolean`	如果操作在 maxTime 过期之前成功完成，则为 `true`

runTimed 键

public CommandStatus runTimed (long timeout, 
                IRunUtil.IRunnableResult runnable, 
                boolean logErrors)

阻塞并执行操作，如果所需时间超过指定时间，则取消。

参数
`timeout`	`long`：最长等待时间（毫秒）
`runnable`	`IRunUtil.IRunnableResult`：要执行的 `IRunUtil.IRunnableResult`
`logErrors`	`boolean`：记录异常与非异常相关的错误。

返回
`CommandStatus`	运算的 `CommandStatus` 结果。

runTimedCmd

public CommandResult runTimedCmd (long timeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                String... command)

用于执行系统命令的辅助方法，如果执行时间超过指定时间，则中止。并将输出重定向到文件（如果已指定）。当以这种方式提供 ERROR(/OutputStream) 时，它们将在函数结束时保持打开状态。

参数
`timeout`	`long`：超时最长等待时间（以毫秒为单位）。0 表示无超时。
`stdout`	`OutputStream`：`ERROR(/OutputStream)`，标准输出将被重定向到该位置。可以为 null。
`stderr`	`OutputStream`：`ERROR(/OutputStream)`，错误输出将被重定向到该位置。可以为 null。
`command`	`String`：指定的系统命令和 exec 的可选参数

返回
`CommandResult`	包含命令运行结果的 `CommandResult`

runTimedCmd

public CommandResult runTimedCmd (long timeout, 
                String... command)

用于执行系统命令，并在用时超过指定值时中止的辅助方法。

参数
`timeout`	`long`：最长等待时间（以毫秒为单位）。0 表示无超时。
`command`	`String`：指定的系统命令和 exec 的可选参数

返回
`CommandResult`	包含命令运行结果的 `CommandResult`

runTimedCmd 重试

public CommandResult runTimedCmdRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

用于执行系统命令，并在用时超过指定值时中止的辅助方法。

参数
`timeout`	`long`：每次尝试的最长等待时间（以毫秒为单位）
`retryInterval`	`long`：两次命令重试之间的等待时间
`attempts`	`int`：尝试次数上限
`command`	`String`：指定的系统命令和 exec 的可选参数

返回
`CommandResult`	包含命令运行结果的 `CommandResult`

runTimedCmd 使用输出监视器重试

public CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                long retryInterval, 
                int attempts, 
                String... command)

用于执行系统命令，并在用时超过指定值时中止的辅助方法。同时监控输出流是否存在活动，如果没有流活动，则中止特定时间的延迟如果 iderOutputTimeout 设为零，则不监控数据流将发生什么。

参数
`timeout`	`long`：每次尝试的最长等待时间（以毫秒为单位）
`idleOutputTimeout`	`long`：输出流上输出等待的最长时间（以毫秒为单位）
`retryInterval`	`long`：两次命令重试之间的等待时间
`attempts`	`int`：尝试次数上限
`command`	`String`：指定的系统命令和 exec 的可选参数

返回
`CommandResult`	包含命令运行结果的 `CommandResult`

runTimedCmdSilently（静默运行）

public CommandResult runTimedCmdSilently (long timeout, 
                String... command)

用于执行系统命令，并在用时超过指定值时中止的辅助方法。与 runTimedCmd(long, String) 类似，但不记录异常。

参数
`timeout`	`long`：最长等待时间（毫秒）
`command`	`String`：指定的系统命令和 exec 的可选参数

返回
`CommandResult`	包含命令运行结果的 `CommandResult`

runTimedCmd 静默地重试

public CommandResult runTimedCmdSilentlyRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

用于执行系统命令，并在用时超过指定值时中止的辅助方法。与runTimedCmdRetry(long, long, int, String[])类似，但不会记录异常时出现的任何错误。

参数
`timeout`	`long`：最长等待时间（毫秒）
`retryInterval`	`long`：两次命令重试之间的等待时间
`attempts`	`int`：尝试次数上限
`command`	`String`：指定的系统命令和 exec 的可选参数

返回
`CommandResult`	包含命令运行结果的 `CommandResult`

runTimedCmdWithInput（在输入时运行）

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                File stdoutFile, 
                File stderrFile, 
                String... command)

用于执行系统命令的辅助方法，如果执行时间超过指定时间，则中止。并将输出重定向到文件（如果已指定）。

参数
`timeout`	`long`：超时最长等待时间（以毫秒为单位）。0 表示无超时。
`input`	`String`：要传递给进程的 stdin 输入
`stdoutFile`	`File`：`ERROR(/File)`，标准输出将被重定向到该位置。可以为 null。
`stderrFile`	`File`：`ERROR(/File)`，错误输出将被重定向到该位置。可以为 null。
`command`	`String`：指定的系统命令和 exec 的可选参数

返回
`CommandResult`	包含命令运行结果的 `CommandResult`

runTimedCmdWithInput（在输入时运行）

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                String... command)

一种辅助方法，用于执行需要 stdin 输入的系统命令，并在该命令时中止花费的时间超过指定的时间。

参数
`timeout`	`long`：最长等待时间（毫秒）
`input`	`String`：要传递给进程的 stdin 输入
`command`	`String`：指定的系统命令和 exec 的可选参数

返回
`CommandResult`	包含命令运行结果的 `CommandResult`

runTimedCmdWithInput（在输入时运行）

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                 command)

一种辅助方法，用于执行需要 stdin 输入的系统命令，并在该命令时中止花费的时间超过指定的时间。

参数
`timeout`	`long`：最长等待时间（毫秒）
`input`	`String`：要传递给进程的 stdin 输入
`command`	：包含系统命令和 exec（可选）参数的 `ERROR(/List)`

返回
`CommandResult`	包含命令运行结果的 `CommandResult`

runTimedCmdWithInputRedirect 类

public CommandResult runTimedCmdWithInputRedirect (long timeout, 
                File inputRedirect, 
                String... command)

用于执行需要从文件重定向 Stdin 的系统命令的帮助程序方法，以及如果耗时超过指定时间，则中止。

参数
`timeout`	`long`：最长等待时间（毫秒）
`inputRedirect`	`File`：使用 `ProcessBuilder.redirectInput()` 作为标准输入重定向的 `ERROR(/File)`。如果为 null，stdin 将不会进行重定向。
`command`	`String`：指定的系统命令和 exec 的可选参数

返回
`CommandResult`	包含命令运行结果的 `CommandResult`

runTimedCmdWithOutputMonitor

public CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                String... command)

参数
`timeout`	`long`：超时最长等待时间（以毫秒为单位）。0 表示无超时。
`idleOutputTimeout`	`long`：输出流上输出等待的最长时间（以毫秒为单位）
`stdout`	`OutputStream`：`ERROR(/OutputStream)`，标准输出将被重定向到该位置。可以为 null。
`stderr`	`OutputStream`：`ERROR(/OutputStream)`，错误输出将被重定向到该位置。可以为 null。
`command`	`String`：指定的系统命令和 exec 的可选参数

返回
`CommandResult`	包含命令运行结果的 `CommandResult`

runTimedCmdWithOutputMonitor

public CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                String... command)

参数
`timeout`	`long`：最长等待时间（以毫秒为单位）。0 表示无超时。
`idleOutputTimeout`	`long`：输出流上输出等待的最长时间（以毫秒为单位）
`command`	`String`：指定的系统命令和 exec 的可选参数

返回
`CommandResult`	包含命令运行结果的 `CommandResult`

runTimedCmdWithOutputMonitor

public CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                ICacheClient cacheClient, 
                String... command)

使用缓存执行系统命令的辅助方法。

如果指定 cacheClient，则将启用缓存。如果缓存已可用，则返回缓存结果。否则，runTimedCmdWithOutputMonitor(long, long, OutputStream, OutputStream, String) 将用于执行该命令，而结果将上传以进行缓存。

参数
`timeout`	`long`：超时最长等待时间（以毫秒为单位）。0 表示无超时。
`idleOutputTimeout`	`long`：输出流上输出等待的最长时间（以毫秒为单位）。
`stdout`	`OutputStream`：`ERROR(/OutputStream)`，标准输出将被重定向到该位置。可以为 null。
`stderr`	`OutputStream`：`ERROR(/OutputStream)`，错误输出将被重定向到该位置。可以为 null。
`cacheClient`	`ICacheClient`：用于处理缓存的 `ICacheClient` 实例。
`command`	`String`：指定的系统命令和 exec 的可选参数。

返回
`CommandResult`	包含命令运行结果的 `CommandResult`。

runTimedRetry [运行时间重试]

public boolean runTimedRetry (long opTimeout, 
                long pollInterval, 
                int attempts, 
                IRunUtil.IRunnableResult runnable)

多次阻塞并执行操作，直到成功。

参数
`opTimeout`	`long`：一次操作尝试等待的最长时间（以毫秒为单位）
`pollInterval`	`long`：两次命令重试之间的等待时间
`attempts`	`int`：尝试次数上限
`runnable`	`IRunUtil.IRunnableResult`：要执行的 `IRunUtil.IRunnableResult`

返回
`boolean`	如果操作在达到尝试次数之前成功完成，则为 `true`。

runTimedRetryWithOutputMonitor

public boolean runTimedRetryWithOutputMonitor (long opTimeout, 
                long idleOutputTimeout, 
                long pollInterval, 
                int attempts, 
                IRunUtil.IRunnableResult runnable)

参数
`opTimeout`	`long`：一次操作尝试等待的最长时间（以毫秒为单位）
`idleOutputTimeout`	`long`：输出流上输出等待的最长时间（以毫秒为单位）
`pollInterval`	`long`：两次命令重试之间的等待时间
`attempts`	`int`：尝试次数上限
`runnable`	`IRunUtil.IRunnableResult`：要执行的 `IRunUtil.IRunnableResult`

返回
`boolean`	如果操作在达到尝试次数之前成功完成，则为 `true`。

runTimedWithOutputMonitor

public CommandStatus runTimedWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                IRunUtil.IRunnableResult runnable, 
                boolean logErrors)

阻塞并执行操作，如果所需时间超过指定时间，则取消。此外，监控输出流中的活动，如果未在。如果将 idilOutputTimeout 值设为零，则不会发生音频流监控。

参数
`timeout`	`long`：最长等待时间（毫秒）
`idleOutputTimeout`	`long`：输出流上输出等待的最长时间（以毫秒为单位）
`runnable`	`IRunUtil.IRunnableResult`：要执行的 `IRunUtil.IRunnableResult`
`logErrors`	`boolean`：记录异常与非异常相关的错误。

返回
`CommandStatus`	运算的 `CommandStatus` 结果。

setEnvVariable

public void setEnvVariable (String name, 
                String value)

设置在运行系统命令时使用的环境变量。

参数
`name`	`String`：变量名称
`value`	`String`：变量值

setEnvVariablePriority

public void setEnvVariablePriority (IRunUtil.EnvPriority priority)

决定是否在创建进程时取消设置环境变量的级别更高比设置更重要默认情况下，取消设置具有较高的优先级：也就是说，如果试图使用但不会出现此情况，因为变量会被取消设置。无法用于默认的“IRunUtil”实例。

参数
`priority`	`IRunUtil.EnvPriority`

setInterruptibleInFuture

public void setInterruptibleInFuture (Thread thread, 
                long timeMs)

在等待一段时间后设为可中断。 ERROR(/CommandScheduler#shutdownHard()) 来强制执行，我们最终会终止。

参数
`thread`	`Thread`：将变为可中断的线程。
`timeMs`	`long`：在设置可中断之前等待的时间。

setLinuxInterruptProcess

public void setLinuxInterruptProcess (boolean interrupt)

允许使用 Linux 的“kill”功能通过 #runTimed 方法运行的进程超时。无法用于默认的“IRunUtil”实例。

参数
`interrupt`	`boolean`

setRedirectStderrToStdout

public void setRedirectStderrToStdout (boolean redirect)

将标准错误流设置为在运行系统时重定向到标准输出流命令。初始值为 false。

参数
`redirect`	`boolean`：用于指定是否重定向的新值

setWORKDir

public void setWorkingDir (File dir)

设置系统命令的工作目录。

参数
`dir`	`File`：工作目录

sleep

public void sleep (long time)

帮助程序方法在给定时间内休眠，忽略所有异常。

参数
`time`	`long`：休眠 ms。小于或等于 0 的值将被忽略

相对

public static String toRelative (File start, 
                String target)

参数
`start`	`File`
`target`	`String`

返回
`String`

UnsetEnvVariable

public void unsetEnvVariable (String key)

取消设置环境变量，以便系统命令在没有此环境变量的情况下运行。环境变量可能继承自父级进程，因此我们需要删除 ProcessBuilder.environment() 中的环境变量

参数
`key`	`String`：变量名称

另见：

ProcessBuilder.environment()