Pesquisar este blog

sábado, 6 de fevereiro de 2016

Tutorial - Maven - Configuração do Ambiente

Motivação

Hoje existem várias ferramentas de controle de dependências e build de aplicações no mercado como Gradle, Ant, Ivy dentre outros.
Um dos mais importantes nesse cenário é o Maven desenvolvido e mantido pela Apache.

Após esse tutorial você vai ser capaz de configurar seu próprio ambiente e iniciar seus próprios projetos com essa ferramenta.

O que é o Maven?



Criado e mantido pela Apache Software Foundation, Maven nasceu da necessidade de simplificar o processo de build do projeto Jakarta Turbine, acabou se tornando uma ferramenta completa para gerenciamento de dependências e build de aplicações Java em geral.

Utilizando o Maven você pode centralizar todo o controle de dependências do projeto e customizar de uma maneira simples o processo de build de sua aplicação por meio de plugins.

    Preparando o ambiente

    O Maven é uma ferramenta desenvolvida em Java, logo para que ele funcione corretamente é necessário que o Java esteja devidamente instalado e configurado na máquina.

    Aqui irei mostrar o procedimento de instalação da JDK do Java, Maven e também mostrarei a configuração das variáveis de ambiente no Windows (Sistema Operacional que utilizo) e no fim colocarei links para configuração em outras plataformas.

    Requirementos


    Ferramenta Versão
    JDK 1.7 ou superior (estou utilizando a versão 1.8.0_74)
    Maven 3.3.9

    Obs: O requisito para essa versão da Maven funcionar é a JDK a partir da versão 7. Logo não há problema de instalar uma JDK mais recente.

    * Os links para download estão listados na seção Links.

    Instalação da JDK

    1. Faça o download da JDK no site da Oracle;
    2. Instale a JDK em um diretório de sua preferencia.
    3. Configure a variável de ambiente JAVA_HOME e inclua a mesma na variável de ambiente Path conforme instruções.

    Configuração variáveis de ambiente da JDK

    Passo 1: Acesse o painel de controle e selecione Sistema.


    Passo 2: Selecione Configurações avançados do sistema.


    3.Clique no botão Variáveis de Ambiente... na aba Avançado.


    Passo: 4: Clique em Novo... .


    Passo 5: Crie a variável JAVA_HOME e coloque a pasta de instalação da JDK.


    Passo 6: Após criar a variável JAVA_HOME edite a variável Path colocando o endereço da pasta \bin da instalação da JDK do Java no fim do texto que define a variável de ambiente conforme a imagem.


    Passo 7: Na linha de comando execute o comando java -version para verificar se a instalação e configuração foram realizadas corretamente.

    O resultado deve ser o mostrado na imagem. 


    Se você obteve esse resultado pode passar para a instalação do Maven, caso contrario repita o processo e verifique as mensagens apresentadas durante a instalação.
    Em alguns casos se faz necessário reiniciar o computador.

    Instalação Maven

    1. Faça o download da última distribuição do Maven no site do projeto da Apache.
    2. Descompacte o pacote em um diretório de sua escolha.
    3. Configure as variáveis de ambiente M2_HOME, MAVEN_HOME, MAVEN_OPTS e M2 e inclua a ultima na variável de ambiente Path conforme instruções.

    Configuração variáveis de ambiente do Maven

    Para configuração das variáveis de ambiente do Maven os passos 1 até 4 da configuração de variáveis de ambiente da JDK são aplicáveis.
     
    Passo 1: Defina a variável M2_HOME apontando para a pasta de instalação do Maven em sua máquina.


    Passo 2: Defina a variável MAVEN_HOME apontando também para a pasta de instalação em sua máquina.


    Obs: Estamos criando duas variáveis apontando para o mesmo local devido algumas ferramentas e IDE's procurarem por padrão pela variável de ambiente MAVEN_HOME e outras por M2_HOME, então para evitar erros por conta dessa diferença iremos criar as duas variáveis.

    Passo 3: Defina a variável de ambiente MAVEN_OPTS.


    Obs: Por padrão o Maven assumira uma alocação máxima de heap de 512 MB iniciando com 256 MB, mas suponha que você tenha uma aplicação gigantesca que consuma mais do que 512 MB da heap no processo de build... isso irá resultar em um java.lang.OutOfMemoryError.
    Essa variável vai mudar esse valor padrão alocando no caso da instalação que eu realizei 1024 MB (1 GB), aumentando assim a alocação máxima no heap e diminuindo o risco de erro durante o processo de build.

    O segundo parâmetro -XXMaxPermSize manipula a alocação máxima do PermGen. Essa é a área de memória onde ficam guardados as representações internas das classes da JDK, aplicação e etc (metadados das classes). 
    Esse parâmetro é válido até a versão 7 do Java, pois na versão 8 o PermGen foi substituído pelo Metaspace com o intuído de sanar os problemas de OutOfMemoryError causados pelo estouro da alocação do PermGen.

    Passo 4: Defina a variável de ambiente M2 apontando para a pasta \bin da instalação do Maven.


    Passo 5: Após a criação da variável M2 edite a variável de ambiente Path incluindo o apontamento de M2 no fim das definições de caminhos que definem Path;


    Passo 6: Na linha de comando execute o comando mvn -version para verificar se a instalação e configuração foram realizadas corretamente.

    O resultado do comando deve ser semelhante ao mostrado na imagem.


    Se você obteve esse resultado seu ambiente esta preparado para a utilização do Maven, caso contrario, repita o processo e verifique as mensagens apresentadas durante a instalação.
    Em alguns casos se faz necessário reiniciar o computador.

    Obs: Repare que o parâmetro que manipula a alocação do PermGenfoi ignorado.
    Isso é devido eu ter utilizado a JDK 8 na instalação.
    Como já comentei, a partir da versão 8 do Java não temos mais PermGen e sim Metaspace.
    Para quem estiver utilizando a JDK 7 isso não irá ocorrer.

    Conclusão

    O Maven é uma ferramenta muito poderosa para gerenciar dependências e automatizar tarefas de build no seu projeto e amplamente utilizado nos mais variados sistemas desenvolvidos em Java.
    É muito importante que você conheça pelo menos o básico de seu funcionamento para conseguir desenvolver bem o seu trabalho.

    Aqui eu mostrei como obter a ferramenta e configurar seu ambiente para que você já consiga utilizar a ferramenta.

    No meu próximo post irei mostrar como criar um projetos utilizando o Maven.

    Até o próximo post!

    Um comentário:

    1. top demais !!!! Prabéns pelo post ! Eu segui os passos e funcionou perfeitamente !!!

      Valeu e Sucesso !

      ResponderExcluir