Utiliser des packages à partir du référentiel Google Maven

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

Avec Azure Artifacts, les développeurs peuvent autoriser amont sources à consommer des packages à partir de différents registres publics tels que google Maven Repository. Une fois activé, Azure Artifacts enregistre automatiquement une copie de tout package installé à partir de la amont. En outre, Azure Artifacts prend en charge d’autres sources maven amont telles que Maven Central, Gradle Plugins et JitPack. Dans cet article, vous allez apprendre à :

  • Ajouter un référentiel Google Maven en tant que source amont
  • Consommer un package à partir de amont
  • Rechercher des packages enregistrés dans votre flux

Prérequis

  • Un organization Azure DevOps et un projet. Créez un organization ou un projet si ce n’est pas déjà fait.

  • Un flux Azure Artifacts.

Activer les sources amont

Si vous n’avez pas encore de flux, suivez les instructions ci-dessous pour créer un flux et veillez à case activée les sources amont case activée box pour les activer. Si vous disposez déjà d’un flux, passez à l’étape suivante pour ajouter google Maven Repository en tant que source amont :

  1. Connectez-vous à votre organisation Azure DevOps puis accédez à votre projet.

  2. Sélectionnez Artefacts, puis créez un flux pour créer un flux.

  3. Entrez un nom descriptif pour votre flux et définissez sa visibilité (indiquant qui peut afficher les packages dans le flux). Spécifiez l’étendue de votre flux et, si vous souhaitez inclure des packages à partir de sources publiques, marquez les sources en amont case activée box.

  4. Sélectionnez Créer lorsque vous avez terminé.

    Capture d’écran montrant comment créer un flux dans Azure DevOps Services.

  1. Connectez-vous à votre serveur Azure DevOps, puis accédez à votre projet.

  2. Sélectionnez Artefacts, puis créez un flux pour créer un flux.

  3. Entrez un nom descriptif pour votre flux et définissez sa visibilité (indiquant qui peut afficher les packages dans le flux). Spécifiez l’étendue de votre flux et, si vous souhaitez inclure des packages à partir de sources publiques, marquez les sources en amont case activée box.

  1. Sélectionnez Créer lorsque vous avez terminé.

    Capture d’écran montrant comment créer un flux dans Azure DevOps 2022.

  1. Sélectionnez Créer lorsque vous avez terminé.

    Capture d’écran montrant comment créer un flux dans Azure DevOps 2020.

  1. Connectez-vous à votre serveur Azure DevOps, puis accédez à votre projet.

  2. Sélectionnez Artefacts, puis nouveau flux.

  3. Entrez un nom descriptif pour votre flux et définissez sa visibilité (indiquant qui peut afficher les packages dans le flux). Si vous souhaitez inclure des packages à partir de sources publiques, sélectionnez l’option Utiliser des packages à partir de sources publiques via cette option de flux .

  4. Sélectionnez Créer lorsque vous avez terminé.

    Capture d’écran montrant comment créer un flux dans Azure DevOps 2019.

Remarque

Par défaut, les flux nouvellement créés ont le service de génération de leur projet défini sur Feed and Upstream Reader (Collaborateur).

Ajouter un dépôt Google Maven amont

Si vous case activée les sources amont case activée box lors de la création de votre flux, le référentiel Google Maven doit déjà être ajouté en tant que source amont. Si ce n’est pas le cas, vous pouvez l’ajouter manuellement en procédant comme suit :

  1. Connectez-vous à votre organisation Azure DevOps puis accédez à votre projet.

  2. Sélectionnez Artefacts, puis sélectionnez l’icôned’engrenage icône d’engrenaged’engrenage dans le coin supérieur droit pour accéder à votre Paramètres de flux.

  3. Sélectionnez Sources en amont, puis sélectionnez Ajouter en amont.

  4. Sélectionnez Source publique, puis sélectionnez Dépôt Google Maven (https://maven.google.com/web/index.html) dans le menu déroulant.

  5. Sélectionnez Enregistrer lorsque vous avez terminé, puis sélectionnez Enregistrer à nouveau dans le coin supérieur droit pour enregistrer vos modifications.

Remarque

Les instantanés Maven ne sont pas pris en charge avec les sources maven amont.

Enregistrer des packages à partir du référentiel Google Maven

Avant d’enregistrer des packages à partir du dépôt Google Maven, vérifiez que vous avez configuré votre projet pour vous connecter à votre flux. Si vous ne l’avez pas déjà fait, suivez les instructions de la configuration du projet pour configurer votre projet Maven et vous connecter à votre flux.

Dans cet exemple, nous allons enregistrer la bibliothèque Zipflinger à partir du dépôt Google Maven.

  1. Accédez au référentiel Google Maven à l’adresse https://mvnrepository.com/.

  2. Recherchez la bibliothèque Zipflinger. Sélectionnez le package Zipflinger , puis sélectionnez la version que vous souhaitez installer.

  3. Copiez l’extrait de code <dependency> à partir de l’onglet Maven .

    <dependency>
        <groupId>com.android</groupId>
        <artifactId>zipflinger</artifactId>
        <version>8.3.0-alpha13</version>
    </dependency>
    
  4. Ouvrez votre fichier pom.xml et collez l’extrait de code à l’intérieur de votre <dependencies> balise, puis enregistrez votre fichier.

  5. Exécutez la commande suivante à partir du même chemin que votre fichier pom.xml pour installer vos dépendances :

    mvn install
    

Remarque

Pour enregistrer des packages à partir de amont s, vous devez disposer du rôle Flux et Lecteur en amont (Collaborateur) ou supérieur. Pour plus d’informations, consultez Gérer les autorisations .

Afficher les packages enregistrés

Pour afficher les packages que vous avez installés à partir de amont, sélectionnez la source du référentiel Google Maven dans le menu déroulant.

  1. Connectez-vous à votre organisation Azure DevOps puis accédez à votre projet.

  2. Sélectionnez Artefacts, puis sélectionnez votre flux dans le menu déroulant.

  3. Sélectionnez la source du référentiel Google Maven dans le menu déroulant pour rechercher des packages à partir de cette amont.

  4. Le package Zipflinger que nous avons enregistré à l’étape précédente est désormais disponible dans notre flux, car Azure Artifacts a automatiquement enregistré une copie lorsque nous avons exécuté la commande d’installation mvn.

    Capture d’écran montrant les packages à partir du dépôt Google Maven.

Conseil

Si Maven ne télécharge pas toutes vos dépendances, exécutez la commande suivante à partir du répertoire du projet pour régénérer les fichiers de votre projet : mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true