GTestBase

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

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

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