Alguns módulos de teste podem exigir etapas personalizadas de configuração e desmontagem que não podem ser realizadas no próprio caso de teste. Exemplos comuns podem incluir:
- 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 do Trade Federation e geralmente aumenta a complexidade de um módulo de teste .
Usando o CTS, introduzimos 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 configuração do 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 segmentação
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 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 conjunto de testes 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: 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
- observações:
- este preparador pode enviar por push de pasta para pasta ou de arquivo para arquivo. Ou seja, não é possível enviar um arquivo em uma pasta no dispositivo: você também precisa especificar o nome de 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 push, formatada como
"
/path/to/srcfile.txt->/path/to/destfile.txt" ou "/path/to/srcfile.txt->/path/to/destdir/". Pode ser repetido. Esse caminho pode ser relativo ao diretório do módulo de teste ou ao próprio diretório externo. - post-push: um comando a ser executado no dispositivo (com `
adb shell <your command>`) depois que todas as tentativas forem realizadas. Um 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
- função:executa comandos arbitrários do shell antes ou depois da execução do módulo de teste.
- opções:
- run-command:o comando do shell do 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
- função: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
- função:um teste que executa um pacote de teste de instrumentação em um determinado dispositivo.
- opções:
- 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 determinado dispositivo usando o android.support.test.runner.AndroidJUnitRunner. Essa é a principal maneira de executar um teste de instrumentação.