Upgrade to Sentry 9.22, add Web View + OTLP journeys, enable Web & macOS

[Prithvirajkumar]

Summary

Brings the Empower Plant Flutter demo up to the latest Sentry SDK (9.22.0) and meaningfully broadens its platform and feature coverage:

• Web View journey that demonstrates Flutter → web distributed tracing into the Empower Plant React app.
• OTLP journey that routes the app's backend calls to the OpenTelemetry-instrumented backend.
• Web and macOS builds now work (the code is made web-safe and macOS gets the network entitlement).
• Build/tooling improvements (AGP bump, a distribute command for Sentry Build Distribution, source-map path fix).
• Several UX fixes (real cart prices, product-grid layout on wide screens, clearer interaction spans).

All docs (README, CLAUDE, BUILD_GUIDE, SENTRY_FEATURES, SIZE_ANALYSIS_GUIDE) are updated to match.

---

Sentry SDK upgrade

• sentry_flutter / sentry_dio / sentry_file / sentry_logging: 9.14.0 → 9.22.0
• sentry_dart_plugin: 3.1.0 → 3.4.0
• App version: → 9.22.0+1 (still matches the SDK version), options.dist = '1'
• Sentry.metrics / enableMetrics still compile on 9.22 — no migration needed.
• Added options.tracePropagationTargets = ['empower-plant.com', 'flask.empower-plant.com', 'flask-otlp.empower-plant.com', 'localhost'].

Web View journey — Flutter → web distributed tracing

New drawer item "Web View" opens the React app (https://empower-plant.com/products) cross-platform:

• Android/iOS: in-app webview_flutter
• Flutter web: dart:ui_web iframe
• Desktop (macOS/Windows/Linux): system browser via url_launcher

It starts its own transaction (webview/empower-plant, op navigation) on a fresh trace, and attaches the active sentry-trace / baggage to the loaded URL as query params so the page's browser SDK can continue the same trace. The screen owns and binds its transaction (bindToScope: true) and finishes it on page load, so the Flutter span reliably lands in the trace.

Note: the browser SDK can only continue a trace from <meta> tags / params, not request headers — hence the URL-param handoff. To fully connect into the live React app, the React side must read those params (separate change in sentry-demos/empower); verified locally end-to-end (Flutter → React /products pageload → flask backend, one trace).

New code: lib/webview/ (web_view_screen.dart, web_view_io.dart, web_view_web.dart, trace_headers.dart). The target URL is kWebViewUrl in web_view_screen.dart.

OTLP backend journey

New drawer item "OTLP" runs the home/shopping experience but routes all backend calls (/products, /checkout) to the OpenTelemetry backend https://flask-otlp.empower-plant.com as its own new trace, so the trace continues into the OTLP-instrumented backend. Backend selection is centralized in lib/backend_config.dart (BackendConfig.base / .products / .checkout).

Web & macOS support

• Web-safe code: removed dart:io from the shared/web path via conditional-import modules in lib/platform/ (platform_info.dart, native_info_{io,web}.dart, file_io_demo{,_io,_web}.dart). Shared code now uses kIsWeb / defaultTargetPlatform instead of Platform.*. flutter build web / flutter run -d chrome work.
• macOS: added com.apple.security.network.client to DebugProfile.entitlements and Release.entitlements (sandboxed apps need it to reach the backend + Sentry). flutter run -d macos works.

Build / tooling

• AGP 8.7.3 → 8.9.1 in android/settings.gradle.kts (required by the androidx libs that webview_flutter/url_launcher pull in; Gradle wrapper 8.12).
• demo.sh:
  • New ./demo.sh distribute <android|aab|ios> [file] → uploads a build to Sentry Build Distribution (sentry-cli build upload).
  • load_env now sources .env (handles inline comments / special chars) instead of the fragile export $(grep …).
  • upload_size_analysis omits --base-sha when it equals head-sha (Sentry rejects equal SHAs).
• sentry: web_build_path → web (the plugin prepends the build dir, so build/web resolved wrongly to build/build/web; web source maps now upload).
• Includes the Flutter 3.44 migrations applied during the upgrade (iOS UIScene migration, builtInKotlin/newDsl gradle flags, plugin registrants for the new plugins).

UX fixes

• Cart shows real prices (e.g. $155.00) — removed the UI _maskPrice helper. Financial values are still masked only in Session Replay via the existing maskCallback, so real users see real prices while replays stay private.
• Product grid layout: the home grid derived its childAspectRatio from the window size, which produced enormous tiles on wide web/desktop windows (products pushed far down). Now uses a stable aspect ratio + max-width cap.
• The drawer button now has an explicit key so its interaction span reads ui.action.click - open_navigation_menu instead of the cryptic built-in StandardComponentType.drawerButton.

New dependencies

webview_flutter ^4.13.0, url_launcher ^6.3.1, web ^1.1.1.

---

Testing / verification

• flutter analyze clean (only the SDK's intended experimental-API warnings).
• Built & ran on Android emulator, iOS Simulator, macOS, and Chrome (web).
• Release build + symbol upload verified: release empower_flutter@9.22.0+1 with Dart symbol maps, native debug symbols, and ProGuard mapping uploaded.
• Distributed tracing verified locally end-to-end: opening the Web View produced a single trace spanning the Flutter webview/empower-plant transaction → React /products pageload → flask backend spans.

Notes for reviewers

• lib/se_config.dart sets the SE tag to the repo default tda (SEs should not commit their own name; change locally only if needed).
• Full Flutter→web distributed tracing in production also requires the React app to continue the incoming trace from the URL params (companion change in sentry-demos/empower).
• The OTLP journey depends on flask-otlp.empower-plant.com being available; when it's down you'll see expected SentryHttpClientError 503s (captured by captureFailedRequests).

🤖 Generated with Claude Code