Aller au contenu principal

Installation du SDK Android

Maven et JitPack ne sont pas encore disponibles

Le SDK Android n’est pas encore publié sur Maven Central ni sur JitPack. Utilisez la configuration AAR locale (dossier plat) ci-dessous, comme dans l’application Android d’exemple. Téléchargez l’AAR depuis la page Téléchargements & sources d’installation.

AAR local (dossier plat dans app/libs)​

Utilisez l’AAR en le plaçant dans app/libs avec une structure style Maven, puis en pointant settings.gradle.kts vers ce dossier. Ceci correspond au projet Android d’exemple.

Étape 1 : Télécharger l’AAR du SDK​

  1. Rendez-vous sur la page Téléchargements & sources d’installation.
  2. Téléchargez l’AAR du SDK Android (zip ou dossier au format Maven).
  3. Décompressez pour obtenir cette structure sous un dossier unique (par ex. app/libs) :
    • com/azeoo/sdk/<version>/sdk-<version>.aar
    • com/azeoo/sdk/<version>/sdk-<version>.pom (and optionally .module)
    • Optionally com/azeoo/sdk/maven-metadata-local.xml

Étape 2 : Placer l’AAR dans app/libs​

Placez le contenu décompressé de façon à ce que app/libs soit la racine du dépôt (le dossier qui contient com/azeoo/sdk/...). Votre structure doit ressembler à :

your-project/
  android/
    settings.gradle.kts
    app/
      build.gradle.kts
      libs/                    ← flat directory root (same as example)
        com/
          azeoo/
            sdk/
              1.0.4/
                sdk-1.0.4.aar
                sdk-1.0.4.pom
              maven-metadata-local.xml

Étape 3 : Pointer Gradle vers app/libs dans settings.gradle.kts​

Dans votre settings.gradle.kts au niveau du projet, ajoutez un dépôt maven dont l’URL est ${rootDir}/app/libs (identique à l’exemple) :

// settings.gradle.kts
pluginManagement {
    repositories {
        google {
            content {
                includeGroupByRegex("com\\.android.*")
                includeGroupByRegex("com\\.google.*")
                includeGroupByRegex("androidx.*")
            }
        }
        mavenCentral()
        gradlePluginPortal()
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        mavenLocal()
        // Local AAR (flat directory) — Azeoo SDK
        maven {
            url = uri("${rootDir}/app/libs")
        }
        // Flutter engine (required by Azeoo SDK)
        maven("https://storage.googleapis.com/download.flutter.io")
    }
}

rootProject.name = "My Application"
include(":app")

Étape 4 : Déclarer la dépendance​

Option A — Catalogue de versions (recommandée, identique à l’exemple)

In gradle/libs.versions.toml:

[versions]
sdk = "1.0.4"   # must match the version folder under app/libs/com/azeoo/sdk/

[libraries]
sdk = { module = "com.azeoo:sdk", version.ref = "sdk" }

In app/build.gradle.kts:

dependencies {
    implementation(libs.sdk)
    // ... other dependencies
}

Option B — Coordonnées directes

In app/build.gradle.kts:

dependencies {
    implementation("com.azeoo:sdk:1.0.4")   // version must match app/libs/com/azeoo/sdk/
    // ... other dependencies
}

Étape 5 : Synchroniser et vérifier​

Synchronisez Gradle. Si le projet compile et que vous pouvez utiliser import com.azeoo.sdk.AzeooSDK, la configuration AAR locale est correcte.

Exigences​

  • minSdkVersion : 24 (Android 7.0)
  • targetSdkVersion : 36
  • Kotlin : 2.1.0 ou ultérieur
  • Gradle : 8.13 ou ultérieur

Règles ProGuard​

Si vous utilisez ProGuard, ajoutez ceci à proguard-rules.pro :

-keep class com.azeoo.sdk.** { *; }
-keep interface com.azeoo.sdk.** { *; }
-dontwarn com.azeoo.sdk.**

Prochaines étapes​