Android SDK

Requirements: Android API 26+ (Android 8.0+), Kotlin 1.8+. A physical device is recommended for App Links verification.

Installation

Add the dependency to your app's build.gradle.kts:

dependencies {
    implementation("app.warplink:sdk:0.1.0")
}

Sync your project with Gradle files.

Configure the SDK

Initialize WarpLink in your Application.onCreate():

import android.app.Application
import app.warplink.WarpLink
import app.warplink.WarpLinkOptions

class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        WarpLink.configure(
            context = this,
            apiKey = "wl_live_your_api_key_here_abcdefgh"
        )
    }
}

<application
    android:name=".MyApp"
    ... >

Enable debug logging during development:

WarpLink.configure(
    context = this,
    apiKey = "wl_live_your_api_key_here_abcdefgh",
    options = WarpLinkOptions(debugLogging = true, matchWindowHours = 48)
)

Add App Links Intent Filter

Add the intent filter to your main Activity in AndroidManifest.xml:

<activity
    android:name=".MainActivity"
    android:exported="true">

    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>

    <!-- WarpLink App 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="aplnk.to" />
    </intent-filter>
</activity>

The android:autoVerify="true" attribute triggers automatic assetlinks.json verification at install time.

Get Your SHA256 Fingerprint

keytool -list -v -keystore ~/.android/debug.keystore \
    -alias androiddebugkey -storepass android

keytool -list -v -keystore your-release-key.keystore -alias your-alias

Copy the SHA256 value and paste it into the dashboard under Settings > Apps.

Test on a Physical Device

# Verify App Links status
adb shell pm get-app-links com.yourcompany.yourapp

# Open a test link
adb shell am start -a android.intent.action.VIEW \
    -d "https://aplnk.to/abc123" com.yourcompany.yourapp

# Filter Logcat for WarpLink messages
adb logcat -s WarpLink

Next Steps

Deep Links — Handle App Links in Activity and Compose
Deferred Deep Links — Preserve context through Play Store installs
Attribution — Play Install Referrer and fingerprint matching
API Reference — Full Kotlin API documentation