Google is committed to advancing racial equity for Black communities. See how.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

InstrumentationTest

public class InstrumentationTest
extends Object implements IDeviceTest , IResumableTest , ITestCollector , IAbiReceiver , IInvocationContextReceiver , IMetricCollectorReceiver

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


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

Sommario

campi

protected boolean mDebug

Costruttori pubblici

InstrumentationTest ()

Metodi pubblici

void addDeviceListeners ( extraListeners) addDeviceListeners ( extraListeners)

Consente di aggiungere più listener personalizzati al runner

void addInstrumentationArg (String key, String value)

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

IAbi getAbi ()
String getCoverageTarget ()

Ottieni la coperturaTarget precedentemente impostato tramite setCoverageTarget(String) .

boolean getDebug ()

Ottieni le impostazioni di debug della strumentazione.

ITestDevice getDevice ()

Metti il ​​dispositivo in prova.

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 dell'esecuzione del test personalizzato che verrà fornito al listener

String getRunnerName ()

Ottiene il corridore di strumentazione Android da utilizzare.

boolean isResumable ()

void run ( ITestInvocationListener listener)

Esegue i test e riporta i risultati al listener.

void setAbi ( IAbi abi)
void setBugreportFrequency ( BugreportCollector.Freq freq)

Imposta la frequenza con cui raccogliere automaticamente le segnalazioni di bug dopo errori di test.

void setClassName (String testClassName)

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

void setCollectTestsOnly (boolean shouldCollectTest)

Abilita o disabilita la modalità di raccolta test

void setCollectsTestsShellTimeout (int timeout)

Questo metodo è obsoleto. Questo metodo è vietato

void setCoverageTarget (String coverageTarget)

Imposta l'obiettivo di copertura di questo test.

void setDebug (boolean debug)

Configurare l'impostazione di debug della strumentazione.

void setDevice ( ITestDevice device)

Iniettare il dispositivo in prova.

void setEnforceFormat (boolean enforce)

Impostare True se imponiamo il formato di output della strumentazione AJUR.

void setFallbackToSerialRerun (boolean reRunSerially)

Imposta l'opzione --fallback-to-serial-rerun.

void setForceAbi (String abi)

Imposta l'opzione force-abi.

void setInstallFile (File installFile)

Impostare il file opzionale da installare che contiene i test.

void setInvocationContext ( IInvocationContext invocationContext)
void setIsolatedStorage (boolean isolatedStorage)

Impostare se utilizzare o meno l'archiviazione isolata.

void setMethodName (String testMethodName)

Facoltativamente, impostare il metodo di test per l'esecuzione.

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

Imposta l'elenco di IMetricCollector definito per l'esecuzione del test.

void setPackageName (String packageName)

Imposta l'esecuzione del pacchetto manifest Android.

void setReRunUsingTestFile (boolean reRunUsingTestFile)

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

void setRebootBeforeReRun (boolean rebootBeforeReRun)

Imposta l'opzione --reboot-before-rerun.

void setRerunMode (boolean rerun)

Facoltativamente, impostare la modalità di riesecuzione.

void setResumeMode (boolean resume)

Facoltativamente, impostare la modalità di ripresa.

void setRunName (String runName)

Imposta il nome dell'esecuzione del test personalizzato che verrà fornito al listener

void setRunnerName (String runnerName)

Facoltativamente, impostare il corridore di strumentazione Android da utilizzare.

void setShellTimeout (long timeout)

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

void setTestFilePathOnDevice (String testFilePathOnDevice)

Facoltativamente, impostare il percorso su un file situato sul dispositivo che dovrebbe contenere un elenco di classi e metodi di test separati da riga (formato: metodo com.foo.Class #) da eseguire.

void setTestPackageName (String testPackageName)

Imposta il filtro del pacchetto di test.

void setTestSize (String size)

Facoltativamente, impostare le dimensioni del test per l'esecuzione.

void setTestTimeout (long timeout)

Facoltativamente, impostare il tempo massimo (in millisecondi) per ogni singola prova.

void setTestsToRun ( tests) setTestsToRun ( tests)

Impostare la raccolta di test che devono essere eseguiti da questo InstrumentationTest.

Metodi protetti

String getClassName ()

Ottieni il nome della classe da eseguire.

ListInstrumentationParser getListInstrumentationParser ()

Ottieni il ListInstrumentationParser utilizzato per analizzare le query "pm list instrumentation".

String getMethodName ()

Ottieni l'esecuzione del metodo di prova.

String getTestPackageName ()

Ottieni l'esecuzione del pacchetto java di prova.

String queryRunnerName ()

Interroga il dispositivo per un test runner da utilizzare.

void setRunnerArgs (IRemoteAndroidTestRunner runner)

campi

mDebug

protected boolean mDebug

Costruttori pubblici

InstrumentationTest

public InstrumentationTest ()

Metodi pubblici

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Consente di aggiungere più listener personalizzati al runner

parametri
extraListeners

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

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

parametri
key String : il nome dell'argomento

value String : il valore dell'argomento

getAbi

public IAbi getAbi ()

ritorna
IAbi

getCoverageTarget

public String getCoverageTarget ()

Ottieni la coperturaTarget precedentemente impostato tramite setCoverageTarget(String) .

ritorna
String

getDebug

public boolean getDebug ()

Ottieni le impostazioni di debug della strumentazione.

ritorna
boolean L'impostazione di debug booleana.

GetDevice

public ITestDevice getDevice ()

Metti il ​​dispositivo in prova.

ritorna
ITestDevice il ITestDevice

getForceAbi

public String getForceAbi ()

ritorna
String

getMaxTimeout

public long getMaxTimeout ()

Restituisce il timeout massimo impostato per la strumentazione.

ritorna
long

getPackageName

public String getPackageName ()

Ottieni l'esecuzione del pacchetto manifest Android.

ritorna
String

getRunName

public String getRunName ()

Ottieni il nome dell'esecuzione del test personalizzato che verrà fornito al listener

ritorna
String

getRunnerName

public String getRunnerName ()

Ottiene il corridore di strumentazione Android da utilizzare.

ritorna
String

isResumable

public boolean isResumable ()

ritorna
boolean

correre

public void run ( ITestInvocationListener listener)

Esegue i test e riporta i risultati al listener.

parametri
listener ITestInvocationListener : ITestInvocationListener dei risultati del test

Genera
DeviceNotAvailableException

setAbi

public void setAbi ( IAbi abi)

parametri
abi IAbi

setBugreportFrequency

public void setBugreportFrequency ( BugreportCollector.Freq freq)

Imposta la frequenza con cui raccogliere automaticamente le segnalazioni di bug dopo errori di test.

Si noti che non esiste un meccanismo di feedback tra il test runner e il raccoglitore di segnalazioni di bug, quindi utilizzare l'impostazione EACH con la dovuta cautela: se si verifica una grande quantità di guasti in rapida successione, il bugreport per un dato dei guasti potrebbe finire per essere raccolto decine di minuti o ore dopo il rispettivo errore.

parametri
freq BugreportCollector.Freq

setClassName

public void setClassName (String testClassName)

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

parametri
testClassName String

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Abilita o disabilita la modalità di raccolta test

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

Questo metodo è obsoleto.
Questo metodo è vietato

Impostare il tempo massimo in ms per consentire il "tempo massimo per la risposta di output shell" durante la raccolta dei test.

parametri
timeout int

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

Imposta l'obiettivo di copertura di questo test.

Attualmente non utilizzato. Questo metodo è presente solo in modo da poter recuperare in seguito getCoverageTarget() tramite getCoverageTarget()

parametri
coverageTarget String

setDebug

public void setDebug (boolean debug)

Configurare l'impostazione di debug della strumentazione.

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

setDevice

public void setDevice ( ITestDevice device)

Iniettare il dispositivo in prova.

parametri
device ITestDevice : ITestDevice da utilizzare

setEnforceFormat

public void setEnforceFormat (boolean enforce)

Impostare True se imponiamo il formato di output della strumentazione AJUR.

parametri
enforce boolean

setFallbackToSerialRerun

public void setFallbackToSerialRerun (boolean reRunSerially)

Imposta l'opzione --fallback-to-serial-rerun.

parametri
reRunSerially boolean

setForceAbi

public void setForceAbi (String abi)

Imposta l'opzione force-abi.

setInstallFile

public void setInstallFile (File installFile)

Impostare il file opzionale da installare che contiene i test.

parametri
installFile File : ERROR(/File) installabile

setInvocationContext

public void setInvocationContext ( IInvocationContext invocationContext)

parametri
invocationContext IInvocationContext

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Impostare se utilizzare o meno l'archiviazione isolata.

parametri
isolatedStorage boolean

setMethodName

public void setMethodName (String testMethodName)

Facoltativamente, impostare il metodo di test per l'esecuzione.

parametri
testMethodName String

setMetricCollectors

public void setMetricCollectors ( collectors)

Imposta l'elenco di IMetricCollector definito per l'esecuzione del test.

parametri
collectors

setPackageName

public void setPackageName (String packageName)

Imposta l'esecuzione del pacchetto manifest Android.

parametri
packageName String

setReRunUsingTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

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

parametri
reRunUsingTestFile boolean

setRebootBeforeReRun

public void setRebootBeforeReRun (boolean rebootBeforeReRun)

Imposta l'opzione --reboot-before-rerun.

parametri
rebootBeforeReRun boolean

setRerunMode

public void setRerunMode (boolean rerun)

Facoltativamente, impostare la modalità di riesecuzione.

parametri
rerun boolean

setResumeMode

public void setResumeMode (boolean resume)

Facoltativamente, impostare la modalità di ripresa.

parametri
resume boolean

setRunName

public void setRunName (String runName)

Impostare il nome dell'esecuzione del test personalizzato che verrà fornito al listener

parametri
runName String

setRunnerName

public void setRunnerName (String runnerName)

Facoltativamente, impostare il corridore di strumentazione Android da utilizzare.

parametri
runnerName String

setShellTimeout

public void setShellTimeout (long timeout)

Facoltativamente, impostare il tempo massimo (in millisecondi) in attesa dell'output della shell dal dispositivo.

parametri
timeout long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

Facoltativamente, impostare il percorso su un file situato sul dispositivo che dovrebbe contenere un elenco di classi e metodi di test separati da riga (formato: metodo com.foo.Class #) da eseguire. Se impostato, tenterà automaticamente di rieseguire i test utilizzando questo file di test tramite InstrumentationFileTest invece di eseguire comandi adb separati per ciascun test rimanente tramite InstrumentationSerialTest "

parametri
testFilePathOnDevice String

setTestPackageName

public void setTestPackageName (String testPackageName)

Imposta il filtro del pacchetto di test.

Se non nullo, verranno eseguiti solo i test all'interno del pacchetto java specificato.

Verrà ignorato se è stato fornito un valore non nullo a setClassName(String)

parametri
testPackageName String

setTestSize

public void setTestSize (String size)

Facoltativamente, impostare le dimensioni del test per l'esecuzione.

parametri
size String

setTestTimeout

public void setTestTimeout (long timeout)

Facoltativamente, impostare il tempo massimo (in millisecondi) per ogni singola prova.

parametri
timeout long

setTestsToRun

public void setTestsToRun ( tests)

Impostare la raccolta di test che devono essere eseguiti da questo InstrumentationTest.

parametri
tests : i test da eseguire

Metodi protetti

GetClassName

protected String getClassName ()

Ottieni il nome della classe da eseguire.

ritorna
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Ottieni il ListInstrumentationParser utilizzato per analizzare le query "pm list instrumentation".

ritorna
ListInstrumentationParser

getMethodName

protected String getMethodName ()

Ottieni l'esecuzione del metodo di prova.

ritorna
String

getTestPackageName

protected String getTestPackageName ()

Ottieni l'esecuzione del pacchetto java di prova.

ritorna
String

queryRunnerName

protected String queryRunnerName ()

Interroga il dispositivo per un test runner da utilizzare.

ritorna
String il primo nome del test runner che corrisponde al pacchetto o null se non ne troviamo nessuno.

Genera
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

parametri
runner IRemoteAndroidTestRunner