GTestBase
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()
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ą |
|
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 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,
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 |
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 |
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(
|
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 |
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.
getAfterTestCmd
publicgetAfterTestCmd ()
Pobiera polecenia powłoki do uruchomienia po GTest.
Zwroty | |
---|---|
|
getBeforeTestCmd
publicgetBeforeTestCmd ()
Pobiera polecenia powłoki do wykonania przed GTest.
Zwroty | |
---|---|
|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
Pobiera wyrażenie regularne, aby wykluczyć uruchamianie niektórych plików.
Zwroty | |
---|---|
|
getGTestFlags
publicgetGTestFlags ()
Pobiera dodatkowe wartości flagi, które mają zostać przekazane 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 ()
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 |
|
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
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 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 |