Aller au contenu principal

Démarrage rapide du SDK iOS

Démarrez avec le SDK Azeoo en 5 minutes.

Pré-requis​

  • Xcode 15.0+
  • iOS 13.0+ (ou la version minimale requise par le SDK)
  • Swift 6.0+ (ou compatible)
  • Une clé API depuis la plateforme Azeoo Client

Étape 1 : Installation​

Swift Package Manager​

  1. Dans Xcode : File → Add Package Dependencies...
  2. Saisissez l’URL du package (voir Téléchargements pour le lien actuel) : https://bitbucket.org/azeoo/azeoo_sdk_spm
  3. Choisissez la version (ex. 1.0.0) et ajoutez-la à la cible de votre application

Consultez le Guide d’installation pour les détails.

Étape 2 : Obtenir votre clé API​

  1. Inscrivez-vous sur Azeoo Client Platform
  2. Générez un jeton SDK

Voir Obtenir le jeton SDK.

Étape 3 : Initialiser et connecter​

Utilisez le point d’entrée public du SDK iOS : appelez AzeooSDK.initialize(...), puis connectUser(...).

import AzeooSDK

let config = AzeooConfig(
    locale: "en",
    analyticsEnabled: true,
    offlineEnabled: true
)
let theme = AzeooThemeConfig(
    lightPrimaryColor: 0xFF5073F0,
    darkPrimaryColor: 0xFF156204
)
let deepLinks = AzeooDeepLinkConfig(scheme: "https", host: "azeoo.com")
let safeArea = AzeooSafeAreaConfig(top: true, bottom: true, left: true, right: true)

AzeooSDK.initialize(
    apiKey: "your-sdk-api-key",
    config: config,
    theme: theme,
    deepLinks: deepLinks,
    safeArea: safeArea
) { result in
    switch result {
    case .success(let sdk):
        // Ensuite, connectez quand votre application dispose d’un jeton utilisateur valide
        sdk.connectUser(
            token: "user-token",
            gender: "male",
            height: AzeooHeight(178.0),
            weight: AzeooWeight(75.0)
        ) { connectResult in
            switch connectResult {
            case .success(let profile):
                print("Connecté : \(profile.name ?? "unknown")")
            case .failure(let error):
                print("Erreur de connexion : \(error.localizedDescription)")
            }
        }
    case .failure(let error):
        print("Erreur d’initialisation : \(error.localizedDescription)")
    }
}

Consultez l’exemple iOS pour une intégration complète.

Étape 4 : Afficher l’UI du SDK​

Récupérez un view controller ou une view depuis le module et présentez-le, ou ouvrez un écran :

guard let sdk = AzeooSDK.shared else { return } // or keep your SDK instance
let nutritionVC = sdk.modules.nutrition.getViewController()
present(nutritionVC, animated: true)

// Or open a screen
sdk.modules.nutrition.showDiary(date: nil)

C’est tout ! Une fois initialisé et connecté, l’UI du SDK est disponible via les vues des modules et les méthodes de navigation des modules.

Et ensuite ?​