InvocationExecution
public
class
InvocationExecution
extends Object
implements
IInvocationExecution
java.lang.Object | |
↳ | com.android.tradefed.invoker.InvocationExecution |
Es una clase que describe todos los pasos de invocación: descarga de compilación, preparación del destino, ejecución de pruebas y limpieza.
Se puede extender para anular el comportamiento predeterminado de algunos pasos. El orden de los pasos está determinado 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)
Ejecuta el paso de limpieza de build_provider. |
void
|
doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception)
Ejecuta el paso cleanUp de target_preparer y multi_target_preparer. |
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 de 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 |
void
|
runDevicePreInvocationSetup(IInvocationContext context, IConfiguration config, ITestLogger logger)
Invoca |
void
|
runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener)
Ejecuta la prueba. |
boolean
|
shardConfig(IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)
Intenta dividir la configuración en subconfiguraciones para que se vuelvan a programar para ejecutarse en varios recursos de forma simultánea. |
Métodos protegidos | |
---|---|
void
|
collectAutoInfo(IConfiguration config, TestInformation info)
Recopila automáticamente información sobre el dispositivo principal en prueba. |
IShardHelper
|
createShardHelper()
Crea un objeto |
void
|
customizeDevicePreInvocation(IConfiguration config, IInvocationContext context)
Permite personalizar parte del dispositivo antes de preInvocationSetup. |
String
|
getAdbVersion()
Muestra la versión de adb que se usa para la invocación. |
|
getLabPreparersToRun(IConfiguration config, String deviceName)
Recupera una lista de preparadores de labs para ejecutar 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,
|
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
JAVA_CLASSPATH_KEY
public static final String JAVA_CLASSPATH_KEY
JAVA_VERSION_KEY
public static final String JAVA_VERSION_KEY
Constructores públicos
InvocationExecution
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 compilaciones.
Parámetros | |
---|---|
context |
IInvocationContext : 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 cleanUp de target_preparer y multi_target_preparer. ¿Los dispositivos se limpian?
Parámetros | |
---|---|
context |
IInvocationContext : 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 ejecución de la prueba. |
doSetup
public void doSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener)
Ejecuta los pasos target_preparer y multi_target_preparer setUp. Realiza la configuración de todos los dispositivos necesarios para que se ejecute la prueba.
Parámetros | |
---|---|
testInfo |
TestInformation : 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 de target_preparer y multi_target_preparer. ¿Se desconectan los dispositivos asociados con la configuración?
Parámetros | |
---|---|
testInfo |
TestInformation : El TestInformation de la invocación. |
config |
IConfiguration : Es el IConfiguration de esta ejecución de prueba. |
logger |
ITestLogger : Es el ITestLogger para informar registros. |
exception |
Throwable : Es la excepción original que arroja la ejecución de la prueba. |
fetchBuild
public boolean fetchBuild (TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)
Ejecuta el paso build_provider de la invocación.
Parámetros | |
---|---|
testInfo |
TestInformation : El TestInformation de la invocación. |
config |
IConfiguration : Es el IConfiguration de esta ejecución de prueba. |
rescheduler |
IRescheduler : Es IRescheduler , para reprogramar partes de la invocación para su ejecución en otros recursos. |
listener |
ITestInvocationListener : El ITestInvocation para informar fallas de descarga de compilación. |
Muestra | |
---|---|
boolean |
Es verdadero si descargamos correctamente la compilación; de lo contrario, es falso. |
Arroja | |
---|---|
BuildRetrievalError |
|
DeviceNotAvailableException |
reportLogs
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 : Es el registrador de los registros. |
stage |
TestInvocation.Stage : Es la etapa de la invocación en la que nos encontramos. |
runDevicePostInvocationTearDown
public void runDevicePostInvocationTearDown (IInvocationContext context, IConfiguration config, Throwable exception)
Invoca ITestDevice.postInvocationTearDown(Throwable)
para cada parte del dispositivo de la invocación.
Parámetros | |
---|---|
context |
IInvocationContext : El IInvocationContext de la invocación. |
config |
IConfiguration : Es el IConfiguration de esta ejecución de prueba. |
exception |
Throwable : La excepción original que arroja la prueba en ejecución, si la hay. |
runDevicePreInvocationSetup
public void runDevicePreInvocationSetup (IInvocationContext context, IConfiguration config, ITestLogger logger)
Invoca 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 : Es el IConfiguration de esta ejecución de prueba. |
logger |
ITestLogger : Es el ITestLogger para informar registros. |
Arroja | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
runTests
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 |
shardConfig
public boolean shardConfig (IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)
Intenta dividir la configuración en subconfiguraciones para que se vuelvan a programar para ejecutarse en varios recursos de forma simultánea.
Si el recuento de fragmentos es mayor que 1, simplemente creará configuraciones para cada fragmento configurando los índices de fragmentos y reprogramándolos. Si no se establece un recuento de fragmentos,se usará IShardHelper.shardConfig
como resguardo.
Parámetros | |
---|---|
config |
IConfiguration : Es el IConfiguration actual. |
testInfo |
TestInformation : El TestInformation que contiene la información de las pruebas. |
rescheduler |
IRescheduler : El IRescheduler . |
logger |
ITestLogger : ITestLogger se usa para registrar el archivo durante la fragmentación. |
Muestra | |
---|---|
boolean |
Es verdadero si la prueba se fragmentó. De lo contrario, muestra false . |
Métodos protegidos
collectAutoInfo
protected void collectAutoInfo (IConfiguration config, TestInformation info)
Recopila automáticamente información sobre el dispositivo principal en prueba.
Parámetros | |
---|---|
config |
IConfiguration |
info |
TestInformation |
Arroja | |
---|---|
DeviceNotAvailableException |
createShardHelper
protected IShardHelper createShardHelper ()
Crea un objeto IShardHelper
que se usará.
Muestra | |
---|---|
IShardHelper |
customizeDevicePreInvocation
protected void customizeDevicePreInvocation (IConfiguration config, IInvocationContext context)
Permite 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 que se usa para la invocación.
Muestra | |
---|---|
String |
getLabPreparersToRun
protectedgetLabPreparersToRun (IConfiguration config, String deviceName)
Recupera una lista de preparadores de labs para ejecutar en este dispositivo.
Se anuló en las clases de zona de pruebas para restringir que los preparadores de labs se ejecuten dentro de la zona de pruebas secundaria.
Parámetros | |
---|---|
config |
IConfiguration |
deviceName |
String |
Muestra | |
---|---|
|
getTargetPreparersToRun
protectedgetTargetPreparersToRun (IConfiguration config, String deviceName)
Recupera una lista de preparadores de destino para ejecutar en este dispositivo.
Se anuló en las clases de zona de pruebas para restringir que los preparadores de labs se ejecuten dentro de la zona de pruebas secundaria.
Parámetros | |
---|---|
config |
IConfiguration |
deviceName |
String |
Muestra | |
---|---|
|
linkExternalDirs
protected void linkExternalDirs (IBuildInfo info, TestInformation testInfo)
Parámetros | |
---|---|
info |
IBuildInfo |
testInfo |
TestInformation |
logHostAdb
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 |