feat(feedback): implement shake gesture detection by antonis · Pull Request #5150 · getsentry/sentry-java

antonis · 2026-03-03T17:57:26Z

📜 Description

Implements shake gesture detection for the user feedback form. When useShakeGesture is enabled in SentryFeedbackOptions, shaking the device opens the feedback form.

The implementation uses the device's accelerometer (via SensorManager) with a 2.7G threshold and 1-second cooldown. A new ShakeDetectionIntegration registers lifecycle callbacks to start/stop the detector when the activity resumes/pauses.

Note: this is exposed to be used on React Native too getsentry/sentry-react-native#5754

💡 Motivation and Context

The useShakeGesture property already existed in SentryFeedbackOptions but was never wired up. This PR implements the feature. The implementation is placed here (sentry-java) rather than in each SDK separately so it can be reused by all SDKs that embed the feedback UI (React Native, Flutter, .NET MAUI, Unity).

No special permissions are required — TYPE_ACCELEROMETER is not a protected sensor. Only BODY_SENSORS requires a permission.

💚 How did you test it?

Tested in a sample Android app (see 0cb8d00) — shaking the device opens the feedback form
Unit tests added for SentryShakeDetector and ShakeDetectionIntegration

📝 Checklist

I added GH Issue ID & Linear ID
I added tests to verify the changes.
No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled.
I updated the docs if needed. docs(android): Add shake-to-report feedback documentation sentry-docs#16792
I updated the wizard if needed.
Review from the native team if needed.
No breaking change or entry added to the changelog.
No breaking change for hybrid SDKs or communicated to hybrid SDKs.

🔮 Next steps

sentry-react-native will remove its own RNSentryShakeDetector and delegate to this class instead.

Adds SentryShakeDetector (accelerometer-based) and ShakeDetectionIntegration that shows the feedback dialog when a shake is detected. Controlled by SentryFeedbackOptions.useShakeGesture (default false). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

github-actions · 2026-03-03T17:57:53Z

Semver Impact of This PR

🟡 Minor (new features)

📋 Changelog Preview

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

New Features ✨

(feedback) Implement shake gesture detection by antonis in #5150

Bug Fixes 🐛

(screenshot) Add dontwarn replay rules to sentry-android-core by romtsn in #5153

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

github-actions · 2026-03-03T17:57:58Z

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

Generated by 🚫 dangerJS against d180230

github-actions · 2026-03-03T18:11:55Z

Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	318.16 ms	373.86 ms	55.70 ms
Size	1.58 MiB	2.29 MiB	727.32 KiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
`ee747ae`	374.71 ms	455.18 ms	80.47 ms
`22f4345`	314.79 ms	375.02 ms	60.23 ms
`91bb874`	311.00 ms	363.47 ms	52.47 ms
`dba088c`	328.51 ms	423.79 ms	95.28 ms
`5b66efd`	308.67 ms	363.85 ms	55.18 ms
`96eeafa`	361.43 ms	455.07 ms	93.63 ms
`2124a46`	319.19 ms	415.04 ms	95.85 ms
`d15471f`	379.40 ms	470.76 ms	91.36 ms
`bbc35bb`	324.88 ms	425.73 ms	100.85 ms
`d15471f`	304.55 ms	408.43 ms	103.87 ms

App size

Revision	Plain	With Sentry	Diff
`ee747ae`	1.58 MiB	2.10 MiB	530.95 KiB
`22f4345`	1.58 MiB	2.29 MiB	719.83 KiB
`91bb874`	1.58 MiB	2.13 MiB	559.07 KiB
`dba088c`	1.58 MiB	2.13 MiB	558.99 KiB
`5b66efd`	1.58 MiB	2.13 MiB	559.07 KiB
`96eeafa`	1.58 MiB	2.19 MiB	620.21 KiB
`2124a46`	1.58 MiB	2.12 MiB	551.51 KiB
`d15471f`	1.58 MiB	2.13 MiB	559.54 KiB
`bbc35bb`	1.58 MiB	2.12 MiB	553.01 KiB
`d15471f`	1.58 MiB	2.13 MiB	559.54 KiB

Previous results on branch: antonis/feedback-shake

Startup times

Revision	Plain	With Sentry	Diff
`3a14925`	327.15 ms	380.52 ms	53.37 ms
`a1a1e57`	323.92 ms	367.22 ms	43.31 ms
`2052d5f`	331.52 ms	401.71 ms	70.19 ms
`ba57364`	317.45 ms	360.35 ms	42.90 ms
`90c01e9`	314.38 ms	370.51 ms	56.13 ms
`58a9026`	330.31 ms	370.45 ms	40.13 ms

App size

Revision	Plain	With Sentry	Diff
`3a14925`	1.58 MiB	2.29 MiB	727.39 KiB
`a1a1e57`	1.58 MiB	2.29 MiB	727.28 KiB
`2052d5f`	1.58 MiB	2.29 MiB	726.85 KiB
`ba57364`	1.58 MiB	2.29 MiB	727.15 KiB
`90c01e9`	1.58 MiB	2.29 MiB	727.37 KiB
`58a9026`	1.58 MiB	2.29 MiB	727.33 KiB

- Add volatile/AtomicLong for thread-safe cross-thread field access - Use SystemClock.elapsedRealtime() instead of System.currentTimeMillis() - Use SENSOR_DELAY_NORMAL for better battery efficiency - Add multi-shake counting (2+ threshold crossings within 1.5s window) - Handle deferred init for already-resumed activities - Wrap showDialog() in try-catch to prevent app crashes - Improve activity transition handling in onActivityPaused - Mark SentryShakeDetector as @ApiStatus.Internal - Add unit tests for SentryShakeDetector and ShakeDetectionIntegration Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

sentry-android-core/src/main/java/io/sentry/android/core/FeedbackShakeIntegration.java

… shakes Track dialog visibility with an isDialogShowing flag that is set before showing and cleared via the onFormClose callback when the dialog is dismissed. Double-checked on both sensor and UI threads to avoid races. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

sentry-android-core/src/main/java/io/sentry/android/core/ShakeDetectionIntegration.java

sentry-android-core/src/main/java/io/sentry/android/core/FeedbackShakeIntegration.java

… growth Save the user's original onFormClose once during register() and restore it after each dialog dismiss, instead of wrapping it with a new lambda each time. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

sentry-android-core/src/main/java/io/sentry/android/core/FeedbackShakeIntegration.java

…ck flag If showDialog silently fails (e.g. activity destroyed between post and execution), isDialogShowing would stay true forever, permanently disabling shake-to-feedback. Reset it in onActivityPaused since the dialog cannot outlive its host activity. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

sentry-android-core/src/main/java/io/sentry/android/core/FeedbackShakeIntegration.java

…ActivityDestroyed AlertDialog survives pause/resume cycles (e.g. screen off/on), so resetting isDialogShowing in onActivityPaused allowed duplicate dialogs. Move the reset to onActivityDestroyed where the dialog truly cannot survive. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

sentry-android-core/src/main/java/io/sentry/android/core/FeedbackShakeIntegration.java

…back on error - Only reset isDialogShowing in onActivityDestroyed when it's the activity that hosts the dialog, not any unrelated activity. - Restore originalOnFormClose in the catch block when showDialog throws. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

lucas-zimerman · 2026-03-04T17:45:35Z

sentry-android-core/src/main/java/io/sentry/android/core/FeedbackShakeIntegration.java

+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Detects shake gestures and shows the user feedback dialog when a shake is detected. Only active


I know the end goal is to add this to improve user feedback, but the way it is, it's doing nothing related to user feedback.
Might be a good idea to rename this to FeedbackShakeIntegration so the name of it self explains the usage of it, instead of leaving it generic, what do you think?

Updated with 1fd4f5b

lucas-zimerman · 2026-03-04T17:46:32Z

sentry-android-core/src/main/java/io/sentry/android/core/AndroidOptionsInitializer.java

              (Application) context, buildInfoProvider, activityFramesTracker));
      options.addIntegration(new ActivityBreadcrumbsIntegration((Application) context));
      options.addIntegration(new UserInteractionIntegration((Application) context, loadClass));
+      options.addIntegration(new ShakeDetectionIntegration((Application) context));


Q: is it possible to only add when useShakeGesture is set to true?

At the time installDefaultIntegrations runs in AndroidOptionsInitializer, the user's configuration callback hasn't executed yet and useShakeGesture is still false. That's why register() checks the option later. This is the same pattern used by other integrations (e.g., UserInteractionIntegration is always added but checks its options in register())

sentry-android-core/src/main/java/io/sentry/android/core/SentryShakeDetector.java

lucas-zimerman · 2026-03-04T18:06:59Z

sentry-android-core/src/main/java/io/sentry/android/core/SentryShakeDetector.java

+      sensorManager.unregisterListener(this);
+      sensorManager = null;
+    }
+    listener = null;


q: why not set listener null first?

Good point. Updated with 1fd4f5b

Co-authored-by: LucasZF <lucas-zimerman1@hotmail.com>

sentry-android-core/src/main/java/io/sentry/android/core/FeedbackShakeIntegration.java

- Rename ShakeDetectionIntegration to FeedbackShakeIntegration to clarify its purpose is feedback-specific (#1) - Avoid Math.sqrt by comparing squared gForce values (#3) - Null out listener before unregistering sensor to prevent in-flight callbacks during stop (#4) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

sentry-android-core/src/main/java/io/sentry/android/core/FeedbackShakeIntegration.java

...ry-samples/sentry-samples-android/src/main/java/io/sentry/samples/android/MyApplication.java

Capture the current onFormClose callback just before showing the dialog rather than caching it during register(). This ensures callbacks set by the user after SDK init are preserved across shake-triggered dialogs. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

When the dialog's host activity is destroyed and onDismiss doesn't fire, onActivityDestroyed now restores the previous onFormClose callback on global options, preventing a stale wrapper from affecting subsequent non-shake feedback dialogs. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

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

sentry-android-core/src/main/java/io/sentry/android/core/FeedbackShakeIntegration.java

… when null The previous null check on previousOnFormClose skipped restoration when no user callback was set, leaving a stale wrapper in global options. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

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.}

sentry-android-core/src/main/java/io/sentry/android/core/SentryShakeDetector.java

Document the new `useShakeGesture` option on `SentryFeedbackOptions` that opens the feedback form when the user shakes the device. Ref: getsentry/sentry-java#5150 Co-Authored-By: Claude <noreply@anthropic.com>

antonis mentioned this pull request Mar 3, 2026

feat(feedback): Show feedback widget on device shake getsentry/sentry-react-native#5754

Draft

7 tasks

antonis and others added 2 commits March 4, 2026 13:08

Merge branch 'main' into antonis/feedback-shake

d13da1b

antonis marked this pull request as ready for review March 4, 2026 13:12

antonis requested review from adinauer, lcian, markushi and romtsn as code owners March 4, 2026 13:12

antonis requested a review from alwx March 4, 2026 13:14

cursor bot reviewed Mar 4, 2026

View reviewed changes

sentry-android-core/src/main/java/io/sentry/android/core/FeedbackShakeIntegration.java Show resolved Hide resolved

sentry bot reviewed Mar 4, 2026

View reviewed changes

sentry-android-core/src/main/java/io/sentry/android/core/ShakeDetectionIntegration.java Outdated Show resolved Hide resolved

cursor bot reviewed Mar 4, 2026

View reviewed changes

sentry-android-core/src/main/java/io/sentry/android/core/FeedbackShakeIntegration.java Show resolved Hide resolved

cursor bot reviewed Mar 4, 2026

View reviewed changes

sentry-android-core/src/main/java/io/sentry/android/core/FeedbackShakeIntegration.java Show resolved Hide resolved

cursor bot reviewed Mar 4, 2026

View reviewed changes

sentry-android-core/src/main/java/io/sentry/android/core/FeedbackShakeIntegration.java Show resolved Hide resolved

cursor bot reviewed Mar 4, 2026

View reviewed changes

sentry-android-core/src/main/java/io/sentry/android/core/FeedbackShakeIntegration.java Show resolved Hide resolved

sentry-android-core/src/main/java/io/sentry/android/core/FeedbackShakeIntegration.java Show resolved Hide resolved

lucas-zimerman reviewed Mar 4, 2026

View reviewed changes

sentry-android-core/src/main/java/io/sentry/android/core/SentryShakeDetector.java Outdated Show resolved Hide resolved

lucas-zimerman reviewed Mar 4, 2026

View reviewed changes

Optimise comparison

d77d60d

Co-authored-by: LucasZF <lucas-zimerman1@hotmail.com>

sentry bot reviewed Mar 5, 2026

View reviewed changes

sentry-android-core/src/main/java/io/sentry/android/core/FeedbackShakeIntegration.java Outdated Show resolved Hide resolved

cursor bot reviewed Mar 5, 2026

View reviewed changes

sentry-android-core/src/main/java/io/sentry/android/core/FeedbackShakeIntegration.java Show resolved Hide resolved

antonis marked this pull request as draft March 5, 2026 09:19

sentry bot reviewed Mar 5, 2026

View reviewed changes

sentry-android-core/src/main/java/io/sentry/android/core/FeedbackShakeIntegration.java Show resolved Hide resolved

cursor bot reviewed Mar 5, 2026

View reviewed changes

antonis and others added 4 commits March 5, 2026 10:24

Reverse sample changes

0cb8d00

fix(feedback): make previousOnFormClose volatile for thread safety

87d508a

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

antonis marked this pull request as ready for review March 5, 2026 09:44

antonis requested a review from lucas-zimerman March 5, 2026 09:44

sentry bot reviewed Mar 5, 2026

View reviewed changes

sentry-android-core/src/main/java/io/sentry/android/core/FeedbackShakeIntegration.java Show resolved Hide resolved

antonis and others added 2 commits March 5, 2026 10:51

fix(feedback): always restore onFormClose in onActivityDestroyed even…

8e2dee3

… when null The previous null check on previousOnFormClose skipped restoration when no user callback was set, leaving a stale wrapper in global options. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Merge branch 'main' into antonis/feedback-shake

d180230

cursor bot reviewed Mar 5, 2026

View reviewed changes

sentry-android-core/src/main/java/io/sentry/android/core/SentryShakeDetector.java Show resolved Hide resolved

antonis mentioned this pull request Mar 5, 2026

docs(android): Add shake-to-report feedback documentation getsentry/sentry-docs#16792

Open

6 tasks

Uh oh!

Conversation

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

Uh oh!

📜 Description

💡 Motivation and Context

💚 How did you test it?

📝 Checklist

🔮 Next steps

Uh oh!

github-actions bot commented Mar 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Semver Impact of This PR

New Features ✨

Bug Fixes 🐛

Uh oh!

github-actions bot commented Mar 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Mar 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Performance metrics 🚀

Baseline results on branch: main

Startup times

App size

Previous results on branch: antonis/feedback-shake

Startup times

App size

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

lucas-zimerman Mar 4, 2026

Choose a reason for hiding this comment

Uh oh!

antonis Mar 5, 2026

Choose a reason for hiding this comment

Uh oh!

lucas-zimerman Mar 4, 2026

Choose a reason for hiding this comment

Uh oh!

antonis Mar 5, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

lucas-zimerman Mar 4, 2026

Choose a reason for hiding this comment

Uh oh!

antonis Mar 5, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cursor bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

antonis commented Mar 3, 2026 •

edited

Loading

github-actions bot commented Mar 3, 2026 •

edited

Loading

github-actions bot commented Mar 3, 2026 •

edited

Loading

github-actions bot commented Mar 3, 2026 •

edited

Loading