Test Cloud Command-Line Interface
O Test Cloud CLI é uma ferramenta para execução de testes via terminal, acessando todos os benefícios do Test Cloud.
Servidores disponíveis:
Instalando o CLI
Acesse o terminal e execute o comando:
npm install testcloud -g
Configurando
Para que seja possível executar um teste pelo CLI, é necessário configurar alguns parâmetros.
Dentro do seu projeto de testes, execute o comando:
testcloud init
Após este comando, serão solicitadas as seguintes informações:
- Test type - Seleciona o tipo de teste a ser executado. Atualmente, o TestCloud suporta testes Calabash e testes unitários instrumentados
- Project name - Cria um novo projeto para associar testes. Caso o nome informado já exista, as informações serão atreladas ao projeto existente. Mínimo de 4 caracteres
- App file path - Caminho onde está o apk/ipa para execução dos testes
- Test directory path - Caminho onde estão os testes automatizados
- Url to TestCloud API - URL do servidor onde os testes serão executados (links acima)
- Calabash tags (somente para Calabash) - Tags opcionais utilizadas nos testes Calabash
Após finalizado, será gerado no diretório um arquivo .testcloud.json com os dados informados.
Listando devices
Para listar os devices disponíveis para teste no TestCloud, execute:
testcloud devices -u <url_servidor>
url_servidor pode ser omitido caso tenha sido previamente definido no arquivo de configuração
Exemplo
testcloud devices -u http://tcsp01.concrete.com.br:8443
Executando os testes
Com arquivo de configuração
Após a configuração, para rodar os testes execute o comando:
testcloud run <calabash|unit>
Os testes serão iniciados de acordo com as informações configuradas previamente.
Sem arquivo de configuração
Caso opte por não realizar a configuração, é possível rodar um teste passando os argumentos manualmente:
Calabash:
testcloud run calabash -n <nome_da_execução>
-p <nome_do_projeto>
-a <caminho_app>
-t <caminho_teste_calabash>
-u <url_servidor>
-d <lista_de_devices>
-r <calabash_run_tags>
Diferentemente do CLI do Calabash, as tags devem ser passadas sem '--t'.
Exemplo:
testcloud run calabash -n execucao_calabash \
-p meu_projeto \
-a caminho/do/app.apk \
-t caminho/do/teste/calabash \
-u http://tcsp01.concrete.com.br:8443 \
-d device_id_1 device_id_2 \
-r '@tag_inclusao ~@tag_exclusao'
Unit:
testcloud run unit -n <nome_da_execução>
-p <nome_do_projeto>
-a <caminho_app>
-t <caminho_app_instrumentacao>
-u <url_servidor>
-d <lista_de_devices>
Exemplo:
testcloud run unit -n execucao_unit \
-p meu_projeto \
-a caminho/do/app.apk \
-t caminho/do/app_teste.apk \
-u http://tcsp01.concrete.com.br:8443 \
-d device_id_1 device_id_2
Caso queira executar um teste com o arquivo de configuração, porém mudando apenas algum parâmetro, execute o comando e passe o argumento que deseja modificar.
Caso o nome_da_execução seja omitido, um nome único é criado automaticamente.
Acompanhamento de log da execução
Para monitorar a exeucução de um teste em um device, execute o comando:
testcloud logs -u <url_servidor>
-r <id_da_execução>
-d <id_do_device>
Exemplo:
testcloud logs -u http://tcsp01.concrete.com.br:8443 \
-r id_da_execucao \
-d device_id_1 device_id_2
Consulta de resultados
Para realizar o download dos resultados dos testes agendados, execute o comando:
testcloud get-report -u <url_servidor>
-r <id_da_execução>
-d <id_do_device>
-o <caminho_de_output>
Exemplo:
testcloud get-report -u http://tcsp01.concrete.com.br:8443 \
-r id_da_execucao \
-d device_id_1 device_id_2 \
-o caminho/dos/resultados
url_servidor pode ser omitido caso tenha sido previamente definido no arquivo de configuração
Helper
Para ajuda dentro do terminal, execute:
testcloud -h