CommandScheduler

public class CommandScheduler
extends Object implements ICommandScheduler

java.lang.Object 中
   ↳ com.android.tradefed.command.CommandScheduler


在所有可用设备上运行 TradeFederation 命令的调度器。

将尝试根据命令的总执行次数来确定要运行的命令的优先级 。例如不频繁或快速运行的命令将优先于长时间运行的命令。

会在后台永久运行,直到关机。

摘要

公共构造函数

CommandScheduler()

创建 CommandScheduler

公共方法

Pair<Boolean, Integer> addCommand(String[] args)

向调度器添加命令。

void addCommandFile(String cmdFilePath, extraArgs)

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

void await()

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

static TradefedDelegator checkDelegation(String[] args)

根据命令行创建一个委托程序,以查看我们是否需要将该运行委托给他人。

static createReleaseMap(IInvocationContext context, Throwable e)

创建设备状态映射,以便适当地发布设备。

ISandbox createSandbox()

创建调用将用于运行的 ISandbox

void displayCommandQueue(PrintWriter printWriter)

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

void displayCommandsInfo(PrintWriter printWriter, String regex)

输出当前命令的列表。

void displayInvocationsInfo(PrintWriter printWriter)

显示当前调用的列表。

void dumpCommandsXml(PrintWriter printWriter, String regex)

转储命令的展开后 xml 文件,其中包含 为所有当前命令指定了 Option 值。

long execCommand(ICommandScheduler.IScheduledInvocationListener listener, reservedDevices, String[] args)

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

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

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

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

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

CommandFileWatcher getCommandFileWatcher()

为此调度器获取适当的 CommandFileWatcher

int getExecutingCommandCount()

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

CommandScheduler.HostState getHostState()
String getInvocationInfo(int invocationId)

返回指定调用 ID 的调用相关信息。

CommandRunner.ExitCode getLastInvocationExitCode()

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

Throwable getLastInvocationThrowable()

返回上次运行的调用中的 Throwable

int getReadyCommandCount()

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

long getShutdownTimeout()
boolean isDeviceInInvocationThread(ITestDevice device)

如果设备由处于活动状态的调用线程使用,则返回 true。

boolean isShuttingDown()
void notifyFileChanged(File cmdFile, extraArgs)
void removeAllCommands()

从调度器中移除所有命令

void run()

此线程的主执行块。

void setClearcutClient(ClearcutClient client)

将客户端设置为报告自动化测试框架数据

boolean shouldShutdownOnCmdfileError()

如果由于命令错误而需要关闭调度器,则返回 true

void shutdown(boolean notifyStop)

尝试正常关闭命令调度器。

void shutdownHard(boolean killAdb)

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

void shutdownHard()

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

void shutdownOnEmpty()

shutdown() 类似,但会等待所有命令都执行完毕 然后下车。

void start()

启动调度器,包括日志记录设置、DeviceManager 初始化等

boolean stopInvocation(ITestInvocation invocation)

停止正在运行的调用。

boolean stopInvocation(int invocationId, String cause)

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

void stopScheduling()

停止调度并接受新测试,但不会停止 Tradefed。

受保护的方法

void cleanUp()

在我们退出之前,关闭日志并进行任何其他必要的清理。

IConfiguration createConfiguration(String[] args)
IInvocationContext createInvocationContext()
void dryRunCommandReporting(ICommandScheduler.IScheduledInvocationListener handler, IConfiguration config)

确定给定命令是否为试运行。

long execCommand(IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, reservedDevices, String[] args)
IConfigurationFactory getConfigFactory()

用于获取对 IConfigurationFactory 的引用的工厂方法

DeviceManagementGrpcServer getDeviceManagementServer()
IDeviceManager getDeviceManager()

用于获取对 IDeviceManager 的引用的工厂方法

TradefedFeatureServer getFeatureServer()
IHostOptions getHostOptions()
IKeyStoreClient getKeyStoreClient()

使用 IGlobalConfiguration 中声明的 IKeyStoreFactory 提取 IKeyStoreClient;如果未定义,则提取 null。

TestInvocationManagementServer getTestInvocationManagementServer()
void initLogging()

初始化 ddmlib 日志。

boolean isShutdown()
void processReadyCommands(IDeviceManager manager)

公共构造函数

CommandScheduler

public CommandScheduler ()

创建 CommandScheduler

注意:必须在使用前调用 start。

公共方法

addCommand

public Pair<Boolean, Integer> addCommand (String[] args)

向调度器添加命令。

命令本质上是要运行的配置的实例,以及 参数。

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

参数
args String:配置参数。

返回
Pair<Boolean, Integer> 一对值,如果添加了命令,则第一个值是布尔值 true 成功。如果 命令已成功添加,当为所有设备添加命令时返回 0,否则返回 0 -1。

抛出
ConfigurationException

addCommandFile

public void addCommandFile (String cmdFilePath, 
                 extraArgs)

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

参数
cmdFilePath String:命令文件的文件系统路径

extraArgs :要附加到解析的每个命令的 ERROR(/List)(包含 String 个参数) 来自文件。可以为空,但不得为 null。

抛出
ConfigurationException

等待

public void await ()

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

checkDelegation

public static TradefedDelegator checkDelegation (String[] args)

根据命令行创建一个委托程序,以查看我们是否需要将该运行委托给他人。

参数
args String

返回
TradefedDelegator

抛出
com.android.tradefed.config.ConfigurationException
ConfigurationException

createReleaseMap

public static  createReleaseMap (IInvocationContext context, 
                Throwable e)

创建设备状态映射,以便适当地发布设备。

参数
context IInvocationContext

e Throwable

返回

createSandbox

public ISandbox createSandbox ()

创建调用将用于运行的 ISandbox

返回
ISandbox

displayCommandQueue

public void displayCommandQueue (PrintWriter printWriter)

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

displayCommandsInfo

public void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

输出当前命令的列表。

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

regex String:要与命令匹配的正则表达式, 。如果为 null,将输出所有命令。

displayInvocationsInfo

public void displayInvocationsInfo (PrintWriter printWriter)

显示当前调用的列表。

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

dumpCommandsXml

public void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

转储命令的展开后 xml 文件,其中包含 为所有当前命令指定了 Option 值。

参数
printWriter PrintWriter:要向其中输出状态的 ERROR(/PrintWriter)

regex String:为了让 xml 文件。如果为 null,将转储所有命令。

execCommand

public long execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                 reservedDevices, 
                String[] args)

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

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

reservedDevices :要使用的 ERROR(/List)

args String:命令参数

返回
long 已安排的命令的调用 ID。

抛出
ConfigurationException

execCommand

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

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

参数
context IInvocationContext:现有的 IInvocationContext

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

args String:命令参数

返回
long

抛出
ConfigurationException
NoDeviceException

execCommand

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

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

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

args String:命令参数

返回
long 已安排的命令的调用 ID。

抛出
ConfigurationException
NoDeviceException

getCommandFileWatcher

public CommandFileWatcher getCommandFileWatcher ()

为此调度器获取适当的 CommandFileWatcher

返回
CommandFileWatcher

getExecutingCommandCount

public int getExecutingCommandCount ()

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

返回
int

getHostState

public CommandScheduler.HostState getHostState ()

返回
CommandScheduler.HostState

getInvocationInfo

public String getInvocationInfo (int invocationId)

返回指定调用 ID 的调用相关信息。

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

返回
String 包含调用相关信息的 String

getLastInvocationExitCode

public CommandRunner.ExitCode getLastInvocationExitCode ()

返回上次运行的调用的错误代码。 如果还没有运行任何调用,则返回 0(无错误)。

返回
CommandRunner.ExitCode

getLastInvocationThrowable

public Throwable getLastInvocationThrowable ()

返回上次运行的调用中的 Throwable。 如果没有可抛出对象,则返回 null。

返回
Throwable

getReadyCommandCount

public int getReadyCommandCount ()

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

返回
int

getShutdownTimeout

public long getShutdownTimeout ()

返回
long

isDeviceInvocationThread

public boolean isDeviceInInvocationThread (ITestDevice device)

如果设备由处于活动状态的调用线程使用,则返回 true。

参数
device ITestDevice

返回
boolean

正在关闭

public boolean isShuttingDown ()

返回
boolean

通知文件已更改

public void notifyFileChanged (File cmdFile, 
                 extraArgs)

参数
cmdFile File

extraArgs

removeAllCommands

public void removeAllCommands ()

从调度器中移除所有命令

得分

public void run ()

此线程的主执行块。

setClearcutClient

public void setClearcutClient (ClearcutClient client)

将客户端设置为报告自动化测试框架数据

参数
client ClearcutClient

shouldShutdownOnCmdfileError

public boolean shouldShutdownOnCmdfileError ()

如果由于命令错误而需要关闭调度器,则返回 true

返回
boolean

关停

public void shutdown (boolean notifyStop)

尝试正常关闭命令调度器。

参数
notifyStop boolean:如果为 true,则通知调用 TF 关停。

closeHard

public void shutdownHard (boolean killAdb)

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

shutdown() 类似,但也可以选择性地终止 adb 连接, 试图“启发”更快地完成。

参数
killAdb boolean

closeHard

public void shutdownHard ()

尝试强制关闭命令调度程序。与 closeHard(true) 相同。

关闭在空白处

public void shutdownOnEmpty ()

shutdown() 类似,但会等待所有命令都执行完毕 然后下车。

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

start

public void start ()

启动调度器,包括日志记录设置、DeviceManager 初始化等

stopInvocation

public boolean stopInvocation (ITestInvocation invocation)

停止正在运行的调用。

参数
invocation ITestInvocation

返回
boolean 如果调用已停止,则为 true,否则为 false

stopInvocation

public boolean stopInvocation (int invocationId, 
                String cause)

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

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

cause String:停止调用的原因。

返回
boolean 如果调用已停止,则为 true,否则为 false

stopScheduling

public void stopScheduling ()

停止调度并接受新测试,但不会停止 Tradefed。这是为了让 两步关闭,首先排空所有正在运行的测试,然后终止 Tradefed 过程。

受保护的方法

清理

protected void cleanUp ()

在我们退出之前,关闭日志并进行任何其他必要的清理。

公开,以便单元测试可以模拟。

createConfiguration

protected IConfiguration createConfiguration (String[] args)

参数
args String

返回
IConfiguration

抛出
ConfigurationException

createInvocationContext

protected IInvocationContext createInvocationContext ()

返回
IInvocationContext

deckRunCommandReporting

protected void dryRunCommandReporting (ICommandScheduler.IScheduledInvocationListener handler, 
                IConfiguration config)

确定给定命令是否为试运行。如果命令是试运行,请对其进行验证。如果 有任何配置问题,则会抛出 ConfigurationException。

参数
handler ICommandScheduler.IScheduledInvocationListenerERROR(/InvocationEventHandler),用于报告事件以进行试运行验证。

config IConfiguration

返回
void 如果命令为试运行,则为 true,否则为 false。

抛出
com.android.tradefed.config.ConfigurationException
ConfigurationException

execCommand

protected long execCommand (IInvocationContext context, 
                ICommandScheduler.IScheduledInvocationListener listener, 
                 reservedDevices, 
                String[] args)

参数
context IInvocationContext

listener ICommandScheduler.IScheduledInvocationListener

reservedDevices

args String

返回
long

抛出
ConfigurationException

getConfigFactory

protected IConfigurationFactory getConfigFactory ()

用于获取对 IConfigurationFactory 的引用的工厂方法

返回
IConfigurationFactory 要使用的 IConfigurationFactory

getDeviceManagementServer

protected DeviceManagementGrpcServer getDeviceManagementServer ()

返回
DeviceManagementGrpcServer

getDeviceManager

protected IDeviceManager getDeviceManager ()

用于获取对 IDeviceManager 的引用的工厂方法

返回
IDeviceManager 要使用的 IDeviceManager

getFeatureServer

protected TradefedFeatureServer getFeatureServer ()

返回
TradefedFeatureServer

getHostOptions

protected IHostOptions getHostOptions ()

返回
IHostOptions

getKeyStoreClient

protected IKeyStoreClient getKeyStoreClient ()

使用 IGlobalConfiguration 中声明的 IKeyStoreFactory 提取 IKeyStoreClient;如果未定义,则提取 null。

返回
IKeyStoreClient IKeyStoreClient

getTestInvocationManagementServer

protected TestInvocationManagementServer getTestInvocationManagementServer ()

返回
TestInvocationManagementServer

初始化日志记录

protected void initLogging ()

初始化 ddmlib 日志。

公开,以便单元测试可以模拟。

isShutdown

protected boolean isShutdown ()

返回
boolean

processReadyCommands

protected void processReadyCommands (IDeviceManager manager)

参数
manager IDeviceManager