Test oprzyrządowania
public class InstrumentationTest
extends Object
implements IDeviceTest , IRemoteTest , ITestCollector , IAbiReceiver , IConfigurationReceiver , IMetricCollectorReceiver
java.lang.Obiekt | |
↳ | com.android.tradefed.testtype.InstrumentationTest |
Test, który uruchamia 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
|
Konstruktory publiczne | |
---|---|
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 do podania podczas uruchamiania testów oprzyrządowania. |
IAbi | getAbi () |
IConfiguration | getConfiguration () Pobiera |
String | getCoverageTarget () Uzyskaj wcześniej ustawiony targetTarget za pomocą |
boolean | getDebug () Pobierz ustawienie debugowania Instrumentacji. |
ITestDevice | getDevice () Przetestuj urządzenie. |
String | getForceAbi () |
long | getMaxTimeout () Zwraca maksymalny limit czasu ustawiony dla instrumentacji. |
String | getPackageName () Pobierz pakiet manifestu systemu Android do uruchomienia. |
String | getRunName () Pobierz niestandardową nazwę przebiegu testu, która zostanie przekazana odbiornikowi |
String | getRunnerName () Pobiera program uruchamiający Instrumentację systemu Android do użycia. |
void | run ( TestInformation testInfo, ITestInvocationListener listener) Uruchamia testy i przekazuje 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 bezobsługowa |
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 wartość True, jeśli wymuszamy format wyjściowy instrumentacji AJUR. |
void | setForceAbi (String abi) Ustawia opcję force-abi. |
void | setInstallFile (File installFile) Ustaw opcjonalny plik do zainstalowania, który zawiera testy. |
void | setIsolatedStorage (boolean isolatedStorage) Ustaw, czy chcesz używać izolowanej pamięci masowej. |
void | setMethodName (String testMethodName) Opcjonalnie ustaw metodę testową do uruchomienia. |
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 uruchamiania. |
void | setRunName (String runName) Ustaw niestandardową nazwę przebiegu testu, która zostanie przekazana odbiornikowi |
void | setRunnerName (String runnerName) Opcjonalnie ustaw narzędzie do uruchamiania Instrumentacji systemu Android do użycia. |
void | setShellTimeout (long timeout) Opcjonalnie ustaw maksymalny czas (w milisekundach) oczekiwania na dane wyjściowe 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ę rozdzielonych wierszami klas i metod testowych (format: com.foo.Class#method) do uruchomienia. |
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 testu. |
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” w celu śledzenia, co należy ponownie uruchomić. |
String | getClassName () Pobierz nazwę klasy do uruchomienia. |
ListInstrumentationParser | getListInstrumentationParser () Pobierz |
String | getMethodName () Pobierz metodę testową do uruchomienia. |
String | getTestPackageName () Pobierz testowy pakiet java do uruchomienia. |
String | queryRunnerName () Zapytaj o urządzenie, którego może użyć osoba przeprowadzająca testy. |
void | setRunnerArgs (IRemoteAndroidTestRunner runner) |
Pola
RUN_TETS_AS_USER_KEY
public static final String RUN_TESTS_AS_USER_KEY
RUN_TETS_ON_SDK_SANDBOX
public static final String RUN_TESTS_ON_SDK_SANDBOX
mDebug
protected boolean mDebug
Konstruktory publiczne
Test oprzyrządowania
public InstrumentationTest ()
Metody publiczne
dodaj odbiorniki urządzeń
public void addDeviceListeners (extraListeners)
Pozwala dodać więcej niestandardowych słuchaczy do biegacza
Parametry | |
---|---|
extraListeners |
addInstrumentationArg
public void addInstrumentationArg (String key, String value)
Dodaj argument do podania podczas uruchamiania testów oprzyrządowania.
Parametry | |
---|---|
key | String : nazwa argumentu |
value | String : wartość argumentu |
getConfiguration
public IConfiguration getConfiguration ()
Pobiera IConfiguration
dla tego testu.
Zwroty | |
---|---|
IConfiguration |
pobierz cel pokrycia
public String getCoverageTarget ()
Uzyskaj wcześniej ustawiony targetTarget za pomocą setCoverageTarget(String)
.
Zwroty | |
---|---|
String |
getDebug
public boolean getDebug ()
Pobierz ustawienie debugowania Instrumentacji.
Zwroty | |
---|---|
boolean | Ustawienie debugowania wartości logicznych. |
pobierzUrządzenie
public ITestDevice getDevice ()
Przetestuj urządzenie.
Zwroty | |
---|---|
ITestDevice | ITestDevice |
PobierzForceAbi
public String getForceAbi ()
Zwroty | |
---|---|
String |
getMaxTimeout
public long getMaxTimeout ()
Zwraca maksymalny limit czasu ustawiony dla instrumentacji.
Zwroty | |
---|---|
long |
pobierzNazwęPakietu
public String getPackageName ()
Pobierz pakiet manifestu systemu Android do uruchomienia.
Zwroty | |
---|---|
String |
getRunNazwa
public String getRunName ()
Pobierz niestandardową nazwę przebiegu testu, która zostanie przekazana odbiornikowi
Zwroty | |
---|---|
String |
getRunnerNazwa
public String getRunnerName ()
Pobiera program uruchamiający Instrumentację systemu Android do użycia.
Zwroty | |
---|---|
String |
uruchomić
public void run (TestInformation testInfo, ITestInvocationListener listener)
Uruchamia testy i przekazuje wyniki słuchaczowi.
Parametry | |
---|---|
testInfo | TestInformation : Obiekt TestInformation zawierający informacje przydatne do uruchamiania testów. |
listener | ITestInvocationListener : ITestInvocationListener wyników testu |
Rzuty | |
---|---|
DeviceNotAvailableException |
ustawNazwaKlasy
public void setClassName (String testClassName)
Opcjonalnie ustaw nazwę klasy testowej do uruchomienia.
Parametry | |
---|---|
testClassName | String |
ustawZbierzTylko testy
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 bezobsługowa
Ustaw maksymalny czas w ms, aby umożliwić „maksymalny czas do odpowiedzi wyjściowej powłoki” podczas zbierania testów.
Parametry | |
---|---|
timeout | int |
zestawKonfiguracja
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 CoverTarget 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ą ma zostać ustawione ustawienie debugowania instrumentacji. |
ustaw urządzenie
public void setDevice (ITestDevice device)
Wstrzyknij testowane urządzenie.
Parametry | |
---|---|
device | ITestDevice : ITestDevice do użycia |
ustawWymuśFormat
public void setEnforceFormat (boolean enforce)
Ustaw wartość True, jeśli wymuszamy format wyjściowy instrumentacji AJUR.
Parametry | |
---|---|
enforce | boolean |
ustawForceAbi
public void setForceAbi (String abi)
Ustawia opcję force-abi.
ustaw plik instalacyjny
public void setInstallFile (File installFile)
Ustaw opcjonalny plik do zainstalowania, który zawiera testy.
Parametry | |
---|---|
installFile | File : instalowalny ERROR(/File) |
zestawIzolowanePrzechowywanie
public void setIsolatedStorage (boolean isolatedStorage)
Ustaw, czy chcesz używać izolowanej pamięci masowej.
Parametry | |
---|---|
isolatedStorage | boolean |
ustawNazwaMetody
public void setMethodName (String testMethodName)
Opcjonalnie ustaw metodę testową do uruchomienia.
Parametry | |
---|---|
testMethodName | String |
setMetricCollectors
public void setMetricCollectors (collectors)
Ustawia listę IMetricCollector
s zdefiniowanych dla przebiegu testu.
Parametry | |
---|---|
collectors |
ustaw nazwę pakietu
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 |
ustawTryb ponownego uruchomienia
public void setRerunMode (boolean rerun)
Opcjonalnie ustaw tryb ponownego uruchamiania.
Parametry | |
---|---|
rerun | boolean |
setRunNazwa
public void setRunName (String runName)
Ustaw niestandardową nazwę przebiegu testu, która zostanie przekazana odbiornikowi
Parametry | |
---|---|
runName | String |
ustawImię Biegacza
public void setRunnerName (String runnerName)
Opcjonalnie ustaw narzędzie do uruchamiania Instrumentacji systemu Android do użycia.
Parametry | |
---|---|
runnerName | String |
setShellTimeout
public void setShellTimeout (long timeout)
Opcjonalnie ustaw maksymalny czas (w milisekundach) oczekiwania na dane wyjściowe powłoki z urządzenia.
Parametry | |
---|---|
timeout | long |
ustawŚcieżkęPlikuTestowegoNaUrządzeniu
public void setTestFilePathOnDevice (String testFilePathOnDevice)
Opcjonalnie ustaw ścieżkę do pliku znajdującego się na urządzeniu, który powinien zawierać listę rozdzielonych wierszami klas i metod testowych (format: com.foo.Class#method) do uruchomienia. Jeśli jest ustawiona, automatycznie podejmie próbę ponownego uruchomienia testów przy użyciu tego pliku testowego za pomocą InstrumentationFileTest
zamiast wykonywania oddzielnych poleceń adb dla każdego pozostałego testu przez ponowne uruchomienie.
Parametry | |
---|---|
testFilePathOnDevice | String |
ustaw nazwę pakietu testowego
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 zignorowany, jeśli do setClassName(String)
podano wartość różną od null
Parametry | |
---|---|
testPackageName | String |
ustaw rozmiar testu
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 testu.
Parametry | |
---|---|
timeout | long |
ustaw testy do uruchomienia
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
wyklucz Niewykonane
protected staticexcludeNonExecuted (TestRunResult results)
Odfiltruj „NOT_EXECUTED” w celu śledzenia, co należy ponownie uruchomić.
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 |
getMethodName
protected String getMethodName ()
Pobierz metodę testową do uruchomienia.
Zwroty | |
---|---|
String |
pobierz nazwę pakietu testowego
protected String getTestPackageName ()
Pobierz testowy pakiet java do uruchomienia.
Zwroty | |
---|---|
String |
nazwaRunner zapytania
protected String queryRunnerName ()
Zapytaj o urządzenie, którego może użyć osoba przeprowadzająca testy.
Zwroty | |
---|---|
String | pierwsza nazwa biegacza testu, która pasuje do pakietu lub wartość null, jeśli takiej nie znajdziemy. |
Rzuty | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setRunnerArgs
protected void setRunnerArgs (IRemoteAndroidTestRunner runner)
Parametry | |
---|---|
runner | IRemoteAndroidTestRunner |