Um guia rápido para o Maven Wrapper

Um guia rápido para o Maven Wrapper

1. Visão geral

OMaven Wrapper é uma excelente escolha para projetos que precisam de uma versão específica do Maven (ou para usuários que não desejam instalar o Maven). Instead of installing many versions of it in the operating system, we can just use the project-specific wrapper script.

Neste artigo rápido, mostraremos como configurar um Wrapper Maven para um projeto Maven existente.

2. Configurando o Wrapper Maven

Existem duas maneiras de configurá-lo em um projeto, onde a mais simples é usar um plugin apropriado para automatizá-lo ou aplicando a instalação manual.

2.1. Plugar

Vamos usar esteMaven Wrapper plugin para fazer a instalação automática em um projeto simples do Spring Boot.

Primeiro, precisamos ir na pasta principal do projeto e executar este comando:

mvn -N io.takari:maven:wrapper

Também podemos especificar a versão do Maven:

mvn -N io.takari:maven:wrapper -Dmaven=3.5.2

A opção-N significa–non-recursive para que o wrapper seja aplicado apenas ao projeto principal do diretório atual, não em nenhum submódulo.

Depois de executar a meta, teremos mais arquivos e diretórios no projeto:

  • mvnw: é um script de shell executável do Unix usado no lugar de um Maven totalmente instalado

  • mvnw.cmd: é a versão em lote do script acima

  • mvn: a pasta oculta que contém a biblioteca Maven Wrapper Java e seu arquivo de propriedades

2.2. Manual

Com uma abordagem manual, podemos copiar arquivos e pastas vistos acima de outro projeto para a pasta principal do projeto atual.

Depois disso, precisamos especificar a versão do Maven a ser usada no arquivo de propriedades do wrapper localizado no arquivo.mvn/wrapper/maven-wrapper.properties.

Por exemplo, nosso arquivo de propriedades tem a seguinte linha:

distributionUrl=https://repo1.maven.org/maven2/org/apache/maven/apache-maven/3.5.2/apache-maven-3.5.2-bin.zip

Conseqüentemente, a versão 3.5.2 será baixada e usada.

3. Casos de Uso

O wrapper deve funcionar com diferentes sistemas operacionais, como:

  • Linux

  • OSX

  • janelas

  • Solaris

Depois disso, podemos executar nossos objetivos assim para o sistema Unix:

./mvnw clean install

E o seguinte comando para o lote:

./mvnw.cmd clean install

Se não tivermos o Maven especificado nas propriedades do wrapper, ele será baixado e instalado na pasta$USER_HOME/.m2/wrapper/dists do sistema.

Vamos executar nosso projeto Spring-Boot:

./mvnw spring-boot:run

A saída é a mesma que para um Maven totalmente instalado:

image

Nota: usamos o executávelmvnw no lugar demvn,, que agora é o programa de linha de comando Maven.

4. Conclusão

Neste tutorial, vimos como configurar e usar o Maven Wrapper em um projeto Maven.

Como sempre, o código-fonte deste artigo pode ser encontradoover on GitHub.