Froggit Repository Plugin

Plugin Gradle pour simplifier l'ajout d'un dépôt Maven hébergé sur Froggit (GitLab).

🧩 Installation

Ajoute le plugin dans ton settings.gradle.kts :

pluginManagement {
    repositories {
        maven(uri("https://lab.frogg.it/api/v4/projects/1980/packages/maven"))
    }
}

Et dans le build.gradle.kts de ton projet :

plugins {
    id("dev.arvernes.froggit-repo") version "1.0.0"
}

📦 Utilisation

Déclare ton dépôt dans le bloc repositories :

repositories {
    mavenFroggit(1234, "MY_TOKEN_VAR") // projectId Froggit, nom de la variable d'environnement ou propriété
}

Le plugin ajoute automatiquement l'authentification par token si la variable est définie.

🔐 Authentification

Le token d'accès doit être un token personnel GitLab avec les permissions suivantes :

• read_api
• read_repository

ℹ️ Ces scopes sont nécessaires pour accéder au registre Maven des projets privés via HTTP.

🔑 Où définir ton token ?

Pour plus de sécurité, il est recommandé d'utiliser ~/.gradle/gradle.properties de l'utilisateur :

MY_TOKEN_VAR=glpat-xxxxxxxxxxxxxxxxxxxx

Alternativement, tu peux le définir via une variable d’environnement (ex : en CI/CD) :

export MY_TOKEN_VAR=glpat-xxxxxxxxxxxxxxxxxxxx

⚠️ Comportement

• Si le token n’est pas fourni, le dépôt est quand même déclaré (utile pour des packages publics).
• Un message d'avertissement s'affiche si la variable est attendue mais manquante.
• L'authentification est appliquée uniquement si le token est trouvé.

📘 Exemple complet

plugins {
    id("dev.arvernes.froggit-repo") version "1.0.0"
}

repositories {
    mavenFroggit(1978, "MAVEN_CONSUMER_TOKEN")
    mavenCentral()
}