Objetivo

Este guia tem o objetivo de apresentar, de maneira resumida, informações sobre o processo de Pré-QA dos apps desenvolvidos pelos parceiros da fluig Store.

Visão Geral

Após finalizar o desenvolvimento e testes do seu app, é o momento de enviá-lo para o quality assurance (QA). Para quem já é um parceiro fluig Store, acesse o documento completo do check-list de QA no Portal da fluig Store.

Porém, antes do envio para o QA de fato, existe essa etapa que chamamos de Pré-QA onde são avaliados alguns pré-requisitos antes mesmo da utilização do app.

Esse documento é um checklist básico de instruções que você deve seguir para agilizar o processo de Pré-QA do seu app. Seguindo corretamente essas instruções, podemos encaminhar o seu app para a etapa final no processo de QA.

Itens Avaliados

1. Adequação e clean code

• Widgets, Layouts e outros componentes do fluig já possuem uma estrutura padrão com pastas pré-definidas (css, js, images). Mantenha essa estrutura organizada.

• Referenciar todo e qualquer biblioteca de JS no arquivo application.info.

• Não deixe arquivos que não estão sendo utilizados dentro do componente. Se houver, remova-os antes de enviar para o QA.

• O fluig já inclui algumas das bibliotecas mais utilizadas, como jQuery, jQuery UI e o próprio fluig Style Guide. Não é necessário adicioná-las novamente.

• Internacionalização: Ao criar qualquer label, avisos, títulos e demais informações, é necessário internacionalizar os textos.

• Utilizar a verificação de licença através da API de Licença.

2. Componente adaptado para a fluig Store

Para a fluig Store, padronizamos a estrutura que o componente deve ser desenvolvido, cujo objetivo também é acelerar o processo de QA, além de formatá-los para o download e instalação por meio da plataforma fluig de forma simples e rápida (Itens da Store). O componente deve seguir os padrões demonstrados no exemplo Sample Component e seguir as etapas abaixo: 

• O arquivo final deve ser do tipo .ear. O pacote pack é o responsável por criar esse arquivo .ear.

• É essencial que o app/componente tenha o arquivo component.xml. Ele contém o component code, que é o código do seu componente dentro da fluig Store e no fluig do cliente que será instalado. Lembre-se que esse código é geral para todos os apps na fluig Store, ou seja, não pode existir mais de um app/componente com o mesmo component code.

• Recomendamos a utilização do pages.xml, onde é vocẽ deve criar uma página dedicada especialmente para o seu app/component, além de um ícone próprio personalizado.

3. Fazer o upload do código no git.fluig.com

Assim que o app/componente estiver adaptado para a fluig Store, o próximo passo é subir o código no repositório Git fluig. Nesse momento, você já deverá possuir um repositório exclusivo para o seu app/componente e um usuário e senha. Caso não tenha ainda, por favor entrar em contato através do Portal fluig Store.

Siga essas instruções na ordem ao subir o código:

1. A partir da master crie uma nova branch. (Fique à vontade para criar o nome. Recomendamos utilizar AAAA-MM-DD, por exemplo: 2018-04-10).

2. Efetue o checkout dessa nova branch e faça o commit e push do código.

3. Em seguida, abra um Pull Request dessa branch para a master e selecione alguma pessoa responsável.

4. Documentação

Juntamente com a entrega do app, solicitamos também uma documentação, contendo informações e detalhes da utilização. Os itens a seguir são fundamentais:

• Fácil acesso a documentação

• Compatível com a versão do app(exibir apenas as features que contém no app e não features que estão em Road Map)
• Layout agradável e amigável. Se possível com imagens, prints ou vídeos.

5. Envio para o QA

Após a verificação dos itens acima,(que é um processo rápido, em torno de 1 a 2 dias úteis) o app está apto a iniciar as análises do código fonte e os testes exploratórios, que é o QA propriamente dito. Assim que finalizada esta etapa, será enviado o resultado por meio de um relatório, que indicará se o app está aprovado ou não.

Caso aprovado, o app já estará pronto para submissão na fluig Store, faltando apenas pequenos detalhes. Nesta etapa, precisamos fazer o upload do app para o repositório de arquivos. Essa submissão será realizada através de um processo no Portal fluig Store, juntamente do preenchimento de um formulário, com nome, descrição, e-mail de suporte, landing page  e outras informações.

Caso não seja aprovado, o relatório irá detalhar os motivos e quais ajustes deverão ser feitos. Os itens estarão identificados da seguinte maneira:

• Alteração necessária: impede a publicação do app na fluig Store. Pode ser mau funcionamento, documentação insuficiente ou algo que interfira negativamente no uso do app.

• Alteração recomendada: itens que não impedem o uso do app mas necessitam de análise para possível adequação. Não impede a publicação na fluig Store na versão em que o item foi identificado, mas pode ser cobrado futuramente, em uma nova versão do app.

• Sugestão: são oportunidades de evolução do app, para torná-lo ainda melhor. Não impede a publicação na fluig Store.