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. Configurar a versão nos arquivos do MAVEN (pom.xml). Colocar na propriedade ${bis.version} a versão no formato v<M>.<m>.<r>;
2. Configurar a versão na classe de definições (por exemplo: BISKernelPluginDefinitions e BISModulesPluginDefinitions);
3. Fazer checkout do código que será feito o release a passar uma tag no formato "v<M>.<m>.<r>" (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);
4. 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'.

Release do APK para Android

Dependência do BISTerminalThinClient O projeto do Android depende do BISTerminalThinClient. Antes de exportar e gerar esse projeto é necessário substituir o .jar dentro da pasta etc\lib. Se a biblioteca não tiver a mesma versão da biblioteca igual ao que estiver rodando no EAR do servidor, a transmissão dos objetos serializados podem acabar gerando exceptions por incompatibilidade de versão.

• Abra o projeto do Android Studio
• vá em Build->Generate Signed APK
• Escolha o Key Store disponível dentro do Projeto na pasta etc\keystore\bisterminal.keystore. Para garantir que o aplicativo será atualizado e não perderá seus dados de configuração.
• Informa senha do keystore: BISERP
• Escolha o Alias bis android terminal navegando pelo botão "..." ao lado.
• Informa a senha do Alias BISERP e clique Next.
• Defina a pasta para exportar o novo APK
• Marque a opção V1 (JAR Signature) e clique em Finish.