Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

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

DeviceTestRunOptions

public class DeviceTestRunOptions
extends Object

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

Uma classe builder para opções relacionadas à execução de testes de dispositivo usando BaseHostJUnit4Test.

Resumo

Construtores públicos
`DeviceTestRunOptions(String packageName)`

Métodos públicos
`DeviceTestRunOptions`	`addExtraListener(ITestLifeCycleReceiver listener)` Adiciona um listener extra à instrumentação em execução.
`DeviceTestRunOptions`	`addInstrumentationArg(String key, String value)` Adicione um argumento que será transmitido à instrumentação.
`void`	`clearExtraListeners()`
`void`	`clearInstrumentationArgs()` Limpa todos os argumentos de instrumentação definidos anteriormente com `addInstrumentationArg(String,String)`.
`String`	`getApkFileName()` Retorna o nome do arquivo APK para a instalação do APK.
`ITestDevice`	`getDevice()`
`List<ITestLifeCycleReceiver>`	`getExtraListeners()`
`String[]`	`getInstallArgs()` Retorna opções extras do comando de instalação.
`Map<String, String>`	`getInstrumentationArgs()`
`Long`	`getMaxInstrumentationTimeoutMs()`
`Long`	`getMaxTimeToOutputMs()`
`String`	`getPackageName()`
`String`	`getRunner()`
`String`	`getTestClassName()`
`String`	`getTestMethodName()`
`Long`	`getTestTimeoutMs()`
`Integer`	`getUserId()`
`boolean`	`isForceQueryable()` Se o APK a ser instalado pode ser consultado.
`boolean`	`isGrantPermission()` Se as permissões para a instalação do APK serão concedidas.
`boolean`	`isHiddenApiCheckDisabled()`
`boolean`	`isInstrumentInPcc()` Indica se a opção "--instrument-in-pcc" deve ser adicionada ao "am instrument" usado do lado do host.
`boolean`	`isIsolatedStorageDisabled()`
`boolean`	`isRestartDisabled()`
`boolean`	`isTestApiCheckDisabled()`
`boolean`	`isWindowAnimationDisabled()`
`DeviceTestRunOptions`	`setApkFileName(String apkFileName)` Define o nome do arquivo APK para a instalação do APK.
`DeviceTestRunOptions`	`setCheckResults(boolean checkResults)` Define se os resultados da execução da instrumentação precisam ser verificados para garantir que não houve falhas.
`DeviceTestRunOptions`	`setDevice(ITestDevice device)`
`DeviceTestRunOptions`	`setDisableHiddenApiCheck(boolean disableHiddenApiCheck)` Define se é necessário adicionar --no-hidden-api-checks ao "am instrument" usado no lado do host.
`DeviceTestRunOptions`	`setDisableIsolatedStorage(boolean disableIsolatedStorage)` Define se o flag "--no-isolated-storage" será adicionado ou não ao "am instrument" usado no lado do host.
`DeviceTestRunOptions`	`setDisableRestart(boolean disableRestart)` Define se a flag "--no-restart" será adicionada ou não ao "am instrument" usado no lado do host.
`DeviceTestRunOptions`	`setDisableTestApiCheck(boolean disableTestApiCheck)` Define se a flag --no-test-api-access será adicionada ao "am instrument" usado no lado do host.
`DeviceTestRunOptions`	`setDisableWindowAnimation(boolean disableWindowAnimation)` Define se a opção "--no-window-animation" será adicionada ou não ao "am instrument" usado no lado do host.
`DeviceTestRunOptions`	`setForceQueryable(boolean forceQueryable)` Define `false` se o APK a ser instalado não puder ser consultado.
`DeviceTestRunOptions`	`setGrantPermission(boolean grantPermission)` Concede permissões para a instalação do APK.
`DeviceTestRunOptions`	`setInstallArgs(String... installArgs)` Define opções extras do comando de instalação.
`DeviceTestRunOptions`	`setInstrumentInPcc(boolean instrumentInPcc)` Define se a opção "--instrument-in-pcc" será adicionada ou não ao "am instrument" usado no lado do host.
`DeviceTestRunOptions`	`setMaxInstrumentationTimeoutMs(Long maxInstrumentationTimeoutMs)` Define o tempo máximo (em milissegundos) que a instrumentação completa terá para ser executada e concluída.
`DeviceTestRunOptions`	`setMaxTimeToOutputMs(Long maxTimeToOutputMs)` Define o tempo máximo (em milissegundos) que a instrumentação pode parar de gerar saída antes de ser interrompida.
`DeviceTestRunOptions`	`setRunner(String runner)` Define o executor de instrumentação que deve ser usado para executar a instrumentação.
`DeviceTestRunOptions`	`setTestClassName(String testClassName)` Define o nome da classe em que a instrumentação será executada.
`DeviceTestRunOptions`	`setTestMethodName(String testMethodName)` Define o nome do método que a instrumentação precisa executar.
`DeviceTestRunOptions`	`setTestTimeoutMs(Long testTimeoutMs)` Define o tempo máximo (em milissegundos) que um teste pode ser executado antes de ser interrompido.
`DeviceTestRunOptions`	`setUserId(Integer userId)` Define o ID do usuário em que a instrumentação deve ser executada.
`boolean`	`shouldCheckResults()`

Construtores públicos

DeviceTestRunOptions

public DeviceTestRunOptions (String packageName)

Parâmetros
`packageName`	`String`

Métodos públicos

addExtraListener

public DeviceTestRunOptions addExtraListener (ITestLifeCycleReceiver listener)

Adiciona um listener extra à instrumentação em execução.

Parâmetros
`listener`	`ITestLifeCycleReceiver`

Retorna
`DeviceTestRunOptions`

addInstrumentationArg

public DeviceTestRunOptions addInstrumentationArg (String key, 
                String value)

Adicione um argumento que será transmitido à instrumentação.

Parâmetros
`key`	`String`
`value`	`String`

Retorna
`DeviceTestRunOptions`

clearExtraListeners

public void clearExtraListeners ()

clearInstrumentationArgs

public void clearInstrumentationArgs ()

Limpa todos os argumentos de instrumentação definidos anteriormente com addInstrumentationArg(String,String).

getApkFileName

public String getApkFileName ()

Retorna o nome do arquivo APK para a instalação do APK.

Retorna
`String`

getDevice

public ITestDevice getDevice ()

Retorna
`ITestDevice`

getExtraListeners

public List<ITestLifeCycleReceiver> getExtraListeners ()

Retorna
`List<ITestLifeCycleReceiver>`

getInstallArgs

public String[] getInstallArgs ()

Retorna opções extras do comando de instalação.

Retorna
`String[]`

getInstrumentationArgs

public Map<String, String> getInstrumentationArgs ()

Retorna
`Map<String, String>`

getMaxInstrumentationTimeoutMs

public Long getMaxInstrumentationTimeoutMs ()

Retorna
`Long`

getMaxTimeToOutputMs

public Long getMaxTimeToOutputMs ()

Retorna
`Long`

getPackageName

public String getPackageName ()

Retorna
`String`

getRunner

public String getRunner ()

Retorna
`String`

getTestClassName

public String getTestClassName ()

Retorna
`String`

getTestMethodName

public String getTestMethodName ()

Retorna
`String`

getTestTimeoutMs

public Long getTestTimeoutMs ()

Retorna
`Long`

getUserId

public Integer getUserId ()

Retorna
`Integer`

isForceQueryable

public boolean isForceQueryable ()

Se o APK a ser instalado pode ser consultado. O valor padrão é true.

Retorna
`boolean`

isGrantPermission

public boolean isGrantPermission ()

Se as permissões para a instalação do APK serão concedidas.

Retorna
`boolean`

isHiddenApiCheckDisabled

public boolean isHiddenApiCheckDisabled ()

Retorna
`boolean`

isInstrumentInPcc

public boolean isInstrumentInPcc ()

Indica se a opção "--instrument-in-pcc" deve ser adicionada ao "am instrument" usado do lado do host.

Retorna
`boolean`

isIsolatedStorageDisabled

public boolean isIsolatedStorageDisabled ()

Retorna
`boolean`

isRestartDisabled

public boolean isRestartDisabled ()

Retorna
`boolean`

isTestApiCheckDisabled

public boolean isTestApiCheckDisabled ()

Retorna
`boolean`

isWindowAnimationDisabled

public boolean isWindowAnimationDisabled ()

Retorna
`boolean`

setApkFileName

public DeviceTestRunOptions setApkFileName (String apkFileName)

Define o nome do arquivo APK para a instalação do APK.

Parâmetros
`apkFileName`	`String`

Retorna
`DeviceTestRunOptions`

setCheckResults

public DeviceTestRunOptions setCheckResults (boolean checkResults)

Define se os resultados da execução da instrumentação precisam ser verificados para garantir que não houve falhas.

Parâmetros
`checkResults`	`boolean`

Retorna
`DeviceTestRunOptions`

setDevice

public DeviceTestRunOptions setDevice (ITestDevice device)

Parâmetros
`device`	`ITestDevice`

Retorna
`DeviceTestRunOptions`

setDisableHiddenApiCheck

public DeviceTestRunOptions setDisableHiddenApiCheck (boolean disableHiddenApiCheck)

Define se é necessário adicionar --no-hidden-api-checks ao "am instrument" usado no lado do host.

Parâmetros
`disableHiddenApiCheck`	`boolean`

Retorna
`DeviceTestRunOptions`

setDisableIsolatedStorage

public DeviceTestRunOptions setDisableIsolatedStorage (boolean disableIsolatedStorage)

Define se o flag "--no-isolated-storage" será adicionado ou não ao "am instrument" usado no lado do host.

Parâmetros
`disableIsolatedStorage`	`boolean`

Retorna
`DeviceTestRunOptions`

setDisableRestart

public DeviceTestRunOptions setDisableRestart (boolean disableRestart)

Define se a flag "--no-restart" será adicionada ou não ao "am instrument" usado no lado do host.

Parâmetros
`disableRestart`	`boolean`

Retorna
`DeviceTestRunOptions`

setDisableTestApiCheck

public DeviceTestRunOptions setDisableTestApiCheck (boolean disableTestApiCheck)

Define se a flag --no-test-api-access será adicionada ao "am instrument" usado no lado do host.

Parâmetros
`disableTestApiCheck`	`boolean`

Retorna
`DeviceTestRunOptions`

setDisableWindowAnimation

public DeviceTestRunOptions setDisableWindowAnimation (boolean disableWindowAnimation)

Define se a opção "--no-window-animation" será adicionada ou não ao "am instrument" usado no lado do host.

Parâmetros
`disableWindowAnimation`	`boolean`

Retorna
`DeviceTestRunOptions`

setForceQueryable

public DeviceTestRunOptions setForceQueryable (boolean forceQueryable)

Define false se o APK a ser instalado não puder ser consultado.

Parâmetros
`forceQueryable`	`boolean`

Retorna
`DeviceTestRunOptions`

setGrantPermission

public DeviceTestRunOptions setGrantPermission (boolean grantPermission)

Concede permissões para a instalação do APK.

Parâmetros
`grantPermission`	`boolean`

Retorna
`DeviceTestRunOptions`

setInstallArgs

public DeviceTestRunOptions setInstallArgs (String... installArgs)

Define opções extras do comando de instalação.

Parâmetros
`installArgs`	`String`

Retorna
`DeviceTestRunOptions`

setInstrumentInPcc

public DeviceTestRunOptions setInstrumentInPcc (boolean instrumentInPcc)

Define se a opção "--instrument-in-pcc" será adicionada ou não ao "am instrument" usado no lado do host.

Parâmetros
`instrumentInPcc`	`boolean`

Retorna
`DeviceTestRunOptions`

setMaxInstrumentationTimeoutMs

public DeviceTestRunOptions setMaxInstrumentationTimeoutMs (Long maxInstrumentationTimeoutMs)

Define o tempo máximo (em milissegundos) que a instrumentação completa terá para ser executada e concluída. Defina como 0 para não ter tempo limite. Opcional.

Parâmetros
`maxInstrumentationTimeoutMs`	`Long`

Retorna
`DeviceTestRunOptions`

setMaxTimeToOutputMs

public DeviceTestRunOptions setMaxTimeToOutputMs (Long maxTimeToOutputMs)

Define o tempo máximo (em milissegundos) que a instrumentação pode parar de gerar saída antes de ser interrompida. Defina como 0 para não ter tempo limite. Opcional.

Parâmetros
`maxTimeToOutputMs`	`Long`

Retorna
`DeviceTestRunOptions`

setRunner

public DeviceTestRunOptions setRunner (String runner)

Define o executor de instrumentação que deve ser usado para executar a instrumentação. O executor padrão é "android.support.test.runner.AndroidJUnitRunner". Opcional.

Parâmetros
`runner`	`String`

Retorna
`DeviceTestRunOptions`

setTestClassName

public DeviceTestRunOptions setTestClassName (String testClassName)

Define o nome da classe em que a instrumentação será executada. A instrumentação será filtrada para executar apenas a classe. Pode ser usado com setTestMethodName(String). Opcional.

Parâmetros
`testClassName`	`String`

Retorna
`DeviceTestRunOptions`

setTestMethodName

public DeviceTestRunOptions setTestMethodName (String testMethodName)

Define o nome do método que a instrumentação precisa executar. Exige que setTestClassName(String) seja definido para funcionar corretamente. Opcional.

Parâmetros
`testMethodName`	`String`

Retorna
`DeviceTestRunOptions`

setTestTimeoutMs

public DeviceTestRunOptions setTestTimeoutMs (Long testTimeoutMs)

Define o tempo máximo (em milissegundos) que um teste pode ser executado antes de ser interrompido. Defina como 0 para não ter tempo limite. Opcional.

Parâmetros
`testTimeoutMs`	`Long`

Retorna
`DeviceTestRunOptions`

setUserId

public DeviceTestRunOptions setUserId (Integer userId)

Define o ID do usuário em que a instrumentação deve ser executada. Opcional.

Parâmetros
`userId`	`Integer`

Retorna
`DeviceTestRunOptions`

shouldCheckResults

public boolean shouldCheckResults ()

Retorna
`boolean`