GTestBase

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

Obiekt Java.lang.Object
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

Konstruktorzy publiczni

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, które należy uwzględnić w testach.

void addExcludeFilter (String filter)

Dodaje filtr określający, które testy należy wykluczyć.

void addIncludeFilter (String filter)

Dodaje filtr określający, które testy należy uwzględnić.

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

getExcludeFilters ()

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

getFileExclusionFilterRegex ()

Pobiera wyrażenie regularne, aby wykluczyć wykonanie niektórych plików.

getGTestFlags ()

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

getIncludeFilters ()

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

long getMaxTestTimeMs ()

Pobiera maksymalny czas uruchomienia gtest.

String getModuleName ()

Uruchom natywny moduł testowy systemu Android.

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 plik binarny testowy w celu zebrania listy odpowiednich przypadków testowych lub nie.

boolean isEnableXmlOutput ()

Pobiera dane wyjściowe gtest xml w celu uzyskania wyników testu lub nie.

boolean isSharded ()

Pobiera flagę isSharded.

void notifyTestExecution (boolean incompleteTestFound, failedTests) notifyTestExecution (boolean incompleteTestFound, failedTests)

Powiadom rodzica o wykonaniu testu, aby filtry włączenia/wykluczenia mogły prawidłowo obsługiwać przy ponownych próbach.

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 moduł testowy natywnego systemu Android, aby działał.

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() , która udostępnia również wartość shardCount, którą próbuje się uruchomić.

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 zakresie rozmiaru argumentów.

void erasePrependedFileName ( filters, String filename) erasePrependedFileName ( filters, String filename)
String getAllGTestFlags (String path)

Pomocnik, aby wszystkie flagi GTest zostały przekazane do polecenia powłoki adb.

IConfiguration getConfiguration ()

Zwraca konfigurację testową.

String getExceptionMessage (Exception e)

Dołóż wszelkich starań, aby uzyskać znaczący, krótki komunikat opisowy dla danego Exception

String getGTestCmdLine (String fullPath, String flags)

Metoda pomocnicza służąca do tworzenia polecenia gtest do uruchomienia.

String getGTestCmdLineWrapper (String fullPath, String flags)

Pomocnik, który pozwala klasom pochodnym zawijać polecenie gtest w innym narzędziu (chroot, strace, gdb i podobne).

String getGTestFilters (String path)

Pomocnik w uruchomieniu filtra testu g.

ITestInvocationListener getGTestListener ( ITestInvocationListener listener)

Zwraca GTestListener, który zapewnia dodatkowe informacje debugowania, na przykład wykrywa i raportuje zduplikowane testy, jeśli mDisabledDuplicateCheck ma wartość false.

abstract String loadFilter (String path)

Zdefiniuj metodę filtra pobierania.

void setRunDisabled (boolean runDisabled)

Ustaw, czy GTest powinien uruchamiać wyłączone testy.

Pola

FILTER_ROZSZERZENIE

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

Konstruktorzy publiczni

GTestBase

public GTestBase ()

Metody publiczne

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Dodaje ERROR(/Set) filtrów, z których testy mają zostać wykluczone.

Parametry
filters

dodajAllIncludeFilters

public void addAllIncludeFilters ( filters)

Dodaje ERROR(/Set) filtrów, które należy uwzględnić w testach.

Parametry
filters

dodajWykluczFiltr

public void addExcludeFilter (String filter)

Dodaje filtr określający, które testy należy wykluczyć.

Parametry
filter String

dodajIncludeFilter

public void addIncludeFilter (String filter)

Dodaje filtr określający, które testy należy uwzględnić.

Parametry
filter String

czysty filtr

public String cleanFilter (String filter)

Parametry
filter String

Zwroty
String

wyczyśćWykluczFiltry

public void clearExcludeFilters ()

Usuń wszystkie aktualnie śledzone filtry wykluczeń.

wyczyśćIncludeFilters

public void clearIncludeFilters ()

Usuń wszystkie aktualnie śledzone filtry uwzględniania.

weź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 GTest.

Zwroty

getExcludeFilters

public  getExcludeFilters ()

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

Zwroty

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Pobiera wyrażenie regularne, aby wykluczyć wykonanie niektórych plików.

Zwroty

pobierzGTestFlags

public  getGTestFlags ()

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

Zwroty

pobierzIncludeFilters

public  getIncludeFilters ()

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

Zwroty

getMaxTestTimeMs

public long getMaxTestTimeMs ()

Pobiera maksymalny czas uruchomienia gtest.

Zwroty
long

pobierz nazwę modułu

public String getModuleName ()

Uruchom natywny moduł testowy systemu Android.

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

pobierz wskazówkę uruchomieniową

public long getRuntimeHint ()

Zwróć oczekiwany czas wykonania testu w milisekundach. Czas jest używany do zrównoważenia obciążenia wykonania podzielonego na fragmenty

Zwroty
long

pobierzShardCount

public int getShardCount ()

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

Zwroty
int

pobierzShardIndex

public int getShardIndex ()

Pobiera indeks fragmentu tego testu.

Zwroty
int

pobierz klucz testowy filtra

public String getTestFilterKey ()

Pobiera klucz filtra testowego.

Zwroty
String

pobierz moduł testowy

public String getTestModule ()

Pobiera nazwę modułu.

Zwroty
String

isCollectTestsOnly

public boolean isCollectTestsOnly ()

Pobiera tylko plik binarny testowy w celu zebrania listy odpowiednich przypadków testowych lub nie.

Zwroty
boolean

isEnableXmlOutput

public boolean isEnableXmlOutput ()

Pobiera dane wyjściowe gtest xml w celu uzyskania wyników testu lub nie.

Zwroty
boolean

jest rozdrobniony

public boolean isSharded ()

Pobiera flagę isSharded.

Zwroty
boolean

powiadomić o wykonaniu testu

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

Powiadom rodzica o wykonaniu testu, aby filtry włączenia/wykluczenia mogły prawidłowo obsługiwać przy ponownych próbach.

Parametry
incompleteTestFound boolean

failedTests

ustawAbi

public void setAbi (IAbi abi)

Parametry
abi IAbi

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

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

ustaw konfigurację

public void setConfiguration (IConfiguration configuration)

Wstrzykuje używaną IConfiguration .

Parametry
configuration IConfiguration

setModuleName

public void setModuleName (String moduleName)

Ustaw moduł testowy natywnego systemu Android, aby działał.

Parametry
moduleName String : nazwa natywnego modułu testowego do uruchomienia

ustawShardCount

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() , która udostępnia również wartość shardCount, którą próbuje się uruchomić. Jest to przydatne dla niektórych biegaczy testowych, którzy czasami nie mogą arbitralnie decydować.

Parametry
shardCountHint int : liczba prób fragmentu.

Zwroty
zbiór podtestów, które mają być wykonane osobno lub mają wartość null , jeśli testu nie można obecnie podzielić

Metody chronione

utwórz plik flagowy

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 zakresie rozmiaru argumentów.

Parametry
filter String : Ciąg filtru

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

Rzuca
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

usuńPrependedFileName

protected void erasePrependedFileName ( filters, 
                String filename)

Parametry
filters

filename String

getAllGTestFlags

protected String getAllGTestFlags (String path)

Pomocnik, aby wszystkie flagi GTest zostały przekazane do polecenia powłoki adb.

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

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

Rzuca
DeviceNotAvailableException

pobierz konfigurację

protected IConfiguration getConfiguration ()

Zwraca konfigurację testową.

Zwroty
IConfiguration IKonfiguracja

pobierz wiadomość o wyjątku

protected String getExceptionMessage (Exception e)

Dołóż wszelkich starań, aby uzyskać znaczący, krótki komunikat opisowy dla danego Exception

Parametry
e Exception : Exception

Zwroty
String krótka wiadomość

pobierzGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

Metoda pomocnicza służąca do tworzenia 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 zawijać polecenie gtest w innym narzędziu (chroot, strace, gdb i podobne).

Parametry
fullPath String

flags String

Zwroty
String

pobierzGTestFilters

protected String getGTestFilters (String path)

Pomocnik w uruchomieniu filtra testu g.

Pamiętaj, że filtry filtrują tylko nazwę funkcji (np. Google Test „Test”); wszystkie „przypadki testowe” Google Test zostaną uwzględnione.

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

Zwroty
String flaga pełnego filtra, która ma zostać przekazana do testu g, lub pusty ciąg znaków, jeśli nie określono żadnego

Rzuca
DeviceNotAvailableException

pobierzGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)

Zwraca GTestListener, który zapewnia dodatkowe informacje debugowania, na przykład wykrywa i raportuje zduplikowane testy, jeśli mDisabledDuplicateCheck ma wartość false. W przeciwnym razie zwraca przekazany słuchacz.

Parametry
listener ITestInvocationListener

Zwroty
ITestInvocationListener

załaduj filtr

protected abstract String loadFilter (String path)

Zdefiniuj metodę filtra pobierania.

Podklasa musi wdrożyć sposób uzyskania własnego filtra.

Parametry
path String : pełna ścieżka pliku filtra.

Zwroty
String ciąg filtrujący.

Rzuca
DeviceNotAvailableException

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

Ustaw, czy GTest powinien uruchamiać wyłączone testy.

Parametry
runDisabled boolean