Google 致力于为黑人社区推动种族平等。查看具体举措
此页面由 Cloud Translation API 翻译。
Switch to English

ICommandScheduler

public interface ICommandScheduler

com.android.tradefed.command.ICommandScheduler


运行TradeFederation命令的调度程序。

摘要

嵌套类

interface ICommandScheduler.IScheduledInvocationListener

调用完成时的调用事件侦听器。

公开方法

abstract boolean addCommand (String[] args)

向调度程序添加命令。

abstract void addCommandFile (String cmdFile, extraArgs) addCommandFile (String cmdFile, extraArgs)

将给定文件中的所有命令添加到调度程序

abstract void await ()

等待调度程序开始运行,包括等待从旧TF的切换完成(如果适用)。

abstract void completeHandover ()

通知命令调度程序已初始化的移交序列已完全完成,并且应在默认端口上重新初始化其远程管理器。

abstract void displayCommandQueue (PrintWriter printWriter)

输出有关命令执行队列状态的详细调试信息。

abstract void displayCommandsInfo (PrintWriter printWriter, String regex)

输出当前命令列表。

abstract void displayInvocationsInfo (PrintWriter printWriter)

显示当前调用的列表。

abstract void dumpCommandsXml (PrintWriter printWriter, String regex)

转储该命令的扩展xml文件,并为所有当前命令指定所有Option值。

abstract void execCommand (IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args)

使用已经存在的IInvocationContext直接分配设备并执行命令,而无需将其添加到命令队列中。

abstract void execCommand ( ICommandScheduler.IScheduledInvocationListener listener, String[] args)

直接分配设备并执行命令,而无需将其添加到命令队列中。

abstract void execCommand ( ICommandScheduler.IScheduledInvocationListener listener, ITestDevice device, String[] args)

在已分配的设备上直接执行命令。

abstract CommandFileWatcher getCommandFileWatcher ()

获取适合此调度程序的CommandFileWatcher

abstract int getExecutingCommandCount ()

返回处于执行状态的命令数。

abstract String getInvocationInfo (int invocationId)

返回有关调用bu的信息,指定调用ID。

abstract CommandRunner.ExitCode getLastInvocationExitCode ()

返回上一次运行的错误代码。

abstract Throwable getLastInvocationThrowable ()

从运行的最后一次调用返回Throwable

abstract int getReadyCommandCount ()

返回队列中处于就绪状态的命令数。

abstract void handoverInitiationComplete ()

通知命令调度程序已完成对使用中的设备和命令的初始切换交换,并且可以开始调度操作。

abstract boolean handoverShutdown (int handoverPort)

启动shutdown()并切换到同一主机上的另一个交易进程。

abstract void join ()

等待调度程序完成。

abstract void join (long millis)

在指定的持续时间(以毫秒为单位)之后等待调度程序完成或超时。

abstract void removeAllCommands ()

从调度程序中删除所有命令

abstract void setClearcutClient (ClearcutClient client)

设置客户端以报告线束数据

abstract void setLastInvocationExitCode ( CommandRunner.ExitCode code, Throwable stack)

CommandRunner上下文中运行时,Helper方法将设置退出错误代码和可返回的堆栈跟踪。

abstract boolean shouldShutdownOnCmdfileError ()

如果需要在命令错误时关闭调度程序,则返回true

abstract void shutdown ()

尝试正常关闭命令调度程序。

abstract void shutdownHard ()

尝试强制关闭命令调度程序。

abstract void shutdownOnEmpty ()

shutdown()相似,但是将在退出之前等待所有命令执行。

abstract void start ()

启动ICommandScheduler

abstract boolean stopInvocation (int invocationId, String cause)

通过指定其ID来停止正在运行的调用。

default boolean stopInvocation (int invocationId)

通过指定其ID来停止正在运行的调用。

abstract boolean stopInvocation ( ITestInvocation invocation)

停止正在运行的调用。

公开方法

addCommand

public abstract boolean addCommand (String[] args)

向调度程序添加命令。

命令本质上是要运行的配置及其关联参数的实例。

如果指定了“ --help”参数,则配置的帮助文本将输出到stdout。否则,配置将添加到队列中以运行。

参量
args String :配置参数。

退货
boolean 如果命令添加成功,则返回true

投掷
ConfigurationException 如果无法解析命令

addCommandFile

public abstract void addCommandFile (String cmdFile, 
                 extraArgs)

将给定文件中的所有命令添加到调度程序

参量
cmdFile String :comand文件的文件系统路径

extraArgs :一个String参数的ERROR(/List)附加到从文件解析的每个命令中。可以为空,但不能为null。

投掷
ConfigurationException 如果无法解析命令文件

也可以看看:

等待

public abstract void await ()

等待调度程序开始运行,包括等待从旧TF的切换完成(如果适用)。

completeHandover

public abstract void completeHandover ()

通知命令调度程序已初始化的移交序列已完全完成,并且应在默认端口上重新初始化其远程管理器。

displayCommandQueue

public abstract void displayCommandQueue (PrintWriter printWriter)

输出有关命令执行队列状态的详细调试信息。

displayCommandsInfo

public abstract void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

输出当前命令列表。

参量
printWriter PrintWriter :要输出到的ERROR(/PrintWriter)

regex String :命令应与之匹配以便打印的正则表达式。如果为null,则将打印所有命令。

displayInvocationsInfo

public abstract void displayInvocationsInfo (PrintWriter printWriter)

显示当前调用的列表。

参量
printWriter PrintWriter :要输出到的ERROR(/PrintWriter)

dumpCommandsXml

public abstract void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

转储该命令的扩展xml文件,并为所有当前命令指定所有Option值。

参量
printWriter PrintWriter :将状态输出到的ERROR(/PrintWriter)

regex String :命令应该与之匹配的正则表达式,以便转储xml文件。如果为null,则将转储所有命令。

execCommand

public abstract void execCommand (IInvocationContext context, 
                ICommandScheduler.IScheduledInvocationListener listener, 
                String[] args)

使用现有的IInvocationContext直接分配设备并执行命令,而无需将其添加到命令队列中。

参量
context IInvocationContext :现有的IInvocationContext

listener ICommandScheduler.IScheduledInvocationListener :要通知的ICommandScheduler.IScheduledInvocationListener

args String :命令参数

投掷
ConfigurationException 如果命令无效
NoDeviceException 如果没有要使用的设备

execCommand

public abstract void execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                String[] args)

直接分配设备并执行命令,而无需将其添加到命令队列中。

参量
listener ICommandScheduler.IScheduledInvocationListener :要通知的ICommandScheduler.IScheduledInvocationListener

args String :命令参数

投掷
ConfigurationException 如果命令无效
NoDeviceException 如果没有要使用的设备

execCommand

public abstract void execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                ITestDevice device, 
                String[] args)

在已分配的设备上直接执行命令。

参量
listener ICommandScheduler.IScheduledInvocationListener :要通知的ICommandScheduler.IScheduledInvocationListener

device ITestDevice :要使用的ITestDevice

args String :命令参数

投掷
ConfigurationException 如果命令无效

getCommandFileWatcher

public abstract CommandFileWatcher getCommandFileWatcher ()

获取适合此调度程序的CommandFileWatcher

退货
CommandFileWatcher

getExecutingCommandCount

public abstract int getExecutingCommandCount ()

返回处于执行状态的命令数。

退货
int

getInvocationInfo

public abstract String getInvocationInfo (int invocationId)

返回有关调用bu的信息,指定调用ID。

参量
invocationId int :调用的跟踪ID。

退货
String 一个String其中包含有关调用的信息。

getLastInvocationExitCode

public abstract CommandRunner.ExitCode getLastInvocationExitCode ()

返回上一次运行的错误代码。如果尚未运行调用,则返回0(无错误)。

退货
CommandRunner.ExitCode

getLastInvocationThrowable

public abstract Throwable getLastInvocationThrowable ()

从运行的最后一次调用返回Throwable 。如果没有throwable可用,则返回null。

退货
Throwable

getReadyCommandCount

public abstract int getReadyCommandCount ()

返回队列中处于就绪状态的命令数。

退货
int

handoverInitiationComplete

public abstract void handoverInitiationComplete ()

通知命令调度程序已完成对使用中的设备和命令的初始切换交换,并且可以开始调度操作。

关机

public abstract boolean handoverShutdown (int handoverPort)

启动shutdown()并切换到同一主机上的另一个交易进程。

调度程序将通知远程交易过程,在释放设备可用时在该端口上监听。

参量
handoverPort int

退货
boolean 如果切换启动成功,则为true ,否则为false

加入

public abstract void join ()

等待调度程序完成。

也可以看看:

加入

public abstract void join (long millis)

在指定的持续时间(以毫秒为单位)之后等待调度程序完成或超时。

参量
millis long

也可以看看:

removeAllCommands

public abstract void removeAllCommands ()

从调度程序中删除所有命令

setClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

设置客户端以报告线束数据

参量
client ClearcutClient

setLastInvocationExitCode

public abstract void setLastInvocationExitCode (CommandRunner.ExitCode code, 
                Throwable stack)

CommandRunner上下文中运行时,Helper方法将设置退出错误代码和可返回的堆栈跟踪。

参量
code CommandRunner.ExitCode

stack Throwable

shouldShutdownOnCmdfileError

public abstract boolean shouldShutdownOnCmdfileError ()

如果需要在命令错误时关闭调度程序,则返回true

退货
boolean

关掉

public abstract void shutdown ()

尝试正常关闭命令调度程序。

清除等待测试的命令,并请求正常关闭所有正在进行的调用。

调用shutdown之后,调度程序主循环将等待所有正在进行的调用完成,然后再完全退出。

关闭硬

public abstract void shutdownHard ()

尝试强制关闭命令调度程序。

shutdown()类似,但也会强制终止adb连接,以试图“激发”进行中的调用以更快地完成。

shutdownOnEmpty

public abstract void shutdownOnEmpty ()

shutdown()相似,但是将在退出之前等待所有命令执行。

请注意,如果有任何命令处于循环模式,则调度程序将永远不会退出。

开始

public abstract void start ()

启动ICommandScheduler

必须在调用其他方法之前调用。

将一直运行到调用shutdown()为止。参见Thread.start()

stopInvocation

public abstract boolean stopInvocation (int invocationId, 
                String cause)

通过指定其ID来停止正在运行的调用。

参量
invocationId int :调用的跟踪ID。

cause String :停止调用的原因。

退货
boolean 如果调用已停止,则为true,否则为false

投掷
UnsupportedOperationException 如果实现不支持此功能

stopInvocation

public boolean stopInvocation (int invocationId)

通过指定其ID来停止正在运行的调用。

参量
invocationId int

退货
boolean 如果调用已停止,则为true,否则为false

投掷
UnsupportedOperationException 如果实施不支持

stopInvocation

public abstract boolean stopInvocation (ITestInvocation invocation)

停止正在运行的调用。

参量
invocation ITestInvocation

退货
boolean 如果调用已停止,则为true,否则为false

投掷
UnsupportedOperationException 如果实现不支持此功能