Adxiety Client SDK Integration Guide

Add adxiety-client-1.0.0.aar to your app/libs/ folder and update app/build.gradle.kts:

dependencies {
    // [ad]xiety Client SDK (Zero permissions, < 30 KB DEX footprint)
    implementation(files("libs/adxiety-client-1.0.0.aar"))
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.8.0")
}

Gradle automatically merges all necessary IPC package queries and the reciprocal return action (com.adxiety.action.HOST_APP) directly from the SDK AAR. Zero manual manifest edits are required. (Shown below only if your build pipeline disables Gradle manifest merging):

<!-- Automatically merged from SDK AAR. Only required if your pipeline disables Manifest Merging: -->
<queries>
    <package android:name="com.adxiety.app" />
    <package android:name="com.adxiety.app.debug" />
    <intent>
        <action android:name="android.intent.action.VIEW" />
        <data android:scheme="adxiety" android:host="renew" />
    </intent>
</queries>

Check whether the user holds an active pass in <1.2ms. When expired, invoke launchRenewal(context):

import com.adxiety.client.AdxietyClient

// 1. Instant Synchronous Check (< 1.2ms local verification for UI / render threads)
val isUnlocked = AdxietyClient.isLeaseActive(context)
if (isUnlocked) {
    startAutomatedService()
} else {
    showPaywallSheet()
}

// 2. Background Asynchronous Check (IO dispatcher for background services & cold-start)
suspend fun checkLeaseOnBackgroundThread() {
    val leaseState = AdxietyClient.getLeaseStateAsync(context)
    if (leaseState.isActive) {
        val remainingDays = leaseState.remainingDays
        // Forward-compatible dynamic metadata envelope:
        val notice = leaseState.extras.getString("server_notice")
    }
}

// 3. Launch Renewal in Quarantined [ad]xiety App
// Reciprocal return: [ad]xiety seamlessly returns the user back to your app upon completion.
AdxietyClient.launchRenewal(context)

Use AdxietyClient.observeLease(context) to automatically update your Compose UI when a pass is extended:

import androidx.compose.runtime.Composable
import androidx.compose.runtime.collectAsState
import androidx.compose.runtime.getValue
import androidx.compose.ui.platform.LocalContext
import com.adxiety.client.AdxietyClient

@Composable
fun FeaturePassCard() {
    val context = LocalContext.current
    val leaseState by AdxietyClient.observeLease(context)
        .collectAsState(initial = AdxietyClient.getLeaseState(context))

    if (leaseState.isActive) {
        Card {
            Text("Feature Unlocked")
            Text(leaseState.formattedRemaining) // e.g. "6 days remaining"
        }
    } else {
        Button(onClick = { AdxietyClient.launchRenewal(context) }) {
            Text("Unlock for Free with [ad]xiety")
        }
    }
}