Skip to content

docs(react-native): Add warning about AGP autoInstallation on Android#17349

Open
antonis wants to merge 2 commits intomasterfrom
antonis/docs/rn-android-autoinstallation-warning
Open

docs(react-native): Add warning about AGP autoInstallation on Android#17349
antonis wants to merge 2 commits intomasterfrom
antonis/docs/rn-android-autoinstallation-warning

Conversation

@antonis
Copy link
Copy Markdown
Contributor

@antonis antonis commented Apr 15, 2026

DESCRIBE YOUR PR

Add documentation warning that the Sentry Android Gradle Plugin autoInstallation must be disabled when using React Native, to prevent IllegalStateException: Sentry SDK has detected a mix of versions crashes.

  • Add warning alert to manual setup guide about autoInstallation needing to be false
  • Add warning alert to v7-to-v8 migration guide
  • Add troubleshooting section for the IllegalStateException mix of versions crash with solution and link to GitHub issue

Refs getsentry/sentry-react-native#5682

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

  • Urgent deadline (GA date, etc.):
  • Other deadline:
  • None: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
    Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

Add alerts to manual setup and v7-to-v8 migration guides warning that
the Sentry Android Gradle Plugin autoInstallation must be disabled for
React Native. Add a troubleshooting section for the
IllegalStateException mix of versions crash caused by this
misconfiguration.

Refs getsentry/sentry-react-native#5682
Co-Authored-By: Claude <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel bot commented Apr 15, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview, Comment Apr 15, 2026 3:17pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Preview Apr 15, 2026 3:17pm

Request Review

@codeowner-assignment codeowner-assignment bot requested a review from a team April 15, 2026 15:02
@antonis antonis requested review from alwx and lucas-zimerman April 15, 2026 15:03
Expo restructured their docs, moving the development builds
introduction from /development/introduction/ to
/develop/development-builds/introduction/.

Co-Authored-By: Claude <noreply@anthropic.com>
## Expo Transactions Never Finish

If you're using [expo-dev-client](https://docs.expo.dev/development/introduction/#what-is-an-expo-dev-client), you might notice that transactions never finish in your dev builds. This is due to logs that the dev client is continuously sending to the development server. To fix this, you can stop creating spans for the HTTP requests to the log endpoint in your dev builds by adding the following to your `Sentry.init()`:
If you're using [expo-dev-client](https://docs.expo.dev/develop/development-builds/introduction/), you might notice that transactions never finish in your dev builds. This is due to logs that the dev client is continuously sending to the development server. To fix this, you can stop creating spans for the HTTP requests to the log endpoint in your dev builds by adding the following to your `Sentry.init()`:
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This change is irrelevant to this PR but fixes a 404 caught by the CI check on the touched file

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant