feat(core): Add `disableAutoUpload` option to Expo plugin by antonis · Pull Request #6195 · getsentry/sentry-react-native

antonis · 2026-05-21T08:31:55Z

📢 Type of change

Bugfix
New feature
Enhancement
Refactoring

📜 Description

Adds a disableAutoUpload option to the Expo plugin (withSentry) that disables source map and debug symbol uploads at build time.

withSentry(config, {
  organization: "my-org",
  project: "my-project",
  disableAutoUpload: true,
});

iOS: Injects export SENTRY_DISABLE_AUTO_UPLOAD=true into both Xcode build phase shell scripts ("Bundle React Native code and images" and "Upload Debug Symbols to Sentry"). This means the env var is baked into the Xcode project after expo prebuild, so builds from the Xcode GUI work without needing env var access.

Android: Overrides project.ext.shouldSentryAutoUploadGeneral to return false in build.gradle, bypassing the System.getenv check in sentry.gradle.

Both platforms handle re-prebuild (already configured projects) and are idempotent — running prebuild multiple times with the option enabled won't duplicate the injected code.

Note: This option permanently disables uploads for all builds from the generated native project. To re-enable uploads, remove the option and run npx expo prebuild --clean. For per-build control, users should use the SENTRY_DISABLE_AUTO_UPLOAD env var instead.

💡 Motivation and Context

Closes #3552

Expo managed workflow users building from the Xcode GUI after expo prebuild cannot easily set the SENTRY_DISABLE_AUTO_UPLOAD environment variable, which causes upload failure warnings during local development builds. While workarounds exist (CLI env var prefix, EAS build profiles), a first-class plugin option provides a better developer experience.

💚 How did you test it?

11 new unit tests covering:
- Bundle phase: fresh prebuild, re-prebuild, idempotency, disableAutoUpload: false no-op
- Debug files phase: JSON-encoded scripts, raw string fallback, idempotency
- Android: fresh prebuild, re-prebuild, idempotency
- Newline correctness (real \n vs literal \\n after JSON round-trip)
All 56 expo plugin tests pass
Full test suite passes (296 tests)
Lint, circular dep check, and API report all pass

📝 Checklist

I added tests to verify changes
No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled
I updated the docs if needed docs(react-native): Document disableAutoUpload Expo plugin option sentry-docs#17830
I updated the wizard if needed.
All tests passing
No breaking changes

🔮 Next steps

Closes #3552 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

github-actions · 2026-05-21T08:32:18Z

Semver Impact of This PR

⚪ None (no version bump detected)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).

feat(core): Add disableAutoUpload option to Expo plugin by antonis in #6195

feat(core): Expose pauseAppHangTracking and resumeAppHangTracking APIs by antonis in #6192

_{🤖 This preview updates automatically when you update the PR.}

github-actions · 2026-05-21T08:32:38Z

	Messages
📖	Do not forget to update Sentry-docs with your feature once the pull request gets approved.

Generated by 🚫 dangerJS against 17fd04f

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

antonis · 2026-05-21T08:34:50Z

@sentry review

cursor

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit e359bd2. Configure here.}

github-actions · 2026-05-21T09:02:21Z

Android (legacy) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	413.27 ms	433.51 ms	20.24 ms
Size	48.30 MiB	53.58 MiB	5.28 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
`bc0d8cf`+dirty	412.37 ms	466.26 ms	53.89 ms
`b9bebee`+dirty	438.86 ms	452.21 ms	13.35 ms
`5c1e987`+dirty	423.52 ms	471.64 ms	48.12 ms
`71abba0`+dirty	496.54 ms	525.16 ms	28.63 ms
`5569641`+dirty	406.43 ms	428.51 ms	22.08 ms
`3b6e9f9`+dirty	442.70 ms	486.44 ms	43.74 ms
`6177334`+dirty	408.16 ms	441.14 ms	32.98 ms
`2c735cc`+dirty	414.09 ms	438.47 ms	24.38 ms
`ef27341`+dirty	412.94 ms	443.98 ms	31.04 ms
`0d9949d`+dirty	403.57 ms	437.00 ms	33.43 ms

App size

Revision	Plain	With Sentry	Diff
`bc0d8cf`+dirty	48.30 MiB	53.48 MiB	5.18 MiB
`b9bebee`+dirty	48.30 MiB	53.58 MiB	5.28 MiB
`5c1e987`+dirty	43.75 MiB	48.08 MiB	4.33 MiB
`71abba0`+dirty	48.30 MiB	53.49 MiB	5.19 MiB
`5569641`+dirty	48.30 MiB	53.48 MiB	5.18 MiB
`3b6e9f9`+dirty	48.30 MiB	53.54 MiB	5.23 MiB
`6177334`+dirty	48.30 MiB	53.54 MiB	5.23 MiB
`2c735cc`+dirty	43.75 MiB	48.08 MiB	4.33 MiB
`ef27341`+dirty	48.30 MiB	53.54 MiB	5.24 MiB
`0d9949d`+dirty	43.75 MiB	48.13 MiB	4.37 MiB

sentry · 2026-05-21T09:04:32Z

📲 Install Builds

Android

🔗 App Name	App ID	Version	Configuration
Sentry RN	io.sentry.reactnative.sample	8.12.0 (89)	Release

⚙️ sentry-react-native Build Distribution Settings

github-actions · 2026-05-21T09:06:41Z

iOS (legacy) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	3840.54 ms	1226.27 ms	-2614.27 ms
Size	5.15 MiB	6.68 MiB	1.53 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
`3817909`+dirty	1183.90 ms	1187.50 ms	3.60 ms
`44c8b3f`+dirty	3823.85 ms	1207.66 ms	-2616.19 ms
`b0d3373`+dirty	3831.75 ms	1227.29 ms	-2604.46 ms
`7d6fd3a`+dirty	1223.29 ms	1229.57 ms	6.28 ms
`6176a94`+dirty	3836.50 ms	1217.64 ms	-2618.86 ms
`5c1e987`+dirty	1204.30 ms	1222.15 ms	17.85 ms
`3d377b5`+dirty	1218.48 ms	1219.51 ms	1.03 ms
`7d8c8bd`+dirty	3837.24 ms	1215.51 ms	-2621.73 ms
`4966363`+dirty	3854.04 ms	1231.55 ms	-2622.50 ms
`5fe1c6c`+dirty	1220.79 ms	1217.63 ms	-3.16 ms

App size

Revision	Plain	With Sentry	Diff
`3817909`+dirty	3.38 MiB	4.73 MiB	1.35 MiB
`44c8b3f`+dirty	5.15 MiB	6.66 MiB	1.51 MiB
`b0d3373`+dirty	5.15 MiB	6.68 MiB	1.53 MiB
`7d6fd3a`+dirty	3.38 MiB	4.77 MiB	1.39 MiB
`6176a94`+dirty	5.15 MiB	6.68 MiB	1.53 MiB
`5c1e987`+dirty	3.38 MiB	4.73 MiB	1.35 MiB
`3d377b5`+dirty	3.38 MiB	4.76 MiB	1.38 MiB
`7d8c8bd`+dirty	5.15 MiB	6.68 MiB	1.53 MiB
`4966363`+dirty	5.15 MiB	6.68 MiB	1.53 MiB
`5fe1c6c`+dirty	3.38 MiB	4.77 MiB	1.39 MiB

github-actions · 2026-05-21T09:14:38Z

iOS (new) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	3836.13 ms	1220.02 ms	-2616.11 ms
Size	5.15 MiB	6.68 MiB	1.53 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
`3817909`+dirty	1210.76 ms	1215.64 ms	4.89 ms
`44c8b3f`+dirty	3849.24 ms	1209.94 ms	-2639.31 ms
`b0d3373`+dirty	3842.49 ms	1218.49 ms	-2624.00 ms
`7d6fd3a`+dirty	1210.89 ms	1217.63 ms	6.74 ms
`6176a94`+dirty	3854.15 ms	1221.77 ms	-2632.38 ms
`5c1e987`+dirty	1208.43 ms	1220.72 ms	12.29 ms
`3d377b5`+dirty	1201.55 ms	1201.80 ms	0.25 ms
`7d8c8bd`+dirty	3847.98 ms	1230.77 ms	-2617.21 ms
`4966363`+dirty	3863.07 ms	1227.19 ms	-2635.88 ms
`5fe1c6c`+dirty	1201.36 ms	1209.15 ms	7.78 ms

App size

Revision	Plain	With Sentry	Diff
`3817909`+dirty	3.38 MiB	4.73 MiB	1.35 MiB
`44c8b3f`+dirty	5.15 MiB	6.66 MiB	1.51 MiB
`b0d3373`+dirty	5.15 MiB	6.68 MiB	1.53 MiB
`7d6fd3a`+dirty	3.38 MiB	4.77 MiB	1.39 MiB
`6176a94`+dirty	5.15 MiB	6.68 MiB	1.53 MiB
`5c1e987`+dirty	3.38 MiB	4.73 MiB	1.35 MiB
`3d377b5`+dirty	3.38 MiB	4.76 MiB	1.38 MiB
`7d8c8bd`+dirty	5.15 MiB	6.68 MiB	1.53 MiB
`4966363`+dirty	5.15 MiB	6.68 MiB	1.53 MiB
`5fe1c6c`+dirty	3.38 MiB	4.77 MiB	1.39 MiB

github-actions · 2026-05-21T09:19:24Z

Android (new) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	514.74 ms	548.31 ms	33.57 ms
Size	48.30 MiB	53.58 MiB	5.28 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
`b9bebee`+dirty	500.50 ms	536.42 ms	35.92 ms
`71abba0`+dirty	411.04 ms	453.67 ms	42.63 ms
`5569641`+dirty	465.92 ms	532.22 ms	66.30 ms
`3b6e9f9`+dirty	442.39 ms	486.44 ms	44.05 ms
`6177334`+dirty	404.80 ms	456.74 ms	51.94 ms
`ef27341`+dirty	519.02 ms	553.42 ms	34.40 ms
`23598c3`+dirty	371.92 ms	420.65 ms	48.74 ms
`a0d8cf8`+dirty	533.71 ms	564.25 ms	30.54 ms
`7ac3378`+dirty	410.67 ms	442.60 ms	31.92 ms
`c004dae`+dirty	404.60 ms	430.67 ms	26.07 ms

App size

Revision	Plain	With Sentry	Diff
`b9bebee`+dirty	48.30 MiB	53.58 MiB	5.28 MiB
`71abba0`+dirty	48.30 MiB	53.49 MiB	5.19 MiB
`5569641`+dirty	48.30 MiB	53.48 MiB	5.18 MiB
`3b6e9f9`+dirty	48.30 MiB	53.54 MiB	5.23 MiB
`6177334`+dirty	48.30 MiB	53.54 MiB	5.23 MiB
`ef27341`+dirty	48.30 MiB	53.54 MiB	5.24 MiB
`23598c3`+dirty	43.94 MiB	49.02 MiB	5.08 MiB
`a0d8cf8`+dirty	48.30 MiB	53.49 MiB	5.19 MiB
`7ac3378`+dirty	43.94 MiB	48.99 MiB	5.05 MiB
`c004dae`+dirty	48.30 MiB	53.49 MiB	5.19 MiB

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 00340cc. Configure here.}

…iters On re-prebuild, addDisableAutoUploadToExistingScript was prepending the export before the " delimiter that wraps shell script content in pbxproj files. This places it inside the delimiter, consistent with the fresh-prebuild path. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

lucas-zimerman · 2026-05-21T12:25:20Z

  authToken?: string;
  url?: string;
  useNativeInit?: boolean;
+  disableAutoUpload?: boolean;


might be worth checking the warden checks, not sure why it didnt post as a comment

Thank you for catching this @lucas-zimerman. Updated with eaa6ae2

…alse When disableAutoUpload was set to true and then changed back to false, the injected export/override was left in place on re-prebuild, silently keeping uploads disabled. Now both iOS and Android remove the injection when disableAutoUpload is false. Also removes the misleading "script already exists" warning that fired after successfully injecting the auto-upload export on iOS. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

feat(core): Add disableAutoUpload option to Expo plugin

34e421a

Closes #3552 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

docs: Add changelog entry for disableAutoUpload

e359bd2

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

cursor Bot reviewed May 21, 2026

View reviewed changes

sentry-warden Bot reviewed May 21, 2026

View reviewed changes

Comment thread packages/core/plugin/src/withSentryAndroid.ts

sentry-warden Bot reviewed May 21, 2026

View reviewed changes

Comment thread packages/core/plugin/src/withSentryAndroid.ts

antonis mentioned this pull request May 21, 2026

docs(react-native): Document disableAutoUpload Expo plugin option getsentry/sentry-docs#17830

Open

6 tasks

antonis added the ready-to-merge Triggers the full CI test suite label May 21, 2026

antonis marked this pull request as ready for review May 21, 2026 09:00

antonis requested review from alwx and lucas-zimerman as code owners May 21, 2026 09:00

antonis removed the ready-to-merge Triggers the full CI test suite label May 21, 2026

antonis added 2 commits May 21, 2026 11:39

Merge branch 'main' into feat/expo-disable-auto-upload

f46bd99

Fix changelog

00340cc

antonis commented May 21, 2026

View reviewed changes

Comment thread CHANGELOG.md Outdated

cursor Bot reviewed May 21, 2026

View reviewed changes

Comment thread packages/core/plugin/src/withSentryIOS.ts

lucas-zimerman reviewed May 21, 2026

View reviewed changes

antonis and others added 3 commits May 21, 2026 14:52

Merge branch 'main' into feat/expo-disable-auto-upload

59c17bf

style(core): Fix formatting in withSentryAndroid

17fd04f

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

antonis marked this pull request as draft May 21, 2026 14:42

antonis added the ready-to-merge Triggers the full CI test suite label May 21, 2026

antonis marked this pull request as ready for review May 21, 2026 14:46

antonis requested a review from lucas-zimerman May 21, 2026 15:37

Uh oh!

Conversation

antonis commented May 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📢 Type of change

📜 Description

💡 Motivation and Context

💚 How did you test it?

📝 Checklist

🔮 Next steps

Uh oh!

github-actions Bot commented May 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Semver Impact of This PR

Uh oh!

github-actions Bot commented May 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

antonis commented May 21, 2026

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented May 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Android (legacy) Performance metrics 🚀

Baseline results on branch: main

Startup times

App size

Uh oh!

sentry Bot commented May 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📲 Install Builds

Android

Uh oh!

github-actions Bot commented May 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

iOS (legacy) Performance metrics 🚀

Baseline results on branch: main

Startup times

App size

Uh oh!

github-actions Bot commented May 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

iOS (new) Performance metrics 🚀

Baseline results on branch: main

Startup times

App size

Uh oh!

github-actions Bot commented May 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Android (new) Performance metrics 🚀

Baseline results on branch: main

Startup times

App size

Uh oh!

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

lucas-zimerman May 21, 2026

Choose a reason for hiding this comment

Uh oh!

antonis May 21, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

antonis commented May 21, 2026 •

edited

Loading

github-actions Bot commented May 21, 2026 •

edited

Loading

github-actions Bot commented May 21, 2026 •

edited

Loading

github-actions Bot commented May 21, 2026 •

edited

Loading

sentry Bot commented May 21, 2026 •

edited

Loading

github-actions Bot commented May 21, 2026 •

edited

Loading

github-actions Bot commented May 21, 2026 •

edited

Loading

github-actions Bot commented May 21, 2026 •

edited

Loading