screenshot_shield 0.1.5
screenshot_shield: ^0.1.5 copied to clipboard
Detect user screenshots and optionally prevent screen capture on Android and iOS.
0.1.5 #
- iOS: fix
preventCapturenot blanking screenshots. The secure text field was added as a sibling subview of the window, which protects only the (empty) field itself; the app's content layer is now nested inside the field's capture-excluded canvas layer, so screenshots and screen recordings of the guarded screen come out blank. The content layer is restored exactly when protection is released, and the window is now resolved from the foreground-active scene. This relies on undocumented UIKit behaviour and can break on a future iOS release. - Reformat the Dart sources with the current formatter so the analysis and formatting checks pass again.
0.1.4 #
- Add
ScreenshotShield.onScreenRecordingChanged, aStream<bool>that emits the current screen-recording state (and the current value on subscription) whilestartListeningis active. - iOS: report screen recording (and screen mirroring) via
UIScreen.capturedDidChangeNotification/UIScreen.isCaptured. - Android: report screen recording on Android 15 (API 35) and newer via the
DETECT_SCREEN_RECORDINGAPI; older versions never emit. TheDETECT_SCREEN_RECORDINGpermission is declared. - Windows and Linux: best-effort screen-recording detection by sampling the
running process list for well-known recorders (OBS, Bandicam, Camtasia,
Kazam, Kooha,
wf-recorder, and others) every two seconds. This is heuristic and can both miss unlisted recorders and report an idle recorder.
0.1.3 #
- Android: fix
onScreenshotDetectednever firing whilepreventCaptureis enabled. The secure window flag blanks the frame (so the media-store observer never fires) and, on Android 14+, the system withholds the screen-capture callback for secure windows, so prevention and detection are mutually exclusive. The guards now resolve the conflict by letting detection win on Android when both are requested, and the guarded screen is re-rasterized into a shareable image instead. The system still shows a notice when detection fires on Android 14+. - Android: make media-store screenshot detection on Android 13 and below more reliable. The observer now queries the most recently added image (filtered to the last 15 seconds) instead of trusting the URI delivered by the media store, which varies by Android version and OEM, and it no longer crashes when the media query is blocked by permissions.
- Android: declare
READ_EXTERNAL_STORAGE(scoped to API 28 and below) so detection can query the media store on Android 9 and older; the host app must still request it at runtime. - Add
ScreenshotShieldGuard, a non-route guard that activates while the widget is mounted and itsactiveflag istrue, for screens not managed by aNavigatorwith aRouteObserver. - Add
forcePreventCapturetoScreenshotShieldRouteGuardandScreenshotShieldGuard. On Android it makes capture prevention win over screenshot detection when both are requested (blanking the frame and suppressing detection events), instead of the default where detection wins.
0.1.2 #
- Add Windows and Linux platform support. The Dart widgets work on desktop,
but screenshot detection and prevention are unavailable there (no OS APIs).
On Windows,
setProtection(backgroundBlur: true)cloaks the window from alt-tab and the taskbar preview while it is inactive or minimized. - iOS:
preventCapturenow blanks the app-switcher preview via a hidden secure text field. User screenshots themselves cannot be blanked on iOS, but detection and the shareable-image capture still work. - iOS: the background blur is applied on
willResignActiveso it reliably appears in the app switcher. - Android: the background blur now triggers on the user-leave hint (before
onPause) and forces a frame commit so the recents thumbnail includes it. - Add a GitHub Actions workflow that publishes to pub.dev with configurable major/minor/patch version bumps.
0.1.1 #
- Fix iOS builds: correct the Swift Package library product name to
screenshot-shield. - Background blur on Android now only applies the
RenderEffectblur when the FlutterView usesRenderMode.texture(where it actually reaches Flutter content); otherwise a dim overlay is shown. UseRenderMode.textureinMainActivityfor a real blur. - Make the iOS background blur appear reliably in the app switcher by committing it immediately when the app enters the background.
ScreenshotShieldRouteGuardnow appliespreventCapture/detectScreenshotschanges immediately instead of only on route changes.- Add an example app demonstrating detection, captured-image callbacks, and background blur.
0.1.0 #
- Detect user screenshots on Android and iOS.
- Android 14+ uses the system
DETECT_SCREEN_CAPTUREAPI; older Android versions watch the media store for new screenshots. - iOS reports immediately via the
UIApplicationUserDidTakeScreenshotNotificationsystem notification. ScreenshotShieldScopeprovides a sharedScreenshotShieldto the widget tree.ScreenshotShieldRouteGuardscopes protection to a route: capture prevention and screenshot listening are enabled while the route is in view and released when another route covers it.- Optional re-rasterized PNG of the guarded screen passed to
onScreenshotDetected. - Optional native background blur that hides the app content in the app
switcher (
setProtection(backgroundBlur: true)). - Prevent screen capture on Android via the secure window flag
(
setProtection(preventCapture: true)).