A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release anziché aosp-main per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.

Questa pagina è stata tradotta dall'API Cloud Translation.

InstrumentationTest

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

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

Classi di sottoclasse dirette note

AndroidJUnitTest, CodeCoverageTest

AndroidJUnitTest	Un test che esegue un pacchetto di test di strumentazione su un determinato dispositivo utilizzando android.support.test.runner.AndroidJUnitRunner.
CodeCoverageTest	Un test che esegue un pacchetto di test di strumentazione su un determinato dispositivo e genera il report sulla copertura del 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 ascoltatori personalizzati al runner
`void`	`addInstrumentationArg(String key, String value)` Aggiungi un argomento da fornire durante l'esecuzione dei test di misurazione.
`IAbi`	`getAbi()`
`IConfiguration`	`getConfiguration()` Recupera il `IConfiguration` per questo test.
`String`	`getCoverageTarget()` Recupera il valore coverageTarget impostato in precedenza tramite `setCoverageTarget(String)`.
`boolean`	`getDebug()` Recupera l'impostazione di debug della misurazione.
`ITestDevice`	`getDevice()` Ottieni il dispositivo di test.
`String`	`getForceAbi()`
`long`	`getMaxTimeout()` Restituisce il timeout massimo impostato per la misurazione.
`String`	`getPackageName()` Esegui il pacchetto manifest Android.
`String`	`getRunName()` Ottieni il nome dell'esecuzione del test personalizzato che verrà fornito all'ascoltatore
`String`	`getRunnerName()` Recupera il runner di strumenti Android da utilizzare.
`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 il risultato all'ascoltatore.
`void`	`setAbi(IAbi abi)`
`void`	`setClassName(String testClassName)` Se vuoi, imposta il nome della classe di test da eseguire.
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Attiva o disattiva la modalità di raccolta dei test
`void`	`setCollectsTestsShellTimeout(int timeout)` Questo metodo è deprecato. Questo metodo è un no-op
`void`	`setConfiguration(IConfiguration config)` Invia il `IConfiguration` in uso.
`void`	`setCoverageTarget(String coverageTarget)` Imposta il target di copertura di questo test.
`void`	`setDebug(boolean debug)` Imposta l'impostazione di debug della misurazione.
`void`	`setDevice(ITestDevice device)` Esegui l'iniezione del dispositivo di test.
`void`	`setEnforceFormat(boolean enforce)` Imposta True se viene applicato il formato di output AJUR della misurazione.
`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)` Imposta se utilizzare o meno lo spazio di archiviazione isolato.
`void`	`setMethodName(String testMethodName)` (Facoltativo) Imposta il metodo di test da eseguire.
`void`	`setMetricCollectors( collectors)` Imposta l'elenco di `IMetricCollector` definiti per l'esecuzione del test.
`void`	`setOrchestrator(boolean useOrchestrator)` Imposta l'opzione --orchestrator
`void`	`setPackageName(String packageName)` Imposta il pacchetto manifest Android da eseguire.
`void`	`setReRunUsingTestFile(boolean reRunUsingTestFile)` Imposta l'opzione --rerun-from-file.
`void`	`setRerunMode(boolean rerun)` (Facoltativo) Imposta la modalità di esecuzione di nuovo.
`void`	`setRunName(String runName)` Imposta il nome della prova personalizzata che verrà fornito all'ascoltatore
`void`	`setRunnerName(String runnerName)` Se vuoi, imposta il runner di strumenti Android da utilizzare.
`void`	`setShellTimeout(long timeout)` (Facoltativo) Imposta il tempo massimo (in millisecondi) che deve trascorrere prima che venga visualizzato l'output della shell dal dispositivo.
`void`	`setTestFilePathOnDevice(String testFilePathOnDevice)` Facoltativamente, imposta il percorso di un file sul dispositivo che deve contenere un elenco di metodi e classi di test separati da riga (formato: com.foo.Class#method) da eseguire.
`void`	`setTestPackageName(String testPackageName)` Imposta il filtro del pacchetto di test.
`void`	`setTestSize(String size)` Se vuoi, imposta la dimensione del test da eseguire.
`void`	`setTestTimeout(long timeout)` Se vuoi, imposta il tempo massimo (in millisecondi) per ogni singola esecuzione del test.
`void`	`setTestsToRun( tests)` Imposta la raccolta di test da eseguire da questo InstrumentationTest.
`void`	`setWindowAnimation(boolean windowAnimation)`

Metodi protetti
`static`	`excludeNonExecuted(TestRunResult results)` Filtra "NOT_EXECUTED" e Saltato allo scopo di monitorare ciò che deve essere eseguito di nuovo.
`String`	`getClassName()` Ottieni il nome del corso da eseguire.
`ListInstrumentationParser`	`getListInstrumentationParser()` Recupera il `ListInstrumentationParser` utilizzato per analizzare le query di "strumentazione dell'elenco pm".
`String`	`getMethodName()` Esegui il metodo di test.
`String`	`getTestPackageName()` Esegui il pacchetto Java di test.
`String`	`queryRunnerName()` Esegui una query sul dispositivo per un programma di esecuzione dei test da utilizzare.
`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

mDebug

protected boolean mDebug

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

Costruttori pubblici

InstrumentationTest

public InstrumentationTest ()

Metodi pubblici

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Consente di aggiungere altri ascoltatori personalizzati al runner

Parametri
`extraListeners`

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

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

Parametri
`key`	`String`: il nome dell'argomento
`value`	`String`: il valore dell'argomento

getAbi

public IAbi getAbi ()

Ritorni
`IAbi`

getConfiguration

public IConfiguration getConfiguration ()

Recupera il IConfiguration per questo test.

Ritorni
`IConfiguration`

getCoverageTarget

public String getCoverageTarget ()

Recupera il valore coverageTarget impostato in precedenza tramite setCoverageTarget(String).

Ritorni
`String`

getDebug

public boolean getDebug ()

Recupera l'impostazione di debug della misurazione.

Ritorni
`boolean`	L'impostazione di debug booleana.

getDevice

public ITestDevice getDevice ()

Ottieni il dispositivo di test.

Ritorni
`ITestDevice`	`ITestDevice`

getForceAbi

public String getForceAbi ()

Ritorni
`String`

getMaxTimeout

public long getMaxTimeout ()

Restituisce il timeout massimo impostato per la misurazione.

Ritorni
`long`

getPackageName

public String getPackageName ()

Esegui il pacchetto manifest Android.

Ritorni
`String`

getRunName

public String getRunName ()

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

Ritorni
`String`

getRunnerName

public String getRunnerName ()

Recupera il runner di strumenti Android da utilizzare.

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 il risultato all'ascoltatore.

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

Lanci
`DeviceNotAvailableException`

setAbi

public void setAbi (IAbi abi)

Parametri
`abi`	`IAbi`

setClassName

public void setClassName (String testClassName)

Se vuoi, 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 dei test

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

Questo metodo è deprecato.
Questo metodo non esegue alcuna operazione

Imposta il tempo massimo in millisecondi per consentire il "tempo massimo per la risposta di output della shell" durante la raccolta dei test.

Parametri
`timeout`	`int`

setConfiguration

public void setConfiguration (IConfiguration config)

Invia il IConfiguration in uso.

Parametri
`config`	`IConfiguration`

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

Imposta il target di copertura di questo test.

Attualmente non utilizzato. Questo metodo è presente solo per consentire il recupero di coverageTarget in un secondo momento tramite getCoverageTarget()

Parametri
`coverageTarget`	`String`

setDebug

public void setDebug (boolean debug)

Imposta l'impostazione di debug della misurazione.

Parametri
`debug`	`boolean`: valore booleano da impostare per l'impostazione di debug della misurazione.

setDevice

public void setDevice (ITestDevice device)

Esegui l'iniezione del dispositivo di test.

Parametri
`device`	`ITestDevice`: il `ITestDevice` da utilizzare

setEnforceFormat

public void setEnforceFormat (boolean enforce)

Imposta True se viene applicato il formato di output AJUR della misurazione.

Parametri
`enforce`	`boolean`

setForceAbi

public void setForceAbi (String abi)

Imposta l'opzione force-abi.

setInstallFile

public void setInstallFile (File installFile)

Imposta il file facoltativo da installare che contiene i test.

Parametri
`installFile`	`File`: il pacchetto installabile `ERROR(/File)`

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Imposta 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)

Imposta 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 il pacchetto manifest Android da eseguire.

Parametri
`packageName`	`String`

setReRunUsingTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

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

Parametri
`reRunUsingTestFile`	`boolean`

setRerunMode

public void setRerunMode (boolean rerun)

(Facoltativo) Imposta la modalità di esecuzione di nuovo.

Parametri
`rerun`	`boolean`

setRunName

public void setRunName (String runName)

Imposta il nome della prova personalizzata che verrà fornito all'ascoltatore

Parametri
`runName`	`String`

setRunnerName

public void setRunnerName (String runnerName)

Se vuoi, imposta il runner di strumenti Android da utilizzare.

Parametri
`runnerName`	`String`

setShellTimeout

public void setShellTimeout (long timeout)

(Facoltativo) Imposta il tempo massimo (in millisecondi) che deve trascorrere prima che venga visualizzato l'output della shell dal dispositivo.

Parametri
`timeout`	`long`

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

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

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 a setClassName(String) è stato fornito un valore diverso da null.

Parametri
`testPackageName`	`String`

setTestSize

public void setTestSize (String size)

Se vuoi, imposta la dimensione del test da eseguire.

Parametri
`size`	`String`

setTestTimeout

public void setTestTimeout (long timeout)

Se vuoi, imposta il tempo massimo (in millisecondi) per ogni singola esecuzione del test.

Parametri
`timeout`	`long`

setTestsToRun

public void setTestsToRun ( tests)

Imposta la raccolta di test da eseguire 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" e Saltato allo scopo di monitorare ciò che deve essere eseguito di nuovo.

Parametri
`results`	`TestRunResult`

Ritorni

getClassName

protected String getClassName ()

Ottieni il nome del corso da eseguire.

Ritorni
`String`

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Recupera il ListInstrumentationParser utilizzato per analizzare le query di "strumentazione dell'elenco pm".

Ritorni
`ListInstrumentationParser`

getMethodName

protected String getMethodName ()

Esegui il metodo di test.

Ritorni
`String`

getTestPackageName

protected String getTestPackageName ()

Esegui il pacchetto Java di test.

Ritorni
`String`

queryRunnerName

protected String queryRunnerName ()

Esegui una query sul dispositivo per un programma di esecuzione dei test da utilizzare.

Ritorni
`String`	il nome del primo runner dei test che corrisponde al pacchetto o null se non ne viene trovato nessuno.

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parametri
`runner`	`IRemoteAndroidTestRunner`