Aller au contenu principal

Démarrage rapide du SDK Android

Démarrez avec le SDK Azeoo en 5 minutes.

Pré-requis​

  • Android Studio (dernière version)
  • minSdkVersion 24 (Android 7.0) ou supérieur
  • Support Kotlin ou Java
  • Une clé API depuis Azeoo Client Platform

Étape 1 : Installation​

Maven et JitPack ne sont pas encore disponibles. Installez en utilisant la configuration AAR locale (dossier plat), comme dans l’application Android d’exemple :

  1. Téléchargez l’AAR depuis la page Téléchargements & sources d’installation.
  2. Décompressez dans app/libs avec la structure Maven (com/azeoo/sdk/<version>/...).
  3. Dans settings.gradle.kts, ajoutez maven { url = uri("${rootDir}/app/libs") } et le dépôt du moteur Flutter (voir Guide d’installation).
  4. Dans app/build.gradle.kts, ajoutez implementation(libs.sdk) ou implementation("com.azeoo:sdk:1.0.4").

Les étapes complètes (fichier settings.gradle.kts exact et version catalog) sont dans le Guide d’installation.

Étape 2 : Obtenir votre clé API​

  1. Inscrivez-vous sur Azeoo Client Platform
  2. Générez un jeton SDK

Voir Obtenir le jeton SDK pour les instructions détaillées.

Étape 3 : Initialiser et connecter​

Utilisez un point d’entrée unique : initialize avec la clé API et la configuration, puis connectUser lorsque l’utilisateur est authentifié.

Dans votre classe Application :

import android.app.Application
import com.azeoo.sdk.AzeooConfig
import com.azeoo.sdk.AzeooSDK

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        val config = AzeooConfig(
            locale = "en",
            analyticsEnabled = true,
            offlineEnabled = true,
        )
        AzeooSDK.initialize(
            context = this,
            apiKey = "your-sdk-api-key-here",
            config = config,
            callback = { error ->
                if (error == null) {
                    // SDK initialized
                } else {
                    // Handle init error
                }
            },
        )
        // connectUser is called later when the user is authenticated (e.g. after login)
    }
}

Enregistrez votre classe Application dans AndroidManifest.xml :

<application android:name=".MyApplication" ...>
</application>

Lorsque l’utilisateur est authentifié (par ex. après la connexion), appelez connectUser :

AzeooSDK.shared.connectUser(
    token = "user-token-here",
    gender = "male",
    height = AzeooHeight(178.0),
    weight = AzeooWeight(75.0),
) { profile, error ->
    if (error == null) {
        // SDK ready
    } else {
        // Handle error
    }
}

Attendez que le SDK soit prêt (par ex. via le callback AzeooSDK.onReady ou en vérifiant AzeooSDK.isReady) avant d’afficher l’UI du SDK.

Étape 4 : Afficher votre première interface​

Intégrez un module ou ouvrez un écran :

import androidx.appcompat.app.AppCompatActivity
import com.azeoo.sdk.AzeooSDK

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // Replace container with the nutrition fragment
        supportFragmentManager.beginTransaction()
            .replace(R.id.container, AzeooSDK.shared.modules.nutrition.getFragment())
            .commit()

        // Or open a specific screen
        findViewById<Button>(R.id.btnDiary).setOnClickListener {
            AzeooSDK.shared.modules.nutrition.showDiary(null)
        }
    }
}

C’est bon ! Vous devriez maintenant voir l’UI du SDK lorsque le fragment est affiché, ou lorsque vous appelez les méthodes des modules.

Et ensuite ?​

Dépannage​

  • Assurez-vous que votre clé API est valide et que vous avez appelé connectUser(...) avant d’utiliser les modules.
  • Utilisez le callback AzeooSDK.onReady pour attendre la fin de l’initialisation côté Flutter.
  • Consultez le Guide de configuration pour les problèmes fréquents.