Usar pacotes do Repositório do Google Maven

  • Artigo

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Com os Artefatos do Azure, os desenvolvedores podem habilitar fontes upstream para consumir pacotes de diferentes registros públicos, como o Repositório do Google Maven. Depois de habilitado, o Azure Artifacts salvará automaticamente uma cópia de qualquer pacote instalado a partir do upstream. Além disso, o Azure Artifacts oferece suporte a outras fontes upstream do Maven, como Maven Central, Gradle Plugins e JitPack. Neste artigo, você aprenderá a:

  • Adicionar o Google Maven Repository como uma fonte upstream
  • Consumir um pacote do upstream
  • Localizar pacotes salvos em seu feed

Pré-requisitos

  • Uma organização do Azure DevOps e um projeto. Crie uma organização ou um projeto , caso ainda não tenha feito isso.

  • Um feed do Azure Artifacts.

Habilitar fontes upstream

Se você ainda não tiver um feed, siga as instruções abaixo para criar um novo feed e marque a caixa de seleção Fontes upstream para habilitá-las. Se você já tiver um feed, vá para a próxima etapa para adicionar o Google Maven Repository como uma fonte upstream:

  1. Entre na sua organização do Azure DevOps e navegue até seu projeto.

  2. Selecione Artefatos e, em seguida, selecione Criar feed para criar um novo feed.

  3. Insira um Nome descritivo para seu feed e defina sua Visibilidade (indicando quem pode exibir pacotes dentro do feed). Especifique o Escopo do seu feed e, se desejar incluir pacotes de fontes públicas, marque a caixa de seleção Códigos-fonte upstream.

  4. Selecione Criar quando terminar.

    Uma captura de tela mostrando como criar um novo feed nos Serviços de DevOps do Azure.

  1. Entre no servidor de DevOps do Azure e navegue até o projeto.

  2. Selecione Artefatos e, em seguida, selecione Criar feed para criar um novo feed.

  3. Insira um Nome descritivo para seu feed e defina sua Visibilidade (indicando quem pode exibir pacotes dentro do feed). Especifique o Escopo do seu feed e, se desejar incluir pacotes de fontes públicas, marque a caixa de seleção Códigos-fonte upstream.

  1. Selecione Criar quando terminar.

    Uma captura de tela mostrando como criar um novo feed no Azure DevOps 2022.

  1. Selecione Criar quando terminar.

    Uma captura de tela mostrando como criar um novo feed no Azure DevOps 2020.

  1. Entre no servidor de DevOps do Azure e navegue até o projeto.

  2. Selecione Artefatos e, em seguida, selecione Novo feed.

  3. Insira um Nome descritivo para seu feed e defina sua Visibilidade (indicando quem pode exibir pacotes dentro do feed). Se você deseja incluir pacotes de fontes públicas, selecione a opção Usar pacotes de fontes públicas por meio deste feed .

  4. Selecione Criar quando terminar.

    Uma captura de tela mostrando como criar um novo feed no Azure DevOps 2019.

Observação

Por padrão, os feeds recém-criados têm o Serviço de Compilação do projeto definido como Feed e Leitor Upstream (Colaborador).

Adicionar repositório do Google Maven upstream

Se você marcou a caixa de seleção Fontes upstream ao criar seu feed, o Repositório do Google Maven já deve ser adicionado como uma fonte upstream. Caso contrário, você pode adicioná-lo manualmente usando as seguintes etapas:

  1. Entre na sua organização do Azure DevOps e navegue até seu projeto.

  2. Selecione Artefatos e, em seguida, selecione o ícone ícone de engrenagem ícone de engrenagem de engrenagem no canto superior direito para navegar até as Configurações de Feed.

  3. Selecione Fontes upstream e, em seguida, selecione Adicionar upstream.

  4. Selecione Fonte pública e, em seguida, selecione Repositório do Google Maven (https://maven.google.com/web/index.html) no menu suspenso.

  5. Selecione Salvar quando terminar e, em seguida, selecione Salvar novamente no canto superior direito para salvar suas alterações.

Observação

Não há suporte para instantâneos do Maven com fontes de upstream do Maven.

Salvar pacotes do Repositório do Google Maven

Antes de salvar pacotes do Repositório do Google Maven, verifique se você configurou seu projeto para se conectar ao feed. Se você ainda não tiver feito isso, siga as instruções na configuração do projeto para configurar seu projeto Maven e conectar-se ao seu feed.

Neste exemplo, salvaremos a Biblioteca Zipflinger do Repositório do Google Maven.

  1. Navegue até o Repositório do Google Maven em https://mvnrepository.com/.

  2. Procure a biblioteca Zipflinger. Selecione o pacote Zipflinger e, em seguida, selecione a versão que deseja instalar.

  3. Copie o <dependency>trecho da guia Maven .

    <dependency>
    <groupId>com.android</groupId>
    <artifactId>zipflinger</artifactId>
    <version>8.3.0-alpha13</version>
</dependency>

  4. Abra o arquivo pom.xml e cole o trecho dentro <dependencies> da marca e salve o arquivo.

  5. Execute o seguinte comando a partir do mesmo caminho que o arquivo pom.xml para instalar suas dependências:

    mvn install

Observação

Para salvar pacotes de upstreams, você deve ter a função Feed e Upstream Reader (Colaborador) ou superior. Consulte Gerenciar permissões para obter mais detalhes.

Exibir pacotes salvos

Para visualizar os pacotes instalados a partir do upstream, selecione a origem do repositório do Google Maven no menu suspenso.

  1. Entre na sua organização do Azure DevOps e navegue até seu projeto.

  2. Selecione Artefatos e, em seguida, selecione o feed no menu suspenso.

  3. Selecione a origem do repositório do Google Maven no menu suspenso para encontrar pacotes desse upstream.

  4. O pacote Zipflinger que salvamos na etapa anterior agora está disponível em nosso feed, pois os Artefatos do Azure salvaram automaticamente uma cópia quando executamos o comando mvn install.

    Uma captura de tela mostrando pacotes do Google Maven Repository.

Dica

Se o Maven não estiver baixando todas as dependências, execute o seguinte comando no diretório do projeto para regenerar os arquivos do projeto: mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true