Android SDK

lander-android is the native Android SDK for Lander. It catches every link that opens your app (App Links and custom scheme URLs), asks Lander what the link means, and hands your app one tidy LanderLink with the route to open and the data you attached to it.

class App : Application() {
    override fun onCreate() {
        super.onCreate()
        Lander.initialize(this, apiKey = "pk_live_...", enableLogging = BuildConfig.DEBUG)
    }
}

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        Lander.handleIntent(intent)
        lifecycleScope.launch {
            repeatOnLifecycle(Lifecycle.State.STARTED) {
                Lander.deepLinks.collect { link -> navigate(link.route) }
            }
        }
    }

    override fun onNewIntent(intent: Intent) {
        super.onNewIntent(intent)
        setIntent(intent)
        Lander.handleIntent(intent)
    }
}

That is the whole integration for most apps. The rest of this section explains each piece. Building with Flutter instead? Use the Flutter SDK.

What you getCopy Anchor Link

• One Flow for every link. Cold start, warm start and deferred links (after an install) all arrive on Lander.deepLinks.
• Nothing lost at startup. Links that arrive before anything collects are buffered and replayed in order, so you can start collecting whenever your navigation is ready.
• No double navigation. The link that launched the app is delivered exactly once, whether you read it from the flow or from Lander.getInitialLink(). A rotated or recreated activity does not deliver its link again.
• Honest attribution. Every link says how sure Lander is: DETERMINISTIC, PROBABILISTIC or UNATTRIBUTED.
• Unknown links still arrive. A URL Lander does not know (or cannot reach because the device is offline) still reaches your app with its raw URL.
• Short links from the app. Lander.createLink makes a shareable link for invite and share flows.
• Conversions that survive offline. Lander.trackEvent writes to an on device queue and sends in batches with retries and deduplication.
• Privacy first. A random install ID, no fingerprinting, no advertising ID.
• Small. It depends on kotlinx-coroutines and the Play Install Referrer library only, and talks HTTP with HttpURLConnection.
• Kotlin and Java. Suspending functions and a Flow for Kotlin, static methods with main thread callbacks for Java.

The public API at a glanceCopy Anchor Link

Full signatures are in the API reference.

How a tap becomes a screenCopy Anchor Link

1. Someone taps https://acme.golander.link/p-123.
2. Android sees that your app has claimed the domain (Lander hosts the assetlinks.json file for you) and opens your activity instead of the browser.
3. Your activity passes its intent to Lander.handleIntent.
4. The SDK calls POST /v1/sdk/resolve on api.golander.link. Lander records the open and answers with the link's route (/product/123), params and attribution labels.
5. Lander.deepLinks emits a LanderLink, and your app opens link.route.

If the app was not installed, Lander sends the person to the Play Store with a single use token, and gives the link back on first launch. See Deferred links.

RequirementsCopy Anchor Link

The current SDK version is 0.1.0.

Next stepsCopy Anchor Link