sentry-expo deprecations plans

[krystofwoldrich]

sentry-expo is not deprecated yet and fully supports the current React Native 0.72 but likely won't get any new features, those will be added to sentry-react-native. This issue summarizes the deprecation plans.

• Previous Expo improvements project Expo support improvements #3102

In Progress

Beta Give feedback

1. React Native for Web #2083
   Platform: React-Native Type: Feature Request +2
2. [metro-config] pass in custom serializer to expo default config expo/expo#25810
   bot: fingerprint changed bot: suggestions +2
3. [metro-config] experimental pre-serialization plugins expo/expo#25859
   bot: fingerprint compatible bot: passed checks published +3
4. Add Sentry Metro Plugin for Expo sentry-wizard#498
   Platform: React-Native Status: Stale +2
   
5. feat(expo): Dynamically resolve default integrations based on platform #3465
   +0
   
6. feat(expo): Add Expo Modules Integration #3466
   +0
   

MVP to deprecate sentry-expo

Beta Give feedback

1. Verify unhandled rejected promise tracking in Expo Go/Expo builds
2. add Expo config plugin #3391
   +0
   
3. Support Expo Go (rewrite frames, only JS)
4. Update Expo Plugin to use Sentry Xcode shell scripts #3394
   Platform: React-Native +1
   
5. React-native-web build fails on sentry-react-native import #3101
   Expo Platform: React-Native sentry-expo +3
   
6. Create @sentry/react-native/expo for simple plugin import #3393
   Platform: React-Native +1
   
7. Add Expo RewriteFrames to sentry-react-native to better support Expo Bare workflow #3081
   Expo Platform: React-Native sentry-expo +3
   

Docs updates

Beta Give feedback

1. Add Expo OTA Update source maps upload to Sentry Docs
2. Add migration docs to Expo Docs
3. Add migration docs to Sentry Docs
4. Add Expo manual setup steps sentry-docs#8631
   +0
5. [docs] SDK 50 guide for Sentry expo/expo#25712
   bot: passed checks preview +2
6. Add deprecation notice and migration guide expo/sentry-expo#385
   +0

Future expo features

Beta Give feedback

1. Web development events are not symbolicated locally #3646
   Platform: React-Native +1
2. Upload Sourcemaps from eas update #3363
   Expo Platform: React-Native Type: Feature Request +3
3. Don't create spans for Dev Servers requests #3210
   Expo Platform: React-Native Type: 🪲 Bug +3
4. Expose helper function to set dist to EAS Update ID #3647
   Platform: React-Native +1
5. Add support for Source Maps Debug ID in Hermes bundle #2947
   5 of 5
   Platform: React-Native +1
   
6. react-native wizard for Expo projects sentry-wizard#285
   Platform: React-Native Status: Stale +2
7. Capture start up crashes by default (auto init native SDKs before JS) #3608
   0 of 7
   Platform: React-Native +1

Not planned to be migrated

• ExpoBareIntegration (frames rewrite will be migrated, for additional tags, extras, and other event data will be supplied guide on how can be added by users)
• ExpoManagedIntegration (frames rewrite will be migrated, for additional tags, extras, and other event data will be supplied guide on how can be added by users)
• Post publish hook config used to set Sentry org, project, and authToken (will be replaced by envs or new solution)

Internal Notion notes

[brentvatne]

thanks for putting this together and for the help here @krystofwoldrich! only feedback I have is re: Expo managed frames / Expo bare frames - those names in our sentry-expo repo are kind of misleading so I'll attempt to clarify that here:

the "Expo managed" integration should be called "Expo Go" (this app is a sandbox for learning/experimenting, I think even supporting it in Sentry is optional and I wouldn't be opposed to dropping that)

the "Expo bare" integration could just be called "Expo" (any app with the Expo SDK installed will work the same, no need to differentiate between managed or bare)

[krystofwoldrich]

@brentvatne Thank you for the context, I agree "Expo Go" is a lower priority (as Sentry is oriented on production bugs), but to keep a good dev experience, we would like the JS error captured during development in Expo Go to be correctly reported (source mapped) in Sentry.

[shanamatthews]

Hey @krystofwoldrich - I'm assuming this will need at least a small docs change to the Expo section of docs. Just want to make sure that's it!

[krystofwoldrich]

@shanamatthews Yes, this will need a few changes in the docs, not only the Expo section but also a migration guide from the sentry-expo package to sentry-react-native.

[felix-lambert]

@krystofwoldrich Hello the sourcemap is still not being uploaded. Can we have instruction on how to upload the sourcemap with sentry? On older version of expo I didn't have this problem. It has now been a few months i'm using expo and sentry without sourcemaps. The sourcemap seems to upload well on the web app version but not on android or ios :)

[krystofwoldrich]

@felix-lambert Hi, thank you for the message, could you share what Sentry SDK version and Expo version are you using and how you build the app?

The auto upload was fixed in the latest release of https://github.com/expo/sentry-expo/releases/tag/v7.1.1.

[felix-lambert]

I tried the latest release and it has been fixed. The sourcemap seems to upload well to sentry on android and ios now. Well done ! :)

[krystofwoldrich]

@sentry/react-native now supports Expo out of the box!

Update to https://github.com/getsentry/sentry-react-native/releases/tag/5.16.0 or newer to get all the new features.

Migration guides available:

• https://github.com/expo/fyi/blob/main/sentry-expo-migration.md
• https://docs.sentry.io/platforms/react-native/migration/sentry-expo/

[natasxa]

Can you help me with the error: "PluginError: Failed to resolve plugin for module "@sentry/react-native/expo" ..."
Updated app to expo SDK 50 and now trying to update sentry-expo to @sentry/react-native...

[paulmthiebauth]

Can you help me with the error: "PluginError: Failed to resolve plugin for module "@sentry/react-native/expo" ..." Updated app to expo SDK 50 and now trying to update sentry-expo to @sentry/react-native...

Dealing with the same error right now trying to upgrade SDK. Added entry to plugins in app.config.ts as the migration guide says is fine

[brentvatne]

@natasxa @paulmthiebauth - do you have @sentry/react-native installed in your project? which version?

[natasxa]

@brentvatne sure I do, "@sentry/react-native": "5.10.0"