Aby zachować zgodność z naszym modelem rozwoju gałęzi głównej i zapewnić stabilność platformy w ekosystemie, w II i IV kwartale 2026 r. opublikujemy kod źródłowy w AOSP. Do tworzenia i współtworzenia AOSP zalecamy używanie android-latest-release zamiast aosp-main. Gałąź android-latest-release manifestu zawsze będzie odnosić się do najnowszej wersji przesłanej do AOSP. Więcej informacji znajdziesz w sekcji Zmiany w AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

InstrumentationTest

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

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

Znane bezpośrednie podklasy

AndroidJUnitTest, CodeCoverageTest

AndroidJUnitTest	Test, który uruchamia pakiet testów z instrumentacją na danym urządzeniu za pomocą klasy android.support.test.runner.AndroidJUnitRunner.
CodeCoverageTest	Test, który uruchamia pakiet testów z instrumentacją na danym urządzeniu i generuje raport o pokryciu kodu.

Test, który uruchamia pakiet testów z instrumentacją na danym urządzeniu.

Podsumowanie

Stałe
`String`	`RUN_TESTS_AS_USER_KEY`
`String`	`RUN_TESTS_ON_SDK_SANDBOX`

Pola
`protected boolean`	`mDebug`
`protected boolean`	`mInstrumentInPcc`
`protected boolean`	`mInstrumentSdkInSandbox`
`protected boolean`	`mInstrumentSdkSandbox`

Konstruktory publiczne
`InstrumentationTest()`

Metody publiczne
`void`	`addDeviceListeners(Set<String> extraListeners)` Umożliwia dodanie do narzędzia więcej niestandardowych odbiorców.
`void`	`addInstrumentationArg(String key, String value)` Dodaj argument, który będzie podawany podczas przeprowadzania testów z instrumentacją.
`IAbi`	`getAbi()`
`IConfiguration`	`getConfiguration()` Pobiera `IConfiguration` dla tego testu.
`String`	`getCoverageTarget()` Pobierz wcześniej ustawiony cel zasięgu za pomocą `setCoverageTarget(String)`.
`boolean`	`getDebug()` Pobierz ustawienie debugowania instrumentacji.
`ITestDevice`	`getDevice()` Przygotuj urządzenie testowe.
`String`	`getForceAbi()`
`long`	`getMaxTimeout()` Zwraca maksymalny limit czasu ustawiony dla instrumentacji.
`String`	`getPackageName()` Pobierz pakiet manifestu Androida, aby go uruchomić.
`String`	`getRunName()` Pobierz niestandardową nazwę testu, która zostanie przekazana do odbiorcy.
`String`	`getRunnerName()` Pobiera narzędzie do uruchamiania instrumentacji Androida, które ma być używane.
`boolean`	`isCollectTestsOnly()`
`boolean`	`isOrchestrator()` Zwraca wartość `ERROR(InstrumentationTest.mOrchestrator/#mOrchestrator InstrumentationTest.mOrchestrator)`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Przeprowadza testy i przekazuje wyniki 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 tryb zbierania testów
`void`	`setCollectsTestsShellTimeout(int timeout)` Ta metoda została wycofana. Ta metoda nie wykonuje żadnych działań.
`void`	`setConfiguration(IConfiguration config)` Wstawia używaną wartość `IConfiguration`.
`void`	`setCoverageTarget(String coverageTarget)` Ustaw cel pokrycia tego testu.
`void`	`setDebug(boolean debug)` Ustawienie debugowania instrumentacji.
`void`	`setDevice(ITestDevice device)` Wstrzyknij testowane urządzenie.
`void`	`setEnforceFormat(boolean enforce)` Ustaw wartość True, jeśli wymuszamy format wyjściowy AJUR instrumentacji.
`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)` Określ, czy chcesz używać izolowanego miejsca na dane.
`void`	`setMethodName(String testMethodName)` Opcjonalnie ustaw metodę testowania do uruchomienia.
`void`	`setMetricCollectors(List<IMetricCollector> collectors)` Ustawia listę `IMetricCollector` zdefiniowanych dla testu.
`void`	`setOrchestrator(boolean useOrchestrator)` Ustawia opcję --orchestrator
`void`	`setPackageName(String packageName)` Ustaw pakiet manifestu Androida do uruchomienia.
`void`	`setReRunUsingTestFile(boolean reRunUsingTestFile)` Ustawia opcję --rerun-from-file.
`void`	`setRerunMode(boolean rerun)` Opcjonalnie ustaw tryb ponownego uruchomienia.
`void`	`setRetryAttemptNumber(int attemptNumber)` Ustawia numer ponownej próby testu. Ustawia numer próby ponowienia, przekazując go jako argument instrumentacji „retry_attempt” do narzędzia uruchamiającego po stronie urządzenia.
`void`	`setRunName(String runName)` Ustaw niestandardową nazwę testu, która będzie przekazywana do odbiorcy.
`void`	`setRunnerName(String runnerName)` Opcjonalnie możesz ustawić narzędzie do uruchamiania testów instrumentacyjnych na Androidzie.
`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 możesz ustawić ścieżkę do pliku znajdującego się na urządzeniu, który powinien zawierać listę klas i metod testowych rozdzielonych znakami podziału wiersza (format: com.foo.Class#method), które mają zostać uruchomione.
`void`	`setTestPackageName(String testPackageName)` Ustawia filtr pakietu testowego.
`void`	`setTestSize(String size)` Opcjonalnie możesz ustawić rozmiar testu do uruchomienia.
`void`	`setTestTimeout(long timeout)` Opcjonalnie możesz ustawić maksymalny czas (w milisekundach) każdego testu.
`void`	`setTestsToRun(Collection<TestDescription> tests)` Ustaw kolekcję testów, które mają być wykonywane przez ten test z instrumentacją.
`void`	`setWindowAnimation(boolean windowAnimation)`

Metody chronione
`static Set<TestDescription>`	`excludeNonExecuted(TestRunResult results)` Odfiltruj wartości „NOT_EXECUTED” i „Skipped”, aby śledzić, co należy uruchomić ponownie.
`String`	`getClassName()` Pobierz nazwę klasy do uruchomienia.
`ListInstrumentationParser`	`getListInstrumentationParser()` Pobierz parser `ListInstrumentationParser` używany do analizowania zapytań dotyczących „instrumentacji listy PM”.
`String`	`getMethodName()` Pobierz metodę testowania do uruchomienia.
`String`	`getTestPackageName()` Pobierz pakiet testowy Java, aby go uruchomić.
`String`	`queryRunnerName()` Wysyłanie do urządzenia zapytania o używany program do testowania.
`void`	`setRunnerArgs(IRemoteAndroidTestRunner runner)`

Stałe

RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

Wartość stała: "RUN_TESTS_AS_USER"

RUN_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

Wartość stała: "RUN_TESTS_ON_SDK_SANDBOX"

Pola

mDebug

protected boolean mDebug

mInstrumentInPcc

protected boolean mInstrumentInPcc

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

Konstruktory publiczne

InstrumentationTest

public InstrumentationTest ()

Metody publiczne

addDeviceListeners

public void addDeviceListeners (Set<String> extraListeners)

Umożliwia dodanie do narzędzia więcej niestandardowych odbiorców.

Parametry
`extraListeners`	`Set`

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

Dodaj argument, który będzie podawany podczas przeprowadzania testów z instrumentacją.

Parametry
`key`	`String`: nazwa argumentu
`value`	`String`: wartość argumentu

getAbi

public IAbi getAbi ()

Zwraca
`IAbi`

getConfiguration

public IConfiguration getConfiguration ()

Pobiera IConfiguration dla tego testu.

Zwraca
`IConfiguration`

getCoverageTarget

public String getCoverageTarget ()

Pobierz wcześniej ustawiony cel zasięgu za pomocą setCoverageTarget(String).

Zwraca
`String`

getDebug

public boolean getDebug ()

Pobierz ustawienie debugowania instrumentacji.

Zwraca
`boolean`	Ustawienie debugowania typu logicznego.

getDevice

public ITestDevice getDevice ()

Przygotuj urządzenie testowe.

Zwraca
`ITestDevice`	`ITestDevice`

getForceAbi

public String getForceAbi ()

Zwraca
`String`

getMaxTimeout

public long getMaxTimeout ()

Zwraca maksymalny limit czasu ustawiony dla instrumentacji.

Zwraca
`long`

getPackageName

public String getPackageName ()

Pobierz pakiet manifestu Androida, aby go uruchomić.

Zwraca
`String`

getRunName

public String getRunName ()

Pobierz niestandardową nazwę testu, która zostanie przekazana do odbiorcy.

Zwraca
`String`

getRunnerName

public String getRunnerName ()

Pobiera narzędzie do uruchamiania instrumentacji Androida, które ma być używane.

Zwraca
`String`

isCollectTestsOnly

public boolean isCollectTestsOnly ()

Zwraca
`boolean`	czy ten test jest w trybie collect-tests-only.

isOrchestrator

public boolean isOrchestrator ()

Zwraca wartość ERROR(InstrumentationTest.mOrchestrator/#mOrchestrator InstrumentationTest.mOrchestrator)

Zwraca
`boolean`

home run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Przeprowadza testy i przekazuje wyniki odbiorcy.

Parametry
`testInfo`	`TestInformation`: obiekt `TestInformation` zawierający przydatne informacje do przeprowadzania testów.
`listener`	`ITestInvocationListener`: `ITestInvocationListener` wyników testu

Zgłasza
`DeviceNotAvailableException`

setAbi

public void setAbi (IAbi abi)

Parametry
`abi`	`IAbi`

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 tryb zbierania testów

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

Ta metoda została wycofana.
Ta metoda nie wykonuje żadnych działań.

Ustaw maksymalny czas w milisekundach, który będzie dozwolony w przypadku „maksymalnego czasu na odpowiedź wyjściową powłoki” podczas zbierania testów.

Parametry
`timeout`	`int`

setConfiguration

public void setConfiguration (IConfiguration config)

Wstawia używaną wartość IConfiguration.

Parametry
`config`	`IConfiguration`

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

Ustaw cel pokrycia tego testu.

Obecnie nieużywane. Ta metoda jest dostępna tylko po to, aby można było później pobrać coverageTarget za pomocą getCoverageTarget()

Parametry
`coverageTarget`	`String`

setDebug

public void setDebug (boolean debug)

Ustawienie debugowania instrumentacji.

Parametry
`debug`	`boolean`: wartość logiczna, która ma być ustawiona w przypadku ustawienia debugowania instrumentacji.

setDevice

public void setDevice (ITestDevice device)

Wstrzyknij testowane urządzenie.

Parametry
`device`	`ITestDevice`: `ITestDevice`, którego chcesz użyć.

setEnforceFormat

public void setEnforceFormat (boolean enforce)

Ustaw wartość True, jeśli wymuszamy format wyjściowy AJUR instrumentacji.

Parametry
`enforce`	`boolean`

setForceAbi

public void setForceAbi (String abi)

Ustawia opcję force-abi.

setInstallFile

public void setInstallFile (File installFile)

Ustaw opcjonalny plik do zainstalowania, który zawiera testy.

Parametry
`installFile`	`File`: instalacyjny `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 do uruchomienia.

Parametry
`testMethodName`	`String`

setMetricCollectors

public void setMetricCollectors (List<IMetricCollector> collectors)

Ustawia listę IMetricCollector zdefiniowanych dla testu.

Parametry
`collectors`	`List`

setOrchestrator

public void setOrchestrator (boolean useOrchestrator)

Ustawia opcję --orchestrator

Parametry
`useOrchestrator`	`boolean`

setPackageName

public void setPackageName (String packageName)

Ustaw pakiet 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 uruchomienia.

Parametry
`rerun`	`boolean`

setRetryAttemptNumber

public void setRetryAttemptNumber (int attemptNumber)

Ustawia numer ponownej próby testu. Domyślna wartość nie powoduje żadnych działań.

Ustawia numer próby ponowienia, przekazując go jako argument instrumentacji „retry_attempt” do narzędzia uruchamiającego po stronie urządzenia.

Parametry
`attemptNumber`	`int`

setRunName

public void setRunName (String runName)

Ustaw niestandardową nazwę testu, która będzie przekazywana do odbiorcy.

Parametry
`runName`	`String`

setRunnerName

public void setRunnerName (String runnerName)

Opcjonalnie możesz ustawić narzędzie do uruchamiania testów instrumentacyjnych na Androidzie.

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`

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

Opcjonalnie możesz ustawić ścieżkę do pliku znajdującego się na urządzeniu, który powinien zawierać listę klas i metod testowych rozdzielonych znakami podziału wiersza (format: com.foo.Class#method), które mają zostać uruchomione. Jeśli ta opcja jest ustawiona, testy zostaną automatycznie ponowione przy użyciu tego pliku testowego za pomocą InstrumentationFileTest zamiast wykonywania osobnych 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 nie jest to wartość null, zostaną wykonane tylko testy w danym pakiecie Java.

Zostanie zignorowany, jeśli w przypadku parametru setClassName(String) podano wartość inną niż null.

Parametry
`testPackageName`	`String`

setTestSize

public void setTestSize (String size)

Opcjonalnie możesz ustawić rozmiar testu do uruchomienia.

Parametry
`size`	`String`

setTestTimeout

public void setTestTimeout (long timeout)

Opcjonalnie możesz ustawić maksymalny czas (w milisekundach) każdego testu.

Parametry
`timeout`	`long`

setTestsToRun

public void setTestsToRun (Collection<TestDescription> tests)

Ustaw kolekcję testów, które mają być wykonywane przez ten test z instrumentacją.

Parametry
`tests`	`Collection`: testy do przeprowadzenia

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

Parametry
`windowAnimation`	`boolean`

Metody chronione

excludeNonExecuted

protected static Set<TestDescription> excludeNonExecuted (TestRunResult results)

Odfiltruj wartości „NOT_EXECUTED” i „Skipped”, aby śledzić, co należy uruchomić ponownie.

Parametry
`results`	`TestRunResult`

Zwraca
`Set<TestDescription>`

getClassName

protected String getClassName ()

Pobierz nazwę klasy do uruchomienia.

Zwraca
`String`

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Pobierz parser ListInstrumentationParser używany do analizowania zapytań dotyczących „instrumentacji listy PM”.

Zwraca
`ListInstrumentationParser`

getMethodName

protected String getMethodName ()

Pobierz metodę testowania do uruchomienia.

Zwraca
`String`

getTestPackageName

protected String getTestPackageName ()

Pobierz pakiet testowy Java, aby go uruchomić.

Zwraca
`String`

queryRunnerName

protected String queryRunnerName ()

Wysyłanie do urządzenia zapytania o używany program do testowania.

Zwraca
`String`	pierwsza nazwa narzędzia do testowania, która pasuje do pakietu, lub wartość null, jeśli nie znajdziemy żadnej.

Zgłasza
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parametry
`runner`	`IRemoteAndroidTestRunner`