A partir del 27 de marzo de 2025, te recomendamos que uses android-latest-release en lugar de aosp-main para compilar y contribuir a AOSP. Para obtener más información, consulta Cambios en AOSP.

Se usó la API de Cloud Translation para traducir esta página.

TestInvocation

public class TestInvocation
extends Object implements ITestInvocation

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

Implementación predeterminada de ITestInvocation.

Carga objetos principales según IConfiguration - Recupera la compilación - Prepara el destino - Ejecuta pruebas - Informa los resultados

Resumen

Constantes
`long`	`AVAILABILITY_CHECK_TIMEOUT`

Campos
`public static final String`	`COMMAND_ARGS_KEY` Clave de los atributos de los argumentos de la línea de comandos
`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`

Constructores públicos
`TestInvocation()`

Métodos públicos
`static IBuildInfo`	`backFillBuildInfoForReporting(String commandLine)` Es un asistente que usa la línea de comandos para reabastecer un `IBuildInfo` para generar informes en caso de fallas de descarga.
`static FailureDescription`	`createFailureFromException(Throwable exception, TestRecordProto.FailureStatus defaultStatus)` Crea un `FailureDescription` a partir de una excepción de invocación.
`IInvocationExecution`	`createInvocationExec(TestInvocation.RunMode mode)` Crea la ruta de invocación que se debe seguir.
`static String`	`getDeviceLogName(TestInvocation.Stage stage)`
`static String`	`getEmulatorLogName(TestInvocation.Stage stage)`
`ITestInvocation.ExitInformation`	`getExitInfo()` La información de salida de la invocación determinada
`void`	`invoke(IInvocationContext context, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener... extraListeners)` Realiza la invocación de prueba.
`static boolean`	`isSubprocess(IConfiguration config)` Muestra verdadero si la invocación se encuentra actualmente dentro de un alcance de subproceso.
`void`	`notifyInvocationForceStopped(String message, ErrorIdentifier errorId)` Notificar al `TestInvocation` que se solicitó que TradeFed deje de funcionar
`void`	`notifyInvocationStopped(String message)` Notifica al `TestInvocation` que TradeFed se cerrará en algún momento.
`static void`	`printStageDelimiter(TestInvocation.Stage phase, boolean end)` Imprime un delimitador para una etapa determinada de la invocación.
`void`	`registerExecutionFiles(ExecutionFiles executionFiles)`
`void`	`setClearcutClient(ClearcutClient client)` Reenvía el cliente de Clearcut para informar las métricas.
`static boolean`	`shouldSkipBugreportError(Throwable t)` Método de ayuda que identifica errores cuando se debe omitir el informe de errores
`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)` Ayuda para establecer el código de salida.

Constantes

AVAILABILITY_CHECK_TIMEOUT

public static final long AVAILABILITY_CHECK_TIMEOUT

Valor constante: 180000 (0x000000000002bf20)

Campos

COMMAND_ARGS_KEY

public static final String COMMAND_ARGS_KEY

Clave de los atributos de los argumentos de la línea de comandos

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

Constructores públicos

TestInvocation

public TestInvocation ()

Métodos públicos

backFillBuildInfoForReporting

public static IBuildInfo backFillBuildInfoForReporting (String commandLine)

Es un asistente que usa la línea de comandos para reabastecer un IBuildInfo para generar informes en caso de fallas de descarga.

Parámetros
`commandLine`	`String`

Muestra
`IBuildInfo`

createFailureFromException

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

Crea un FailureDescription a partir de una excepción de invocación.

Parámetros
`exception`	`Throwable`: Es la excepción que se convertirá.
`defaultStatus`	`TestRecordProto.FailureStatus`: Es el estado que se usará de forma predeterminada si la excepción no es `IHarnessException`.

Muestra
`FailureDescription`

createInvocationExec

public IInvocationExecution createInvocationExec (TestInvocation.RunMode mode)

Crea la ruta de invocación que se debe seguir.

Parámetros
`mode`	`TestInvocation.RunMode`: Es el modo en el que nos encontramos actualmente.

Muestra
`IInvocationExecution`	El `IInvocationExecution` que describe la invocación.

getDeviceLogName

public static String getDeviceLogName (TestInvocation.Stage stage)

Parámetros
`stage`	`TestInvocation.Stage`

Muestra
`String`

getEmulatorLogName

public static String getEmulatorLogName (TestInvocation.Stage stage)

Parámetros
`stage`	`TestInvocation.Stage`

Muestra
`String`

getExitInfo

public ITestInvocation.ExitInformation getExitInfo ()

La información de salida de la invocación determinada

Muestra
`ITestInvocation.ExitInformation`

invocar

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

Realiza la invocación de prueba.

Parámetros
`context`	`IInvocationContext`: Es el `IInvocationContext` para realizar pruebas.
`config`	`IConfiguration`: Es el `IConfiguration` de esta ejecución de prueba.
`rescheduler`	`IRescheduler`: Es `IRescheduler`, para reprogramar partes de la invocación para su ejecución en otros recursos.
`extraListeners`	`ITestInvocationListener`: Son los `ITestInvocationListener` que se notificarán, además de los que se encuentran en `config`.

Arroja
`DeviceNotAvailableException`

isSubprocess

public static boolean isSubprocess (IConfiguration config)

Muestra verdadero si la invocación se encuentra actualmente dentro de un alcance de subproceso.

Parámetros
`config`	`IConfiguration`

Muestra
`boolean`

notifyInvocationForceStopped

public void notifyInvocationForceStopped (String message, 
                ErrorIdentifier errorId)

Notificar al TestInvocation que se solicitó que TradeFed deje de funcionar

Parámetros
`message`	`String`: Es el mensaje asociado con la detención de la invocación.
`errorId`	`ErrorIdentifier`: Es el identificador asociado con la detención forzada.

notifyInvocationStopped

public void notifyInvocationStopped (String message)

Notifica al TestInvocation que TradeFed se cerrará en algún momento.

Parámetros
`message`	`String`: Es el mensaje asociado con la detención de la invocación.

printStageDelimiter

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

Imprime un delimitador para una etapa determinada de la invocación.

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

registerExecutionFiles

public void registerExecutionFiles (ExecutionFiles executionFiles)

Parámetros
`executionFiles`	`ExecutionFiles`

setClearcutClient

public void setClearcutClient (ClearcutClient client)

Reenvía el cliente de Clearcut para informar las métricas.

Parámetros
`client`	`ClearcutClient`

shouldSkipBugreportError

public static boolean shouldSkipBugreportError (Throwable t)

Método de ayuda que identifica errores cuando se debe omitir el informe de errores

Parámetros
`t`	`Throwable`

Muestra
`boolean`

toString

public String toString ()

Muestra
`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)

Ayuda para establecer el código de salida. Se expone para pruebas.

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