UiAutomatorRunner

public class UiAutomatorRunner
extends Object implements IRemoteAndroidTestRunner

java.lang.Object
   ↳ com.android.tradefed.testtype.UiAutomatorRunner

Uruchamia test UI Automator na urządzeniu i zgłasza wyniki. Test UI Automator to specjalny program do uruchamiania testów automatyzacji interfejsu, który korzysta z platformy UI Automator. Program do uruchamiania testów na urządzeniu emuluje format wyjściowy testu instrumentacji, dzięki czemu można ponownie wykorzystać istniejący kod analizujący w ddmlib i TF. Jest to w zasadzie otoczka tego polecenia: adb shell uiautomator runtest (jar files) -e class (test classes) ...

Podsumowanie

Publiczne konstruktory

UiAutomatorRunner(IDevice remoteDevice, String[] jarPaths, String runnerPath)

Tworzenie UiAutomatorRunner do uruchamiania testów automatyzacji interfejsu

Metody publiczne

void addBooleanArg(String name, boolean value)

Dodaje argument logiczny do polecenia instrumentacji.

void addInstrumentationArg(String name, String value)

Dodaje argument do polecenia instrumentacji.

void cancel()

Prośba o anulowanie tego testu.

IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

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

String getPackageName()

Zwraca nazwę pakietu ostatniej dodanej klasy Java.

String getRunnerName()

Zwraca domyślną nazwę klasy UiAutomatorTestRunner

void removeInstrumentationArg(String name)

Usuwa wcześniej dodany argument.

void run(ITestRunListener... listeners)

Uruchom ten test.

void run( listeners)

Uruchom ten test.

void setAdditionalTestOutputLocation(String additionalTestDataPath)

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

void setClassName(String className)

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

void setClassNames(String[] classNames)

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

void setCoverage(boolean coverage)

Ustawia tryb pokrycia kodu w tym teście.

void setCoverageReportLocation(String arg0)

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

void setDebug(boolean debug)

Ustawia tryb debugowania tego testu.

void setIgnoreSighup(boolean value)

Ustawia opcję w uiautomator, aby ignorować SIGHUP.

void setLogOnly(boolean logOnly)

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

void setMaxTimeToOutputResponse(long timeout, TimeUnit unit)

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

void setMaxTimeout(long maxTimeout, TimeUnit unit)

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

void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)

Ta metoda została wycofana. użyj w zamian zasady setMaxTimeToOutputResponse(long, TimeUnit).

void setMethodName(String className, String testName)

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

void setRunName(String runName)

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

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

void setTestCollection(boolean b)

Ustawia ten test w trybie zbierania testów.

void setTestPackageName(String packageName)

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

void setTestSize(IRemoteAndroidTestRunner.TestSize size)

Ustawia uruchamianie tylko testów o danym rozmiarze.

Metody chronione

String getRunCommand()
String getRunnerPath()

Publiczne konstruktory

UiAutomatorRunner

public UiAutomatorRunner (IDevice remoteDevice, 
                String[] jarPaths, 
                String runnerPath)

Tworzenie UiAutomatorRunner do uruchamiania testów automatyzacji interfejsu

Parametry
remoteDevice IDevice: urządzenie zdalne, z którym chcesz wejść w interakcję: uruchomić test, zebrać wyniki itp.
jarPaths String: ścieżki do plików JAR, w których znajdują się przypadki testowe UI Automator; ścieżki muszą być bezwzględne lub względne w stosunku do /data/local/tmp/ na urządzeniu.
runnerPath String: alternatywny program uruchamiający uiautomator, może być null, w tym przypadku zostanie użyty domyślny

Metody publiczne

addBooleanArg

public 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 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 void cancel ()

Prośba o anulowanie tego testu.

getCoverageOutputType

public IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

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

Zwroty
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public String getPackageName ()

Zwraca nazwę pakietu ostatniej dodanej klasy Java.

Zwroty
String

getRunnerName

public String getRunnerName ()

Zwraca domyślną nazwę klasy UiAutomatorTestRunner

Zwroty
String

removeInstrumentationArg

public void removeInstrumentationArg (String name)

Usuwa wcześniej dodany argument.

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

home run

public void run (ITestRunListener... listeners)

Uruchom ten test.

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

Parametry
listeners ITestRunListener: nasłuchuje wyników testu.
Zgłasza
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

home run

public void run ( listeners)

Uruchom ten test.

Parametry
listeners : zbiór detektorów wyników testów
Zgłasza
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

setAdditionalTestOutputLocation

public 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 void setClassName (String className)

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

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

setClassNames

public 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 void setCoverage (boolean coverage)

Ustawia tryb pokrycia kodu w tym teście.

Parametry
coverage boolean

setCoverageReportLocation

public void setCoverageReportLocation (String arg0)

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

Parametry
arg0 String

setDebug

public void setDebug (boolean debug)

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

Parametry
debug boolean

setIgnoreSighup

public void setIgnoreSighup (boolean value)

Ustawia opcję w uiautomator, aby ignorować SIGHUP.

Parametry
value boolean: ignoruj sygnał, jeśli wartość to „true”.

setLogOnly

public void setLogOnly (boolean logOnly)

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

Parametry
logOnly boolean

setMaxTimeToOutputResponse

public void setMaxTimeToOutputResponse (long timeout, 
                TimeUnit unit)

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

Pozwala to ustawić limit 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
timeout long: maksymalny czas, w którym polecenie może nie generować żadnej odpowiedzi. Wartość 0 oznacza, że metoda będzie czekać w nieskończoność (dopóki receiver nie anuluje wykonania) na dane wyjściowe polecenia i nigdy nie zgłosi wyjątku.
unit TimeUnit: jednostki dla wartości innych niż zero w polach maxTimeToOutputResponse i maxTimeout.

setMaxTimeout

public void setMaxTimeout (long maxTimeout, 
                TimeUnit unit)

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

Pozwala to ustawić limit 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 generować żadnej odpowiedzi. Wartość 0 oznacza, że metoda będzie czekać w nieskończoność (dopóki receiver nie anuluje wykonania) na dane wyjściowe polecenia i nigdy nie zgłosi wyjątku.
unit TimeUnit: jednostki dla wartości innych niż zero w polach maxTimeToOutputResponse i maxTimeout.

setMaxtimeToOutputResponse

public void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

Ta metoda została wycofana.
Użyj w zamian zasady setMaxTimeToOutputResponse(long, TimeUnit).

Parametry
maxTimeToOutputResponse int

setMethodName

public void setMethodName (String className, 
                String testName)

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

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

setRunName

public void setRunName (String runName)

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

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

setTestCollection

public void setTestCollection (boolean b)

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 testów wymagane do pomyślnego zebrania testów zostaną ustawione.

Parametry
b boolean

setTestPackageName

public 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 nazwa pakietu (np. x.y.z)

setTestSize

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

Metody chronione

getRunCommand

protected String getRunCommand ()

Zwroty
String

getRunnerPath

protected String getRunnerPath ()

Zwroty
String