Invocación Ejecución

public class InvocationExecution
extends Object implements IInvocationExecution

java.lang.Objeto
com.android.tradefed.invoker.InvocationExecution


Clase que describe todos los pasos de invocación: descarga de compilación, target_prep, ejecución de pruebas, limpieza. Se puede ampliar para anular el comportamiento predeterminado de algunos pasos. El orden de los pasos lo controla TestInvocation .

Resumen

Campos

public static final String ADB_VERSION_KEY

public static final String JAVA_CLASSPATH_KEY

public static final String JAVA_VERSION_KEY

Constructores públicos

InvocationExecution ()

Métodos públicos

void cleanUpBuilds ( IInvocationContext context, IConfiguration config)

Ejecute el paso de limpieza build_provider.

void doCleanUp ( IInvocationContext context, IConfiguration config, Throwable exception)

Ejecute el paso de limpieza de target_preparer y multi_target_preparer.

void doSetup ( TestInformation testInfo, IConfiguration config, ITestLogger listener)

Ejecute el paso de configuración target_preparer y multi_target_preparer.

void doTeardown ( TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)

Ejecute el paso de desmontaje de target_preparer y multi_target_preparer.

boolean fetchBuild ( TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)

Ejecute el paso build_provider de la invocación.

void reportLogs ( ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)

Informe algunos registros del dispositivo en diferentes etapas de la invocación.

void runDevicePostInvocationTearDown ( IInvocationContext context, IConfiguration config, Throwable exception)

Invoque ITestDevice#postInvocationTearDown(Throwable) para cada parte del dispositivo de la invocación.

void runDevicePreInvocationSetup ( IInvocationContext context, IConfiguration config, ITestLogger logger)

Invoque el ERROR(ITestDevice#preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice#preInvocationSetup(IBuildInfo)) para cada parte del dispositivo de la invocación.

void runTests ( TestInformation info, IConfiguration config, ITestInvocationListener listener)

Ejecuta la prueba.

boolean shardConfig ( IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)

Intente dividir la configuración en subconfiguraciones para reprogramarla para que se ejecute en varios recursos en paralelo.

Métodos protegidos

void collectAutoInfo ( IConfiguration config, TestInformation info)

Recopile automáticamente cierta información sobre el dispositivo principal bajo prueba.

IShardHelper createShardHelper ()

Cree una devolución del IShardHelper que se utilizará.

void customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context)

Dé la oportunidad de personalizar parte del dispositivo antes de la configuración previa a la invocación.

String getAdbVersion ()

Devuelve la versión de adb utilizada para la invocación.

getLabPreparersToRun ( IConfiguration config, String deviceName)

Obtenga una lista de preparadores de laboratorio para ejecutar en este dispositivo.

getTargetPreparersToRun ( IConfiguration config, String deviceName)

Obtenga una lista de preparadores de destino para ejecutar en este dispositivo.

void logHostAdb ( IConfiguration config, ITestLogger logger)

Recopile los registros de $TMPDIR/adb.$UID.log.

Throwable runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap) runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap) runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap)
void setTestTag ( IBuildInfo info, IConfiguration config)

Manejar la configuración de la etiqueta de prueba en la información de compilación.

Campos

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

JAVA_VERSION_KEY

public static final String JAVA_VERSION_KEY

Constructores públicos

Invocación Ejecución

public InvocationExecution ()

Métodos públicos

limpieza de construcciones

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Ejecute el paso de limpieza build_provider. Asociado con la búsqueda de compilación.

Parámetros
context IInvocationContext : el IInvocationContext de la invocación.

config IConfiguration : la IConfiguration de esta ejecución de prueba.

hacerlimpieza

public void doCleanUp (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

Ejecute el paso de limpieza de target_preparer y multi_target_preparer. ¿Se limpian los dispositivos?

Parámetros
context IInvocationContext : el IInvocationContext de la invocación.

config IConfiguration : la IConfiguration de esta ejecución de prueba.

exception Throwable : la excepción original lanzada por la prueba en ejecución.

hacerConfiguración

public void doSetup (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger listener)

Ejecute el paso de configuración target_preparer y multi_target_preparer. Realiza la configuración de todos los dispositivos necesarios para que se ejecute la prueba.

Parámetros
testInfo TestInformation : TestInformation de la invocación.

config IConfiguration : la IConfiguration de esta ejecución de prueba.

listener ITestLogger : ITestLogger para informar registros de fallas de configuración.

Lanza
BuildError
DeviceNotAvailableException
TargetSetupError

hacer desmontaje

public void doTeardown (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger, 
                Throwable exception)

Ejecute el paso de desmontaje de target_preparer y multi_target_preparer. ¿Se descomponen los dispositivos asociados con la configuración?

Parámetros
testInfo TestInformation : TestInformation de la invocación.

config IConfiguration : la IConfiguration de esta ejecución de prueba.

logger ITestLogger : ITestLogger para informar registros.

exception Throwable : la excepción original lanzada por la prueba en ejecución.

buscarConstruir

public boolean fetchBuild (TestInformation testInfo, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener listener)

Ejecute el paso build_provider de la invocación.

Parámetros
testInfo TestInformation : TestInformation de la invocación.

config IConfiguration : la IConfiguration de esta ejecución de prueba.

rescheduler IRescheduler : IRescheduler , para reprogramar partes de la invocación para su ejecución en otro(s) recurso(s)

listener ITestInvocationListener : ITestInvocation para informar errores de descarga de compilación.

Devoluciones
boolean Verdadero si descargamos correctamente la compilación; falso en caso contrario.

Lanza
BuildRetrievalError
DeviceNotAvailableException

informeRegistros

public void reportLogs (ITestDevice device, 
                ITestLogger listener, 
                TestInvocation.Stage stage)

Informe algunos registros del dispositivo en diferentes etapas de la invocación. Por ejemplo: logcat.

Parámetros
device ITestDevice : el dispositivo desde el que informar los registros.

listener ITestLogger : el registrador de los registros.

stage TestInvocation.Stage : La etapa de la invocación en la que nos encontramos.

runDevicePostInvocationTearDown

public void runDevicePostInvocationTearDown (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

Invoque ITestDevice#postInvocationTearDown(Throwable) para cada parte del dispositivo de la invocación.

Parámetros
context IInvocationContext : el IInvocationContext de la invocación.

config IConfiguration : la IConfiguration de esta ejecución de prueba.

exception Throwable : la excepción original lanzada por la prueba en ejecución, si corresponde.

ejecutarDevicePreInvocationSetup

public void runDevicePreInvocationSetup (IInvocationContext context, 
                IConfiguration config, 
                ITestLogger logger)

Invoque el ERROR(ITestDevice#preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice#preInvocationSetup(IBuildInfo)) para cada parte del dispositivo de la invocación.

Parámetros
context IInvocationContext : el IInvocationContext de la invocación.

config IConfiguration : la IConfiguration de esta ejecución de prueba.

logger ITestLogger : ITestLogger para informar registros.

Lanza
DeviceNotAvailableException
TargetSetupError

ejecutar pruebas

public void runTests (TestInformation info, 
                IConfiguration config, 
                ITestInvocationListener listener)

Ejecuta la prueba.

Parámetros
info TestInformation : TestInformation con el que ejecutar pruebas.

config IConfiguration : la IConfiguration a ejecutar

listener ITestInvocationListener : el ITestInvocationListener de los resultados de la prueba.

shardConfig

public boolean shardConfig (IConfiguration config, 
                TestInformation testInfo, 
                IRescheduler rescheduler, 
                ITestLogger logger)

Intente dividir la configuración en subconfiguraciones para reprogramarla para que se ejecute en varios recursos en paralelo.

Si el recuento de fragmentos es mayor que 1, simplemente creará configuraciones para cada fragmento estableciendo índices de fragmentos y reprogramándolos. Si no se establece un recuento de fragmentos, se recurrirá a IShardHelper#shardConfig .

Parámetros
config IConfiguration : la IConfiguration actual.

testInfo TestInformation : TestInformation que contiene la información de las pruebas.

rescheduler IRescheduler : el IRescheduler .

logger ITestLogger : ITestLogger se utiliza para registrar archivos durante la fragmentación.

Devoluciones
boolean Es cierto si la prueba estaba fragmentada. De lo contrario devolverá false

Métodos protegidos

recopilarAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

Recopile automáticamente cierta información sobre el dispositivo principal bajo prueba.

Parámetros
config IConfiguration

info TestInformation

Lanza
DeviceNotAvailableException

crearShardHelper

protected IShardHelper createShardHelper ()

Cree una devolución del IShardHelper que se utilizará.

Devoluciones
IShardHelper

personalizarDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Dé la oportunidad de personalizar parte del dispositivo antes de la configuración previa a la invocación.

Parámetros
config IConfiguration : la configuración de la invocación.

context IInvocationContext : el contexto de invocación actual.

getAdbVersion

protected String getAdbVersion ()

Devuelve la versión de adb utilizada para la invocación.

Devoluciones
String

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

Obtenga una lista de preparadores de laboratorio para ejecutar en este dispositivo.

Anulado en clases de sandbox para restringir la ejecución de los preparadores de laboratorio dentro del entorno sandbox secundario

Parámetros
config IConfiguration

deviceName String

Devoluciones

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

Obtenga una lista de preparadores de destino para ejecutar en este dispositivo.

Anulado en clases de sandbox para restringir la ejecución de los preparadores de laboratorio dentro del entorno sandbox secundario

Parámetros
config IConfiguration

deviceName String

Devoluciones

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

Recopile los registros de $TMPDIR/adb.$UID.log.

Parámetros
config IConfiguration

logger ITestLogger

ejecutarPreparadoresTearDown

protected Throwable runPreparersTearDown (TestInformation testInfo, 
                ITestDevice device, 
                String deviceName, 
                int deviceIndex, 
                ITestLogger logger, 
                Throwable exception, 
                 preparersToRun, 
                 trackPreparersMap)

Parámetros
testInfo TestInformation

device ITestDevice

deviceName String

deviceIndex int

logger ITestLogger

exception Throwable

preparersToRun

trackPreparersMap

Devoluciones
Throwable

estableceretiquetadeprueba

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

Manejar la configuración de la etiqueta de prueba en la información de compilación.

Parámetros
info IBuildInfo

config IConfiguration