InvocaciónEjecución

public class InvocationExecution
extends Object implements IInvocationExecution

java.lang.Objeto
com.android.tradefed.invocador.InvocaciónEjecución


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 está controlado por 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 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 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 de dispositivos en diferentes etapas de la invocación.

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

Invoque ITestDevice#postInvocationTearDown(Throwable) para cada dispositivo que forma parte 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 dispositivo que forma parte 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 fragmentar la configuración en subconfiguraciones, para volver a programarlas para que se ejecuten 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)

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

String getAdbVersion ()

Devuelve la versión adb en uso para la invocación.

getLabPreparersToRun ( IConfiguration config, String deviceName)

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

getTargetPreparersToRun ( IConfiguration config, String deviceName)

Recupere 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ónEjecución

public InvocationExecution ()

Métodos públicos

limpiarconstrucciones

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Ejecute el paso de limpieza build_provider. Asociado con la obtención de compilación.

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

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

limpiar

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

Ejecute el paso de limpieza 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 ejecución de la prueba.

doSetup

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

Ejecute el paso de configuración target_preparer y multi_target_preparer. ¿Todos los dispositivos se configuran necesarios para que se ejecute la prueba?

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

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

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

Lanza
BuildError
DeviceNotAvailableException
TargetSetupError

desmontar

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

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

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

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

logger ITestLogger : el ITestLogger para informar registros.

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

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 : la TestInformation de la invocación.

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

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

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

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

Lanza
BuildRetrievalError
DeviceNotAvailableException

reportar registros

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

Informe algunos registros de dispositivos en diferentes etapas de la invocación. Por ejemplo: log cat.

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.

ejecutarDispositivoPostInvocaciónDesmontar

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

Invoque ITestDevice#postInvocationTearDown(Throwable) para cada dispositivo que forma parte 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.

ejecutarDispositivoPreInvocaciónConfiguración

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 dispositivo que forma parte 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 : el 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 para ejecutar pruebas.

config IConfiguration : la IConfiguration para ejecutar

listener ITestInvocationListener : el ITestInvocationListener de los resultados de la prueba

shardConfig

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

Intente fragmentar la configuración en subconfiguraciones, para volver a programarlas para que se ejecuten en varios recursos en paralelo.

Si un 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, recurriría 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 utilizado para registrar el archivo durante la fragmentación.

Devoluciones
boolean verdadero si la prueba fue fragmentada. De lo contrario devuelve 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

personalizarDispositivoPreInvocación

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Dé la oportunidad de personalizar algunos de los dispositivos 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 adb en uso para la invocación.

Devoluciones
String

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

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

Se anula en las clases de espacio aislado para restringir que los preparadores de laboratorio se ejecuten dentro del elemento secundario del espacio aislado

Parámetros
config IConfiguration

deviceName String

Devoluciones

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

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

Se anula en las clases de espacio aislado para restringir que los preparadores de laboratorio se ejecuten dentro del elemento secundario del espacio aislado

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

RunPreparersTearDown

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

establecer etiqueta de prueba

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