Android

[android/1.1.1] — 2026-06-25

Artifact: cx.swan:swan-android-sdk:1.1.1 on Maven Central Min SDK: 21 (Android 5.0) · Target/Compile SDK: 34 · Kotlin: 2.0.21 · AGP: 8.7

Changed

Device registration resolves the device identifier more robustly. The SDK now reliably obtains the device identifier when registering, so the identifier is consistently available for events and attribution.

[android/1.1.0] — 2026-06-19

Artifact: cx.swan:swan-android-sdk:1.1.0 on Maven Central Min SDK: 21 (Android 5.0) · Target/Compile SDK: 34 · Kotlin: 2.0.21 · AGP: 8.7

Fixed

Swan.login() now triggers the full backend pipeline. Previously a login() call suppressed the backend's downstream side-effects (cart, journey, and messaging triggers) in the same way identify() does. login() now runs the complete pipeline, so logging a user in fires those side-effects as expected. identify() is unchanged and continues to switch the profile without those side-effects.
Carousel notification text is now readable on dark notification shades. Carousel push notifications previously used hardcoded dark text that became unreadable when the OS drew the notification shade in dark mode; the text now adapts to the light or dark shade.
Logging out now starts a fresh anonymous identity. When a user who first used the app anonymously and later signed in subsequently logs out, the SDK begins a new anonymous identity instead of reusing the one that had been merged into their account on sign-in. This prevents activity after logout from being attributed to the signed-out user.

[android/1.0.0] — 2026-05-16

First production release of the Swan Android SDK.

Artifact: cx.swan:swan-android-sdk:1.0.0 on Maven Central Min SDK: 21 (Android 5.0) · Target/Compile SDK: 34 · Kotlin: 2.0.21 · AGP: 8.7

Added

Core identity — Swan.init, Swan.identify, Swan.login, Swan.logout, Swan.enrichProfile, Swan.getSwanIdentifier, Swan.getDeviceInfo. Anonymous-to-identified profile merge on the backend.
Event tracking — SwanEvents.screen, Swan.customEvent, Swan.track, super-properties (setCountry / setCurrency / setBusinessUnit / setCurrentScreenName), session tracking with 20-minute inactivity rollover, offline-first SQLite-backed queue with exponential-backoff retry.
E-commerce events — typed helpers covering productViewed, productAddedToAddTocart, productAddedToWishlist, checkoutStarted, checkoutCompleted, orderCompleted, search, categoryViewedPage, and the rest of the catalog (see the Track events guide).
Push notifications (FCM) — SwanMessagingService FCM subclass, token registration and rotation, basic + carousel (manual + auto) notification templates, 5 predefined notification channels (swan_transactional, swan_alerts, swan_promotional, swan_general, swan_notifications), custom-sound channel support via Swan.createNotificationChannel(soundResName=...), badge count, foreground / cold-start notification routing, click acknowledgement.
Deep linking — Swan.handleDeepLink(url) for external URLs, Swan.handleNotificationIntent(intent) for cold-start, Swan.handleNotificationTap(data) for warm-start, listener model via Swan.addNotificationOpenedListener + Swan.addDeepLinkOpenedListener, 30-second deduplication on messageId.
Permissions — Swan.requestNotificationPermission() (suspending), Swan.hasNotificationPermission(), Swan.isPushEnabled(), graceful POST_NOTIFICATIONS-denied handling on Android 13+.
Location — Swan.updateLocation(lat, lng, accuracy?), Swan.isLocationEnabled(). Host app supplies coordinates; the SDK does not acquire location itself.
Lifecycle listeners — addInitializedListener, addDeviceRegisteredListener, addDeviceRegistrationFailedListener, addSwanIdentifierChangedListener, addNetworkStateChangedListener, addPushTokenRegisteredListener, addPushTokenRegistrationFailedListener, addPushNotificationReceivedListener, addPushTokenRefreshListener, addNotificationOpenedListener, addDeepLinkOpenedListener, addPushLifecycleListener.
Log markers — six [SwanSDK] * log lines emit at key lifecycle points (init start, init done, device registered, foreground push received, notification displayed, notification ACK queued) for integration verification.