4.2.4.2. Configuração Maven para Uso com a Linha de Comando

Os artefatos e dependências necessárias para construir e implantar aplicativos ao JBoss EAP 6 possuem host num repositório público. Caso deseje planejar o uso do Red Hat JBoss Developer Studio para construir e implantar os aplicativos, você pode ignorar este tópico. Do contrário, siga as seguintes instruções: Seção 4.2.3.1, “Configuração Maven para uso com o Red Hat JBoss Developer Studio”. No entanto, caso planeje usar a linha de comando do Maven, você deve direcionar o Maven para uso do JBoss EAP 6 Maven Repository por todos os seus projetos usando as configurações do Maven.
Existem duas maneiras de configurar as configurações para uso com a linha de comando do Maven.
  • Você pode copiar o arquivo settings.xml pré-configurado que lança as iniciações rápidas.
  • Você pode editar manualmente o arquivo settings.xml Maven.
Este tópico descreve ambos os métodos. Caso você tenha baixado as iniciações rápidas, o primeiro procedimento é a maneira mais simples de realizar as configurações.
Pré-requisitos

Você deve instalar o Maven antes de configurar as configurações. Consulte: Seção 4.2.4.1, “Download e Instalação do Maven” para maiores informações.

Procedimento 4.4. Configure o Maven usando as Configurações lançadas com as Amostras de Iniciação Rápida

As Iniciações Rápidas do Red Hat JBoss Enterprise Application Platform lançam um arquivo settings.xml que é configurado para uso online do repositório Maven do JBoss EAP. Caso tenha baixado as iniciações rápidas, esta é a maneira mais fácil de realizar as configurações.
  1. Este procedimento sobrescreve o arquivo de configurações do Maven existente, de forma que você deve realizar o backup do arquivo settings.xml Maven.
    1. Encontre o diretório de instalação para o seu sistema operacional. Ele normalmente é instalado no diretório USER_HOME/.m2/.
      • Para o Linux ou Mac, ele é: ~/.m2/
      • Para o Windows, ele é: \Documents and Settings\USER_NAME\.m2\ ou \Users\USER_NAME\.m2\
    2. Caso possua um arquivo USER_HOME/.m2/settings.xml existente, renomeie-o ou realize uma cópia de forma que você pode restaurá-lo mais tarde.
  2. Caso você não tenha baixado as iniciações rápidas, siga as seguintes instruções: Seção 3.4.1, “Realize o Download das Iniciações Rápidas”.
  3. Copie o arquivo QUICKSTART_HOME/settings.xml ao diretório USER_HOME/.m2/.
  4. Caso você modifique o arquivo settings.xml enquanto o Red Hat JBoss Developer Studio estiver sendo executado, siga o procedimento no final deste tópico nomeado Refresh the Red Hat JBoss Developer Studio User Settings.

Procedimento 4.5. Edição manual e Configurações Maven para uso online do Repositório Maven do JBoss EAP

É possível adicionar manualmente os perfis do JBoss EAP a um arquivo de configurações Maven existente.
  1. Encontre o diretório de instalação para o seu sistema operacional. Ele normalmente é instalado no diretório USER_HOME/.m2/.
    • Para o Linux ou Mac, ele é ~/.m2/
    • Para o Windows, ele é \Documents and Settings\USER_NAME\.m2\ ou \Users\USER_NAME\.m2\
  2. Caso você não encontrar um arquivo settings.xml, copie o arquivo settings.xml a partir do diretório USER_HOME/.m2/conf/ no diretório USER_HOME/.m2/.
  3. Copie o seguinte XML ao elemento <profiles> do arquivo.
    <!-- Configure the JBoss GA Maven repository -->
    <profile>
      <id>jboss-ga-repository</id>
      <repositories>
        <repository>
          <id>jboss-ga-repository</id>
          <url>http://maven.repository.redhat.com/techpreview/all</url>
          <releases>
            <enabled>true</enabled>
          </releases>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
        </repository>
      </repositories>
      <pluginRepositories>
        <pluginRepository>
          <id>jboss-ga-plugin-repository</id>
          <url>http://maven.repository.redhat.com/techpreview/all</url>
          <releases>
            <enabled>true</enabled>
          </releases>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
        </pluginRepository>
      </pluginRepositories>
    </profile>
    <!-- Configure the JBoss Early Access Maven repository -->
    <profile>
      <id>jboss-earlyaccess-repository</id>
      <repositories>
        <repository>
          <id>jboss-earlyaccess-repository</id>
          <url>http://maven.repository.redhat.com/earlyaccess/all/</url>
          <releases>
            <enabled>true</enabled>
          </releases>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
        </repository>
      </repositories>
      <pluginRepositories>
        <pluginRepository>
          <id>jboss-earlyaccess-plugin-repository</id>
          <url>http://maven.repository.redhat.com/earlyaccess/all/</url>
          <releases>
            <enabled>true</enabled>
          </releases>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
        </pluginRepository>
      </pluginRepositories>
    </profile>
    
    
    Copie o seguinte XML no elemento <activeProfiles> do arquivo settings.xml.
    <activeProfile>jboss-ga-repository</activeProfile>
    <activeProfile>jboss-earlyaccess-repository</activeProfile>
    
    
  4. Caso você modifique o arquivo settings.xml enquanto o Red Hat JBoss Developer Studio estiver sendo executado, siga o procedimento no final deste tópico nomeado Refresh the Red Hat JBoss Developer Studio User Settings.

Procedimento 4.6. Atualize as Configurações do Usuário do Red Hat JBoss Developer Studio

Caso você modificar o arquivo settings.xml enquanto o Red Hat JBoss Developer Studio estiver sendo executado, você deve atualizar as configurações do usuário.
  1. A partir do menu, selecione WindowPreferences.
  2. Na Janela Preferences, expanda o Maven e selecione User Settings.
  3. Clique no botão Update Settings para atualizar as configurações do usuário Maven no Red Hat JBoss Developer Studio.
    Atualização das Configurações do Usuário Maven

    Figura 4.11. Atualização das Configurações do Usuário Maven

Importante

Caso o seu repositório Maven possuir artefatos desatualizados, é possível encontrar um dos seguintes erros de mensagens do Maven quando construindo ou implantando o seu projeto.
  • Falta o artefato ARTIFACT_NAME
  • [ERROR] Falha ao executar a meta no projeto PROJECT_NAME; Não foi possível resolver as dependências para PROJECT_NAME
Para resolver este problema, exclua a versão com cache de seu repositório local para forçar um download dos artefatos Maven mais recentes. O repositório com cache está localizado no seu subdiretório ~/.m2/repository/ no Linux ou no subdiretório %SystemDrive%\Users\USERNAME\.m2\repository\ no Windows.