FrameworkDemoiselle.gov.brCommunity Documentation

Capítulo 11. Testes de Regressão de Layout

11.1. Conceito
11.2. Pré Requisitos
11.2.1. Java
11.2.2. Image Magick
11.2.3. Projeto dbehave
11.2.4. Maven
11.3. Configuração do Projeto dbehave
11.3.1. Configurações Básicas do pom.xml
11.3.2. Configurações do behave.properties
11.3.3. Repositório Local de Imagens
11.4. Pontos de Comparação
11.5. Rodando o Teste de Regressão
11.6. Relatório Gerado

Neste capítulo será apresentada a funcionalidade que permite a comparação de layout entre navegadores diferentes a partir de histórias desenvolvidas em projetos do dbehave.

Atenção

Esta funcionalidade está disponível a partir da versão 1.5.0 do dbehave.

11.1. Conceito

A ideia principal da funcionalidade é permitir a equipe do projeto ter uma visibilidade, por meio de imagens e números, das diferenças de design entre os diversos navegadores que são, ou serão, suportados pelo sistema.

O processo de navegação no sistema deve ser feito por meio das histórias do dbehave, que em alguns casos já existem, e a partir de imagens capturadas durante o processo seja gerado um relatório ao final do teste, comparando os navegadores selecionados com um que deve ser o navegador de referência.

11.2. Pré Requisitos

Para que o teste de regressão de layout funcione corretamente são necessárias algumas tecnologias durante o processo, seguem elas.

É necessário ter o Java (JDK) instalado para que o processo funcione, normalmente as máquinas que já rodam o dbehave já possuem a versão necessária. Para verificar se a JDK está instalada corretamente rode o seguinte comando: 

java -version

A saída do console deverá ser parecida com esta:

java version "1.6.0_35"
OpenJDK Runtime Environment (IcedTea6 1.13.7) (6b35-1.13.7-1ubuntu0.12.04.2)
OpenJDK Server VM (build 23.25-b01, mixed mode)

Para que o processo de comparação dos layouts funcione corretamente é necessário que a biclioteca Image Magick (http://www.imagemagick.org) seja instalada. A instalação desta biblioteca em muitas distribuições Linux, como a Ubuntu 12.04, pode ser feita através do seguinte comando: 

sudo apt-get install imagemagick

Após a instalação acesse o Promp/Terminar do computador que irá rodar os testes e rode o seguinte comando:

compare --version

E o resultado deverá ser algo como o seguinte texto:

Version: ImageMagick 6.9.0-0 Q16 i686 2014-11-24 http://www.imagemagick.org
Copyright: Copyright (C) 1999-2014 ImageMagick Studio LLC
Features: DPC OpenMP
Delegates (built-in): png x zlib

O teste de regressão tem como pré requisito inicial um projeto dbehave já criado, caso ainda não tenha criado um basta seguir o Roteiro Rápido do manual do dbehave.

Para que o teste rode corretamente é necessário que a máquina tenha instalado o Maven, para saber se ele esta funcionando corretamente rode o seguinte comando no prompt/terminal: 

mvn --version

A saída do console deverá ser algo parecido com o seguinte:

Apache Maven 2.2.1 (rdebian-8)
Java version: 1.6.0_33
Java home: /usr/lib/jvm/java-6-serpro-1.6.0.33/jre
Default locale: pt_BR, platform encoding: UTF-8
OS name: "linux" version: "3.2.0-58-generic-pae" arch: "i386" Family: "unix"

11.3. Configuração do Projeto dbehave

Esta sessão descreve como o projeto dbehave deve ser configurado para que o teste de regressão rode.

Esta funcionalidade possui basicamente 2 inclusões no pom.xml:

Para adicionar os passos personalizados basta adicionar uma nova dependência ao pom.xml na tag dependencies como segue abaixo: 

<dependency>
    <groupId>br.gov.frameworkdemoiselle.component.behave</groupId>
    <artifactId>demoiselle-behave-regression-step</artifactId>
    <scope>test</scope>
</dependency>

E a outra configuração é a inclusão do plugin maven dentro da tag build/plugins como abaixo: 

<build>
    <plugins>
        <plugin>
            <groupId>br.gov.frameworkdemoiselle.component.behave</groupId>
            <artifactId>demoiselle-behave-regression-report</artifactId>
            <version>1.5.0</version>                
            <executions>
                <execution>
                    <phase>test</phase>
                    <goals>
                        <goal>regression</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

Para que as capturas de tela e relatório seja gerado são necessárias algumas configurações no behave.properties

Para o repositório local ele irá usar o diretório home do usuário como padrão, por exemplo, no Linux ele irá ficar em /home/NOME_DO_USUARIO/.dbehave/.

A configuração é bem simples, basta selecionar a seguinte propriedade:

behave.regression.type=local

11.4. Pontos de Comparação

Para que as novas frases de captura funcionem é necessário adicionar os passos ao dbehave por meio do seguinte comando:

BehaveContext.getInstance().addSteps(new RegressionSteps());

Para que as telas sejam capturadas basta utilizar uma das seguinte frases:

Quando tiro um print screen
Quando tiro um print screen com o nome "NOME DA CAPTURA QUE APARECERÁ NO RELATÓRIO"

11.5. Rodando o Teste de Regressão

Mostrar o comando maven e a saída do console e o relatório. O resultado final será criado na pasta /target/dbehave do seu projeto dbehave. É recomendado que sejam criados novos métodos JUnit com o seguinte código: 

@Test // Anotação JUnit
public void testRegressaoLayout() throws Throwable {

    // Laço de repetição para testar com todos os navagedores
    for (String browser : RegressionConfig.getTypes()) {
        RegressionConfig.setCurrentType(browser);  // Seleciona o navegador atual

        eng.addStoriesReuse("/stories/XXXX.story"); // Histórias de reuso
        eng.addStories("/stories/XXXXX.story"); // Histórias que irão rodar

        eng.addSteps(new MySteps());  // Passos customizados
        eng.addSteps(new RegressionSteps()); // Passos de captura

        // Roda o teste para o navegador atual selecionado no setCurrentType
        eng.run();
    }

}

11.6. Relatório Gerado

Atenção

O relatório só será gerado se os testes funcionais passarem e quando for executado via maven (mvn package), pois o relatório é gerado por meio de um plugin.

O relatório final será criado na pasta /target/dbehave do seu projeto dbehave e possuirá as seguintes características.

Exemplo de Relatório de Teste de Regressão de Layout