Alguns módulos de teste podem exigir etapas de configuração e remoção personalizadas que não podem ser realizadas no próprio caso de teste. Exemplos típicos incluem:
- instalar outros APKs (além do APK de teste)
- enviar alguns arquivos para o dispositivo
- executar comandos (por exemplo, adb shell pm ...)
No passado, as equipes de componentes geralmente recorriam à criação de um teste do lado do host para realizar essas tarefas, o que exige o entendimento do harness da Trade Federation e geralmente aumenta a complexidade de um módulo de teste .
Usando o CTS, apresentamos o conceito de configuração de módulo de teste para oferecer suporte a essas tarefas. A lista de tarefas comuns acima pode ser alcançada com apenas algumas linhas de configuração. Para ter a máxima flexibilidade, você pode implementar seu próprio preparador de destino, conforme definido por ITargetPreparer ou ITargetCleaner, e configurá-los para uso na sua própria configuração de módulo de teste.
A configuração de um módulo de teste é um arquivo XML obrigatório adicionado à pasta de origem do módulo de nível superior, chamada "AndroidTest.xml". O XML segue o formato de um arquivo de configuração usado pelo harness de automação de testes da Trade Federation. No momento, as tags principais processadas pelas configurações do módulo de teste são "target_preparer" e "test".
Preparadores de destino
Uma tag "target_preparer", como o nome sugere, define um preparador de destino (consulte ITargetPreparer) que oferece um método de configuração, que é chamado antes que o módulo de teste seja executado para teste. Se a classe referenciada na tag "target_preparer" também implementar ITargetCleaner, o método de desmontagem dela será invocado após o término do módulo de teste.
Para usar a configuração integrada do módulo comum, adicione um novo arquivo "AndroidTest.xml" na pasta de nível superior do módulo de teste e preencha-o com o seguinte conteúdo:
<?xml version="1.0" encoding="utf-8"?>
<!-- [insert standard AOSP copyright here] -->
<configuration description="Test module config for Foo">
<!-- insert options here -->
</configuration>
Como exemplo, podemos adicionar as seguintes tags de opção (no comentário "inserir" acima):
<target_preparer class="com.android.tradefed.targetprep.RunCommandTargetPreparer">
<option name="run-command" value="settings put secure accessibility_enabled 1" />
<option name="teardown-command" value="settings put secure accessibility_enabled 0" />
</target_preparer>
As opções vão configurar o harness de teste para:
- Antes que o módulo de teste seja invocado, execute o comando shell "settings put secure accessibility_enabled 1" no dispositivo.
- Depois que o módulo de teste for concluído, execute o comando do shell "settings put secure accessibility_enabled 0".
Neste exemplo específico, a acessibilidade é ativada/desativada antes/depois da execução do módulo de teste, respectivamente. Com um exemplo simples demonstrado, é necessário cobrir mais detalhes sobre como a tag "option" é usada. Como mostrado acima, a tag pode ter dois atributos: nome e valor. O atributo de nome precisa se referir a uma das opções oferecidas pelo preparador.
A finalidade exata do campo de valor depende de como o preparador definiu a opção: ela pode ser uma string, um número, um booleano ou até mesmo um caminho de arquivo. Confira um resumo dos três preparadores de destino comuns:
nome da classe: PushFilePreparer
- nome curto: push-file
- function: envia arquivos arbitrários na pasta do caso de teste para o destino no dispositivo
- anotações:
- Esse preparador pode enviar de uma pasta para outra ou de um arquivo para outro. Ou seja, não é possível enviar um arquivo em uma pasta no dispositivo: é necessário especificar o nome do arquivo de destino nessa pasta também.
- opções:
- push-file:uma push-spec, que especifica o arquivo local para o caminho em que ele precisa ser enviado no dispositivo. Pode ser repetido. Se vários arquivos estiverem configurados para serem enviados para o mesmo caminho remoto, o mais recente será enviado.
- push:(descontinuado) uma especificação de push, formatada como
'
/path/to/srcfile.txt->/path/to/destfile.txt' ou '/path/to/srcfile.txt->/path/to/destdir/'. Pode ser repetida. Esse caminho pode ser relativo ao diretório do módulo de teste ou ao próprio diretório de saída. - pós-envio:um comando para executar no dispositivo (com "
adb shell <your command>") depois que todos os envios forem tentados. O caso de uso típico seria usar chmod para permissões.
nome da classe: InstallApkSetup
- nome curto:install-apk
- function:envia arquivos APK arbitrários para o destino no dispositivo.
- options:
- nome-do-arquivo-de-teste:o nome do apk a ser instalado no dispositivo.
- install-arg:argumentos adicionais a serem transmitidos para o comando pm install, incluindo o traço inicial, por exemplo, "-d". Pode ser repetido
nome da classe: RunCommandTargetPreparer
- nome curto: run-command
- function:executa comandos arbitrários do shell antes ou depois da execução do módulo de teste.
- options:
- run-command:comando do shell adb a ser executado. Pode ser repetido
- teardown-command:comando do shell adb a ser executado durante a fase de desmontagem. Pode ser repetido
Classe de teste
Uma classe de teste é a classe Trade Federation usada para executar o teste.
<test class="com.android.tradefed.testtype.AndroidJUnitTest">
<option name="package" value="android.test.example.helloworld"/>
<option name="runner" value="android.support.test.runner.AndroidJUnitRunner"/>
</test>
Estas são três classes de teste comuns:
nome da classe: GTest
- nome curto: gtest
- function:um teste que executa um pacote de teste nativo em um determinado dispositivo.
- options:
- native-test-device-path:o caminho no dispositivo onde os testes nativos estão localizados.
nome da classe: InstrumentationTest
- nome curto: instrumentação
- function:um teste que executa um pacote de teste de instrumentação em um determinado dispositivo.
- options:
- package:o nome do pacote do manifesto do app de teste Android a ser executado.
- class:o nome da classe de teste a ser executada.
- method:o nome do método de teste a ser executado.
nome da classe: AndroidJUnitTest
- função:um teste que executa um pacote de teste de instrumentação em um determinado dispositivo usando o android.support.test.runner.AndroidJUnitRunner. Essa é a maneira principal de executar um teste de instrumentação.