Ta strona została przetłumaczona przez Cloud Translation API.

Test oprzyrządowania

public class InstrumentationTest
extends Object implements IDeviceTest , IRemoteTest , ITestCollector , IAbiReceiver , IConfigurationReceiver , IMetricCollectorReceiver

Obiekt Java.lang.Object
↳	com.android.tradefed.testtype.InstrumentationTest

Znane bezpośrednie podklasy

AndroidJUnitTest , CodeCoverageTest

Test AndroidJUnit	Test, który uruchamia pakiet testów oprzyrządowania na danym urządzeniu przy użyciu android.support.test.runner.AndroidJUnitRunner.
Test pokrycia kodu	Test, który uruchamia pakiet testów oprzyrządowania na danym urządzeniu i generuje raport pokrycia kodu.

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 `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

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`