GTestBase
public abstract class GTestBase
extends Object
implements IRemoteTest , IConfigurationReceiver , ITestFilterReceiver , IRuntimeHintProvider , ITestCollector , IShardableTest , IAbiReceiver
java.lang.Obiekt | |
↳ | 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
|
Konstruktory publiczne | |
---|---|
GTestBase () |
Metody publiczne | |
---|---|
void | addAllExcludeFilters ( filters) addAllExcludeFilters ( filters) Dodaje |
void | addAllIncludeFilters ( filters) addAllIncludeFilters ( filters) Dodaje |
void | addExcludeFilter (String filter) Dodaje filtr testów do wykluczenia. |
void | addIncludeFilter (String filter) Dodaje filtr określający, które testy mają zostać uwzględnione. |
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 GTestem. | |
getExcludeFilters () Zwraca bieżący | |
getFileExclusionFilterRegex () Pobiera wyrażenie regularne, aby wykluczyć określone pliki z wykonywania. | |
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 Androida. |
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 wywołanie testowego pliku binarnego w celu zebrania listy odpowiednich przypadków testowych lub nie. |
boolean | isEnableXmlOutput () Pobiera użycie wyjścia gtest xml dla wyników testu, czy nie. |
boolean | isSharded () Pobiera flagę isSharded. |
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 natywny moduł testowy Androida do uruchomienia. |
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 rozmiarze argumentów. |
void | erasePrependedFileName ( filters, String filename) erasePrependedFileName ( filters, String filename) |
String | getAllGTestFlags (String path) Pomocnik, aby wszystkie flagi GTest przeszły do polecenia powłoki adb. |
IConfiguration | getConfiguration () Zwraca konfigurację testową. |
String | getExceptionMessage (Exception e) Dołóż wszelkich starań, aby pobrać sensowną krótką wiadomość opisową dla danego |
String | getGTestCmdLine (String fullPath, String flags) Metoda pomocnicza do zbudowania polecenia gtest do uruchomienia. |
String | getGTestCmdLineWrapper (String fullPath, String flags) Pomocnik, który pozwala klasom pochodnym zawinąć polecenie gtest w inne narzędzie (chroot, strace, gdb i podobne). |
String | getGTestFilters (String path) Pomocnik, aby uruchomić filtr g-test testu. |
ITestInvocationListener | getGTestListener ( ITestInvocationListener listener) Zwraca |
abstract String | loadFilter (String path) Zdefiniuj metodę get filter. |
void | setRunDisabled (boolean runDisabled) Ustaw, czy GTest ma uruchamiać wyłączone testy. |
Pola
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, z których testy mają zostać wykluczone.
Parametry | |
---|---|
filters |
dodaj filtry AllInclude
public void addAllIncludeFilters (filters)
Dodaje ERROR(/Set)
filtrów, z których testy mają zostać uwzględnione.
Parametry | |
---|---|
filters |
dodaj filtr wykluczenia
public void addExcludeFilter (String filter)
Dodaje filtr testów do wykluczenia.
Parametry | |
---|---|
filter | String |
addIncludeFilter
public void addIncludeFilter (String filter)
Dodaje filtr określający, które testy mają zostać uwzględnione.
Parametry | |
---|---|
filter | String |
wyczyść filtr
public String cleanFilter (String filter)
Parametry | |
---|---|
filter | String |
Zwroty | |
---|---|
String |
wyczyść filtry wykluczające
public void clearExcludeFilters ()
Usuń wszystkie aktualnie śledzone filtry wykluczeń.
wyczyść filtry uwzględnienia
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 GTestem.
Zwroty | |
---|---|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
Pobiera wyrażenie regularne, aby wykluczyć określone pliki z wykonywania.
Zwroty | |
---|---|
getGTestFlags
publicgetGTestFlags ()
Pobiera dodatkowe wartości flag do przekazania do polecenia powłoki testu natywnego.
Zwroty | |
---|---|
getMaxTestTimeMs
public long getMaxTestTimeMs ()
Pobiera maksymalny czas uruchomienia gtest.
Zwroty | |
---|---|
long |
pobierzNazwęModułu
public String getModuleName ()
Uruchom natywny moduł testowy Androida.
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 |
getRuntimeHint
public long getRuntimeHint ()
Zwróć oczekiwany czas wykonania testu w milisekundach. Czas jest używany do równoważenia obciążenia wykonania podzielonego na fragmenty
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 |
pobierz moduł testowy
public String getTestModule ()
Pobiera nazwę modułu.
Zwroty | |
---|---|
String |
jest tylko zbieraniem testów
public boolean isCollectTestsOnly ()
Pobiera tylko wywołanie testowego pliku binarnego w celu zebrania listy odpowiednich przypadków testowych lub nie.
Zwroty | |
---|---|
boolean |
isEnableXmlOutput
public boolean isEnableXmlOutput ()
Pobiera użycie wyjścia gtest xml dla wyników testu, czy nie.
Zwroty | |
---|---|
boolean |
jestSharded
public boolean isSharded ()
Pobiera flagę isSharded.
Zwroty | |
---|---|
boolean |
ustawZbierzTylko testy
public void setCollectTestsOnly (boolean shouldCollectTest)
Włącza lub wyłącza tryb zbierania testów
zestawKonfiguracja
public void setConfiguration (IConfiguration configuration)
Wstrzykuje używaną IConfiguration
.
Parametry | |
---|---|
configuration | IConfiguration |
ustawNazwaModułu
public void setModuleName (String moduleName)
Ustaw natywny moduł testowy Androida do uruchomienia.
Parametry | |
---|---|
moduleName | String : Nazwa natywnego modułu testowego do uruchomienia |
ustawLiczbę odłamków
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()
zawierająca również liczbę shardCount, która ma zostać uruchomiona. Jest to przydatne dla niektórych biegaczy testowych, którzy czasami nie mogą arbitralnie decydować.
Parametry | |
---|---|
shardCountHint | int : próba zliczenia odłamków. |
Zwroty | |
---|---|
zbiór podtestów do wykonania oddzielnie lub null , jeśli test nie jest obecnie możliwy do podzielenia |
Metody chronione
utwórz plik flagi
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 rozmiarze argumentów.
Parametry | |
---|---|
filter | String : ciąg filtru |
Zwroty | |
---|---|
String | Ścieżka do pliku zawierającego filtr. |
Rzuty | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
wymażPrzedstawionąNazwęPliku
protected void erasePrependedFileName (filters, String filename)
Parametry | |
---|---|
filters | |
filename | String |
getAllGTestFlags
protected String getAllGTestFlags (String path)
Pomocnik, aby wszystkie flagi GTest przeszły do polecenia powłoki adb.
Parametry | |
---|---|
path | String : pełna ścieżka pliku binarnego na urządzeniu. |
Zwroty | |
---|---|
String | ERROR(/String) wszystkich flag GTest, które powinny zostać przekazane do GTest |
Rzuty | |
---|---|
DeviceNotAvailableException |
getConfiguration
protected IConfiguration getConfiguration ()
Zwraca konfigurację testową.
Zwroty | |
---|---|
IConfiguration | IConfiguration |
getExceptionMessage
protected String getExceptionMessage (Exception e)
Dołóż wszelkich starań, aby pobrać sensowną krótką wiadomość opisową dla danego ERROR(/Exception)
Parametry | |
---|---|
e | Exception : ERROR(/Exception) |
Zwroty | |
---|---|
String | krótka wiadomość |
getGTestCmdLine
protected String getGTestCmdLine (String fullPath, String flags)
Metoda pomocnicza do zbudowania 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 zawinąć polecenie gtest w inne narzędzie (chroot, strace, gdb i podobne).
Parametry | |
---|---|
fullPath | String |
flags | String |
Zwroty | |
---|---|
String |
getGTestFilters
protected String getGTestFilters (String path)
Pomocnik, aby uruchomić filtr g-test testu.
Pamiętaj, że filtry filtrują tylko nazwę funkcji (np.: Google Test „Test”); wszystkie „Przypadki testowe” Google będą brane pod uwagę.
Parametry | |
---|---|
path | String : pełna ścieżka pliku binarnego na urządzeniu. |
Zwroty | |
---|---|
String | flagę pełnego filtra, która ma zostać przekazana do testu g, lub pusty łańcuch, jeśli żaden nie został określony |
Rzuty | |
---|---|
DeviceNotAvailableException |
getGTestListener
protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)
Zwraca GTestListener
, który zapewnia dodatkowe informacje debugowania, takie jak wykrywanie i zgłaszanie zduplikowanych testów, jeśli mDisabledDuplicateCheck ma wartość false. W przeciwnym razie zwraca przekazanego odbiornika.
Parametry | |
---|---|
listener | ITestInvocationListener |
Zwroty | |
---|---|
ITestInvocationListener |
filtr wczytywania
protected abstract String loadFilter (String path)
Zdefiniuj metodę get filter.
Podklasa musi zaimplementować sposób uzyskania własnego filtra.
Parametry | |
---|---|
path | String : pełna ścieżka do pliku filtru. |
Zwroty | |
---|---|
String | ciąg filtru. |
Rzuty | |
---|---|
DeviceNotAvailableException |
ustawUruchomWyłączone
protected void setRunDisabled (boolean runDisabled)
Ustaw, czy GTest ma uruchamiać wyłączone testy.
Parametry | |
---|---|
runDisabled | boolean |