IRemoteAndroidTestRunner

public interface IRemoteAndroidTestRunner

com.android.ddmlib.testrunner.IRemoteAndroidTestRunner

Interfejs do zdalnego uruchamiania polecenia testowego Androida i przekazywania wyniku do odbiorcy.

Podsumowanie

Metody publiczne

abstract void addBooleanArg(String name, boolean value)

Dodaje argument logiczny do polecenia instrumentacji.

abstract void addInstrumentationArg(String name, String value)

Dodaje argument do polecenia instrumentacji.

abstract void cancel()

Prośba o anulowanie tego testu.

abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

Zwraca typ pokrycia testem generowanego przez moduł uruchamiający.

abstract String getPackageName()

Zwraca nazwę pakietu aplikacji.

abstract String getRunnerName()

Zwraca nazwę wykonawcy.

abstract void removeInstrumentationArg(String name)

Usuwa wcześniej dodany argument.

abstract void run(Collection<ITestRunListener> listeners)

Wykonaj ten test.

abstract void run(ITestRunListener... listeners)

Wykonaj ten test.

abstract void setAdditionalTestOutputLocation(String additionalTestDataPath)

Określa lokalizację dodatkowych danych wyjściowych testu, które mają zostać skopiowane na hosta przed odinstalowaniem aplikacji testowej.

abstract void setClassName(String className)

Ustawia, aby uruchamiać tylko testy w tej klasie. Musi być wywoływana przed „run”.

abstract void setClassNames(String[] classNames)

Ustawia, aby uruchamiać tylko testy w podanych klasach. Musi być wywoływana przed „run”.

abstract void setCoverage(boolean coverage)

Ustawia tryb pokrycia kodu w tym teście.

abstract void setCoverageReportLocation(String reportPath)

Określa lokalizację wygenerowanych raportów o pokryciu.

abstract void setDebug(boolean debug)

Ustawia tryb debugowania tego testu.

abstract void setLogOnly(boolean logOnly)

Ustawia ten przebieg testu w trybie tylko do rejestrowania – pomija wykonanie testu.

abstract void setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

Określa maksymalny czas między wynikami polecenia powłoki uruchamiającego testy na urządzeniach.

abstract void setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)

Określa maksymalny czas, w którym instrumentacja może się zakończyć.

abstract void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)

Ta metoda została wycofana. Użyj konta setMaxTimeToOutputResponse(long, java.util.concurrent.TimeUnit).

abstract void setMethodName(String className, String testName)

Ustawia uruchamianie tylko określonej metody testowej. Musi być wywoływana przed „run”.

abstract void setRunName(String runName)

Ustaw niestandardową nazwę uruchomienia, która będzie zgłaszana do ITestRunListener w dniu run(ITestRunListener)

Jeśli nie zostanie podana, użyta zostanie nazwa pakietu.

abstract void setTestCollection(boolean collection)

Ustawia ten test w trybie zbierania testów.

abstract void setTestPackageName(String packageName)

Ustawia uruchomienie wszystkich testów w określonym pakiecie. Musi być wywoływana przed funkcją „run”.

abstract void setTestSize(IRemoteAndroidTestRunner.TestSize size)

Ustawia uruchamianie tylko testów o danym rozmiarze.

Metody publiczne

addBooleanArg

public abstract void addBooleanArg (String name, 
                boolean value)

Dodaje argument logiczny do polecenia instrumentacji.

Parametry
name String: nazwa argumentu pakietu instrumentacji
value boolean: wartość argumentu

addInstrumentationArg

public abstract void addInstrumentationArg (String name, 
                String value)

Dodaje argument do polecenia instrumentacji.

Musi być wywoływana przed funkcją „run”. Jeśli argument o podanej nazwie został już podany, jego wartość zostanie zastąpiona.

Parametry
name String: nazwa argumentu pakietu instrumentacji
value String: wartość argumentu

anuluj

public abstract void cancel ()

Prośba o anulowanie tego testu.

getCoverageOutputType

public abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

Zwraca typ pokrycia testem generowanego przez moduł uruchamiający. Zobacz CoverageOutput.

Zwraca
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public abstract String getPackageName ()

Zwraca nazwę pakietu aplikacji.

Zwraca
String

getRunnerName

public abstract String getRunnerName ()

Zwraca nazwę wykonawcy.

Zwraca
String

removeInstrumentationArg

public abstract void removeInstrumentationArg (String name)

Usuwa wcześniej dodany argument.

Parametry
name String: nazwa argumentu pakietu instrumentacji do usunięcia

home run

public abstract void run (Collection<ITestRunListener> listeners)

Wykonaj ten test.

Parametry
listeners Collection: zbiór detektorów wyników testów
Zgłasza
AdbCommandRejectedException jeśli adb odrzuci polecenie;
ShellCommandUnresponsiveException jeśli urządzenie nie wygenerowało żadnego wyniku testu przez okres dłuższy niż maksymalny czas generowania wyniku.
TimeoutException w przypadku przekroczenia limitu czasu połączenia.
IOException jeśli połączenie z urządzeniem zostało utracone.

home run

public abstract void run (ITestRunListener... listeners)

Wykonaj ten test.

Metoda ułatwiająca korzystanie z run(Collection).

Parametry
listeners ITestRunListener: nasłuchuje wyników testu.
Zgłasza
AdbCommandRejectedException jeśli adb odrzuci polecenie;
ShellCommandUnresponsiveException jeśli urządzenie nie wygenerowało żadnego wyniku testu przez okres dłuższy niż maksymalny czas generowania wyniku.
TimeoutException w przypadku przekroczenia limitu czasu połączenia.
IOException jeśli połączenie z urządzeniem zostało utracone.

setAdditionalTestOutputLocation

public abstract void setAdditionalTestOutputLocation (String additionalTestDataPath)

Określa lokalizację dodatkowych danych wyjściowych testu, które mają zostać skopiowane na hosta przed odinstalowaniem aplikacji testowej. np. wygenerowane raporty testów porównawczych.

Parametry
additionalTestDataPath String

setClassName

public abstract void setClassName (String className)

Ustawia, aby uruchamiać tylko testy w tej klasie. Musi być wywoływana przed „run”.

Parametry
className String: pełna i jednoznaczna nazwa klasy (np. x.y.z)

setClassNames

public abstract void setClassNames (String[] classNames)

Ustawia, aby uruchamiać tylko testy w podanych klasach. Musi być wywoływana przed „run”.

Jeśli podajesz więcej niż jedną klasę, musisz użyć klasy InstrumentationTestRunner, która obsługuje składnię argumentu z wieloma klasami.

Parametry
classNames String: tablica pełnych nazw klas (np. x.y.z)

setCoverage

public abstract void setCoverage (boolean coverage)

Ustawia tryb pokrycia kodu w tym teście.

Parametry
coverage boolean

setCoverageReportLocation

public abstract void setCoverageReportLocation (String reportPath)

Określa lokalizację wygenerowanych raportów o pokryciu.

Parametry
reportPath String

setDebug

public abstract void setDebug (boolean debug)

Ustawia tryb debugowania tego testu. Jeśli wartość to „true”, program do uruchamiania testów na Androidzie będzie czekać na przyłączenie debugera przed rozpoczęciem wykonywania testu.

Parametry
debug boolean

setLogOnly

public abstract void setLogOnly (boolean logOnly)

Ustawia ten przebieg testu w trybie tylko do rejestrowania – pomija wykonanie testu.

Parametry
logOnly boolean

setMaxTimeToOutputResponse

public abstract void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

Określa maksymalny czas między wynikami polecenia powłoki uruchamiającego testy na urządzeniach.

Umożliwia to ustawienie limitu czasu na wypadek, gdyby testy utknęły i nigdy się nie zakończyły. Różni się on od zwykłego limitu czasu połączenia.

Domyślnie nie jest określany żaden limit czasu.

Parametry
maxTimeToOutputResponse long: maksymalny czas, w którym polecenie może nie generować żadnej odpowiedzi. Wartość 0 oznacza, że metoda będzie czekać w nieskończoność (do momentu, gdy receiver anuluje wykonanie) na dane wyjściowe polecenia i nigdy nie zgłosi wyjątku.
maxTimeUnits TimeUnit: jednostki dla wartości maxTimeToOutputResponse i maxTimeout innych niż zero.

setMaxTimeout

public abstract void setMaxTimeout (long maxTimeout, 
                TimeUnit maxTimeUnits)

Określa maksymalny czas, w którym instrumentacja może się zakończyć.

Umożliwia to ustawienie limitu czasu na wypadek, gdyby testy utknęły i nigdy się nie zakończyły. Różni się on od zwykłego limitu czasu połączenia.

Domyślnie nie jest określany żaden limit czasu.

Parametry
maxTimeout long: maksymalny czas, w którym polecenie może nie zwracać żadnej odpowiedzi. Wartość 0 oznacza, że metoda będzie czekać w nieskończoność (do momentu, gdy receiver anuluje wykonanie) na dane wyjściowe polecenia i nigdy nie zgłosi wyjątku.
maxTimeUnits TimeUnit: jednostki dla wartości maxTimeToOutputResponse i maxTimeout innych niż zero.

setMaxtimeToOutputResponse

public abstract void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

Ta metoda została wycofana.
Użyj setMaxTimeToOutputResponse(long, java.util.concurrent.TimeUnit).

Parametry
maxTimeToOutputResponse int

setMethodName

public abstract void setMethodName (String className, 
                String testName)

Ustawia uruchamianie tylko określonej metody testowej. Musi być wywoływana przed „run”.

Parametry
className String: pełna i jednoznaczna nazwa klasy (np. x.y.z)
testName String: nazwa metody

setRunName

public abstract void setRunName (String runName)

Ustaw niestandardową nazwę uruchomienia, która będzie zgłaszana do ITestRunListener w dniu run(ITestRunListener)

Jeśli nie zostanie podana, użyta zostanie nazwa pakietu.

setTestCollection

public abstract void setTestCollection (boolean collection)

Ustawia ten test w trybie zbierania testów. Jeśli ma wartość true, wykonanie testu zostanie pominięte, a wszystkie odpowiednie argumenty narzędzia do uruchamiania wymagane do pomyślnego zebrania testów zostaną ustawione.

Parametry
collection boolean

setTestPackageName

public abstract void setTestPackageName (String packageName)

Ustawia uruchomienie wszystkich testów w określonym pakiecie. Musi być wywoływana przed funkcją „run”.

Parametry
packageName String: pełna i jednoznaczna nazwa pakietu (np. x.y.z)

setTestSize

public abstract void setTestSize (IRemoteAndroidTestRunner.TestSize size)

Ustawia uruchamianie tylko testów o danym rozmiarze. Musi być wywoływana przed funkcją „run”.

Parametry
size IRemoteAndroidTestRunner.TestSize: TestSize do uruchomienia.