Repository navigation
Conversation
Document the opt-in out-of-process backend of the NDK integration, which captures native crashes in a separate crash service process and sends them right away. Cover enabling it with and without the Sentry Android Gradle Plugin, the API 30+ requirement, and what the separate process means for the app. Ref: getsentry/sentry-native#1725 Ref: getsentry/sentry-java#6347 Ref: getsentry/sentry-android-gradle-plugin#1474
|
The latest updates on your projects. Learn more about Vercel for GitHub.
1 Skipped Deployment
|
Contributor
|
Getting ready to monitor this change · Rollout details
|
codeowner-assignment
Bot
requested review from
a team,
markushi and
runningcode
and removed request for
a team
November 3, 2026 19:14
This was referenced Nov 3, 2026
Merged
Android can freeze the crash service shortly after the app exits, so a slow upload may not finish. The SDK then sends the crash on a later app start. Document this as a known limitation of out-of-process crash handling.
The `ndkBackend` option of the Gradle plugin is parked for now, so add the package and the exclude directly.
romtsn
reviewed
Nov 5, 2026
romtsn
reviewed
Nov 5, 2026
|
|
||
| ```groovy {filename:app/build.gradle} | ||
| dependencies { | ||
| implementation "io.sentry:sentry-android-ndk-outproc:{{@inject packages.version('sentry.java.android', '8.21.1') }}" |
Contributor
There was a problem hiding this comment.
Suggested change
| implementation "io.sentry:sentry-android-ndk-outproc:{{@inject packages.version('sentry.java.android', '8.21.1') }}" | |
| implementation "io.sentry:sentry-android-ndk-outproc:{{@inject packages.version('sentry.java.android', '9.0.0-alpha.1') }}" |
I think this should be the version where this first ships whether it's v9 or v8 (same for the snippet below)
Collaborator
Author
There was a problem hiding this comment.
I put 8.64 for now, but let's sync it at the end when it's been released and we are ready to merge this. Leaving this unresolved until then. 👍
romtsn
reviewed
Nov 5, 2026
romtsn
approved these changes
Nov 5, 2026
romtsn
left a comment
romtsn
left a comment
Contributor
There was a problem hiding this comment.
a few nits, but looks good otherwise! pre-approving
Android runs `Application.onCreate` in the crash service process too. Spell out the side effects for app startup code and how to skip it.
Only the `sentry-android` bundle pulls in `sentry-native-ndk`, so builds that use `sentry-android-core` don't need the exclude.
The snippets copied `8.21.1` from the older NDK snippet, which predates `sentry-android-ndk-outproc`. Use the first release expected to ship it.
github-actions
Bot
removed
the
Priority: Normal
github-actions
Bot
added
Priority: Needs Triage
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
DESCRIBE YOUR PR
Document the opt-in out-of-process backend of the NDK integration, which captures native crashes in a separate crash service process and sends them right away. Cover enabling it with and without the Sentry Android Gradle Plugin, the API 30+ requirement, and what the separate process means for the app.
See:
IS YOUR CHANGE URGENT?
Help us prioritize incoming PRs by letting us know when the change needs to go live.
Select exactly one option. For deadlines, replace
YYYY-MM-DDwith the due date. You can update this information later by editing the PR description.SLA
Thanks in advance for your help!
PRE-MERGE CHECKLIST
Make sure you've checked the following before merging your changes:
LEGAL BOILERPLATE
Look, I get it. The entity doing business as "Sentry" was incorporated in the State of Delaware in 2015 as Functional Software, Inc. and is gonna need some rights from me in order to utilize my contributions in this here PR. So here's the deal: I retain all rights, title and interest in and to my contributions, and by keeping this boilerplate intact I confirm that Sentry can use, modify, copy, and redistribute my contributions, under Sentry's choice of terms.
EXTRA RESOURCES