W 2026 r., aby dostosować się do naszego modelu stabilnego rozwoju trunk i zapewnić stabilność platformy w ekosystemie, będziemy publikować kod źródłowy w AOSP w drugim i czwartym kwartale. Do tworzenia i współtworzenia AOSP używaj gałęzi android-latest-release. Gałąź manifestu android-latest-release będzie zawsze odwoływać się do najnowszej wersji przesłanej do AOSP. Więcej informacji znajdziesz w artykule Zmiany w AOSP.

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

GTestBase

public abstract class GTestBase
extends Object implements IAbiReceiver, IConfigurationReceiver, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestCollector, ITestFilterReceiver

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

Znane bezpośrednie podklasy

GTest, HostGTest

GTest	Test, który uruchamia natywny pakiet testowy na danym urządzeniu.
HostGTest	Test, który uruchamia natywny pakiet testowy.

Znane podklasy pośrednie

ArtGTest

Klasa bazowa gTest

Podsumowanie

Stałe
`String`	`FILTER_EXTENSION`
`String`	`GTEST_FLAG_FILE`
`String`	`GTEST_FLAG_FILTER`
`String`	`GTEST_FLAG_LIST_TESTS`
`String`	`GTEST_FLAG_PRINT_TIME`
`String`	`GTEST_FLAG_RUN_DISABLED_TESTS`
`String`	`GTEST_XML_OUTPUT`

Konstruktory publiczne
`GTestBase()`

Metody publiczne
`void`	`addAllExcludeFilters(Set<String> filters)` Dodaje `Set` filtrów określających, które testy mają zostać wykluczone.
`void`	`addAllIncludeFilters(Set<String> filters)` Dodaje `Set` filtrów, które określają, jakie testy mają być uwzględnione.
`void`	`addExcludeFilter(String filter)` Dodaje filtr określający, które testy mają zostać wykluczone.
`void`	`addIncludeFilter(String filter)` Dodaje filtr określający, które testy mają być uwzględnione.
`String`	`cleanFilter(String filter)`
`void`	`clearExcludeFilters()` Usuń wszystkie obecnie śledzone filtry wykluczeń.
`void`	`clearIncludeFilters()` Usuń wszystkie obecnie śledzone filtry uwzględniania.
`IAbi`	`getAbi()`
`List<String>`	`getAfterTestCmd()` Pobiera polecenia powłoki do uruchomienia po GTest.
`List<String>`	`getBeforeTestCmd()` Pobiera polecenia powłoki do uruchomienia przed GTest.
`Set<String>`	`getExcludeFilters()` Zwraca bieżącą `Set` filtrów wykluczeń.
`Set<String>`	`getFileExclusionFilterRegex()` Pobiera wyrażenie regularne, aby wykluczyć niektóre pliki z wykonywania.
`List<String>`	`getGTestFlags()` Pobiera dodatkowe wartości flag, które mają być przekazywane do polecenia powłoki testu natywnego.
`Set<String>`	`getIncludeFilters()` Zwraca bieżącą `Set` filtrów uwzględniania.
`long`	`getMaxTestTimeMs()` Pobiera maksymalny czas działania testu GTest.
`String`	`getModuleName()` Uruchom moduł testowy Androida.
`boolean`	`getRunDisabledTests()` Określa, czy GTest ma uruchamiać wyłączone testy.
`long`	`getRuntimeHint()` Zwraca oczekiwany czas działania testu w milisekundach.
`int`	`getShardCount()` Zwraca bieżącą liczbę fragmentów.
`int`	`getShardIndex()` Pobiera indeks fragmentu tego testu.
`String`	`getTestFilterKey()` Pobiera klucz filtra testowego.
`String`	`getTestModule()` Pobiera nazwę modułu.
`boolean`	`isCollectTestsOnly()` Określa, czy wywoływać tylko plik binarny testu w celu zebrania listy odpowiednich przypadków testowych.
`boolean`	`isEnableXmlOutput()` Określa, czy do wyników testów ma być używane wyjście XML gtest.
`boolean`	`isSharded()` Pobiera flagę isSharded.
`void`	`notifyTestExecution(boolean incompleteTestFound, Set<String> failedTests)` Powiadamianie rodzica o wykonaniu testu, aby można było prawidłowo obsługiwać filtry włączania/wykluczania w przypadku ponownych prób.
`void`	`setAbi(IAbi abi)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Włącza lub wyłącza tryb zbierania testów
`void`	`setConfiguration(IConfiguration configuration)` Wstawia używaną wartość `IConfiguration`.
`void`	`setModuleName(String moduleName)` Ustaw moduł testowy natywnych reklam na Androida, aby go uruchomić.
`void`	`setShardCount(int shardCount)` Ustawia liczbę fragmentów tego testu.
`void`	`setShardIndex(int shardIndex)` Ustawia indeks fragmentu tego testu.
`Collection<IRemoteTest>`	`split(int shardCountHint)` Alternatywna wersja `split()`, która podaje też liczbę fragmentów, które mają zostać uruchomione.

Metody chronione
`String`	`convertName(String gtestFlagName)`
`String`	`createFlagFile(String filter)` Utwórz plik zawierający filtry, które będą używane za pomocą flagi --gtest_flagfile, aby uniknąć ograniczeń systemu operacyjnego dotyczących rozmiaru argumentów.
`void`	`erasePrependedFileName(Set<String> filters, String filename)`
`String`	`getAllGTestFlags(String path)` Funkcja pomocnicza do pobierania wszystkich flag GTest, które można przekazać do polecenia powłoki adb.
`IConfiguration`	`getConfiguration()` Zwraca konfigurację testu.
`String`	`getExceptionMessage(Exception e)` Spróbuj pobrać odpowiedni krótki opis dla danego`Exception`
`String`	`getGTestCmdLine(String fullPath, String flags)` Metoda pomocnicza do tworzenia polecenia gtest do uruchomienia.
`String`	`getGTestCmdLineWrapper(String fullPath, String flags)` Klasa pomocnicza, która umożliwia klasom pochodnym opakowanie polecenia gtest w inne narzędzie (chroot, strace, gdb itp.).
`String`	`getGTestFilters(String path)` Funkcja pomocnicza do pobierania filtra testu g-test do uruchomienia.
`ITestInvocationListener`	`getGTestListener(ITestInvocationListener... listeners)` Zwraca GTestListener, który zawiera dodatkowe informacje do debugowania, np. wykrywa i zgłasza zduplikowane testy, jeśli mDisabledDuplicateCheck ma wartość false.
`abstract String`	`loadFilter(String path)` Zdefiniuj metodę pobierania filtra.
`void`	`setRunDisabled(boolean runDisabled)` Określa, czy GTest ma uruchamiać wyłączone testy.

Stałe

FILTER_EXTENSION

protected static final String FILTER_EXTENSION

Wartość stała: ".filter"

GTEST_FLAG_FILE

protected static final String GTEST_FLAG_FILE

Wartość stała: "--gtest_flagfile"

GTEST_FLAG_FILTER

protected static final String GTEST_FLAG_FILTER

Wartość stała: "--gtest_filter"

GTEST_FLAG_LIST_TESTS

protected static final String GTEST_FLAG_LIST_TESTS

Wartość stała: "--gtest_list_tests"

GTEST_FLAG_PRINT_TIME

protected static final String GTEST_FLAG_PRINT_TIME

Wartość stała: "--gtest_print_time"

GTEST_FLAG_RUN_DISABLED_TESTS

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

Wartość stała: "--gtest_also_run_disabled_tests"

GTEST_XML_OUTPUT

protected static final String GTEST_XML_OUTPUT

Wartość stała: "--gtest_output=xml:%s"

Konstruktory publiczne

GTestBase

public GTestBase ()

Metody publiczne

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

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

Parametry
`filters`	`Set`

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

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

Parametry
`filters`	`Set`

addExcludeFilter

public void addExcludeFilter (String filter)

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

Parametry
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

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

Parametry
`filter`	`String`

cleanFilter

public String cleanFilter (String filter)

Parametry
`filter`	`String`

Zwraca
`String`

clearExcludeFilters

public void clearExcludeFilters ()

Usuń wszystkie obecnie śledzone filtry wykluczeń.

clearIncludeFilters

public void clearIncludeFilters ()

Usuń wszystkie obecnie śledzone filtry uwzględniania.

getAbi

public IAbi getAbi ()

Zwraca
`IAbi`

getAfterTestCmd

public List<String> getAfterTestCmd ()

Pobiera polecenia powłoki do uruchomienia po GTest.

Zwraca
`List<String>`

getBeforeTestCmd

public List<String> getBeforeTestCmd ()

Pobiera polecenia powłoki do uruchomienia przed GTest.

Zwraca
`List<String>`

getExcludeFilters

public Set<String> getExcludeFilters ()

Zwraca bieżącą Set filtrów wykluczeń.

Zwraca
`Set<String>`

getFileExclusionFilterRegex

public Set<String> getFileExclusionFilterRegex ()

Pobiera wyrażenie regularne, aby wykluczyć niektóre pliki z wykonywania.

Zwraca
`Set<String>`

getGTestFlags

public List<String> getGTestFlags ()

Pobiera dodatkowe wartości flag, które mają być przekazywane do polecenia powłoki testu natywnego.

Zwraca
`List<String>`

getIncludeFilters

public Set<String> getIncludeFilters ()

Zwraca bieżącą Set filtrów uwzględniania.

Zwraca
`Set<String>`

getMaxTestTimeMs

public long getMaxTestTimeMs ()

Pobiera maksymalny czas działania testu GTest.

Zwraca
`long`

getModuleName

public String getModuleName ()

Uruchom moduł testowy Androida.

Zwraca
`String`	nazwa natywnego modułu testowego do uruchomienia lub wartość null, jeśli nie jest ustawiona.

getRunDisabledTests

public boolean getRunDisabledTests ()

Określa, czy GTest ma uruchamiać wyłączone testy.

Zwraca
`boolean`	Wartość true, jeśli należy uruchomić wyłączone testy. W przeciwnym razie wartość false.

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.

Zwraca
`long`

getShardCount

public int getShardCount ()

Zwraca bieżącą liczbę fragmentów.

Zwraca
`int`

getShardIndex

public int getShardIndex ()

Pobiera indeks fragmentu tego testu.

Zwraca
`int`

getTestFilterKey

public String getTestFilterKey ()

Pobiera klucz filtra testowego.

Zwraca
`String`

getTestModule

public String getTestModule ()

Pobiera nazwę modułu.

Zwraca
`String`

isCollectTestsOnly

public boolean isCollectTestsOnly ()

Określa, czy wywoływać tylko plik binarny testu w celu zebrania listy odpowiednich przypadków testowych.

Zwraca
`boolean`

isEnableXmlOutput

public boolean isEnableXmlOutput ()

Określa, czy do wyników testów ma być używane wyjście XML gtest.

Zwraca
`boolean`

isSharded

public boolean isSharded ()

Pobiera flagę isSharded.

Zwraca
`boolean`

notifyTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                Set<String> failedTests)

Powiadamianie rodzica o wykonaniu testu, aby można było prawidłowo obsługiwać filtry włączania/wykluczania w przypadku ponownych prób.

Parametry
`incompleteTestFound`	`boolean`
`failedTests`	`Set`

setAbi

public void setAbi (IAbi abi)

Parametry
`abi`	`IAbi`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

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

setConfiguration

public void setConfiguration (IConfiguration configuration)

Wstawia używaną wartość IConfiguration.

Parametry
`configuration`	`IConfiguration`

setModuleName

public void setModuleName (String moduleName)

Ustaw moduł testowy natywnych reklam na Androida, aby go uruchomić.

Parametry
`moduleName`	`String`: nazwa natywnego modułu testowego do uruchomienia.

setShardCount

public void setShardCount (int shardCount)

Ustawia liczbę fragmentów tego testu.

Parametry
`shardCount`	`int`

setShardIndex

public void setShardIndex (int shardIndex)

Ustawia indeks fragmentu tego testu.

Parametry
`shardIndex`	`int`

podziel

public Collection<IRemoteTest> split (int shardCountHint)

Alternatywna wersja split(), która podaje też liczbę fragmentów, które mają zostać uruchomione. Jest to przydatne w przypadku niektórych programów do uruchamiania testów, które nie mogą czasami podejmować arbitralnych decyzji.

Parametry
`shardCountHint`	`int`: liczba fragmentów, których utworzenie zostało podjęte.

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

Metody chronione

convertName

protected String convertName (String gtestFlagName)

Parametry
`gtestFlagName`	`String`

Zwraca
`String`

createFlagFile

protected String createFlagFile (String filter)

Utwórz plik zawierający filtry, które będą używane za pomocą flagi --gtest_flagfile, aby uniknąć ograniczeń systemu operacyjnego dotyczących rozmiaru argumentów.

Parametry
`filter`	`String`: ciąg filtra

Zwraca
`String`	Ścieżka do pliku zawierającego filtr.

Zgłasza
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

erasePrependedFileName

protected void erasePrependedFileName (Set<String> filters, 
                String filename)

Parametry
`filters`	`Set`
`filename`	`String`

getAllGTestFlags

protected String getAllGTestFlags (String path)

Funkcja pomocnicza do pobierania wszystkich flag GTest, które można przekazać do polecenia powłoki adb.

Parametry
`path`	`String`: pełna ścieżka do pliku binarnego na urządzeniu.

Zwraca
`String`	`String` wszystkich flag GTest, które powinny zostać przekazane do GTest.

Zgłasza
`DeviceNotAvailableException`

getConfiguration

protected IConfiguration getConfiguration ()

Zwraca konfigurację testu.

Zwraca
`IConfiguration`	obiekt IConfiguration,

getExceptionMessage

protected String getExceptionMessage (Exception e)

Spróbuj pobrać odpowiednią krótką wiadomość opisową dla danego Exception

Parametry
`e`	`Exception`: `Exception`

Zwraca
`String`	krótką wiadomość,

getGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

Metoda pomocnicza do tworzenia polecenia gtest do uruchomienia.

Parametry
`fullPath`	`String`: bezwzględna ścieżka do pliku binarnego gtest w systemie plików na urządzeniu
`flags`	`String`: flagi wykonania gtest

Zwraca
`String`	wiersz poleceń powłoki do uruchomienia testu gtest,

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

Klasa pomocnicza, która umożliwia klasom pochodnym opakowanie polecenia gtest w inne narzędzie (chroot, strace, gdb i podobne).

Parametry
`fullPath`	`String`
`flags`	`String`

Zwraca
`String`

getGTestFilters

protected String getGTestFilters (String path)

Funkcja pomocnicza do pobierania filtra testu g-test do uruchomienia.

Pamiętaj, że filtry działają tylko na nazwie funkcji (np. Google Test „Test”); wszystkie „Test Cases” w Google Test będą brane pod uwagę.

Parametry
`path`	`String`: pełna ścieżka do pliku binarnego na urządzeniu.

Zwraca
`String`	pełną flagę filtra do przekazania do g-test lub pusty ciąg znaków, jeśli nie określono żadnej flagi.

Zgłasza
`DeviceNotAvailableException`

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)

Zwraca GTestListener, który zawiera dodatkowe informacje do debugowania, np. wykrywa i zgłasza zduplikowane testy, jeśli mDisabledDuplicateCheck ma wartość false. W przeciwnym razie zwraca przekazany obiekt nasłuchujący.

Parametry
`listeners`	`ITestInvocationListener`

Zwraca
`ITestInvocationListener`

loadFilter

protected abstract String loadFilter (String path)

Zdefiniuj metodę pobierania filtra.

Klasa podrzędna musi implementować sposób uzyskiwania własnego filtra.

Parametry
`path`	`String`: pełna ścieżka do pliku filtra.

Zwraca
`String`	ciąg znaków filtra.

Zgłasza
`DeviceNotAvailableException`

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

Określa, czy GTest ma uruchamiać wyłączone testy.

Parametry
`runDisabled`	`boolean`