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

protected boolean mInstrumentSdkInSandbox

protected boolean mInstrumentSdkSandbox

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 IConfiguration dla tego testu.

String getCoverageTarget ()

Uzyskaj wcześniej ustawiony zasięgTarget za pomocą setCoverageTarget(String) .

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ą IConfiguration .

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ę IMetricCollector zdefiniowanych dla przebiegu testu.

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 ListInstrumentationParser używany do analizowania zapytań „pm list instrumentation”.

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

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

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

weźAbi

public IAbi getAbi ()

Zwroty
IAbi

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

ustawAbi

public void setAbi (IAbi abi)

Parametry
abi IAbi

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 : testy do uruchomienia

ustaw animację okna

public void setWindowAnimation (boolean windowAnimation)

Parametry
windowAnimation boolean

Metody chronione

wykluczNiewykonane

protected static  excludeNonExecuted (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