Skip to main content
This document tracks changes in Android Headless Lite SDK releases and their feature parity with the corresponding Android Headless SDK versions. Lite SDK is a trimmed-down variant of the full Headless SDK, optimized for smaller AAR size, while retaining core stability, security fixes, and phone-auth critical flows.

Scope of Lite SDK

Included

  • Core phone-number authentication flows
  • SNA (Silent Network Authentication), OTP (WhatsApp/SMS/RCS)
  • Security / stability fixes from the corresponding Headless SDK base

Excluded (by design)

  • Passkey flows
  • Google / Facebook integrations
  • Non-essential intent-based models and APIs not required for Lite phone-auth usecase

Version Mapping (Lite → Full SDK)

Lite SDK VersionBased on Headless SDKNotes
0.0.10.2.7Initial Lite fork, removed non-essential auth methods
0.0.20.2.8Bugfix parity
0.0.30.2.9Bugfix parity
0.0.40.3.4Fraud control + SNA improvements
0.0.50.3.6SNA improvements
0.0.60.3.7Internal API contract updates
0.0.7Airtel + new Vi SNA support, SIM improvements
1.0.1Major footprint reduction + API simplification
Note: Versions 0.0.7 and 1.0.1 include changes not strictly tied to a single full SDK version tag (internal contract / refactor + size optimization work).

Release Notes

v1.0.1
January 8, 2026

Changed

  • Enabled library minification (minifyEnabled true) and enhanced Proguard/consumer rules.
  • Simplified the public API by removing unnecessary parameters not required for the phone-auth use case.

Simplified OtplessRequest

  • Removed AuthenticationMedium, locale support, and libphonenumber validation.
  • Phone validation is now lightweight digit/length based (E.164-ish 8–15 digits).
  • Request JSON generation simplified (phone-number-only path).

Refactors / dependency trimming

  • Refactored code to reduce footprint and improve SDK size.
  • Trimmed dependencies: removed appcompat, chucker, googleid (credential manager), libphonenumber.
  • Converted model classes from data class → class and added explicit @SerializedName mappings.
  • Added consumer Proguard rules for Retrofit + Gson reflection safety.
  • Added library Proguard rules:
    • -dontobfuscate to reduce collision risks when consumers merge multiple obfuscated SDKs
    • Keeps public entrypoints and DTOs stable
    • Keeps network model constructors for Gson

Impact

  • Major SDK size reduction.
v0.0.7
January 6, 2026

Changed

  • Added support for Airtel and the new Vi SNA endpoint.
  • Expanded network security config allowlist to include:
    • in-vil.ipification.com
    • api-csp.airtel.in
  • Improved SIM detail logic to use the data-SIM TelephonyManager when available.
  • Replaced okhttp3.internal.toImmutableMap with Utility.toImmutableMap.
v0.0.6
November 21, 2025

Based on

  • android-headless-sdk: 0.3.7

Changed

  • Updated internal API contract.
v0.0.5
November 17, 2025

Based on

  • android-headless-sdk: 0.3.6

Changed

  • Improved SNA flow.
v0.0.4
August 12, 2025

Based on

  • android-headless-sdk: 0.3.4

Changed

  • Fixed immutability-related issues.
  • Added enhanced fraud control changes.
  • Improved SNA flow.
v0.0.3
June 16, 2025

Based on

  • android-headless-sdk: 0.2.9

Changed

  • Incorporated bug fixes from Headless SDK 0.2.9.
v0.0.2
June 9, 2025

Based on

  • android-headless-sdk: 0.2.8

Changed

  • Incorporated bug fixes from Headless SDK 0.2.8.
v0.0.1
May 30, 2025

Based on

  • android-headless-sdk: 0.2.7

Changed

  • Removed Passkey, Google, and Facebook SDK integrations.
  • Removed intent-based data classes.
  • Removed APIs related to Passkey / Google / Facebook auth methods.

Impact

  • Reduced SDK size by ~200 KB.
  • Focused Lite SDK on essential authentication flows only.

Size History (AAR)

Lite SDK VersionSize (bytes)Size (MB)
0.0.1272,8070.2602
0.0.2272,8810.2602
0.0.3290,9120.2774
0.0.4292,6210.2791
0.0.5290,9350.2775
0.0.6293,1750.2796
0.0.7294,3870.2807
1.0.1171,9630.1640

Lite vs Full SDK size comparison

This section compares Lite SDK sizes to the corresponding Full Android Headless SDK version that each Lite release is based on.
Note: Lite 0.0.7 and 1.0.1 are intentionally excluded here because they do not map directly to a single Full SDK version.
Lite SDK VersionBased on Full SDKLite size (bytes)Full size (bytes)Saved (bytes)Saved (%)
0.0.10.2.7272,807449,882177,07539.4
0.0.20.2.8272,881449,955177,07439.4
0.0.30.2.9290,912466,775175,86337.7
0.0.40.3.4292,621473,064180,44338.1
0.0.50.3.6290,935475,839184,90438.9
0.0.60.3.7293,175476,451183,27638.5