chore(deps): update Android SDK to v8.0.0

[github-actions]

Bumps flutter/scripts/update-android.sh from 7.20.1 to 8.0.0.

Auto-generated by a dependency updater.

Changelog

8.0.0

Summary

Version 8 of the Sentry Android/Java SDK brings a variety of features and fixes. The most notable changes are:

• Hub has been replaced by Scopes
• New Scope types have been introduced, see "Behavioural Changes" for more details.
• Lifecycle tokens have been introduced to manage Scope lifecycle, see "Behavioural Changes" for more details.
• Bumping minSdk level to 21 (Android 5.0)
• Our sentry-opentelemetry-agent has been improved and now works in combination with the rest of Sentry. You may now mix and match OpenTelemetry and Sentry API for instrumenting your application.
• The SDK is now compatible with Spring Boot 3.4
• We now support GraphQL v22 (sentry-graphql-22)
• Metrics have been removed

Please take a look at our migration guide in docs.

Sentry Self-hosted Compatibility

This SDK version is compatible with a self-hosted version of Sentry 22.12.0 or higher. If you are using an older version of self-hosted Sentry (aka onpremise), you will need to upgrade. If you're using sentry.io no action is required.

Breaking Changes

• The Android minSdk level for all Android modules is now 21 (#3852)
• The minSdk level for sentry-android-ndk changed from 19 to 21 (#3851)
• Throw IllegalArgumentException when calling Sentry.init on Android (#3596)
• Metrics have been removed from the SDK (#3774)
  • Metrics will return but we don't know in what exact form yet
• enableTracing option (a.k.a enable-tracing) has been removed from the SDK (#3776)
  • Please set tracesSampleRate to a value >= 0.0 for enabling performance instead. The default value is null which means performance is disabled.
• Replace synchronized methods and blocks with ReentrantLock (AutoClosableReentrantLock) (#3715)
  • If you are subclassing any Sentry classes, please check if the parent class used synchronized before. Please make sure to use the same lock object as the parent class in that case.
• traceOrigins option (io.sentry.traces.tracing-origins in manifest) has been removed, please use tracePropagationTargets (io.sentry.traces.trace-propagation-targets in manifest`) instead (#3780)
• profilingEnabled option (io.sentry.traces.profiling.enable in manifest) has been removed, please use profilesSampleRate (io.sentry.traces.profiling.sample-rate instead) instead (#3780)
• shutdownTimeout option has been removed, please use shutdownTimeoutMillis instead (#3780)
• profilingTracesIntervalMillis option for Android has been removed (#3780)
• io.sentry.session-tracking.enable manifest option has been removed (#3780)
• Sentry.traceHeaders() method has been removed, please use Sentry.getTraceparent() instead (#3718)
• Sentry.reportFullDisplayed() method has been removed, please use Sentry.reportFullyDisplayed() instead (#3717)
• User.other has been removed, please use data instead (#3780)
• SdkVersion.getIntegrations() has been removed, please use getIntegrationSet instead (#3780)
• SdkVersion.getPackages() has been removed, please use getPackageSet() instead (#3780)
• Device.language has been removed, please use locale instead (#3780)
• TraceContext.user and TraceContextUser class have been removed, please use userId on TraceContext instead (#3780)
• TransactionContext.fromSentryTrace() has been removed, please use Sentry.continueTrace() instead (#3780)
• SentryDataFetcherExceptionHandler has been removed, please use SentryGenericDataFetcherExceptionHandler in combination with SentryInstrumentation instead (#3780)
• sentry-android-okhttp has been removed in favor of sentry-okhttp, removing android dependency from the module (#3510)
• Contexts no longer extends ConcurrentHashMap, instead we offer a selected set of methods.
• User segment has been removed (#3512)
• One of the AndroidTransactionProfiler constructors has been removed, please use a different one (#3780)
• Use String instead of UUID for SessionId (#3834)
  • The Session constructor now takes a String instead of a UUID for the sessionId parameter.
  • Session.getSessionId() now returns a String instead of a UUID.
• All status codes below 400 are now mapped to SpanStatus.OK (#3869)
• Change OkHttp sub-spans to span attributes (#3556)
  • This will reduce the number of spans created by the SDK
• instrumenter option should no longer be needed as our new OpenTelemetry integration now works in combination with the rest of Sentry

Behavioural Changes

• We're introducing some new Scope types in the SDK, allowing for better control over what data is attached where. Previously there was a stack of scopes that was pushed and popped. Instead we now fork scopes for a given lifecycle and then restore the previous scopes. Since Hub is gone, it is also never cloned anymore. Separation of data now happens through the different scope types while making it easier to manipulate exactly what you need without having to attach data at the right time to have it apply where wanted.
  • Global scope is attached to all events created by the SDK. It can also be modified before Sentry.init has been called. It can be manipulated using Sentry.configureScope(ScopeType.GLOBAL, (scope) -> { ... }).
  • Isolation scope can be used e.g. to attach data to all events that come up while handling an incoming request. It can also be used for other isolation purposes. It can be manipulated using Sentry.configureScope(ScopeType.ISOLATION, (scope) -> { ... }). The SDK automatically forks isolation scope in certain cases like incoming requests, CRON jobs, Spring Async and more.
  • Current scope is forked often and data added to it is only added to events that are created while this scope is active. Data is also passed on to newly forked child scopes but not to parents. It can be manipulated using Sentry.configureScope(ScopeType.CURRENT, (scope) -> { ... }).
• Sentry.popScope has been deprecated, please call .close() on the token returned by Sentry.pushScope instead or use it in a way described in more detail in our migration guide.
• We have chosen a default scope that is used for Sentry.configureScope() as well as API like Sentry.setTag()
  • For Android the type defaults to CURRENT scope
  • For Backend and other JVM applicatons it defaults to ISOLATION scope
• Event processors on Scope can now be ordered by overriding the getOrder method on implementations of EventProcessor. NOTE: This order only applies to event processors on Scope but not SentryOptions at the moment. Feel free to request this if you need it.
• Hub is deprecated in favor of Scopes, alongside some Hub relevant APIs. More details can be found in our migration guide.
• Send file name and path only if isSendDefaultPii is true (#3919)
• (Android) Enable Performance V2 by default (#3824)
  • With this change cold app start spans will include spans for ContentProviders, Application and Activity load.
• (Android) Replace thread id with kernel thread id in span data (#3706)
• (Android) The JNI layer for sentry-native has now been moved from sentry-java to sentry-native (#3189)
  • This now includes prefab support for sentry-native, allowing you to link and access the sentry-native API within your native app code
  • Checkout the sentry-samples/sentry-samples-android example on how to configure CMake and consume sentry.h
• The user ip-address is now only set to "{{auto}}" if sendDefaultPii is enabled (#4072)
  • This change gives you control over IP address collection directly on the client

Features

• The SDK is now compatible with Spring Boot 3.4 (#3939)
• Our sentry-opentelemetry-agent has been completely reworked and now plays nicely with the rest of the Java SDK
  • You may also want to give this new agent a try even if you haven't used OpenTelemetry (with Sentry) before. It offers support for many more libraries and frameworks, improving on our trace propagation, Scopes (used to be Hub) propagation as well as performance instrumentation (i.e. more spans).
  • If you are using a framework we did not support before and currently resort to manual instrumentation, please give the agent a try. See here for a list of supported libraries, frameworks and application servers.
  • Please see Java SDK docs for more details on how to set up the agent. Please make sure to select the correct SDK from the dropdown on the left side of the docs.
  • What's new about the Agent
    • When the OpenTelemetry Agent is used, Sentry API creates OpenTelemetry spans under the hood, handing back a wrapper object which bridges the gap between traditional Sentry API and OpenTelemetry. We might be replacing some of the Sentry performance API in the future.
      • This is achieved by configuring the SDK to use OtelSpanFactory instead of DefaultSpanFactory which is done automatically by the auto init of the Java Agent.
    • OpenTelemetry spans are now only turned into Sentry spans when they are finished so they can be sent to the Sentry server.
    • Now registers an OpenTelemetry Sampler which uses Sentry sampling configuration
    • Other Performance integrations automatically stop creating spans to avoid duplicate spans
    • The Sentry SDK now makes use of OpenTelemetry Context for storing Sentry Scopes (which is similar to what used to be called Hub) and thus relies on OpenTelemetry for Context propagation.
    • Classes used for the previous version of our OpenTelemetry support have been deprecated but can still be used manually. We're not planning to keep the old agent around in favor of less complexity in the SDK.
• Add sentry-opentelemetry-agentless-spring module (#4000)
  • This module can be added as a dependency when using Sentry with OpenTelemetry and Spring Boot but don't want to use our Agent. It takes care of configuring OpenTelemetry for use with Sentry.
  • You may want to set OTEL_LOGS_EXPORTER=none;OTEL_METRICS_EXPORTER=none;OTEL_TRACES_EXPORTER=none env vars to not have the log flooded with error messages regarding OpenTelemetry features we don't use.
• Add sentry-opentelemetry-agentless module (#3961)
  • This module can be added as a dependency when using Sentry with OpenTelemetry but don't want to use our Agent. It takes care of configuring OpenTelemetry for use with Sentry.
  • To enable the auto configuration of it, please set -Dotel.java.global-autoconfigure.enabled=true on the java command, when starting your application.
  • You may also want to set OTEL_LOGS_EXPORTER=none;OTEL_METRICS_EXPORTER=none;OTEL_TRACES_EXPORTER=none env vars to not have the log flooded with error messages regarding OpenTelemetry features we don't use.
• OpenTelemetryUtil.applyOpenTelemetryOptions now takes an enum instead of a boolean for its mode
• Add openTelemetryMode option (#3994)
  • It defaults to AUTO meaning the SDK will figure out how to best configure itself for use with OpenTelemetry
  • Use of OpenTelemetry can also be disabled completely by setting it to OFF (#3995)
    • In this case even if OpenTelemetry is present, the Sentry SDK will not use it
  • Use AGENT when using sentry-opentelemetry-agent
  • Use AGENTLESS when using sentry-opentelemetry-agentless
  • Use AGENTLESS_SPRING when using sentry-opentelemetry-agentless-spring
• Add ignoredTransactions option to filter out transactions by name (#3871)
  • can be used via ENV vars, e.g. SENTRY_IGNORED_TRANSACTIONS=POST /person/,GET /pers.*
  • can also be set in options directly, e.g. options.setIgnoredTransactions(...)
  • can also be set in sentry.properties, e.g. ignored-transactions=POST /person/,GET /pers.*
  • can also be set in Spring config application.properties, e.g. sentry.ignored-transactions=POST /person/,GET /pers.*
• Add scopeBindingMode to SpanOptions (#4004)
  • This setting only affects the SDK when used with OpenTelemetry.
  • Defaults to AUTO meaning the SDK will decide whether the span should be bound to the current scope. It will not bind transactions to scope using AUTO, it will only bind spans where the parent span is on the current scope.
  • ON sets the new span on the current scope.
  • OFF does not set the new span on the scope.
• Add ignoredSpanOrigins option for ignoring spans coming from certain integrations
  • We pre-configure this to ignore Performance instrumentation for Spring and other integrations when using our OpenTelemetry Agent to avoid duplicate spans
• Support graphql-java v22 via a new module sentry-graphql-22 (#3740)
  • If you are using graphql-java v21 or earlier, you can use the sentry-graphql module
  • For graphql-java v22 and newer please use the sentry-graphql-22 module
• We now provide a SentryInstrumenter bean directly for Spring (Boot) if there is none yet instead of using GraphQlSourceBuilderCustomizer to add the instrumentation (#3744)
  • It is now also possible to provide a bean of type SentryGraphqlInstrumentation.BeforeSpanCallback which is then used by SentryInstrumenter
• Add data fetching environment hint to breadcrumb for GraphQL (#3413) (#3431)
• Report exceptions returned by Throwable.getSuppressed() to Sentry as exception groups ([#3396] Report suppressed exceptions as exception group sentry-java#3396)
  • Any suppressed exceptions are added to the issue details page in Sentry, the same way any cause is.
  • We are planning to improve how we visualize suppressed exceptions. See Mark suppressed exceptions in Sentry UI sentry-java#4059
• Enable ThreadLocalAccessor for Spring Boot 3 WebFlux by default (#4023)
• Allow passing environment to CheckinUtils.withCheckIn (3889)
• Add globalHubMode to options (#3805)
  • globalHubMode used to only be a param on Sentry.init. To make it easier to be used in e.g. Desktop environments, we now additionally added it as an option on SentryOptions that can also be set via sentry.properties.
  • If both the param on Sentry.init and the option are set, the option will win. By default the option is set to null meaning whatever is passed to Sentry.init takes effect.
• Lazy uuid generation for SentryId and SpanId (#3770)
• Faster generation of Sentry and Span IDs (#3818)
  • Uses faster implementation to convert UUID to SentryID String
  • Uses faster Random implementation to generate UUIDs
• Android 15: Add support for 16KB page sizes (#3851)
  • See https://developer.android.com/guide/practices/page-sizes for more details
• Add init priority settings (#3674)
  • You may now set forceInit=true (force-init for .properties files) to ensure a call to Sentry.init / SentryAndroid.init takes effect
• Add force init option to Android Manifest (#3675)
  • Use <meta-data android:name="io.sentry.force-init" android:value="true" /> to ensure Sentry Android auto init is not easily overwritten
• Attach request body for application/x-www-form-urlencoded requests in Spring (#3731)
  • Previously request body was only attached for application/json requests
• Set breadcrumb level based on http status (#3771)
• Emit transaction.data inside contexts.trace.data (#3735)
  • Also does not emit transaction.data in extras anymore
• Add a sample for showcasing Sentry with OpenTelemetry for Spring Boot 3 with our Java agent (sentry-samples-spring-boot-jakarta-opentelemetry) (#3856)
• Add a sample for showcasing Sentry with OpenTelemetry for Spring Boot 3 without our Java agent (sentry-samples-spring-boot-jakarta-opentelemetry-noagent) (#3856)
• Add a sample for showcasing Sentry with OpenTelemetry (sentry-samples-console-opentelemetry-noagent) (#3856)

Fixes

• Fix incoming defer sampling decision sentry-trace header (#3942)
  • A sentry-trace header that only contains trace ID and span ID but no sampled flag (-1, -0 suffix) means the receiving system can make its own sampling decision
  • When generating sentry-trace header from PropagationContext we now copy the sampled flag.
  • In TransactionContext.fromPropagationContext when there is no parent sampling decision, keep the decision null so a new sampling decision is made instead of defaulting to false
• Fix order of calling close on previous Sentry instance when re-initializing (#3750)
  • Previously some parts of Sentry were immediately closed after re-init that should have stayed open and some parts of the previous init were never closed
• All status codes below 400 are now mapped to SpanStatus.OK (#3869)
• Improve ignored check performance (#3992)
  • Checking if a span origin, a transaction or a checkIn should be ignored is now faster
• Cache requests for Spring using Springs ContentCachingRequestWrapper instead of our own Wrapper to also cache parameters (#3641)
  • Previously only the body was cached which could lead to problems in the FilterChain as Request parameters were not available
• Close backpressure monitor on SDK shutdown (#3998)
  • Due to the backpressure monitor rescheduling a task to run every 10s, it very likely caused shutdown to wait the full shutdownTimeoutMillis (defaulting to 2s) instead of being able to terminate immediately
• Let OpenTelemetry auto instrumentation handle extracting and injecting tracing information if present (#3953)
  • Our integrations no longer call .continueTrace and also do not inject tracing headers if the integration has been added to ignoredSpanOrigins
• Fix testTag not working for Jetpack Compose user interaction tracking (#3878)
• Mark DiskFlushNotification hint flushed when rate limited (#3892)
  • Our UncaughtExceptionHandlerIntegration waited for the full flush timeout duration (default 15s) when rate limited.
• Do not replace op with auto generated content for OpenTelemetry spans with span kind INTERNAL (#3906)
• Add enable-spotlight and spotlight-connection-url to external options and check if spotlight is enabled when deciding whether to inspect an OpenTelemetry span for connecting to splotlight (#3709)
• Trace context on Contexts.setTrace has been marked NotNull (#3721)
  • Setting it to null would cause an exception.
  • Transactions are dropped if trace context is missing
• Remove internal annotation on SpanOptions (#3722)
• SentryLogbackInitializer is now public (#3723)
• Parse and use send-default-pii and max-request-body-size from sentry.properties (#3534)
• TracesSampler is now only created once in SentryOptions instead of creating a new one for every Hub (which is now Scopes). This means we're now creating fewer SecureRandom instances.

Internal

• Make SentryClient constructor public (#4045)
• Warm starts cleanup (#3954)

Changes in pre-releases

These changes have been made during development of 8.0.0. You may skip this section. We just put it here for sake of completeness.

• Extract OpenTelemetry URL_PATH span attribute into description (#3933)

• Replace OpenTelemetry ContextStorage wrapper with ContextStorageProvider (#3938)

  • The wrapper had to be put in place before any call to Context whereas ContextStorageProvider is automatically invoked at the correct time.

• Send otel.kind to Sentry (#3907)

• Spring Boot now automatically detects if OpenTelemetry is available and makes use of it (#3846)

  • This is only enabled if there is no OpenTelemetry agent available
  • We prefer to use the OpenTelemetry agent as it offers more auto instrumentation
  • In some cases the OpenTelemetry agent cannot be used, please see https://opentelemetry.io/docs/zero-code/java/spring-boot-starter/ for more details on when to prefer the Agent and when the Spring Boot starter makes more sense.
  • In this mode the SDK makes use of the OpenTelemetry bean that is created by opentelemetry-spring-boot-starter instead of GlobalOpenTelemetry

• Spring Boot now automatically detects our OpenTelemetry agent if its auto init is disabled (#3848)

  • This means Spring Boot config mechanisms can now be combined with our OpenTelemetry agent
  • The sentry-opentelemetry-extra module has been removed again, most classes have been moved to sentry-opentelemetry-bootstrap which is loaded into the bootstrap classloader (i.e. null) when our Java agent is used. The rest has been moved into sentry-opentelemetry-agentcustomization and is loaded into the agent classloader when our Java agent is used.
  • The sentry-opentelemetry-bootstrap and sentry-opentelemetry-agentcustomization modules can be used without the agent as well, in which case all classes are loaded into the application classloader. Check out our sentry-samples-spring-boot-jakarta-opentelemetry-noagent sample.
  • In this mode the SDK makes use of GlobalOpenTelemetry

• Automatically set span factory based on presence of OpenTelemetry (#3858)

  • SentrySpanFactoryHolder has been removed as it is no longer required.

• Replace deprecated SimpleInstrumentation with SimplePerformantInstrumentation for graphql 22 (#3974)

• We now hold a strong reference to the underlying OpenTelemetry span when it is created through Sentry API (#3997)

  • This keeps it from being garbage collected too early

• Defer sampling decision by setting sampled to null in PropagationContext when using OpenTelemetry in case of an incoming defer sampling sentry-trace header. (#3945)

• Build PropagationContext from SamplingDecision made by SentrySampler instead of parsing headers and potentially ignoring a sampling decision in case a sentry-trace header comes in with deferred sampling decision. (#3947)

• The Sentry OpenTelemetry Java agent now makes sure Sentry Scopes storage is initialized even if the agents auto init is disabled (#3848)

  • This is required for all integrations to work together with our OpenTelemetry Java agent if its auto init has been disabled and the SDKs init should be used instead.

• Fix startChild for span that is not in current OpenTelemetry Context (#3862)

  • Starting a child span from a transaction that wasn't in the current Context lead to multiple transactions being created (one for the transaction and another per span created).

• Add auto.graphql.graphql22 to ignored span origins when using OpenTelemetry (#3828)

• Use OpenTelemetry span name as fallback for transaction name (#3557)

  • In certain cases we were sending transactions as "" when using OpenTelemetry

• Add OpenTelemetry span data to Sentry span (#3593)

• No longer selectively copy OpenTelemetry attributes to Sentry spans / transactions data (#3663)

• Remove PROCESS_COMMAND_ARGS (process.command_args) OpenTelemetry span attribute as it can be very large (#3664)

• Use RECORD_ONLY sampling decision if performance is disabled (#3659)

  • Also fix check whether Performance is enabled when making a sampling decision in the OpenTelemetry sampler

• Sentry OpenTelemetry Java Agent now sets Instrumenter to SENTRY (used to be OTEL) (#3697)

• Set span origin in ActivityLifecycleIntegration on span options instead of after creating the span / transaction (#3702)

  • This allows spans to be filtered by span origin on creation

• Honor ignored span origins in SentryTracer.startChild (#3704)

• Use span id of remote parent (#3548)

  • Traces were broken because on an incoming request, OtelSentrySpanProcessor did not set the parentSpanId on the span correctly. Traces were not referencing the actual parent span but some other (random) span ID which the server doesn't know.

• Attach active span to scope when using OpenTelemetry (#3549)

  • Errors weren't linked to traces correctly due to parts of the SDK not knowing the current span

• Record dropped spans in client report when sampling out OpenTelemetry spans (#3552)

• Retrieve the correct current span from Scope/Scopes when using OpenTelemetry (#3554)

• Support spans that are split into multiple batches (#3539)

  • When spans belonging to a single transaction were split into multiple batches for SpanExporter, we did not add all spans because the isSpanTooOld check wasn't inverted.

• Partially fix bootstrap class loading (#3543)

  • There was a problem with two separate Sentry Scopes being active inside each OpenTelemetry Context due to using context keys from more than one class loader.

• The Spring Boot 3 WebFlux sample now uses our GraphQL v22 integration (#3828)

• Do not ignore certain span origins for OpenTelemetry without agent (#3856)

• span.startChild now uses .makeCurrent() by default (#3544)

  • This caused an issue where the span tree wasn't correct because some spans were not added to their direct parent

• Do not set the exception group marker when there is a suppressed exception (#4056)

  • Due to how grouping works in Sentry currently sometimes the suppressed exception is treated as the main exception. This change ensures we keep using the main exception and not change how grouping works.
  • As a consequence the list of exceptions in the group on top of an issue is no longer shown in Sentry UI.
  • We are planning to improve this in the future but opted for this fix first.

Dependencies

• Bump Native SDK from v0.7.0 to v0.7.17 (#3441) (#3851) (#3914) (#4003)
  • changelog
  • diff
• Bump OpenTelemetry to 1.44.1, OpenTelemetry Java Agent to 2.10.0 and Semantic Conventions to 1.28.0 (#3668) (#3935)

Migration Guide / Deprecations

Please take a look at our migration guide in docs.

• Hub has been deprecated, we're replacing the following:
  • IHub has been replaced by IScopes, however you should be able to simply pass IHub instances to code expecting IScopes, allowing for an easier migration.
  • HubAdapter.getInstance() has been replaced by ScopesAdapter.getInstance()
  • The .clone() method on IHub/IScopes has been deprecated, please use .pushScope() or .pushIsolationScope() instead
  • Some internal methods like .getCurrentHub() and .setCurrentHub() have also been replaced.
• Sentry.popScope has been replaced by calling .close() on the token returned by Sentry.pushScope() and Sentry.pushIsolationScope(). The token can also be used in a try block like this:

try (final NotNull ISentryLifecycleToken ignored = Sentry.pushScope()) {
  // this block has its separate current scope
}

as well as:

try (final NotNull ISentryLifecycleToken ignored = Sentry.pushIsolationScope()) {
  // this block has its separate isolation scope
}

• Classes used by our previous OpenTelemetry integration have been deprecated (SentrySpanProcessor, SentryPropagator, OpenTelemetryLinkErrorEventProcessor). Please take a look at docs on how to setup OpenTelemetry in v8.

You may also use LifecycleHelper.close(token), e.g. in case you need to pass the token around for closing later.

Changes from rc.4

If you have been using 8.0.0-rc.4 of the Java SDK, here's the new changes that have been included in the 8.0.0 release:

• Make SentryClient constructor public (#4045)
• The user ip-address is now only set to "{{auto}}" if sendDefaultPii is enabled (#4072)
  • This change gives you control over IP address collection directly on the client
• Do not set the exception group marker when there is a suppressed exception (#4056)
  • Due to how grouping works in Sentry currently sometimes the suppressed exception is treated as the main exception. This change ensures we keep using the main exception and not change how grouping works.
  • As a consequence the list of exceptions in the group on top of an issue is no longer shown in Sentry UI.
  • We are planning to improve this in the future but opted for this fix first.
• Fix swallow NDK loadLibrary errors (#4082)

7.20.0

Features

• Session Replay GA (#4017)

To enable Replay use the sessionReplay.sessionSampleRate or sessionReplay.onErrorSampleRate options.

import io.sentry.SentryReplayOptions
import io.sentry.android.core.SentryAndroid

SentryAndroid.init(context) { options ->
 
  options.sessionReplay.sessionSampleRate = 1.0
  options.sessionReplay.onErrorSampleRate = 1.0

  // To change default redaction behavior (defaults to true)
  options.sessionReplay.redactAllImages = true
  options.sessionReplay.redactAllText = true

  // To change quality of the recording (defaults to MEDIUM)
  options.sessionReplay.quality = SentryReplayOptions.SentryReplayQuality.MEDIUM // (LOW|MEDIUM|HIGH)
}

Fixes

• Fix warm start detection (#3937)
• Session Replay: Reduce memory allocations, disk space consumption, and payload size (#4016)
• Session Replay: Do not try to encode corrupted frames multiple times (#4016)

Internal

• Session Replay: Allow overriding SdkVersion for replay events (#4014)
• Session Replay: Send replay options as tags (#4015)

Breaking changes

• Session Replay options were moved from under experimental to the main options object (#4017)

7.19.1

Fixes

• Change TTFD timeout to 25 seconds (#3984)
• Session Replay: Fix memory leak when masking Compose screens (#3985)
• Session Replay: Fix potential ANRs in GestureRecorder (#4001)

Internal

• Session Replay: Flutter improvements (#4007)

7.19.0

Fixes

• Session Replay: fix various crashes and issues (#3970)
  • Fix IndexOutOfBoundsException when tracking window changes
  • Fix IllegalStateException when adding/removing draw listener for a dead view
  • Fix ConcurrentModificationException when registering window listeners and stopping WindowRecorder/GestureRecorder
• Add support for setting sentry-native handler_strategy (#3671)

Dependencies

• Bump Native SDK from v0.7.8 to v0.7.16 (#3671)
  • changelog
  • diff

7.18.1

Fixes

• Fix testTag not working for Jetpack Compose user interaction tracking (#3878)

7.18.0

Features

• Android 15: Add support for 16KB page sizes (#3620)
  • See https://developer.android.com/guide/practices/page-sizes for more details
• Session Replay: Add beforeSendReplay callback (#3855)
• Session Replay: Add support for masking/unmasking view containers (#3881)

Fixes

• Avoid collecting normal frames (#3782)
• Ensure android initialization process continues even if options configuration block throws an exception (#3887)
• Do not report parsing ANR error when there are no threads (#3888)
  • This should significantly reduce the number of events with message "Sentry Android SDK failed to parse system thread dump..." reported
• Session Replay: Disable replay in session mode when rate limit is active (#3854)

Dependencies

• Bump Native SDK from v0.7.2 to v0.7.8 (#3620)
  • changelog
  • diff

7.17.0

Features

• Add meta option to set the maximum amount of breadcrumbs to be logged. (#3836)
• Use a separate Random instance per thread to improve SDK performance (#3835)

Fixes

• Using MaxBreadcrumb with value 0 no longer crashes. (#3836)
• Accept manifest integer values when requiring floating values (#3823)
• Fix standalone tomcat jndi issue (#3873)
  • Using Sentry Spring Boot on a standalone tomcat caused the following error:
    • Failed to bind properties under 'sentry.parsed-dsn' to io.sentry.Dsn

7.16.0

Features

• Add meta option to attach ANR thread dumps (#3791)

Fixes

• Cache parsed Dsn (#3796)
• fix invalid profiles when the transaction name is empty (#3747)
• Deprecate enableTracing option (#3777)
• Vendor java.util.Random and replace java.security.SecureRandom usages (#3783)
• Fix potential ANRs due to NDK scope sync (#3754)
• Fix potential ANRs due to NDK System.loadLibrary calls (#3670)
• Fix slow Log calls on app startup (#3793)
• Fix slow Integration name parsing (#3794)
• Session Replay: Reduce startup and capture overhead (#3799)
• Load lazy fields on init in the background (#3803)
• Replace setOf with HashSet.add (#3801)

Breaking changes

• The method addIntegrationToSdkVersion(Ljava/lang/Class;)V has been removed from the core (io.sentry:sentry) package. Please make sure all of the packages (e.g. io.sentry:sentry-android-core, io.sentry:sentry-android-fragment, io.sentry:sentry-okhttp and others) are all aligned and using the same version to prevent the NoSuchMethodError exception.

7.16.0-alpha.1

Features

• Add meta option to attach ANR thread dumps (#3791)

Fixes

• Cache parsed Dsn (#3796)
• fix invalid profiles when the transaction name is empty (#3747)
• Deprecate enableTracing option (#3777)
• Vendor java.util.Random and replace java.security.SecureRandom usages (#3783)
• Fix potential ANRs due to NDK scope sync (#3754)
• Fix potential ANRs due to NDK System.loadLibrary calls (#3670)
• Fix slow Log calls on app startup (#3793)
• Fix slow Integration name parsing (#3794)
• Session Replay: Reduce startup and capture overhead (#3799)

7.15.0

Features

• Add support for feedback envelope header item type (#3687)
• Add breadcrumb.origin field (#3727)
• Session Replay: Add options to selectively mask/unmask views captured in replay. The following options are available: (#3689)
  • android:tag="sentry-mask|sentry-unmask" in XML or view.setTag("sentry-mask|sentry-unmask") in code tags
    • if you already have a tag set for a view, you can set a tag by id: <tag android:id="id/sentry_privacy" android:value="mask|unmask"/> in XML or view.setTag(io.sentry.android.replay.R.id.sentry_privacy, "mask|unmask") in code
  • view.sentryReplayMask() or view.sentryReplayUnmask() extension functions
  • mask/unmask Views of a certain type by adding fully-qualified classname to one of the lists options.experimental.sessionReplay.addMaskViewClass() or options.experimental.sessionReplay.addUnmaskViewClass(). Note, that all of the view subclasses/subtypes will be masked/unmasked as well
    • For example, (this is already a default behavior) to mask all TextViews and their subclasses (RadioButton, EditText, etc.): options.experimental.sessionReplay.addMaskViewClass("android.widget.TextView")
    • If you're using code obfuscation, adjust your proguard-rules accordingly, so your custom view class name is not minified
• Session Replay: Support Jetpack Compose masking (#3739)
  • To selectively mask/unmask Composables, use Modifier.sentryReplayMask() and Modifier.sentryReplayUnmask() modifiers
• Session Replay: Mask WebView, VideoView and androidx.media3.ui.PlayerView by default (#3775)

Fixes

• Avoid stopping appStartProfiler after application creation (#3630)
• Session Replay: Correctly detect dominant color for TextViews with Spans (#3682)
• Fix ensure Application Context is used even when SDK is initialized via Activity Context (#3669)
• Fix potential ANRs due to Calendar.getInstance usage in Breadcrumbs constructor (#3736)
• Fix potential ANRs due to default integrations (#3778)
• Lazily initialize heavy SentryOptions members to avoid ANRs on app start (#3749)

Breaking changes:

• options.experimental.sessionReplay.errorSampleRate was renamed to options.experimental.sessionReplay.onErrorSampleRate (#3637)
• Manifest option io.sentry.session-replay.error-sample-rate was renamed to io.sentry.session-replay.on-error-sample-rate (#3637)
• Change redactAllText and redactAllImages to maskAllText and maskAllImages (#3741)

7.14.0

Features

• Session Replay: Gesture/touch support for Flutter (#3623)

Fixes

• Fix app start spans missing from Pixel devices (#3634)
• Avoid ArrayIndexOutOfBoundsException on Android cpu data collection (#3598)
• Fix lazy select queries instrumentation (#3604)
• Session Replay: buffer mode improvements (#3622)
  • Align next segment timestamp with the end of the buffered segment when converting from buffer mode to session mode
  • Persist buffer replay type for the entire replay when converting from buffer mode to session mode
  • Properly store screen names for buffer mode
• Session Replay: fix various crashes and issues (#3628)
  • Fix video not being encoded on Pixel devices
  • Fix SIGABRT native crashes on Xiaomi devices when encoding a video
  • Fix RejectedExecutionException when redacting a screenshot
  • Fix FileNotFoundException when persisting segment values

Chores

• Introduce ReplayShadowMediaCodec and refactor tests using custom encoder (#3612)

7.13.0

Features

• Session Replay: (#3565) (#3609)
  • Capture remaining replay segment for ANRs on next app launch
  • Capture remaining replay segment for unhandled crashes on next app launch

Fixes

• Session Replay: (#3565) (#3609)
  • Fix stopping replay in session mode at 1 hour deadline
  • Never encode full frames for a video segment, only do partial updates. This further reduces size of the replay segment
  • Use propagation context when no active transaction for ANRs

Dependencies

• Bump Spring Boot to 3.3.2 (#3541)

7.12.1

Fixes

• Check app start spans time and ignore background app starts (#3550)
  • This should eliminate long-lasting App Start transactions

7.12.0

Features

• Session Replay Public Beta (#3339)

  To enable Replay use the sessionReplay.sessionSampleRate or sessionReplay.errorSampleRate experimental options.

  import io.sentry.SentryReplayOptions
  import io.sentry.android.core.SentryAndroid
  
  SentryAndroid.init(context) { options ->
   
    // Currently under experimental options:
    options.experimental.sessionReplay.sessionSampleRate = 1.0
    options.experimental.sessionReplay.errorSampleRate = 1.0
  
    // To change default redaction behavior (defaults to true)
    options.experimental.sessionReplay.redactAllImages = true
    options.experimental.sessionReplay.redactAllText = true
  
    // To change quality of the recording (defaults to MEDIUM)
    options.experimental.sessionReplay.quality = SentryReplayOptions.SentryReplayQuality.MEDIUM // (LOW|MEDIUM|HIGH)
  }

  To learn more visit Sentry's Mobile Session Replay documentation page.

7.11.0

Features

• Report dropped spans (#3528)

Fixes

• Fix duplicate session start for React Native (#3504)
• Move onFinishCallback before span or transaction is finished (#3459)
• Add timestamp when a profile starts (#3442)
• Move fragment auto span finish to onFragmentStarted (#3424)
• Remove profiling timeout logic and disable profiling on API 21 (#3478)
• Properly reset metric flush flag on metric emission (#3493)
• Use SecureRandom in favor of Random for Metrics (#3495)
• Fix UncaughtExceptionHandlerIntegration Memory Leak (#3398)
• Deprecated User.segment. Use a custom tag or context instead. (#3511)
• Fix duplicated http spans (#3526)
• When capturing unhandled hybrid exception session should be ended and new start if need (#3480)

Dependencies

• Bump Native SDK from v0.7.0 to v0.7.2 (#3314)
  • changelog
  • diff

7.10.0

Features

• Publish Gradle module metadata (#3422)

Fixes

• Fix faulty span.frame_delay calculation for early app start spans (#3427)
• Fix crash when installing ShutdownHookIntegration and the VM is shutting down (#3456)

7.9.0

Features

• Add start_type to app context (#3379)
• Add ttid/ttfd contribution flags (#3386)

Fixes

• (Internal) Metrics code cleanup (#3403)
• Fix Frame measurements in app start transactions (#3382)
• Fix timing metric value different from span duration (#3368)
• Do not always write startup crash marker (#3409)
  • This may have been causing the SDK init logic to block the main thread

7.8.0

Features

• Add description to OkHttp spans (#3320)
• Enable backpressure management by default (#3284)

Fixes

• Add rate limit to Metrics (#3334)
• Fix java.lang.ClassNotFoundException: org.springframework.web.servlet.HandlerMapping in Spring Boot Servlet mode without WebMVC (#3336)
• Fix normalization of metrics keys, tags and values (#3332)

7.7.0

Features

• Add support for Spring Rest Client (#3199)
• Extend Proxy options with proxy type (#3326)

Fixes

• Fixed default deadline timeout to 30s instead of 300s (#3322)
• Fixed Fix java.lang.ClassNotFoundException: org.springframework.web.servlet.HandlerExceptionResolver in Spring Boot Servlet mode without WebMVC (#3333)

7.6.0

Features

• Experimental: Add support for Sentry Developer Metrics (#3205, #3238, #3248, #3250)
  Use the Metrics API to track processing time, download sizes, user signups, and conversion rates and correlate them back to tracing data in order to get deeper insights and solve issues faster. Our API supports counters, distributions, sets, gauges and timers, and it's easy to get started:

  Sentry.metrics()
    .increment(
        "button_login_click", // key
        1.0,                  // value
        null,                 // unit
        mapOf(                // tags
            "provider" to "e-mail"
        )
    )

⚠️ Changelog content truncated by 177305 characters because it was over the limit (60000) and wouldn't fit into PR description.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 92.53%. Comparing base (0965b4f) to head (8e7e43d).

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2596      +/-   ##
==========================================
+ Coverage   88.78%   92.53%   +3.74%     
==========================================
  Files         122       91      -31     
  Lines        4306     2986    -1320     
==========================================
- Hits         3823     2763    -1060     
+ Misses        483      223     -260     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[vaind]

This change is breaking because it drops support for Android API 19.

Background:
Flutter SDK has also dropped support for API 19 but only since version 3.22.0 and we currently support 3.0.0

[buenaflor]

@vaind do we have any urgency to work on v9 because of this? e.g is android replay going to keep continue supporting v7 - dunno how much we depend on further/future work by android replay

[vaind]

With the android bump & this requirement for performance improvemnts, I'm thinking we should start working on 9.0.
While I'm not aware of any issues that would require as to update the Android SDK at the moment, it may be risky to release GA in FLutter SDK v8 when we can't get further Android SDK updates (or rather we can but it would be painful), in case any issue arises in the future.

It also sounds like a good time to combine the replay GA release in a new major version.