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:

TC-SP

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