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.

HostTest

public class HostTest
extends Object implements IAbiReceiver, IBuildReceiver, IConfigurationReceiver, IDeviceTest, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

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

Classi di sottoclasse dirette note

JarHostTest

JarHostTest Test runner per i test JUnit lato host.

Un programma di esecuzione dei test per i test basati su host JUnit. Se il test da eseguire implementa IDeviceTest questo runner passerà un riferimento al dispositivo.

Riepilogo

Campi
`public static final String`	`SET_OPTION_DESC`
`public static final String`	`SET_OPTION_NAME`

Costruttori pubblici
`HostTest()`

Metodi pubblici
`void`	`addAllExcludeAnnotation( notAnnotations)` Aggiunge un `ERROR(/Set)` di annotazioni da escludere se un test è contrassegnato.
`void`	`addAllExcludeFilters( filters)` Aggiunge il `ERROR(/Set)` dei filtri di cui escludere i test.
`void`	`addAllIncludeAnnotation( annotations)` Aggiunge un `ERROR(/Set)` di annotazioni da includere se un test è contrassegnato.
`void`	`addAllIncludeFilters( filters)` Aggiunge il `ERROR(/Set)` dei filtri di cui includere i test.
`void`	`addExcludeAnnotation(String notAnnotation)` Aggiunge un'annotazione da escludere se un test è contrassegnato.
`void`	`addExcludeFilter(String filter)` Aggiunge un filtro per i test da escludere.
`void`	`addIncludeAnnotation(String annotation)` Aggiunge un'annotazione da includere se un test è contrassegnato.
`void`	`addIncludeFilter(String filter)` Aggiunge un filtro per i test da includere.
`void`	`clearExcludeAnnotations()` Elimina tutte le annotazioni di esclusione attualmente monitorate.
`void`	`clearExcludeFilters()` Elimina tutti i filtri di esclusione attualmente monitorati.
`void`	`clearIncludeAnnotations()` Elimina tutte le annotazioni include attualmente monitorate.
`void`	`clearIncludeFilters()` Elimina tutti i filtri di inclusione attualmente monitorati.
`int`	`countTestCases()` Restituisce il numero di casi di test in tutte le classi che fanno parte dei test
`IAbi`	`getAbi()`
	`getClassNames()`
`ITestDevice`	`getDevice()` Ottieni il dispositivo di test.
	`getExcludeAnnotations()` Restituisce l'`ERROR(/Set)` corrente delle annotazioni da escludere.
	`getExcludeFilters()` Restituisce l'`ERROR(/Set)` corrente dei filtri di esclusione.
	`getIncludeAnnotations()` Restituisce l'`ERROR(/Set)` corrente delle annotazioni da includere.
	`getIncludeFilters()` Restituisce l'`ERROR(/Set)` corrente dei filtri di inclusione.
`long`	`getRuntimeHint()` Restituisce il tempo di esecuzione previsto del test in millisecondi.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Esegue i test e segnala il risultato all'ascoltatore.
`void`	`setAbi(IAbi abi)`
`void`	`setBuild(IBuildInfo buildInfo)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Attiva o disattiva la modalità di raccolta dei test
`void`	`setConfiguration(IConfiguration configuration)` Invia il `IConfiguration` in uso.
`void`	`setDevice(ITestDevice device)` Esegui l'iniezione del dispositivo di test.
`static void`	`setOptionToLoadedObject(Object testObj, keyValueOptions)` Elemento di supporto per gli utenti di Device Runners da utilizzare per impostare le opzioni nello stesso modo di HostTest, da set-option.
`void`	`setTestInformation(TestInformation testInfo)`
	`split(Integer shardCount, TestInformation testInfo)` La suddivisione avviene in base al singolo utente, al metodo o alla classe di test.

Metodi protetti
`HostTest`	`createHostTest(Class<?> classObj)` Elemento di supporto per la creazione di un'istanza HostTest durante lo sharding.
`IBuildInfo`	`getBuild()` Ricevi le informazioni sulla compilazione ricevute da HostTest.
`ClassLoader`	`getClassLoader()` Restituisce il caricatore di classi predefinito.
`final`	`getClasses()`
`File`	`getJarFile(String jarName, TestInformation testInfo)` Controlla diverse posizioni in cui si trovano di solito gli elementi per casi d'uso diversi per trovare il nostro file jar.
`boolean`	`hasJUnit4Annotation(Class<?> classObj)` Helper per determinare se abbiamo a che fare con una classe di test con annotazioni Junit4.
`Object`	`loadObject(Class<?> classObj)` Carica l'oggetto della classe e imposta le informazioni del test (dispositivo, build).
`void`	`setClassName(String className)` Cancella e imposta un nome di classe da eseguire.
`boolean`	`shouldTestRun(AnnotatedElement annotatedElement)` Controlla se un elemento con annotazioni supera il filtro.

Campi

SET_OPTION_DESC

public static final String SET_OPTION_DESC

SET_OPTION_NAME

public static final String SET_OPTION_NAME

Costruttori pubblici

HostTest

public HostTest ()

Metodi pubblici

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( notAnnotations)

Aggiunge un ERROR(/Set) di annotazioni da escludere se un test è contrassegnato.

Parametri
`notAnnotations`

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Aggiunge il ERROR(/Set) dei filtri di cui escludere i test.

Parametri
`filters`

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

Aggiunge un ERROR(/Set) di annotazioni da includere se un test è contrassegnato.

Parametri
`annotations`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Aggiunge il ERROR(/Set) dei filtri di cui includere i test.

Parametri
`filters`

addExcludeAnnotation

public void addExcludeAnnotation (String notAnnotation)

Aggiunge un'annotazione da escludere se un test è contrassegnato.

Parametri
`notAnnotation`	`String`

addExcludeFilter

public void addExcludeFilter (String filter)

Aggiunge un filtro per i test da escludere.

Parametri
`filter`	`String`

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

Aggiunge un'annotazione da includere se un test è contrassegnato.

Parametri
`annotation`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Aggiunge un filtro per i test da includere.

Parametri
`filter`	`String`

clearExcludeAnnotations

public void clearExcludeAnnotations ()

Elimina tutte le annotazioni di esclusione attualmente monitorate.

clearExcludeFilters

public void clearExcludeFilters ()

Elimina tutti i filtri di esclusione attualmente monitorati.

clearIncludeAnnotations

public void clearIncludeAnnotations ()

Elimina tutte le annotazioni include attualmente monitorate.

clearIncludeFilters

public void clearIncludeFilters ()

Elimina tutti i filtri di inclusione attualmente monitorati.

countTestCases

public int countTestCases ()

Restituisce il numero di casi di test in tutte le classi che fanno parte dei test

Ritorni
`int`

getAbi

public IAbi getAbi ()

Ritorni
`IAbi`

getClassNames

public  getClassNames ()

Ritorni

getDevice

public ITestDevice getDevice ()

Ottieni il dispositivo di test.

Ritorni
`ITestDevice`	`ITestDevice`

getExcludeAnnotations

public  getExcludeAnnotations ()

Restituisce l'ERROR(/Set) corrente delle annotazioni da escludere.

Ritorni

getExcludeFilters

public  getExcludeFilters ()

Restituisce l'ERROR(/Set) corrente dei filtri di esclusione.

Ritorni

getIncludeAnnotations

public  getIncludeAnnotations ()

Restituisce l'ERROR(/Set) corrente delle annotazioni da includere.

Ritorni

getIncludeFilters

public  getIncludeFilters ()

Restituisce l'ERROR(/Set) corrente dei filtri di inclusione.

Ritorni

getRuntimeHint

public long getRuntimeHint ()

Restituisce il tempo di esecuzione previsto del test in millisecondi. Il tempo viene utilizzato per bilanciare il carico dell'esecuzione suddivisa in parti

Ritorni
`long`

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`

setBuild

public void setBuild (IBuildInfo buildInfo)

Parametri
`buildInfo`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Attiva o disattiva la modalità di raccolta dei test

setConfiguration

public void setConfiguration (IConfiguration configuration)

Invia il IConfiguration in uso.

Parametri
`configuration`	`IConfiguration`

setDevice

public void setDevice (ITestDevice device)

Esegui l'iniezione del dispositivo di test.

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

setOptionToLoadedObject

public static void setOptionToLoadedObject (Object testObj, 
                 keyValueOptions)

Elemento di supporto per gli utenti di Device Runners da utilizzare per impostare le opzioni nello stesso modo di HostTest, da set-option.

Parametri
`testObj`	`Object`: l'oggetto che riceverà le opzioni.
`keyValueOptions`	: l'elenco di opzioni formattato come richiesto da set-option HostTest.

setTestInformation

public void setTestInformation (TestInformation testInfo)

Parametri
`testInfo`	`TestInformation`

suddivisione

public  split (Integer shardCount, 
                TestInformation testInfo)

La suddivisione avviene in base al singolo utente, al metodo o alla classe di test.

Parametri
`shardCount`	`Integer`: il numero di tentativi di shard.
`testInfo`	`TestInformation`: l'elemento principale `TestInformation`

Ritorni
	una raccolta di sottotesti da eseguire separatamente o `null` se il test non è attualmente suddivisibile in parti

Metodi protetti

createHostTest

protected HostTest createHostTest (Class<?> classObj)

Elemento di supporto per la creazione di un'istanza HostTest durante lo sharding. Sostituzione per restituire qualsiasi elemento figlio da HostTest.

Parametri
`classObj`	`Class`

Ritorni
`HostTest`

getBuild

protected IBuildInfo getBuild ()

Ricevi le informazioni sulla compilazione ricevute da HostTest.

Ritorni
`IBuildInfo`	`IBuildInfo`

getClassLoader

protected ClassLoader getClassLoader ()

Restituisce il caricatore di classi predefinito.

Ritorni
`ClassLoader`

getClasses

protected final  getClasses ()

Ritorni

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

Controlla diverse posizioni in cui si trovano di solito gli elementi per casi d'uso diversi per trovare il nostro file jar.

Parametri
`jarName`	`String`
`testInfo`	`TestInformation`

Ritorni
`File`

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

Helper per determinare se abbiamo a che fare con una classe di test con annotazioni Junit4.

Parametri
`classObj`	`Class`

Ritorni
`boolean`

loadObject

protected Object loadObject (Class<?> classObj)

Carica l'oggetto della classe e imposta le informazioni del test (dispositivo, build).

Parametri
`classObj`	`Class`

Ritorni
`Object`

setClassName

protected void setClassName (String className)

Cancella e imposta un nome di classe da eseguire.

Parametri
`className`	`String`

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

Controlla se un elemento con annotazioni supera il filtro. Esposto per i test delle unità.

Ritorni
`boolean`	false se il test non deve essere eseguito.