Skip to main content

🚀 Android Quick Start

Six steps from zero to nutrition UI.

Prerequisites​

Step 1: Install the SDK​

Download the AAR from Downloads (version 1.0.9 recommended) and set up local Maven — Installation guide.

In app/build.gradle.kts:

implementation("com.azeoo:sdk:1.0.9")
Required — NDK ABI filters

Before you run the app, add ndk.abiFilters in app/build.gradle.kts (your host app, not optional). See Installation → Step 4b for the exact snippet and why it is required.

Step 2: Initialize in Application or Activity​

import com.azeoo.sdk.AzeooConfig
import com.azeoo.sdk.AzeooDeepLinkConfig
import com.azeoo.sdk.AzeooSDK
import com.azeoo.sdk.AzeooSafeAreaConfig

private fun initializeSDK() {
    val config = AzeooConfig(
        locale = "en",
        analyticsEnabled = true,
        offlineEnabled = true,
        connectionTimeoutSeconds = 30L,
        persistSession = true,
    )
    val deepLinks = AzeooDeepLinkConfig(scheme = "https", host = "azeoo.com")
    val safeArea = AzeooSafeAreaConfig(top = true, bottom = true, left = true, right = true)

    AzeooSDK.initialize(
        context = applicationContext,
        apiKey = "YOUR_API_KEY",
        config = config,
        theme = themeConfig,   // optional — see ThemeHelper in example
        deepLinks = deepLinks,
        safeArea = safeArea,
    ) { error ->
        if (error != null) { /* show error UI */ return@initialize }
        // Show login / connect UI
    }
}
Use initialize, not init

Use initialize, not init. Wait for the callback before connectUser.

Step 3: Connect when user is logged in​

Pass a User JWT created by your backend. See Creating the User JWT for the payload spec and backend code examples.

AzeooSDK.shared.connectUser(
    token = userJwt,    // JWT from YOUR backend — see link above
    gender = user.gender,
    height = user.height,
    weight = user.weight,
) { profile, error ->
    if (error != null) return@connectUser
    // profile?.id is the Azeoo user id — navigate to main UI
}

Do not pass userId — it comes back in profile.

Step 4: Embed nutrition Fragment​

val fragment = AzeooSDK.shared.modules.nutrition.getFragment(bottomSafeArea = false)
childFragmentManager
    .beginTransaction()
    .replace(R.id.flutter_container, fragment)
    .commitNow()

Training: modules.training.getFragment(...).

Step 5: Tab bar sync (optional)​

If you use bottom navigation:

sdk.setModuleContainer(
    AzeooBottomNavCoordinator(
        bottomNav = bottomNavigation,
        mapping = mapOf(
            AzeooDestination.Module.NUTRITION to R.id.nav_nutrition,
            AzeooDestination.Module.TRAINING to R.id.nav_training,
        ),
    )
)

See Navigation and the destination catalogue.

Step 6: Logout​

AzeooSDK.shared.disconnect { }

Full teardown: dispose() then initialize again.

Next steps​