A partire dal 2026, per allinearci al nostro modello di sviluppo trunk stabile e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per compilare e contribuire ad AOSP, utilizza android-latest-release. Il branch del manifest android-latest-release farà sempre riferimento alla release più recente pubblicata su AOSP. Per saperne di più, consulta la sezione Modifiche ad AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

UiAutomatorTest

public class UiAutomatorTest
extends Object implements IDeviceTest, IRemoteTest, ITestFilterReceiver

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

Riepilogo

Campi
`protected Collection<ITestLifeCycleReceiver>`	`mListeners`

Costruttori pubblici
`UiAutomatorTest()`

Metodi pubblici
`void`	`addAllExcludeFilters(Set<String> filters)` Aggiunge il `Set` dei filtri dei test da escludere.
`void`	`addAllIncludeFilters(Set<String> filters)` Aggiunge il `Set` dei filtri dei test da includere.
`void`	`addClassName(String className)` Aggiungi un nome di classe di test da eseguire.
`void`	`addClassNames(Collection<String> classNames)` Aggiungi una raccolta di nomi di classi di test da eseguire.
`void`	`addExcludeFilter(String filter)` Aggiunge un filtro per i test da escludere.
`void`	`addIncludeFilter(String filter)` Aggiunge un filtro per i test da includere.
`void`	`addRunArg(String key, String value)` Aggiungi un argomento da fornire durante l'esecuzione dei test UI Automator
`void`	`clearExcludeFilters()` Elimina tutti i filtri di esclusione attualmente monitorati.
`void`	`clearIncludeFilters()` Elimina tutti i filtri di inclusione attualmente monitorati.
`List<String>`	`getClassNames()` Recupera l'elenco dei nomi delle classi di test configurate per l'esecuzione
`ITestDevice`	`getDevice()` Ottieni il dispositivo in fase di test.
`Set<String>`	`getExcludeFilters()` Restituisce l'attuale `Set` dei filtri di esclusione.
`Set<String>`	`getIncludeFilters()` Restituisce l'`Set` corrente dei filtri di inclusione.
`long`	`getSyncTime()`
`List<String>`	`getTestJarPaths()`
`Map<String, String>`	`getTestRunArgMap()`
`IRemoteAndroidTestRunner`	`getTestRunner()`
`boolean`	`isInstrumentationTest()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Esegue i test e comunica il risultato al listener.
`void`	`setCaptureLogs(boolean captureLogs)` Questo metodo è obsoleto. utilizza invece `setLoggingOption(LoggingOption)`. Mantenuto per la compatibilità con cts-tradefed
`void`	`setDevice(ITestDevice device)` Inserisci il dispositivo in fase di test.
`void`	`setLoggingOption(UiAutomatorTest.LoggingOption loggingOption)`
`void`	`setRunName(String runName)`
`void`	`setRunnerName(String runnerName)`
`void`	`setSyncTime(long syncTime)`
`void`	`setTestJarPaths(List<String> jarPaths)`
`void`	`setTestRunArgMap(Map<String, String> runArgMap)`

Metodi protetti
`IRemoteAndroidTestRunner`	`createTestRunner()`
`IRunUtil`	`getRunUtil()`
`void`	`onScreenshotAndBugreport(ITestDevice device, ITestInvocationListener listener, String prefix, UiAutomatorTest.TestFailureAction overrideAction)`
`void`	`onScreenshotAndBugreport(ITestDevice device, ITestInvocationListener listener, String prefix)`
`void`	`preTestSetup()` Verifica se i componenti di UI Automator sono presenti sul dispositivo

Campi

mListeners

protected Collection<ITestLifeCycleReceiver> mListeners

Costruttori pubblici

UiAutomatorTest

public UiAutomatorTest ()

Metodi pubblici

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

Aggiunge il Set dei filtri dei test da escludere.

Parametri
`filters`	`Set`

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

Aggiunge il Set dei filtri dei test da includere.

Parametri
`filters`	`Set`

addClassName

public void addClassName (String className)

Aggiungi un nome di classe di test da eseguire.

Parametri
`className`	`String`

addClassNames

public void addClassNames (Collection<String> classNames)

Aggiungi una raccolta di nomi di classi di test da eseguire.

Parametri
`classNames`	`Collection`

addExcludeFilter

public void addExcludeFilter (String filter)

Aggiunge un filtro per i test da escludere.

Parametri
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Aggiunge un filtro per i test da includere.

Parametri
`filter`	`String`

addRunArg

public void addRunArg (String key, 
                String value)

Aggiungi un argomento da fornire durante l'esecuzione dei test UI Automator

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

clearExcludeFilters

public void clearExcludeFilters ()

Elimina tutti i filtri di esclusione attualmente monitorati.

clearIncludeFilters

public void clearIncludeFilters ()

Elimina tutti i filtri di inclusione attualmente monitorati.

getClassNames

public List<String> getClassNames ()

Recupera l'elenco dei nomi delle classi di test configurate per l'esecuzione

Resi
`List<String>`	elenco dei nomi delle classi di test

getDevice

public ITestDevice getDevice ()

Ottieni il dispositivo in fase di test.

Resi
`ITestDevice`	`ITestDevice`

getExcludeFilters

public Set<String> getExcludeFilters ()

Restituisce l'attuale Set dei filtri di esclusione.

Resi
`Set<String>`

getIncludeFilters

public Set<String> getIncludeFilters ()

Restituisce l'Set corrente dei filtri di inclusione.

Resi
`Set<String>`

getSyncTime

public long getSyncTime ()

Resi
`long`	il tempo assegnato per la sincronizzazione dei test.

getTestJarPaths

public List<String> getTestJarPaths ()

Resi
`List<String>`	il percorso del file JAR di test.

getTestRunArgMap

public Map<String, String> getTestRunArgMap ()

Resi
`Map<String, String>`	la mappa degli argomenti da passare a UiAutomatorRunner.

getTestRunner

public IRemoteAndroidTestRunner getTestRunner ()

Resi
`IRemoteAndroidTestRunner`	l'esecutore test.

isInstrumentationTest

public boolean isInstrumentationTest ()

Resi
`boolean`

run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Esegue i test e comunica il risultato al listener.

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

Genera
`DeviceNotAvailableException`

setCaptureLogs

public void setCaptureLogs (boolean captureLogs)

Questo metodo è obsoleto.
utilizza invece setLoggingOption(LoggingOption).

Mantenuto per la compatibilità con cts-tradefed

Parametri
`captureLogs`	`boolean`

setDevice

public void setDevice (ITestDevice device)

Inserisci il dispositivo in fase di test.

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

setLoggingOption

public void setLoggingOption (UiAutomatorTest.LoggingOption loggingOption)

Parametri
`loggingOption`	`UiAutomatorTest.LoggingOption`

setRunName

public void setRunName (String runName)

Parametri
`runName`	`String`

setRunnerName

public void setRunnerName (String runnerName)

Parametri
`runnerName`	`String`

setSyncTime

public void setSyncTime (long syncTime)

Parametri
`syncTime`	`long`: il tempo necessario per sincronizzare i file di test.

setTestJarPaths

public void setTestJarPaths (List<String> jarPaths)

Parametri
`jarPaths`	`List`: le posizioni dei file JAR di test.

setTestRunArgMap

public void setTestRunArgMap (Map<String, String> runArgMap)

Parametri
`runArgMap`	`Map`: gli argomenti da passare a UiAutomatorRunner.

Metodi protetti

createTestRunner

protected IRemoteAndroidTestRunner createTestRunner ()

Resi
`IRemoteAndroidTestRunner`

Genera
`DeviceNotAvailableException`

getRunUtil

protected IRunUtil getRunUtil ()

Resi
`IRunUtil`

onScreenshotAndBugreport

protected void onScreenshotAndBugreport (ITestDevice device, 
                ITestInvocationListener listener, 
                String prefix, 
                UiAutomatorTest.TestFailureAction overrideAction)

Parametri
`device`	`ITestDevice`
`listener`	`ITestInvocationListener`
`prefix`	`String`
`overrideAction`	`UiAutomatorTest.TestFailureAction`

onScreenshotAndBugreport

protected void onScreenshotAndBugreport (ITestDevice device, 
                ITestInvocationListener listener, 
                String prefix)

Parametri
`device`	`ITestDevice`
`listener`	`ITestInvocationListener`
`prefix`	`String`

preTestSetup

protected void preTestSetup ()

Verifica se i componenti di UI Automator sono presenti sul dispositivo

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`