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

Znane podklasy pośrednie ArtGTest ArtGTest

---

Klasa bazowa gTest

Podsumowanie

Stałe
String	FILTER_EXTENSION
String	GTEST_FLAG_FILE
String	GTEST_FLAG_FILTER
String	GTEST_FLAG_LIST_TESTS
String	GTEST_FLAG_PRINT_TIME
String	GTEST_FLAG_RUN_DISABLED_TESTS
String	GTEST_XML_OUTPUT

Publiczne konstruktory
GTestBase()

Metody publiczne
void	addAllExcludeFilters( filters) Dodaje ERROR(/Set) filtrów, które określają, które testy mają zostać wykluczone.
void	addAllIncludeFilters( filters) Dodaje ERROR(/Set) filtrów, które określają, jakie testy mają być uwzględnione.
void	addExcludeFilter(String filter) Dodaje filtr określający, które testy mają zostać 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 obecnie śledzone filtry wykluczeń.
void	clearIncludeFilters() Usuń wszystkie obecnie ś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żącą ERROR(/Set) filtrów wykluczeń.
	getFileExclusionFilterRegex() Pobiera wyrażenie regularne, aby wykluczyć niektóre pliki z wykonywania.
	getGTestFlags() Pobiera dodatkowe wartości flag, które mają być przekazywane do polecenia powłoki testu natywnego.
	getIncludeFilters() Zwraca bieżący ERROR(/Set) filtrów uwzględniania.
long	getMaxTestTimeMs() Pobiera maksymalny czas działania testu gtest.
String	getModuleName() Pobierz moduł testowy Androida, aby go uruchomić.
boolean	getRunDisabledTests() Określa, 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() Zwraca indeks fragmentu tego testu.
String	getTestFilterKey() Pobiera klucz filtra testowego.
String	getTestModule() Pobiera nazwę modułu.
boolean	isCollectTestsOnly() Określa, czy wywoływać tylko plik binarny testu w celu zebrania listy odpowiednich przypadków testowych.
boolean	isEnableXmlOutput() Określa, czy do wyników testów ma być używane wyjście XML gtest.
boolean	isSharded() Pobiera flagę isSharded.
void	notifyTestExecution(boolean incompleteTestFound, failedTests) Powiadamianie rodzica o wykonaniu testu, aby filtry włączania/wykluczania mogły być prawidłowo obsługiwane w przypadku ponownych prób.
void	setAbi(IAbi abi)
void	setCollectTestsOnly(boolean shouldCollectTest) Włącza i wyłącza tryb zbierania testów
void	setConfiguration(IConfiguration configuration) Wstawia używany element IConfiguration.
void	setModuleName(String moduleName) Ustaw moduł testowy natywny na Androida, aby go uruchomić.
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 też liczbę fragmentów, które mają zostać uruchomione.

Metody chronione
String	convertName(String gtestFlagName)
String	createFlagFile(String filter) Utwórz plik zawierający filtry, które będą używane za pomocą flagi --gtest_flagfile, aby uniknąć ograniczeń systemu operacyjnego dotyczących rozmiaru argumentów.
void	erasePrependedFileName( filters, String filename)
String	getAllGTestFlags(String path) Funkcja pomocnicza do pobierania wszystkich flag GTest, które można przekazać do polecenia powłoki adb.
IConfiguration	getConfiguration() Zwraca konfigurację testu.
String	getExceptionMessage(Exception e) Spróbuj pobrać odpowiednią krótką wiadomość opisową dla danego Exception
String	getGTestCmdLine(String fullPath, String flags) Metoda pomocnicza do tworzenia polecenia gtest do uruchomienia.
String	getGTestCmdLineWrapper(String fullPath, String flags) Klasa pomocnicza, która umożliwia klasom pochodnym opakowanie polecenia gtest w inne narzędzie (chroot, strace, gdb i podobne).
String	getGTestFilters(String path) Funkcja pomocnicza do pobierania filtra testu g-test, który ma zostać uruchomiony.
ITestInvocationListener	getGTestListener(ITestInvocationListener... listeners) Zwraca GTestListener, który zawiera dodatkowe informacje do debugowania, np. wykrywa i zgłasza zduplikowane testy, jeśli mDisabledDuplicateCheck ma wartość false.
abstract String	loadFilter(String path) Zdefiniuj metodę pobierania filtra.
void	setRunDisabled(boolean runDisabled) Określa, czy GTest ma uruchamiać wyłączone testy.

Stałe

FILTER_EXTENSION

protected static final String FILTER_EXTENSION

Constant Value: ".filter"

GTEST_FLAG_FILE

protected static final String GTEST_FLAG_FILE

Wartość stała: "--gtest_flagfile"

GTEST_FLAG_FILTER

protected static final String GTEST_FLAG_FILTER

Stała wartość: "--gtest_filter"

GTEST_FLAG_LIST_TESTS

protected static final String GTEST_FLAG_LIST_TESTS

Stała wartość: "--gtest_list_tests"

GTEST_FLAG_PRINT_TIME

protected static final String GTEST_FLAG_PRINT_TIME

Wartość stała: "--gtest_print_time"

GTEST_FLAG_RUN_DISABLED_TESTS

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

Stała wartość: "--gtest_also_run_disabled_tests"

GTEST_XML_OUTPUT

protected static final String GTEST_XML_OUTPUT

Stała wartość: "--gtest_output=xml:%s"

Publiczne konstruktory

GTestBase

public GTestBase ()

Metody publiczne

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Dodaje ERROR(/Set) filtrów, które określają, które testy mają zostać wykluczone.

Parametry
filters

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Dodaje ERROR(/Set) filtrów, które określają, jakie testy mają być uwzględnione.

Parametry
filters

addExcludeFilter

public void addExcludeFilter (String filter)

Dodaje filtr określający, które testy 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

cleanFilter

public String cleanFilter (String filter)

Parametry
filter	String

Zwroty
String

clearExcludeFilters

public void clearExcludeFilters ()

Usuń wszystkie obecnie śledzone filtry wykluczeń.

clearIncludeFilters

public void clearIncludeFilters ()

Usuń wszystkie obecnie śledzone filtry uwzględniania.

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 uruchomienia przed GTest.

Zwroty

getExcludeFilters

public  getExcludeFilters ()

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

Zwroty

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Pobiera wyrażenie regularne, aby wykluczyć niektóre pliki z wykonywania.

Zwroty

getGTestFlags

public  getGTestFlags ()

Pobiera dodatkowe wartości flag, które mają być przekazywane do polecenia powłoki testu natywnego.

Zwroty

getIncludeFilters

public  getIncludeFilters ()

Zwraca bieżący 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ł testowy Androida, aby go uruchomić.

Zwroty
String	nazwa natywnego modułu testowego do uruchomienia lub wartość null, jeśli nie jest ustawiona.

getRunDisabledTests

public boolean getRunDisabledTests ()

Określa, 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. Ten czas jest używany do równoważenia obciążenia podczas wykonywania podzielonego na fragmenty.

Zwroty
long

getShardCount

public int getShardCount ()

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

Zwroty
int

getShardIndex

public int getShardIndex ()

Zwraca 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 ()

Określa, czy wywołania GET mają uruchamiać binarny plik testowy w celu zebrania listy odpowiednich przypadków testowych.

Zwroty
boolean

isEnableXmlOutput

public boolean isEnableXmlOutput ()

Określa, czy do wyników testów ma być używane wyjście XML gtest.

Zwroty
boolean

isSharded

public boolean isSharded ()

Pobiera flagę isSharded.

Zwroty
boolean

notifyTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

Powiadamianie rodzica o wykonaniu testu, aby filtry włączania/wykluczania mogły być prawidłowo obsługiwane w przypadku ponownych prób.

Parametry
incompleteTestFound	boolean
failedTests

setAbi

public void setAbi (IAbi abi)

Parametry
abi	IAbi

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Włącza i wyłącza tryb zbierania testów

setConfiguration

public void setConfiguration (IConfiguration configuration)

Wstawia używany element IConfiguration.

Parametry
configuration	IConfiguration

setModuleName

public void setModuleName (String moduleName)

Ustaw moduł testowy natywny na Androida, aby go uruchomić.

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 też liczbę fragmentów, które mają zostać uruchomione. Jest to przydatne w przypadku niektórych programów do uruchamiania testów, które nie mogą czasami podejmować arbitralnych decyzji.

Parametry
shardCountHint	int: liczba fragmentów, które próbowano utworzyć.

Zwroty
	zbiór podtestów do wykonania osobno lub null, jeśli test nie jest obecnie podzielony na części.

Metody chronione

convertName

protected String convertName (String gtestFlagName)

Parametry
gtestFlagName	String

Zwroty
String

createFlagFile

protected String createFlagFile (String filter)

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

Parametry
filter	String: ciąg filtra

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

Zgłasza
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

erasePrependedFileName

protected void erasePrependedFileName ( filters, 
                String filename)

Parametry
filters
filename	String

getAllGTestFlags

protected String getAllGTestFlags (String path)

Funkcja pomocnicza do pobierania wszystkich flag GTest, które można przekazać do polecenia powłoki adb.

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

Zwroty
String	String wszystkich flag GTest, które powinny zostać przekazane do GTest.

Zgłasza
DeviceNotAvailableException

getConfiguration

protected IConfiguration getConfiguration ()

Zwraca konfigurację testu.

Zwroty
IConfiguration	an IConfiguration

getExceptionMessage

protected String getExceptionMessage (Exception e)

Spróbuj pobrać odpowiednią krótką wiadomość opisową dla danego Exception

Parametry
e	Exception: Exception

Zwroty
String	krótką wiadomość,

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 w systemie plików na urządzeniu.
flags	String: flagi wykonania gtest

Zwroty
String	wiersz poleceń powłoki do uruchomienia testu gtest;

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

Klasa pomocnicza, która umożliwia klasom pochodnym opakowanie polecenia gtest w inne narzędzie (chroot, strace, gdb i podobne).

Parametry
fullPath	String
flags	String

Zwroty
String

getGTestFilters

protected String getGTestFilters (String path)

Funkcja pomocnicza do pobierania filtra testu g, który ma zostać uruchomiony.

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

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

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

Zgłasza
DeviceNotAvailableException

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)

Zwraca GTestListener, który zawiera dodatkowe informacje do debugowania, np. wykrywa i zgłasza zduplikowane testy, jeśli mDisabledDuplicateCheck ma wartość false. W przeciwnym razie zwraca przekazany obiekt nasłuchujący.

Parametry
listeners	ITestInvocationListener

Zwroty
ITestInvocationListener

loadFilter

protected abstract String loadFilter (String path)

Zdefiniuj metodę pobierania filtra.

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 filtra.

Zgłasza
DeviceNotAvailableException

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

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

Parametry
runDisabled	boolean