Native Android SDK

Use the native SmartLinks SDK in Kotlin/Java Android apps without Flutter. The full package combines analytics and native UI modules. The example dependency below is the published 2.0.2 release.

Add the dependency

Make sure mavenCentral() is in your project's dependency repositories, then add this to the app module's build.gradle.kts:

dependencies {
    implementation("live.smartlinks:smartlinks-sdk:2.0.2")
}

The native UI module requires Android API 24 or newer and targets Java/JVM 11. Use a compatible Android Gradle toolchain. For integrations without native UI, the separate smartlinks-sdk-core artifact provides the core bridge; its API is not interchangeable with every full-package UI example.

Initialize in your Application

import android.app.Application
import com.alkashier.smartlinks.SmartLinks

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        SmartLinks.initialize(
            context = this,
            apiKey = "YOUR_API_KEY",
            debugMode = BuildConfig.DEBUG,
        )
    }
}

Register .MyApplication with android:name on your manifest's <application> element. If you already have an Application class, add initialization there instead of replacing it. BuildConfig should be your host app's generated class.

Send an event

Call this after initialization, from a context where applicationContext is available:

SmartLinks.analytics.sendEvent(
    eventName = "integration_test",
    params = mapOf("screen" to "home"),
    context = applicationContext,
)

Use non-sensitive properties. Never send API credentials, passwords or raw purchase receipts as event metadata.

Configure deep links

Inside the activity that receives your links:

<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="https"
          android:host="smartlinks.live"
          android:pathPrefix="/l/YOUR_APP_SLUG/" />
</intent-filter>

Replace the slug and domain with your app's configuration. This covers long-form app links, not every short-link path. Configure the actual paths you use and register the correct package name and signing fingerprints in SmartLinks.

Forward the launch intent and subsequent link intents from your Activity using SmartLinks.handleDeepLink(this, intent). Handle subsequent intents in onNewIntent, after calling the superclass implementation. Validate a received route before navigating.

Optional native screens

After initialization, call SmartLinks.openFeedback(activity) or SmartLinks.openApps(activity) from an active Activity. Community, blogs and ads also have native modules; configure their required services before enabling them.

Confirm delivery

Run the app, send integration_test, then check the matching app's private analytics view. Verify installed-app links on a physical device and repeat with the release signing certificate before distribution.

For errors and key handling, see API keys and security. Published artifact versions are listed in Maven Central metadata.