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 os testes de instrumentação do lado do host. Esta classe é compatível com vários dispositivos. Deve ser a única fonte de verdade para executar testes de instrumentação do lado do host, a fim de evitar duplicação de utilitário e classe 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 runDeviceTests mais recentes executados.

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

Instale um APK com base no DeviceTestRunOptions do dispositivo.

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

Instale um apk determinado no dispositivo.

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

Instala um apk com o nome em um determinado dispositivo.

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 dispositivo.

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

Instalar um apk com o nome de um usuário específico.

final boolean isPackageInstalled(String pkg)

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

final boolean isPackageInstalled(ITestDevice device, String pkg)

Verifica se um pacote com 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 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(String pkgName, String testClassName, 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, boolean isTestApiCheckDisabled, boolean isIsolatedStorageDisabled, instrumentationArgs, extraListeners)

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 desinstalará todo o APK do dispositivo em que 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 runDeviceTests mais recentes 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 com base no DeviceTestRunOptions do dispositivo. O APK será limpos automaticamente.

Parâmetros
options DeviceTestRunOptions: as opções da instalação do pacote.
Gera
DeviceNotAvailableException
TargetSetupError

installPackage

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

Instale um apk determinado 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)

Instala um apk com o nome 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 dispositivo.

Parâmetros
device ITestDevice: o ITestDevice em que o APK será instalado.
apkFileName String: o nome do arquivo APK.
grantPermission boolean: se a flag de permissão vai ser transmitida 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)

Instalar um apk com o nome de um usuário específico.

Parâmetros
apkFileName String: o nome do arquivo APK.
grantPermission boolean: se a flag de permissão vai ser transmitida 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

isPackageInstall

public final boolean isPackageInstalled (String pkg)

Verifica se um pacote com 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

isPackageInstall

public final boolean isPackageInstalled (ITestDevice device, 
                String pkg)

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

Parâmetros
device ITestDevice: o dispositivo que vai 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. Usar o getLastDeviceRunResults() logo em seguida para obter 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 executada.
userId Integer: o ID do usuário para executar o teste. pode ser nulo.
testTimeoutMs Long: tempo limite em milissegundos que será aplicado a cada caso de teste.
Retorna
boolean Verdadeiro se for bem-sucedida sem falhas. Falso, do contrário.
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. Usar o getLastDeviceRunResults() logo em seguida para obter 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 executada.
testTimeoutMs Long: tempo limite em milissegundos que 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 ser concluída.
Retorna
boolean Verdadeiro se for bem-sucedida sem falhas. Falso, do contrário.
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. Usar o getLastDeviceRunResults() logo em seguida para obter 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 executada.
userId Integer: o ID do usuário para executar o teste. pode ser nulo.
testTimeoutMs Long: tempo limite em milissegundos que 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 ser concluída.
checkResults boolean: se os resultados serão verificados quanto a falhas.
isHiddenApiCheckDisabled boolean: se precisamos ou não desativar a verificação de API oculta.
isTestApiCheckDisabled boolean: se precisamos ou não desativar a verificação da API de teste.
isIsolatedStorageDisabled boolean: se o armazenamento isolado precisa ou não ser desativado.
isWindowAnimationDisabled boolean: se precisamos ou não desativar a animação de janela.
instrumentationArgs : argumentos a serem transmitidos para a instrumentação.
extraListeners

Retorna
boolean Verdadeiro se for bem-sucedida sem falha. Falso, do contrário.
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. Usar o getLastDeviceRunResults() logo em seguida para obter 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 executada.
testTimeoutMs Long: tempo limite em milissegundos que será aplicado a cada caso de teste.
Retorna
boolean Verdadeiro se for bem-sucedida sem falhas. Falso, do contrário.
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. Usar o getLastDeviceRunResults() logo em seguida para obter 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 executada.
userId Integer: o ID do usuário para executar o teste. pode ser nulo.
testTimeoutMs Long: tempo limite em milissegundos que 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 ser concluída.
checkResults boolean: se os resultados serão verificados quanto a falhas.
isHiddenApiCheckDisabled boolean: se precisamos ou não desativar a verificação de API oculta.
instrumentationArgs : argumentos a serem transmitidos para a instrumentação.
Retorna
boolean Verdadeiro se for bem-sucedida sem falha. Falso, do contrário.
Gera
DeviceNotAvailableException

runDeviceTests

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

Método para executar um pacote de instrumentação instalado. Usar o getLastDeviceRunResults() logo em seguida para obter 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 executada.
Retorna
boolean Verdadeiro se for bem-sucedida sem falhas. Falso, do contrário.
Gera
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (DeviceTestRunOptions options)

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

Parâmetros
options DeviceTestRunOptions: o DeviceTestRunOptions que orienta a configuração de instrumentação.
Retorna
boolean Verdadeiro se for bem-sucedida sem falha. Falso, do contrário.
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. Usar o getLastDeviceRunResults() logo em seguida para obter 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 executada.
userId Integer: o ID do usuário para executar o teste. pode ser nulo.
testTimeoutMs Long: tempo limite em milissegundos que 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 ser concluída.
checkResults boolean: se os resultados serão verificados quanto a falhas.
isHiddenApiCheckDisabled boolean: se precisamos ou não desativar a verificação de API oculta.
isTestApiCheckDisabled boolean: se precisamos ou não desativar a verificação da API de teste.
isIsolatedStorageDisabled boolean: se o armazenamento isolado precisa ou não ser desativado.
isWindowAnimationDisabled boolean: se precisamos ou não desativar a animação de janela.
isRestartDisabled boolean

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

Retorna
boolean Verdadeiro se for bem-sucedida sem falha. Falso, do contrário.
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. Usar o getLastDeviceRunResults() logo em seguida para obter 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 executada.
Retorna
boolean Verdadeiro se for bem-sucedida sem falhas. Falso, do contrário.
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. Usar o getLastDeviceRunResults() logo em seguida para obter 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 para executar o teste. pode ser nulo.
testTimeoutMs Long: tempo limite em milissegundos que será aplicado a cada caso de teste.
Retorna
boolean Verdadeiro se for bem-sucedida sem falhas. Falso, do contrário.
Gera
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (String pkgName, 
                String testClassName)

Método para executar um pacote de instrumentação instalado. Usar o getLastDeviceRunResults() logo em seguida para obter 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-sucedida sem falhas. Falso, do contrário.
Gera
DeviceNotAvailableException

runDeviceTests

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

Método para executar um pacote de instrumentação instalado. Usar o getLastDeviceRunResults() logo em seguida para obter 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: tempo limite em milissegundos que será aplicado a cada caso de teste.
Retorna
boolean Verdadeiro se for bem-sucedida sem falhas. Falso, do contrário.
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. Usar o getLastDeviceRunResults() logo em seguida para obter 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 executada.
userId Integer: o ID do usuário para executar o teste. pode ser nulo.
testTimeoutMs Long: tempo limite em milissegundos que 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 ser concluída.
checkResults boolean: se os resultados serão verificados quanto a falhas.
isHiddenApiCheckDisabled boolean: se precisamos ou não desativar a verificação de API oculta.
isTestApiCheckDisabled boolean: se precisamos ou não desativar a verificação da API de teste.
isIsolatedStorageDisabled boolean: se o armazenamento isolado precisa ou não ser desativado.
instrumentationArgs : argumentos a serem transmitidos para a instrumentação.
extraListeners

Retorna
boolean Verdadeiro se for bem-sucedida sem falha. Falso, do contrário.
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. Usar o getLastDeviceRunResults() logo em seguida para obter 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 executada.
Retorna
boolean Verdadeiro se for bem-sucedida sem falhas. Falso, do contrário.
Gera
DeviceNotAvailableException

SetAbi

public final void setAbi (IAbi abi)

Parâmetros
abi IAbi

setTestInformation

public final void setTestInformation (TestInformation testInformation)

Parâmetros
testInformation TestInformation

desinstalarPackage

public final String uninstallPackage (String pkgName)

Desinstala um pacote no dispositivo.

Parâmetros
pkgName String: o pacote do Android a ser desinstalado.
Retorna
String um String com um código de erro ou null em caso de sucesso
Gera
DeviceNotAvailableException

desinstalarPackage

public final String uninstallPackage (ITestDevice device, 
                String pkgName)

Desinstala um pacote no dispositivo

Parâmetros
device ITestDevice: o dispositivo que vai desinstalar o pacote.
pkgName String: o pacote do Android a ser desinstalado.
Retorna
String um String com um código de erro ou null em caso de sucesso
Gera
DeviceNotAvailableException