Aller au contenu principal

Initialisation du SDK

L'Azeoo SDK utilise un flux unique en deux étapes sur toutes les plateformes : initialize avec votre clé API et vos options, puis connect avec un ID utilisateur et un token. Les étapes ci-dessous s'appliquent à Android, iOS, Flutter et React Native ; pour la configuration complète (dépendance, Application/AppDelegate, etc.), consultez Quick Start et le guide d'installation de votre plateforme.

Flux d'initialisation​

  1. Initialize — Passer la clé API et une config optionnelle (locale, thème, zone de sécurité, deep links, analytics, offline). Aucun utilisateur n'est attaché.
  2. Connect — Passer userId et token pour attacher un utilisateur. Ensuite, vous pouvez utiliser les modules et les API user/theme/navigation.

Étape 1 : Initialize​

Flutter​

import 'package:azeoo_sdk/azeoo_sdk.dart';

await AzeooSDK.initialize(
  'your-api-key',
  options: AzeooSDKInitOptions(
    locale: 'en',
    analyticsEnabled: true,
    offlineSupport: true,
    theme: themeConfig,
    deepLinks: deepLinkConfig,
    safeArea: SafeAreaConfig.all(),
  ),
);

Android​

import com.azeoo.sdk.AzeooSDK
import com.azeoo.sdk.AzeooConfig

val sdk = AzeooSDK.init(
    context = this,
    apiKey = "your-api-key",
    config = AzeooConfig(
        locale = "en",
        analyticsEnabled = true,
        offlineEnabled = true,
    ),
    theme = themeConfig,      // optional
    deepLinks = deepLinkConfig, // optional
    safeArea = safeAreaConfig,  // optional
)
// Use AzeooSDK.shared or the returned instance

iOS​

import AzeooSDK

AzeooCore.shared.initialize(enableMultipleInstances: false)
let api = AzeooClientApiFromEngine(AzeooCore.shared.getFlutterEngine()!)

api.initialize(
    apiKey: "your-api-key",
    config: configMessage,
    theme: themeMessage,
    deepLinks: deepLinkMessage,
    safeArea: safeAreaMessage
) { result in
    // Handle result
}

React Native​

Utilisez l'API fournie par le package React Native (ex. AzeooSDK.init avec apiKey, config et theme). Voir l'installation React Native et le quick start pour l'API exacte.

Étape 2 : Connect user​

Après initialize, appelez connect avec l'ID et le token de l'utilisateur authentifié. Tant que vous n'avez pas appelé connect, les API des modules et utilisateur ne sont pas disponibles.

Flutter​

await AzeooSDK.connect(userId, token);
// Then use AzeooSDK.nutrition, AzeooSDK.training, AzeooSDK.user, etc.

Android​

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

iOS​

api.connect(userId: "user-123", token: "jwt-token") { result in
    switch result {
    case .success(let profile): break // SDK ready
    case .failure(let error): break   // Handle error
    }
}

Étape 3 : Utiliser le SDK​

Une fois connecté, utilisez l'instance du SDK pour embarquer des modules ou ouvrir des écrans :

  • Flutter : AzeooSDK.nutrition.showMainScreen(), AzeooSDK.training.showWorkouts(), ou embarquer AzeooSDKContent.
  • Android : AzeooSDK.shared.modules.nutrition.getFragment(), .showDiary(), etc.
  • iOS : Obtenir l'instance du SDK et utiliser modules.nutrition.getViewController(), showDiary(), etc.
  • React Native : Utiliser les vues et méthodes de module du package comme documenté.

Consultez la section API SDK / Client de votre plateforme pour la liste complète des méthodes.

Gestion des erreurs​

Toujours gérer les erreurs de initialize et connect (ex. clé API invalide, problèmes réseau, token invalide). Ne considérez pas le SDK comme prêt tant que ces appels n'ont pas réussi.

Étapes suivantes​