--- title: Android API Reference & Changelog --- # Android SDK The Bitdrift Capture SDK offers developers a straightforward method to seamlessly integrate the Capture platform into their Android applications. !!! info The Android SDK requires a minimum API level of 23. This release page lists releases for the following libraries: - `capture` SDK: Refer to the [SDK integration guide](..//quickstart.md#installation) for more details. - `capture-timber`: Refer to the [Log Forwarding integration guide](../integrations.md#timber-android) for more details. - `capture-apollo`: Refer to the [GraphQL integration guide](../integrations.md#apollo-graphql) for more details. - `capture-plugin`: Refer to the [Gradle plugin network instrumentation guide](../integrations.md#auto-instrumentation-via-gradle-plugin) for more details. !!! tip It's strongly recommended that you keep the versions of all the bitdrift Capture libraries in sync. For instance, if your application uses Capture SDK version 0.9.115, you should also use `CaptureTimber` version 0.9.115. ## Releases The source code for this SDK is available on GitHub: [bitdriftlabs/capture-sdk](https://github.com/bitdriftlabs/capture-sdk) Starting with version [0.18.0](#0180) all the artifacts are also being published to maven central: [https://central.sonatype.com/namespace/io.bitdrift](https://central.sonatype.com/namespace/io.bitdrift){:target="_blank"}. ### Latest Version [Maven Central Version](https://central.sonatype.com/artifact/io.bitdrift/capture){:target="_blank"} [GitHub Release](https://github.com/bitdriftlabs/capture-sdk/releases){:target="_blank"} ### 0.22.16 *2026-04-27* {{ android_release_v4("0.22.16") }} Changelog: - Handle `trace` console messages in WebView bridge. - Hardened WebView bridge SDK against native crashes: added size limits to all strings crossing the native bridge (stack traces, error messages, console args, serialized JSON), bounded DOM traversal depth for user interaction detection, capped deduplication map sizes to prevent unbounded memory growth, and skipped `data:`/`blob:` URLs in network interception to avoid serializing large payloads. - Added an early exit in the event that injected JavaScript is present, but the native bridge is not properly set up (for example, missing `window.bitdrift.sendMessage` function). - Ensured that any `console.log` calls made within the injected JavaScript use the pristine un-instrumented console methods to avoid the potential for infinite recursion when console capture is active. - Added guards against potential `DataCloneError` exceptions when sending messages across the native bridge. ### 0.22.15 *2026-04-17* {{ android_release_v4("0.22.15") }} Changelog: - `Capture.Logger.screenView` now captures an up-to-date wireframe for Session Replay at the time of the call. - `Capture.Logger.getPreviousRunInfo()` now reports JVM crash terminations on API levels below 30. ### 0.22.14 *2026-04-13* {{ android_release_v4("0.22.14") }} Changelog: - Added experimental [distributed tracing support](../features/tracing.md) for network instrumentation with W3C (`traceparent`), B3 Single (`b3`), and B3 Multi (`X-B3-*`) propagation formats. - Native crash reports are now generated on API level 30 when tombstone data is unavailable. These reports include signal information but no stack traces. - Fixed an issue where 3rd-party dependencies like `androidx` were included in the released Javadoc artifacts. Also updated the style of `capture-timber` and `capture-apollo` javadocs to match. ### 0.22.13 *2026-03-26* {{ android_release_v4("0.22.13") }} Changelog: - Added experimental API to get detailed previous run information via `Capture.Logger.getPreviousRunInfo()`. - Added `manufacturer` OOTB field. ### 0.22.12 *2026-03-17* {{ android_release_v4("0.22.12") }} Changelog: - Added experimental issue report callback support so apps can receive issue metadata before a report is sent (`reportType`, `reason`, `details`, `sessionId`, and `fields`). ### 0.22.11 *2026-03-12* {{ android_release_v4("0.22.11") }} Changelog: - Log internal SDK error if we fail to process and persist other issue reports (e.g. Native Crash, ANRs, etc). ### 0.22.10 *2026-03-09* {{ android_release_v4("0.22.10") }} Changelog: - Fixed memory leak in `JankStatsMonitor` when activity is destroyed without `onPause` being called. - Fixed inaccurate calculation for `Battery Level Change Per Min`. ### 0.22.9 *2026-03-04* {{ android_release_v4("0.22.9") }} Changelog: - Added battery drain rate monitoring on resource utilization logs. - Added the `_page_url` field to WebVital events sent from the WebView bridge. - Return all performance timing entries for WebVital events instead of just the first. - Fixed OkHttp connection leak. ### 0.22.8 *2026-02-24* {{ android_release_v4("0.22.8") }} Changelog: - Log internal sdk error if we fail to process and persist a JVM crash report. - Bump `androidx.metrics:metrics-performance` dep to `1.0.0`. - io.bitdrift.capture-plugin: `automaticOkHttpInstrumentation` now defaults to `PROXY` mode instead of `OVERWRITE`, preserving any custom `EventListener.Factory` on the `OkHttpClient`. ### 0.22.7 *2026-02-12* {{ android_release_v4("0.22.7") }} Changelog: - io.bitdrift.capture-plugin: Fix concurrent `bdUpload` task execution with certain CI scenarios causing `OverlappingFileLockException`. ### 0.22.6 *2026-02-10* {{ android_release_v4("0.22.6") }} Changelog: - io.bitdrift.capture-plugin: Further improvements on `bdUpload` task. ### 0.22.5 *2026-02-05* {{ android_release_v4("0.22.5") }} Changelog: - io.bitdrift.capture-plugin: Harden bdUpload task for CI scenarios. ### 0.22.4 *2026-02-03* {{ android_release_v4("0.22.4") }} Changelog: - Fixes an issue causing certain workflows to not work across process restart. - Expose `baseDomain` Gradle plugin configuration for `bd` CLI uploads. - Added support for honoring `data-redacted` attributes on elements included in WebView user interaction events. - Fixed session replay skipping views with stale text layouts. - Fixed `Untagged socket detected` Strict Mode Violation. ### 0.22.3 *2026-01-27* {{ android_release_v4("0.22.3") }} Changelog: - Exclude `androidx.webkit:webkit` dependency from the generated pom. ### 0.22.2 *2026-01-27* {{ android_release_v4("0.22.2") }} Changelog: - Added experimental WebView integration support. See [WebView integration guide](../integrations.md#webview-android) for more details. - Updated `./gradlew bdUpload` from `io.bitdrift.capture-plugin` to handle automatic upload of sourcemap files. ### 0.22.1 *2026-01-20* {{ android_release_v4("0.22.1") }} Changelog: - License fixes: removed redundant NOTICE entry from POM and updated `LICENSE` content to PolyForm Shield. ### 0.22.0 *2026-01-13* {{ android_release_v4("0.22.0") }} Changelog: - Optimized internal field handling to reduce JVM object allocations. ### 0.21.2 *2025-12-18* {{ android_release_v4("0.21.2") }} Changelog: - Added support for workflow matching on feature flag state and transitions. - **BREAKING**: The `variant` parameter in `setFeatureFlagExposure` is now required instead of optional. - Added method overloads to accept `Boolean` values for the `variant` parameter in `setFeatureFlagExposure`, in addition to the existing `String` parameter. - Fixed an issue where multiple Logger instances could come up and conflict. Subsequent loggers will now noop. ### 0.21.1 *2025-12-12* {{ android_release_v4("0.21.1") }} Changelog: - Made `HttpRequestInfo` and `HttpResponseInfo` properties public so they can be used with the `Logger.log()` methods directly. - Fix NPE crash when using automatic OkHttp instrumentation via capture-plugin. ### 0.21.0 *2025-12-05* {{ android_release_v4("0.21.0") }} Changelog: - The experimental feature flag APIs have been redone and now only expose a single `setFeatureFlagExposure()` function instead of generic setters. - Add JVM memory usage percent as a reported OOTB field in Resource Utilization logs. - Improve accuracy of low memory detection in `MemoryMetricsProvider`. - Fix `NoSuchMethodError` runtime exception when consumers target newer versions of `androidx.compose.ui:ui`. ### 0.20.1 *2025-12-01* {{ android_release_v4("0.20.1") }} Changelog: - Removed `enableNativeCrashReporting` flag from `Configuration` object. From now on Native (NDK) crash reports will be included if `enableFatalIssueReporting` is set to true. Please note Native (NDK) crash detection still requires Android 12+ (API level 31 or higher). - Fixed a jni LocalReference leak that could crash the app when very large field maps or feature flags were sent to the logger. - Excluded `com.squareup.retrofit2:retrofit` dependency from the generated pom. - Fixed an issue where the session ID on AppExit logs would not match the previous process run session ID as expected. ### 0.20.0 *2025-11-21* {{ android_release_v4("0.20.0") }} Changelog: - Add `RetrofitUrlPathProvider` helper class to help extracting endpoint's url paths when using Retrofit services. - Simplify constructor of `CaptureOkHttpEventListenerFactory`. Remove usage of `(call: Call) -> EventListener)` in favor of `EventListener.Factory`. - Make `HttpField.PATH_TEMPLATE` constant public so consumers can override it using a custom `OkHttpRequestFieldProvider`. - Fix the rendering order and position of dialog and modal windows in Session Replay. ### 0.19.1 *2025-11-05* {{ android_release_v4("0.19.1") }} Changelog: - Improved ring buffer serialization format for more efficient space usage. - Add threshold compression for large message/fields. - Add support for custom fields in network responses. - Add API to clear all feature flags. - Rename `SleepMode` enum values: `ACTIVE` → `ENABLED`, `INACTIVE` → `DISABLED`. - Add back the ability to disable the Session Replay feature at SDK initialization. - Remove internal OkHttp reference. ### 0.19.0 *2025-10-27* {{ android_release_v4("0.19.0") }} Changelog: - First version to support free-tier plans for bitdrift. - Fix inaccurate frame symbolication in NDK some crash stacktraces. - Add ANR detection for "App Start ANR" and improv detection for "Service ANR". - Improve performance of Feature Flags writes. ### 0.18.12 *2025-10-21* {{ android_release_v4("0.18.12") }} Changelog: - Fix rare memory leak situation within slow rendering monitoring logic - Small performance optimization within session replay - Added support for feature flags ### 0.18.11 *2025-10-14* {{ android_release_v4("0.18.11") }} Changelog: - Set minSdk to 23 (priorly minSdk was 24) - Make android .aar build deterministic - Downgrade androidx.metrics.performance to 1.0.0-beta02 - Added support for live workflow debugging - Reuse OkHttpClient instance - Gradle sample app UI Revamp ### 0.18.10 *2025-10-09* {{ android_release_v4("0.18.10") }} Changelog: - Binary size reduction by enabling full LTO in Rust builds. - Fix crash forwarding in `CaptureUncaughtExceptionHandler` and improve throwable root-cause detection. - Avoid creating `CaptureOkHttpEventListener` when the SDK is not initialized. - Stability improvements in the native layer. ### 0.18.9 *2025-10-03* {{ android_release_v4("0.18.9") }} Changelog: - Added performance optimizations (reducing map allocations and preventing unnecessary binder calls) - Fixed a bug that resulted in the network icon not displaying correct state upon connectivity loss and recovery - Bumped androidx.metrics:metrics-performance dep to 1.0.0-beta04 - ANR parsing improvements - Fixed missing thread name - Added device code creation for debug builds - Improved crash logs with crash-time metadata snapshots ### 0.18.8 *2025-09-09* {{ android_release_v4("0.18.8") }} Changelog: - Include `androidx.appcompat:appcompat` and `org.jetbrains.kotlin:kotlin-stdlib` as dependencies in the published POM that were accidentally omitted in the 0.18.6 release. ### 0.18.7 *2025-09-04* {{ android_release_v4("0.18.7") }} Changelog: - **Fatal crash reporting is now enabled by default** - can be turned off via configuration. For more details, refer to the [setup page](../features/fatal-issues.md#setup) - Improved rate limiting with better backoff strategies - Improved symbol extraction and debugging capabilities - Various bug fixes and performance improvements ### 0.18.6 *2025-08-25* {{ android_release_v4("0.18.6") }} Changelog: - Fixed an issue causing the SDK to depend on a specific version of kotlin-stdlib. ### 0.18.5 *2025-08-19* {{ android_release_v4("0.18.5") }} Changelog: - Fixed an issue with stacktrace symbolication for Android Native crashes. ### 0.18.4 *2025-08-15* {{ android_release_v4("0.18.4") }} Changelog: - This release is identical to 0.18.3 release. ### 0.18.3 *2025-08-15* {{ android_release_v4("0.18.3") }} Changelog: - This release is identical to 0.18.2 release. ### 0.18.2 *2025-08-15* {{ android_release_v4("0.18.2") }} Changelog: - This release is identical to 0.18.1 release. ### 0.18.1 *2025-08-08* {{ android_release_v4("0.18.1") }} Changelog: - Fatal Issue Detection now includes reporting Native (NDK) Crashes by [enabling the `enableNativeCrashReporting` flag](../features/fatal-issues.md#setup) - Improved the performance of [Fatal Issue Detection initialization](../features/fatal-issues.md#setup) by moving expensive operations to a background thread. - Fixed missing OS information on crash reports. - Added the ability to pass custom fields when using [the Networking OkHttp Instrumentation](../integrations.md#okhttp-android) via a new `OkHttpRequestFieldProvider` - Fixed occasional OkHttpClient connection leak - Improved the performance of the logging path when attaching auto-instrumented fields ### 0.18.0 *2025-07-30* {{ android_release_v4("0.18.0") }} Changelog: - All library artifacts are now published to [maven central](https://central.sonatype.com/namespace/io.bitdrift) - Minimum SDK API Level requirement raised from 21 to 24 - Added support for apps targeting SDK API Level 36 - Performance improvements: prevented some rare interop crashes, reduced allocations in logging path, and improved initialization performance by moving expensive operations to a background thread. - CaptureTree can now be extended to allow customization via `CaptureTree.isLoggable` - Extended the granularity of `Capture.Logger.start` reported duration - Improved accuracy for fatal issue metadata (fixing a case where the app version or timestamp could be incorrect) - Architecture is now reported as a default field in crash reports !!! warning If your app depends on `com.google.protobuf:protobuf-java` and given the SDK has a dep on `protobuf-kotlin-lite` since 0.18.0, you may run into **duplicate class errors** due to [this known protobuf issue](https://github.com/protocolbuffers/protobuf/issues/8104). **Workaround:** To prevent build failures, exclude `protobuf-javalite` when declaring the SDK: === "Gradle (Kotlin)" ```kotlin implementation("io.bitdrift:capture:0.18.0") { exclude(group = "com.google.protobuf", module = "protobuf-javalite") } ``` === "Gradle (Groovy)" ```groovy implementation("io.bitdrift:capture:0.18.0") { exclude group: "com.google.protobuf", module: "protobuf-javalite" } ``` ### 0.17.29 *2025-07-09* {{ android_release_v3("0.17.29") }} Changelog: - Timeout Matcher is now available in the SDK. See [Timeout Matcher](../../product/workflows/workflow-steps.md#timeout-matcher) for more details. ### 0.17.28 *2025-07-02* {{ android_release_v3("0.17.28") }} Changelog: - Symbol upload for issue reports can be done now via gradle tasks. For more details on setup please refer to [Issues & Crashes](../features/fatal-issues.md#gradle-plugin-android) - Automatic OkHttp instrumentation is now disabled by default. It can be enabled via custom DSL at the bottom of your build.gradle file. See [Integration Guide](../integrations.md#okhttp-android) for more details on setup. - Remove com.michael-bull.kotlin-result:kotlin-result-jvm dependency - Revert running Logger.start on a dedicated background thread - Prevent potential issue on native layer for metric changes ### 0.17.27 *2025-06-27* {{ android_release_v3("0.17.27") }} Changelog: - Fix fatal issue classification logic for background ANRs - Capture nested stack traces for JVM crashes ### 0.17.26 *2025-06-24* {{ android_release_v3("0.17.26") }} Changelog: - Automatically capture timeline and replay logs when a fatal issue is detected. - Added an accessor for bitdrift Capture [SDK Version](../features/sdk-version.md). - Improved the accuracy of durations for `Slow Rendering` logs. ### 0.17.25 *2025-06-20* {{ android_release_v3("0.17.25") }} Changelog: - Issue reports setup is now part of Logger.start call. See [Issues & Crashes](../features/fatal-issues.md) for more details on setup. - Offloaded Logger.start() internals to a dedicated background thread to reduce launch-time overhead. ### 0.17.24 *2025-06-18* {{ android_release_v3("0.17.24") }} Changelog: - Fix potential deadlock situation that could occur upon internal blocking logger calls. ### 0.17.23 *2025-06-12* {{ android_release_v3("0.17.23") }} Changelog: - Beta support for reporting of [Issues & Crashes](../features/fatal-issues.md) can now be enabled via `Logger.initFatalIssueReporting()` - Started reporting installation source in the Capture SDK Started log ### 0.17.22 *2025-06-06* {{ android_release_v3("0.17.22") }} Changelog: - Fixed a bug in [SessionStrategy#onSessionIdChanged](../features/session-management.md#observing-session-id-changes) that could lead to ANRs when calling `start()` on the main thread. ### 0.17.21 *2025-06-03* {{ android_release_v3("0.17.21") }} Changelog: - Improves reliability of [App Exit out of the box event](../features/automatic-instrumentation.md#log-events) by ensuring only the most relevant app process exit info is captured. ### 0.17.20 *2025-06-02* {{ android_release_v3("0.17.20") }} Changelog: - Report the thread name where Logger.start() is called. ### 0.17.19 *2025-05-28* {{ android_release_v3("0.17.19") }} Changelog: - This release is identical to 0.17.18 release. ### 0.17.18 *2025-05-27* {{ android_release_v3("0.17.18") }} Changelog: - This release is identical to 0.17.17 release. ### 0.17.17 *2025-05-23* {{ android_release_v3("0.17.17") }} Changelog: - Added experimental API which collects fatal issues (Crashes, ANRs) when configured. ### 0.17.16 *2025-05-21* {{ android_release_v3("0.17.16") }} Changelog: - Consolidate prior "Dropped Frames"/Application Not Responding" OOTB events into "Slow Rendering" event. - Improve low memory detection mechanism: replaced `_trim_level` with `_is_memory_low`, which compares actual app memory usage against [ActivityManager.MemoryInfo.threshold](https://developer.android.com/reference/android/app/ActivityManager.MemoryInfo#threshold) for more accurate and reliable low memory detection. - Remove unreliable memory fields from AppExit event. - Fixes a low volume crash when using modern PixelCopy. - Improved the reliability of client metrics. ### 0.17.15 *2025-05-09* {{ android_release_v3("0.17.15") }} Changelog: - Support optional context in fatal issue reporting initialization to allow setup with a content provider. ### 0.17.14 *2025-05-09* Changelog: - This is an invalid release, it's our general suggestion to skip this version. ### 0.17.13 *2025-04-10* {{ android_release_v3("0.17.13") }} Changelog: - Check ring buffer file CRC before reading it. This should prevent the SDK from reading a corrupted file. ### 0.17.12 *2025-04-07* {{ android_release_v3("0.17.12") }} Changelog: - Fixed typo on the span API used to create child spans ### 0.17.11 *2025-04-04* {{ android_release_v3("0.17.11") }} Changelog: - Fixed issue that would send larger payloads than needed for the logs that are used to signal app crashes. ### 0.17.10 *2025-03-31* {{ android_release_v3("0.17.10") }} Changelog: - Enhanced crash integration capabilities - Added protocol information to the [automatic networking instrumentation](../features/http-traffic-logs.md) - Included `dontwarn` proguard rule for `android.app.ApplicationStartInfo` ### 0.17.9 *2025-03-25* {{ android_release_v3("0.17.9") }} Changelog: - Spans with custom start and/or end times are now placed at the provided time in the timeline view - Added support for the `Measure Duration` action, allowing the duration between two log lines to be measured using a workflow ### 0.17.8 *2025-03-21* {{ android_release_v3("0.17.8") }} Changelog: - Added error reporting for cases where JankStats API returns unexpected duration - Changed span interface to include the ability to specify a parent span ID and custom start/end times ### 0.17.7 *2025-03-14* {{ android_release_v3("0.17.7") }} Changelog: - Include bazel common [fix](https://github.com/google/bazel-common/pull/217) for proper pom packaging - Updated Rust version from 1.83 to 1.85 - Log screen name as part of the dropped frames payload ### 0.17.6 *2025-03-04* {{ android_release_v3("0.17.6") }} Changelog: - Fixed potential memory leak caused by the automatic tracking of Slow/Frozen Frames and ANR events added in [v0.17.3](#0173). - libcapture.so artifacts now include build-id. ### 0.17.5 *2025-02-25* {{ android_release_v3("0.17.5") }} Changelog: - Add additional timing metrics to network responses. See [HTTP Response Fields](../features/http-traffic-logs.md#http-response-fields) section for more details. - Enrich existing App Launch event with additional metadata collected from ApplicationStartInfo ### 0.17.4 *2025-02-21* {{ android_release_v3("0.17.4") }} Changelog: - Made the latency threshold values for the reporting of Slow Frame, Frozen Frame, and ANR events remotely configurable. ### 0.17.3 *2025-02-20* {{ android_release_v3("0.17.3") }} Changelog: - Added automatic reporting of Slow Frame, Frozen Frame, and ANR events. See [Automatic Instrumentation](../features/automatic-instrumentation.md) for more details. ### 0.17.2 *2025-02-17* {{ android_release_v3("0.17.2") }} Changelog: - Improved performance of `start()` operation by moving non-critical tasks to a background thread ### 0.17.1 *2025-02-10* {{ android_release_v3("0.17.1") }} Changelog: - This release is identical to the 0.17.0 release. ### 0.17.0 *2025-02-06* {{ android_release_v3("0.17.0") }} Changelog: - Added more memory-related attributes to 'App Crash' and 'App Termination' events. - 'Memory Class' attribute is now reported in megabytes instead of kilobytes, to be consistent with [the Android API](https://developer.android.com/reference/android/app/ActivityManager#getMemoryClass()). - Event tracking used for [User Journey Sankey charts](../../product/workflows/actions.md#create-user-journey-diagram) has been made more reliable. ### 0.16.12 *2025-01-29* {{ android_release_v3("0.16.12") }} Changelog: - This release is identical to the 0.16.11 release. ### 0.16.11 *2025-01-27* {{ android_release_v3("0.16.11") }} Changelog: - Added a way for emitting a "Screen View" event. Refer to the [Screen Views](../features/automatic-instrumentation.md#screen-views) section for more details. - Downgraded dependency on `androidx.core` to `1.13.1` from `1.15.0` to avoid forcing consumers to `compileSdk 35`. ### 0.16.10 *2025-01-24* {{ android_release_v3("0.16.10") }} Changelog: - Set Kotlin version from 2.1.0 to 2.0.0 to prevent build errors on apps targeting 1.9.0 ### 0.16.9 *2025-01-23* {{ android_release_v3("0.16.9") }} Changelog: - Support added for apps targetting Android 15 (API Level 35). This required compiling our native portion to [support 16 KB page sizes](https://developer.android.com/about/versions/15/behavior-changes-all#16-kb). You might need to force the `androidx.core` dependency to target `1.13.1` if you're still on `compileSdk 34` or below by adding this to your gradle configuration: ```kotlin configurations.configureEach { resolutionStrategy { force "androidx.core:core:1.13.1" } } ``` - Now targetting [Kotlin 2.1](https://kotlinlang.org/docs/whatsnew21.html). You might need to use the `-Xskip-metadata-version-check` [kotlin compiler flag](https://kotlinlang.org/docs/gradle-compiler-options.html#example-of-additional-arguments-usage-via-freecompilerargs) if you encounter `incompatible version of Kotlin` when building your app with a Kotlin version of 1.9.0 or below. ```kotlin android { kotlinOptions { freeCompilerArgs += listOf("-Xskip-metadata-version-check") } } ``` ### 0.16.8 *2025-01-16* {{ android_release_v3("0.16.8") }} Changelog: - This release is identical to the 0.16.7 release. ### 0.16.7 *2025-01-10* {{ android_release_v3("0.16.7") }} Changelog: - `apollo-capture` integration library migrated from v3 to v4. See [Networking Integrations > Apollo GraphQL](../integrations.md#apollo-graphql) for more details. ### 0.16.6 *2025-01-06* {{ android_release_v2("0.16.6") }} Changelog: - Added support for handling floating point values in [Match Nodes conditions](../../product/workflows/workflow-steps.md#match-conditions). !!! warning Workflows with conditions using float numbers will be ignored in previous versions of the SDK. - Fixed a bug causing internal timers to fire more often than expected after returning from suspension. - Reduced the amount of log messages sent to logcat when parsing invalid Compose views. ### 0.16.5 *2024-12-17* {{ android_release_v2("0.16.5") }} Changelog: - This release is identical to the 0.16.4 release. ### 0.16.4 *2024-12-13* {{ android_release_v2("0.16.4") }} Changelog: - Released side library for integrating Capture SDK with [`Apollo`](https://github.com/apollographql/apollo-kotlin) graphql networking library. See [Networking Integrations > Apollo GraphQL](../integrations.md#apollo-graphql) for more details. - Released new gradle plugin (`io.bitdrift.capture-plugin`) that can be used to automatically instrument OkHttp clients. See [Networking Integrations > OkHttp](../integrations.md#okhttp-android) for more details. ### 0.16.3 *2024-11-27* {{ android_release("0.16.3") }} Changelog: - Added support for ignoring Compose elements via Modifiers. - Fixed an issue where third party libraries would interfere with the OkHttp client used by the Capture SDK. ### 0.16.2 *2024-11-18* {{ android_release("0.16.2") }} Changelog: - Added a 'Take Screenshot' workflow action, allowing users to capture a screenshot for a specific log or after a designated series of logs. - Fixed an issue with Session Replays for Compose where nested legacy AndroidViews were not being rendered correctly. ### 0.16.1 *2024-11-13* {{ android_release("0.16.1") }} Changelog: - Fixed the implementation of the 'User Journey' workflow action introduced in version 0.16.0 of the SDK to ensure reliable registration of user journeys. ### 0.16.0 *2024-11-08* {{ android_release("0.16.0") }} Changelog: - Added a 'User Journey' workflow action, enabling users to capture [Sankey diagrams](https://sankeymatic.com/) to visualize user flows of interest. - Reworked the `SessionReplayConfiguration` APIs by removing the option to disable the session replay screen capture feature or control the screen capture rate. Instead, this feature is now controlled through a remote runtime configuration that can be updated at any time. ### 0.15.2 *2024-10-22* {{ android_release("0.15.2") }} Changelog: - Fixed a potential issue with an unhandled exception for when another 3rd party SDK injects an interceptor into Capture SDK `OkHttp` client. ### 0.15.1 *2024-10-11* {{ android_release("0.15.1") }} Changelog: - This release is identical to 0.15.0 release. ### 0.15.0 *2024-10-09* {{ android_release("0.15.0") }} Changelog: - Renamed the `Logger.configure(...)` method to `Logger.start(...)`. To migrate, simply replace `Logger.configure(...)` with `Logger.start(...)`. - Handled cases where the SDK cannot be started due to unexpected reasons. - Added exponential backoff and jittering to the logic responsible for establishing connections with the bitdrift control plane. - Introduced jittering to the logic handling remote bitdrift control plane configuration updates to prevent the synchronization of all connected SDK clients. ### 0.14.5 *2024-09-27* {{ android_release("0.14.5") }} Changelog: - This release is identical to 0.14.4 release. ### 0.14.4 *2024-09-24* {{ android_release("0.14.4") }} Changelog: - Added a remote configurable mechanism to limit the lookback window using during buffer flush. This allows limiting the amount of data sent per flush. - Added further compression improvements to the data sent and received to the server, reducing the amount of memory required to process the data server-side. ### 0.14.3 *2024-09-11* {{ android_release("0.14.3") }} Changelog: - Small improvements to the documentation of the public APIs. ### 0.14.2 *2024-09-10* {{ android_release("0.14.2") }} Changelog: - Treat responses with 3xx HTTP status codes as successes instead of failures. Previously, only the 304 HTTP status code was considered a success. - Fixed a rare crash caused by the `PowerManager` being returned as `null` from the application context, even though the API is expected to always return a non-`null` object. - Fixed an issue with the propagation of bitdrift remote configuration, which is responsible for log field manipulation and helps sanitize paths displayed in workflow charts. - Updated Rust version from 1.80.1 to 1.81.0. ### 0.14.1 *2024-08-30* {{ android_release("0.14.1") }} Changelog: - Added an API for emitting the "App Launch TTI" event. Refer to [Log Events](../features/automatic-instrumentation.md#log-events) for more details. - Added an option for bitdrift SaaS to control how the path template is extracted from the HTTP URL path. - Fixed an issue with out-of-the-box "App Updated" event not being emitted. ### 0.14.0 *2024-08-26* {{ android_release("0.14.0") }} Changelog: - Added idiomatic kotlin support for tracking spans. Refer to [Spans](../features/spans.md#span-logs-fields ) for more details. - Added a new out-of-the-box "Thermal State Change" log event that's emitted each time device's thermal state changes. Refer to [Log Events](../features/automatic-instrumentation.md#log-events) for more details. - Removed the deprecated `OkHttpInterceptor`. Use `CaptureOkHttpEventListenerFactory` instead. For more details, refer to [OkHttp integration](../integrations.md#okhttp-android). - Improved the reliability of stats delivery mechanism. - Updated NDK version from `25.2.9519653` to `27.0.12077973`. ### 0.13.0 *2024-08-05* {{ android_release("0.13.0") }} Changelog: - Added SDK version attribute to out-of-the-box "SDK Configured" log event. - Added support for new SET/NOT_SET matching conditions. More details will be provided once they are available to use in bitdrift frontend. - Modified the "App Updated" event logic so that the app installation size is calculated only if needed. This should reduce the number of disk operations the SDK performs. - Fixed an issue with `fixed` session strategy detecting prohibited re-entrance from within the `generateSessionID` closure. - Improved the overall performance of the `Logger.configure` method call. - Removed the option to disable session replay for Compose views. The `skipReplayComposeViews` parameter was removed from the initializer of `SessionReplayConfiguration`. Session replay for compose views is enabled by default and can be disabled with a bitdrift remote runtime update. Reach out to the bitdrift team if you want to disable it. ### 0.12.0 *2024-07-24* {{ android_release("0.12.0") }} Changelog: - Added a new out-of-the-box "App Updated" log event that's emitted when the SDK runs after the app update. The log includes information about the app installation size. Refer to [Log Events](../features/automatic-instrumentation.md#log-events) for more details. - Added a new out-of-the-box "SDK Configured" log event that's emitted immediately after the SDK configuration is complete. Refer to [Log Events](../features/automatic-instrumentation.md#log-events) for more details. - Added a new out-of-the-box "App Termination" event that's emitted every time the OS reports process exit info. Refer to [Log Events](../features/automatic-instrumentation.md#log-events) for more details. - Added a new out-of-the-box "App Version Code" attribute to emitted logs. Refer to [Default Fields](../features/fields.md#default-fields) for more details. - Added an option to visualize the duration the SDK spends capturing screen session replay frames on the application's main thread. - Added fields to the existing "Resource utilization" log event with information about the amount of used disk space the SDK host app uses. - Added fields to the existing "Resource utilization" log event with information about the number of downloaded/uploaded bytes per minute. - Added information about the "memory class" to the out-of-the-box memory warnings log event. - Added an accessor for bitdrift Capture Identifier. Refer to [Device Identifier](../features/device.md#identifier) for more details. - Removed the `ResourceReportingConfiguration` type and the option to configure the resource reporting polling rate. The feature is enabled by default with a polling rate of 6s, controllable remotely by bitdrift services as needed. - Significantly reduced the amount of space resource reporting logs take on disk and during over-the-wire transfer. - Treat responses with an HTTP status code of 304 as successes instead of failures. - Removed an unintended reflection method call from the release version of the SDK. ### 0.11.3 *2024-06-28* {{ android_release("0.11.3") }} Changelog: - Added APIs for emitting span logs. Refer to [Spans](../features/spans.md) for more details. - Improved the reliability of logs and stats delivery by flushing the relevant state to disk when the SDK detects an event that may imply the app is about to be terminated or suspended. ### 0.11.2 *2024-06-18* {{ android_release("0.11.2") }} Changelog: - Improved the logic used to derive path template from the path of HTTP Request. Refer to [HTTP Traffic Log Fields](../features/http-traffic-logs.md#http-traffic-logs-fields) for more details. - Fixed a potential bug with an infinite loop inside of a logic used to derive path template. ### 0.11.1 *2024-06-13* {{ android_release("0.11.1") }} Changelog: - This release is identical to 0.11.0 release. ### 0.11.0 *2024-06-11* {{ android_release("0.11.0") }} Changelog: - Deprecated `CaptureOkHttpInterceptor` used to instrument HTTP requests performed by the app. Use newly introduced `CaptureOkHttpEventListenerFactory` to integrate Capture with `OkHttp` networking stack. Refer to [OkHttp (Android)](../integrations.md#okhttp-android) for more details. - Added new out-of-the-box fields to HTTP request and HTTP response logs. Refer to [HTTP Traffic Logs](../features/http-traffic-logs.md#http-traffic-logs-fields) for more details. - Made Session Replay capable of distinguishing between off and on switches in Compose views. ### 0.10.0 *2024-06-04* {{ android_release("0.10.0") }} Changelog: - The Session Replay support for Jetpack Compose has been rewritten from the ground-up to improve performance and reliability. Additionally Compose is now enabled by default as part of the `SessionReplayConfiguration`. It is strongly recommended to update to this version if you're using Compose views in your applications. ### 0.9.118 *2024-05-30* {{ android_release("0.9.118") }} Changelog: - The first release to support the collection of 'Workflow Insights,' a new feature that will add extra aggregated information to all workflow actions. A separate announcement will be made once the feature is available to the public, but we recommend that customers upgrade their SDK now so they can start benefiting from the new feature as soon as it's released. - Added a new out-of-the-box `locale` attribute that is collected as part of the emitted logs. Refer to [Default Fields](../features/fields.md#default-fields) for more details. - Changed the type of `path` argument of `HttpRequestInfo` and `HttpResponseInfo` classes from `String?` to newly introduced `HttpUrlPath`. ### 0.9.117 *2024-05-08* {{ android_release("0.9.117") }} Changelog: - This release is identical to 0.9.116 release. ### 0.9.116 *2024-04-26* {{ android_release("0.9.116") }} Changelog: - Make the `path` argument of `HTTPRequestInfo` optional. - Revamped support for app and OS version matching. Refer to [Version Matching](../../product/workflows/workflow-steps.md#version-matching) for more details. ### 0.9.115 *2024-04-09* {{ android_release("0.9.115") }} Changelog: - Released side libraries for integrating Capture SDK with [`Timber`](https://github.com/JakeWharton/timber) 3rd party logging library. See [Log Forwarding](../integrations.md#log-forwarding) for more details. ### 0.9.114 *2024-04-09* - [Library Artifact (aar)](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.114/capture-0.9.114.aar){:target="_blank"} - [NDK symbols](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.114/capture-0.9.114-symbols.tar){:target="_blank"} - [API Reference Docs](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.114/capture-0.9.114-javadoc.jar){:target="_blank"} Changelog: - This release is identical to 0.9.113 release. ### 0.9.113 *2024-04-02* - [Library Artifact (aar)](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.114/capture-0.9.114.aar){:target="_blank"} - [NDK symbols](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.114/capture-0.9.114-symbols.tar){:target="_blank"} - [API Reference Docs](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.114/capture-0.9.114-javadoc.jar){:target="_blank"} Changelog: - Add an optional argument of `Throwable` type to all methods from the `log(...)` family of methods. See [custom logs](../features/custom-logs.md) for more details. ### 0.9.112 *2024-04-02* - [Library Artifact (aar)](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.112/capture-0.9.112.aar){:target="_blank"} - [NDK symbols](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.112/capture-0.9.112-symbols.tar){:target="_blank"} - [API Reference Docs](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.112/capture-0.9.112-javadoc.jar){:target="_blank"} Changelog: - This release is identical to 0.9.111 release. ### 0.9.111 *2024-03-19* - [Library Artifact (aar)](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.111/capture-0.9.111.aar){:target="_blank"} - [NDK symbols](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.111/capture-0.9.111-symbols.tar){:target="_blank"} - [API Reference Docs](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.111/capture-0.9.111-javadoc.jar){:target="_blank"} Changelog: - Add `addField(...)` and `removeField(...)` methods that can be used to add and remove fields to be attached to all logs emitted by the SDK. - Omit fields whose names start with `_` and are provided via `addField(...)` or returned by `FieldProvider`s registered with the SDK. See [Field Additions and Removal methods](../features/fields.md#field-addition-and-removal-methods) for more details. - Drop fields whose names are on the the list of reserved log field names. See [Fields](../features/fields.md) for more details. ### 0.9.110 *2024-02-28* - [Library Artifact (aar)](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.110/capture-0.9.110.aar){:target="_blank"} - [NDK symbols](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.110/capture-0.9.110-symbols.tar){:target="_blank"} - [API Reference Docs](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.110/capture-0.9.110-javadoc.jar){:target="_blank"} Changelog: - Fixed broken `createTemporaryDeviceCode()` method, which was returning an invalid code. ### 0.9.109 *2024-02-26* - [Library Artifact (aar)](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.109/capture-0.9.109.aar){:target="_blank"} - [NDK symbols](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.109/capture-0.9.109-symbols.tar){:target="_blank"} - [API Reference Docs](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.109/capture-0.9.109-javadoc.jar){:target="_blank"} Changelog: - Added `createTemporaryDeviceCode(completion:)` method, which creates a temporary device code that can be used to stream logs from a given device in real-time. See [bd cli](../../cli/quickstart.md) for more details. ### 0.9.108 *2024-02-15* - [Library Artifact (aar)](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.108/capture-0.9.108.aar){:target="_blank"} - [NDK symbols](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.108/capture-0.9.108-symbols.tar){:target="_blank"} - [API Reference Docs](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.108/capture-0.9.108-javadoc.jar){:target="_blank"} Changelog: - Introduced significant improvements to the way session logs are uploaded. With this update, users now have access to logs not only before the workflow's 'Record Session' action triggers but also after the trigger. This enhancement provides a more comprehensive view of session logs, empowering users to gain deeper insights into their workflows and troubleshoot issues more effectively. - Added `Logger.log(level:message:info:)` method that takes log severity level as one of its arguments. The existence of this method may help reduce the amount of boilerplate needed to forward logs from existing logging systems into bitdrift. ### 0.9.107 *2024-02-02* - [Library Artifact (aar)](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.107/capture-0.9.107.aar){:target="_blank"} - [NDK symbols](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.107/capture-0.9.107-symbols.tar){:target="_blank"} - [API Reference Docs](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.107/capture-0.9.107-javadoc.jar){:target="_blank"} Changelog: - Exposed a convenience API method to retrieve a session permalink URL in the `Logger`. - Fixed a potential bug that may have caused a logger internal run loop to get stuck until the next app relaunch. ### 0.9.106 *2024-02-01* - [Library Artifact (aar)](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.106/capture-0.9.106.aar){:target="_blank"} - [NDK symbols](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.106/capture-0.9.106-symbols.tar){:target="_blank"} - [API Reference Docs](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.106/capture-0.9.106-javadoc.jar){:target="_blank"} Changelog: - Improved support for [Funnel Analysis](../../product/workflows/actions.md#create-funnel). This update is recommended for customers interested in using funnels in their workflows. - Funnels improvements were accomplished partially by changes to workflows' traversal rules and have limited impact on session captures and stats emission actions in multi-steps workflows. The final result should be be more intuitive results of workflow actions. ### 0.9.105 *2024-01-30* - [Library Artifact (aar)](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.105/capture-0.9.105.aar){:target="_blank"} - [NDK symbols](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.105/capture-0.9.105-symbols.tar){:target="_blank"} - [API Reference Docs](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.105/capture-0.9.105-javadoc.jar){:target="_blank"} Changelog: - Added support for on-demand log streaming, used to power real-time debugging tools. ### 0.9.104 *2024-01-18* - [Library Artifact (aar)](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.104/capture-0.9.104.aar){:target="_blank"} - [NDK symbols](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.104/capture-0.9.104-symbols.tar){:target="_blank"} - [API Reference Docs](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.104/capture-0.9.104-javadoc.jar){:target="_blank"} Changelog: - Fixed a rare `IllegalArgumentException` related to the use of moshi serialization and kotlin. - Removed [moshi](https://github.com/square/moshi) as a dependency. ### 0.9.103 *2023-12-27* - [Library Artifact (aar)](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.103/capture-0.9.103.aar){:target="_blank"} - [NDK symbols](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.103/capture-0.9.103-symbols.tar){:target="_blank"} - [API Reference Docs](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.103/capture-0.9.103-javadoc.jar){:target="_blank"} Changelog: - Made public APIs more Java friendly. - Changed the order the params in the `configure()` method to denote their importance. ### 0.9.102 *2023-12-20* - [Library Artifact (aar)](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.102/capture-0.9.102.aar){:target="_blank"} - [NDK symbols](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.102/capture-0.9.102-symbols.tar){:target="_blank"} - [API Reference Docs](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.102/capture-0.9.102-javadoc.jar){:target="_blank"} Changelog: - This release is identical to 0.9.101 release. ### 0.9.101 *2023-12-20* - [Library Artifact (aar)](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.101/capture-0.9.101.aar){:target="_blank"} - [NDK symbols](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.101/capture-0.9.101-symbols.tar){:target="_blank"} - [API Reference Docs](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.101/capture-0.9.101-javadoc.jar){:target="_blank"} Changelog: - This release is identical to 0.9.100 release. ### 0.9.100 *2023-12-19* - [Library Artifact (aar)](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.100/capture-0.9.100.aar){:target="_blank"} - [NDK symbols](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.100/capture-0.9.100-symbols.tar){:target="_blank"} - [API Reference Docs](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.100/capture-0.9.100-javadoc.jar){:target="_blank"} Changelog: - Reduced the minimum required Android SDK to API level 21 (down from 24). ### 0.9.99 *2023-12-08* - [Library Artifact (aar)](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.99/capture-0.9.99.aar){:target="_blank"} - [NDK symbols](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.99/capture-0.9.99-symbols.tar){:target="_blank"} - [API Reference Docs](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.99/capture-0.9.99-javadoc.jar){:target="_blank"} Changelog: - Update ProGuard rules, disable `androidx` related warnings. - Remove references to unused protobuf code. The change led to the reduction of the size of SDK binaries by around 4 KiB. ### 0.9.98 *2023-12-08* - [Library Artifact (aar)](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.98/capture-0.9.98.aar){:target="_blank"} - [NDK symbols](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.98/capture-0.9.98-symbols.tar){:target="_blank"} - [API Reference Docs](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.98/capture-0.9.98-javadoc.jar){:target="_blank"} Changelog: - Make Java Native Interface (JNI) code more robust and resilient. - Update ProGuard rules, fix unexpected SDK errors reporting. ### 0.9.97 *2023-12-07* - [Library Artifact (aar)](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.97/capture-0.9.97.aar){:target="_blank"} - [NDK symbols](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.97/capture-0.9.97-symbols.tar){:target="_blank"} - [API Reference Docs](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.97/capture-0.9.97-javadoc.jar){:target="_blank"} Changelog: - Disable internal debug and trace logs for improved performance and reduced binary size (~40 KiB smaller binary). ### 0.9.96 *2023-12-07* - [Library Artifact (aar)](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.96/capture-0.9.96.aar){:target="_blank"} - [NDK symbols](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.96/capture-0.9.96-symbols.tar){:target="_blank"} - [API Reference Docs](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.96/capture-0.9.96-javadoc.jar){:target="_blank"} Changelog: - Fix ProGuard misconfiguration issue that caused the SDK to throw an exception during `Logger.configure(...)` method call. ### 0.9.95 *2023-12-04* - [Library Artifact (aar)](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.95/capture-0.9.95.aar){:target="_blank"} - [NDK symbols](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.95/capture-0.9.95-symbols.tar){:target="_blank"} - [API Reference Docs](https://dl.bitdrift.io/sdk/android-maven/io/bitdrift/capture/0.9.95/capture-0.9.95-javadoc.jar){:target="_blank"} Changelog: - First public release of the bitdrift Capture SDK.