Como adicionar um JAR local ao Maven da forma correta

Tem um JAR e precisa adiciona-lo a um projeto Maven? Veja como adicionar um JAR local ao Maven da forma correta e intercambiável. É bem simples.

[ad#texto]

O Maven é um ótimo gerenciador de dependências, auxilia uma série de complicações que temos ao gerenciar de forma manual estas dependências, mas como adicionar um JAR local ao Maven?

A princípio existem duas formas, uma é bem direta e não é recomendada, pois não permite que o seu projeto seja portável e a outra é a recomendação.

Vamos explicar as duas formas, daí você decide o que fazer.

Como adicionar um JAR local ao Maven: a maneira incorreta, mas funcional

Você tem um projeto Maven qualquer e precisa adicionar um JAR que não está nos repositórios remotos do Maven e precisa adiciona-lo ao seu projeto.

Você pode apontar esta JAR direto do seu disco pelo arquivo pom.xml:

  com.groupid.dependencia
  suadependencia
  1.0.0
  system
  /user/usuario/projeto/suaDependencia.jar

Embora funcione (e seja rápido de fazer) não é recomendado, pois o seu projeto fica com um path do JAR fixado em código e qualquer alteração vai quebra-lo.

Isso pode ser um complicador para projetos em equipe.

Como adicionar um JAR local ao Maven: a maneira correta

Se o indicado acima não é a melhor forma como é a forma recomendada?

Devemos adicionar o nosso JAR ao nosso repositório local do Maven.

Para fazer isso basta usar o seguinte comando:

mvn install:install-file -Dfile=/user/usuario/projeto/suaDependencia.jar -DgroupId=org.meujar -DartifactId=meujar -Dversion=1.0.0 -Dpackaging=jar -DgeneratePom=true

Feito isso já temos o JAR disponível no nosso repositório local.

Basta agora adiciona-lo ao nosso pom.xml da seguinte forma:

  org.meujar
  meujar
  1.0.0

Pronto, seu JAR está no seu projeto e o seu projeto é intercambiável entre a equipe.

A partir deste ponto seu JAR é mantido pelo seu repositório, fica fácil até mesmo atualiza-lo caso for necessário.