BazaGTestowa
public
abstract
class
GTestBase
extends Object
implements
IAbiReceiver,
IConfigurationReceiver,
IRemoteTest,
IRuntimeHintProvider,
IShardableTest,
ITestCollector,
ITestFilterReceiver
java.lang.Object | |
↳ | com.android.tradefed.testtype.GTestBase, |
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(
Dodaje |
void
|
addAllIncludeFilters(
Dodaje |
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()
Usuń wszystkie śledzone obecnie filtry wykluczania. |
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 uruchomienia przed GTest. |
|
getExcludeFilters()
Zwraca bieżącą |
|
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ść |
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 fragmentów z 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 testów. |
boolean
|
isEnableXmlOutput()
Określa, czy wyniki testów mają być wyświetlane w formacie XML gtest. |
boolean
|
isSharded()
Pobiera flagę isSharded. |
void
|
notifyTestExecution(boolean incompleteTestFound,
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 i wyłącza tryb zbierania danych o testach |
void
|
setConfiguration(IConfiguration configuration)
Wstawia używany |
void
|
setModuleName(String moduleName)
Ustaw uruchamianie modułu testów natywnych na 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 |
Chronione metody | |
---|---|
String
|
createFlagFile(String filter)
Utwórz plik zawierający filtry, które będą używane w funkcji --gtest_flagfile, aby uniknąć ograniczenia rozmiaru argumentów systemu operacyjnego. |
void
|
erasePrependedFileName(
|
String
|
getAllGTestFlags(String path)
Narzędzie pomocnicze do pobierania wszystkich flag GTest do przekazania do polecenia adb shell. |
IConfiguration
|
getConfiguration()
Zwraca konfigurację testową. |
String
|
getExceptionMessage(Exception e)
Dołożyć wszelkich starań, aby pobrać krótki, treściwy komunikat dla danego |
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 pochodnym klasom owinięcie polecenia gtest w ramach innego narzędzia (chroot, strace, gdb i podobnych). |
String
|
getGTestFilters(String path)
Funkcja pomocnicza służąca do uzyskiwania filtra g-testu testu do wykonania. |
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 mDisabledDuplikatCheck ma wartość false (fałsz). |
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
BazaGTestowa
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 z testów, które 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 |
wyczyśćFiltr
public String cleanFilter (String filter)
Parametry | |
---|---|
filter |
String |
Zwroty | |
---|---|
String |
clearExcludeFilters
public void clearExcludeFilters ()
Usuń wszystkie śledzone obecnie filtry wykluczania.
wyczyść UwzględnijFiltry
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ć niektóre pliki z wykonania.
Zwroty | |
---|---|
|
getGTestFlags
publicgetGTestFlags ()
Pobiera dodatkowe wartości flagi, aby przekazać je do polecenia powłoki testu natywnego.
Zwroty | |
---|---|
|
getIncludeFilters
publicgetIncludeFilters ()
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 ()
Pobierz moduł do testowania natywnych aplikacji na Androida.
Zwroty | |
---|---|
String |
nazwa natywnego modułu testowego do uruchomienia lub wartość null, jeśli nie została 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 fragmentów z 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 testów.
Zwroty | |
---|---|
boolean |
isEnableXmlOutput
public boolean isEnableXmlOutput ()
Określa, czy wyniki testów mają być wyświetlane w formacie XML gtest.
Zwroty | |
---|---|
boolean |
Podzielony na fragmenty
public boolean isSharded ()
Pobiera flagę isSharded.
Zwroty | |
---|---|
boolean |
powiadamiajTestExecution
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 |
|
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
Włącza lub wyłącza tryb testowy zbierania danych
setConfiguration
public void setConfiguration (IConfiguration configuration)
Wstawia używany IConfiguration
.
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 fragmentów tego testu.
Parametry | |
---|---|
shardIndex |
int |
podziel
publicsplit (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 testujących, które czasami nie mogą podejmować arbitralnych decyzji.
Parametry | |
---|---|
shardCountHint |
int : liczba prób fragmentacji. |
Zwroty | |
---|---|
|
zbiór podtestów do wykonania oddzielnie lub null , jeśli testu nie można obecnie podzielić na fragmenty |
Chronione metody
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 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)
Spróbuj pobrać zwięzły, krótki opisowy komunikat dla danego atrybutu Exception
Parametry | |
---|---|
e |
Exception : Exception |
Zwroty | |
---|---|
String |
krótka wiadomość |
getGTestCmdLine
protected String getGTestCmdLine (String fullPath, String flags)
Metoda pomocnicza do kompilowania 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 owinięcie 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)
Pomoc do pobierania filtra testu g testu.
Pamiętaj, że filtry filtrują tylko nazwę funkcji (np. Test Google „Test”), biorąc pod uwagę wszystkie „Przypadki testowe” w teście Google.
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 |
filtr obciążenia
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ągu filtra. |
Rzuty | |
---|---|
DeviceNotAvailableException |
setRunDisabled
protected void setRunDisabled (boolean runDisabled)
Określ, czy GTest ma uruchamiać wyłączone testy.
Parametry | |
---|---|
runDisabled |
boolean |