Installation

The Android SDK ships as a Kotlin AAR (com.widas.sdk).

Requirements

• Android 11 (API 30) or later minSdk
• compileSdk 35 (build-tools 35.0.0)
• JDK 17
• Google Play Services on the device (Play Integrity needs it at runtime)

Add the library

Maven dependency (when published)

If Wi-DAS publishes the SDK to a Maven repository, add the repository and coordinate to your module's build.gradle.kts:

dependencies {
    implementation("com.widas.sdk:widas:0.1.0") // version supplied by Wi-DAS
}

Local AAR

Otherwise, drop the released widas-release.aar into your app's libs/ folder and reference it. A bare AAR doesn't pull in its own runtime dependencies, so declare those too:

dependencies {
    implementation(files("libs/widas-release.aar"))

    implementation("com.google.android.play:integrity:<version>")
    implementation("com.google.android.gms:play-services-base:<version>")
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:<version>")
    implementation("com.squareup.okhttp3:okhttp:<version>")
}

Check with your Wi-DAS contact which channel to use. Go with the Maven coordinate if it's on offer, since it resolves the SDK's transitive dependencies (Play Integrity, Play Services base, coroutines, OkHttp, Bouncy Castle) for you and saves the manual list above.

Minimum SDK

Set your module's minSdk to at least 30:

android {
    defaultConfig {
        minSdk = 30
    }
}

Passpoint and the attestation floor both need Android 11 or later.

Import

import com.widas.sdk.WiDAS
import com.widas.sdk.WiDASException

Fetching it isn't the same as being able to use it

Holding the AAR grants no access. Issuance is gated by Play Integrity and your registration with Wi-DAS. An unregistered app that calls connect() gets AttestationRejected / EntitlementMissing back. Work through Setup first.

Next: Setup.