> For the complete documentation index, see [llms.txt](https://docs.luciq.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.luciq.ai/changelog/android-sdk.md).

# Android SDK

Version history and release notes for the Luciq Android SDK. Track new features, enhancements, fixes, and breaking changes in each published release.

{% updates format="full" %}
{% update date="2026-11-13" %}

## v19.16.0

#### New Features

* Adds `exception` and `failureName` to `NetworkLogSnapshot`. A `NetworkLogListener` can read the exception behind a client-side network failure and record the failure under another name, for example when an interceptor added after Luciq's wraps the original failure.

#### Enhancements

* Jetpack Compose tap steps in User Steps and Session Replay now name the `@Composable` function the tapped element is called from, as Repro Steps already do, for apps that use the Luciq Compiler Extension or `Modifier.luciqTrackingInfo`.
* Scrolls and swipes that end without a fling (a drag that stops before the finger lifts) are now recorded as user steps and captured in Video-Like Replay interactions mode.

#### Bug Fixes

* Fixes APM recording a 4xx or 5xx `HttpURLConnection` response as a client-side `FileNotFoundException` when the app reads the body with `getInputStream()` or `getContent()` without reading the response code first. APM now records it as its HTTP status, so on affected endpoints client-side failures decrease and 4xx/5xx responses increase.
* Fixes a `NetworkLogListener` receiving an `HttpURLConnection` request that calls `connect()` explicitly before the request completed, with no response code and no failure. The listener now receives it once its outcome is known. As a result, APM no longer records a request whose app calls `connect()`, then reads only response headers other than `getContentLength()`, and never calls `disconnect()`.
* Fixes `keepScreenNames` not applying to Jetpack Compose tap steps in Repro Steps and Session Replay, which still named the screen by its obfuscated Activity class.
* Fixes Jetpack Compose tap steps reading only "Composable" instead of a button's text or an icon's content description. Text from private or masked Composables is still never captured, nor from a `ComposeView` that is private or sits inside a private View.
* Fixes `Modifier.testTag` missing from Jetpack Compose tap steps in release builds minified with R8 on Compose 1.7 and later.
* Fixes sessions reporting the previous launch's user attributes when attributes are set shortly after SDK initialization or the app is killed in the foreground.
* Fixes Jetpack Compose tap labels and scroll/swipe steps degrading for the rest of the session, and a tap step or bug-report screenshot being dropped, when an app's `Modifier.semantics {}` block throws. That Composable is now treated as private.
  {% endupdate %}

{% update date="2026-11-05" %}

## v19.15.1

#### Enhancements

* \[Internal] Improves internal monitoring tools.

#### Bug Fixes

* Fixes App Flows started right after SDK initialization on a fresh install being rejected until the SDK received its first configuration from the server.
* Fixes sessions including user events logged in earlier sessions of the same app launch. Each session now includes only the user events logged since it started.
  {% endupdate %}

{% update date="2026-10-29" %}

## v19.15.0

#### New Features

* Adds detection of app terminations by Android 17's memory limiter, which kills an app that exceeds its system-enforced memory limit. They are reported as "Android Memory Limit Exceeded" under Memory terminations, with no stack trace. Requires Android 17 and is off by default. Adds `IssueType.MemoryLimitTermination` for Repro Steps configuration: until you set its mode, it follows `IssueType.ForceRestart`. `IssueType.AllCrashes` now includes it.
* Adds `CrashReporting.onTaskRemoved()`. Call it from `onTaskRemoved` of the service that keeps your process running, typically a foreground service. Without it, swiping the app away from recents doesn't kill the process, so the SDK can't detect the resulting force restart. It has no effect when App Terminations reporting is disabled.
* Adds `response_index` to each multiple-choice response in the survey `OnFinishCallback` payload: the index of the selected option, or `-1` otherwise.

#### Enhancements

* Improves IDE support for the public API: parameter names now show as named arguments in Kotlin and as parameter hints in Java.
* \[Internal] Improves the SDK's internal architecture.

#### Bug Fixes

* Fixes missing scroll and swipe Repro Steps on Jetpack Compose 1.7+ screens.
* Fixes a thread-pool deadlock on devices with fewer than 4 CPU cores that could stall the SDK and leak Activities and Fragments.
  {% endupdate %}

{% update date="2026-10-27" %}

## v19.14.1

#### Bug Fixes

* Fixes `keepScreenNames` reporting obfuscated screen names in apps protected by obfuscators that rewrite class-name strings, such as Appdome, DexGuard, or R8 with `-adaptclassstrings`. Update both the Luciq SDK and the Gradle plugin to get the fix.
  {% endupdate %}

{% update date="2026-10-12" %}

## v19.14.0

#### New Features

* Adds `Luciq.setOnBeforeSendHandler` and `Luciq.Builder.setOnBeforeSendHandler`, a hook invoked before each bug report and crash report is sent, to add tags, user attributes, user data and file attachments to it. Crash reports include non-fatal errors, ANRs and fatal hangs; the hook doesn't run for NDK crashes, surveys, feature requests or chat replies. It replaces `Luciq.onReportSubmitHandler`. Prefer the Builder method: it is in place from the first report, including a crash from the previous app launch, which a handler set later at runtime cannot see.
* Adds `Luciq.removeTags` to remove tags added with `Luciq.addTags`.
* Adds `Luciq.addOnNetworkTraceListener` and `Luciq.removeOnNetworkTraceListener` to attach custom attributes to captured network traces. They replace the APM-scoped `APM.addOnNetworkTraceListener` and `APM.removeOnNetworkTraceListener`.
* Adds `Luciq.Builder.setNetworkLogListener` and `Luciq.Builder.setNetworkLogBodyEnabled` to set the network log listener and body capture from the first captured network log. They stay in place after `Luciq.disable()` and `Luciq.enable()`.

#### Enhancements

* The Luciq Gradle plugin and SDK versions must match. When the plugin is newer than the SDK, it now skips the instrumentation that SDK does not support and logs a build warning, instead of producing an app that crashes or a release build that fails R8.
* \[Internal] Improves internal monitoring tools

#### Deprecations

* Deprecates `Luciq.onReportSubmitHandler` in favor of `Luciq.setOnBeforeSendHandler`.
* Deprecates `Luciq.getTags()` with no replacement, and it may return an empty list. Your tags are still attached to reports; to read them back, keep your own copy of the tags you add with `Luciq.addTags`.
* Deprecates `APM.addOnNetworkTraceListener` and `APM.removeOnNetworkTraceListener` in favor of `Luciq.addOnNetworkTraceListener` and `Luciq.removeOnNetworkTraceListener`. The replacements take the `ai.luciq.core.networklogs.contract.OnNetworkTraceListener` type, so migrating means changing the listener import and the trace type the callback receives.
* Deprecates `LuciqLog.getLogs()` and `LuciqLog.clearLogs()`.
* Deprecates `CrashReporting.setOnCrashSentCallback` with no replacement. Don't rely on it to confirm that a crash report was sent.
* Deprecates `CrashReporting.setUserIdentificationState` with no replacement. It removed the user's name and email (set with `Luciq.identifyUser`) from crash reports only: the same details are still sent with session data. To keep a user's name and email out of Luciq, don't pass them to `Luciq.identifyUser`.
* Deprecates auto screen recording: `BugReporting.setAutoScreenRecordingEnabled` and `CrashReporting.deleteAutoScreenRecording`. To see what users did before a report, use Session Replay (<https://docs.luciq.ai/android/set-up-luciq-for-android/set-up-session-replay>). To let users attach a screen recording to a bug report, enable the screen recording attachment type through `BugReporting.setAttachmentTypesEnabled`.
* `LuciqOkhttpInterceptor` has been deprecated since 19.0.0. We recommend migrating to automatic network interception with the Luciq Gradle plugin: <https://docs.luciq.ai/android/set-up-luciq-for-android/logs-and-profiling/unified-network-interception>
* `LuciqAPMOkhttpInterceptor` and `LuciqAPMGrpcInterceptor` are deprecated. We recommend migrating to automatic network interception with the Luciq Gradle plugin for OkHttp (<https://docs.luciq.ai/android/set-up-luciq-for-android/logs-and-profiling/unified-network-interception>), and to `LuciqGrpcInterceptor` for gRPC.

#### Bug Fixes

* Fixes host app builds failing on Android Gradle Plugin 9 with a duplicate `androidx.vectordrawable` namespace error. The SDK now requires `androidx.vectordrawable:vectordrawable-animated` 1.1.0 or above, so apps that pinned it manually to work around the failure can drop the pin.
  {% endupdate %}

{% update date="2026-10-07" %}

## v19.13.1

#### Bug Fixes

* Fixes a crash in the Jetpack Compose draw pass (`LayoutNode.ZComparator` NullPointerException) caused by the screenshot masking hierarchy walk reading the Compose node tree off the main thread; also fixes Session Replay screenshots being dropped on scrolled `LazyColumn` screens.
  {% endupdate %}

{% update date="2026-10-01" %}

## v19.13.0

#### New Features

* Adds `keepScreenNames` to the Gradle plugin, which preserves the original Activity and Fragment names in APM traces, screen loading and rendering, crash and ANR reports, Repro Steps, Session Replay and bug reports. Intended for apps built with a class-renaming obfuscator such as DexGuard or Appdome, where screen names would otherwise be unreadable and change on every release. Requires the `luciq` plugin id and is disabled by default.

```groovy
plugins {
    id 'luciq'
}

luciq {
    keepScreenNames = true
}
```

* Adds customizable success messages for bug reports, feedback, questions, and proactive reports.

```kotlin
import ai.luciq.library.Luciq
import ai.luciq.library.LuciqCustomTextPlaceHolder
import ai.luciq.library.LuciqCustomTextPlaceHolder.Key

val placeHolders = LuciqCustomTextPlaceHolder().apply {
    set(Key.BUG_REPORT_SUCCESSFULLY_SENT, "Bug sent!")
    set(Key.FEEDBACK_REPORT_SUCCESSFULLY_SENT, "Thanks!")
    set(Key.QUESTION_REPORT_SUCCESSFULLY_SENT, "On it!")
    set(
        Key.PROACTIVE_BUG_REPORT_SUCCESSFULLY_SENT,
        "Thanks for reporting!"
    )
}
Luciq.setCustomTextPlaceHolders(placeHolders)
```

* Adds APIs to retrieve configured custom text placeholders with live and snapshot access.
* Adds the experimental `Surveys.disableFrequencyEvaluationInDebugBuilds()` API to show surveys every time their targeting conditions are met, ignoring the configured frequency, on debuggable builds only. The call is ignored on release builds.

#### Enhancements

* Changes App Flows to be enabled by default on fresh installs until the feature configuration is received from the backend.
* Fragment spans are now recorded in apps that do not apply the Gradle plugin, instead of being dropped. The non-fatal those apps used to get once per fragment is now reported at most once per process.

#### Deprecations

* Deprecates the View Hierarchy APIs `BugReporting.setViewHierarchyState` and `Luciq.Builder.setViewHierarchyState`. The feature is discontinued, these APIs no longer have any effect, and they will be removed in an upcoming major release. There is no replacement.

#### Bug Fixes

* Fixes an issue where fully failed GraphQL requests returning an HTTP 2xx status were incorrectly marked as partially successful.
* Fixes an issue where the crash reporting cache could grow without limit in apps that are mostly launched in the background.
* Fixes App Rating surveys showing the Yes/No and rate-us questions as text inputs after the user selects "No", which also caused the survey responses to be recorded incorrectly.
* Fixes the module name reported for cross-platform screen loading traces, which named the SDK's own package instead of the current Activity's.
* Fixes a SQL injection finding reported by security scanners: the SDK's database migration now only removes tables with standard names.
* Fixes a path manipulation finding reported by security scanners: photos and videos attached from the gallery in bug reports and chats can no longer be read from, or saved to, locations outside the SDK's own attachment folders.
  {% endupdate %}

{% update date="2026-09-16" %}

## v19.12.1

#### Bug Fixes

* Fixes manually logged network requests not appearing in APM.
  {% endupdate %}

{% update date="2026-09-02" %}

## v19.12.0

#### New Features

* Adds render-aware screenshot capture, keeping private and auto-masked views accurately covered even when a layout or draw pass happens during capture. Applies to bug report screenshots, Repro Steps, and Session Replay. Disabled by default — enable and tune it at app startup.

```kotlin
Luciq.setRenderAwareScreenshotCapturingEnabled(true)
Luciq.setScreenshotCapturingMaxRetries(3)
Luciq.setScreenshotCapturingRetryDelay(200)
```

#### Enhancements

* Keeps the SDK running on emulators instead of pausing it on low virtual storage or memory, and no longer classifies emulators as low-performance devices.
* \[Internal] Enhances SDK internal analytics

#### Bug Fixes

* Fixes mandatory version update announcements being dismissed after tapping "Update Now" even when the app was not updated, letting users continue into the app.
* Fixes Repro Steps recording nested fragment screens out of order, where a child screen could be logged before the parent screens that contain it.
  {% endupdate %}

{% update date="2026-08-19" %}

## v19.11.0

#### New Features

* Extends theme support to In-App Surveys and Announcements, applying the same colors, fonts, and light/dark mode already used in Bug Reporting.

#### Enhancements

* Adds support for Android 17 (API 37).
* Adds support for Jetpack Compose BOM 2026.06.01 (Compose 1.11.4).
* Improves text contrast in the bug reporting screen to meet WCAG AA.

#### Bug Fixes

* Fixes text fields not being identified as input fields in User Steps and Repro Steps on Compose 1.8.0 and above.
* Fixes the Surveys dialog showing at the wrong size after rotating the device.
* Fixes screen reader announcements for consent checkboxes in the bug reporting screen.
* Fixes an issue where surveys could fail to be fetched in some configurations.
  {% endupdate %}

{% update date="2026-08-05" %}

## v19.10.1

#### Enhancements

* Adds a read-only `isCanceled` property to `NetworkLogSnapshot`, letting apps identify and optionally drop cancelled network requests via the network log listener.

```kotlin
Luciq.setNetworkLogListener { networkLog ->
    if (networkLog.isCanceled) null else networkLog
}
```

* Reduces disk writes when the SDK applies configuration updates.
* Reduces the overhead of APM screen rendering monitoring and releases its resources when the feature is disabled.
* Reduces Session Replay CPU usage.

#### Bug Fixes

* Fixes the screenshot, floating and screen-recording buttons being hidden behind bottom sheets and dialogs.
  {% endupdate %}

{% update date="2026-07-22" %}

## v19.10.0

#### Features

* Adds screen rendering metrics support for Jetpack Compose screens in APM.

#### Enhancements

* Resolves a security warning by replacing dynamically built SQL statements with parameterized queries in the SDK's internal storage.
* Improves user event identifier validation: identifiers are now trimmed, sanitized against control characters, and capped at 200 characters.
  {% endupdate %}

{% update date="2026-07-13" %}

## v19.9.2

#### Enhancements

* Improves the reliability of WebView network monitoring so it stays fully transparent to the page's own fetch / XMLHttpRequest requests.
  {% endupdate %}

{% update date="2026-06-29" %}

## v19.9.1

#### Enhancements

* \[Internal] Enhances SDK internal analytics
  {% endupdate %}

{% update date="2026-06-28" %}

## v19.9.0

#### Enhancements

* Flags GraphQL network logs as partial success when a request returns an HTTP 2xx response that still contains a non-empty `errors` array — catching GraphQL calls that look successful but partially failed. Flagged logs are marked with a **Partial success** badge in Bug Reports, Session Replay, and Crashes.
* Improves SDK network efficiency.
  {% endupdate %}

{% update date="2026-06-09" %}

## v19.8.0

#### Features

* Added the ability to start a new session on logout so each user identity gets an isolated session, ensuring activity is attributed to the correct user. This is disabled by default — reach out to customer support team to enable it.

#### Bug Fixes

* Fixes a rare ANR that could occur at crash time due to a lock-ordering deadlock while a session was being ended.
* Fixes SDK diagnostic events — including network and Session Replay logs — being silently dropped on obfuscated (release) builds.
* Fixes an empty (0-byte) `luciq_config.json` bundled in the SDK that could break post-build security / app-shielding tools.
  {% endupdate %}

{% update date="2026-06-03" %}

## v19.7.1

#### Features

* Adds the `setCapturingContainerEnabled` API to control whether container screens (Activities, Fragments, and DialogFragments) generate Repro Steps screenshots.

#### Bug Fixes

* Fixes a rare crash during screenshot capture when an Activity is being destroyed.
  {% endupdate %}

{% update date="2026-05-13" %}

## v19.7.0

#### Features

* Adds the `setViewsContentCaptureEnabled` API to redact User Steps and Repro Steps content.
* Adds support for `params` in user events.
* Adds a Gradle configuration to automatically capture Jetpack Compose screens as `APM` screens.

```kotlin
luciq {
  showAutoComposableAsScreen = true
}
```

#### Enhancements

* Adds support for per-variant Luciq app tokens in the `luciq-crash` Gradle plugin.
* Optimizes console log lock contention that could block the main thread and cause ANRs.

#### Bug Fixes

* Fixes an ANR caused by thread-safety race in `OkHttp` network logging under concurrent traffic.
* Fixes data capture in the `inapp_webview` plugin by instrumenting `WebView` subclasses.
* Fixes OOM crashes in long background sessions by applying backoff on sync failure.
  {% endupdate %}

{% update date="2026-04-29" %}

## v19.6.0

#### New Features

* Track user actions in React Native `WebView`s
* Support Screen Loading For React Native

#### Enhancements

* Improve Accessibility in Bug Reporting screen

#### Bug Fixes

* Fix host app crashes caused by `RxJava UndeliverableException`
* Fix deadlock between the `APM` `ServiceLocator.class` monitor and Kotlin `lazy` internal locks which causes ANR in Flutter apps.
* Fix memory leak in screen rendering caused by an unbounded per-instance map and prevent `Window`/`Activity` retention
  {% endupdate %}

{% update date="2026-04-19" %}

## v19.5.1

#### Bug Fixes

* Fixes an ANR that could occur when non-HTTP URL connections, such as `classpath` resource loading via Kotlin reflection, were being intercepted by the network monitor.
* Fixes an ANR that could occur when using the `OkHttp` network interceptor due to concurrent access from multiple threads during a network call.
  {% endupdate %}

{% update date="2026-04-15" %}

## v19.5.0

#### New Features

* Adds support for branching in Custom Surveys.
* Adds NDK symbol upload Gradle task for automated symbol file (`.so`) upload during the build process.

```kotlin
luciq {
   crashReporting {
       appToken = "APP_TOKEN"
       ndkSymbol {
           autoUploadEnabled = true
           apiKey = "API_KEY"
       }
   }
}
```

#### Enhancements

* Adds support for excluding custom URL patterns from `OkHttp` response body capture.

```kotlin
luciq {
   networkInterception {
       enabled = true
       excludeUrlPatterns = listOf(
           ".*chat/stream.*",
           ".*/events.*",
           ".*/notifications/live.*"
       )
       okHttp {
           it.enabled = true
       }
   }
}
```

#### Bug Fixes

* Fixes `OkHttp` interceptor breaking streaming/chunked HTTP responses (`SSE`/`event-stream`) by skipping response body buffering for streaming content types.
  {% endupdate %}

{% update date="2026-04-29" %}

## v19.4.1

#### Bug Fixes

* Fix host app crashes caused by `RxJava UndeliverableException`
* Fix memory leak in screen rendering caused by an unbounded per-instance map and prevent `Window`/`Activity` retention
  {% endupdate %}

{% update date="2026-04-01" %}

## v19.4.0

#### Features & Enhancements

* Adds satellite network type detection for Session Profiler and `APM` network logs, providing better visibility into network connectivity.
* Adds Multi-window support in Surveys and Announcements.
* Adds support for `Compose BOM` version `2026.03.00` (`Compose 1.10.5`).
* Improved internal SDK logging and error handling to reduce noise.
  {% endupdate %}

{% update date="2026-03-07" %}

## v19.3.0

#### Features

* Custom Spans in `APM`: Adds support for `CustomSpan` tracking with explicit start and end times.

```kotlin
// Start a custom span, do the work, then end it
val span: CustomSpan? = APM.startCustomSpan("checkout")
// ... do work ...
span?.end()

// Or record a span with known start and end dates
APM.addCompletedCustomSpan("checkout", startDate, endDate)
```

#### Enhancements

* Adds default masking for `WebView` content to enhance privacy protection.
* Reduces unnecessary error log output when reporting non-fatal exceptions.
* Changes the ADB debug property key from `debug.instabug.apm.app` to `debug.luciq.app`. The old property is still supported as a fallback.

#### Bug Fixes

* Fixes an ANR caused by synchronous `SharedPreferences` access in the `APM` `ContentProvider` during app startup.
* Fixes an ANR caused by Firebase initialization deadlock when Firebase Performance SDK is enabled.
* Fixes a crash that occurs under certain conditions when invoking the SDK via the Floating Action Button.
* Fixes malformed JSON in crash reports when message content exceeds size limits.
* Fixes an issue where `ScreenRendering` traces were incorrectly attributed in specific scenarios.
* Fixes a crash in `Replies` UI that occurs under certain conditions when the screen is closed unexpectedly.
  {% endupdate %}

{% update date="2026-02-19" %}

## v19.2.2

#### Enhancements

* Adds `LogLevel.WARNING` log level for filtering SDK warning logs. This is now the default log level.
* Resolves a security warning by replacing raw SQL construction with parameterized queries in internal diagnostics storage.

#### Bug Fixes

* Fixes a build-time crash in the Gradle plugin when logging ASM bytecode transformations for certain `ClassVisitor` types.
* Fixes an issue where user steps data scraping captured incorrect view IDs for legacy views inside private scope containers.
* Fixes a crash that could occur when displaying chat messages with a null attachment type.
* Fixes potential null pointer exceptions in bug reporting UI when fragment views are accessed after destruction.
  {% endupdate %}

{% update date="2026-01-25" %}

## v19.2.1

#### Bug Fixes

* Fixes an issue where the bug report form could sometimes open twice after a single shake gesture.
* Fixes an issue where surveys and announcements being obscured by the system navigation bar on certain devices.
* Fixes an issue where canceled network requests being incorrectly logged as errors when using the `OkHttp` interceptor.
* Fixes a crash that could occur when accessing device storage on devices where external storage is temporarily unavailable.
* Fixes `NPE` error log that could occur during URL connection interception for certain URL types (`JAR`, `file` protocols).
  {% endupdate %}

{% update date="2026-01-13" %}

## v19.2.0

#### Features

* WebView Monitoring: Added comprehensive `WebView` monitoring to capture performance metrics, user interactions, and network requests from `WebView` components.
  * New API: `Luciq.setWebViewMonitoringEnabled(boolean)`
  * New API: `Luciq.setWebViewUserInteractionsTrackingEnabled(boolean)`
  * New API: `Luciq.setWebViewNetworkTrackingEnabled(boolean)`
  * New build configuration: `luciq { webViewsTrackingEnabled = true }`
* Notification Icon Color API: Introduces `Replies.setNotificationIconColor()` to customize the background color of notification icons.

```kotlin
Replies.setNotificationIconColor(Color.RED)
```

#### Enhancements

* Adds defensive validation to prevent sending corrupt app version data under certain conditions.

#### Bug Fixes

* Fixes a race condition that could cause duplicate chat sync network requests.
* Fixes an issue where proactive bug reporting does not trigger after user termination.
* Fixes a bug causing logs and attachments to go missing with NDK crash reports.
* Fixes `ProtectionLayout` appearing repeatedly on each interaction with `Composable`s when using `androidx.core:core-ktx` `v1.16.0+`.
* Fixes button text color in chats to ensure proper visibility.
* Fixes alert dialogs appearing with a white background in dark mode when using a custom theme.
  {% endupdate %}

{% update date="2025-12-26" %}

## v19.1.0

#### Features

* Session Replay Screenshot Quality Control: New API to adjust the visual quality of captured screenshots.

```kotlin
SessionReplay.setScreenshotQuality(ScreenshotQuality.NORMAL)
```

* Video-like Session Replay (Experimental): Capture screenshots based on user interactions or at fixed intervals for a video-like playback experience.

```kotlin
@OptIn(ExperimentalVideoLikeReplay::class)
fun configureVideoLikeSessionReplay() {
    SessionReplay.setCapturingMode(CapturingMode.FREQUENCY)
    SessionReplay.setScreenshotCaptureInterval(500)
}
```

#### Enhancements

* Feature Flags' keys and values limits are now server-side configurable.
* Introduces actionable user consents for Bug Reporting with a new `ActionType.NO_AUTOMATIC_BUG_GROUPING` action type.

```kotlin
BugReporting.addUserConsent(
    "grouping-consent",
    "Allow grouping similar bugs",
    false, true,
    ActionType.NO_AUTOMATIC_BUG_GROUPING
)
```

#### Bug Fixes

* Fixes a bug where keyboard open/close detection caused cyclic `onGlobalLayout` callbacks when adjusting the bottom sheet margin in Bug Reporting.
  {% endupdate %}

{% update date="2025-12-21" %}

## v19.0.1

#### Bug Fixes

* Fixes a critical incompatibility with Jetpack Compose `v1.9.0+` that could prevent exceptions and crashes from being propagated.
  {% endupdate %}

{% update date="2025-12-11" %}

## v19.0.0

#### Breaking Changes

* Introducing a new, single network interceptor with automatic instrumentation for `OkHttp` and native `UrlConnection`.

```kotlin
// Project-level build.gradle
plugins {
    id("ai.luciq.library") version "$luciqVersion" apply false
}
// app-level build.gradle
plugins {
    id("luciq")
}
luciq {
    networkInterception {
        enabled = true
    }
}
```

* Revamped `APM`'s `UI Hangs` with slow and frozen frames metric.

```kotlin
// Deprecated:
APM.setUIHangEnabled()
// Replace with:
APM.setScreenRenderingEnabled()
```

#### Bug Fixes

* Fixed a race condition causing `android.database.sqlite.SQLiteConstraintException` error to be logged under certain conditions.
  {% endupdate %}

{% update date="2025-11-26" %}

## v18.2.1

#### Enhancements

* Cleaned up and refined logging levels for non-critical events.

#### Bug Fixes

* Fixed incorrect UI translation when the device locale is set to Portuguese (Brazil) `pt_BR`.
* Fixed Out of Memory (OOM) issues during chat messages synchronization by optimizing memory allocation and resource management.
  {% endupdate %}

{% update date="2025-11-13" %}

## v18.2.0

#### Enhancements

* Added support for app variant targeting in Surveys and Announcements.

```kotlin
new Instabug.Builder(this, "APP_TOKEN")
    .setAppVariant("App1")
    .build();
```

* Increased character limit for disclaimer and consent fields in bug reporting to 200 chars.

#### Bug Fixes

* Fixed an issue that caused missing screenshots in Repro Steps for Flutter apps.
* Fixed an issue where the first UI trace wasn't inserted into the database, leading to `SqliteConstraintException` logs.
* Fixed an issue where a white box covered the bug description field on small-screen devices.
* Fixed a Disk Read `StrictMode` violation that occurred when attaching images from the gallery in Bug Reporting.
* Fixed an issue where `BugReporting.setDisclaimerText()` did not apply if called immediately after SDK initialization.
  {% endupdate %}

{% update date="2025-10-31" %}

## v18.1.0

#### Enhancements

* Adds test tags support for `Compose v1.7.+`
* Adds support for `Apollo v4`

#### Bug Fixes

* Fixes missing request and response headers in `NetworkLogSnapshot` when using `APM.registerNetworkLogsListener(listener)`.
* Fixes header changes done using `APM.registerNetworkLogsListener(listener)` not being applied to the captured network data.
* Fixes attributes added using `OnNetworkTraceListener.addAttributesOnFinish()` are not added in some cases.
  {% endupdate %}

{% update date="2025-10-10" %}

## v18.0.1

#### Enhancements

* Optimizes SDK's `UncaughtExceptionHandler` operations to prevent ANRs from occurring while the application is exiting (crashing).
* Mutes a few diagnostics logs to reduce noise in the `logcat`.

#### Bug Fixes

* Fixes an issue where features cache was being stored before features states were properly consumed, which could lead to inconsistent SDK behavior.
* Fixes an issue with email format validation causing malformed emails to be sent with crash reports.
* Fixes a crash (`ActivityNotFoundException`) encountered while attaching extra images to bug reports via Android's new photo picker on some devices.
* Fixes a race condition that causes chats synchronization request to get fired while chats being disabled with `Replies` APIs.
* Fixes an issue that causes interactions tracking for Jetpack Compose screens to yield inaccurate results when an overlay `Composable` is present.
  {% endupdate %}

{% update date="2025-09-23" %}

## v18.0.0

#### Breaking Changes

* SDK rebranded from Instabug to Luciq. To migrate, visit the migration guide for guidance.
  {% endupdate %}
  {% endupdates %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.luciq.ai/changelog/android-sdk.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
