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.

TestInvocation

public class TestInvocation
extends Object implements ITestInvocation

java.lang.Object
↳	com.android.tradefed.invoker.TestInvocation

Implementação padrão de ITestInvocation.

Carrega objetos principais com base em IConfiguration - recupera o build - prepara o destino - executa testes - informa os resultados

Resumo

Constantes
`long`	`AVAILABILITY_CHECK_TIMEOUT`

Campos
`public static final String`	`COMMAND_ARGS_KEY` Chave dos atributos de argumentos da linha de comando
`public static final String`	`INVOCATION_EXTERNAL_DEPENDENCIES`
`public static final String`	`TRADEFED_CONFIG_NAME`
`public static final String`	`TRADEFED_END_HOST_LOG`
`public static final String`	`TRADEFED_INVOC_COMPLETE_HOST_LOG`
`public static final String`	`TRADEFED_LOG_NAME`

Construtores públicos
`TestInvocation()`

Métodos públicos
`static IBuildInfo`	`backFillBuildInfoForReporting(String commandLine)` Assistente que usa a linha de comando para preencher um `IBuildInfo` para relatórios em caso de falha no download.
`static FailureDescription`	`createFailureFromException(Throwable exception, TestRecordProto.FailureStatus defaultStatus)` Crie um `FailureDescription` a partir de uma exceção de invocação.
`IInvocationExecution`	`createInvocationExec(TestInvocation.RunMode mode)` Crie o caminho de invocação que deve ser seguido.
`static String`	`getDeviceLogName(TestInvocation.Stage stage)`
`static String`	`getEmulatorLogName(TestInvocation.Stage stage)`
`ITestInvocation.ExitInformation`	`getExitInfo()` As informações de saída da invocação.
`void`	`invoke(IInvocationContext context, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener... extraListeners)` Realize a invocação do teste.
`static boolean`	`isSubprocess(IConfiguration config)` Retorna verdadeiro se a invocação estiver em um escopo de subprocesso.
`void`	`notifyInvocationForceStopped(String message, ErrorIdentifier errorId)` Notifique o `TestInvocation` de que a TradeFed foi solicitada a parar.
`void`	`notifyInvocationStopped(String message)` Notifique o `TestInvocation` de que o TradeFed será encerrado.
`static void`	`printStageDelimiter(TestInvocation.Stage phase, boolean end)` Mostra um delimitador para um determinado estágio da invocação.
`void`	`registerExecutionFiles(ExecutionFiles executionFiles)`
`void`	`setClearcutClient(ClearcutClient client)` Encaminhar o cliente clearcut para gerar relatórios de métricas.
`static boolean`	`shouldSkipBugreportError(Throwable t)` Método auxiliar que identifica erros quando o bugreport precisa ser ignorado
`String`	`toString()`

Métodos protegidos
`void`	`addInvocationMetric(InvocationMetricLogger.InvocationMetricKey key, String value)`
`void`	`addInvocationMetric(InvocationMetricLogger.InvocationMetricKey key, long value)`
`void`	`applyAutomatedReporters(IConfiguration config)`
`void`	`setExitCode(CommandRunner.ExitCode code, Throwable stack)` Ajudante para definir o código de saída.

Constantes

AVAILABILITY_CHECK_TIMEOUT

public static final long AVAILABILITY_CHECK_TIMEOUT

Valor da constante: 180000 (0x000000000002bf20)

Campos

COMMAND_ARGS_KEY

public static final String COMMAND_ARGS_KEY

Chave dos atributos de argumentos da linha de comando

INVOCATION_EXTERNAL_DEPENDENCIES

public static final String INVOCATION_EXTERNAL_DEPENDENCIES

TRADEFED_CONFIG_NAME

public static final String TRADEFED_CONFIG_NAME

TRADEFED_END_HOST_LOG

public static final String TRADEFED_END_HOST_LOG

TRADEFED_INVOC_COMPLETE_HOST_LOG

public static final String TRADEFED_INVOC_COMPLETE_HOST_LOG

TRADEFED_LOG_NAME

public static final String TRADEFED_LOG_NAME

Construtores públicos

TestInvocation

public TestInvocation ()

Métodos públicos

backFillBuildInfoForReporting

public static IBuildInfo backFillBuildInfoForReporting (String commandLine)

Assistente que usa a linha de comando para preencher um IBuildInfo para relatórios em caso de falha no download.

Parâmetros
`commandLine`	`String`

Retorna
`IBuildInfo`

createFailureFromException

public static FailureDescription createFailureFromException (Throwable exception, 
                TestRecordProto.FailureStatus defaultStatus)

Crie um FailureDescription a partir de uma exceção de invocação.

Parâmetros
`exception`	`Throwable`: a exceção a ser convertida
`defaultStatus`	`TestRecordProto.FailureStatus`: o status a ser usado por padrão se a exceção não for `IHarnessException`.

Retorna
`FailureDescription`

createInvocationExec

public IInvocationExecution createInvocationExec (TestInvocation.RunMode mode)

Crie o caminho de invocação que deve ser seguido.

Parâmetros
`mode`	`TestInvocation.RunMode`: o modo em que estamos executando.

Retorna
`IInvocationExecution`	O `IInvocationExecution` que descreve a invocação.

getDeviceLogName

public static String getDeviceLogName (TestInvocation.Stage stage)

Parâmetros
`stage`	`TestInvocation.Stage`

Retorna
`String`

getEmulatorLogName

public static String getEmulatorLogName (TestInvocation.Stage stage)

Parâmetros
`stage`	`TestInvocation.Stage`

Retorna
`String`

getExitInfo

public ITestInvocation.ExitInformation getExitInfo ()

As informações de saída da invocação.

Retorna
`ITestInvocation.ExitInformation`

invocar

public void invoke (IInvocationContext context, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener... extraListeners)

Realize a invocação do teste.

Parâmetros
`context`	`IInvocationContext`: o `IInvocationContext` para realizar testes.
`config`	`IConfiguration`: o `IConfiguration` desta execução de teste.
`rescheduler`	`IRescheduler`: o `IRescheduler`, para reprogramar partes da invocação para execução em outro recurso
`extraListeners`	`ITestInvocationListener`: `ITestInvocationListener`s a serem notificados, além dos que estão em `config`

Gera
`DeviceNotAvailableException`

isSubprocess

public static boolean isSubprocess (IConfiguration config)

Retorna verdadeiro se a invocação estiver em um escopo de subprocesso.

Parâmetros
`config`	`IConfiguration`

Retorna
`boolean`

notifyInvocationForceStopped

public void notifyInvocationForceStopped (String message, 
                ErrorIdentifier errorId)

Notifique o TestInvocation de que a TradeFed foi solicitada a parar.

Parâmetros
`message`	`String`: a mensagem associada à interrupção da invocação
`errorId`	`ErrorIdentifier`: identificador associado à interrupção forçada

notifyInvocationStopped

public void notifyInvocationStopped (String message)

Notifique o TestInvocation de que o TradeFed será encerrado.

Parâmetros
`message`	`String`: a mensagem associada à interrupção da invocação

printStageDelimiter

public static void printStageDelimiter (TestInvocation.Stage phase, 
                boolean end)

Mostra um delimitador para um determinado estágio da invocação.

Parâmetros
`phase`	`TestInvocation.Stage`
`end`	`boolean`

registerExecutionFiles

public void registerExecutionFiles (ExecutionFiles executionFiles)

Parâmetros
`executionFiles`	`ExecutionFiles`

setClearcutClient

public void setClearcutClient (ClearcutClient client)

Encaminhar o cliente clearcut para gerar relatórios de métricas.

Parâmetros
`client`	`ClearcutClient`

shouldSkipBugreportError

public static boolean shouldSkipBugreportError (Throwable t)

Método auxiliar que identifica erros quando o bugreport precisa ser ignorado

Parâmetros
`t`	`Throwable`

Retorna
`boolean`

toString

public String toString ()

Retorna
`String`

Métodos protegidos

addInvocationMetric

protected void addInvocationMetric (InvocationMetricLogger.InvocationMetricKey key, 
                String value)

Parâmetros
`key`	`InvocationMetricLogger.InvocationMetricKey`
`value`	`String`

addInvocationMetric

protected void addInvocationMetric (InvocationMetricLogger.InvocationMetricKey key, 
                long value)

Parâmetros
`key`	`InvocationMetricLogger.InvocationMetricKey`
`value`	`long`

applyAutomatedReporters

protected void applyAutomatedReporters (IConfiguration config)

Parâmetros
`config`	`IConfiguration`

setExitCode

protected void setExitCode (CommandRunner.ExitCode code, 
                Throwable stack)

Ajudante para definir o código de saída. Exposto para testes.

Parâmetros
`code`	`CommandRunner.ExitCode`
`stack`	`Throwable`