Apache Maven Framework
Guia de Referência Rápida para Comandos Maven
Last updated
Guia de Referência Rápida para Comandos Maven
Last updated
O Maven é uma ferramenta de gerenciamento, construção e implantação de projetos, que tem como função ajudar no processo de gerenciamento de dependências e no de build do projeto, geração de relatórios e de documentação.
Download do Framework
O framework está disponível na página oficial da ferramenta: http://maven.apache.org/.
Variáveis de Ambiente do Maven
Variáveis de Usuários
JAVA_HOME = C:\Program Files\Java\jdk1.7.0_45
CLASS_PATH= C:\Program Files\Java\jdk1.7.0_45\bin\lib
M2_HOME = C:\Program Files\apache-maven-3.1.1
M2_REPO = C:\Users\ppontes\.m2\repository
MAVEN_OPTS = -Xmx1024m -Xmx512m -XX:MaxPermSize=128m -Djava.awt.headless=true
Variáveis de Sistema
Path – C:\Program Files\apache-maven-3.1.1\bin
Descrição das Variáveis de Ambiente
M2_HOME
Home de instalação do Maven
M2_REPO
Repositório das Bibliotecas
MAVEN_OPTS
Configurações de Memória do
Path
Variáveis de Ambiente do Sistema Operacional
JAVA_HOME
Home de instalação da JDK
CLASS_PATH
Classpath com as libs da JDK
Comandos Básicos do MAVEN
Visando facilitar você que está começando a usar o Maven segue uma lista com algumas dicas muito úteis que irão ajudar o início desta longa e grande viagem sem volta!
1) A melhor forma de iniciar um projeto Maven é através de templates já prontos para uso.
2) Existe uma lista de comandos básicos no Maven. Faça alguns testes e entenda na prática como funciona cada um deles. Veja o que acontece na pasta target do seu projeto. Seguem os comandos:
mvn compile
mvn jar:jar
mvn test
mvn package
mvn install
mvn eclipse:eclipse
mvn package
mvn clean
3) Pular os testes( isto é muito importante mas… quem sabe você não precise testar no momento, não é?)
4) Crie profiles de execução:
O exemplo abaixo explica como usar 2 tipos diferentes de profiles: tomcat e jboss:
Caso seja necessário é possível executar dois profiles de uma só vez:
Agora, um exemplo para criação de um projeto web com o conteúdo aberto (war:exploded):
Acesse o link para mais informações sobre profiles: http://maven.apache.org/guides/introduction/introduction-to-profiles.html
5) Instale qualquer arquivo no repositório local Imagine que você precise criar um arquivo jar e este será compartilhado entre seus vários projetos. Você pode instalar qualquer jar que quiser, mesmo não sendo do projeto maven (como no exemplo abaixo):
O Maven possui uma vasta lista de comandos para facilitar a sua vida e a minha também imaginei: por que não criar uma página de referência com os principais comandos existentes? Assim podemos acessá-la sempre que for necessário para lembrar de alguns comandos até que todos estejam “decorados”. Espero que seja útil e que estejam todos funcionando em seus computadores.
Para compilar
mvn compile
Para compilar off-line
mvn –o compile
Para criar os pacotes
mvn package
Instalar o pacote nos respectivos repositórios
mvn install
Limpar a pasta target
mvn clean
Gerar um projeto eclipse(normalmente prefiro recriar)
mvn eclipse:clean eclipse:eclipse
Gerar um projeto eclipse baixando os códigos-fonte das dependências
mvn eclipse:clean eclipse:eclipse –DdownloadSources=true
Gerar um projeto eclipse baixando os códigos-fonte assim como o javadoc das dependências
mvn eclipse:clean eclipse:eclipse –DdownloadSources=true –DdownloadJavadocs=true
Executar os testes unitários
mvn test
Executar os testes unitários apenas informando no console os resultados dos testes
mvn -Dsurefire.useFile=false test
Executar um teste específico
mvn test –Dtest=br.com.maven3.tutorial.tests.suaClasseDeTestes
Ignorar os testes ao gerar um pacote
mvn package -Dmaven.test.skip=true
Ignorar os testes ao instalar um pacote
mvn install -Dmaven.test.skip=true
Gerar um projeto web baseado em um template(Leia mais sobre templates em Dicas para usar templates de projetos pré-configurados no Maven – Maven Archetypes)
mvn archetype:create -DgroupId=br.com.projeto.exemplo -DartifactId=projeto-web -DarchetypeArtifactId=maven-archetype-webapp
Gerar site de documentação para o projeto
mvn site
Gerar Javadoc
mvn javadoc:javadoc
Para ver qual é o pom.xml que o Maven entende(veja o link Qual é a estrutura padrão de diretórios e arquivos no Maven?)
mvn help:effective-pom
Como executar um profile
mvn –P profile1
Como executar 2 profiles
mvn –P profile1 –P profile2
Como ignorar um profile e executar outro profile
mvn –P !profile1 –P profile2
Como recriar um projeto web aberto na pasta target
mvn clean package war:exploded
Como executar o Sonar(Aprenda mais sobre o Sonar em Aprenda como melhorar a qualidade do código usando o Sonar)
mvn sonar:sonar
Exibir todas as dependências e dependências transitivas, ajudando a identificar conflitos;
mvn dependency:tree
Exibir todas as dependências transitivas para um pacote, ajudando a identificar conflitos;
mvn -X <nome_pacote>
Fazer download dos códigos fontes independentes de IDE
mvn dependency:sources
