Procedimento de Release

Para efetuar a release de uma nova distribuição do BIS siga os passos abaixo:

Release da Aplicação J2EE - BISEAR

EAR Não tratar o projeto BISEAR como os demais projetos de desenvolvimento. O procedimento do BISEAR são explicados no final e só devem ser feitos depois que os demais projetos envolvidos já estejam preparados para o release.

Preparando os projetos para o release

Esses passos devem ser realizados nos projetos que serão incluídos neste release, e empacotados no EAR.

1. Confirmar que as informações de versão dos módulos estão corretamente definidas na classe de definições (por exemplo: BISKernelPluginDefinitions e BISModulesPluginDefinitions);
2. Configurar a mesma versão nos arquivos do MAVEN (pom.xml). Colocar na propriedade ${bis.version} a versão no formato v7.2.0;
3. Atualizar o arquivo de release (projeto BISEAR), informando a versão dos módulos que serão inclusos nessa versão do EAR e fazer checkin do arquivo.
4. Fazer checkout do código que será feito o release a passar uma tag no formato "v<major>.<minor>.<revision>" (Para mais detalhes sobre o número de versão leia Definindo Número de Versão) garantindo que o diretório onde a tag será criada está no formato "<repositório>/tags/vX.Y.Z" (formato do SVN);
5. Fazer o checkout pela tag gerada para que não ocorra o empacotamento de classes diferentes das marcadas na versão.

Compilar e "Instalar" os Pacotes no Repositório Maven

Ao utilizar o projeto BISDistro você pode executar os comandos para todos os projetos de uma única vez. Também é possível executar o comando apenas em um projeto, no entanto é necessário que os pacotes dos projetos dependentes já estejam instalados no repositório local do Maven.

Para executar o Maven siga os passos:

1. Clique com o botão direito sobre o projeto desejado;
2. Clicar em 'Run As...' no projeto, e escolher 'Maven build...', em goals informe os comandos que deseja:

   clean - Força a limpeza das classes compiladas, e consequentemente o projeto todo é recompilado;

   package - Força gerar o pacote da aplicação. Que é colocado na pasta 'target' dentro de cada projeto;

   install - Força a geração dos pacotes e "instala" o pacote da versão criada no repositório local do Maven.

Release do EAR

O EAR é criado durante a phase de package do maven. Mas para a distribuição em produção, as seguintes alterações devem ser realiadas:

1. alterar o arquivo persistence.xml dentro do pacote lib/bispersistence.jar para que os SQL não sejam impressos. Mais instruções no arquivo;
2. alterar o arquivo web.xml do war e definir o Vaadin como modo de produção = true.

Release do BISPDV

Gerado automaticamente pela phase de package do maven. Não é criado como um jar executável exatamente por faltar uma referência correta para as bibliotecas dentro do MANIFEST.

• O jar do BISPDV é criado dentro da pasta target;
• Todos os JARs necessários para a execução do BISPDV são copiados para a pasta 'target/lib-jars'.