Como Instalar o JAR do Inter SDK Java Localmente e Configurar no Maven

Para usar o inter-sdk-java em um projeto Maven, você pode instalar o JAR localmente utilizando o comando install:install-file. Este artigo vai detalhar o processo de instalação do JAR no repositório local e como adicionar a dependência ao arquivo pom.xml.

1. Pré-requisitos

Antes de começar, certifique-se de que:

  • O arquivo JAR inter-sdk-java-1.0.2.jar está disponível localmente.
  • Você possui o Maven instalado em sua máquina e configurado corretamente no PATH.

2. Comando para Instalar o JAR no Repositório Local

Para instalar o JAR no repositório Maven local, use o comando abaixo:

mvn install:install-file -Dfile=inter-sdk-java-1.0.2.jar -DgroupId=br.com.inter -DartifactId=inter-sdk-java -Dversion=1.0.2 -Dpackaging=jar

Explicação dos Parâmetros

  • -Dfile=inter-sdk-java-1.0.2.jar: Especifica o caminho do arquivo JAR que você deseja instalar.
  • -DgroupId=br.com.inter: Define o identificador de grupo (Group ID) para o projeto, que no caso é br.com.inter.
  • -DartifactId=inter-sdk-java: Define o identificador do artefato (Artifact ID) para o JAR.
  • -Dversion=1.0.2: Define a versão do JAR.
  • -Dpackaging=jar: Define o tipo de pacote do artefato, neste caso, jar.

Esse comando copia o JAR para o repositório local do Maven (normalmente localizado em ~/.m2/repository no Linux e macOS ou C:\Users\<usuario>\.m2\repository no Windows).

3. Adicionando a Dependência ao pom.xml

Após instalar o JAR, você pode referenciá-lo no pom.xml do seu projeto Maven. Adicione o seguinte bloco dentro da seção <dependencies>:

<dependency>
    <groupId>br.com.inter</groupId>
    <artifactId>inter-sdk-java</artifactId>
    <version>1.0.2</version>
</dependency>

Estrutura Completa do pom.xml

Aqui está um exemplo de como seu pom.xml pode ficar com essa dependência configurada:

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.seuprojeto</groupId>
    <artifactId>seu-projeto</artifactId>
    <version>1.0-SNAPSHOT</version>

    <dependencies>
        <!-- Dependência para o inter-sdk-java -->
        <dependency>
            <groupId>br.com.inter</groupId>
            <artifactId>inter-sdk-java</artifactId>
            <version>1.0.2</version>
        </dependency>
    </dependencies>

</project>

4. Verificando a Instalação

Para verificar se a dependência foi instalada corretamente, execute o seguinte comando Maven para compilar o projeto:

mvn clean install

Se tudo estiver correto, o Maven deverá localizar o inter-sdk-java no repositório local e compilar o projeto sem erros.

5. Solução de Problemas

Caso o Maven não encontre a dependência, verifique:

  • Se o arquivo JAR está realmente instalado no repositório local (~/.m2/repository/br/com/inter/inter-sdk-java/1.0.2/).
  • Se o caminho especificado em -Dfile está correto.
  • Se os campos groupId, artifactId, e version no pom.xml correspondem aos valores usados no comando de instalação.

Conclusão

Agora você configurou corretamente o inter-sdk-java no seu projeto Maven! Com o JAR instalado no repositório local, ele será acessível sempre que o Maven precisar reconstruir o projeto. Esse método é útil para projetos internos ou pacotes que não estão disponíveis em repositórios públicos.