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 |
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 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 |
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. |
getPreparersToRun ( IConfiguration config, String deviceName) Recupere una lista de preparadores para ejecutar en este dispositivo. | |
void | logHostAdb ( IConfiguration config, ITestLogger logger) Recopile los registros de $TMPDIR/adb.$UID.log. |
void | runPreparersSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener) |
Throwable | runPreparersTearDown (TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun) runPreparersTearDown (TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun) |
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)
Brinde 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 adb en uso para la invocación.
Devoluciones | |
---|---|
String |
getPreparersToRun
protectedgetPreparersToRun (IConfiguration config, String deviceName)
Recupere una lista de preparadores 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 |
ejecutarPreparersSetup
protected void runPreparersSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener)
Parámetros | |
---|---|
testInfo | TestInformation |
config | IConfiguration |
listener | ITestLogger |
Lanza | |
---|---|
BuildError | |
DeviceNotAvailableException | |
TargetSetupError |
RunPreparersTearDown
protected Throwable runPreparersTearDown (TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception,preparersToRun)
Parámetros | |
---|---|
testInfo | TestInformation |
device | ITestDevice |
deviceName | String |
deviceIndex | int |
logger | ITestLogger |
exception | Throwable |
preparersToRun |
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 |