A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.

Esta página foi traduzida pela API Cloud Translation.

CommandScheduler

public class CommandScheduler
extends Object implements ICommandScheduler

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

Subclasses diretas conhecidas

ClusterCommandScheduler

ClusterCommandScheduler Um ICommandScheduler para oferecer suporte ao TFC (Tradefed Cluster).

Um programador para executar comandos da TradeFederation em todos os dispositivos disponíveis.

Tenta priorizar os comandos a serem executados com base em uma contagem total do tempo de execução. Por exemplo, comandos de execução frequentes ou rápidos são priorizados em vez de comandos de execução longa.

É executada para sempre em segundo plano até a desativação.

Resumo

Construtores públicos
`CommandScheduler()` Cria um `CommandScheduler`.

Métodos públicos
`Pair<Boolean, Integer>`	`addCommand(String[] args)` Adiciona um comando ao programador.
`void`	`addCommandFile(String cmdFilePath, extraArgs)` Adiciona todos os comandos do arquivo especificado ao agendador
`void`	`await()` Aguarda a execução do programador, incluindo a espera pela conclusão da transferência da TF antiga, se aplicável.
`static TradefedDelegator`	`checkDelegation(String[] args)` Crie um delegante com base na linha de comando para saber se precisamos delegar a execução.
`static`	`createReleaseMap(IInvocationContext context, Throwable e)` Crie um mapa do estado dos dispositivos para que eles possam ser liberados adequadamente.
`ISandbox`	`createSandbox()` Crie um `ISandbox` que a invocação vai usar para executar.
`void`	`displayCommandQueue(PrintWriter printWriter)` Mostra informações detalhadas de depuração sobre o estado da fila de execução de comandos.
`void`	`displayCommandsInfo(PrintWriter printWriter, String regex)` Mostra uma lista dos comandos atuais.
`void`	`displayInvocationsInfo(PrintWriter printWriter)` Mostra uma lista das invocações atuais.
`void`	`dumpCommandsXml(PrintWriter printWriter, String regex)` Faça o despejo do arquivo XML expandido para o comando com todos os valores `Option` especificados para todos os comandos atuais.
`long`	`execCommand(ICommandScheduler.IScheduledInvocationListener listener, ITestDevice device, String[] args)` Executa o comando diretamente em um dispositivo já alocado.
`long`	`execCommand(ICommandScheduler.IScheduledInvocationListener listener, reservedDevices, String[] args)` Executar o comando diretamente em dispositivos já alocados.
`long`	`execCommand(IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args)` Aloca um dispositivo diretamente e executa um comando sem adicioná-lo à fila de comandos usando um `IInvocationContext` já existente.
`long`	`execCommand(ICommandScheduler.IScheduledInvocationListener listener, String[] args)` Aloca um dispositivo diretamente e executa um comando sem adicioná-lo à fila de comandos.
`CommandFileWatcher`	`getCommandFileWatcher()` Receber o CommandFileWatcher apropriado para esse programador
`int`	`getExecutingCommandCount()` Retorna o número de comandos no estado de execução.
`CommandScheduler.HostState`	`getHostState()`
`String`	`getInvocationInfo(int invocationId)` Retorna as informações de uma invocação ao especificar o ID da invocação.
`CommandRunner.ExitCode`	`getLastInvocationExitCode()` Retorna o código de erro da última invocação executada.
`Throwable`	`getLastInvocationThrowable()` Retorna o `Throwable` da última invocação executada.
`int`	`getReadyCommandCount()` Retorna o número de comandos no estado pronto na fila.
`long`	`getShutdownTimeout()`
`boolean`	`isDeviceInInvocationThread(ITestDevice device)` Retorna true se o dispositivo for usado por uma linha de execução de invocação ativa.
`boolean`	`isShuttingDown()`
`void`	`notifyFileChanged(File cmdFile, extraArgs)`
`void`	`removeAllCommands()` Remover todos os comandos do programador
`void`	`run()` O bloco de execução principal desta linha de execução.
`void`	`setClearcutClient(ClearcutClient client)` Configurar o cliente para informar dados do harness
`boolean`	`shouldShutdownOnCmdfileError()` Retorna verdadeiro se precisarmos encerrar o programador em um erro de comando
`void`	`shutdown(boolean notifyStop)` Tente encerrar o programador de comandos de forma suave.
`void`	`shutdownHard(boolean killAdb)` Tenta encerrar o programador de comandos à força.
`void`	`shutdownHard()` Tenta encerrar o programador de comandos à força.
`void`	`shutdownOnEmpty()` Semelhante a `shutdown()`, mas aguarda a execução de todos os comandos antes de sair.
`void`	`start()` Inicia o programador, incluindo a configuração de geração de registros, a inicialização de `DeviceManager` etc.
`boolean`	`stopInvocation(ITestInvocation invocation)` Interrompa uma invocação em execução.
`boolean`	`stopInvocation(int invocationId, String cause)` Para interromper uma invocação em execução, especifique o ID dela.
`void`	`stopScheduling()` Interrompe a programação e a aceitação de novos testes, mas não interrompe o Tradefed.

Métodos protegidos
`void`	`cleanUp()` Fecha os registros e faz qualquer outra limpeza necessária antes de sair.
`IConfiguration`	`createConfiguration(String[] args)`
`IInvocationContext`	`createInvocationContext()`
`void`	`dryRunCommandReporting(ICommandScheduler.IScheduledInvocationListener handler, IConfiguration config)` Determina se um determinado comando é um teste.
`long`	`execCommand(IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, reservedDevices, String[] args)`
`IConfigurationFactory`	`getConfigFactory()` Método de fábrica para receber uma referência ao `IConfigurationFactory`
`DeviceManagementGrpcServer`	`getDeviceManagementServer()`
`IDeviceManager`	`getDeviceManager()` Método de fábrica para receber uma referência ao `IDeviceManager`
`TradefedFeatureServer`	`getFeatureServer()`
`IHostOptions`	`getHostOptions()`
`IKeyStoreClient`	`getKeyStoreClient()` Busca um `IKeyStoreClient` usando o `IKeyStoreFactory` declarado em `IGlobalConfiguration` ou nulo, se nenhum for definido.
`TestInvocationManagementServer`	`getTestInvocationManagementServer()`
`void`	`initLogging()` Inicializa o registro da ddmlib.
`boolean`	`isShutdown()`
`void`	`processReadyCommands(IDeviceManager manager)`

Construtores públicos

CommandScheduler

public CommandScheduler ()

Cria um CommandScheduler.

Observação: a chamada start precisa ser feita antes do uso.

Métodos públicos

addCommand

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

Adiciona um comando ao programador.

Um comando é essencialmente uma instância de uma configuração a ser executada e os argumentos associados.

Se o argumento "--help" for especificado, o texto de ajuda da configuração será enviado para o stdout. Caso contrário, a configuração será adicionada à fila para execução.

Parâmetros
`args`	`String`: os argumentos de configuração.

Retorna
`Pair<Boolean, Integer>`	Um par de valores, o primeiro é um `true` booleano se o comando foi adicionado com sucesso. O segundo valor é o ID do rastreador de comando conhecido(valor não negativo) se o comando foi adicionado. Retorne 0 quando o comando for adicionado para todos os dispositivos. Caso contrário, retorne -1.

Gera
`ConfigurationException`

addCommandFile

public void addCommandFile (String cmdFilePath, 
                 extraArgs)

Adiciona todos os comandos do arquivo especificado ao agendador

Parâmetros
`cmdFilePath`	`String`: o caminho do sistema de arquivos do arquivo de comando
`extraArgs`	: um `ERROR(/List)` de argumentos `String` para anexar a cada comando analisado em arquivo. Pode estar vazio, mas não pode ser nulo.

Gera
`ConfigurationException`

await

public void await ()

Aguarda a execução do programador, incluindo a espera pela conclusão da transferência da TF antiga, se aplicável.

checkDelegation

public static TradefedDelegator checkDelegation (String[] args)

Crie um delegante com base na linha de comando para saber se precisamos delegar a execução.

Parâmetros
`args`	`String`

Retorna
`TradefedDelegator`

Gera
	com.android.tradefed.config.ConfigurationException
`ConfigurationException`

createReleaseMap

public static  createReleaseMap (IInvocationContext context, 
                Throwable e)

Crie um mapa do estado dos dispositivos para que eles possam ser liberados adequadamente.

Parâmetros
`context`	`IInvocationContext`
`e`	`Throwable`

Retorna

createSandbox

public ISandbox createSandbox ()

Crie um ISandbox que a invocação vai usar para executar.

Retorna
`ISandbox`

displayCommandQueue

public void displayCommandQueue (PrintWriter printWriter)

Mostra informações detalhadas de depuração sobre o estado da fila de execução de comandos.

displayCommandsInfo

public void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

Mostra uma lista dos comandos atuais.

Parâmetros
`printWriter`	`PrintWriter`: o `ERROR(/PrintWriter)` para saída.
`regex`	`String`: a expressão regular a que os comandos precisam ser correspondentes para serem impressos. Se for nulo, todos os comandos serão impressos.

displayInvocationsInfo

public void displayInvocationsInfo (PrintWriter printWriter)

Mostra uma lista das invocações atuais.

Parâmetros
`printWriter`	`PrintWriter`: o `ERROR(/PrintWriter)` para saída.

dumpCommandsXml

public void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

Faça o despejo do arquivo XML expandido para o comando com todos os valores Option especificados para todos os comandos atuais.

Parâmetros
`printWriter`	`PrintWriter`: o `ERROR(/PrintWriter)` para gerar o status.
`regex`	`String`: a expressão regular com que os comandos precisam ser correspondidos para que o arquivo XML seja descartado. Se for nulo, todos os comandos serão descartados.

execCommand

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

Executa o comando diretamente em um dispositivo já alocado.

Parâmetros
`listener`	`ICommandScheduler.IScheduledInvocationListener`: o `ICommandScheduler.IScheduledInvocationListener` a ser informado
`device`	`ITestDevice`: o `ITestDevice` a ser usado
`args`	`String`: os argumentos do comando

Retorna
`long`	O ID de invocação do comando programado.

Gera
`ConfigurationException`

execCommand

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

Executar o comando diretamente em dispositivos já alocados.

Parâmetros
`listener`	`ICommandScheduler.IScheduledInvocationListener`: o `ICommandScheduler.IScheduledInvocationListener` a ser informado
`reservedDevices`	: o `ERROR(/List)` a ser usado
`args`	`String`: os argumentos do comando

Retorna
`long`	O ID de invocação do comando programado.

Gera
`ConfigurationException`

execCommand

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

Aloca um dispositivo diretamente e executa um comando sem adicioná-lo à fila de comandos usando um IInvocationContext já existente.

Parâmetros
`context`	`IInvocationContext`: um `IInvocationContext` existente.
`listener`	`ICommandScheduler.IScheduledInvocationListener`: o `ICommandScheduler.IScheduledInvocationListener` a ser informado
`args`	`String`: os argumentos do comando

Retorna
`long`

Gera
`ConfigurationException`
`NoDeviceException`

execCommand

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

Aloca um dispositivo diretamente e executa um comando sem adicioná-lo à fila de comandos.

Parâmetros
`listener`	`ICommandScheduler.IScheduledInvocationListener`: o `ICommandScheduler.IScheduledInvocationListener` a ser informado
`args`	`String`: os argumentos do comando

Retorna
`long`	O ID de invocação do comando programado.

Gera
`ConfigurationException`
`NoDeviceException`

getCommandFileWatcher

public CommandFileWatcher getCommandFileWatcher ()

Receber o CommandFileWatcher apropriado para esse programador

Retorna
`CommandFileWatcher`

getExecutingCommandCount

public int getExecutingCommandCount ()

Retorna o número de comandos no estado de execução.

Retorna
`int`

getHostState

public CommandScheduler.HostState getHostState ()

Retorna
`CommandScheduler.HostState`

getInvocationInfo

public String getInvocationInfo (int invocationId)

Retorna as informações de uma invocação ao especificar o ID da invocação.

Parâmetros
`invocationId`	`int`: o ID de rastreamento da invocação.

Retorna
`String`	Um `String` que contém informações sobre a invocação.

getLastInvocationExitCode

public CommandRunner.ExitCode getLastInvocationExitCode ()

Retorna o código de erro da última invocação executada. Retorna 0 (sem erro) se nenhuma invocação tiver sido executada.

Retorna
`CommandRunner.ExitCode`

getLastInvocationThrowable

public Throwable getLastInvocationThrowable ()

Retorna o Throwable da última invocação executada. Retorna nulo se nenhum throwable estiver disponível.

Retorna
`Throwable`

getReadyCommandCount

public int getReadyCommandCount ()

Retorna o número de comandos no estado pronto na fila.

Retorna
`int`

getShutdownTimeout

public long getShutdownTimeout ()

Retorna
`long`

isDeviceInInvocationThread

public boolean isDeviceInInvocationThread (ITestDevice device)

Retorna true se o dispositivo for usado por uma linha de execução de invocação ativa.

Parâmetros
`device`	`ITestDevice`

Retorna
`boolean`

isShuttingDown

public boolean isShuttingDown ()

Retorna
`boolean`

notifyFileChanged

public void notifyFileChanged (File cmdFile, 
                 extraArgs)

Parâmetros
`cmdFile`	`File`
`extraArgs`

removeAllCommands

public void removeAllCommands ()

Remover todos os comandos do programador

run

public void run ()

O bloco de execução principal desta linha de execução.

setClearcutClient

public void setClearcutClient (ClearcutClient client)

Configurar o cliente para informar dados do harness

Parâmetros
`client`	`ClearcutClient`

shouldShutdownOnCmdfileError

public boolean shouldShutdownOnCmdfileError ()

Retorna verdadeiro se precisarmos encerrar o programador em um erro de comando

Retorna
`boolean`

encerramento

public void shutdown (boolean notifyStop)

Tente encerrar o programador de comandos de forma suave.

Parâmetros
`notifyStop`	`boolean`: se verdadeiro, notifica invocações de desligamento do TF.

shutdownHard

public void shutdownHard (boolean killAdb)

Tenta encerrar o programador de comandos à força.

Semelhante a shutdown(), mas também encerra a conexão adb, opcionalmente, em uma tentativa de "inspirar" as invocações em andamento para que sejam concluídas mais rapidamente.

Parâmetros
`killAdb`	`boolean`

shutdownHard

public void shutdownHard ()

Tenta encerrar o programador de comandos à força. O mesmo que shutdownHard(true).

shutdownOnEmpty

public void shutdownOnEmpty ()

Semelhante a shutdown(), mas aguarda a execução de todos os comandos antes de sair.

Se algum comando estiver no modo de loop, o programador nunca será encerrado.

start

public void start ()

Inicia o programador, incluindo a configuração de geração de registros, a inicialização de DeviceManager etc.

stopInvocation

public boolean stopInvocation (ITestInvocation invocation)

Interrompa uma invocação em execução.

Parâmetros
`invocation`	`ITestInvocation`

Retorna
`boolean`	Verdadeiro se a invocação foi interrompida. Caso contrário, é falso.

stopInvocation

public boolean stopInvocation (int invocationId, 
                String cause)

Para interromper uma invocação em execução, especifique o ID dela.

Parâmetros
`invocationId`	`int`: o ID de rastreamento da invocação.
`cause`	`String`: a causa da interrupção da invocação.

Retorna
`boolean`	Verdadeiro se a invocação foi interrompida. Caso contrário, é falso.

stopScheduling

public void stopScheduling ()

Interrompe a programação e a aceitação de novos testes, mas não interrompe o Tradefed. Isso permite uma desativação em duas etapas, em que primeiro drenamos todos os testes em execução e, em seguida, encerramos o processo Tradefed.

Métodos protegidos

cleanUp

protected void cleanUp ()

Fecha os registros e faz qualquer outra limpeza necessária antes de sair.

Exposição para que os testes de unidade possam simular.

createConfiguration

protected IConfiguration createConfiguration (String[] args)

Parâmetros
`args`	`String`

Retorna
`IConfiguration`

Gera
`ConfigurationException`

createInvocationContext

protected IInvocationContext createInvocationContext ()

Retorna
`IInvocationContext`

dryRunCommandReporting

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

Determina se um determinado comando é um teste. Se o comando for uma simulação, valide-o. Se houver algum problema de configuração, ele vai gerar uma ConfigurationException.

Parâmetros
`handler`	`ICommandScheduler.IScheduledInvocationListener`: `ERROR(/InvocationEventHandler)` para informar eventos para a validação de simulação.
`config`	`IConfiguration`

Retorna
`void`	Verdadeiro se o comando for um teste, falso caso contrário.

Gera
	com.android.tradefed.config.ConfigurationException
`ConfigurationException`

execCommand

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

Parâmetros
`context`	`IInvocationContext`
`listener`	`ICommandScheduler.IScheduledInvocationListener`
`reservedDevices`
`args`	`String`

Retorna
`long`

Gera
`ConfigurationException`

getConfigFactory

protected IConfigurationFactory getConfigFactory ()

Método de fábrica para receber uma referência ao IConfigurationFactory

Retorna
`IConfigurationFactory`	o `IConfigurationFactory` a ser usado

getDeviceManagementServer

protected DeviceManagementGrpcServer getDeviceManagementServer ()

Retorna
`DeviceManagementGrpcServer`

getDeviceManager

protected IDeviceManager getDeviceManager ()

Método de fábrica para receber uma referência ao IDeviceManager

Retorna
`IDeviceManager`	o `IDeviceManager` a ser usado

getFeatureServer

protected TradefedFeatureServer getFeatureServer ()

Retorna
`TradefedFeatureServer`

getHostOptions

protected IHostOptions getHostOptions ()

Retorna
`IHostOptions`

getKeyStoreClient

protected IKeyStoreClient getKeyStoreClient ()

Busca um IKeyStoreClient usando o IKeyStoreFactory declarado em IGlobalConfiguration ou nulo, se nenhum for definido.

Retorna
`IKeyStoreClient`	IKeyStoreClient

getTestInvocationManagementServer

protected TestInvocationManagementServer getTestInvocationManagementServer ()

Retorna
`TestInvocationManagementServer`

initLogging

protected void initLogging ()

Inicializa o registro da ddmlib.

Exposição para que os testes de unidade possam simular.

isShutdown

protected boolean isShutdown ()

Retorna
`boolean`

processReadyCommands

protected void processReadyCommands (IDeviceManager manager)

Parâmetros
`manager`	`IDeviceManager`