A partir de 2026, para alinhar com nosso modelo de desenvolvimento estável de tronco e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, recomendamos usar android-latest-release em vez de aosp-main. O branch de manifesto android-latest-release sempre vai fazer referência à versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

TestInvocation

public class TestInvocation
extends Object implements ITestInvocation

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

Implementação padrão de ITestInvocation.

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

Resumo

Constantes
`long`	`AVAILABILITY_CHECK_TIMEOUT`
`String`	`COMMAND_ARGS_KEY` Chave dos atributos de argumentos da linha de comando
`String`	`INVOCATION_EXTERNAL_DEPENDENCIES`
`String`	`TRADEFED_CONFIG_NAME`
`String`	`TRADEFED_END_HOST_LOG`
`String`	`TRADEFED_INVOC_COMPLETE_HOST_LOG`
`String`	`TRADEFED_LOG_NAME`

Construtores públicos
`TestInvocation()`

Métodos públicos
`static IBuildInfo`	`backFillBuildInfoForReporting(String commandLine)` Auxiliar que usa a linha de comando para fazer o backfill de um `IBuildInfo` para relatórios em caso de falha no download.
`static FailureDescription`	`createFailureFromException(Throwable exception, TestRecordProto.FailureStatus defaultStatus)` Crie um `FailureDescription` 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 determinada invocação.
`void`	`invoke(IInvocationContext context, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener... extraListeners)` Realize a invocação de teste.
`static boolean`	`isSubprocess(IConfiguration config)` Retorna verdadeiro se a invocação estiver no momento dentro de um escopo de subprocesso.
`void`	`notifyInvocationForceStopped(String message, ErrorIdentifier errorId)` Notifique o `TestInvocation` de que o TradeFed foi solicitado a parar.
`void`	`notifyInvocationStopped(String message)` Notifique o `TestInvocation` de que o TradeFed será desligado.
`static void`	`printStageDelimiter(TestInvocation.Stage phase, boolean end)` Imprime um delimitador para uma determinada etapa da invocação.
`void`	`registerExecutionFiles(ExecutionFiles executionFiles)`
`void`	`setClearcutClient(ClearcutClient client)` Encaminhe o cliente clearcut para relatar métricas.
`static boolean`	`shouldSkipBugreportError(Throwable t)` Método auxiliar que identifica erros quando o relatório de bug 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)` Auxiliar para definir o código de saída.

Constantes

AVAILABILITY_CHECK_TIMEOUT

public static final long AVAILABILITY_CHECK_TIMEOUT

Valor da constante: 180000 (0x000000000002bf20)

COMMAND_ARGS_KEY

public static final String COMMAND_ARGS_KEY

Chave dos atributos de argumentos da linha de comando

Valor da constante: "command_line_args"

INVOCATION_EXTERNAL_DEPENDENCIES

public static final String INVOCATION_EXTERNAL_DEPENDENCIES

Valor da constante: "invocation-external-dependencies"

TRADEFED_CONFIG_NAME

public static final String TRADEFED_CONFIG_NAME

Valor da constante: "tradefed-expanded-config"

TRADEFED_END_HOST_LOG

public static final String TRADEFED_END_HOST_LOG

Valor da constante: "end_host_log"

TRADEFED_INVOC_COMPLETE_HOST_LOG

public static final String TRADEFED_INVOC_COMPLETE_HOST_LOG

Valor da constante: "invoc_complete_host_log"

TRADEFED_LOG_NAME

public static final String TRADEFED_LOG_NAME

Valor da constante: "host_log"

Construtores públicos

TestInvocation

public TestInvocation ()

Métodos públicos

backFillBuildInfoForReporting

public static IBuildInfo backFillBuildInfoForReporting (String commandLine)

Auxiliar que usa a linha de comando para fazer o backfill de 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 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 um `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 no momento.

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 determinada invocação.

Retorna
`ITestInvocation.ExitInformation`

invocar

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

Realize a invocação de teste.

Parâmetros
`context`	`IInvocationContext`: o `IInvocationContext` para realizar testes.
`config`	`IConfiguration`: o `IConfiguration` desta execução de teste.
`rescheduler`	`IRescheduler`: o `IRescheduler`, para reagendar partes da invocação para execução em outros recursos.
`extraListeners`	`ITestInvocationListener`: `ITestInvocationListener`s a serem notificados, além daqueles em `config`

Gera
`DeviceNotAvailableException`

isSubprocess

public static boolean isSubprocess (IConfiguration config)

Retorna verdadeiro se a invocação estiver no momento dentro de um escopo de subprocesso.

Parâmetros
`config`	`IConfiguration`

Retorna
`boolean`

notifyInvocationForceStopped

public void notifyInvocationForceStopped (String message, 
                ErrorIdentifier errorId)

Notifique o TestInvocation de que o TradeFed foi solicitado 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á desligado.

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

printStageDelimiter

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

Imprime um delimitador para uma determinada etapa 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)

Encaminhe o cliente clearcut para relatar métricas.

Parâmetros
`client`	`ClearcutClient`

shouldSkipBugreportError

public static boolean shouldSkipBugreportError (Throwable t)

Método auxiliar que identifica erros quando o relatório de bug 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)

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

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