Test oprzyrządowania
public class InstrumentationTest
extends Object
implements IDeviceTest , IRemoteTest , ITestCollector , IAbiReceiver , IConfigurationReceiver , IMetricCollectorReceiver
Obiekt Java.lang.Object | |
↳ | com.android.tradefed.testtype.InstrumentationTest |
Test uruchamiający pakiet testów oprzyrządowania na danym urządzeniu.
Streszczenie
Pola | |
---|---|
public static final String | RUN_TESTS_AS_USER_KEY |
public static final String | RUN_TESTS_ON_SDK_SANDBOX |
protected boolean | mDebug
|
Konstruktorzy publiczni | |
---|---|
InstrumentationTest () |
Metody publiczne | |
---|---|
void | addDeviceListeners ( extraListeners) addDeviceListeners ( extraListeners) Pozwala dodać więcej niestandardowych słuchaczy do biegacza |
void | addInstrumentationArg (String key, String value) Dodaj argument, który należy podać podczas uruchamiania testów oprzyrządowania. |
IAbi | getAbi () |
IConfiguration | getConfiguration () Pobiera |
String | getCoverageTarget () Uzyskaj wcześniej ustawiony zasięgTarget za pomocą |
boolean | getDebug () Pobierz ustawienie debugowania oprzyrządowania. |
ITestDevice | getDevice () Oddaj urządzenie do testu. |
String | getForceAbi () |
long | getMaxTimeout () Zwraca maksymalny limit czasu ustawiony dla oprzyrządowania. |
String | getPackageName () Pobierz pakiet manifestu systemu Android do uruchomienia. |
String | getRunName () Uzyskaj niestandardową nazwę przebiegu testu, która zostanie dostarczona słuchaczowi |
String | getRunnerName () Pobiera moduł uruchamiający instrumentację systemu Android, który ma być używany. |
void | run ( TestInformation testInfo, ITestInvocationListener listener) Uruchamia testy i raportuje wyniki słuchaczowi. |
void | setAbi ( IAbi abi) |
void | setClassName (String testClassName) Opcjonalnie ustaw nazwę klasy testowej do uruchomienia. |
void | setCollectTestsOnly (boolean shouldCollectTest) Włącza lub wyłącza tryb zbierania testów |
void | setCollectsTestsShellTimeout (int timeout) Ta metoda jest przestarzała. Ta metoda jest nieskuteczna |
void | setConfiguration ( IConfiguration config) Wstrzykuje używaną |
void | setCoverageTarget (String coverageTarget) Ustaw docelowy zasięg tego testu. |
void | setDebug (boolean debug) Ustaw ustawienie debugowania oprzyrządowania. |
void | setDevice ( ITestDevice device) Wstrzyknij testowane urządzenie. |
void | setEnforceFormat (boolean enforce) Ustaw True, jeśli wymuszamy format wyjściowy oprzyrządowania AJUR. |
void | setForceAbi (String abi) Ustawia opcję force-abi. |
void | setInstallFile (File installFile) Ustaw opcjonalny plik do zainstalowania zawierający testy. |
void | setIsolatedStorage (boolean isolatedStorage) Ustaw, czy chcesz używać izolowanego magazynu. |
void | setMethodName (String testMethodName) Opcjonalnie ustaw metodę testową na uruchomienie. |
void | setMetricCollectors ( collectors) setMetricCollectors ( collectors) Ustawia listę |
void | setPackageName (String packageName) Ustaw pakiet manifestu systemu Android do uruchomienia. |
void | setReRunUsingTestFile (boolean reRunUsingTestFile) Ustawia opcję --rerun-from-file. |
void | setRerunMode (boolean rerun) Opcjonalnie ustaw tryb ponownego uruchomienia. |
void | setRunName (String runName) Ustaw niestandardową nazwę przebiegu testu, która zostanie udostępniona odbiornikowi |
void | setRunnerName (String runnerName) Opcjonalnie skonfiguruj moduł uruchamiający oprzyrządowanie systemu Android do użycia. |
void | setShellTimeout (long timeout) Opcjonalnie ustaw maksymalny czas (w milisekundach) oczekiwania na wyjście powłoki z urządzenia. |
void | setTestFilePathOnDevice (String testFilePathOnDevice) Opcjonalnie ustaw ścieżkę do pliku znajdującego się na urządzeniu, który powinien zawierać listę oddzielonych liniami klas testowych i metod (format: com.foo.Class#method), które mają zostać uruchomione. |
void | setTestPackageName (String testPackageName) Ustawia filtr pakietu testowego. |
void | setTestSize (String size) Opcjonalnie ustaw rozmiar testu do uruchomienia. |
void | setTestTimeout (long timeout) Opcjonalnie ustaw maksymalny czas (w milisekundach) dla każdego pojedynczego przebiegu testowego. |
void | setTestsToRun ( tests) setTestsToRun ( tests) Ustaw kolekcję testów, które powinny być wykonywane przez ten InstrumentationTest. |
void | setWindowAnimation (boolean windowAnimation) |
Metody chronione | |
---|---|
static | excludeNonExecuted ( TestRunResult results) Odfiltruj „NOT_EXECUTED”, aby śledzić, co należy uruchomić ponownie. |
String | getClassName () Pobierz nazwę klasy do uruchomienia. |
ListInstrumentationParser | getListInstrumentationParser () Pobierz |
String | getMethodName () Uruchom metodę testową. |
String | getTestPackageName () Pobierz testowy pakiet Java do uruchomienia. |
String | queryRunnerName () Zapytaj o urządzenie, aby mógł z niego skorzystać biegacz testowy. |
void | setRunnerArgs (IRemoteAndroidTestRunner runner) |
Pola
RUN_TESTS_AS_USER_KEY
public static final String RUN_TESTS_AS_USER_KEY
RUN_TESTS_ON_SDK_SANDBOX
public static final String RUN_TESTS_ON_SDK_SANDBOX
mDebug
protected boolean mDebug
Konstruktorzy publiczni
Test oprzyrządowania
public InstrumentationTest ()
Metody publiczne
dodaj słuchaczy urządzeń
public void addDeviceListeners (extraListeners)
Pozwala dodać więcej niestandardowych słuchaczy do biegacza
Parametry | |
---|---|
extraListeners |
dodajInstrumentationArg
public void addInstrumentationArg (String key, String value)
Dodaj argument, który należy podać podczas uruchamiania testów oprzyrządowania.
Parametry | |
---|---|
key | String : nazwa argumentu |
value | String : wartość argumentu |
pobierz konfigurację
public IConfiguration getConfiguration ()
Pobiera IConfiguration
dla tego testu.
Zwroty | |
---|---|
IConfiguration |
uzyskaj cel pokrycia
public String getCoverageTarget ()
Uzyskaj wcześniej ustawiony zasięgTarget za pomocą setCoverageTarget(String)
.
Zwroty | |
---|---|
String |
pobierzDebug
public boolean getDebug ()
Pobierz ustawienie debugowania oprzyrządowania.
Zwroty | |
---|---|
boolean | Ustawienie debugowania logicznego. |
pobierz urządzenie
public ITestDevice getDevice ()
Oddaj urządzenie do testu.
Zwroty | |
---|---|
ITestDevice | ITestDevice |
pobierzForceAbi
public String getForceAbi ()
Zwroty | |
---|---|
String |
uzyskajMaxTimeout
public long getMaxTimeout ()
Zwraca maksymalny limit czasu ustawiony dla oprzyrządowania.
Zwroty | |
---|---|
long |
pobierz nazwę pakietu
public String getPackageName ()
Pobierz pakiet manifestu systemu Android do uruchomienia.
Zwroty | |
---|---|
String |
getRunName
public String getRunName ()
Uzyskaj niestandardową nazwę przebiegu testu, która zostanie dostarczona słuchaczowi
Zwroty | |
---|---|
String |
pobierz nazwę biegacza
public String getRunnerName ()
Pobiera moduł uruchamiający instrumentację systemu Android, który ma być używany.
Zwroty | |
---|---|
String |
uruchomić
public void run (TestInformation testInfo, ITestInvocationListener listener)
Uruchamia testy i raportuje wyniki słuchaczowi.
Parametry | |
---|---|
testInfo | TestInformation : Obiekt TestInformation zawierający informacje przydatne do uruchamiania testów. |
listener | ITestInvocationListener : ITestInvocationListener wyników testów |
Rzuca | |
---|---|
DeviceNotAvailableException |
nazwa_klasy zestawu
public void setClassName (String testClassName)
Opcjonalnie ustaw nazwę klasy testowej do uruchomienia.
Parametry | |
---|---|
testClassName | String |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
Włącza lub wyłącza tryb zbierania testów
setCollectsTestsShellTimeout
public void setCollectsTestsShellTimeout (int timeout)
Ta metoda jest przestarzała.
Ta metoda jest nieskuteczna
Ustaw maksymalny czas w ms, aby uwzględnić „maksymalny czas odpowiedzi wyjściowej powłoki” podczas zbierania testów.
Parametry | |
---|---|
timeout | int |
ustaw konfigurację
public void setConfiguration (IConfiguration config)
Wstrzykuje używaną IConfiguration
.
Parametry | |
---|---|
config | IConfiguration |
ustaw cel pokrycia
public void setCoverageTarget (String coverageTarget)
Ustaw docelowy zasięg tego testu.
Obecnie nieużywany. Ta metoda jest po prostu obecna, więc pokrycieTarget można później pobrać za pomocą getCoverageTarget()
Parametry | |
---|---|
coverageTarget | String |
setDebug
public void setDebug (boolean debug)
Ustaw ustawienie debugowania oprzyrządowania.
Parametry | |
---|---|
debug | boolean : wartość logiczna, na którą należy ustawić debugowanie oprzyrządowania. |
ustaw urządzenie
public void setDevice (ITestDevice device)
Wstrzyknij testowane urządzenie.
Parametry | |
---|---|
device | ITestDevice : ITestDevice do użycia |
setEnforceFormat
public void setEnforceFormat (boolean enforce)
Ustaw True, jeśli wymuszamy format wyjściowy oprzyrządowania AJUR.
Parametry | |
---|---|
enforce | boolean |
setForceAbi
public void setForceAbi (String abi)
Ustawia opcję force-abi.
ustaw plik instalacyjny
public void setInstallFile (File installFile)
Ustaw opcjonalny plik do zainstalowania zawierający testy.
Parametry | |
---|---|
installFile | File : instalowalny ERROR(/File) |
zestawIzolowane miejsce do przechowywania
public void setIsolatedStorage (boolean isolatedStorage)
Ustaw, czy chcesz używać izolowanego magazynu.
Parametry | |
---|---|
isolatedStorage | boolean |
ustawNazwęMetody
public void setMethodName (String testMethodName)
Opcjonalnie ustaw metodę testową na uruchomienie.
Parametry | |
---|---|
testMethodName | String |
setMetricCollectors
public void setMetricCollectors (collectors)
Ustawia listę IMetricCollector
zdefiniowanych dla przebiegu testu.
Parametry | |
---|---|
collectors |
setNazwaPakietu
public void setPackageName (String packageName)
Ustaw pakiet manifestu systemu Android do uruchomienia.
Parametry | |
---|---|
packageName | String |
setReRunUsingTestFile
public void setReRunUsingTestFile (boolean reRunUsingTestFile)
Ustawia opcję --rerun-from-file.
Parametry | |
---|---|
reRunUsingTestFile | boolean |
ustaw tryb ponownego uruchomienia
public void setRerunMode (boolean rerun)
Opcjonalnie ustaw tryb ponownego uruchomienia.
Parametry | |
---|---|
rerun | boolean |
ustawNazwęRun
public void setRunName (String runName)
Ustaw niestandardową nazwę przebiegu testu, która zostanie udostępniona odbiornikowi
Parametry | |
---|---|
runName | String |
setRunnerName
public void setRunnerName (String runnerName)
Opcjonalnie skonfiguruj moduł uruchamiający oprzyrządowanie systemu Android do użycia.
Parametry | |
---|---|
runnerName | String |
ustawShellTimeout
public void setShellTimeout (long timeout)
Opcjonalnie ustaw maksymalny czas (w milisekundach) oczekiwania na wyjście powłoki z urządzenia.
Parametry | |
---|---|
timeout | long |
setTestFilePathOnDevice
public void setTestFilePathOnDevice (String testFilePathOnDevice)
Opcjonalnie ustaw ścieżkę do pliku znajdującego się na urządzeniu, który powinien zawierać listę oddzielonych liniami klas testowych i metod (format: com.foo.Class#method), które mają zostać uruchomione. Jeśli jest ustawione, automatycznie podejmie próbę ponownego uruchomienia testów przy użyciu tego pliku testowego za pośrednictwem InstrumentationFileTest zamiast wykonywania oddzielnych poleceń adb dla każdego pozostałego testu poprzez ponowne uruchomienie.
Parametry | |
---|---|
testFilePathOnDevice | String |
setTestNazwaPakietu
public void setTestPackageName (String testPackageName)
Ustawia filtr pakietu testowego.
Jeśli nie ma wartości null, zostaną wykonane tylko testy w ramach danego pakietu Java.
Zostanie zignorowane, jeśli do setClassName(String)
podano wartość różną od null
Parametry | |
---|---|
testPackageName | String |
ustawRozmiarTestu
public void setTestSize (String size)
Opcjonalnie ustaw rozmiar testu do uruchomienia.
Parametry | |
---|---|
size | String |
ustaw limit czasu testu
public void setTestTimeout (long timeout)
Opcjonalnie ustaw maksymalny czas (w milisekundach) dla każdego pojedynczego przebiegu testowego.
Parametry | |
---|---|
timeout | long |
setTestsToRun
public void setTestsToRun (tests)
Ustaw kolekcję testów, które powinny być wykonywane przez ten InstrumentationTest.
Parametry | |
---|---|
tests |
ustaw animację okna
public void setWindowAnimation (boolean windowAnimation)
Parametry | |
---|---|
windowAnimation | boolean |
Metody chronione
wykluczNiewykonane
protected staticexcludeNonExecuted (TestRunResult results)
Odfiltruj „NOT_EXECUTED”, aby śledzić, co należy uruchomić ponownie.
Parametry | |
---|---|
results | TestRunResult |
Zwroty | |
---|---|
pobierzNazwęKlasy
protected String getClassName ()
Pobierz nazwę klasy do uruchomienia.
Zwroty | |
---|---|
String |
getListInstrumentationParser
protected ListInstrumentationParser getListInstrumentationParser ()
Pobierz ListInstrumentationParser
używany do analizowania zapytań „pm list instrumentation”.
Zwroty | |
---|---|
ListInstrumentationParser |
pobierzNazwęMetody
protected String getMethodName ()
Uruchom metodę testową.
Zwroty | |
---|---|
String |
pobierz nazwę pakietu testowego
protected String getTestPackageName ()
Pobierz testowy pakiet Java do uruchomienia.
Zwroty | |
---|---|
String |
nazwa_zapytaniaRunner
protected String queryRunnerName ()
Zapytaj o urządzenie, aby mógł z niego skorzystać biegacz testowy.
Zwroty | |
---|---|
String | nazwa pierwszego programu uruchamiającego test, która pasuje do pakietu lub wartość null, jeśli żadnej nie znajdziemy. |
Rzuca | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setRunnerArgs
protected void setRunnerArgs (IRemoteAndroidTestRunner runner)
Parametry | |
---|---|
runner | IRemoteAndroidTestRunner |