Aller au contenu principal

🛠️ Dépannage

SDK non initialisé​

Symptôme : L'erreur mentionne initialize ou token SDK introuvable.

Correctif :

  1. Appelez initialize avec une clé API valide en premier.
  2. Attendez le succès avant connect ou l'affichage de l'UI.
  3. Sur Android, utilisez le callback — n'appelez pas connectUser tant que initialize n'a pas réussi.

Non connecté / ensureConnected​

Symptôme : Impossible d'afficher l'UI nutrition/training.

Correctif : Appelez connect / connectUser après initialize. Vérifiez que le JWT n'est pas expiré.

Mauvais paramètres de connect​

Symptôme : Échec de connect ou mauvais utilisateur.

Correctif :

  • Ne passez pas userId à connect.
  • Passez token, gender, height, weight — voir Mesures.

iOS : frameworks Flutter manquants​

Symptôme : Xcode ne trouve pas les xcframeworks / échec de build sur sdk/ios.

Correctif : Depuis la racine du dépôt :

./scripts/ios_build.sh

Puis rouvrez le workspace Xcode.

Android : AAR introuvable​

Symptôme : Gradle ne résout pas com.azeoo:sdk.

Correctif :

  1. Téléchargez l'AAR depuis Téléchargements ou copiez depuis example/android/app/libs.
  2. Ajoutez le dépôt Maven local dans settings.gradle.kts comme dans Installation Android.

Android : bibliothèque native / UnsatisfiedLinkError​

Symptôme : java.lang.UnsatisfiedLinkError: dlopen failed, libflutter.so manquant, ou erreurs de build liées aux ABI après ajout du SDK.

Correctif : Ajoutez les filtres ABI NDK dans votre module app (app/build.gradle.kts). C'est obligatoire pour chaque app hôte — l'AAR SDK ne peut pas le définir pour vous.

android {
    defaultConfig {
        ndk {
            abiFilters += listOf("armeabi-v7a", "arm64-v8a", "x86_64")
        }
    }
}

Explication complète : Installation Android → filtres ABI NDK. Puis clean et rebuild.

React Native : échec de build Android​

Symptôme : Moteur Flutter / dépendance SDK manquante.

Correctif : Dans android/build.gradle au niveau projet :

apply from: "../node_modules/react-native-azeoo-lib/android/azeoolib-dependencies.gradle"

Correctif :

  1. Configurez les schémas URL / universal links dans l'app hôte.
  2. Passez deepLinks / DeepLinkConfig correspondant à l'initialize.
  3. Transmettez les URL au SDK via handleDeepLink (natif/RN).

Problèmes de thème / vue intégrée (React Native)​

Voir Thème React Native et Composants UI. Si le problème persiste, comparez avec example/react-native et incluez la version du SDK dans les demandes de support.

Toujours bloqué ?​

  1. Comparez avec l'app exemple correspondante.
  2. Consultez la Checklist d'intégration.
  3. Contactez le support AZEOO avec la plateforme, la version du SDK et les logs initialize/connect (sans secrets).