Procedimento de Release

De BIS Wiki
Ir para navegação Ir para pesquisar

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

Release da Aplicação J2EE - BISEAR

Stop 256.png
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

Stop 256.png
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.