IRemoteAndroidTestRunner

public interface IRemoteAndroidTestRunner

com.android.ddmlib.testrunner.IRemoteAndroidTestRunner

Znane podklasy pośrednie AndroidTestOrchestratorRemoteTestRunner, DefaultRemoteAndroidTestRunner, RemoteAndroidTestRunner, UiAutomatorRunner AndroidTestOrchestratorRemoteTestRunner Uruchamia test z instrumentacją na Androidzie za pomocą polecenia adb i AndroidTestOrchestrator.  DefaultRemoteAndroidTestRunner Rozszerzenie biblioteki ddmlib RemoteAndroidTestRunner, które umożliwia ustawienie domyślnych wartości w przypadkach użycia Tradefed.  RemoteAndroidTestRunner Zdalnie uruchamia polecenie testowe Androida i zgłasza wyniki.  UiAutomatorRunner Uruchamia test UI Automator na urządzeniu i zgłasza wyniki.

---

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 testami 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(ITestRunListener... listeners) Uruchom ten test.
abstract void	run( listeners) Uruchom 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 rejestrowania – pomija wykonanie testu.
abstract void	setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits) Określa maksymalny czas między wyjściem 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 zostać zakończona.
abstract void	setMaxtimeToOutputResponse(int maxTimeToOutputResponse) Ta metoda została wycofana. Użyj konta ERROR(/#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() 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

Zobacz też:

• RemoteAndroidTestRunner.addInstrumentationArg(String, String)

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 testami generowanego przez moduł uruchamiający. Zobacz CoverageOutput.

Zwroty
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public abstract String getPackageName ()

Zwraca nazwę pakietu aplikacji.

Zwroty
String

getRunnerName

public abstract String getRunnerName ()

Zwraca nazwę wykonawcy.

Zwroty
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 (ITestRunListener... listeners)

Wykonaj ten test.

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

Parametry
listeners	ITestRunListener: nasłuchuje wyników testu.

Zgłasza
TimeoutException	w przypadku upłynięcia limitu czasu połączenia.
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 danych wyjściowych.
	jeśli połączenie z urządzeniem zostało utracone.

Zobacz też:

• setMaxtimeToOutputResponse(int)

home run

public abstract void run ( listeners)

Wykonaj ten test.

Parametry
listeners	: zbiór detektorów wyników testów

Zgłasza
TimeoutException	w przypadku upłynięcia limitu czasu połączenia.
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 danych wyjściowych.
	jeśli połączenie z urządzeniem zostało utracone.

Zobacz też:

• setMaxtimeToOutputResponse(int)

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

Parametry
logOnly	boolean

setMaxTimeToOutputResponse

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

Zobacz też:

• IShellEnabledDevice.executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, long, TimeUnit)

setMaxTimeout

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

Zobacz też:

• IShellEnabledDevice.executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, long, TimeUnit)

setMaxtimeToOutputResponse

public abstract void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

Ta metoda została wycofana.
Użyj ERROR(/#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 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()

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 testów 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 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.