InstrumentationTest
public
class
InstrumentationTest
extends Object
implements
IAbiReceiver,
IConfigurationReceiver,
IDeviceTest,
IMetricCollectorReceiver,
IRemoteTest,
ITestCollector
java.lang.Object | |
↳ | com.android.tradefed.testtype.InstrumentationTest |
Test, który uruchamia pakiet testu z instrumentacją na danym urządzeniu.
Podsumowanie
Fieldsem | |
---|---|
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
|
Konstruktory publiczne | |
---|---|
InstrumentationTest()
|
Metody publiczne | |
---|---|
void
|
addDeviceListeners(
Umożliwia dodanie do wykonawcy większej liczby niestandardowych słuchaczy |
void
|
addInstrumentationArg(String key, String value)
Dodaj argument, który należy podać podczas uruchamiania testów instrumentacji. |
IAbi
|
getAbi()
|
IConfiguration
|
getConfiguration()
Pobiera |
String
|
getCoverageTarget()
Pobierz wartość coverageTarget ustawioną wcześniej za pomocą |
boolean
|
getDebug()
Pobranie ustawienia debugowania instrumentacji. |
ITestDevice
|
getDevice()
Przygotuj urządzenie do testowania. |
String
|
getForceAbi()
|
long
|
getMaxTimeout()
Zwraca maksymalny limit czasu ustawiony dla pomiarów. |
String
|
getPackageName()
Uruchom pakiet pliku manifestu Androida. |
String
|
getRunName()
Pobierz nazwę niestandardowego testu, która zostanie podana słuchaczowi. |
String
|
getRunnerName()
Pobiera narzędzie do pomiarów Androida, które ma być używane. |
boolean
|
isOrchestrator()
|
void
|
run(TestInformation testInfo, ITestInvocationListener listener)
Przeprowadza testy i przekazuje wyniki do odbiorcy. |
void
|
setAbi(IAbi abi)
|
void
|
setClassName(String testClassName)
Opcjonalnie ustaw nazwę klasy testowej do uruchomienia. |
void
|
setCollectTestsOnly(boolean shouldCollectTest)
Włącza lub wyłącza testowy tryb zbierania danych |
void
|
setCollectsTestsShellTimeout(int timeout)
Ta metoda została wycofana. Ta metoda nie jest opcjonalna |
void
|
setConfiguration(IConfiguration config)
Wstrzykuje |
void
|
setCoverageTarget(String coverageTarget)
Ustaw docelowy zakres tego testu. |
void
|
setDebug(boolean debug)
Ustaw ustawienie debugowania instrumentacji. |
void
|
setDevice(ITestDevice device)
Wstrzyknij urządzenie testowe. |
void
|
setEnforceFormat(boolean enforce)
Ustaw na Prawda, jeśli chcemy narzucić format wyjściowy AJUR dla instrumentacji. |
void
|
setForceAbi(String abi)
Ustawia opcję force-abi. |
void
|
setInstallFile(File installFile)
Wybierz opcjonalny plik do zainstalowania, który zawiera testy. |
void
|
setIsolatedStorage(boolean isolatedStorage)
Określ, czy chcesz używać izolowanego miejsca na dane. |
void
|
setMethodName(String testMethodName)
Opcjonalnie ustaw metodę testowania. |
void
|
setMetricCollectors(
Ustawia listę |
void
|
setOrchestrator(boolean useOrchestrator)
Ustawia opcję --orchestrator. |
void
|
setPackageName(String packageName)
Ustaw pakiet pliku manifestu Androida 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ę testu, która będzie wyświetlana słuchaczowi. |
void
|
setRunnerName(String runnerName)
Opcjonalnie ustaw, który narzędzie do pomiarów Androida ma być używane. |
void
|
setShellTimeout(long timeout)
Opcjonalnie ustaw maksymalny czas (w milisekundach), w którym oczekujesz danych z 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ę klas i metod testowych (w formacie: com.foo.Class#method) do uruchomienia. |
void
|
setTestPackageName(String testPackageName)
Ustawia filtr pakietu testowego. |
void
|
setTestSize(String size)
Opcjonalnie ustaw rozmiar testu. |
void
|
setTestTimeout(long timeout)
Opcjonalnie ustaw maksymalny czas (w milisekundach) dla każdego pojedynczego testu. |
void
|
setTestsToRun(
Ustaw kolekcję testów, które mają być wykonywane przez ten test z instrumentacją. |
void
|
setWindowAnimation(boolean windowAnimation)
|
Chronione metody | |
---|---|
static
|
excludeNonExecuted(TestRunResult results)
W celu śledzenia, które testy należy ponownie uruchomić, odfiltruj wartości „NOT_EXECUTED” i „Skipped”. |
String
|
getClassName()
Uzyskaj nazwę zajęć, które chcesz uruchomić. |
ListInstrumentationParser
|
getListInstrumentationParser()
Pobierz wartość |
String
|
getMethodName()
Uruchom metodę testowania. |
String
|
getTestPackageName()
Uruchom testowy pakiet Java. |
String
|
queryRunnerName()
Przesyłanie zapytania do urządzenia, aby wykonać test. |
void
|
setRunnerArgs(IRemoteAndroidTestRunner runner)
|
Fieldsem
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
Konstruktory publiczne
InstrumentationTest
public InstrumentationTest ()
Metody publiczne
addDeviceListeners
public void addDeviceListeners (extraListeners)
Umożliwia dodanie do wykonawcy większej liczby niestandardowych słuchaczy
Parametry | |
---|---|
extraListeners |
|
addInstrumentationArg
public void addInstrumentationArg (String key, String value)
Dodaj argument, który należy podać podczas wykonywania testów instrumentacji.
Parametry | |
---|---|
key |
String : nazwa argumentu |
value |
String : wartość argumentu |
getConfiguration
public IConfiguration getConfiguration ()
Pobiera IConfiguration
dla tego testu.
Zwroty | |
---|---|
IConfiguration |
getCoverageTarget
public String getCoverageTarget ()
Pobierz wartość coverageTarget ustawioną wcześniej za pomocą setCoverageTarget(String)
.
Zwroty | |
---|---|
String |
getDebug
public boolean getDebug ()
Pobranie ustawienia debugowania instrumentacji.
Zwroty | |
---|---|
boolean |
Ustawienie debugowania typu logicznego. |
getDevice
public ITestDevice getDevice ()
Przygotuj urządzenie do testowania.
Zwroty | |
---|---|
ITestDevice |
ITestDevice |
getForceAbi
public String getForceAbi ()
Zwroty | |
---|---|
String |
getMaxTimeout
public long getMaxTimeout ()
Zwraca maksymalny limit czasu ustawiony dla pomiarów.
Zwroty | |
---|---|
long |
getPackageName
public String getPackageName ()
Uruchom pakiet pliku manifestu Androida.
Zwroty | |
---|---|
String |
getRunName
public String getRunName ()
Pobierz nazwę niestandardowego testu, która zostanie podana słuchaczowi.
Zwroty | |
---|---|
String |
getRunnerName
public String getRunnerName ()
Pobiera narzędzie do pomiarów Androida, które ma być używane.
Zwroty | |
---|---|
String |
isOrchestrator
public boolean isOrchestrator ()
Zwroty | |
---|---|
boolean |
home run
public void run (TestInformation testInfo, ITestInvocationListener listener)
Przeprowadza testy i przekazuje wyniki do odbiorcy.
Parametry | |
---|---|
testInfo |
TestInformation : obiekt TestInformation zawierający przydatne informacje do przeprowadzania testów. |
listener |
ITestInvocationListener : ITestInvocationListener wyników testu |
Rzuty | |
---|---|
DeviceNotAvailableException |
setClassName
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 testowy tryb zbierania danych
setCollectsTestsShellTimeout
public void setCollectsTestsShellTimeout (int timeout)
Ta metoda została wycofana.
Ta metoda nie jest opcjonalna
Ustaw maksymalny czas w ms, aby umożliwić „maksymalny czas oczekiwania na odpowiedź z pudełka” podczas zbierania testów.
Parametry | |
---|---|
timeout |
int |
setConfiguration
public void setConfiguration (IConfiguration config)
Wstrzykuje IConfiguration
w użyciu.
Parametry | |
---|---|
config |
IConfiguration |
setCoverageTarget
public void setCoverageTarget (String coverageTarget)
Ustaw docelowy zakres tego testu.
Obecnie nieużywany. Ta metoda jest obecna tylko po to, aby wartość coverageTarget mogła zostać później pobrana za pomocą getCoverageTarget()
.
Parametry | |
---|---|
coverageTarget |
String |
setDebug
public void setDebug (boolean debug)
Ustaw ustawienie debugowania instrumentacji.
Parametry | |
---|---|
debug |
boolean : wartość logiczna do ustawienia w ustawieniu debugowania instrumentacji. |
setDevice
public void setDevice (ITestDevice device)
Wstrzyknij urządzenie testowe.
Parametry | |
---|---|
device |
ITestDevice : ITestDevice do użycia |
setEnforceFormat
public void setEnforceFormat (boolean enforce)
Ustaw na Prawda, jeśli narzucamy format wyjściowy AJUR dla uinstrumentowania.
Parametry | |
---|---|
enforce |
boolean |
setForceAbi
public void setForceAbi (String abi)
Ustawia opcję force-abi.
setInstallFile
public void setInstallFile (File installFile)
Wybierz opcjonalny plik do zainstalowania, który zawiera testy.
Parametry | |
---|---|
installFile |
File : instalowany ERROR(/File) |
setIsolatedStorage
public void setIsolatedStorage (boolean isolatedStorage)
Określ, czy chcesz używać izolowanego miejsca na dane.
Parametry | |
---|---|
isolatedStorage |
boolean |
setMethodName
public void setMethodName (String testMethodName)
Opcjonalnie ustaw metodę testowania.
Parametry | |
---|---|
testMethodName |
String |
setMetricCollectors
public void setMetricCollectors (collectors)
Ustawia listę IMetricCollector
zdefiniowanych na potrzeby testu.
Parametry | |
---|---|
collectors |
|
setOrchestrator
public void setOrchestrator (boolean useOrchestrator)
Ustawia opcję --orchestrator.
Parametry | |
---|---|
useOrchestrator |
boolean |
setPackageName
public void setPackageName (String packageName)
Ustaw pakiet pliku manifestu Androida do uruchomienia.
Parametry | |
---|---|
packageName |
String |
setReRunUsingTestFile
public void setReRunUsingTestFile (boolean reRunUsingTestFile)
Ustawia opcję --rerun-from-file.
Parametry | |
---|---|
reRunUsingTestFile |
boolean |
setRerunMode
public void setRerunMode (boolean rerun)
Opcjonalnie ustaw tryb ponownego uruchamiania.
Parametry | |
---|---|
rerun |
boolean |
setRunName
public void setRunName (String runName)
Ustaw niestandardową nazwę testu, która zostanie podana słuchaczowi.
Parametry | |
---|---|
runName |
String |
setRunnerName
public void setRunnerName (String runnerName)
Opcjonalnie ustaw, który narzędzie do pomiarów Androida ma być używane.
Parametry | |
---|---|
runnerName |
String |
setShellTimeout
public void setShellTimeout (long timeout)
Opcjonalnie ustaw maksymalny czas (w milisekundach), w którym oczekujesz danych z 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ę klas i metod testowych (w formacie: com.foo.Class#method) do uruchomienia. Jeśli to ustawienie jest ustawione, automatycznie podejmowane będą próby ponownego uruchomienia testów za pomocą tego pliku testowego za pomocą InstrumentationFileTest zamiast wykonywania oddzielnych poleceń adb dla każdego pozostałego testu za pomocą ponownego uruchomienia.
Parametry | |
---|---|
testFilePathOnDevice |
String |
setTestPackageName
public void setTestPackageName (String testPackageName)
Ustawia filtr pakietu testowego.
Jeśli wartość jest inna niż null, zostaną wykonane tylko testy w danym pakiecie Java.
Jest ignorowana, jeśli parametr setClassName(String)
ma wartość inną niż NULL.
Parametry | |
---|---|
testPackageName |
String |
setTestSize
public void setTestSize (String size)
Opcjonalnie ustaw rozmiar testu.
Parametry | |
---|---|
size |
String |
setTestTimeout
public void setTestTimeout (long timeout)
Opcjonalnie ustaw maksymalny czas (w milisekundach) dla każdego testu.
Parametry | |
---|---|
timeout |
long |
setTestsToRun
public void setTestsToRun (tests)
Ustaw kolekcję testów, które mają być wykonywane przez ten test z instrumentacją.
Parametry | |
---|---|
tests |
: testy do wykonania |
setWindowAnimation
public void setWindowAnimation (boolean windowAnimation)
Parametry | |
---|---|
windowAnimation |
boolean |
Chronione metody
excludeNonExecuted
protected staticexcludeNonExecuted (TestRunResult results)
W celu śledzenia, które testy wymagają ponownego uruchomienia, odfiltruj wartości „NOT_EXECUTED” i „Skipped”.
Parametry | |
---|---|
results |
TestRunResult |
Zwroty | |
---|---|
|
getClassName
protected String getClassName ()
Uzyskaj nazwę zajęć, które chcesz uruchomić.
Zwroty | |
---|---|
String |
getListInstrumentationParser
protected ListInstrumentationParser getListInstrumentationParser ()
Pobierz wartość ListInstrumentationParser
używaną do analizowania zapytań „pm list instrumentation”.
Zwroty | |
---|---|
ListInstrumentationParser |
getMethodName
protected String getMethodName ()
Uruchom metodę testowania.
Zwroty | |
---|---|
String |
getTestPackageName
protected String getTestPackageName ()
Uruchom testowy pakiet Java.
Zwroty | |
---|---|
String |
queryRunnerName
protected String queryRunnerName ()
Przesyłanie zapytania do urządzenia, aby wykonać test.
Zwroty | |
---|---|
String |
nazwa pierwszego test runnera pasującego do pakietu lub null, jeśli nie znaleziono żadnego; |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setRunnerArgs
protected void setRunnerArgs (IRemoteAndroidTestRunner runner)
Parametry | |
---|---|
runner |
IRemoteAndroidTestRunner |