GTestBase
public abstract class GTestBase
extends Object
implements IRemoteTest , IConfigurationReceiver , ITestFilterReceiver , IRuntimeHintProvider , ITestCollector , IShardableTest , IAbiReceiver
Obiekt Java.lang.Object | |
↳ | com.android.tradefed.testtype.GTestBase |
Klasa bazowa gTest
Streszczenie
Pola | |
---|---|
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
|
Konstruktorzy publiczni | |
---|---|
GTestBase () |
Metody publiczne | |
---|---|
void | addAllExcludeFilters ( filters) addAllExcludeFilters ( filters) Dodaje |
void | addAllIncludeFilters ( filters) addAllIncludeFilters ( filters) Dodaje |
void | addExcludeFilter (String filter) Dodaje filtr określający, które testy należy wykluczyć. |
void | addIncludeFilter (String filter) Dodaje filtr określający, które testy należy uwzględnić. |
String | cleanFilter (String filter) |
void | clearExcludeFilters () Usuń wszystkie aktualnie śledzone filtry wykluczeń. |
void | clearIncludeFilters () Usuń wszystkie aktualnie śledzone filtry uwzględniania. |
IAbi | getAbi () |
getAfterTestCmd () Pobiera polecenia powłoki do uruchomienia po GTest. | |
getBeforeTestCmd () Pobiera polecenia powłoki do uruchomienia przed GTest. | |
getExcludeFilters () Zwraca bieżący | |
getFileExclusionFilterRegex () Pobiera wyrażenie regularne, aby wykluczyć wykonanie niektórych plików. | |
getGTestFlags () Pobiera dodatkowe wartości flag do przekazania do polecenia powłoki testu natywnego. | |
getIncludeFilters () Zwraca bieżący | |
long | getMaxTestTimeMs () Pobiera maksymalny czas uruchomienia gtest. |
String | getModuleName () Uruchom natywny moduł testowy systemu Android. |
boolean | getRunDisabledTests () Dowiedz się, czy GTest powinien uruchamiać wyłączone testy. |
long | getRuntimeHint () Zwróć oczekiwany czas wykonania 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 () Pobiera tylko plik binarny testowy w celu zebrania listy odpowiednich przypadków testowych lub nie. |
boolean | isEnableXmlOutput () Pobiera dane wyjściowe gtest xml w celu uzyskania wyników testu lub nie. |
boolean | isSharded () Pobiera flagę isSharded. |
void | notifyTestExecution (boolean incompleteTestFound, failedTests) notifyTestExecution (boolean incompleteTestFound, failedTests) Powiadom rodzica o wykonaniu testu, aby filtry włączenia/wykluczenia mogły prawidłowo obsługiwać przy ponownych próbach. |
void | setAbi ( IAbi abi) |
void | setCollectTestsOnly (boolean shouldCollectTest) Włącza lub wyłącza tryb zbierania testów |
void | setConfiguration ( IConfiguration configuration) Wstrzykuje używaną |
void | setModuleName (String moduleName) Ustaw moduł testowy natywnego systemu Android, aby działał. |
void | setShardCount (int shardCount) Ustawia liczbę fragmentów tego testu. |
void | setShardIndex (int shardIndex) Ustawia indeks fragmentu tego testu. |
split (int shardCountHint) Alternatywna wersja metody |
Metody chronione | |
---|---|
String | createFlagFile (String filter) Utwórz plik zawierający filtry, które będą używane przez --gtest_flagfile, aby uniknąć ograniczeń systemu operacyjnego w zakresie rozmiaru argumentów. |
void | erasePrependedFileName ( filters, String filename) erasePrependedFileName ( filters, String filename) |
String | getAllGTestFlags (String path) Pomocnik, aby wszystkie flagi GTest zostały przekazane do polecenia powłoki adb. |
IConfiguration | getConfiguration () Zwraca konfigurację testową. |
String | getExceptionMessage (Exception e) Dołóż wszelkich starań, aby uzyskać znaczący, krótki komunikat opisowy dla danego |
String | getGTestCmdLine (String fullPath, String flags) Metoda pomocnicza służąca do tworzenia polecenia gtest do uruchomienia. |
String | getGTestCmdLineWrapper (String fullPath, String flags) Pomocnik, który pozwala klasom pochodnym zawijać polecenie gtest w innym narzędziu (chroot, strace, gdb i podobne). |
String | getGTestFilters (String path) Pomocnik w uruchomieniu filtra testu g. |
ITestInvocationListener | getGTestListener ( ITestInvocationListener listener) Zwraca GTestListener, który zapewnia dodatkowe informacje debugowania, na przykład wykrywa i raportuje zduplikowane testy, jeśli mDisabledDuplicateCheck ma wartość false. |
abstract String | loadFilter (String path) Zdefiniuj metodę filtra pobierania. |
void | setRunDisabled (boolean runDisabled) Ustaw, czy GTest powinien uruchamiać wyłączone testy. |
Pola
FILTER_ROZSZERZENIE
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
Konstruktorzy publiczni
GTestBase
public GTestBase ()
Metody publiczne
addAllExcludeFilters
public void addAllExcludeFilters (filters)
Dodaje ERROR(/Set)
filtrów, z których testy mają zostać wykluczone.
Parametry | |
---|---|
filters |
dodajAllIncludeFilters
public void addAllIncludeFilters (filters)
Dodaje ERROR(/Set)
filtrów, które należy uwzględnić w testach.
Parametry | |
---|---|
filters |
dodajWykluczFiltr
public void addExcludeFilter (String filter)
Dodaje filtr określający, które testy należy wykluczyć.
Parametry | |
---|---|
filter | String |
dodajIncludeFilter
public void addIncludeFilter (String filter)
Dodaje filtr określający, które testy należy uwzględnić.
Parametry | |
---|---|
filter | String |
czysty filtr
public String cleanFilter (String filter)
Parametry | |
---|---|
filter | String |
Zwroty | |
---|---|
String |
wyczyśćWykluczFiltry
public void clearExcludeFilters ()
Usuń wszystkie aktualnie śledzone filtry wykluczeń.
wyczyśćIncludeFilters
public void clearIncludeFilters ()
Usuń wszystkie aktualnie śledzone filtry uwzględniania.
getAfterTestCmd
publicgetAfterTestCmd ()
Pobiera polecenia powłoki do uruchomienia po GTest.
Zwroty | |
---|---|
getBeforeTestCmd
publicgetBeforeTestCmd ()
Pobiera polecenia powłoki do uruchomienia przed GTest.
Zwroty | |
---|---|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
Pobiera wyrażenie regularne, aby wykluczyć wykonanie niektórych plików.
Zwroty | |
---|---|
pobierzGTestFlags
publicgetGTestFlags ()
Pobiera dodatkowe wartości flag do przekazania do polecenia powłoki testu natywnego.
Zwroty | |
---|---|
pobierzIncludeFilters
publicgetIncludeFilters ()
Zwraca bieżący ERROR(/Set)
filtrów dołączanych.
Zwroty | |
---|---|
getMaxTestTimeMs
public long getMaxTestTimeMs ()
Pobiera maksymalny czas uruchomienia gtest.
Zwroty | |
---|---|
long |
pobierz nazwę modułu
public String getModuleName ()
Uruchom natywny moduł testowy systemu Android.
Zwroty | |
---|---|
String | nazwa natywnego modułu testowego do uruchomienia lub null, jeśli nie jest ustawiona |
getRunDisabledTests
public boolean getRunDisabledTests ()
Dowiedz się, czy GTest powinien uruchamiać wyłączone testy.
Zwroty | |
---|---|
boolean | Prawda, jeśli należy uruchomić wyłączone testy, w przeciwnym razie fałsz |
pobierz wskazówkę uruchomieniową
public long getRuntimeHint ()
Zwróć oczekiwany czas wykonania testu w milisekundach. Czas jest używany do zrównoważenia obciążenia wykonania podzielonego na fragmenty
Zwroty | |
---|---|
long |
pobierzShardCount
public int getShardCount ()
Zwraca bieżącą liczbę fragmentów.
Zwroty | |
---|---|
int |
pobierzShardIndex
public int getShardIndex ()
Pobiera indeks fragmentu tego testu.
Zwroty | |
---|---|
int |
pobierz klucz testowy filtra
public String getTestFilterKey ()
Pobiera klucz filtra testowego.
Zwroty | |
---|---|
String |
pobierz moduł testowy
public String getTestModule ()
Pobiera nazwę modułu.
Zwroty | |
---|---|
String |
isCollectTestsOnly
public boolean isCollectTestsOnly ()
Pobiera tylko plik binarny testowy w celu zebrania listy odpowiednich przypadków testowych lub nie.
Zwroty | |
---|---|
boolean |
isEnableXmlOutput
public boolean isEnableXmlOutput ()
Pobiera dane wyjściowe gtest xml w celu uzyskania wyników testu lub nie.
Zwroty | |
---|---|
boolean |
jest rozdrobniony
public boolean isSharded ()
Pobiera flagę isSharded.
Zwroty | |
---|---|
boolean |
powiadomić o wykonaniu testu
public void notifyTestExecution (boolean incompleteTestFound,failedTests)
Powiadom rodzica o wykonaniu testu, aby filtry włączenia/wykluczenia mogły prawidłowo obsługiwać przy ponownych próbach.
Parametry | |
---|---|
incompleteTestFound | boolean |
failedTests |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
Włącza lub wyłącza tryb zbierania testów
ustaw konfigurację
public void setConfiguration (IConfiguration configuration)
Wstrzykuje używaną IConfiguration
.
Parametry | |
---|---|
configuration | IConfiguration |
setModuleName
public void setModuleName (String moduleName)
Ustaw moduł testowy natywnego systemu Android, aby działał.
Parametry | |
---|---|
moduleName | String : nazwa natywnego modułu testowego do uruchomienia |
ustawShardCount
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 |
podział
publicsplit (int shardCountHint)
Alternatywna wersja metody split()
, która udostępnia również wartość shardCount, którą próbuje się uruchomić. Jest to przydatne dla niektórych biegaczy testowych, którzy czasami nie mogą arbitralnie decydować.
Parametry | |
---|---|
shardCountHint | int : liczba prób fragmentu. |
Zwroty | |
---|---|
zbiór podtestów, które mają być wykonane osobno lub mają wartość null , jeśli testu nie można obecnie podzielić |
Metody chronione
utwórz plik flagowy
protected String createFlagFile (String filter)
Utwórz plik zawierający filtry, które będą używane przez --gtest_flagfile, aby uniknąć ograniczeń systemu operacyjnego w zakresie rozmiaru argumentów.
Parametry | |
---|---|
filter | String : Ciąg filtru |
Zwroty | |
---|---|
String | Ścieżka do pliku zawierającego filtr. |
Rzuca | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
usuńPrependedFileName
protected void erasePrependedFileName (filters, String filename)
Parametry | |
---|---|
filters | |
filename | String |
getAllGTestFlags
protected String getAllGTestFlags (String path)
Pomocnik, aby wszystkie flagi GTest zostały przekazane do polecenia powłoki adb.
Parametry | |
---|---|
path | String : pełna ścieżka pliku binarnego na urządzeniu. |
Zwroty | |
---|---|
String | String wszystkich flag GTest, które powinny zostać przekazane do GTest |
Rzuca | |
---|---|
DeviceNotAvailableException |
pobierz konfigurację
protected IConfiguration getConfiguration ()
Zwraca konfigurację testową.
Zwroty | |
---|---|
IConfiguration | IKonfiguracja |
pobierz wiadomość o wyjątku
protected String getExceptionMessage (Exception e)
Dołóż wszelkich starań, aby uzyskać znaczący, krótki komunikat opisowy dla danego Exception
Parametry | |
---|---|
e | Exception : Exception |
Zwroty | |
---|---|
String | krótka wiadomość |
pobierzGTestCmdLine
protected String getGTestCmdLine (String fullPath, String flags)
Metoda pomocnicza służąca do tworzenia polecenia gtest do uruchomienia.
Parametry | |
---|---|
fullPath | String : bezwzględna ścieżka systemu plików do pliku binarnego gtest na urządzeniu |
flags | String : flagi wykonania gtest |
Zwroty | |
---|---|
String | wiersz poleceń powłoki do uruchomienia gtest |
getGTestCmdLineWrapper
protected String getGTestCmdLineWrapper (String fullPath, String flags)
Pomocnik, który pozwala klasom pochodnym zawijać polecenie gtest w innym narzędziu (chroot, strace, gdb i podobne).
Parametry | |
---|---|
fullPath | String |
flags | String |
Zwroty | |
---|---|
String |
pobierzGTestFilters
protected String getGTestFilters (String path)
Pomocnik w uruchomieniu filtra testu g.
Pamiętaj, że filtry filtrują tylko nazwę funkcji (np. Google Test „Test”); wszystkie „przypadki testowe” Google Test zostaną uwzględnione.
Parametry | |
---|---|
path | String : pełna ścieżka pliku binarnego na urządzeniu. |
Zwroty | |
---|---|
String | flaga pełnego filtra, która ma zostać przekazana do testu g, lub pusty ciąg znaków, jeśli nie określono żadnego |
Rzuca | |
---|---|
DeviceNotAvailableException |
pobierzGTestListener
protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)
Zwraca GTestListener, który zapewnia dodatkowe informacje debugowania, na przykład wykrywa i raportuje zduplikowane testy, jeśli mDisabledDuplicateCheck ma wartość false. W przeciwnym razie zwraca przekazany słuchacz.
Parametry | |
---|---|
listener | ITestInvocationListener |
Zwroty | |
---|---|
ITestInvocationListener |
załaduj filtr
protected abstract String loadFilter (String path)
Zdefiniuj metodę filtra pobierania.
Podklasa musi wdrożyć sposób uzyskania własnego filtra.
Parametry | |
---|---|
path | String : pełna ścieżka pliku filtra. |
Zwroty | |
---|---|
String | ciąg filtrujący. |
Rzuca | |
---|---|
DeviceNotAvailableException |
setRunDisabled
protected void setRunDisabled (boolean runDisabled)
Ustaw, czy GTest powinien uruchamiać wyłączone testy.
Parametry | |
---|---|
runDisabled | boolean |