RemoteAndroidTestRunner

public class RemoteAndroidTestRunner
extends Object implements IRemoteAndroidTestRunner

java.lang.Object
   ↳ com.android.ddmlib.testrunner.RemoteAndroidTestRunner

Zdalnie uruchamia polecenie testowe Androida i zgłasza wyniki.

Podsumowanie

Publiczne konstruktory

RemoteAndroidTestRunner(String packageName, IShellEnabledDevice remoteDevice)

Konstruktor alternatywny.

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice)

Konstruktor alternatywny.

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice, RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

Tworzy zdalny program do uruchamiania testów na Androidzie.

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.

IInstrumentationResultParser createParser(String runName, listeners)

Utwórz InstrumentationResultParser, który będzie używany do analizowania danych wyjściowych instrumentacji.

String getAmInstrumentCommand()
IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

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

String getPackageName()

Zwraca nazwę pakietu aplikacji.

String getRunOptions()

Zwraca opcje polecenia am instrument.

String getRunnerName()

Zwraca nazwę wykonawcy.

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 reportPath)

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

void setDebug(boolean debug)

Ustawia tryb debugowania tego testu.

void setLogOnly(boolean logOnly)

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

void setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

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

void setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)

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

void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)
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 setRunOptions(String options)

Ustawia opcje polecenia am instrument.

void setTestCollection(boolean collect)

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 getArgsCommand()

Zwraca pełną składnię wiersza poleceń instrumentacji dla podanych argumentów instrumentacji.

String getRunnerPath()

Zwraca pełną ścieżkę komponentu instrumentacji.

Publiczne konstruktory

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                IShellEnabledDevice remoteDevice)

Konstruktor alternatywny. Używa domyślnego narzędzia do uruchamiania testów.

Parametry
packageName String: pakiet aplikacji na Androida zawierający testy do uruchomienia.
remoteDevice IShellEnabledDevice: urządzenie z Androidem, na którym mają być przeprowadzane testy.

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice)

Konstruktor alternatywny. Używana jest domyślna wartość statusReporterMode.

Parametry
packageName String: pakiet aplikacji na Androida zawierający testy do uruchomienia.
runnerName String: program do przeprowadzania testów z instrumentacją. Jeśli wartość to null, używany będzie domyślny moduł uruchamiający.
remoteDevice IShellEnabledDevice: urządzenie z Androidem, na którym mają być przeprowadzane testy.

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice, 
                RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

Tworzy zdalny program do uruchamiania testów na Androidzie.

Parametry
packageName String: pakiet aplikacji na Androida zawierający testy do uruchomienia.
runnerName String: program do przeprowadzania testów z instrumentacją. Jeśli wartość to null, używany będzie domyślny moduł uruchamiający.
remoteDevice IShellEnabledDevice: urządzenie z Androidem, na którym mają być przeprowadzane testy.
statusReporterMode RemoteAndroidTestRunner.StatusReporterMode: tryb raportowania stanu, który ma być używany w przypadku polecenia instrumentu.

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.

createParser

public IInstrumentationResultParser createParser (String runName, 
                 listeners)

Utwórz InstrumentationResultParser, który będzie używany do analizowania danych wyjściowych instrumentacji.

Parametry
runName String: Nazwa uruchomienia, którego chcesz użyć.
listeners : detektory, do których należy zgłaszać wyniki.
Zwroty
IInstrumentationResultParser Instancja InstrumentationResultParser.

getAmInstrumentCommand

public String getAmInstrumentCommand ()

Zwroty
String

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

Zwroty
String

getRunOptions

public String getRunOptions ()

Zwraca opcje polecenia am instrument.

Zwroty
String

getRunnerName

public String getRunnerName ()

Zwraca nazwę wykonawcy.

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 reportPath)

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

Parametry
reportPath 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

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 maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

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
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ść (dopóki receiver nie anuluje wykonania) na dane wyjściowe polecenia i nigdy nie zgłosi wyjątku.
maxTimeUnits TimeUnit: jednostki dla wartości innych niż zero w polach maxTimeToOutputResponse i maxTimeout.

setMaxTimeout

public void setMaxTimeout (long maxTimeout, 
                TimeUnit maxTimeUnits)

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.
maxTimeUnits TimeUnit: jednostki dla wartości innych niż zero w polach maxTimeToOutputResponse i maxTimeout.

setMaxtimeToOutputResponse

public void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

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.

setRunOptions

public void setRunOptions (String options)

Ustawia opcje polecenia am instrument. Pełną listę opcji znajdziesz w pliku com/android/commands/am/Am.java.

Parametry
options String

setTestCollection

public void setTestCollection (boolean collect)

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
collect 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

getArgsCommand

protected String getArgsCommand ()

Zwraca pełną składnię wiersza poleceń instrumentacji dla podanych argumentów instrumentacji. Jeśli nie podano argumentów, zwraca pusty ciąg.

Zwroty
String

getRunnerPath

protected String getRunnerPath ()

Zwraca pełną ścieżkę komponentu instrumentacji.

Zwroty
String