GTestBase

public abstract class GTestBase
extends Object implements IRemoteTest , IConfigurationReceiver , ITestFilterReceiver , IRuntimeHintProvider , ITestCollector , IShardableTest , IAbiReceiver

java.lang.Obiekt
↳	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

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 ERROR(/Set) filtrów, z których testy mają zostać wykluczone.
void	addAllIncludeFilters ( filters) addAllIncludeFilters ( filters) Dodaje ERROR(/Set) filtrów, z których testy mają zostać uwzględnione.
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 ERROR(/Set) filtrów wykluczających.
	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 ERROR(/Set) filtrów dołączania.
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ą IConfiguration .
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 split() zawierająca również liczbę shardCount, która ma zostać uruchomiona.

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 ERROR(/Exception)
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 GTestListener , który zapewnia 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ę 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.

dostaćAbi

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

Zwroty

getExcludeFilters

public  getExcludeFilters ()

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

Zwroty

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Pobiera wyrażenie regularne, aby wykluczyć określone pliki z wykonywania.

Zwroty

getGTestFlags

public  getGTestFlags ()

Pobiera dodatkowe wartości flag do przekazania do polecenia powłoki testu natywnego.

Zwroty

getIncludeFilters

public  getIncludeFilters ()

Zwraca bieżący ERROR(/Set) filtrów dołączania.

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

ustaw Abi

public void setAbi (IAbi abi)

Parametry
abi	IAbi

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ł

public  split (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