Skip to main content

🛠️ Troubleshooting

SDK not initialized​

Symptom: Error mentions initialize or SDK token not found.

Fix:

  1. Call initialize with a valid API key first.
  2. Wait for success before connect or showing UI.
  3. On Android, use the callback — do not call connectUser until initialize succeeds.

Not connected / ensureConnected​

Symptom: Cannot show nutrition/training UI.

Fix: Call connect / connectUser after initialize. Check JWT is not expired.

Wrong connect parameters​

Symptom: Connect fails or wrong user.

Fix:

  • Do not pass userId into connect.
  • Pass token, gender, height, weight — see Measurements.

iOS: missing Flutter frameworks​

Symptom: Xcode cannot find xcframeworks / build fails on sdk/ios.

Fix: From repo root run:

./scripts/ios_build.sh

Then reopen the Xcode workspace.

Android: AAR not found​

Symptom: Gradle cannot resolve com.azeoo:sdk.

Fix:

  1. Download AAR from Downloads or copy from example/android/app/libs.
  2. Add local Maven repo in settings.gradle.kts as in Android installation.

Android: native library / UnsatisfiedLinkError​

Symptom: java.lang.UnsatisfiedLinkError: dlopen failed, missing libflutter.so, or ABI-related build errors after adding the SDK.

Fix: Add NDK ABI filters in your app module (app/build.gradle.kts). This is required for every host app — the SDK AAR cannot set it for you.

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

Full explanation: Android installation → NDK ABI filters. Then clean and rebuild.

React Native: Android build fails​

Symptom: Missing Flutter engine / SDK dependency.

Fix: In project-level android/build.gradle:

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

Fix:

  1. Configure URL schemes / universal links in the host app.
  2. Pass matching deepLinks / DeepLinkConfig at initialize.
  3. Forward URLs to SDK handleDeepLink (native/RN).

Theme / embedded view issues (React Native)​

See React Native theme and UI components. If problems persist, compare with example/react-native and include SDK version in support requests.

Still stuck?​

  1. Compare with the matching example app.
  2. Check Integration checklist.
  3. Contact AZEOO support with platform, SDK version, and initialize/connect logs (no secrets).