Test della strumentazione

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

java.lang.Object
🎞 com.android.tradefed.testtype.InstrumentationTest


Un test che esegue un pacchetto di test di strumentazione su un determinato dispositivo.

Riepilogo

Campi

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

Costruttori pubblici

InstrumentationTest()

Metodi pubblici

void addDeviceListeners( extraListeners)

Consente di aggiungere altri listener personalizzati al runner

void addInstrumentationArg(String key, String value)

Aggiungi un argomento da fornire durante l'esecuzione dei test di strumentazione.

IAbi getAbi()
IConfiguration getConfiguration()

Ottiene il valore IConfiguration per questo test.

String getCoverageTarget()

Ottieni il valore di coverTarget impostato in precedenza tramite setCoverageTarget(String).

boolean getDebug()

Ottieni l'impostazione di debug della strumentazione.

ITestDevice getDevice()

Fai testare il dispositivo.

String getForceAbi()
long getMaxTimeout()

Restituisce il timeout massimo impostato per la strumentazione.

String getPackageName()

Ottieni l'esecuzione del pacchetto manifest Android.

String getRunName()

Ottieni il nome esecuzione di test personalizzato che verrà fornito al listener

String getRunnerName()

Ottieni l'utilizzo del runner di strumentazione Android.

boolean isOrchestrator()

Restituisce il valore di ERROR(InstrumentationTest#mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest#mOrchestrator)

void run(TestInformation testInfo, ITestInvocationListener listener)

Esegue i test e segnala i risultati al listener.

void setAbi(IAbi abi)
void setClassName(String testClassName)

Facoltativamente, imposta il nome della classe di test da eseguire.

void setCollectTestsOnly(boolean shouldCollectTest)

Attiva o disattiva la modalità di raccolta di prova

void setCollectsTestsShellTimeout(int timeout)

Questo metodo è obsoleto. Questo metodo è autonomo

void setConfiguration(IConfiguration config)

Inserisce IConfiguration in uso.

void setCoverageTarget(String coverageTarget)

Imposta il target di copertura di questo test.

void setDebug(boolean debug)

Configura l'impostazione di debug della strumentazione.

void setDevice(ITestDevice device)

Inietta il dispositivo sottoposto a test.

void setEnforceFormat(boolean enforce)

Imposta True se applichiamo il formato di output AJUR della strumentazione.

void setForceAbi(String abi)

Imposta l'opzione force-abi.

void setInstallFile(File installFile)

Imposta il file facoltativo da installare che contiene i test.

void setIsolatedStorage(boolean isolatedStorage)

Impostare se utilizzare o meno lo spazio di archiviazione isolato.

void setMethodName(String testMethodName)

(Facoltativo) Imposta il metodo di test da eseguire.

void setMetricCollectors( collectors)

Consente di impostare l'elenco di IMetricCollector definiti per l'esecuzione del test.

void setOrchestrator(boolean useOrchestrator)

Imposta l'opzione --orchestrator

void setPackageName(String packageName)

Imposta l'esecuzione del pacchetto manifest Android.

void setReRunUsingTestFile(boolean reRunUsingTestFile)

Imposta l'opzione --rerun-from-file.

void setRerunMode(boolean rerun)

Se vuoi, imposta la modalità di riesecuzione.

void setRunName(String runName)

Imposta il nome dell'esecuzione di test personalizzata che verrà fornito al listener

void setRunnerName(String runnerName)

Se vuoi, puoi impostare il runner della strumentazione Android da utilizzare.

void setShellTimeout(long timeout)

Facoltativamente, imposta il tempo massimo (in millisecondi) previsto per l'output della shell dal dispositivo.

void setTestFilePathOnDevice(String testFilePathOnDevice)

Facoltativamente, imposta il percorso di un file che si trova sul dispositivo e che deve contenere un elenco di righe classi e metodi di test separati (formato: com.foo.Class#method) da eseguire.

void setTestPackageName(String testPackageName)

Imposta il filtro del pacchetto di test.

void setTestSize(String size)

(Facoltativo) Imposta le dimensioni di test da eseguire.

void setTestTimeout(long timeout)

Facoltativamente, imposta il tempo massimo (in millisecondi) per ogni singola esecuzione di test.

void setTestsToRun( tests)

Imposta la raccolta dei test che devono essere eseguiti da questo InstrumentationTest.

void setWindowAnimation(boolean windowAnimation)

Metodi protetti

static excludeNonExecuted(TestRunResult results)

Filtra "NOT_EXECUTED" e Ignorato per monitorare ciò che deve essere ripetuto.

String getClassName()

Ottieni il nome del corso da eseguire.

ListInstrumentationParser getListInstrumentationParser()

Usa ListInstrumentationParser per analizzare "pm list instrumentation" query.

String getMethodName()

Ottieni il metodo di test da eseguire.

String getTestPackageName()

Scarica il pacchetto Java di test da eseguire.

String queryRunnerName()

Esegui una query sul dispositivo per farla usare a un test runner.

void setRunnerArgs(IRemoteAndroidTestRunner runner)

Campi

RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

RUN_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

debug m

protected boolean mDebug

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

Costruttori pubblici

Test della strumentazione

public InstrumentationTest ()

Metodi pubblici

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Consente di aggiungere altri listener personalizzati al runner

Parametri
extraListeners

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

Aggiungi un argomento da fornire durante l'esecuzione dei test di strumentazione.

Parametri
key String: nome dell'argomento

value String: valore dell'argomento

getAbi

public IAbi getAbi ()

Ritorni
IAbi

getConfiguration

public IConfiguration getConfiguration ()

Ottiene il valore IConfiguration per questo test.

Ritorni
IConfiguration

getCoperturaTarget

public String getCoverageTarget ()

Ottieni il valore di coverTarget impostato in precedenza tramite setCoverageTarget(String).

Ritorni
String

getDebug

public boolean getDebug ()

Ottieni l'impostazione di debug della strumentazione.

Ritorni
boolean L'impostazione di debug booleana.

getDevice

public ITestDevice getDevice ()

Fai testare il dispositivo.

Ritorni
ITestDevice ITestDevice

getForceAbi

public String getForceAbi ()

Ritorni
String

getMaxTimeout

public long getMaxTimeout ()

Restituisce il timeout massimo impostato per la strumentazione.

Ritorni
long

getPackageName

public String getPackageName ()

Ottieni l'esecuzione del pacchetto manifest Android.

Ritorni
String

getRunName

public String getRunName ()

Ottieni il nome esecuzione di test personalizzato che verrà fornito al listener

Ritorni
String

getRunnerName

public String getRunnerName ()

Ottieni l'utilizzo del runner di strumentazione Android.

Ritorni
String

run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Esegue i test e segnala i risultati al listener.

Parametri
testInfo TestInformation: l'oggetto TestInformation contenente informazioni utili da eseguire test.

listener ITestInvocationListener: ITestInvocationListener dei risultati del test

Lanci
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

Parametri
abi IAbi

setClassName

public void setClassName (String testClassName)

Facoltativamente, imposta il nome della classe di test da eseguire.

Parametri
testClassName String

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Attiva o disattiva la modalità di raccolta di prova

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

Questo metodo è stato ritirato.
Questo metodo è autonomo

Imposta il tempo massimo in ms per consentire il "tempo massimo per la risposta dell'output della shell" durante la raccolta test.

Parametri
timeout int

setConfiguration

public void setConfiguration (IConfiguration config)

Inserisce IConfiguration in uso.

Parametri
config IConfiguration

setCoperturaTarget

public void setCoverageTarget (String coverageTarget)

Imposta il target di copertura di questo test.

Attualmente non utilizzato. Questo metodo è appena presente, quindicoverTarget può essere recuperato in un secondo momento tramite getCoverageTarget()

Parametri
coverageTarget String

setDebug

public void setDebug (boolean debug)

Configura l'impostazione di debug della strumentazione.

Parametri
debug boolean: valore booleano su cui impostare l'impostazione di debug della strumentazione.

impostaDispositivo

public void setDevice (ITestDevice device)

Inietta il dispositivo sottoposto a test.

Parametri
device ITestDevice: i ITestDevice da utilizzare

setEnforceFormat

public void setEnforceFormat (boolean enforce)

Imposta True se applichiamo il formato di output AJUR della strumentazione.

Parametri
enforce boolean

impostaForzaAbi

public void setForceAbi (String abi)

Imposta l'opzione force-abi.

setInstallaFile

public void setInstallFile (File installFile)

Imposta il file facoltativo da installare che contiene i test.

Parametri
installFile File: l'elemento ERROR(/File) installabile

impostaIsolatoArchiviazione

public void setIsolatedStorage (boolean isolatedStorage)

Impostare se utilizzare o meno lo spazio di archiviazione isolato.

Parametri
isolatedStorage boolean

setMethodName

public void setMethodName (String testMethodName)

(Facoltativo) Imposta il metodo di test da eseguire.

Parametri
testMethodName String

setMetricCollectors

public void setMetricCollectors ( collectors)

Consente di impostare l'elenco di IMetricCollector definiti per l'esecuzione del test.

Parametri
collectors

setOrchestrator

public void setOrchestrator (boolean useOrchestrator)

Imposta l'opzione --orchestrator

Parametri
useOrchestrator boolean

setPackageName

public void setPackageName (String packageName)

Imposta l'esecuzione del pacchetto manifest Android.

Parametri
packageName String

impostaReRunUsingTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

Imposta l'opzione --rerun-from-file.

Parametri
reRunUsingTestFile boolean

setRerunMode

public void setRerunMode (boolean rerun)

Se vuoi, imposta la modalità di riesecuzione.

Parametri
rerun boolean

setRunName

public void setRunName (String runName)

Imposta il nome dell'esecuzione di test personalizzata che verrà fornito al listener

Parametri
runName String

setRunnerName

public void setRunnerName (String runnerName)

Se vuoi, puoi impostare il runner della strumentazione Android da utilizzare.

Parametri
runnerName String

setShellTimeout

public void setShellTimeout (long timeout)

Facoltativamente, imposta il tempo massimo (in millisecondi) previsto per l'output della shell dal dispositivo.

Parametri
timeout long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

Facoltativamente, imposta il percorso di un file che si trova sul dispositivo e che deve contenere un elenco di righe classi e metodi di test separati (formato: com.foo.Class#method) da eseguire. Se impostato, Tentano automaticamente di eseguire di nuovo i test utilizzando questo file di test tramite InstrumentationFileTest anziché eseguire comandi adb separati per ogni test rimanente replica.

Parametri
testFilePathOnDevice String

setTestPackageName

public void setTestPackageName (String testPackageName)

Imposta il filtro del pacchetto di test.

Se il valore è diverso, verranno eseguiti solo i test all'interno del pacchetto Java specificato.

Verrà ignorato se a setClassName(String) è stato fornito un valore diverso da null

Parametri
testPackageName String

setTestSize

public void setTestSize (String size)

(Facoltativo) Imposta le dimensioni di test da eseguire.

Parametri
size String

setTestTimeout

public void setTestTimeout (long timeout)

Facoltativamente, imposta il tempo massimo (in millisecondi) per ogni singola esecuzione di test.

Parametri
timeout long

setTestsToRun

public void setTestsToRun ( tests)

Imposta la raccolta dei test che devono essere eseguiti da questo InstrumentationTest.

Parametri
tests : i test da eseguire

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

Parametri
windowAnimation boolean

Metodi protetti

escludereNonEsecuzione

protected static  excludeNonExecuted (TestRunResult results)

Filtra "NOT_EXECUTED" e Ignorato per monitorare ciò che deve essere ripetuto.

Parametri
results TestRunResult

Ritorni

getClassName

protected String getClassName ()

Ottieni il nome del corso da eseguire.

Ritorni
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Usa ListInstrumentationParser per analizzare "pm list instrumentation" query.

Ritorni
ListInstrumentationParser

getMethodName

protected String getMethodName ()

Ottieni il metodo di test da eseguire.

Ritorni
String

getTestPackageName

protected String getTestPackageName ()

Scarica il pacchetto Java di test da eseguire.

Ritorni
String

QueryRunnerName

protected String queryRunnerName ()

Esegui una query sul dispositivo per farla usare a un test runner.

Ritorni
String il nome del primo runner di test che corrisponde al pacchetto oppure è nullo se non ne troviamo.

Lanci
com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parametri
runner IRemoteAndroidTestRunner