Questa pagina è stata tradotta dall'API Cloud Translation.

StrumentazioneTest

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

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

Sottoclassi dirette conosciute

AndroidJUnitTest , CodeCoverageTest

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

Un test che esegue un pacchetto di test della 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`

Costruttori pubblici
`InstrumentationTest ()`

Metodi pubblici
`void`	`addDeviceListeners ( extraListeners)` `addDeviceListeners ( extraListeners)` Consente di aggiungere più ascoltatori personalizzati al corridore
`void`	`addInstrumentationArg (String key, String value)` Aggiungi un argomento da fornire durante l'esecuzione dei test di strumentazione.
`IAbi`	`getAbi ()`
`IConfiguration`	`getConfiguration ()` Ottiene l' `IConfiguration` per questo test.
`String`	`getCoverageTarget ()` Ottieni il coverTarget precedentemente impostato tramite `setCoverageTarget(String)` .
`boolean`	`getDebug ()` Ottieni l'impostazione 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 di Android.
`String`	`getRunName ()` Ottieni il nome dell'esecuzione del test personalizzato che verrà fornito all'ascoltatore
`String`	`getRunnerName ()` Ottiene l'utilizzo del runner della strumentazione Android.
`void`	`run ( TestInformation testInfo, ITestInvocationListener listener)` Esegue i test e segnala i risultati all'ascoltatore.
`void`	`setAbi ( IAbi abi)`
`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 dei test
`void`	`setCollectsTestsShellTimeout (int timeout)` Questo metodo è deprecato. Questo metodo non è operativo
`void`	`setConfiguration ( IConfiguration config)` Inietta la `IConfiguration` in uso.
`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)` Imposta True se applichiamo il formato di output AJUR della strumentazione.
`void`	`setForceAbi (String abi)` Imposta l'opzione force-abi.
`void`	`setInstallFile (File installFile)` Impostare il file facoltativo da installare che contiene i test.
`void`	`setIsolatedStorage (boolean isolatedStorage)` Imposta se utilizzare o meno la memoria isolata.
`void`	`setMethodName (String testMethodName)` Facoltativamente, impostare il metodo di test da eseguire.
`void`	`setMetricCollectors ( collectors)` `setMetricCollectors ( collectors)` Imposta l'elenco di `IMetricCollector` definiti per l'esecuzione del test.
`void`	`setPackageName (String packageName)` Imposta il pacchetto manifest Android per l'esecuzione.
`void`	`setReRunUsingTestFile (boolean reRunUsingTestFile)` Imposta l'opzione --rerun-from-file.
`void`	`setRerunMode (boolean rerun)` Facoltativamente, impostare la modalità di riesecuzione.
`void`	`setRunName (String runName)` Imposta il nome dell'esecuzione del test personalizzato che verrà fornito all'ascoltatore
`void`	`setRunnerName (String runnerName)` Facoltativamente, impostare il runner della strumentazione Android da utilizzare.
`void`	`setShellTimeout (long timeout)` Facoltativamente, imposta il tempo massimo (in millisecondi) di attesa dell'output della shell dal dispositivo.
`void`	`setTestFilePathOnDevice (String testFilePathOnDevice)` Facoltativamente, impostare il percorso di un file situato sul dispositivo che dovrebbe contenere un elenco di classi e metodi di test separati da righe (formato: com.foo.Class#method) da eseguire.
`void`	`setTestPackageName (String testPackageName)` Imposta il filtro del pacchetto di prova.
`void`	`setTestSize (String size)` Facoltativamente, impostare la dimensione del test da eseguire.
`void`	`setTestTimeout (long timeout)` Facoltativamente, impostare il tempo massimo (in millisecondi) per ogni singola esecuzione del test.
`void`	`setTestsToRun ( tests)` `setTestsToRun ( tests)` Imposta la raccolta di test che devono essere eseguiti da questo InstrumentationTest.
`void`	`setWindowAnimation (boolean windowAnimation)`

Metodi protetti
`static`	`excludeNonExecuted ( TestRunResult results)` Filtra "NOT_EXECUTED" allo scopo di tenere traccia di ciò che deve essere eseguito nuovamente.
`String`	`getClassName ()` Ottieni il nome della classe da eseguire.
`ListInstrumentationParser`	`getListInstrumentationParser ()` Ottieni `ListInstrumentationParser` utilizzato per analizzare le query "pm list instrumentation".
`String`	`getMethodName ()` Ottieni il metodo di test da eseguire.
`String`	`getTestPackageName ()` Ottieni il pacchetto Java di prova da eseguire.
`String`	`queryRunnerName ()` Richiedi il dispositivo per un test runner da utilizzare.
`void`	`setRunnerArgs (IRemoteAndroidTestRunner runner)`

Campi

ESEGUIRE_TESTS_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

ESEGUIRE_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

mDebug

protected boolean mDebug

Costruttori pubblici

StrumentazioneTest

public InstrumentationTest ()

Metodi pubblici

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Consente di aggiungere più ascoltatori personalizzati al corridore

Parametri
`extraListeners`

aggiungiStrumentazioneArg

public void addInstrumentationArg (String key, 
                String value)

Aggiungi 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`

getConfigurazione

public IConfiguration getConfiguration ()

Ottiene l' IConfiguration per questo test.

ritorna
`IConfiguration`

getCoverageTarget

public String getCoverageTarget ()

Ottieni il coverTarget precedentemente impostato tramite setCoverageTarget(String) .

ritorna
`String`

getDebug

public boolean getDebug ()

Ottieni l'impostazione di debug della strumentazione.

ritorna
`boolean`	L'impostazione booleana di debug.

getDevice

public ITestDevice getDevice ()

Metti il dispositivo in prova.

ritorna
`ITestDevice`	l' `ITestDevice`

getForceAbi

public String getForceAbi ()

ritorna
`String`

getMaxTimeout

public long getMaxTimeout ()

Restituisce il timeout massimo impostato per la strumentazione.

ritorna
`long`

getNomePacchetto

public String getPackageName ()

Ottieni l'esecuzione del pacchetto manifest di Android.

ritorna
`String`

getRunName

public String getRunName ()

Ottieni il nome dell'esecuzione del test personalizzato che verrà fornito all'ascoltatore

ritorna
`String`

getNomeCorridore

public String getRunnerName ()

Ottiene l'utilizzo del runner della strumentazione Android.

ritorna
`String`

correre

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Esegue i test e segnala i risultati all'ascoltatore.

Parametri
`testInfo`	`TestInformation` : l'oggetto `TestInformation` contenente informazioni utili per eseguire i test.
`listener`	`ITestInvocationListener` : `ITestInvocationListener` dei risultati del test

Lancia
`DeviceNotAvailableException`

setAbi

public void setAbi (IAbi abi)

Parametri
`abi`	`IAbi`

setClassNome

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 dei test

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

Questo metodo è deprecato.
Questo metodo non è operativo

Imposta il tempo massimo in ms per consentire il "tempo massimo per la risposta in uscita della shell" durante la raccolta dei test.

Parametri
`timeout`	`int`

setConfigurazione

public void setConfiguration (IConfiguration config)

Inietta la IConfiguration in uso.

Parametri
`config`	`IConfiguration`

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

Imposta l'obiettivo di copertura di questo test.

Attualmente inutilizzato. Questo metodo è appena presente, quindi coverTarget può essere successivamente recuperato 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` : l' `ITestDevice` da utilizzare

setEnforceFormat

public void setEnforceFormat (boolean enforce)

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

Parametri
`enforce`	`boolean`

setForceAbi

public void setForceAbi (String abi)

Imposta l'opzione force-abi.

setInstallFile

public void setInstallFile (File installFile)

Impostare il file facoltativo da installare che contiene i test.

Parametri
`installFile`	`File` : l' `ERROR(/File)`

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Imposta se utilizzare o meno la memoria isolata.

Parametri
`isolatedStorage`	`boolean`

setMethodName

public void setMethodName (String testMethodName)

Facoltativamente, impostare il metodo di test da eseguire.

Parametri
`testMethodName`	`String`

setMetricCollectors

public void setMetricCollectors ( collectors)

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

Parametri
`collectors`

setNomePacchetto

public void setPackageName (String packageName)

Imposta il pacchetto manifest Android per l'esecuzione.

Parametri
`packageName`	`String`

setReRunUsingTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

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

Parametri
`reRunUsingTestFile`	`boolean`

setRerunMode

public void setRerunMode (boolean rerun)

Facoltativamente, impostare la modalità di riesecuzione.

Parametri
`rerun`	`boolean`

setRunName

public void setRunName (String runName)

Imposta il nome dell'esecuzione del test personalizzato che verrà fornito all'ascoltatore

Parametri
`runName`	`String`

setNomeRunner

public void setRunnerName (String runnerName)

Facoltativamente, impostare il runner della strumentazione Android da utilizzare.

Parametri
`runnerName`	`String`

setShellTimeout

public void setShellTimeout (long timeout)

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

Parametri
`timeout`	`long`

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

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

Parametri
`testFilePathOnDevice`	`String`

setNomePacchettoTest

public void setTestPackageName (String testPackageName)

Imposta il filtro del pacchetto di prova.

Se diverso da null, verranno eseguiti solo i test all'interno del pacchetto Java specificato.

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

Parametri
`testPackageName`	`String`

setTestSize

public void setTestSize (String size)

Facoltativamente, impostare la dimensione del test da eseguire.

Parametri
`size`	`String`

setTestTimeout

public void setTestTimeout (long timeout)

Facoltativamente, impostare il tempo massimo (in millisecondi) per ogni singola esecuzione del test.

Parametri
`timeout`	`long`

setTestDaEseguire

public void setTestsToRun ( tests)

Imposta la raccolta di 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

excludeNonExecuted

protected static  excludeNonExecuted (TestRunResult results)

Filtra "NOT_EXECUTED" allo scopo di tenere traccia di ciò che deve essere eseguito nuovamente.

Parametri
`results`	`TestRunResult`

ritorna

getClassName

protected String getClassName ()

Ottieni il nome della classe da eseguire.

ritorna
`String`

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

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

ritorna
`ListInstrumentationParser`

getNomeMetodo

protected String getMethodName ()

Ottieni il metodo di test da eseguire.

ritorna
`String`

getNomePacchettoTest

protected String getTestPackageName ()

Ottieni il pacchetto Java di prova da eseguire.

ritorna
`String`

queryRunnerName

protected String queryRunnerName ()

Richiedi il dispositivo per un test runner da utilizzare.

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

Lancia
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parametri
`runner`	`IRemoteAndroidTestRunner`