Ejecución de invocación

public class InvocationExecution
extends Object implements IInvocationExecution

Objeto java.lang.
   ↳ com.android.tradefed.Invoker.InvocationExecution


Es la clase que describe todos los pasos de invocación: build download, target_prep, ejecutar pruebas y limpiar. Se puede extender para anular el comportamiento predeterminado de algunos pasos. El orden de los pasos se determina según 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)

Ejecuta el paso de limpieza de build_provider.

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

Ejecuta el paso target_preparer y multi_target_preparer cleanUp.

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

Ejecuta los pasos target_preparer y multi_target_preparer setUp.

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

Ejecuta el paso de desmontaje target_preparer y multi_target_preparer.

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

Ejecuta el paso build_provider de la invocación.

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

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

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

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

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

Invoca el ERROR(ITestDevice#preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice#preInvocationSetup(IBuildInfo)) de 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)

Intento de fragmentar la configuración en subconfiguraciones, que se reprogramará para ejecutarse el varios recursos en paralelo.

Métodos protegidos

void collectAutoInfo(IConfiguration config, TestInformation info)

Recopila automáticamente información sobre el dispositivo principal que se está probando.

IShardHelper createShardHelper()

Crea una devolución que muestre el IShardHelper que se usará.

void customizeDevicePreInvocation(IConfiguration config, IInvocationContext context)

Da la oportunidad de personalizar parte del dispositivo antes de preInvocationSetup.

String getAdbVersion()

Muestra la versión de adb en uso para la invocación.

getLabPreparersToRun(IConfiguration config, String deviceName)

Recupera una lista de los preparadores de labs que se ejecutarán en este dispositivo.

getTargetPreparersToRun(IConfiguration config, String deviceName)

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

void linkExternalDirs(IBuildInfo info, TestInformation testInfo)
void logHostAdb(IConfiguration config, ITestLogger logger)

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

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

Controla 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

CLAVE_CLASE_DE_JAVA

public static final String JAVA_CLASSPATH_KEY

CLAVE_DE_LA_VERSIÓN_DE_JAVA

public static final String JAVA_VERSION_KEY

Constructores públicos

Ejecución de invocación

public InvocationExecution ()

Métodos públicos

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Ejecuta el paso de limpieza de build_provider. Se asocia con la recuperación de la compilación.

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

config IConfiguration: Es el IConfiguration de esta ejecución de prueba.

DoCleanUp

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

Ejecuta el paso target_preparer y multi_target_preparer cleanUp. ¿Los dispositivos están limpios? arriba.

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

config IConfiguration: Es el IConfiguration de esta ejecución de prueba.

exception Throwable: Es la excepción original que arroja la prueba en ejecución.

Configuración

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

Ejecuta los pasos target_preparer y multi_target_preparer setUp. ¿Se configuran todos los dispositivos? necesaria para que se ejecute la prueba.

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

config IConfiguration: Es el IConfiguration de esta ejecución de prueba.

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

Arroja
BuildError
DeviceNotAvailableException
TargetSetupError

DOTeardown

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

Ejecuta el paso de desmontaje target_preparer y multi_target_preparer. ¿Se rompen los dispositivos? asociado con la configuración.

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

config IConfiguration: Es el IConfiguration de esta ejecución de prueba.

logger ITestLogger: Es el ITestLogger para informar los registros.

exception Throwable: Es la excepción original que arroja la prueba en ejecución.

recuperarBuild

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

Ejecuta el paso build_provider de la invocación.

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

config IConfiguration: Es el IConfiguration de esta ejecución de prueba.

rescheduler IRescheduler: Es el IRescheduler, para la reprogramación de las partes de la invocación de ejecución en otros recursos

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

Muestra
boolean Es verdadero si descargamos correctamente la compilación. De lo contrario, es falso.

Arroja
BuildRetrievalError
DeviceNotAvailableException

Registros del informe

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

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

Parámetros
device ITestDevice: Es el dispositivo desde el que se informan los registros.

listener ITestLogger: El registrador de los registros

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

TearDown de runDevicePostInvocation

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

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

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

config IConfiguration: Es el IConfiguration de esta ejecución de prueba.

exception Throwable: Es la excepción original que arroja la prueba en ejecución, si corresponde.

RunDevicePreInvocationSetup

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

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

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

config IConfiguration: Es el IConfiguration de esta ejecución de prueba.

logger ITestLogger: Es el ITestLogger para informar los registros.

Arroja
DeviceNotAvailableException
TargetSetupError

Pruebas de ejecución

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

Ejecuta la prueba.

Parámetros
info TestInformation: Es el TestInformation con el que se ejecutarán las pruebas.

config IConfiguration: Es el IConfiguration que se ejecutará.

listener ITestInvocationListener: el ITestInvocationListener de los resultados de la prueba

SharConfig

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

Intento de fragmentar la configuración en subconfiguraciones, que se reprogramará para ejecutarse el varios recursos en paralelo.

Si el recuento de fragmentos es mayor que 1, simplemente creará archivos de configuración para cada fragmento establecer índices de fragmentos y reprogramarlos. Si no se establece un recuento de fragmentos,se recurrirá a IShardHelper#shardConfig

Parámetros
config IConfiguration: Es el IConfiguration actual.

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

rescheduler IRescheduler: Es el IRescheduler.

logger ITestLogger: Es el ITestLogger que se usa para registrar el archivo durante la fragmentación.

Muestra
boolean true si la prueba se fragmentó. De lo contrario, devuelve false

Métodos protegidos

recopilarAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

Recopila automáticamente información sobre el dispositivo principal que se está probando.

Parámetros
config IConfiguration

info TestInformation

Arroja
DeviceNotAvailableException

createShardHelper

protected IShardHelper createShardHelper ()

Crea una devolución que muestre el IShardHelper que se usará.

Muestra
IShardHelper

customDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Da la oportunidad de personalizar parte del dispositivo antes de preInvocationSetup.

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

context IInvocationContext: Es el contexto de invocación actual.

getAdbVersion

protected String getAdbVersion ()

Muestra la versión de adb en uso para la invocación.

Muestra
String

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

Recupera una lista de los preparadores de labs que se ejecutarán en este dispositivo.

Se anulan en las clases de la zona de pruebas para evitar que los preparadores del lab se ejecuten dentro de la zona de pruebas. hijo

Parámetros
config IConfiguration

deviceName String

Muestra

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

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

Se anulan en las clases de la zona de pruebas para evitar que los preparadores del lab se ejecuten dentro de la zona de pruebas. hijo

Parámetros
config IConfiguration

deviceName String

Muestra

dir.externas de vínculo

protected void linkExternalDirs (IBuildInfo info, 
                TestInformation testInfo)

Parámetros
info IBuildInfo

testInfo TestInformation

AdB de host de registro

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

Recopila 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

Muestra
Throwable

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

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

Parámetros
info IBuildInfo

config IConfiguration