Od 27 marca 2025 r. zalecamy używanie android-latest-release zamiast aosp-main do kompilowania i wspołtworzenia AOSP. Więcej informacji znajdziesz w artykule o zmianach w AOSP.

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

DeviceTestRunOptions

public class DeviceTestRunOptions
extends Object

java.lang.Object
↳	com.android.tradefed.testtype.junit4.DeviceTestRunOptions

Klasa konstruktora opcji związanych z uruchamianiem testów urządzenia za pomocą BaseHostJUnit4Test.

Podsumowanie

Konstruktory publiczne
`DeviceTestRunOptions(String packageName)`

Metody publiczne
`DeviceTestRunOptions`	`addExtraListener(ITestLifeCycleReceiver listener)` Dodaj dodatkowego słuchacza do uruchamianej instrumentacji.
`DeviceTestRunOptions`	`addInstrumentationArg(String key, String value)` Dodaj argument, który zostanie przekazany do pomiarów.
`void`	`clearExtraListeners()`
`void`	`clearInstrumentationArgs()` Wyczyść wszystkie argumenty pomiarów, które zostały wcześniej ustawione za pomocą `addInstrumentationArg(String, String)`.
`String`	`getApkFileName()` Zwraca nazwę pliku apk dla instalacji apk.
`ITestDevice`	`getDevice()`
	`getExtraListeners()`
`String[]`	`getInstallArgs()` Zwraca dodatkowe opcje polecenia install.
	`getInstrumentationArgs()`
`Long`	`getMaxInstrumentationTimeoutMs()`
`Long`	`getMaxTimeToOutputMs()`
`String`	`getPackageName()`
`String`	`getRunner()`
`String`	`getTestClassName()`
`String`	`getTestMethodName()`
`Long`	`getTestTimeoutMs()`
`Integer`	`getUserId()`
`boolean`	`isForceQueryable()` Określa, czy pakiet APK, który ma być zainstalowany, powinien być dostępny w zapytaniach.
`boolean`	`isGrantPermission()` Określa, czy należy przyznać uprawnienia do instalacji pliku APK.
`boolean`	`isHiddenApiCheckDisabled()`
`boolean`	`isIsolatedStorageDisabled()`
`boolean`	`isRestartDisabled()`
`boolean`	`isTestApiCheckDisabled()`
`boolean`	`isWindowAnimationDisabled()`
`DeviceTestRunOptions`	`setApkFileName(String apkFileName)` Ustawia nazwę pliku APK dla instalacji APK.
`DeviceTestRunOptions`	`setCheckResults(boolean checkResults)` Określa, czy wyniki uruchomienia narzędzia do pomiarów powinny zostać sprawdzone i czy nie wystąpiły żadne błędy.
`DeviceTestRunOptions`	`setDevice(ITestDevice device)`
`DeviceTestRunOptions`	`setDisableHiddenApiCheck(boolean disableHiddenApiCheck)` określa, czy do „am instrument” używanego po stronie hosta należy dodać opcję --no-hidden-api-checks.
`DeviceTestRunOptions`	`setDisableIsolatedStorage(boolean disableIsolatedStorage)` określa, czy do „am instrument” używanego po stronie hosta należy dodać opcję --no-isolated-storage.
`DeviceTestRunOptions`	`setDisableRestart(boolean disableRestart)` Określa, czy do „am instrument” używanego po stronie hosta należy dodać opcję --no-restart.
`DeviceTestRunOptions`	`setDisableTestApiCheck(boolean disableTestApiCheck)` określa, czy dodać opcję --no-test-api-access do „am instrument” używanego po stronie hosta.
`DeviceTestRunOptions`	`setDisableWindowAnimation(boolean disableWindowAnimation)` określa, czy dodać parametr --no-window-animation do „am instrument” używanego po stronie hosta.
`DeviceTestRunOptions`	`setForceQueryable(boolean forceQueryable)` Ustawia wartość `false`, jeśli zainstalowany plik APK nie powinien być dostępny do zapytań.
`DeviceTestRunOptions`	`setGrantPermission(boolean grantPermission)` Przyznawanie uprawnień do instalowania pliku APK.
`DeviceTestRunOptions`	`setInstallArgs(String... installArgs)` Ustawia dodatkowe opcje polecenia install.
`DeviceTestRunOptions`	`setMaxInstrumentationTimeoutMs(Long maxInstrumentationTimeoutMs)` Określa maksymalny czas (w milisekundach), przez jaki ma być wykonywane i zakończone pełne uinstrumentowanie.
`DeviceTestRunOptions`	`setMaxTimeToOutputMs(Long maxTimeToOutputMs)` Określa maksymalny czas (w milisekundach), przez jaki instrumentacja może przestać generować dane przed zatrzymaniem.
`DeviceTestRunOptions`	`setRunner(String runner)` Ustawia narzędzie do wykonywania testów, które powinno być używane do wykonywania testów.
`DeviceTestRunOptions`	`setTestClassName(String testClassName)` Ustawia nazwę klasy, która ma być uruchomiona przez instrumentację.
`DeviceTestRunOptions`	`setTestMethodName(String testMethodName)` Ustawia nazwę metody, która ma być wykonywana przez narzędzie do pomiarów.
`DeviceTestRunOptions`	`setTestTimeoutMs(Long testTimeoutMs)` Określa maksymalny czas (w milisekundach), przez jaki może trwać test, zanim zostanie przerwany.
`DeviceTestRunOptions`	`setUserId(Integer userId)` Ustawia identyfikator użytkownika, dla którego ma być wykonywana instrumentacja.
`boolean`	`shouldCheckResults()`

Konstruktory publiczne

DeviceTestRunOptions

public DeviceTestRunOptions (String packageName)

Parametry
`packageName`	`String`

Metody publiczne

addExtraListener

public DeviceTestRunOptions addExtraListener (ITestLifeCycleReceiver listener)

Dodaj dodatkowego słuchacza do uruchamianej instrumentacji.

Parametry
`listener`	`ITestLifeCycleReceiver`

Zwroty
`DeviceTestRunOptions`

addInstrumentationArg

public DeviceTestRunOptions addInstrumentationArg (String key, 
                String value)

Dodaj argument, który zostanie przekazany do pomiarów.

Parametry
`key`	`String`
`value`	`String`

Zwroty
`DeviceTestRunOptions`

clearExtraListeners

public void clearExtraListeners ()

clearInstrumentationArgs

public void clearInstrumentationArgs ()

Wyczyść wszystkie argumenty pomiarów, które zostały wcześniej ustawione za pomocą addInstrumentationArg(String, String).

getApkFileName

public String getApkFileName ()

Zwraca nazwę pliku apk dla instalacji apk.

Zwroty
`String`

getDevice

public ITestDevice getDevice ()

Zwroty
`ITestDevice`

getExtraListeners

public  getExtraListeners ()

Zwroty

getInstallArgs

public String[] getInstallArgs ()

Zwraca dodatkowe opcje polecenia install.

Zwroty
`String[]`

getInstrumentationArgs

public  getInstrumentationArgs ()

Zwroty

getMaxInstrumentationTimeoutMs

public Long getMaxInstrumentationTimeoutMs ()

Zwroty
`Long`

getMaxTimeToOutputMs

public Long getMaxTimeToOutputMs ()

Zwroty
`Long`

getPackageName

public String getPackageName ()

Zwroty
`String`

getRunner

public String getRunner ()

Zwroty
`String`

getTestClassName

public String getTestClassName ()

Zwroty
`String`

getTestMethodName

public String getTestMethodName ()

Zwroty
`String`

getTestTimeoutMs

public Long getTestTimeoutMs ()

Zwroty
`Long`

getUserId

public Integer getUserId ()

Zwroty
`Integer`

isForceQueryable

public boolean isForceQueryable ()

Określa, czy pakiet APK, który ma być zainstalowany, powinien być dostępny w zapytaniach. Wartością domyślną jest true (prawda).

Zwroty
`boolean`

isGrantPermission

public boolean isGrantPermission ()

Określa, czy należy przyznać uprawnienia do instalacji pliku APK.

Zwroty
`boolean`

isHiddenApiCheckDisabled

public boolean isHiddenApiCheckDisabled ()

Zwroty
`boolean`

isIsolatedStorageDisabled

public boolean isIsolatedStorageDisabled ()

Zwroty
`boolean`

isRestartDisabled

public boolean isRestartDisabled ()

Zwroty
`boolean`

isTestApiCheckDisabled

public boolean isTestApiCheckDisabled ()

Zwroty
`boolean`

isWindowAnimationDisabled

public boolean isWindowAnimationDisabled ()

Zwroty
`boolean`

setApkFileName

public DeviceTestRunOptions setApkFileName (String apkFileName)

Ustawia nazwę pliku APK dla instalacji APK.

Parametry
`apkFileName`	`String`

Zwroty
`DeviceTestRunOptions`

setCheckResults

public DeviceTestRunOptions setCheckResults (boolean checkResults)

Określa, czy wyniki uruchomienia narzędzia do pomiarów powinny zostać sprawdzone i czy nie wystąpiły żadne błędy.

Parametry
`checkResults`	`boolean`

Zwroty
`DeviceTestRunOptions`

setDevice

public DeviceTestRunOptions setDevice (ITestDevice device)

Parametry
`device`	`ITestDevice`

Zwroty
`DeviceTestRunOptions`

setDisableHiddenApiCheck

public DeviceTestRunOptions setDisableHiddenApiCheck (boolean disableHiddenApiCheck)

określa, czy do „am instrument” używanego po stronie hosta należy dodać opcję --no-hidden-api-checks.

Parametry
`disableHiddenApiCheck`	`boolean`

Zwroty
`DeviceTestRunOptions`

setDisableIsolatedStorage

public DeviceTestRunOptions setDisableIsolatedStorage (boolean disableIsolatedStorage)

określa, czy do „am instrument” używanego po stronie hosta należy dodać opcję --no-isolated-storage.

Parametry
`disableIsolatedStorage`	`boolean`

Zwroty
`DeviceTestRunOptions`

setDisableRestart

public DeviceTestRunOptions setDisableRestart (boolean disableRestart)

Określa, czy do „am instrument” używanego po stronie hosta należy dodać opcję --no-restart.

Parametry
`disableRestart`	`boolean`

Zwroty
`DeviceTestRunOptions`

setDisableTestApiCheck

public DeviceTestRunOptions setDisableTestApiCheck (boolean disableTestApiCheck)

określa, czy dodać opcję --no-test-api-access do „am instrument” używanego po stronie hosta.

Parametry
`disableTestApiCheck`	`boolean`

Zwroty
`DeviceTestRunOptions`

setDisableWindowAnimation

public DeviceTestRunOptions setDisableWindowAnimation (boolean disableWindowAnimation)

określa, czy dodać parametr --no-window-animation do „am instrument” używanego po stronie hosta.

Parametry
`disableWindowAnimation`	`boolean`

Zwroty
`DeviceTestRunOptions`

setForceQueryable

public DeviceTestRunOptions setForceQueryable (boolean forceQueryable)

Ustawia wartość false, jeśli zainstalowany pakiet APK nie powinien być dostępny w zapytaniach.

Parametry
`forceQueryable`	`boolean`

Zwroty
`DeviceTestRunOptions`

setGrantPermission

public DeviceTestRunOptions setGrantPermission (boolean grantPermission)

Przyznawanie uprawnień do instalowania pliku APK.

Parametry
`grantPermission`	`boolean`

Zwroty
`DeviceTestRunOptions`

setInstallArgs

public DeviceTestRunOptions setInstallArgs (String... installArgs)

Ustawia dodatkowe opcje polecenia install.

Parametry
`installArgs`	`String`

Zwroty
`DeviceTestRunOptions`

setMaxInstrumentationTimeoutMs

public DeviceTestRunOptions setMaxInstrumentationTimeoutMs (Long maxInstrumentationTimeoutMs)

Określa maksymalny czas (w milisekundach), przez jaki ma być wykonywane i zakończone pełne uinstrumentowanie. Ustaw wartość 0, aby wyłączyć limit czasu. Opcjonalnie:

Parametry
`maxInstrumentationTimeoutMs`	`Long`

Zwroty
`DeviceTestRunOptions`

setMaxTimeToOutputMs

public DeviceTestRunOptions setMaxTimeToOutputMs (Long maxTimeToOutputMs)

Określa maksymalny czas (w milisekundach), przez jaki instrumentacja może przestać generować dane przed zatrzymaniem. Ustaw wartość 0, aby wyłączyć limit czasu. Opcjonalnie:

Parametry
`maxTimeToOutputMs`	`Long`

Zwroty
`DeviceTestRunOptions`

setRunner

public DeviceTestRunOptions setRunner (String runner)

Ustawia narzędzie do wykonywania testów, które powinno być używane do wykonywania testów. Domyślnym narzędziem do testowania jest „android.support.test.runner.AndroidJUnitRunner”. Opcjonalnie:

Parametry
`runner`	`String`

Zwroty
`DeviceTestRunOptions`

setTestClassName

public DeviceTestRunOptions setTestClassName (String testClassName)

Ustawia nazwę klasy, która ma być uruchomiona przez instrumentację. Instrumentacja zostanie przefiltrowana, aby uwzględnić tylko zajęcia. Można go używać z setTestMethodName(String). Opcjonalnie:

Parametry
`testClassName`	`String`

Zwroty
`DeviceTestRunOptions`

setTestMethodName

public DeviceTestRunOptions setTestMethodName (String testMethodName)

Ustawia nazwę metody, która ma być wykonywana przez narzędzie do pomiarów. Aby działać prawidłowo, wymaga ustawienia setTestClassName(String). Opcjonalnie:

Parametry
`testMethodName`	`String`

Zwroty
`DeviceTestRunOptions`

setTestTimeoutMs

public DeviceTestRunOptions setTestTimeoutMs (Long testTimeoutMs)

Określa maksymalny czas (w milisekundach), przez jaki może trwać test, zanim zostanie przerwany. Ustaw wartość 0, aby nie używać limitu czasu. Opcjonalnie:

Parametry
`testTimeoutMs`	`Long`

Zwroty
`DeviceTestRunOptions`

setUserId

public DeviceTestRunOptions setUserId (Integer userId)

Ustawia identyfikator użytkownika, dla którego ma być wykonywana instrumentacja. Opcjonalnie:

Parametry
`userId`	`Integer`

Zwroty
`DeviceTestRunOptions`

shouldCheckResults

public boolean shouldCheckResults ()

Zwroty
`boolean`