Changelog

v4.3.0 — 2026-09-28

🚀 New features

• Added Screeb.setAnonymousId(anonymousId:) to link the current respondent to the anonymous id your CDP already uses (e.g. Amplitude device id, Segment or RudderStack anonymous id). The respondent stays anonymous, and if that id already belongs to an existing respondent, Screeb switches to it (unless the current one is already identified). Call it right after initSdk.

🐛 Bug fixes

• SDK error reports are no longer sent over the network before initSdk runs, since the host app may not have collected consent yet, they now stay local until then. Error messages also no longer include command arguments or other data that could carry visitor identities or properties.

v4.2.1 — 2026-09-25

🐛 Bug fixes

• Screenshot answers no longer capture the iOS screen-sharing "Stop Sharing" overlay — the SDK now waits for that system sheet to be dismissed before grabbing the frame.
• Session replay recovers on its own if an update is ever lost in transit: a changing screen now gets a fresh keyframe at least every 30 seconds instead of staying wrong for the rest of the session.
• Session replay no longer misses the last change made right as a screen settles.
• A brief memory warning no longer keeps session replay (quality, resolution, capture rate) throttled for the rest of the time the app is in the foreground — the throttling now eases back automatically a few seconds after the warning stops recurring.

⚡ Improvements

• Session replay capture does less work for hidden looping animations, duplicate change regions, and paused capture passes, lowering CPU and battery impact with no change in replay fidelity.

v4.2.0 — 2026-08-24

🚀 New features

• Exit-intent surveys now work on native iOS: leaving a tracked screen can trigger a survey, as on web. Requires screen tracking (trackScreen) instrumentation.
• New "inactivity" targeting rule: trigger a survey after the respondent has stopped interacting with the app for a configured time.

🐛 Bug fixes

• Time-based triggers (delay, session duration, inactivity) now fire on time: the SDK arms its own native timer instead of relying on webview timers, which iOS throttles while the webview is hidden.

v4.1.0 — 2026-08-20

🚀 New features

• Heatmaps now work for native iOS sessions — clicks, dead clicks, rage clicks and device type are captured the same way as on web.
• Session replay anonymization (session_replay_anonymize) is now enforced on-device: when enabled, text and sensitive images are masked in the recording, not just on web.

🐛 Bug fixes

• Fixed the survey becoming unreachable (stuck behind the app, unresponsive to touches) after a respondent opened the photo/file picker from a modally-presented screen — a very common integration pattern.
• Fixed visitor properties bridged from Flutter/React Native: numeric 0/1 values were sometimes sent as booleans and silently dropped by number-typed properties.
• Fixed closeSdk occasionally failing silently when called right as a survey-close screen reloads.
• Fixed masked/redacted content sometimes leaking into captured pixels (screenshots, cropped or scrolled captures).
• Fixed replay recordings sometimes opening on a blank screen instead of the real starting content.
• Fixed several rare crashes in session replay (low memory, backgrounding, network changes, rapid start/stop).
• Fixed heatmap clicks occasionally being attributed to the previous screen right after navigation.

⚡ Improvements

• Session replay's impact on the host app's main thread is substantially reduced, keeping the app smoother while recording, especially on busy or animated screens.
• The SDK release artifact is now signed with Screeb's vendor identity, so Xcode can verify the SDK's authenticity and warn if it ever changes.
• The attach-file editor title is now generic ("Edit") for any picked image, and its toolbar respects the device's safe area.

v4.0.4 — 2026-08-13

🐛 Bug fixes

• Respondents can attach a picture again: tapping the attach button in a survey now opens the system photo menu, where it previously did nothing at all.
• The photo library no longer opens behind the survey, where its photos could be seen but not tapped.

⚡ Improvements

• The attach menu is the iOS one: photo library, camera and files, in the language of the device, filtered to the picture formats a survey accepts.

v4.0.3 — 2026-08-07

🐛 Bug fixes

• Fixed a rare crash that could close the app while session replay was recording.
• Fixed a crash when the app was opened from a malformed Screeb link.
• Fixed a crash that could happen on the first network error after startup.
• Screeb no longer closes the app when memory runs low while recording: it skips a frame instead.
• Fixed the order of screen and event tracking, so events are always attached to the screen they happened on.
• Fixed occasional instability when Screeb methods are called from a background thread.

⚡ Improvements

• Session replay stays light for the whole session on apps where it could previously fall back to full-screen captures.
• Command callbacks and survey hooks are called back on a background thread again, as they were before 4.0.2.

v4.0.2 — 2026-07-08

🚀 Improvements

• More robust session replay, even under heavy memory pressure.
• Lower CPU and memory usage while recording.
• In-app surveys and messages stay reliably in the foreground.

v3.1.1 — 2026-02-10

🚀 Improvements

• Added sessionReplay{start|stop} commands.

v3.1.0 — 2026-02-09

🚀 Improvements

• Added getIdentity command.
• Added Callback result to debug and debugTargeting commands.

v3.0.3 — 2026-02-06

🚀 Improvements

• Added file picker for In-App messages video.

v3.0.2 — 2026-01-13

🚀 Improvements

• Hotfixes.

v3.0.1 — 2026-01-12

🚀 Improvements

• Ensure webview is not in the accessible tree when it is hidden.

v3.0.0 — 2026-01-12

🚀 Improvements

• Session Replay in Beta.
• Added disableMirror to InitOptions to force disable In-App messages mirroring and Session Replay.

v2.2.4 — 2025-12-04

🚀 Improvements

• Fixed SDK methods Objective-C type.

v2.2.2 — 2025-11-18

🚀 Improvements

• AnyEncodable is now unneeded and should be removed.
• SDK methods are now Objective-C compatible.
• Fixed Closing In-App messages builder reopening it.

v2.2.1 — 2025-10-23

🚀 Improvements

• Thread safety fixes.

v2.2.0 — 2025-10-23

🚀 Improvements

• Added startMessage, closeMessage commands.
• Added optional surveyId param to closeSurvey.

v2.1.14 — 2025-10-16

🚀 Improvements

• Support In-App Messages.
• Removed deprecated "automaticScreenDetection" InitOptions.
• Bump min iOS version to 12.0.

v2.1.13 — 2025-06-18

🚀 Improvements

• Ensure sequential messages consume.

v2.1.12 — 2025-06-04

🚀 Improvements

• Auto-recover on network change.
• Fixed hitboxes on keyboard visibility changes.
• Threads improvements.
• Added "distributionId" param to startSurvey.

v2.1.11 — 2025-02-03

🚀 Improvements

• Thread safety fixes.

v2.1.10 — 2025-01-31

🚀 Improvements

• Ensure commands execution orders.

v2.1.9 — 2024-12-19

🚀 Improvements

• Reduce memory usage caused by logging.

v2.1.8 — 2024-12-09

🚀 Improvements

• Fixed case where content is untouchable.

v2.1.7 — 2024-10-02

🚀 Improvements

• Add language parameter

v2.1.6 — 2024-07-30

🚀 Improvements

• Fixed double encoding.

v2.1.5 — 2024-07-30

🚀 Improvements

• Prepare support of new hooks in secondary SDK.

v2.1.4 — 2024-07-29

🚀 Improvements

• Fixed hook result encoding.

v2.1.3 — 2024-07-29

🚀 Improvements

• Support new onSurveyDisplayAllowed and onMessageDisplayAllowed hooks.

v2.1.2 — 2024-07-22

🚀 Improvements

• Fixed destroy animation.
• Improved key window handling.

v2.1.1 — 2024-06-12

🚀 Improvements

• Fixed error and message printing.
• Improved key window handling.

v2.1.0 — 2024-05-28

🚀 Improvements

• Improved surveys hit boxes.
• Prepare support for in-app messages.
• Prepare support for session recording.

v2.0.13 — 2024-04-11

🚀 Improvements

• Fixed possible non-interactive surveys

v2.0.12 — 2024-04-10

🚀 Improvements

• Allow lazy init SDK without any context
• Better handling of window switching #2
• Fixed threads warnings

v2.0.11 — 2024-04-05

🚀 Improvements

• Multi-platform support
• Better handling of window switching

v2.0.10 — 2024-02-05

🚀 Improvements

• Improved commands encoding.
• Handle a rare case where a survey is not properly closed.

v2.0.9 — 2024-01-09

🚀 Improvements

• Improved context tracking.

v2.0.8 — 2024-01-03

🚀 Improvements

• Fixed Close/Init SDK lifecycle.

v2.0.7 — 2023-12-11

🚀 Improvements

• Properly handle SSL errors.

v2.0.4→2.0.6 — 2023-12-11

🚀 Improvements

• Improve errors reporting.
• Warn about debug mode enabled.

v2.0.3 — 2023-09-08

🚀 Improvements

• Allow to init SDK without context that'll default to the app one.
• Remove false translatesAutoresizingMaskIntoConstraints.

v2.0.1→2.0.2 — 2023-09-08

🚀 Improvements

• Added closeSurvey command.
• Fixed surveys not showing in some cases.
• Fixed surveys on screen rotation.

v2.0.0 — 2023-08-02

🚀 Improvements

• The SDK has been rewritten from scratch to provide greater stability, instant updates of Screeb features, and be even lighter.
• All SDK dependencies have been removed, and the minimum iOS version has been reduced from 12.4 to 11.0.

Improvements (PS: Same as rc.1, rc.2, and rc.3 but with a new feature called hooks) 🚀

• The SDK has been rewritten from scratch to provide greater stability, instant updates of Screeb features, and be even lighter.
• All SDK dependencies have been removed, and the minimum iOS version has been reduced from 12.4 to 11.0.

v1.13.2 — 2023-06-07

🚀 Improvements

• New "Range rating" type of questions

v1.13.1 — 2023-05-17

🚀 Improvements

• Fixed Version Targeting

v1.13.0 — 2023-04-28

🚀 Improvements

• startSurvey command now accepts the ignoreSurveyStatus argument (default: true)
• Better log management
• Fixed multiple "End survey" buttons

v1.12.4 — 2023-04-21

🚀 Improvements

• Added Swift Package Manager support
• Fixed a bug on buttons having no emoji.
• Retry request on network failure

v1.12.2→1.12.3 — 2023-03-10

🚀 Improvements

• Fixed Validation event and group name
• Fixed Disable Automatic screen detection

v1.12.1 — 2023-02-24

🚀 Improvements

• Build SDK with Xcode 13.2.1 and Swift 5.5.2 (1300.0.47.5) to fix compilation issue and support swift version 5.5.2+

v1.12.0 — 2023-02-09

🚀 Improvements

• Added debug and debugTargeting commands
• Added resetIdentity command
• Added closeSdk command
• Fixed survey closing on reduced mod

v1.11.0 — 2023-01-25

🚀 Improvements

• Response expiration

v1.10.5 — 2023-01-24

🚀 Improvements

• Fixed validation issues in visitor properties

v1.10.4 — 2022-10-29

🚀 Improvements

• Make targeting more reliable in order to not trigger survey in a corner-case

v1.10.3 — 2022-10-18

🚀 Improvements

• Replace numeric emojis by custom SVG
• Fixed Survey superposition on the app