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.

RemoteAndroidTestRunner

public class RemoteAndroidTestRunner
extends Object implements IRemoteAndroidTestRunner

java.lang.Object
↳	com.android.ddmlib.testrunner.RemoteAndroidTestRunner

Esegue un comando di test Android da remoto e riporta i risultati.

Riepilogo

Costruttori pubblici
`RemoteAndroidTestRunner(String packageName, IShellEnabledDevice remoteDevice)` Costruttore alternativo.
`RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice)` Costruttore alternativo.
`RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice, RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)` Crea un test runner Android remoto.

Metodi pubblici
`void`	`addBooleanArg(String name, boolean value)` Aggiunge un argomento booleano da includere nel comando di strumentazione.
`void`	`addInstrumentationArg(String name, String value)` Aggiunge un argomento da includere nel comando di strumentazione.
`void`	`cancel()` Richiede l'annullamento di questo test.
`IInstrumentationResultParser`	`createParser(String runName, listeners)` Crea il `InstrumentationResultParser` che verrà utilizzato per analizzare l'output della strumentazione.
`String`	`getAmInstrumentCommand()`
`IRemoteAndroidTestRunner.CoverageOutput`	`getCoverageOutputType()` Restituisce il tipo di copertura del test prodotto dal runner.
`String`	`getPackageName()` Restituisce il nome del pacchetto dell'applicazione.
`String`	`getRunOptions()` Restituisce le opzioni per il comando dello strumento am.
`String`	`getRunnerName()` Restituisce runnerName.
`void`	`removeInstrumentationArg(String name)` Rimuove un argomento aggiunto in precedenza.
`void`	`run(ITestRunListener... listeners)` Esegui questa esecuzione di test.
`void`	`run( listeners)` Esegui questa esecuzione di test.
`void`	`setAdditionalTestOutputLocation(String additionalTestDataPath)` Imposta la posizione dell'output di test aggiuntivo da copiare sull'host prima della disinstallazione dell'app di test.
`void`	`setClassName(String className)` Imposta l'esecuzione solo dei test in questa classe. Deve essere chiamato prima di "run".
`void`	`setClassNames(String[] classNames)` Imposta l'esecuzione solo dei test nelle classi fornite. Deve essere chiamato prima di "run".
`void`	`setCoverage(boolean coverage)` Imposta questa modalità di copertura del codice dell'esecuzione del test.
`void`	`setCoverageReportLocation(String reportPath)` Imposta la posizione dei report sulla copertura generati.
`void`	`setDebug(boolean debug)` Imposta questa modalità di debug dell'esecuzione del test.
`void`	`setLogOnly(boolean logOnly)` Imposta questa esecuzione del test in modalità solo log, ignorando l'esecuzione del test.
`void`	`setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` Imposta il tempo massimo consentito tra l'output del comando shell che esegue i test sui dispositivi.
`void`	`setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)` Imposta il tempo massimo consentito per il completamento della strumentazione.
`void`	`setMaxtimeToOutputResponse(int maxTimeToOutputResponse)`
`void`	`setMethodName(String className, String testName)` Imposta l'esecuzione solo del metodo di test specificato. Deve essere chiamato prima di "run".
`void`	`setRunName(String runName)` Imposta un nome di esecuzione personalizzato da comunicare a `ITestRunListener` il giorno `run()` Se non specificato, verrà utilizzato il nome del pacchetto
`void`	`setRunOptions(String options)` Imposta le opzioni per il comando am instrument.
`void`	`setTestCollection(boolean collect)` Imposta questa esecuzione test sulla modalità di raccolta test.
`void`	`setTestPackageName(String packageName)` Imposta l'esecuzione di tutti i test nel pacchetto specificato. Deve essere chiamato prima di "run".
`void`	`setTestSize(IRemoteAndroidTestRunner.TestSize size)` Imposta l'esecuzione solo di test di dimensioni specifiche.

Metodi protetti
`String`	`getArgsCommand()` Restituisce la sintassi completa della riga di comando di strumentazione per gli argomenti di strumentazione forniti.
`String`	`getRunnerPath()` Restituisce il percorso completo del componente di strumentazione.

Costruttori pubblici

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                IShellEnabledDevice remoteDevice)

Costruttore alternativo. Utilizza il runner di strumentazione predefinito.

Parametri
`packageName`	`String`: il pacchetto dell'applicazione Android che contiene i test da eseguire
`remoteDevice`	`IShellEnabledDevice`: il dispositivo Android su cui eseguire i test

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice)

Costruttore alternativo. Utilizza il valore predefinito statusReporterMode.

Parametri
`packageName`	`String`: il pacchetto dell'applicazione Android che contiene i test da eseguire
`runnerName`	`String`: il runner di test di strumentazione da eseguire. Se null, verrà utilizzato il runner predefinito
`remoteDevice`	`IShellEnabledDevice`: il dispositivo Android su cui eseguire i test

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice, 
                RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

Crea un test runner Android remoto.

Parametri
`packageName`	`String`: il pacchetto dell'applicazione Android che contiene i test da eseguire
`runnerName`	`String`: il runner di test di strumentazione da eseguire. Se null, verrà utilizzato il runner predefinito
`remoteDevice`	`IShellEnabledDevice`: il dispositivo Android su cui eseguire i test
`statusReporterMode`	`RemoteAndroidTestRunner.StatusReporterMode`: la modalità di reporter di stato da utilizzare per un comando di strumentazione

Metodi pubblici

addBooleanArg

public void addBooleanArg (String name, 
                boolean value)

Aggiunge un argomento booleano da includere nel comando di strumentazione.

Parametri
`name`	`String`: il nome dell'argomento del bundle di strumentazione
`value`	`boolean`: il valore dell'argomento

addInstrumentationArg

public void addInstrumentationArg (String name, 
                String value)

Aggiunge un argomento da includere nel comando di strumentazione.

Deve essere chiamato prima di "run". Se è già stato fornito un argomento con il nome specificato, il relativo valore verrà sovrascritto.

Parametri
`name`	`String`: il nome dell'argomento del bundle di strumentazione
`value`	`String`: il valore dell'argomento

annulla

public void cancel ()

Richiede l'annullamento di questo test.

createParser

public IInstrumentationResultParser createParser (String runName, 
                 listeners)

Crea il InstrumentationResultParser che verrà utilizzato per analizzare l'output della strumentazione.

Parametri
`runName`	`String`: il nome dell'esecuzione da utilizzare.
`listeners`	: i listener a cui segnalare i risultati.

Ritorni
`IInstrumentationResultParser`	Un'istanza di `InstrumentationResultParser`.

getAmInstrumentCommand

public String getAmInstrumentCommand ()

Ritorni
`String`

getCoverageOutputType

public IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

Restituisce il tipo di copertura del test prodotto dal runner. Leggi i CoverageOutput.

Ritorni
`IRemoteAndroidTestRunner.CoverageOutput`

getPackageName

public String getPackageName ()

Restituisce il nome del pacchetto dell'applicazione.

Ritorni
`String`

getRunOptions

public String getRunOptions ()

Restituisce le opzioni per il comando dello strumento am.

Ritorni
`String`

getRunnerName

public String getRunnerName ()

Restituisce runnerName.

Ritorni
`String`

removeInstrumentationArg

public void removeInstrumentationArg (String name)

Rimuove un argomento aggiunto in precedenza.

Parametri
`name`	`String`: il nome dell'argomento del bundle di strumentazione da rimuovere

run

public void run (ITestRunListener... listeners)

Esegui questa esecuzione di test.

Metodo di convenienza per ERROR(/#run(Collection)).

Parametri
`listeners`	`ITestRunListener`: ascolta i risultati del test

Lanci
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

run

public void run ( listeners)

Esegui questa esecuzione di test.

Parametri
`listeners`	: raccolta di listener per i risultati del test

Lanci
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

setAdditionalTestOutputLocation

public void setAdditionalTestOutputLocation (String additionalTestDataPath)

Imposta la posizione dell'output di test aggiuntivo da copiare sull'host prima della disinstallazione dell'app di test. Ad esempio, i report benchmark generati.

Parametri
`additionalTestDataPath`	`String`

setClassName

public void setClassName (String className)

Imposta l'esecuzione solo dei test in questa classe. Deve essere chiamato prima di "run".

Parametri
`className`	`String`: nome della classe completo (ad es. x.y.z)

setClassNames

public void setClassNames (String[] classNames)

Imposta l'esecuzione solo dei test nelle classi fornite. Deve essere chiamato prima di "run".

Se fornisci più di una classe, è necessario un InstrumentationTestRunner che supporti la sintassi dell'argomento per più classi.

Parametri
`classNames`	`String`: array di nomi di classi completi (ad es. x.y.z)

setCoverage

public void setCoverage (boolean coverage)

Imposta questa modalità di copertura del codice dell'esecuzione del test.

Parametri
`coverage`	`boolean`

setCoverageReportLocation

public void setCoverageReportLocation (String reportPath)

Imposta la posizione dei report sulla copertura generati.

Parametri
`reportPath`	`String`

setDebug

public void setDebug (boolean debug)

Imposta questa modalità di debug dell'esecuzione del test. Se è true, Android Test Runner attenderà l'attacco di un debugger prima di procedere con l'esecuzione del test.

Parametri
`debug`	`boolean`

setLogOnly

public void setLogOnly (boolean logOnly)

Imposta questa esecuzione del test in modalità solo log, ignorando l'esecuzione del test.

Parametri
`logOnly`	`boolean`

setMaxTimeToOutputResponse

public void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

Imposta il tempo massimo consentito tra l'output del comando shell che esegue i test sui dispositivi.

Ciò consente di impostare un timeout nel caso in cui i test possano bloccarsi e non terminare mai. Questo è diverso dal normale timeout della connessione.

Per impostazione predefinita, non verrà specificato alcun timeout.

Parametri
`maxTimeToOutputResponse`	`long`: il periodo di tempo massimo durante il quale il comando può non restituire alcuna risposta. Un valore pari a 0 indica che il metodo attenderà per sempre (finché `receiver` non annulla l'esecuzione) l'output del comando e non genererà mai un'eccezione.
`maxTimeUnits`	`TimeUnit`: unità per i valori non nulli di `maxTimeToOutputResponse` e `maxTimeout`.

setMaxTimeout

public void setMaxTimeout (long maxTimeout, 
                TimeUnit maxTimeUnits)

Imposta il tempo massimo consentito per il completamento della strumentazione.

Ciò consente di impostare un timeout nel caso in cui i test possano bloccarsi e non terminare mai. Questo è diverso dal normale timeout della connessione.

Per impostazione predefinita, non verrà specificato alcun timeout.

Parametri
`maxTimeout`	`long`: il periodo di tempo massimo durante il quale il comando non può restituire alcuna risposta. Un valore pari a 0 indica che il metodo attenderà per sempre (finché `receiver` non annulla l'esecuzione) l'output del comando e non genererà mai un'eccezione.
`maxTimeUnits`	`TimeUnit`: unità per i valori non nulli di `maxTimeToOutputResponse` e `maxTimeout`.

setMaxtimeToOutputResponse

public void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

Parametri
`maxTimeToOutputResponse`	`int`

setMethodName

public void setMethodName (String className, 
                String testName)

Imposta l'esecuzione solo del metodo di test specificato. Deve essere chiamato prima di "run".

Parametri
`className`	`String`: nome della classe completo (ad es. x.y.z)
`testName`	`String`: nome del metodo

setRunName

public void setRunName (String runName)

Imposta un nome di esecuzione personalizzato da comunicare a ITestRunListener il giorno run()

Se non specificato, verrà utilizzato il nome del pacchetto

setRunOptions

public void setRunOptions (String options)

Imposta le opzioni per il comando am instrument. Per l'elenco completo delle opzioni, consulta com/android/commands/am/Am.java.

Parametri
`options`	`String`

setTestCollection

public void setTestCollection (boolean collect)

Imposta questa esecuzione test sulla modalità di raccolta test. Se il valore è true, l'esecuzione del test verrà ignorata e verranno impostati tutti gli argomenti del runner appropriati necessari per una raccolta di test riuscita.

Parametri
`collect`	`boolean`

setTestPackageName

public void setTestPackageName (String packageName)

Imposta l'esecuzione di tutti i test nel pacchetto specificato. Deve essere chiamato prima di "run".

Parametri
`packageName`	`String`: nome completo del pacchetto (ad es. x.y.z)

setTestSize

public void setTestSize (IRemoteAndroidTestRunner.TestSize size)

Imposta l'esecuzione solo di test di dimensioni specifiche. Deve essere chiamato prima di "run".

Parametri
`size`	`IRemoteAndroidTestRunner.TestSize`: il `TestSize` da eseguire.

Metodi protetti

getArgsCommand

protected String getArgsCommand ()

Restituisce la sintassi completa della riga di comando di strumentazione per gli argomenti di strumentazione forniti. Restituisce una stringa vuota se non sono stati specificati argomenti.

Ritorni
`String`

getRunnerPath

protected String getRunnerPath ()

Restituisce il percorso completo del componente di strumentazione.

Ritorni
`String`