sentry-react-native

Fixes

• Missing RNSentryOnDrawReporterView on iOS (#3832)

Dependencies

• Bump Cocoa SDK from v8.25.0 to v8.26.0 (#3802, #3815)
  • changelog
  • diff

Fixes

• Pass replaysSessionSampleRate option to Android (#3714)

Access to Mobile Replay is limited to early access orgs on Sentry. If you're interested, sign up for the waitlist

Dependencies

• Bump CLI from v2.30.4 to v2.31.2 (#3719)
  • changelog
  • diff
• Bump Cocoa SDK from v8.25.0 to v8.25.2 (#3802)
  • changelog
  • diff

Fixes

• Remove tunnel from SDK Options (#3787)
• Fix Apple non UIKit builds (#3784)

Dependencies

• Bump JavaScript SDK from v7.110.1 to v7.113.0 (#3768)
  • changelog
  • diff

Dependencies

• Bump Cocoa SDK from v8.24.0 to v8.25.0 (#3790)
  • changelog
  • diff

Features

• Mobile Session Replay Alpha (#3714)

  To enable Replay for React Native on mobile and web add the following options.

  Sentry.init({
    _experiments: {
      replaysSessionSampleRate: 1.0,
      replaysOnErrorSampleRate: 1.0,
    },
  });
  

  To change the default Mobile Replay options add the mobileReplayIntegration.

  Sentry.init({
    _experiments: {
      replaysSessionSampleRate: 1.0,
      replaysOnErrorSampleRate: 1.0,
    },
    integration: [
      Sentry.mobileReplayIntegration({
        maskAllText: true,
        maskAllImages: true,
      }),
    ],
  });
  

  Access is limited to early access orgs on Sentry. If you're interested, sign up for the waitlist

Dependencies

• Bump Cocoa SDK to 8.25.0-alpha.0
• Bump Android SDK to 7.9.0-alpha.1

Features

• Updated metric normalization from @sentry/core (#11519)
• Metric rate limiting from sentry-cocoa and sentry-android

Dependencies

• Bump Cocoa SDK from v8.21.0 to v8.24.0 (#3686, #3696)
  • changelog
  • diff
• Bump Android SDK from v7.6.0 to v7.8.0 (#3750)
  • changelog
  • diff
• Bump JavaScript SDK from v7.100.1 to v7.110.1 (#3601, #3758)
  • changelog
  • diff

Features

• Add getDefaultConfig option to getSentryExpoConfig (#3690)
• Add beforeScreenshot option to ReactNativeOptions (#3715)

Fixes

• Do not enable NativeFramesTracking when native is not available (#3705)
• Do not initialize the SDK during expo-router static routes generation (#3730)
• Cancel spans in background doesn't crash in environments without AppState (#3727)
• Fix missing Stall measurements when using new .end() span API (#3737)
• Change TimeToDisplay unsupported log from error to warning level. (#3699)

Dependencies

• Bump CLI from v2.30.0 to v2.30.4 (#3678, #3704)
  • changelog
  • diff
• Bump Android SDK from v7.5.0 to v7.6.0 (#3675)
  • changelog
  • diff

Features

• Automatic tracing of time to initial display for react-navigation (#3588)

  When enabled the instrumentation will create TTID spans and measurements.
  The TTID timestamp represent moment when the react-navigation screen
  was rendered by the native code.

  const routingInstrumentation = new Sentry.ReactNavigationInstrumentation({
    enableTimeToInitialDisplay: true,
  });
  
  Sentry.init({
    integrations: [new Sentry.ReactNativeTracing({routingInstrumentation})],
  });
  

• Tracing of full display using manual API (#3654)

  In combination with the react-navigation automatic instrumentation you can record when
  the application screen is fully rendered.

  For more examples and manual time to initial display see the documentation.

  function Example() {
    const [loaded] = React.useState(false);
  
    return <View>
      <Sentry.TimeToFullDisplay record={loaded}>
        <Text>Example content</Text>
      </Sentry.TimeToFullDisplay>
    </View>;
  }
  

Fixes

• Allow custom sentryUrl for Expo updates source maps uploads (#3664)
• Missing Mobile Vitals (slow, frozen frames) when ActiveSpan (Transaction) is trimmed at the end (#3684)

Fixes

• Multiple Debug IDs can be loaded into the global polyfill (#3660)
  • This fixes a symbolication issue with Expo on the web with enabled bundle splitting.

Dependencies

• Bump CLI from v2.25.2 to v2.30.0 (#3534, #3666)
  • changelog
  • diff
• Bump Cocoa SDK from v8.20.0 to v8.21.0 (#3651)
  • changelog
  • diff
• Bump Android SDK from v7.3.0 to v7.5.0 (#3615)
  • changelog
  • diff

Fixes

• expo-upload-sourcemaps now works on Windows (#3643)
• Option enabled: false ensures no events are sent (#3606)
• Ignore JSON response when retrieving source context from local Expo Dev Server (#3611)
• Upload native debug files only for non-debug builds (#3649)
• TurboModuleRegistry should not be imported in web applications (#3610)

Dependencies

• Bump Cocoa SDK from v8.17.1 to v8.20.0 (#3476)
  • changelog
  • diff

Fixes

• Don't add Expo Plugin option authToken to application bundle (#3630)
  • Expo plugin configurations are generelly stored in plain text, and are also automatically added to built app bundles, and are therefore considered insecure.
  • You should not set the auth token in the plugin config except for local testing. Instead, use the SENTRY_AUTH_TOKEN env variable, as pointed out in our docs.
  • In addition to showing a warning, we are now actively removing an authToken from the plugin config if it was set.
  • If you had set the auth token in the plugin config previously, and built and published an app with that config, you should rotate your token.
• Reduce waning messages spam when a property in Expo plugin configuration is missing (#3631)
• Add concrete error messages for RN bundle build phase patch (#3626)

This release contains upgrade of sentry-android dependency to major version 7. There are no breaking changes in the JS API. If you are using the Android API please check the migration guide.

Features

• Add Android profiles to React Native Profiling (#3397)

• Add Sentry.metrics (#3590)

  To learn more, see the Set Up Metrics guide.

  import * as Sentry from '@sentry/react-native';
  
  Sentry.init({
    dsn: '___DSN___',
    integrations: [
      Sentry.metrics.metricsAggregatorIntegration(),
    ],
  });
  
  Sentry.metrics.increment("button_click", 1, {
    tags: { system: "iOS", app_version: "1.0.0" },
  });
  

Fixes

• Upload Debug Symbols Build Phase continues when node not found in WITH_ENVIRONMENT (#3573)
• Fix proguardUuid loading on Android (#3591)

Dependencies

• Bump Android SDK from v6.34.0 to v7.3.0 (#3434)
  • changelog
  • diff
• Bump JavaScript SDK from v7.81.1 to v7.100.1 (#3426, #3589)
  • changelog
  • diff

Features

• Add @spotlightjs/spotlight support (#3550)

  Download the Spotlight desktop application and add the integration to your Sentry.init.

  import * as Sentry from '@sentry/react-native';
  
  Sentry.init({
    dsn: '___DSN___',
    enableSpotlight: __DEV__,
  });
  

• Only upload Expo artifact if source map exists (#3568)

• Read .env file in sentry-expo-upload-sourcemaps (#3571)

Fixes

• Prevent pod install crash when visionos is not present (#3548)
• Fetch Organization slug from @sentry/react-native/expo config when uploading artifacts (#3557)
• Remove 404 Http Client Errors reports for Metro Dev Server Requests (#3553)
• Stop tracing Spotlight Sidecar network request in JS (#3559)

Features

• New Sentry Metro configuration function withSentryConfig (#3478)

  • Ensures all Sentry configuration is added to your Metro config
  • Includes createSentryMetroSerializer
  • Collapses Sentry internal frames from the stack trace view in LogBox

  const { getDefaultConfig } = require('@react-native/metro-config');
  const { withSentryConfig } = require('@sentry/react-native/metro');
  
  const config = getDefaultConfig(__dirname);
  module.exports = withSentryConfig(config);
  

• Add experimental visionOS support (#3467)

  • To set up react-native-visionos with the Sentry React Native SDK follow the standard iOS guides.
  • Xcode project is located in visionos folder instead of ios.

Fixes

• Fix WITH_ENVIRONMENT overwrite in sentry-xcode-debug-files.sh (#3525)
• Sentry CLI 2.25.1 fixes background debug files uploads during Xcode builds (#3486)
• Performance Tracing should be disabled by default (#3533)
• Use $NODE_BINARY to execute Sentry CLI in Xcode scripts (#3493)
• Return auto Release and Dist to source maps auto upload (#3540)

Dependencies

• Bump CLI from v2.23.0 to v2.25.2 (#3486)
  • changelog
  • diff

This release ships with a beta version of our new built-in Expo SDK 50 support, which replaces the deprecated sentry-expo package. To learn more, see the Expo guide.

Features

• New @sentry/react-native/expo Expo config plugin (#3429)

  const { withSentry } = require('@sentry/react-native/expo');
  
  const config = {...};
  
  module.exports = withSentry(config, {
    url: 'https://www.sentry.io/',
    authToken: 'example-token', // Or use SENTRY_AUTH_TOKEN env
    project: 'project-slug', // Or use SENTRY_PROJECT env
    organization: 'org-slug', // Or use SENTRY_ORG env
  });
  

  • And Sentry.init in App.js

  import * as Sentry from '@sentry/react-native';
  
  Sentry.init({
    dsn: '__DSN__',
  });
  

• New getSentryExpoConfig for simple Metro configuration (#3454, #3501, #3514)

  • This function is a drop in replacement for getDefaultConfig from expo/metro-config

  // const { getDefaultConfig } = require("expo/metro-config");
  const { getSentryExpoConfig } = require("@sentry/react-native/metro");
  
  // const config = getDefaultConfig(__dirname);
  const config = getSentryExpoConfig(config, {});
  

• New npx sentry-expo-upload-sourcemaps for simple EAS Update (npx expo export) source maps upload (#3491, #3510, #3515, #3507)

  SENTRY_PROJECT=project-slug \
  SENTRY_ORG=org-slug \
  SENTRY_AUTH_TOKEN=super-secret-token \
  npx sentry-expo-upload-sourcemaps dist
  

Others

• Update sentry-xcode.sh scripts with Node modules resolution (#3450)
  • RN SDK and Sentry CLI are dynamically resolved if override is not supplied
• Resolve Default Integrations based on current platform (#3465)
  • Native Integrations are only added if Native Module is available
  • Web Integrations only for React Native Web builds
• Remove Native Modules warning from platform where the absence is expected (#3466)
• Add Expo Context information using Expo Native Modules (#3466)
• Errors from InternalBytecode.js are no longer marked as in_app (#3518)
• Fix system node can't be overwritten in sentry-xcode-debug-files.sh (#3523)

Fixes

• Make getSentryExpoConfig options parameter optional (#3514)
• Use @sentry/react-native/expo as plugin name in expo-upload-sourcemaps.js (#3515)

This release is compatible with [email protected] and newer.

Features

• withSentryExpoSerializers changes to getSentryExpoConfig (#3501)

  • getSentryExpoConfig accepts the same parameters as getDefaultConfig from expo/metro-config and returns Metro configuration
  • This also works for EAS Updates (and expo export). Debug ID is generated by expo/metro-config and used by Sentry.

  const { getSentryExpoConfig } = require("@sentry/react-native/metro");
  const config = getSentryExpoConfig(config);
  

• Add npx sentry-expo-upload-sourcemaps for simple EAS Update (expo export) source maps upload to Sentry (#3491, #3510)

  SENTRY_PROJECT=project-slug \
  SENTRY_ORG=org-slug \
  SENTRY_AUTH_TOKEN=super-secret-token \
  npx sentry-expo-upload-sourcemaps dist
  

• Sentry CLI binary path in scripts/expo-upload-sourcemaps.js is resolved dynamically (#3507)

  • Or can be overwritten by SENTRY_CLI_EXECUTABLE env

• Resolve Default Integrations based on current platform (#3465)

  • Native Integrations are only added if Native Module is available
  • Web Integrations only for React Native Web builds

• Remove Native Modules warning from platform where the absence is expected (#3466)

• Add Expo Context information using Expo Native Modules (#3466)

Fixes

• Includes fixes from version 5.15.2

Fixes

• Stop sending navigation route params for auto-generated transactions, as they may contain PII or other sensitive data (#3487)
  • Further details and other strategies to mitigate this issue can be found on our trouble shooting guide page

Features

• Add withSentryExpoSerializers for easy configurable metro.config.js (#3454)

  This Serializer doesn't support EAS Updates (and expo export) commands yet. Debug IDs needed for source maps resolution in Sentry
  are generated only during native builds.

  const { getDefaultConfig } = require('expo/metro-config');
  const { withSentryExpoSerializers } = require("@sentry/react-native/metro");
  
  const config = getDefaultConfig(__dirname);
  module.exports = withSentryExpoSerializers(config);
  

  Note that this will remove any existing customSerializer. Guide for advanced setups can be found here.

Fixes

• Expo SDK minimum version is 49 (#3453)
• Remove RN Internal imports for RN Web builds (#3462)
• Remove circular dependencies inside of the SDK (#3464)
• Includes fixes from version 5.15.1

Fixes

• Sentry CLI upgrade resolves Xcode Could timeout during source maps upload #3390

Dependencies

• Bump CLI from v2.21.3 to v2.23.0 (#3390)
  • changelog
  • diff