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

Konstruktory publiczne

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

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, Collection<ITestRunListener> listeners)

Utwórz parser wyników instrumentacji InstrumentationResultParser, którego można użyć do analizowania danych wyjściowych.

String getAmInstrumentCommand()
IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

Zwraca typ pokrycia testem 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)

Wykonaj ten test.

void run(Collection<ITestRunListener> listeners)

Wykonaj 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 do rejestrowania – pomija wykonanie testu.

void setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

Określa maksymalny czas między wynikami 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(ITestRunListener)

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.

Konstruktory publiczne

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żywa domyślnego modelu statusReporterMode.

Parametry
packageName String: pakiet aplikacji na Androida zawierający testy do uruchomienia
runnerName String: narzędzie do przeprowadzania testów z instrumentacją. Jeśli wartość to null, używany będzie domyślny moduł wykonawczy.
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 Androida.

Parametry
packageName String: pakiet aplikacji na Androida zawierający testy do uruchomienia
runnerName String: narzędzie do przeprowadzania testów z instrumentacją. Jeśli wartość to null, używany będzie domyślny moduł wykonawczy.
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, 
                Collection<ITestRunListener> listeners)

Utwórz parser wyników instrumentacji InstrumentationResultParser, którego można użyć do analizowania danych wyjściowych.

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

getAmInstrumentCommand

public String getAmInstrumentCommand ()

Zwraca
String

getCoverageOutputType

public IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

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

Zwraca
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public String getPackageName ()

Zwraca nazwę pakietu aplikacji.

Zwraca
String

getRunOptions

public String getRunOptions ()

Zwraca opcje polecenia am instrument.

Zwraca
String

getRunnerName

public String getRunnerName ()

Zwraca nazwę wykonawcy.

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

Wykonaj ten test.

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

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

home run

public void run (Collection<ITestRunListener> listeners)

Wykonaj ten test.

Parametry
listeners Collection: zbiór detektorów wyników testów
Zgłasza
AdbCommandRejectedException
IOException
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 i jednoznaczna 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 uruchamiania testów 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 do rejestrowania – pomija wykonanie testu.

Parametry
logOnly boolean

setMaxTimeToOutputResponse

public 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 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 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 i jednoznaczna 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(ITestRunListener)

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 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 i jednoznaczna 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 żadnych argumentów, zwraca pusty ciąg.

Zwraca
String

getRunnerPath

protected String getRunnerPath ()

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

Zwraca
String