O arquivo settings.xml possui elementos que são usados na configuração e execução do Maven, como no pom.xml, porém este não devem ser empacotados em qualquer projeto ou distribuídos para um público. Esse arquivo incluem inclui valores que direcionam para repositórios locais, servidores de repositórios remotos alternativos e informações de autenticação.

Pré-requisitos

Antes de começar a seguir os passos do tutorial é preciso ter certeza de que se tem um ambiente minimamente preparado para reproduzir o exemplo. Abaixo estão os requisitos principais.

Requisitos:

1. Projeto do tipo mobile criado. Caso haja dúvidas de como criar esse tipo de projeto acesse o link ( Criar projeto );
2. Ter conhecimento sobre o Maven. Para mais informações, acesse o link (Maven).
3. Ter conhecimento sobre as configurações do settings.xml, veja a documentação de referência em (Settings Reference e Settings).
4. Habilitar o botão Modo Avançado.

Visão geral

Nesse tutorial iremos aprender a criar o arquivo settings.xml do Maven, permitindo , o download de bibliotecas privadas com acesso restrito.

Image RemovedImage Added

Figura 1 - Obtendo dependências Maven com repositórios Processar Alvos com repositórios privados e acesso restrito

Aviso
title Aviso
Ao Processar os Alvos antes de configurar as dependências, será exibido uma mensagem de erro.

Resumo do settings.xml

A estrutura XML do settings está organizada de forma a facilitar a configurações no Maven, abaixo segue um resumo simples da sua estrutura.

• "Elementos da raiz": tags de configuração do usuário e sistema;
• proxies: referente a configurações da requisição do proxy;
• servers: contém informações necessárias para as configurações do servidor;
• mirrors: espelho para download de determinadas dependências alternativas;
• profile: modifica alguns parâmetros do ambiente no processo de build;
  • activation: chaves de ativação de um perfil;
    • so: ativa os atributos de um sistema operacional;
    • property: usada para ativar um perfil;
    • file: especificação de arquivo usado para ativar um perfil;
  • repositories: estabelece conexões com o repositório remoto;
    • releases: politicas políticas de download;
    • snapshots: politicas políticas de download;
  • pluginRepositories: contém as informações necessárias para estabelecer conexões com o repositório remoto.

Passos

Criando o arquivo settings.xml

Por padrão, o arquivo settings.xml não é gerado junto ao criarmos um projeto no CronAppCronapp. Nesse caso, o programador usuário deverá criar o arquivo no diretório raiz do seu projeto.

Para criar o arquivo na raiz do projetoApós habilitar o botão Modo Avançado (destaque 1 da figura 2), clique com o botão direito do mouse no nome do projeto , na árvore de arquivos, selecione Novo → Outros e insira Novo, depois escolha Outro, insira o nome do arquivo "settings.xml" , como na na janela que abrir e clique em OK. (Figura 2.)

Image RemovedImage Added

Figura 2 - Criando o arquivo settings.xml na raiz do projeto.

Biblioteca com acesso privado

Chamada no pom.xml

No Maven, o arquivo pom.xml (ou Definições Maven) é onde são colocamos todos possui as bibliotecas que são baixadas no nosso projeto pelo Maven, no caso de bibliotecas privadas com acesso restrito, isso também deve acontecer, porém os dados de autenticação ficarão no arquivo settings.xml.

Abra o arquivo pomarquivo pom.xml (ou Definições Maven) e adicione os dados do repositório privado dentro da tag <repositories> (Figura 3). No exemplo da figura 3 abaixo, estamos chamando os dados de uma dependência privada fictícia.

Image RemovedImage Added

Figura 3 - Adicionando os dados do repositório Exemplo de repositório privado no pom.xml.

Configurando o settings.xml

De volta ao arquivo settings.xml, abra o arquivo que está na raiz da árvore de arquivos (Figura 4) , caso não esteja aberto, para começar a editá-lo. Siga o passo abaixo.

Image Added

Image RemovedFigura 4 - Localização do Editando o arquivo criadosettings.xml

vamos Vamos adicionar o código abaixo, com as informações mínimas necessárias para permitir o acesso a uma dependência privada com acesso restrito. Nela estamos inserindo informações como nome do diretório, localização, nome do usuário, senha e algumas outras informações.

<?xml

 version="1.0"

 encoding="UTF-8"?>

<settings
	xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0

 http://maven.apache.org/xsd/settings-1.1.0.xsd"

    xmlns="http://maven.apache.org/SETTINGS/1.1.0"

    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

	<servers>
		<server>		
			<id>libs-release</id>
			<username>NomeDoUsuario</username>
			<password>Senha</password>
		</server>
	</servers>
	<profiles>
		<profile>
			<id>artefatos</id>
			<repositories>
				<repository>
					<id>libs-release</id>
					<name>libs-release</name>
					<releases>
						<enable>true</enable>
					</releases>
					<url>https://artefatos.cronapp.com.br/libs-

release</url>
				</repository>
			</repositories>
		</profile>
	</profiles>
	<activeProfiles>
		<activeProfile>artefatos</activeProfile>
	</activeProfiles>
</settings>

Baixando as dependências

Para baixar as dependências, salve todos os arquivos editados, clique com o botão direito do mouse no arquivo pom.xml (ou Definições Maven) e selecione Maven → Obter dependências do maven. Maven >  Processar Alvos (Figura 5). Aparecerá a janela de Confirmação com o campo Insira o valor preenchido por padrão com "dependency:resolve -U", isso significa que esse valor força a atualização das dependências.

Image AddedImage Removed

Figura 5 - Obtendo dependências do maven.Processando alvos

Após baixar as dependências, a mensagem "Dependências do Maven obtidas com sucesso.informação "BUILD SUCCESS" deve aparecer no consolena aba de informações Saída, confirmando o êxito na ação , como mostrado na (Figura 6).

Image Added

Image RemovedFigura 6 - Dependências obtidas com sucesso.Mensagem de sucesso