Prueba de instrumentación

public class InstrumentationTest
extends Object implements IAbiReceiver, IConfigurationReceiver, IDeviceTest, IMetricCollectorReceiver, IRemoteTest, ITestCollector

Objeto java.lang.
↳	com.android.tradefed.testtype.InstrumentationTest

Subclases directas conocidas AndroidJUnitTest y CodeCoverageTest AndroidJUnitTest. Es una prueba que ejecuta un paquete de prueba de instrumentación en un dispositivo determinado a través del Se puede usar android.support.test.runner.AndroidJUnitRunner.  CodeCoverageTest Es una prueba que ejecuta un paquete de prueba de instrumentación en un dispositivo determinado. genera el informe de cobertura de código.

---

Es una prueba que ejecuta un paquete de prueba de instrumentación en un dispositivo determinado.

Resumen

Campos
public static final String	RUN_TESTS_AS_USER_KEY
public static final String	RUN_TESTS_ON_SDK_SANDBOX
protected boolean	mDebug
protected boolean	mInstrumentSdkInSandbox
protected boolean	mInstrumentSdkSandbox

Constructores públicos
InstrumentationTest()

Métodos públicos
void	addDeviceListeners( extraListeners) Permite agregar más objetos de escucha personalizados al ejecutor
void	addInstrumentationArg(String key, String value) Agrega un argumento para proporcionar cuando ejecutes las pruebas de instrumentación.
IAbi	getAbi()
IConfiguration	getConfiguration() Obtiene el IConfiguration para esta prueba.
String	getCoverageTarget() Obtén el coverTarget establecido anteriormente mediante setCoverageTarget(String).
boolean	getDebug() Obtén la configuración de depuración de la instrumentación.
ITestDevice	getDevice() Pon el dispositivo a prueba.
String	getForceAbi()
long	getMaxTimeout() Muestra el tiempo de espera máximo establecido para la instrumentación.
String	getPackageName() Obtén el paquete de manifiesto de Android para ejecutarlo.
String	getRunName() Obtén el nombre de ejecución de prueba personalizado que se proporcionará al objeto de escucha
String	getRunnerName() Obtiene el ejecutor de instrumentación de Android que se usará.
boolean	isOrchestrator() Muestra el valor de ERROR(InstrumentationTest#mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest#mOrchestrator).
void	run(TestInformation testInfo, ITestInvocationListener listener) Ejecuta las pruebas y, luego, informa los resultados al objeto de escucha.
void	setAbi(IAbi abi)
void	setClassName(String testClassName) De manera opcional, establece el nombre de la clase de prueba que se ejecutará.
void	setCollectTestsOnly(boolean shouldCollectTest) Habilita o inhabilita el modo de recopilación de pruebas
void	setCollectsTestsShellTimeout(int timeout) Este método dejó de estar disponible. Este método es una no-op
void	setConfiguration(IConfiguration config) Inserta el IConfiguration en uso.
void	setCoverageTarget(String coverageTarget) Establece el objetivo de cobertura de esta prueba.
void	setDebug(boolean debug) Establece la configuración de depuración de instrumentación.
void	setDevice(ITestDevice device) Inyecta el dispositivo a prueba.
void	setEnforceFormat(boolean enforce) Establece el valor True si aplicamos el formato de salida AJUR de instrumentación.
void	setForceAbi(String abi) Establece la opción force-abi.
void	setInstallFile(File installFile) Configura el archivo opcional de instalación que contiene las pruebas.
void	setIsolatedStorage(boolean isolatedStorage) Establece cuándo usar o no el almacenamiento aislado.
void	setMethodName(String testMethodName) De manera opcional, establece el método de prueba que se ejecutará.
void	setMetricCollectors( collectors) Establece la lista de elementos IMetricCollector definidos para la ejecución de prueba.
void	setOrchestrator(boolean useOrchestrator) Establece la opción --orchestrator
void	setPackageName(String packageName) Configura el paquete de manifiesto de Android que se ejecutará.
void	setReRunUsingTestFile(boolean reRunUsingTestFile) Establece la opción --rerun-from-file.
void	setRerunMode(boolean rerun) De manera opcional, configura el modo de repetición.
void	setRunName(String runName) Establece el nombre de ejecución de prueba personalizado que se proporcionará al objeto de escucha
void	setRunnerName(String runnerName) De manera opcional, configura el ejecutor de instrumentación de Android que se usará.
void	setShellTimeout(long timeout) De manera opcional, establece el tiempo máximo (en milisegundos) que se espera como resultado del shell del dispositivo.
void	setTestFilePathOnDevice(String testFilePathOnDevice) De manera opcional, establece la ruta de acceso a un archivo ubicado en el dispositivo que debe contener una lista de líneas métodos y clases de prueba separados (formato: com.foo.Class#method) para ejecutar.
void	setTestPackageName(String testPackageName) Establece el filtro del paquete de prueba.
void	setTestSize(String size) De manera opcional, configura el tamaño de la prueba que se ejecutará.
void	setTestTimeout(long timeout) De manera opcional, establece el tiempo máximo (en milisegundos) para cada ejecución de prueba individual.
void	setTestsToRun( tests) Establece la colección de pruebas que debe ejecutar InstrumentationTest.
void	setWindowAnimation(boolean windowAnimation)

Métodos protegidos
static	excludeNonExecuted(TestRunResult results) Filtrar por "NOT_EXECUTED" y se omite para hacer un seguimiento de lo que debe volver a ejecutarse.
String	getClassName() Obtén el nombre de la clase para ejecutar.
ListInstrumentationParser	getListInstrumentationParser() Obtén el ListInstrumentationParser que se usa para analizar "pm list instrumentation" para tus consultas.
String	getMethodName() Obtén el método de prueba para ejecutar.
String	getTestPackageName() Obtén el paquete de prueba de Java para ejecutarlo.
String	queryRunnerName() Consulta el dispositivo para obtener un ejecutor de pruebas que pueda usar.
void	setRunnerArgs(IRemoteAndroidTestRunner runner)

Campos

EJECUTAR_PRUEBAS_AS_CLAVE_DE_USUARIO

public static final String RUN_TESTS_AS_USER_KEY

RUN_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

mDebug

protected boolean mDebug

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

Constructores públicos

Prueba de instrumentación

public InstrumentationTest ()

Métodos públicos

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Permite agregar más objetos de escucha personalizados al ejecutor

Parámetros
extraListeners

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

Agrega un argumento para proporcionar cuando ejecutes las pruebas de instrumentación.

Parámetros
key	String: Es el nombre del argumento.
value	String: Es el valor del argumento.

GetAbi

public IAbi getAbi ()

Muestra
IAbi

getConfiguration

public IConfiguration getConfiguration ()

Obtiene el IConfiguration para esta prueba.

Muestra
IConfiguration

getCoverageTarget

public String getCoverageTarget ()

Obtén el coverTarget establecido anteriormente mediante setCoverageTarget(String).

Muestra
String

getDebug

public boolean getDebug ()

Obtén la configuración de depuración de la instrumentación.

Muestra
boolean	La configuración booleana de depuración.

getDevice

public ITestDevice getDevice ()

Pon el dispositivo a prueba.

Muestra
ITestDevice	ITestDevice

getForceAbi

public String getForceAbi ()

Muestra
String

getMaxTimeout

public long getMaxTimeout ()

Muestra el tiempo de espera máximo establecido para la instrumentación.

Muestra
long

getPackageName

public String getPackageName ()

Obtén el paquete de manifiesto de Android para ejecutarlo.

Muestra
String

getRunName

public String getRunName ()

Obtén el nombre de ejecución de prueba personalizado que se proporcionará al objeto de escucha

Muestra
String

nombregetRunner

public String getRunnerName ()

Obtiene el ejecutor de instrumentación de Android que se usará.

Muestra
String

Orquestador

public boolean isOrchestrator ()

Muestra el valor de ERROR(InstrumentationTest#mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest#mOrchestrator).

Muestra
boolean

run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Ejecuta las pruebas y, luego, informa los resultados al objeto de escucha.

Parámetros
testInfo	TestInformation: Es el objeto TestInformation que contiene información útil para ejecutar. y pruebas.
listener	ITestInvocationListener: el ITestInvocationListener de los resultados de la prueba

Arroja
DeviceNotAvailableException

SetAbi

public void setAbi (IAbi abi)

Parámetros
abi	IAbi

setClassName

public void setClassName (String testClassName)

De manera opcional, establece el nombre de la clase de prueba que se ejecutará.

Parámetros
testClassName	String

Solo RecopilarTests

public void setCollectTestsOnly (boolean shouldCollectTest)

Habilita o inhabilita el modo de recopilación de pruebas

SetCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

Este método dejó de estar disponible.
Este método es no-op

Establece el tiempo máximo en milisegundos para permitir el “tiempo máximo de respuesta del resultado de shell” al recopilar y pruebas.

Parámetros
timeout	int

setConfiguration

public void setConfiguration (IConfiguration config)

Inserta el IConfiguration en uso.

Parámetros
config	IConfiguration

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

Establece el objetivo de cobertura de esta prueba.

Actualmente inactivo. Este método solo está presente, por lo que connectionTarget puede recuperarse luego getCoverageTarget()

Parámetros
coverageTarget	String

setDebug

public void setDebug (boolean debug)

Establece la configuración de depuración de instrumentación.

Parámetros
debug	boolean: Es un valor booleano para establecer la configuración de depuración de la instrumentación.

SetDevice

public void setDevice (ITestDevice device)

Inyecta el dispositivo a prueba.

Parámetros
device	ITestDevice: Es el ITestDevice que se usará.

setEnforceFormat

public void setEnforceFormat (boolean enforce)

Establece el valor True si aplicamos el formato de salida AJUR de instrumentación.

Parámetros
enforce	boolean

setForceAbi

public void setForceAbi (String abi)

Establece la opción force-abi.

setInstallFile

public void setInstallFile (File installFile)

Configura el archivo opcional de instalación que contiene las pruebas.

Parámetros
installFile	File: Es el ERROR(/File) instalable.

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Establece cuándo usar o no el almacenamiento aislado.

Parámetros
isolatedStorage	boolean

setMethodName

public void setMethodName (String testMethodName)

De manera opcional, establece el método de prueba que se ejecutará.

Parámetros
testMethodName	String

setMetricCollectors

public void setMetricCollectors ( collectors)

Establece la lista de elementos IMetricCollector definidos para la ejecución de prueba.

Parámetros
collectors

setOrchestrator

public void setOrchestrator (boolean useOrchestrator)

Establece la opción --orchestrator

Parámetros
useOrchestrator	boolean

SetPackageName

public void setPackageName (String packageName)

Configura el paquete de manifiesto de Android que se ejecutará.

Parámetros
packageName	String

setReRun conTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

Establece la opción --rerun-from-file.

Parámetros
reRunUsingTestFile	boolean

setRerunMode

public void setRerunMode (boolean rerun)

De manera opcional, configura el modo de repetición.

Parámetros
rerun	boolean

setRunName

public void setRunName (String runName)

Establece el nombre de ejecución de prueba personalizado que se proporcionará al objeto de escucha

Parámetros
runName	String

setRunnerName

public void setRunnerName (String runnerName)

De manera opcional, configura el ejecutor de instrumentación de Android que se usará.

Parámetros
runnerName	String

setShellTimeout

public void setShellTimeout (long timeout)

De manera opcional, establece el tiempo máximo (en milisegundos) que se espera como resultado del shell del dispositivo.

Parámetros
timeout	long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

De manera opcional, establece la ruta de acceso a un archivo ubicado en el dispositivo que debe contener una lista de líneas métodos y clases de prueba separados (formato: com.foo.Class#method) para ejecutar. Si se establece, intentan ejecutar automáticamente las pruebas con este archivo de prueba mediante InstrumentationFileTest, en lugar de ejecutar comandos adb separados para cada prueba restante. a través de una nueva ejecución.

Parámetros
testFilePathOnDevice	String

setTestPackageName

public void setTestPackageName (String testPackageName)

Establece el filtro del paquete de prueba.

Si el valor no es nulo, solo se ejecutarán las pruebas dentro del paquete de Java especificado.

Se ignorará si se proporciona un valor no nulo a setClassName(String).

Parámetros
testPackageName	String

setTestSize

public void setTestSize (String size)

De manera opcional, configura el tamaño de la prueba que se ejecutará.

Parámetros
size	String

setTestTimeout

public void setTestTimeout (long timeout)

De manera opcional, establece el tiempo máximo (en milisegundos) para cada ejecución de prueba individual.

Parámetros
timeout	long

setTestsToRun

public void setTestsToRun ( tests)

Establece la colección de pruebas que debe ejecutar InstrumentationTest.

Parámetros
tests	: Son las pruebas que se ejecutarán.

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

Parámetros
windowAnimation	boolean

Métodos protegidos

excluirNo ejecutado

protected static  excludeNonExecuted (TestRunResult results)

Filtrar por "NOT_EXECUTED" y se omite para hacer un seguimiento de lo que debe volver a ejecutarse.

Parámetros
results	TestRunResult

Muestra

getClassName

protected String getClassName ()

Obtén el nombre de la clase para ejecutar.

Muestra
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Obtén el ListInstrumentationParser que se usa para analizar "pm list instrumentation" para tus consultas.

Muestra
ListInstrumentationParser

getMethodName

protected String getMethodName ()

Obtén el método de prueba para ejecutar.

Muestra
String

getTestPackageName

protected String getTestPackageName ()

Obtén el paquete de prueba de Java para ejecutarlo.

Muestra
String

nombre del ejecutor de consultas

protected String queryRunnerName ()

Consulta el dispositivo para obtener un ejecutor de pruebas que pueda usar.

Muestra
String	el nombre del primer ejecutor de pruebas que coincida con el paquete o un valor nulo si no encontramos ninguno.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parámetros
runner	IRemoteAndroidTestRunner