Test oprzyrządowania

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

java.lang.Obiekt
↳	com.android.tradefed.testtype.InstrumentationTest

Znane bezpośrednie podklasy AndroidJUnitTest , CodeCoverageTest AndroidJUnitTest Test, który uruchamia pakiet testowy 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, 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 IConfiguration dla tego testu.
String	getCoverageTarget () Uzyskaj wcześniej ustawiony targetTarget za pomocą setCoverageTarget(String) .
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ą 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 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ę IMetricCollector s 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 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 ListInstrumentationParser używany do analizowania zapytań „pm list instrumentation”.
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

dostaćAbi

public IAbi getAbi ()

Zwroty
IAbi

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

ustaw Abi

public void setAbi (IAbi abi)

Parametry
abi	IAbi

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

ustaw animację okna

public void setWindowAnimation (boolean windowAnimation)

Parametry
windowAnimation	boolean

Metody chronione

wyklucz Niewykonane

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