Skip to main content

iOS Quick Start

Get started with the Azeoo SDK in 5 minutes.

Prerequisites​

Step 1: Installation​

Swift Package Manager​

  1. In Xcode: File → Add Package Dependencies...
  2. Enter the package URL (see Downloads for the current link): https://bitbucket.org/azeoo/azeoo_sdk_spm
  3. Select version (e.g. 1.0.0) and add to your app target

See Installation Guide for details.

Step 2: Get your API key​

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

See Getting SDK Token.

Step 3: Initialize and connect​

Use the public iOS SDK entry point: call AzeooSDK.initialize(...), then 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):
        // Then connect when your app has a valid user token
        sdk.connectUser(
            token: "user-token",
            gender: "male",
            height: AzeooHeight(178.0),
            weight: AzeooWeight(75.0)
        ) { connectResult in
            switch connectResult {
            case .success(let profile):
                print("Connected: \(profile.name ?? "unknown")")
            case .failure(let error):
                print("Connect error: \(error.localizedDescription)")
            }
        }
    case .failure(let error):
        print("Initialize error: \(error.localizedDescription)")
    }
}

See the iOS example for a full integration.

Step 4: Show SDK UI​

Get a view controller or view from the module and present it, or open a screen:

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)

That's it! Once initialized and connected, the SDK UI is available through module views and module navigation methods.

What's next?​