Android SDK overview

widas-sdk-android is a native Kotlin library (AAR) that adds Wi-DAS Passpoint onboarding to your app. A small WiDAS facade gets a signed client certificate and installs a Passpoint profile. You call four verbs; everything else is internal.

At a glance

Distribution	Kotlin AAR (com.widas.sdk)
Minimum OS	Android 11 (API 30)
Language	Kotlin (coroutines / suspend)
Attestation	Play Integrity
Passpoint install	WifiManager
Telemetry	None

The public surface

import com.widas.sdk.WiDAS

// Configure once — ships no secret; partnerId is a public identifier.
val widas = WiDAS.configure(
    context = context,
    partnerId = "partner-acme",
    baseUrl = "https://partner-api.wi-das.com/",
    cloudProjectNumber = 123456789L, // your Google Cloud project number
)

// Onboard the user. suspend, so call from a coroutine.
val result = widas.connect(user = "user-42", requestedValidity = "P365D")

// Advisory status — never throws.
val status = widas.status()   // NONE | VALID | EXPIRED | REVOKED

// Remove the installed profile.
widas.disconnect()

connect(), status(), and disconnect() are suspend functions, so call them from a coroutine.

The four verbs

Verb	What it does
WiDAS.configure(context, partnerId, baseUrl, cloudProjectNumber?)	Configures the SDK. Ships no secret; partnerId is public.
connect(user, requestedValidity?)	Onboards the user. Idempotent — call it every launch.
status()	Advisory certificate status. Never throws.
disconnect()	Removes the installed Passpoint profile.

Next steps

1. Installation — add the library.
2. Setup — permissions, Play Integrity, your Cloud project number, and the Play App Signing trap.
3. Usage — wiring the four verbs into your app.
4. Error handling — the WiDASException types and what to do about each.