9.26.0

Features

Flutter

• Standalone app start tracing (experimental) by @buenaflor in #3896 and #3918
  • App start is reported as its own App Start root (app.start) spanning process start to the first frame, instead of being nested under the synthetic initial ui.load. This gives startup its own lifecycle and sampling decision.
  • Opt in via options.enableStandaloneAppStartTracing. Requires tracing, is supported on Android and iOS, and works with both SentryTraceLifecycle.static and SentryTraceLifecycle.stream.
  • Extend the app start past the first frame with SentryFlutter.extendAppStart() and SentryFlutter.finishExtendedAppStart(), so startup work that finishes later — remote config, auth restore, flag hydration — is part of the reported duration.
  • Always finish what you extend. While an extension is open the app start stays open too; if it hits its 30 second deadline first, the extension is dropped and the reported duration falls back to the first frame.

// Opt in during SDK init and extend the app start across your startup work.
await SentryFlutter.init(
  (options) {
    options.dsn = 'https://example@sentry.io/add-your-dsn-here';
    options.tracesSampleRate = 1.0;
    options.enableStandaloneAppStartTracing = true;
  },
  appRunner: () async {
    // Extend before the first frame renders.
    SentryFlutter.extendAppStart();
    runApp(const MyApp());

    try {
      await remoteConfig.fetchAndActivate();
      await auth.restoreSession();
    } finally {
      // Releases the app start to report, measured up to here.
      await SentryFlutter.finishExtendedAppStart();
    }
  },
);

• To nest your own spans under the extension, take the span itself — SentryFlutter.getExtendedAppStartSpan() on the static lifecycle, SentryFlutter.getExtendedAppStartSpanV2() on the streaming one. Each returns null on the other lifecycle and once the extension has ended. Finishing the span completes the extension, so there is no need to also call finishExtendedAppStart().

// Static lifecycle.
final appStart = SentryFlutter.getExtendedAppStartSpan();
final child = appStart?.startChild('app.init', description: 'Load config');
try {
  await loadConfig();
} finally {
  await child?.finish();
}

// Streaming lifecycle. Only pass a parent when there is one — passing `null`
// starts a root span instead of a child.
final appStartV2 = SentryFlutter.getExtendedAppStartSpanV2();
if (appStartV2 != null) {
  await Sentry.startSpan(
    'Load config',
    (span) => loadConfig(),
    parentSpan: appStartV2,
  );
} else {
  await loadConfig();
}

Fixes

• Read normalized rate limit headers by @sentry-junior in #3883

Enhancements

• (flutter) Speed up Android scope sync and replay capture by @buenaflor in #3924

Dependencies

Deps

• chore(deps): update Native SDK to v0.16.1 by @github-actions in #3937
• chore(deps): update Android SDK to v8.51.0 by @github-actions in #3938

Internal Changes

• (deps) Pin Flutter development dependencies by @buenaflor in #3913
• (grpc) Move MockHub to _sentry_testing package by @lucas-zimerman in #3908