Skip to main content

Android Quick Start

Get started with the Azeoo SDK in 5 minutes.

Prerequisites​

  • Android Studio latest version
  • minSdkVersion 21 (Android 5.0) or higher
  • Kotlin or Java support
  • An API key from Azeoo Client Platform

Step 1: Installation​

Maven and JitPack are not available yet. Install using the local AAR (flat directory) setup, as in the example Android app:

  1. Download the AAR from the Downloads & install sources page.
  2. Unpack into app/libs in Maven layout (com/azeoo/sdk/<version>/...).
  3. In settings.gradle.kts, add maven { url = uri("${rootDir}/app/libs") } and the Flutter engine repo (see Installation Guide).
  4. In app/build.gradle.kts, add implementation(libs.sdk) or implementation("com.azeoo:sdk:1.0.4").

Full steps (exact settings.gradle.kts and version catalog) are in the Installation Guide.

Step 2: Get Your API Key​

  1. Register at Azeoo Client Platform
  2. Generate an SDK token

See Getting SDK Token for detailed instructions.

Step 3: Initialize and connect​

Use a single entry point: init with API key and config, then connect with user ID and token.

In your Application class:

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.init(
            context = this,
            apiKey = "your-api-key-here",
            config = config,
        )
        // Connect is called later when the user is authenticated (e.g. after login)
    }
}

Register your Application class in AndroidManifest.xml:

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

When the user is authenticated (e.g. after login), call connect:

AzeooSDK.shared.connect(userId = "user-123", token = "auth-token-here") { result ->
    result.onSuccess { profile -> /* SDK ready */ }
    result.onFailure { error -> /* Handle error */ }
}

Wait for the SDK to be ready (e.g. AzeooSDK.onReady callback or check AzeooSDK.shared.isReady) before showing SDK UI.

Step 4: Show your first screen​

Embed a module or open a screen:

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)
        }
        findViewById<Button>(R.id.btnTraining).setOnClickListener {
            AzeooSDK.shared.modules.training.showWorkouts()
        }
    }
}

That's it! You should now see the SDK UI when the fragment is shown or when you call the module methods.

What's next?​

Troubleshooting​

  • Ensure your API key is valid and you have called connect(userId, token) before using modules.
  • Use AzeooSDK.onReady callback to wait for Flutter initialization to complete.
  • Check the Configuration Guide for common issues.