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
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.
getAbi
public final IAbi getAbi ()
getLastDeviceRunResults
public final TestRunResult getLastDeviceRunResults ()
Retorna o TestRunResult
resultante dos últimos runDeviceTests executados. Ou nulo
se não houver resultados disponíveis.
getListDevices
public final getListDevices ()
hasDeviceFeature
public boolean hasDeviceFeature (String feature)
Parâmetros |
feature |
String |
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. |
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 |
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 |
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 |
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 |
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 |
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 |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
setAbi
public final void setAbi (IAbi abi)
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 |
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 |