Questa pagina è stata tradotta dall'API Cloud Translation.

Test della strumentazione

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

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

Sottoclassi dirette note

AndroidJUnitTest, CodeCoperturaTest

AndroidJUnitTest	Un test che esegue un pacchetto di test di strumentazione su un determinato dispositivo utilizzando android.support.test.runner.AndroidJUnitRunner
TestCopertura del codice	un test che esegue un pacchetto di test di strumentazione su un determinato dispositivo e genera il report Copertura codice.

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`

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`

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`