no_screenshot 1.3.0-beta.1

no_screenshot: ^1.3.0-beta.1 copied to clipboard

Beta — please test before the stable 1.3.0. This release changes how prevention state is tracked internally (details below). If your app mixes screenshotOff()/screenshotOn() with the overlay-mode APIs, please verify your flows and report issues.

• feat: added overlayOff() — an idempotent method that deterministically disables any active app-switcher overlay mode (image, blur, or color), without needing to know the current state (#115). The counterpart to the existing screenshotWithImage()/screenshotWithBlur()/screenshotWithColor() enable methods.
• feat (behavior change): prevention is now tracked as two separate claims on every platform — screenshotOff()/screenshotOn()/toggleScreenshot() own an independent claim, and an active overlay mode holds its own claim. Protection stays engaged while either claim is held. No API signatures changed, and apps that use only the plain methods or only the overlay methods behave exactly as before; sequences that mix the two APIs now resolve fail-secure instead of silently dropping protection:
  • screenshotWithBlur() → screenshotOff() → overlayOff(): prevention now stays on (the independent claim survives; previously it was silently dropped).
  • screenshotWithBlur() → screenshotOn(): prevention now stays on while the overlay is active (the overlay's claim survives; previously prevention dropped while the blur overlay kept showing in the app switcher).
  • screenshotOff() → toggleScreenshotWithBlur() on/off: prevention now stays on after the overlay toggles off (previously dropped).
  • To fully disable protection, release both claims — e.g. overlayOff() + screenshotOn() (what SecureWidget/applyOverlayMode(OverlayMode.none) do).
  • The persisted state gains an independent_prevention key; state written by older versions is migrated automatically (one-shot) on first launch.
  • toggleScreenshot() now toggles the plugin's own independent claim rather than inspecting the current window flag. If your app sets FLAG_SECURE (or the platform equivalent) outside this plugin, do not mix that with toggleScreenshot() — use screenshotOff()/screenshotOn() explicitly.
• fix: SecureWidget teardown, applyOverlayMode(OverlayMode.none), and applyOverlayMode(OverlayMode.secure) now clear any active overlay mode. Previously they only called screenshotOn(), which leaves the overlay mode active (and persisted) — so a disposed SecureWidget(mode: OverlayMode.blur) kept showing the blur overlay in the app switcher.
• fix: applyOverlayMode(OverlayMode.secure) takes the independent prevention claim before releasing the overlay's claim, so prevention stays continuously engaged across an overlay → secure transition (no transient unprotected frame).

• fix(android): removed a duplicate Kotlin source-directory registration that made the plugin fail to compile on Flutter 3.44.4+ with "Conflicting declarations" errors (#114).
• fix(ios): screenshot prevention now attaches lazily on the first method call, so screenshotOff() works even when scene lifecycle events never reach the plugin — e.g. apps migrated to the UIScene lifecycle with a custom SceneDelegate that does not subclass FlutterSceneDelegate (#105). screenshotOff()/toggleScreenshot() now return false instead of a misleading true when protection could not engage because no window is available yet.
• fix(ios): iOS builds running on Apple-silicon Macs ("Designed for iPhone/iPad") no longer show a permanently black/white window at launch (#107). Screenshot prevention is not supported by this technique on a macOS host, so screenshotOff() now returns false there; app-switcher overlays and screenshot/recording detection are unaffected.
• fix(android): migrated to AGP's built-in Kotlin support following the official plugin migration guide, so the plugin keeps building on AGP 9+ where applying the Kotlin Gradle Plugin is no longer allowed (#104, #110).
• fix(macos): replaced CGWindowListCreateImage (removed in the macOS 26 "Tahoe" SDK) with cacheDisplay for the blur-overlay snapshot, keeping the plugin compiling against the latest SDK without requiring Screen Recording permission (#109). Because Flutter renders into a CAMetalLayer that AppKit snapshots cannot capture, the blur overlay on macOS now always uses the system blur material and blurRadius has no effect there; content remains fully obscured in Mission Control / the app switcher. Also fixes blur-overlay edges fading to transparent on iOS and macOS, thanks to @paulanatoleclaudot-betclic (#102).

• breaking: renamed overlay image assets on all platforms to avoid generic-name collisions (#99) by @yar-tsar.

  Migration — rename your overlay image files:

  Platform	Before	After
  Android	res/drawable/image.png	res/drawable/no_screenshot_image.png
  iOS	Assets.xcassets/image.imageset/	Assets.xcassets/NoScreenshotImage.imageset/
  macOS	Assets.xcassets/image.imageset/	Assets.xcassets/NoScreenshotImage.imageset/

  No Dart-side code changes are required — only the asset files need to be renamed.

• feat(android): added Android 15 (API 35) screen recording detection via WindowManager.addScreenRecordingCallback — provides true start/stop detection with SCREEN_RECORDING_STATE_VISIBLE / SCREEN_RECORDING_STATE_NOT_VISIBLE (#98) by @fonkamloic.
• feat(android): layered backward compatibility — API 35+ uses WindowManager.addScreenRecordingCallback, API 34 falls back to Activity.ScreenCaptureCallback, API <34 graceful no-op by @fonkamloic.
• docs: updated README with Android 15 recording detection details, platform behavior table, and upgrade notes by @fonkamloic.

• feat(ios): migrate to UIScene lifecycle for iOS 26+ compatibility — add FlutterSceneLifeCycleDelegate conformance so overlay show/hide logic fires under both the legacy UIApplicationDelegate and the new UIScene lifecycle; replace deprecated UIScreen.main usages; remove stale iOS 11 availability checks; bump deployment target to iOS 13.0 / Flutter >=3.38.0 by @fonkamloic.
• fix(ios): add @objc(NoScreenshotPlugin) annotation for Swift Package Manager builds — fixes "Unknown receiver 'NoScreenshotPlugin'" compilation error in GeneratedPluginRegistrant.m (#96) by @fonkamloic.
• fix(ios): replace UIVisualEffectView blur overlay with CIGaussianBlur — the previous implementation darkened the screen instead of blurring it; now captures a window snapshot and applies a true Gaussian blur with configurable radius by @fonkamloic.

• chore: add pub.dev topics to pubspec.yaml.

• feat(ios, macos): added Swift Package Manager support — Package.swift for both iOS and macOS, with CocoaPods backward compatibility by @fonkamloic.
• feat(example): added color picker with 8 preset colors for the color overlay section by @fonkamloic.
• feat(example): added blur radius slider (1–100) that applies the blur overlay in real time by @fonkamloic.
• chore: updated podspec source_files paths to reference SPM directory structure by @fonkamloic.
• chore: added .build/ and .swiftpm/ to .gitignore and .pubignore by @fonkamloic.

• feat: added timestamp and sourceApp metadata fields to ScreenshotSnapshot — backward-compatible defaults (P8) by @fonkamloic.
• feat(android): screenshot metadata via MediaStore.Images.Media.DATE_ADDED and DISPLAY_NAME by @fonkamloic.
• feat(ios): screenshot metadata via wall clock at detection time by @fonkamloic.
• feat(macos): screenshot metadata via kMDItemContentCreationDate and kMDItemCreator / detected recording app name by @fonkamloic.
• feat(linux): screenshot metadata via G_FILE_ATTRIBUTE_TIME_MODIFIED and inferred source app from filename prefix by @fonkamloic.
• feat(windows): added Windows platform support — SetWindowDisplayAffinity(WDA_EXCLUDEFROMCAPTURE) for prevention, AddClipboardFormatListener + ReadDirectoryChangesW for screenshot detection, process scanning for recording detection (P11) by @fonkamloic.
• feat: added granular callbacks — onScreenshotDetected, onScreenRecordingStarted, onScreenRecordingStopped with startCallbacks() / stopCallbacks() / removeAllCallbacks() API (P15) by @fonkamloic.
• feat(web): added best-effort web platform support — right-click blocking, PrintScreen interception, user-select: none CSS, visibilitychange detection (P17) by @fonkamloic.
• fix: fixed NoScreenshot.instance creating a new instance on every access — now a proper cached singleton by @fonkamloic.
• fix: changed _instancePlatform from a captured field to a getter so platform is resolved at call time by @fonkamloic.
• feat(example): added Granular Callbacks section with real-time event display by @fonkamloic.
• feat(example): added web platform scaffolding by @fonkamloic.
• fix(linux): replaced FlEventSink with fl_event_channel_send for stream event delivery by @fonkamloic.
• fix(linux): fixed GObject typedefs, recording detection thread safety, stream caching, and platform-specific UI layout by @fonkamloic.
• test: added granular callback tests with mock platform class by @fonkamloic.
• test: added web platform test suite by @fonkamloic.
• test: added screenshotStream coverage for event channel decoding and stream caching by @fonkamloic.

• feat: added SecureWidget — a declarative Flutter widget that auto-enables screenshot protection on mount and disables on unmount (P6) by @fonkamloic.
• feat: added SecureNavigatorObserver — a NavigatorObserver that applies different protection levels per named route (P7) by @fonkamloic.
• feat: added SecureRouteConfig class for configuring per-route protection policies with OverlayMode, blurRadius, and color by @fonkamloic.
• feat: added OverlayMode enum (none, secure, blur, color, image) and applyOverlayMode() helper for declarative protection by @fonkamloic.
• feat: added idempotent screenshotWithImage(), screenshotWithBlur(), and screenshotWithColor() API methods — always enable the overlay (no toggle), safe to call repeatedly by @fonkamloic.
• feat: added idempotent native handlers on Android, iOS, macOS, and Linux for the new always-enable methods by @fonkamloic.
• feat(example): added SecureWidget demo page and per-route protection demo with payment, profile, and public pages by @fonkamloic.
• test: added widget tests for SecureWidget (initState, dispose, didUpdateWidget, all overlay modes) by @fonkamloic.
• test: added unit tests for SecureNavigatorObserver (didPush, didPop, didReplace, didRemove, defaultConfig, custom params) by @fonkamloic.
• test: added method channel, platform interface, and NoScreenshot tests for new idempotent methods by @fonkamloic.
• docs: updated README with SecureWidget and per-route protection sections, updated API reference table by @fonkamloic.

• feat: added configurable blurRadius parameter to toggleScreenshotWithBlur({double blurRadius}) — defaults to 30.0, customizable per platform by @fonkamloic.
• feat: added toggleScreenshotWithColor({int color}) API — solid color overlay for app switcher / recents screen across all platforms by @fonkamloic.
• feat(android): color overlay via a solid View with the specified ARGB color by @fonkamloic.
• feat(ios): color overlay via UIView with the specified background color by @fonkamloic.
• feat(macos): color overlay via NSView with the specified background color by @fonkamloic.
• feat(linux): color overlay state tracked and persisted (best-effort — compositors control task switcher thumbnails) by @fonkamloic.
• feat: color, blur, and image overlays are mutually exclusive — activating one deactivates the others, enforced at native level on all platforms by @fonkamloic.
• feat(example): added Color Overlay section with color picker and toggle button by @fonkamloic.
• feat(example): added localization strings for color overlay UI by @fonkamloic.
• test: added method channel, platform interface, and NoScreenshot tests for toggleScreenshotWithBlur with custom radius and toggleScreenshotWithColor by @fonkamloic.
• docs: updated README, CHANGELOG, roadmap, and example app to reflect configurable blur radius and color overlay support by @fonkamloic.

• feat: added toggleScreenshotWithBlur() API — Gaussian blur overlay for app switcher / recents screen (P2) by @fonkamloic.
• feat(android): blur overlay via RenderEffect.createBlurEffect() on API 31+ (zero-copy GPU blur) and RenderScript.ScriptIntrinsicBlur on API 17–30 by @fonkamloic.
• feat(ios): blur overlay via UIVisualEffectView with UIBlurEffect(style: .regular) by @fonkamloic.
• feat(macos): blur overlay via NSVisualEffectView with .hudWindow material by @fonkamloic.
• feat(linux): blur overlay state tracked and persisted (best-effort — compositors control task switcher thumbnails) by @fonkamloic.
• feat: blur and image overlay are mutually exclusive — activating one deactivates the other, enforced at native level on all platforms by @fonkamloic.
• feat: blur overlay state persists across app restarts via SharedPreferences / UserDefaults / JSON on all platforms by @fonkamloic.
• feat(example): added Overlay Blur section with toggle button and status indicator by @fonkamloic.
• fix(example): fixed stream subscription leak causing setState on unmounted widget — added proper dispose() and mounted check by @fonkamloic.
• test: added method channel, platform interface, and NoScreenshot tests for toggleScreenshotWithBlur by @fonkamloic.
• docs: updated README, CHANGELOG, roadmap, and example app to reflect blur overlay support by @fonkamloic.

• feat: detect screen recording start/stop events across all platforms (P1) by @fonkamloic.
• feat(ios): event-driven screen recording detection via UIScreen.capturedDidChangeNotification (iOS 11+) — detects both start and stop by @fonkamloic.
• feat(android): screen recording detection via Activity.ScreenCaptureCallback (API 34+) — detects recording start; graceful no-op on pre-34 devices by @fonkamloic.
• feat(macos): best-effort screen recording detection via NSWorkspace process monitoring — polls for known recording apps (QuickTime Player, OBS, Loom, Kap, ffmpeg, screencapture, simplescreenrecorder) by @fonkamloic.
• feat(linux): best-effort screen recording detection via /proc process scanning — polls for known recording tools (ffmpeg, obs, simplescreenrecorder, kazam, peek, recordmydesktop, vokoscreen) by @fonkamloic.
• feat: added isScreenRecording field to ScreenshotSnapshot — backward-compatible, defaults to false when omitted by native code by @fonkamloic.
• feat: added startScreenRecordingListening() and stopScreenRecordingListening() API methods — recording detection is independent of screenshot detection by @fonkamloic.
• feat(example): added Recording Monitoring section with enable/disable buttons and real-time isScreenRecording status display by @fonkamloic.
• test: added method channel, platform interface, and ScreenshotSnapshot tests for screen recording detection by @fonkamloic.
• docs: updated README, CHANGELOG, roadmap, and example app to reflect screen recording detection support by @fonkamloic.

• feat(linux): added Linux support with screenshot detection via GFileMonitor (inotify), monitoring ~/Pictures/Screenshots/, ~/Pictures/, and XDG pictures directory by @fonkamloic.
• feat(linux): screenshot file path is available on Linux (via GFileMonitor) — same as macOS by @fonkamloic.
• feat(linux): screenshot prevention and image overlay are best-effort on Linux — state is tracked and persisted, but Linux compositors (Wayland / X11) do not expose a FLAG_SECURE-equivalent API by @fonkamloic.
• feat(linux): state persistence via JSON file in $XDG_DATA_HOME/no_screenshot/state.json by @fonkamloic.
• docs: updated README, CHANGELOG, and example app to reflect Linux support by @fonkamloic.

• fix(ios): fix iOS 26 RTL layout shift by dropping ScreenProtectorKit and inlining screenshot prevention with forceLeftToRight semantics by @fonkamloic.
• fix(ios): fix EXC_BAD_ACCESS crash in _collectExistingTraitCollectionsForTraitTracking on iOS 26+ caused by circular view hierarchy by @fonkamloic.
• fix(ios): fix bottom-right content alignment caused by Auto Layout constraint offset during layer reparenting by @fonkamloic.
• feat(ios): removed ScreenProtectorKit dependency — all iOS screenshot prevention is now inlined by @fonkamloic.
• feat(example): add EN/AR localization and RTL toggle to example app for testing RTL layout by @fonkamloic.
• docs: document screenshotPath availability — file path is only available on macOS; Android and iOS return a placeholder by @fonkamloic.
• docs: add LTR/RTL language support note to README by @fonkamloic.
• docs: add GIF demo placeholders for every feature on every platform by @fonkamloic.

• fix(macos): detect clipboard-only screenshots (Cmd+Ctrl+Shift+3/4) via pasteboard polling by @fonkamloic.
• fix(macos): detect repeated screenshots while screencaptureui is still running by @fonkamloic.
• fix(macos): track screencaptureui process lifecycle (launch + termination) for reliable detection by @fonkamloic.
• fix(macos): add 2s debounce to suppress duplicate detection events while allowing file-path upgrades from NSMetadataQuery by @fonkamloic.
• docs: updated macOS screenshot monitoring documentation to reflect three detection methods by @fonkamloic.

• feat(macos): added macOS support for toggleScreenshotWithImage() by @fonkamloic.
• feat: added toggleScreenshotWithImage() API to display a custom image overlay when the app goes to the background or app switcher, preventing screenshot content exposure on both Android and iOS by @zhangyuanyuan-bear and @fonkamloic.
• feat: image overlay mode persists across app restarts via platform SharedPreferences/UserDefaults by @zhangyuanyuan-bear and @fonkamloic.
• fix(ios): prevent stale image overlay by consolidating lifecycle handling by @BranislavKljaic96 and @fonkamloic.
• fix(ios): native code now works with both SceneDelegate and AppDelegate by @BranislavKljaic96 in https://github.com/FlutterPlaza/no_screenshot/pull/86.
• fix: use Executors for SharedPreferences access on Android to avoid strict mode violations on startup by @qk7b in https://github.com/FlutterPlaza/no_screenshot/pull/74.
• fix: properly clean up image overlay and activity references on detach/config changes (Android) by @fonkamloic.
• chore: updated Kotlin and Gradle versions in Android build configuration by @T-moz in https://github.com/FlutterPlaza/no_screenshot/pull/76.
• chore: updated example app to demonstrate the new image overlay feature by @fonkamloic.
• test: added toggleScreenshotWithImage tests and fixed CI codecov upload by @fonkamloic.
• ci: added automated pub.dev publish workflow by @fonkamloic.

• feat: added toggleScreenshotWithImage() API to display a custom image overlay when the app goes to the background or app switcher, preventing screenshot content exposure on both Android and iOS by @zhangyuanyuan-bear and @fonkamloic.
• feat: image overlay mode persists across app restarts via platform SharedPreferences/UserDefaults by @zhangyuanyuan-bear and @fonkamloic.
• fix: use Executors for SharedPreferences access on Android to avoid strict mode violations on startup by @qk7b.
• fix: properly clean up image overlay and activity references on detach/config changes (Android) by @fonkamloic.
• chore: updated Kotlin and Gradle versions in Android build configuration by @T-moz.
• chore: updated example app to demonstrate the new image overlay feature by @fonkamloic.
• ci: added automated pub.dev publish workflow by @fonkamloic.

• feat: macos support by @fonkamloic in https://github.com/FlutterPlaza/no_screenshot/pull/51
• fix: fix screenshot state not persisting on iOS by @fonkamloic in https://github.com/FlutterPlaza/no_screenshot/pull/45
• fix: duplicate interface definition for class 'NoScreenshotPlugin' by @fonkamloic in https://github.com/FlutterPlaza/no_screenshot/pull/62
• chore(deps): bump actions/checkout from 2 to 4 by @dependabot in https://github.com/FlutterPlaza/no_screenshot/pull/43
• chore(deps): bump codecov/codecov-action from 4.0.1 to 4.5.0 by @dependabot in https://github.com/FlutterPlaza/no_screenshot/pull/42

• chore: updated pkg version by @fonkamloic in https://github.com/FlutterPlaza/no_screenshot/pull/63
• fix: duplicate interface definition for class 'NoScreenshotPlugin' by @fonkamloic in https://github.com/FlutterPlaza/no_screenshot/pull/62

• fix: fix screenshot state not persisting on iOS by @fonkamloic in https://github.com/FlutterPlaza/no_screenshot/pull/45
• chore(deps): bump actions/checkout from 2 to 4 by @dependabot in https://github.com/FlutterPlaza/no_screenshot/pull/43
• chore(deps): bump codecov/codecov-action from 4.0.1 to 4.5.0 by @dependabot in https://github.com/FlutterPlaza/no_screenshot/pull/42
• feat: macos support by @fonkamloic in https://github.com/FlutterPlaza/no_screenshot/pull/51

• feat: added MacOS support
• fix: fix screenshot state not persisting on iOS
• chore: added more examples.

• fix: Pub Point analysis failure.

Summary of Changes #

• Automatic State Persistence: Removed the need to track didChangeAppLifecycleState. The state will now be automatically persisted using native platform SharedPreferences.
• Enhanced Example: Updated the example app to demonstrate the new automatic state persistence and usage of the NoScreenshot plugin.
• Stream Support: Provided a stream to listen for screenshot activities, making it easier to react to screenshots in real-time.
• Bug Fixes: Fixed various bugs related to screenshot detection and state management on both Android and iOS platforms.
• Documentation Updates: Improved documentation to reflect the new features and provide clearer usage examples.
• Deprecation Notice: Deprecated the use of the constructor NoScreenshot() in favor of the singleton NoScreenshot.instance.

• Upgrade android to support AGP 8.X
• merged fix by @alberto-cappellina PR[https://github.com/FlutterPlaza/no_screenshot/pull/27]
• gradle:7.1.2 -> 7.4.2
• kotlin_version = '1.6.10' -> '1.6.21'

• Set the namespace for android
• Specify a more current version of ScreenProtectorKit. This resolves iOS17 issues.
• fix: screenshot prevention on iOS
• updated readme by @Musaddiq635 PR[https://github.com/FlutterPlaza/no_screenshot/pull/26]
• merged fix by @ggiordan PR[https://github.com/FlutterPlaza/no_screenshot/pull/29]

• Removed the non implemented override functions in android life-cycle

• Fixed broken link from pub dev analyses

• Fixed issue #1Crashes app when backgrounded on iOS

• Reverted to BSD 3 license
• Added documentation
• Made NoScreenshot class a singleton

• Adopted MIT license

Updated readme and added sample usage.

Package has 3 basic functionalities on android and IOS via method channel. - Disable screenshot support in app - Enable screenshot support in app - Toggle between enable and disable state