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 |
void | runDevicePreInvocationSetup ( IInvocationContext context, IConfiguration config, ITestLogger logger) Invoque el |
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 |
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
protectedgetLabPreparersToRun (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
protectedgetTargetPreparersToRun (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 |