Od 27 marca 2025 r. zalecamy używanie android-latest-release zamiast aosp-main do kompilowania i wspołtworzenia AOSP. Więcej informacji znajdziesz w artykule o zmianach w AOSP.

Ta strona została przetłumaczona przez Cloud Translation API.

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 testów na danym urządzeniu.
HostGTest	Test, który uruchamia natywny pakiet testowy.

Znane podklasy pośrednie

ArtGTest

Klasa bazowa gTest

Podsumowanie

Fieldsem
`protected static final String`	`FILTER_EXTENSION`
`protected static final String`	`GTEST_FLAG_FILE`
`protected static final String`	`GTEST_FLAG_FILTER`
`protected static final String`	`GTEST_FLAG_LIST_TESTS`
`protected static final String`	`GTEST_FLAG_PRINT_TIME`
`protected static final String`	`GTEST_FLAG_RUN_DISABLED_TESTS`
`protected static final String`	`GTEST_XML_OUTPUT`

Konstruktory publiczne
`GTestBase()`

Metody publiczne
`void`	`addAllExcludeFilters( filters)` Dodaje `ERROR(/Set)` filtrów, które testy mają być wykluczone.
`void`	`addAllIncludeFilters( filters)` Dodaje `ERROR(/Set)` filtrów, których testy mają być uwzględnione.
`void`	`addExcludeFilter(String filter)` Dodaje filtr, który określa, które testy mają być wykluczone.
`void`	`addIncludeFilter(String filter)` Dodaje filtr określający, które testy mają być uwzględnione.
`String`	`cleanFilter(String filter)`
`void`	`clearExcludeFilters()` usunąć wszystkie filtry wykluczeń, które są obecnie śledzone;
`void`	`clearIncludeFilters()` Usuń wszystkie filtry uwzględniania, które są obecnie śledzone.
`IAbi`	`getAbi()`
	`getAfterTestCmd()` Pobiera polecenia powłoki do uruchomienia po GTest.
	`getBeforeTestCmd()` Pobiera polecenia powłoki do wykonania przed GTest.
	`getExcludeFilters()` Zwraca bieżącą `ERROR(/Set)` filtrów wykluczeń.
	`getFileExclusionFilterRegex()` Pobiera wyrażenie regularne, aby wykluczyć uruchamianie niektórych plików.
	`getGTestFlags()` Pobiera dodatkowe wartości flagi, które mają zostać przekazane do polecenia powłoki testu natywnego.
	`getIncludeFilters()` Zwraca bieżącą wartość `ERROR(/Set)` filtrów uwzględniania.
`long`	`getMaxTestTimeMs()` Pobiera maksymalny czas działania testu gtest.
`String`	`getModuleName()` Uruchom moduł testów natywnych aplikacji na Androida.
`boolean`	`getRunDisabledTests()` Określ, 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()` Wywołuje tylko testowy plik binarny, aby zebrać listę odpowiednich przypadków testowych.
`boolean`	`isEnableXmlOutput()` Ustawienie określające, czy do wyników testów ma być używany format XML gtest.
`boolean`	`isSharded()` Pobiera flagę isSharded.
`void`	`notifyTestExecution(boolean incompleteTestFound, failedTests)` Poinformuj rodzica o wykonywaniu testu, aby filtry uwzględniania/wykluczania mogły być prawidłowo obsługiwane w przypadku prób ponownego wykonania.
`void`	`setAbi(IAbi abi)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Włącza lub wyłącza tryb testowy zbierania danych
`void`	`setConfiguration(IConfiguration configuration)` Wstrzykuje `IConfiguration` w użyciu.
`void`	`setModuleName(String moduleName)` Ustaw do uruchomienia natywny moduł testowy Androida.
`void`	`setShardCount(int shardCount)` Ustawia liczbę fragmentów tego testu.
`void`	`setShardIndex(int shardIndex)` Ustawia indeks fragmentu tego testu.
	`split(int shardCountHint)` Alternatywna wersja `split()`, która zawiera również parametr shardCount, który próbuje się uruchomić.

Chronione metody
`String`	`convertName(String gtestFlagName)`
`String`	`createFlagFile(String filter)` Aby uniknąć ograniczeń systemu operacyjnego dotyczących rozmiaru argumentów, utwórz plik zawierający filtry, które będą używane za pomocą opcji --gtest_flagfile.
`void`	`erasePrependedFileName( filters, String filename)`
`String`	`getAllGTestFlags(String path)` Narzędzie pomocnicze do pobierania wszystkich flag GTest do przekazania do polecenia adb shell.
`IConfiguration`	`getConfiguration()` Zwraca konfigurację testu.
`String`	`getExceptionMessage(Exception e)` Dołożyć wszelkich starań, aby pobrać krótki, treściwy komunikat dla danego `Exception`
`String`	`getGTestCmdLine(String fullPath, String flags)` Metoda pomocnicza do tworzenia polecenia gtest do uruchomienia.
`String`	`getGTestCmdLineWrapper(String fullPath, String flags)` Pomocnik, który umożliwia klasom pochodnym owinięcie polecenia gtest w ramach innego narzędzia (chroot, strace, gdb itp.).
`String`	`getGTestFilters(String path)` Funkcja pomocnicza do uzyskiwania filtra g-testu testu do uruchomienia.
`ITestInvocationListener`	`getGTestListener(ITestInvocationListener... listeners)` Zwraca obiekt GTestListener, który udostępnia dodatkowe informacje debugowania, takie jak wykrywanie i zgłaszanie zduplikowanych testów, jeśli mDisabledDuplicateCheck ma wartość false.
`abstract String`	`loadFilter(String path)` Zdefiniuj metodę filtrowania get.
`void`	`setRunDisabled(boolean runDisabled)` Określ, czy GTest ma uruchamiać wyłączone testy.

Fieldsem

FILTER_EXTENSION

protected static final String FILTER_EXTENSION

GTEST_FLAG_FILE

protected static final String GTEST_FLAG_FILE

GTEST_FLAG_FILTER

protected static final String GTEST_FLAG_FILTER

GTEST_FLAG_LIST_TESTS

protected static final String GTEST_FLAG_LIST_TESTS

GTEST_FLAG_PRINT_TIME

protected static final String GTEST_FLAG_PRINT_TIME

GTEST_FLAG_RUN_DISABLED_TESTS

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

GTEST_XML_OUTPUT

protected static final String GTEST_XML_OUTPUT

Konstruktory publiczne

GTestBase

public GTestBase ()

Metody publiczne

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Dodaje ERROR(/Set) filtrów, które testy mają być wykluczone.

Parametry
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Dodaje ERROR(/Set) filtrów, których testy mają być uwzględnione.

Parametry
`filters`

addExcludeFilter

public void addExcludeFilter (String filter)

Dodaje filtr, który określa, które testy mają być 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`

Zwroty
`String`

clearExcludeFilters

public void clearExcludeFilters ()

usunąć wszystkie filtry wykluczeń, które są obecnie śledzone;

clearIncludeFilters

public void clearIncludeFilters ()

Usuń wszystkie filtry uwzględniania, które są obecnie śledzone.

getAbi

public IAbi getAbi ()

Zwroty
`IAbi`

getAfterTestCmd

public  getAfterTestCmd ()

Pobiera polecenia powłoki do uruchomienia po GTest.

Zwroty

getBeforeTestCmd

public  getBeforeTestCmd ()

Pobiera polecenia powłoki do wykonania przed GTest.

Zwroty

getExcludeFilters

public  getExcludeFilters ()

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

Zwroty

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Pobiera wyrażenie regularne, aby wykluczyć uruchamianie niektórych plików.

Zwroty

getGTestFlags

public  getGTestFlags ()

Pobiera dodatkowe wartości flagi, które mają zostać przekazane do polecenia powłoki testu natywnego.

Zwroty

getIncludeFilters

public  getIncludeFilters ()

Zwraca bieżącą wartość ERROR(/Set) filtrów uwzględniania.

Zwroty

getMaxTestTimeMs

public long getMaxTestTimeMs ()

Pobiera maksymalny czas działania testu gtest.

Zwroty
`long`

getModuleName

public String getModuleName ()

Uruchom moduł testów natywnych aplikacji na Androida.

Zwroty
`String`	nazwa natywnego modułu testu do uruchomienia lub null, jeśli nie jest ustawiona;

getRunDisabledTests

public boolean getRunDisabledTests ()

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

Zwroty
`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. Czas jest używany do równoważenia obciążenia w ramach sekcji.

Zwroty
`long`

getShardCount

public int getShardCount ()

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

Zwroty
`int`

getShardIndex

public int getShardIndex ()

Pobiera indeks fragmentu tego testu.

Zwroty
`int`

getTestFilterKey

public String getTestFilterKey ()

Pobiera klucz filtra testowego.

Zwroty
`String`

getTestModule

public String getTestModule ()

Pobiera nazwę modułu.

Zwroty
`String`

isCollectTestsOnly

public boolean isCollectTestsOnly ()

Wywołuje tylko testowy plik binarny, aby zebrać listę odpowiednich przypadków testowych.

Zwroty
`boolean`

isEnableXmlOutput

public boolean isEnableXmlOutput ()

Ustawienie określające, czy do wyników testów ma być używany format XML gtest.

Zwroty
`boolean`

isSharded

public boolean isSharded ()

Pobiera flagę isSharded.

Zwroty
`boolean`

notifyTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

Poinformuj rodzica o wykonywaniu testu, aby filtry uwzględniania/wykluczania mogły być prawidłowo obsługiwane w przypadku prób ponownego wykonania.

Parametry
`incompleteTestFound`	`boolean`
`failedTests`

setAbi

public void setAbi (IAbi abi)

Parametry
`abi`	`IAbi`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Włącza lub wyłącza tryb testowy zbierania danych

setConfiguration

public void setConfiguration (IConfiguration configuration)

Wstrzykuje IConfiguration w użyciu.

Parametry
`configuration`	`IConfiguration`

setModuleName

public void setModuleName (String moduleName)

Ustaw do uruchomienia natywny moduł testowy Androida.

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  split (int shardCountHint)

Alternatywna wersja split(), która zawiera również parametr shardCount, który próbuje się uruchomić. Jest to przydatne w przypadku niektórych narzędzi testowych, które czasami nie mogą podejmować arbitralnych decyzji.

Parametry
`shardCountHint`	`int`: liczba prób fragmentacji.

Zwroty
	kolekcję testów podrzędnych do wykonania osobno lub `null`, jeśli test nie jest obecnie podzielony na części;

Chronione metody

convertName

protected String convertName (String gtestFlagName)

Parametry
`gtestFlagName`	`String`

Zwroty
`String`

createFlagFile

protected String createFlagFile (String filter)

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

Parametry
`filter`	`String`: ciąg znaków filtra

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

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

erasePrependedFileName

protected void erasePrependedFileName ( filters, 
                String filename)

Parametry
`filters`
`filename`	`String`

getAllGTestFlags

protected String getAllGTestFlags (String path)

Narzędzie pomocnicze do pobierania wszystkich flag GTest do przekazania do polecenia adb shell.

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

Zwroty
`String`	`String` wszystkich flag GTest, które mają zostać przekazane do GTest.

Rzuty
`DeviceNotAvailableException`

getConfiguration

protected IConfiguration getConfiguration ()

Zwraca konfigurację testu.

Zwroty
`IConfiguration`	IConfiguration

getExceptionMessage

protected String getExceptionMessage (Exception e)

Dołożyć wszelkich starań, aby pobrać krótki, treściwy komunikat dla danego Exception

Parametry
`e`	`Exception`: `Exception`

Zwroty
`String`	krótki komunikat

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 na urządzeniu
`flags`	`String`: flagi wykonania gtest

Zwroty
`String`	wiersz poleceń w powłoce do uruchomienia dla gtest

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

Pomocnik, który umożliwia pochodnym klasom owijanie polecenia gtest w ramach innego narzędzia (chroot, strace, gdb i podobnych).

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

Zwroty
`String`

getGTestFilters

protected String getGTestFilters (String path)

Funkcja pomocnicza do uzyskiwania filtra g-testu testu do uruchomienia.

Pamiętaj, że filtry działają tylko na podstawie nazwy funkcji (np. Google Test „Test”), więc będą brane pod uwagę wszystkie przypadki testowe Google Test „Test Cases”.

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

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

Rzuty
`DeviceNotAvailableException`

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)

Zwraca obiekt GTestListener, który udostępnia dodatkowe informacje debugowania, takie jak wykrywanie i zgłaszanie zduplikowanych testów, jeśli mDisabledDuplicateCheck ma wartość false. W przeciwnym razie zwraca przekazanego słuchacza.

Parametry
`listeners`	`ITestInvocationListener`

Zwroty
`ITestInvocationListener`

loadFilter

protected abstract String loadFilter (String path)

Zdefiniuj metodę filtrowania get.

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

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

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

Rzuty
`DeviceNotAvailableException`

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

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

Parametry
`runDisabled`	`boolean`