Skip to main content
Version: current (0.13)

Mobile SDKs

Beta — research & development

The mobile SDKs are in beta. They work and are safe to ship, but they don't yet do everything the web SDK does, and their API may change between releases. This page explains what you can rely on today, what's missing, and how we plan to close the gap.

Where things stand​

PlatformStatusWhat it does today
iOS (Swift)Beta — available nowIdentifies each device with a Lucia ID and records taps and swipes
AndroidComing soonNot available yet

iOS is our main mobile platform for now. Android is in development, and these docs will grow with it.

What the iOS SDK can do today​

Identify each device

Gives every app install a stable Lucia ID, so its activity joins one profile in Lucia.

Record engagement

Captures taps and swipes (iOS 17+), batched and stored offline until there's a connection.

Respect privacy rules

Asks for Apple's tracking permission, limits what it collects by region, and ships Apple's privacy manifest for App Store review.

What it can't do yet​

The iOS SDK doesn't have methods for in-app conversions (purchases, signups), screen views, identifying a signed-in user later on, or wallet connects. Lucia also doesn't yet capture which ad led to an app install.

That means the iOS SDK tells you who is using your app and how much, but on its own it can't yet credit an in-app purchase to the campaign behind it, which is what the web SDK does.

Need in-app purchases in Lucia now?

You can send them yourself with one HTTPS request, tied to the device's Lucia ID. See Tracking In-App Conversions (Interim).

What's coming​

  • In-app events in the SDK. Native methods for conversions and other in-app events, so the interim workaround becomes a one-line SDK call. When that ships, the workaround page will show how to switch over.
  • Android SDK with the same capabilities as iOS.
  • Leaving beta. Once in-app events are in, we'll lock the API and mark iOS as stable.

Get started​

  1. iOS Quickstart: install the SDK and see your first device in about ten minutes.
  2. Privacy & App Store: what to tell Apple and your users, and what the SDK collects in each region.
  3. iOS Reference: every option, error, and setting.