BaseHostJUnit4Test

public abstract class BaseHostJUnit4Test
extends Object implements IAbiReceiver, ITestInformationReceiver

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


Classe de teste base para executar testes no estilo JUnit4 do host. Essa classe oferece suporte para instalar, executar e limpar testes de instrumentação do lado do host. Essa classe é compatível com vários dispositivos. Deve ser a única fonte de verdade para executar testes de instrumentação do lado do host para evitar a duplicação de utilitários e classes de base.

Resumo

Construtores públicos

BaseHostJUnit4Test()

Métodos públicos

final void autoTearDown()

Remoção automática de todos os apks instalados.

final IAbi getAbi()
final IBuildInfo getBuild()
final ITestDevice getDevice()
final IInvocationContext getInvocationContext()
final TestRunResult getLastDeviceRunResults()

Retorna o TestRunResult resultante dos últimos runDeviceTests executados.

final getListDevices()
TestInformation getTestInformation()
boolean hasDeviceFeature(String feature)
final void installPackage(DeviceTestRunOptions options)

Instale um APK baseado no DeviceTestRunOptions no dispositivo.

final void installPackage(String apkFileName, String... options)

Instala um APK com base no nome dele no dispositivo.

final void installPackage(ITestDevice device, String apkFileName, String... options)

Instale um APK com base no nome dele em um determinado dispositivo.

final void installPackageAsUser(ITestDevice device, String apkFileName, boolean grantPermission, int userId, String... options)

Instale um APK com o nome de um usuário específico em um determinado dispositivo.

final void installPackageAsUser(String apkFileName, boolean grantPermission, int userId, String... options)

Instala um APK com o nome de um usuário específico.

final boolean isPackageInstalled(String pkg)

Verifica se um pacote de um determinado nome está instalado no dispositivo

final boolean isPackageInstalled(ITestDevice device, String pkg)

Verifica se um pacote de um determinado nome está instalado no dispositivo

final boolean runDeviceTests(ITestDevice device, String pkgName, String testClassName, String testMethodName, Integer userId, Long testTimeoutMs)

Método para executar um pacote de instrumentação instalado.

final boolean runDeviceTests(ITestDevice device, String pkgName, String testClassName, String testMethodName, Long testTimeoutMs, Long maxTimeToOutputMs, Long maxInstrumentationTimeoutMs)

Método para executar um pacote de instrumentação instalado.

final boolean runDeviceTests(ITestDevice device, String runner, String pkgName, String testClassName, String testMethodName, Integer userId, Long testTimeoutMs, Long maxTimeToOutputMs, Long maxInstrumentationTimeoutMs, boolean checkResults, boolean isHiddenApiCheckDisabled, boolean isTestApiCheckDisabled, boolean isIsolatedStorageDisabled, boolean isWindowAnimationDisabled, instrumentationArgs, extraListeners)

Método para executar um pacote de instrumentação instalado.

final boolean runDeviceTests(ITestDevice device, String pkgName, String testClassName, String testMethodName, Long testTimeoutMs)

Método para executar um pacote de instrumentação instalado.

final boolean runDeviceTests(ITestDevice device, String runner, String pkgName, String testClassName, String testMethodName, Integer userId, Long testTimeoutMs, Long maxTimeToOutputMs, Long maxInstrumentationTimeoutMs, boolean checkResults, boolean isHiddenApiCheckDisabled, instrumentationArgs)

Método para executar um pacote de instrumentação instalado.

final boolean runDeviceTests(String pkgName, String testClassName, String testMethodName)

Método para executar um pacote de instrumentação instalado.

final boolean runDeviceTests(DeviceTestRunOptions options)

Executa a base de instrumentação com base nas informações em DeviceTestRunOptions.

final boolean runDeviceTests(ITestDevice device, String runner, String pkgName, String testClassName, String testMethodName, Integer userId, Long testTimeoutMs, Long maxTimeToOutputMs, Long maxInstrumentationTimeoutMs, boolean checkResults, boolean isHiddenApiCheckDisabled, boolean isTestApiCheckDisabled, boolean isIsolatedStorageDisabled, boolean isWindowAnimationDisabled, boolean isRestartDisabled, instrumentationArgs, extraListeners)

Método para executar um pacote de instrumentação instalado.

final boolean runDeviceTests(ITestDevice device, String pkgName, String testClassName, String testMethodName)

Método para executar um pacote de instrumentação instalado.

final boolean runDeviceTests(String pkgName, String testClassName, Integer userId, Long testTimeoutMs)

Método para executar um pacote de instrumentação instalado.

final boolean runDeviceTests(String pkgName, String testClassName)

Método para executar um pacote de instrumentação instalado.

final boolean runDeviceTests(ITestDevice device, String runner, String pkgName, String testClassName, String testMethodName, Integer userId, Long testTimeoutMs, Long maxTimeToOutputMs, Long maxInstrumentationTimeoutMs, boolean checkResults, boolean isHiddenApiCheckDisabled, boolean isTestApiCheckDisabled, boolean isIsolatedStorageDisabled, instrumentationArgs, extraListeners)

Método para executar um pacote de instrumentação instalado.

final boolean runDeviceTests(String pkgName, String testClassName, Long testTimeoutMs)

Método para executar um pacote de instrumentação instalado.

final boolean runDeviceTests(String runner, String pkgName, String testClassName, String testMethodName)

Método para executar um pacote de instrumentação instalado.

final void setAbi(IAbi abi)
final void setTestInformation(TestInformation testInformation)
final String uninstallPackage(String pkgName)

Desinstala um pacote no dispositivo.

final String uninstallPackage(ITestDevice device, String pkgName)

Desinstala um pacote no dispositivo

Construtores públicos

BaseHostJUnit4Test

public BaseHostJUnit4Test ()

Métodos públicos

autoTearDown

public final void autoTearDown ()

Remoção automática de todos os apks instalados. Isso desinstala todos os APKs do dispositivo em que eles foram instalados.

Gera
DeviceNotAvailableException

getAbi

public final IAbi getAbi ()

Retorna
IAbi

getBuild

public final IBuildInfo getBuild ()

Retorna
IBuildInfo

getDevice

public final ITestDevice getDevice ()

Retorna
ITestDevice

getInvocationContext

public final IInvocationContext getInvocationContext ()

Retorna
IInvocationContext

getLastDeviceRunResults

public final TestRunResult getLastDeviceRunResults ()

Retorna o TestRunResult resultante dos últimos runDeviceTests executados. Ou nulo se não houver resultados disponíveis.

Retorna
TestRunResult

getListDevices

public final  getListDevices ()

Retorna

getTestInformation

public TestInformation getTestInformation ()

Retorna
TestInformation

hasDeviceFeature

public boolean hasDeviceFeature (String feature)

Parâmetros
feature String

Retorna
boolean

Gera
DeviceNotAvailableException

installPackage

public final void installPackage (DeviceTestRunOptions options)

Instale um APK baseado no DeviceTestRunOptions no dispositivo. O Apk será limpo automaticamente.

Parâmetros
options DeviceTestRunOptions: as opções de instalação do pacote.

Gera
DeviceNotAvailableException
TargetSetupError

installPackage

public final void installPackage (String apkFileName, 
                String... options)

Instala um APK com base no nome dele no dispositivo. O Apk será limpo automaticamente.

Parâmetros
apkFileName String: o nome do arquivo apk.

options String: opções extras fornecidas ao comando de instalação

Gera
DeviceNotAvailableException
TargetSetupError

installPackage

public final void installPackage (ITestDevice device, 
                String apkFileName, 
                String... options)

Instale um APK com base no nome dele em um determinado dispositivo. O Apk será limpo automaticamente.

Parâmetros
device ITestDevice: o ITestDevice em que o APK será instalado.

apkFileName String: o nome do arquivo apk.

options String: opções extras fornecidas ao comando de instalação

Gera
DeviceNotAvailableException
TargetSetupError

installPackageAsUser

public final void installPackageAsUser (ITestDevice device, 
                String apkFileName, 
                boolean grantPermission, 
                int userId, 
                String... options)

Instala um APK com o nome de um usuário específico em um determinado dispositivo.

Parâmetros
device ITestDevice: o ITestDevice em que o APK será instalado.

apkFileName String: o nome do arquivo apk.

grantPermission boolean: se é necessário transmitir a flag de permissão de concessão ao instalar o APK.

userId int: o ID do usuário em que o APK será instalado.

options String: opções extras fornecidas ao comando de instalação

Gera
DeviceNotAvailableException
TargetSetupError

installPackageAsUser

public final void installPackageAsUser (String apkFileName, 
                boolean grantPermission, 
                int userId, 
                String... options)

Instala um APK com o nome de um usuário específico.

Parâmetros
apkFileName String: o nome do arquivo apk.

grantPermission boolean: se é necessário transmitir a flag de permissão de concessão ao instalar o APK.

userId int: o ID do usuário em que o APK será instalado.

options String: opções extras fornecidas ao comando de instalação

Gera
DeviceNotAvailableException
TargetSetupError

isPackageInstalled

public final boolean isPackageInstalled (String pkg)

Verifica se um pacote de um determinado nome está instalado no dispositivo

Parâmetros
pkg String: o nome do pacote

Retorna
boolean verdadeiro se o pacote for encontrado no dispositivo

Gera
DeviceNotAvailableException

isPackageInstalled

public final boolean isPackageInstalled (ITestDevice device, 
                String pkg)

Verifica se um pacote de um determinado nome está instalado no dispositivo

Parâmetros
device ITestDevice: o dispositivo que precisa desinstalar o pacote.

pkg String: o nome do pacote

Retorna
boolean verdadeiro se o pacote for encontrado no dispositivo

Gera
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String pkgName, 
                String testClassName, 
                String testMethodName, 
                Integer userId, 
                Long testTimeoutMs)

Método para executar um pacote de instrumentação instalado. Use getLastDeviceRunResults() logo depois para conferir os detalhes dos resultados.

Parâmetros
device ITestDevice: o dispositivo em que a instrumentação será executada.

pkgName String: o nome do pacote a ser executado.

testClassName String: o nome da classe de teste a ser executada.

testMethodName String: o nome do método de teste na classe a ser executado.

userId Integer: o ID do usuário em que o teste será executado. Pode ser nulo.

testTimeoutMs Long: o tempo limite em milissegundos a ser aplicado a cada caso de teste.

Retorna
boolean Verdadeiro se for bem-sucedido. Falso em outros casos.

Gera
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String pkgName, 
                String testClassName, 
                String testMethodName, 
                Long testTimeoutMs, 
                Long maxTimeToOutputMs, 
                Long maxInstrumentationTimeoutMs)

Método para executar um pacote de instrumentação instalado. Use getLastDeviceRunResults() logo depois para conferir os detalhes dos resultados.

Parâmetros
device ITestDevice: o dispositivo em que a instrumentação será executada.

pkgName String: o nome do pacote a ser executado.

testClassName String: o nome da classe de teste a ser executada.

testMethodName String: o nome do método de teste na classe a ser executado.

testTimeoutMs Long: o tempo limite em milissegundos a ser aplicado a cada caso de teste.

maxTimeToOutputMs Long: o tempo limite máximo que o teste precisa para começar a gerar algo.

maxInstrumentationTimeoutMs Long: o tempo limite máximo que a instrumentação completa precisa para ser concluída.

Retorna
boolean Verdadeiro se for bem-sucedido. Falso em outros casos.

Gera
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String runner, 
                String pkgName, 
                String testClassName, 
                String testMethodName, 
                Integer userId, 
                Long testTimeoutMs, 
                Long maxTimeToOutputMs, 
                Long maxInstrumentationTimeoutMs, 
                boolean checkResults, 
                boolean isHiddenApiCheckDisabled, 
                boolean isTestApiCheckDisabled, 
                boolean isIsolatedStorageDisabled, 
                boolean isWindowAnimationDisabled, 
                 instrumentationArgs, 
                 extraListeners)

Método para executar um pacote de instrumentação instalado. Use getLastDeviceRunResults() logo depois para conferir os detalhes dos resultados.

Parâmetros
device ITestDevice: o dispositivo em que a instrumentação será executada.

runner String

pkgName String: o nome do pacote a ser executado.

testClassName String: o nome da classe de teste a ser executada.

testMethodName String: o nome do método de teste na classe a ser executado.

userId Integer: o ID do usuário em que o teste será executado. Pode ser nulo.

testTimeoutMs Long: o tempo limite em milissegundos a ser aplicado a cada caso de teste.

maxTimeToOutputMs Long: o tempo limite máximo que o teste precisa para começar a gerar algo.

maxInstrumentationTimeoutMs Long: o tempo limite máximo que a instrumentação completa precisa para ser concluída.

checkResults boolean: se os resultados são verificados quanto a falhas.

isHiddenApiCheckDisabled boolean: se é necessário desativar a verificação de API oculta.

isTestApiCheckDisabled boolean: se é necessário desativar a verificação da API de teste.

isIsolatedStorageDisabled boolean: se é necessário desativar o armazenamento isolado.

isWindowAnimationDisabled boolean: se devemos ou não desativar a animação da janela.

instrumentationArgs : argumentos a serem transmitidos para a instrumentação.

extraListeners

Retorna
boolean Verdadeiro se tiver sido bem-sucedido. Falso em outros casos.

Gera
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String pkgName, 
                String testClassName, 
                String testMethodName, 
                Long testTimeoutMs)

Método para executar um pacote de instrumentação instalado. Use getLastDeviceRunResults() logo depois para conferir os detalhes dos resultados.

Parâmetros
device ITestDevice: o dispositivo em que a instrumentação será executada.

pkgName String: o nome do pacote a ser executado.

testClassName String: o nome da classe de teste a ser executada.

testMethodName String: o nome do método de teste na classe a ser executado.

testTimeoutMs Long: o tempo limite em milissegundos a ser aplicado a cada caso de teste.

Retorna
boolean Verdadeiro se for bem-sucedido. Falso em outros casos.

Gera
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String runner, 
                String pkgName, 
                String testClassName, 
                String testMethodName, 
                Integer userId, 
                Long testTimeoutMs, 
                Long maxTimeToOutputMs, 
                Long maxInstrumentationTimeoutMs, 
                boolean checkResults, 
                boolean isHiddenApiCheckDisabled, 
                 instrumentationArgs)

Método para executar um pacote de instrumentação instalado. Use getLastDeviceRunResults() logo depois para conferir os detalhes dos resultados.

Parâmetros
device ITestDevice: o dispositivo em que a instrumentação será executada.

runner String

pkgName String: o nome do pacote a ser executado.

testClassName String: o nome da classe de teste a ser executada.

testMethodName String: o nome do método de teste na classe a ser executado.

userId Integer: o ID do usuário em que o teste será executado. Pode ser nulo.

testTimeoutMs Long: o tempo limite em milissegundos a ser aplicado a cada caso de teste.

maxTimeToOutputMs Long: o tempo limite máximo que o teste precisa para começar a gerar algo.

maxInstrumentationTimeoutMs Long: o tempo limite máximo que a instrumentação completa precisa para ser concluída.

checkResults boolean: se os resultados são verificados quanto a falhas.

isHiddenApiCheckDisabled boolean: se é necessário desativar a verificação de API oculta.

instrumentationArgs : argumentos a serem transmitidos para a instrumentação.

Retorna
boolean Verdadeiro se tiver sido bem-sucedido. Falso em outros casos.

Gera
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (String pkgName, 
                String testClassName, 
                String testMethodName)

Método para executar um pacote de instrumentação instalado. Use getLastDeviceRunResults() logo depois para conferir os detalhes dos resultados.

Parâmetros
pkgName String: o nome do pacote a ser executado.

testClassName String: o nome da classe de teste a ser executada.

testMethodName String: o nome do método de teste na classe a ser executado.

Retorna
boolean Verdadeiro se for bem-sucedido. Falso em outros casos.

Gera
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (DeviceTestRunOptions options)

Executa a base de instrumentação com base nas informações em DeviceTestRunOptions.

Parâmetros
options DeviceTestRunOptions: o DeviceTestRunOptions que direciona a configuração da instrumentação.

Retorna
boolean Verdadeiro se tiver sido bem-sucedido. Falso em outros casos.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String runner, 
                String pkgName, 
                String testClassName, 
                String testMethodName, 
                Integer userId, 
                Long testTimeoutMs, 
                Long maxTimeToOutputMs, 
                Long maxInstrumentationTimeoutMs, 
                boolean checkResults, 
                boolean isHiddenApiCheckDisabled, 
                boolean isTestApiCheckDisabled, 
                boolean isIsolatedStorageDisabled, 
                boolean isWindowAnimationDisabled, 
                boolean isRestartDisabled, 
                 instrumentationArgs, 
                 extraListeners)

Método para executar um pacote de instrumentação instalado. Use getLastDeviceRunResults() logo depois para conferir os detalhes dos resultados.

Parâmetros
device ITestDevice: o dispositivo em que a instrumentação será executada.

runner String

pkgName String: o nome do pacote a ser executado.

testClassName String: o nome da classe de teste a ser executada.

testMethodName String: o nome do método de teste na classe a ser executado.

userId Integer: o ID do usuário em que o teste será executado. Pode ser nulo.

testTimeoutMs Long: o tempo limite em milissegundos a ser aplicado a cada caso de teste.

maxTimeToOutputMs Long: o tempo limite máximo que o teste precisa para começar a gerar algo.

maxInstrumentationTimeoutMs Long: o tempo limite máximo que a instrumentação completa precisa para ser concluída.

checkResults boolean: se os resultados são verificados quanto a falhas.

isHiddenApiCheckDisabled boolean: se é necessário desativar a verificação de API oculta.

isTestApiCheckDisabled boolean: se é necessário desativar a verificação da API de teste.

isIsolatedStorageDisabled boolean: se é necessário desativar o armazenamento isolado.

isWindowAnimationDisabled boolean: se devemos ou não desativar a animação da janela.

isRestartDisabled boolean

instrumentationArgs : argumentos a serem transmitidos para a instrumentação.

extraListeners

Retorna
boolean Verdadeiro se tiver sido bem-sucedido. Falso em outros casos.

Gera
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String pkgName, 
                String testClassName, 
                String testMethodName)

Método para executar um pacote de instrumentação instalado. Use getLastDeviceRunResults() logo depois para conferir os detalhes dos resultados.

Parâmetros
device ITestDevice: o dispositivo em que a instrumentação será executada.

pkgName String: o nome do pacote a ser executado.

testClassName String: o nome da classe de teste a ser executada.

testMethodName String: o nome do método de teste na classe a ser executado.

Retorna
boolean Verdadeiro se for bem-sucedido. Falso em outros casos.

Gera
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (String pkgName, 
                String testClassName, 
                Integer userId, 
                Long testTimeoutMs)

Método para executar um pacote de instrumentação instalado. Use getLastDeviceRunResults() logo depois para conferir os detalhes dos resultados.

Parâmetros
pkgName String: o nome do pacote a ser executado.

testClassName String: o nome da classe de teste a ser executada.

userId Integer: o ID do usuário em que o teste será executado. Pode ser nulo.

testTimeoutMs Long: o tempo limite em milissegundos a ser aplicado a cada caso de teste.

Retorna
boolean Verdadeiro se for bem-sucedido. Falso em outros casos.

Gera
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (String pkgName, 
                String testClassName)

Método para executar um pacote de instrumentação instalado. Use getLastDeviceRunResults() logo depois para conferir os detalhes dos resultados.

Parâmetros
pkgName String: o nome do pacote a ser executado.

testClassName String: o nome da classe de teste a ser executada.

Retorna
boolean Verdadeiro se for bem-sucedido. Falso em outros casos.

Gera
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String runner, 
                String pkgName, 
                String testClassName, 
                String testMethodName, 
                Integer userId, 
                Long testTimeoutMs, 
                Long maxTimeToOutputMs, 
                Long maxInstrumentationTimeoutMs, 
                boolean checkResults, 
                boolean isHiddenApiCheckDisabled, 
                boolean isTestApiCheckDisabled, 
                boolean isIsolatedStorageDisabled, 
                 instrumentationArgs, 
                 extraListeners)

Método para executar um pacote de instrumentação instalado. Use getLastDeviceRunResults() logo depois para conferir os detalhes dos resultados.

Parâmetros
device ITestDevice: o dispositivo em que a instrumentação será executada.

runner String

pkgName String: o nome do pacote a ser executado.

testClassName String: o nome da classe de teste a ser executada.

testMethodName String: o nome do método de teste na classe a ser executado.

userId Integer: o ID do usuário em que o teste será executado. Pode ser nulo.

testTimeoutMs Long: o tempo limite em milissegundos a ser aplicado a cada caso de teste.

maxTimeToOutputMs Long: o tempo limite máximo que o teste precisa para começar a gerar algo.

maxInstrumentationTimeoutMs Long: o tempo limite máximo que a instrumentação completa precisa para ser concluída.

checkResults boolean: se os resultados são verificados quanto a falhas.

isHiddenApiCheckDisabled boolean: se é necessário desativar a verificação de API oculta.

isTestApiCheckDisabled boolean: se é necessário desativar a verificação da API de teste.

isIsolatedStorageDisabled boolean: se é necessário desativar o armazenamento isolado.

instrumentationArgs : argumentos a serem transmitidos para a instrumentação.

extraListeners

Retorna
boolean Verdadeiro se tiver sido bem-sucedido. Falso em outros casos.

Gera
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (String pkgName, 
                String testClassName, 
                Long testTimeoutMs)

Método para executar um pacote de instrumentação instalado. Use getLastDeviceRunResults() logo depois para conferir os detalhes dos resultados.

Parâmetros
pkgName String: o nome do pacote a ser executado.

testClassName String: o nome da classe de teste a ser executada.

testTimeoutMs Long: o tempo limite em milissegundos a ser aplicado a cada caso de teste.

Retorna
boolean Verdadeiro se for bem-sucedido. Falso em outros casos.

Gera
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (String runner, 
                String pkgName, 
                String testClassName, 
                String testMethodName)

Método para executar um pacote de instrumentação instalado. Use getLastDeviceRunResults() logo depois para conferir os detalhes dos resultados.

Parâmetros
runner String: o executor de instrumentação a ser usado.

pkgName String: o nome do pacote a ser executado.

testClassName String: o nome da classe de teste a ser executada.

testMethodName String: o nome do método de teste na classe a ser executado.

Retorna
boolean Verdadeiro se for bem-sucedido. Falso em outros casos.

Gera
DeviceNotAvailableException

setAbi

public final void setAbi (IAbi abi)

Parâmetros
abi IAbi

setTestInformation

public final void setTestInformation (TestInformation testInformation)

Parâmetros
testInformation TestInformation

uninstallPackage

public final String uninstallPackage (String pkgName)

Desinstala um pacote no dispositivo.

Parâmetros
pkgName String: o pacote Android a ser desinstalado

Retorna
String String com um código de erro ou null em caso de sucesso

Gera
DeviceNotAvailableException

uninstallPackage

public final String uninstallPackage (ITestDevice device, 
                String pkgName)

Desinstala um pacote no dispositivo

Parâmetros
device ITestDevice: o dispositivo que precisa desinstalar o pacote.

pkgName String: o pacote Android a ser desinstalado

Retorna
String String com um código de erro ou null se for bem-sucedido

Gera
DeviceNotAvailableException