TP1.2 — Instalação do Maven 3.9.x

Objetivos

Este exercício prático permitirá que você:

• Instale o Apache Maven 3.9.x no seu sistema operacional
• Configure as variáveis de ambiente necessárias
• Verifique se a instalação está funcionando corretamente
• Entenda o papel do Maven em um projeto Spring Boot

Duração estimada: 30-45 minutos

---

Por que Maven?

O Apache Maven é a ferramenta de build padrão para projetos Java e Spring Boot. Ele gerencia:

• Dependências: download automático das bibliotecas necessárias
• Build: compilação, testes, empacotamento da aplicação
• Ciclo de vida: clean → compile → test → package → install → deploy

Seu código Java  ──►  Maven  ──►  Aplicação pronta (.jar)
                        │
                        ├── Baixa as dependências
                        ├── Compila o código
                        ├── Executa os testes
                        └── Cria o arquivo .jar

Versão recomendada

Utilizamos Maven 3.9.x por sua compatibilidade ideal com Java 17+ e Spring Boot 3.x.

---

Pré-requisitos

Antes de instalar o Maven, você deve ter o Java JDK 17 ou superior instalado.

Verificar Java

java -version

Resultado esperado (exemplo):

openjdk version "17.0.x" 2024-xx-xx
OpenJDK Runtime Environment ...
OpenJDK 64-Bit Server VM ...

Se o Java não estiver instalado, consulte nosso guia detalhado:

👉 TP: Instalação do Java JDK 17

Ou faça o download diretamente em:

• Eclipse Adoptium (Temurin) (recomendado)
• Oracle JDK

---

Instalação no Windows

Etapa 1: Baixar o Maven

1. Acesse https://maven.apache.org/download.cgi
2. Baixe o arquivo Binary zip archive: apache-maven-3.9.9-bin.zip

Link direto

apache-maven-3.9.9-bin.zip

Se a versão 3.9.9 não estiver mais disponível, pegue a última versão 3.9.x na página de download.

Etapa 2: Extrair o arquivo

1. Crie uma pasta C:\Program Files\Maven (ou C:\maven)
2. Extraia o conteúdo do ZIP nesta pasta
3. Você deverá ter: C:\Program Files\Maven\apache-maven-3.9.9

C:\Program Files\Maven\
└── apache-maven-3.9.9\
    ├── bin\
    │   ├── mvn.cmd        ← O executável do Maven
    │   └── mvnDebug.cmd
    ├── boot\
    ├── conf\
    │   └── settings.xml
    └── lib\

Etapa 3: Configurar a variável MAVEN_HOME

1. Abra o menu Iniciar → digite "variáveis de ambiente"
2. Clique em "Editar variáveis de ambiente do sistema"
3. Clique em "Variáveis de ambiente..."
4. Em Variáveis do sistema, clique em Novo:
   • Nome da variável: MAVEN_HOME
   • Valor da variável: C:\Program Files\Maven\apache-maven-3.9.9
5. Clique em OK

Etapa 4: Adicionar Maven ao PATH

1. Em Variáveis do sistema, encontre a variável Path
2. Clique em Editar
3. Clique em Novo
4. Adicione: %MAVEN_HOME%\bin
5. Clique em OK para fechar todas as janelas

Etapa 5: Verificar a instalação

Feche todos os terminais abertos e abra um novo terminal (CMD ou PowerShell):

mvn -version

Resultado esperado:

Apache Maven 3.9.9 (8e8579a9e76f7d015ee5ec7bfcdc97d260186937)
Maven home: C:\Program Files\Maven\apache-maven-3.9.9
Java version: 17.0.x, vendor: Eclipse Adoptium
Default locale: fr_CA, platform encoding: UTF-8
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"

Importante

Se mvn não for reconhecido após configurar o PATH, reinicie seu terminal ou até mesmo seu computador. As variáveis de ambiente não são recarregadas em terminais já abertos.

Alternativa Windows: Instalação com Chocolatey

Se você tem o Chocolatey instalado, a instalação é mais simples:

choco install maven --version=3.9.9

Alternativa Windows: Instalação com Scoop

Se você tem o Scoop instalado:

scoop install maven

---

Instalação no macOS

Opção 1: Homebrew (Recomendado)

O Homebrew é o gerenciador de pacotes mais popular no macOS.

Instale o Homebrew (se ainda não tiver):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Instale o Maven:

brew install maven

Verifique:

mvn -version

dica

O Homebrew instala automaticamente a última versão estável do Maven 3.9.x e configura o PATH para você.

Opção 2: Instalação manual

Etapa 1: Baixar o Maven

cd ~/Downloads
curl -O https://dlcdn.apache.org/maven/maven-3/3.9.9/binaries/apache-maven-3.9.9-bin.tar.gz

Etapa 2: Extrair o arquivo

sudo mkdir -p /opt/maven
sudo tar -xzf apache-maven-3.9.9-bin.tar.gz -C /opt/maven

Etapa 3: Configurar as variáveis de ambiente

Abra seu arquivo de perfil do shell:

Para zsh (padrão do macOS desde o Catalina):

nano ~/.zshrc

Para bash:

nano ~/.bash_profile

Adicione as seguintes linhas ao final do arquivo:

# Apache Maven
export MAVEN_HOME=/opt/maven/apache-maven-3.9.9
export PATH=$MAVEN_HOME/bin:$PATH

Salve (Ctrl+O, Enter, Ctrl+X) e recarregue o perfil:

source ~/.zshrc

Etapa 4: Verificar

mvn -version

Resultado esperado:

Apache Maven 3.9.9 (8e8579a9e76f7d015ee5ec7bfcdc97d260186937)
Maven home: /opt/maven/apache-maven-3.9.9
Java version: 17.0.x, vendor: Eclipse Adoptium
...
OS name: "mac os x", ...

Opção 3: SDKMAN!

O SDKMAN! é uma ferramenta que gerencia versões de Java, Maven, Gradle, etc.

# Instalar SDKMAN!
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

# Instalar Maven
sdk install maven 3.9.9

---

Instalação no Linux

Opção 1: Gerenciador de pacotes (Ubuntu/Debian)

sudo apt update
sudo apt install maven

Atenção à versão

Os repositórios oficiais do Ubuntu/Debian podem conter uma versão antiga do Maven. Verifique a versão instalada:

mvn -version

Se a versão for inferior a 3.9, prefira a instalação manual abaixo.

Opção 2: Instalação manual (Recomendado)

Etapa 1: Baixar o Maven

cd /tmp
wget https://dlcdn.apache.org/maven/maven-3/3.9.9/binaries/apache-maven-3.9.9-bin.tar.gz

Etapa 2: Extrair e instalar

sudo mkdir -p /opt/maven
sudo tar -xzf apache-maven-3.9.9-bin.tar.gz -C /opt/maven

Etapa 3: Configurar as variáveis de ambiente

Crie um arquivo de configuração do Maven:

sudo nano /etc/profile.d/maven.sh

Adicione o seguinte conteúdo:

#!/bin/bash
export MAVEN_HOME=/opt/maven/apache-maven-3.9.9
export PATH=$MAVEN_HOME/bin:$PATH

Torne o arquivo executável e carregue-o:

sudo chmod +x /etc/profile.d/maven.sh
source /etc/profile.d/maven.sh

Etapa 4: Verificar

mvn -version

Resultado esperado:

Apache Maven 3.9.9 (8e8579a9e76f7d015ee5ec7bfcdc97d260186937)
Maven home: /opt/maven/apache-maven-3.9.9
Java version: 17.0.x, vendor: Eclipse Adoptium
...
OS name: "linux", ...

Opção 3: SDKMAN! (também funciona no Linux)

curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

sdk install maven 3.9.9

Opção 4: Fedora / CentOS / RHEL

sudo dnf install maven

---

Verificação final (todos os SOs)

Após a instalação, abra um novo terminal e execute estes comandos:

# Verificar Java
java -version

# Verificar Maven
mvn -version

# Verificar se JAVA_HOME está definido
echo $JAVA_HOME       # macOS/Linux
echo %JAVA_HOME%      # Windows CMD
$env:JAVA_HOME        # Windows PowerShell

Resultado esperado

Você deve ver:

• Java: versão 17 ou superior
• Maven: versão 3.9.x
• JAVA_HOME: aponta para sua instalação do JDK

Se JAVA_HOME não estiver definido

O Maven precisa da variável JAVA_HOME. Se ela não estiver definida:

Windows: Adicione JAVA_HOME nas variáveis de ambiente do sistema, apontando para sua pasta do JDK (ex: C:\Program Files\Eclipse Adoptium\jdk-17.0.x)

macOS/Linux: Adicione no seu ~/.zshrc ou ~/.bashrc:

export JAVA_HOME=$(/usr/libexec/java_home -v 17)   # macOS
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64 # Linux (o caminho pode variar)

---

Teste do Maven: Primeiro build

Para confirmar que o Maven está funcionando, vamos criar um projeto de teste:

mvn archetype:generate \
  -DgroupId=com.test \
  -DartifactId=test-maven \
  -DarchetypeArtifactId=maven-archetype-quickstart \
  -DarchetypeVersion=1.4 \
  -DinteractiveMode=false

Se o Maven baixar as dependências e exibir BUILD SUCCESS, sua instalação está completa.

cd test-maven
mvn clean package

[INFO] BUILD SUCCESS
[INFO] Total time:  X.XXX s

Você pode remover esta pasta de teste:

cd ..
rm -rf test-maven       # macOS/Linux
rmdir /s /q test-maven   # Windows CMD

---

Resumo dos comandos por SO

Ação	Windows	macOS (Homebrew)	Linux (Manual)
Instalar	Baixar ZIP + configurar PATH	brew install maven	wget + extrair + PATH
Configurar PATH	Variáveis de ambiente do sistema	Automático	/etc/profile.d/maven.sh
Verificar	mvn -version	mvn -version	mvn -version
Atualizar	Baixar novamente	brew upgrade maven	Baixar novamente

---

Resolução de problemas

mvn não é reconhecido

Causa	Solução
PATH não configurado	Adicionar MAVEN_HOME/bin ao PATH
Terminal não recarregado	Fechar e reabrir o terminal
Caminho incorreto	Verificar se a pasta bin do Maven existe no caminho configurado

JAVA_HOME is not defined correctly

Causa	Solução
JAVA_HOME não definido	Definir a variável de ambiente JAVA_HOME
JAVA_HOME aponta para JRE	Apontar para o JDK (não o JRE)
Espaço no caminho	Usar aspas: "C:\Program Files\Java\jdk-17"

Maven baixa dependências lentamente

O primeiro build do Maven baixa muitas dependências na pasta ~/.m2/repository. Isso é normal e ocorre apenas uma vez.

---

Checklist de validação

Antes de passar para o Módulo 2, certifique-se de que tudo está pronto:

• Java 17+ instalado e java -version funcionando
• Maven 3.9.x instalado e mvn -version funcionando
• JAVA_HOME está definido corretamente
• O teste mvn archetype:generate funcionou
• Visual Studio Code instalado com as extensões Java

---

Próximos Passos

Seu ambiente está pronto! Agora você pode avançar para o Módulo 2:

➡️ Módulo 2: Primeiros Passos com Spring Boot

---

⬅️ Voltar ao Módulo 1