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(
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 |
String
|
getCoverageTarget()
Ottieni il valore di coverTarget impostato in precedenza tramite |
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 |
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 |
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(
Consente di impostare l'elenco di |
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(
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 |
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 |
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 |
isOrchestrator
public boolean isOrchestrator ()
Restituisce il valore di ERROR(InstrumentationTest#mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest#mOrchestrator)
Ritorni | |
---|---|
boolean |
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 |
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 staticexcludeNonExecuted (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 |