Aby zachować zgodność z naszym modelem rozwoju gałęzi głównej i zapewnić stabilność platformy w ekosystemie, w II i IV kwartale 2026 r. opublikujemy kod źródłowy w AOSP. Do tworzenia i współtworzenia AOSP zalecamy używanie android-latest-release zamiast aosp-main. Gałąź android-latest-release manifestu zawsze będzie odnosić się do najnowszej wersji przesłanej do AOSP. Więcej informacji znajdziesz w sekcji Zmiany w AOSP.

HostTest

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

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

Znane bezpośrednie podklasy

JarHostTest

JarHostTest Uruchamiający testy JUnit po stronie hosta.

Uruchamiający testy JUnit po stronie hosta. Jeśli test do uruchomienia implementuje IDeviceTest, ten program uruchamiający przekaże odwołanie do urządzenia.

Podsumowanie

Stałe
`String`	`SET_OPTION_DESC`
`String`	`SET_OPTION_NAME`

Publiczne konstruktory
`HostTest()`

Metody publiczne
`void`	`addAllExcludeAnnotation( notAnnotations)` Dodaje `ERROR(/Set)` adnotacji do wykluczenia, jeśli test jest oznaczony tym symbolem.
`void`	`addAllExcludeFilters( filters)` Dodaje `ERROR(/Set)` filtrów, które określają, które testy mają zostać wykluczone.
`void`	`addAllIncludeAnnotation( annotations)` Dodaje `ERROR(/Set)` adnotacji do uwzględnienia, jeśli test jest oznaczony tym symbolem.
`void`	`addAllIncludeFilters( filters)` Dodaje `ERROR(/Set)` filtrów, które określają, jakie testy mają być uwzględnione.
`void`	`addExcludeAnnotation(String notAnnotation)` Dodaje adnotację do wykluczenia, jeśli testy są nią oznaczone.
`void`	`addExcludeFilter(String filter)` Dodaje filtr określający, które testy mają zostać wykluczone.
`void`	`addIncludeAnnotation(String annotation)` Dodaje adnotację, która ma być uwzględniana, jeśli test jest oznaczony tą adnotacją.
`void`	`addIncludeFilter(String filter)` Dodaje filtr określający, które testy mają być uwzględnione.
`void`	`clearExcludeAnnotations()` Usuń wszystkie aktualnie śledzone adnotacje wykluczeń.
`void`	`clearExcludeFilters()` Usuń wszystkie obecnie śledzone filtry wykluczeń.
`void`	`clearIncludeAnnotations()` Usuń wszystkie obecnie śledzone adnotacje dotyczące uwzględniania.
`void`	`clearIncludeFilters()` Usuń wszystkie obecnie śledzone filtry uwzględniania.
`int`	`countTestCases()` Zwraca liczbę przypadków testowych we wszystkich klasach wchodzących w skład testów.
`IAbi`	`getAbi()`
	`getClassNames()`
`ITestDevice`	`getDevice()` Przygotuj testowane urządzenie.
	`getExcludeAnnotations()` Zwraca bieżącą `ERROR(/Set)` adnotacji do wykluczenia.
	`getExcludeFilters()` Zwraca bieżącą `ERROR(/Set)` filtrów wykluczeń.
	`getIncludeAnnotations()` Zwraca bieżącą `ERROR(/Set)` adnotacji do uwzględnienia.
	`getIncludeFilters()` Zwraca bieżący `ERROR(/Set)` filtrów uwzględniania.
`long`	`getRuntimeHint()` Zwraca oczekiwany czas działania testu w milisekundach.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Przeprowadza testy i przekazuje wyniki odbiorcy.
`void`	`setAbi(IAbi abi)`
`void`	`setBuild(IBuildInfo buildInfo)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Włącza i wyłącza tryb zbierania testów
`void`	`setConfiguration(IConfiguration configuration)` Wstawia używany element `IConfiguration`.
`void`	`setDevice(ITestDevice device)` Wstrzyknij testowane urządzenie.
`static void`	`setOptionToLoadedObject(Object testObj, keyValueOptions)` Narzędzie pomocnicze dla modułów uruchamiających urządzenia, które umożliwia ustawianie opcji w taki sam sposób jak w przypadku HostTest, czyli za pomocą set-option.
`void`	`setTestInformation(TestInformation testInfo)`
	`split(Integer shardCount, TestInformation testInfo)` Dzielimy je według osób, w zależności od klasy testu lub metody.

Metody chronione
`HostTest`	`createHostTest(Class<?> classObj)` Pomocnik do tworzenia instancji HostTest podczas dzielenia na partycje.
`IBuildInfo`	`getBuild()` Pobierz informacje o kompilacji otrzymane przez HostTest.
`ClassLoader`	`getClassLoader()` Zwraca domyślny program wczytujący klasy.
`final`	`getClasses()`
`File`	`getJarFile(String jarName, TestInformation testInfo)` Sprawdź kilka lokalizacji, w których zwykle znajdują się artefakty w różnych przypadkach użycia, aby znaleźć nasz plik JAR.
`boolean`	`hasJUnit4Annotation(Class<?> classObj)` Funkcja pomocnicza, która określa, czy mamy do czynienia z klasą testową z adnotacjami Junit4.
`Object`	`loadObject(Class<?> classObj)` wczytać obiekt klasy i ustawić informacje testowe (urządzenie, kompilacja);
`void`	`setClassName(String className)` Wyczyść, a następnie ustaw nazwę klasy, która ma zostać uruchomiona.
`boolean`	`shouldTestRun(AnnotatedElement annotatedElement)` Sprawdź, czy elementy z adnotacjami przechodzą przez filtr.

Stałe

SET_OPTION_DESC

public static final String SET_OPTION_DESC

Stała wartość: „Opcje, które mają być przekazywane do testowanej klasy. Klucz i wartość powinny być oddzielone dwukropkiem „:”. Jeśli na przykład testowana klasa obsługuje „--iteration 1” z wiersza poleceń, należy przekazać ją jako „--set-option iteration:1” lub „--set-option iteration:key=value” w celu przekazania opcji do mapy. Wartości zawierające znaki „:” lub „=” można poprzedzić ukośnikiem. Możesz kierować reklamy na konkretną klasę, podając jej nazwę. " --set-option :

SET_OPTION_NAME

public static final String SET_OPTION_NAME

Wartość stała: "set-option"

Publiczne konstruktory

HostTest

public HostTest ()

Metody publiczne

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( notAnnotations)

Dodaje ERROR(/Set) adnotacji do wykluczenia, jeśli test jest oznaczony tym symbolem.

Parametry
`notAnnotations`

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Dodaje ERROR(/Set) filtrów, które określają, które testy mają zostać wykluczone.

Parametry
`filters`

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

Dodaje ERROR(/Set) adnotacji do uwzględnienia, jeśli test jest oznaczony tym symbolem.

Parametry
`annotations`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Dodaje ERROR(/Set) filtrów, które określają, jakie testy mają być uwzględnione.

Parametry
`filters`

addExcludeAnnotation

public void addExcludeAnnotation (String notAnnotation)

Dodaje adnotację do wykluczenia, jeśli testy są nią oznaczone.

Parametry
`notAnnotation`	`String`

addExcludeFilter

public void addExcludeFilter (String filter)

Dodaje filtr określający, które testy mają zostać wykluczone.

Parametry
`filter`	`String`

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

Dodaje adnotację, która ma być uwzględniana, jeśli test jest oznaczony tą adnotacją.

Parametry
`annotation`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Dodaje filtr określający, które testy mają być uwzględnione.

Parametry
`filter`	`String`

clearExcludeAnnotations

public void clearExcludeAnnotations ()

Usuń wszystkie aktualnie śledzone adnotacje wykluczeń.

clearExcludeFilters

public void clearExcludeFilters ()

Usuń wszystkie obecnie śledzone filtry wykluczeń.

clearIncludeAnnotations

public void clearIncludeAnnotations ()

Usuń wszystkie obecnie śledzone adnotacje dotyczące uwzględniania.

clearIncludeFilters

public void clearIncludeFilters ()

Usuń wszystkie obecnie śledzone filtry uwzględniania.

countTestCases

public int countTestCases ()

Zwraca liczbę przypadków testowych we wszystkich klasach wchodzących w skład testów.

Zwroty
`int`

getAbi

public IAbi getAbi ()

Zwroty
`IAbi`

getClassNames

public  getClassNames ()

Zwroty

getDevice

public ITestDevice getDevice ()

Przygotuj testowane urządzenie.

Zwroty
`ITestDevice`	`ITestDevice`

getExcludeAnnotations

public  getExcludeAnnotations ()

Zwraca bieżącą ERROR(/Set) adnotacji do wykluczenia.

Zwroty

getExcludeFilters

public  getExcludeFilters ()

Zwraca bieżącą ERROR(/Set) filtrów wykluczeń.

Zwroty

getIncludeAnnotations

public  getIncludeAnnotations ()

Zwraca bieżącą ERROR(/Set) adnotacji do uwzględnienia.

Zwroty

getIncludeFilters

public  getIncludeFilters ()

Zwraca bieżący ERROR(/Set) filtrów uwzględniania.

Zwroty

getRuntimeHint

public long getRuntimeHint ()

Zwraca oczekiwany czas działania testu w milisekundach. Ten czas jest używany do równoważenia obciążenia podczas wykonywania podzielonego na fragmenty.

Zwroty
`long`

home run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Przeprowadza testy i przekazuje wyniki odbiorcy.

Parametry
`testInfo`	`TestInformation`: Obiekt `TestInformation` zawierający przydatne informacje do przeprowadzania testów.
`listener`	`ITestInvocationListener`: `ITestInvocationListener` wyników testu

Zgłasza
`DeviceNotAvailableException`

setAbi

public void setAbi (IAbi abi)

Parametry
`abi`	`IAbi`

setBuild

public void setBuild (IBuildInfo buildInfo)

Parametry
`buildInfo`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Włącza i wyłącza tryb zbierania testów

setConfiguration

public void setConfiguration (IConfiguration configuration)

Wstawia używany element IConfiguration.

Parametry
`configuration`	`IConfiguration`

setDevice

public void setDevice (ITestDevice device)

Wstrzyknij testowane urządzenie.

Parametry
`device`	`ITestDevice`: `ITestDevice`, którego chcesz użyć

setOptionToLoadedObject

public static void setOptionToLoadedObject (Object testObj, 
                 keyValueOptions)

Narzędzie pomocnicze dla modułów uruchamiających urządzenia, które umożliwia ustawianie opcji w taki sam sposób jak w przypadku HostTest, czyli za pomocą set-option.

Parametry
`testObj`	`Object`: obiekt, który otrzyma opcje.
`keyValueOptions`	: lista opcji sformatowana zgodnie z wymaganiami HostTest set-option.

setTestInformation

public void setTestInformation (TestInformation testInfo)

Parametry
`testInfo`	`TestInformation`

podziel

public  split (Integer shardCount, 
                TestInformation testInfo)

Dzielimy je według osób, w zależności od klasy testu lub metody.

Parametry
`shardCount`	`Integer`: liczba fragmentów, które próbowano utworzyć.
`testInfo`	`TestInformation`: Reklamodawca `TestInformation`

Zwroty
	zbiór podtestów do wykonania osobno lub `null`, jeśli test nie jest obecnie podzielony na części.

Metody chronione

createHostTest

protected HostTest createHostTest (Class<?> classObj)

Pomocnik do tworzenia instancji HostTest podczas dzielenia na partycje. Zastąpienie, aby zwrócić dowolny element podrzędny z HostTest.

Parametry
`classObj`	`Class`

Zwroty
`HostTest`

getBuild

protected IBuildInfo getBuild ()

Pobierz informacje o kompilacji otrzymane przez HostTest.

Zwroty
`IBuildInfo`	`IBuildInfo`

getClassLoader

protected ClassLoader getClassLoader ()

Zwraca domyślny program wczytujący klasy.

Zwroty
`ClassLoader`

getClasses

protected final  getClasses ()

Zwroty

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

Sprawdź kilka lokalizacji, w których zwykle znajdują się artefakty w różnych przypadkach użycia, aby znaleźć nasz plik JAR.

Parametry
`jarName`	`String`
`testInfo`	`TestInformation`

Zwroty
`File`

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

Pomocnik, który określa, czy mamy do czynienia z klasą testową z adnotacjami Junit4.

Parametry
`classObj`	`Class`

Zwroty
`boolean`

loadObject

protected Object loadObject (Class<?> classObj)

wczytać obiekt klasy i ustawić informacje testowe (urządzenie, kompilacja);

Parametry
`classObj`	`Class`

Zwroty
`Object`

setClassName

protected void setClassName (String className)

Wyczyść, a następnie ustaw nazwę klasy, która ma zostać uruchomiona.

Parametry
`className`	`String`

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

Sprawdź, czy elementy z adnotacjami przechodzą przez filtr. Udostępniony do testów jednostkowych.

Zwroty
`boolean`	wartość „false”, jeśli test nie powinien być uruchomiony.