Breaking changes

First, we bumped Godot compatibility to 4.5-beta7 (#348)

Second, we've redesigned the breadcrumb API for a cleaner, more intuitive interface. Previously, add_breadcrumb() method accepted 5 parameters (3 of which were strings), making it confusing to use. The new approach uses a dedicated SentryBreadcrumb class:

var crumb := SentryBreadcrumb.create("Something happened")
crumb.type = "info"
crumb.set_data({"some": "data"})
SentrySDK.add_breadcrumb(crumb)

For simple breadcrumbs, you can use a one-liner:

SentrySDK.add_breadcrumb(SentryBreadcrumb.create("Something happened"))

This change provides better type safety, improved readability, and enables future support for the before_breadcrumb callback.

Features

• Add support for script context and variables on Apple platforms (#306)
• Add SentryEvent.to_json() (#329)

Improvements

• Improve initialization flow (#322)
• Introduce SentryBreadcrumb class (#332)

Fixes

• Potential crash in SentryLogger if removed early (#323)
• Ensure compatibility with minSdk 24 on Android (#324)
• Fixed UTF-8 retention problems with native SentryEvent properties (#345)

Dependencies

• Bump Cocoa SDK from v8.55.0 to v8.55.1 (#349)
  • changelog
  • diff
• Bump Native SDK from v0.10.0 to v0.10.1 (#344)
  • changelog
  • diff
• Bump Sentry Android from v8.19.1 to v8.20.0 (#325)
  • changelog
  • diff

Breaking changes

• Bump Godot compatibility to 4.5-beta5 (#307)

Features

• Intoduce SentryTimestamp class to improve timestamp handling (#286)
• Support for iOS & macOS using Sentry Cocoa SDK integration (#266)
• Add option to disable logging messages as breadcrumbs (#305)

Improvements

• Make error throttling smarter by factoring in error message (#287)

Other changes

• Add iOS framework as optional build target (#290)
• Add demo icon (#302)

Dependencies

• Bump Cocoa SDK from v8.53.2 to v8.54.0 (#304)
  • changelog
  • diff
• Bump Native SDK from v0.9.1 to v0.10.0 (#311)
  • changelog
  • diff
• Bump Sentry Android from v8.18.0 to v8.19.1 (#312, #315)
  • changelog
  • diff

Breaking changes

• Remove disabled_in_editor option in favor of disabling SDK in the Godot editor by default.(#277)
• Bump Godot minimum version to 4.5-beta4 (#285)

Fixes

• Prevent feedback loops in SentryLogger (#275)
• Fix release option not honored if set to a custom value in the project settings, and fix parsing of app_name/app_version replacement tokens if set via a configuration script. (#276)
• Remove libatomic.so.1 dependency on Linux (#278)
• Prevent stack overflow in variant conversion (#284)

Dependencies

• Bump Sentry Android from v8.17.0 to v8.18.0 (#282)
  • changelog
  • diff

Features

• Auto-enable required project settings (#260)
• Add disabled_in_editor_play option (#262)

Fixes

• Allow configuration script to run even if SDK is initially disabled in project settings (#258)
• Fix runtime errors with logger connecting to signal and early initialization (#265)
• Fix context-related errors generated at runtime with early intialization (#264)

Fixes

• Check options.enabled during SDK initialization (#250)
• Fix crashing when SDK is disabled via options (#253)

Breaking changes

• Minimum Godot version required is now 4.5, which is needed for the Logger interface (#201) and Android support (#169)

Features

• Initial Android support (#169)
• Refine demo for mobile screens (#196)
• Add user attachments support (#205)
• Provide x86_32 builds for Windows and Linux (#218)
• Support for the new Logger interface (more accurate error reporting), script stack traces and local variables in Godot 4.5 (#201)
• Provide noop (stub) builds for unsupported platforms (#239)

Fixes

• Fixed Godot 4.5 complaining that "usage" is not supported (#214)

Other changes

• Filter SDK messages in logger (#233)

Dependencies

• Bump Native SDK from v0.9.0 to v0.9.1 (#210)
  • changelog
  • diff
• Bump Sentry Android from v8.14.0 to v8.17.0 (#212, #242)
  • changelog
  • diff
• Bump gdUnit 4 from v5.0.4 to v5.0.5 (#221)
  • changelog
  • diff
• Bump godot-cpp to sync with Godot 4.5-beta3 (#246)

Various fixes & improvements

• fix: Ensure crashpad_handler has executable permissions on Unix exports (#207) by @limbonaut
• chore: update modules/gdUnit4 to v5.0.4 (#197) by @github-actions
• chore: update modules/gdUnit4 to v5.0.3 (#193) by @github-actions

Breaking changes

• Remove on_crash hook in favor of SentryEvent.is_crash(): before_send is now called for crash events too, and you can check if it's a crash event by calling event.is_crash() (#181)

Fixes

• Filter out warnings about missing attachment files that may not exist in some scenarios (screenshot.jpg and view-hierarchy.json) (#189)
• Fix crash in code editor when disabled_in_editor is ON (#191)

Other changes

• Rename "addons/sentrysdk" to "addons/sentry" (#180)
• Improve thread safety (#186)

Dependencies

• Bump Native SDK from v0.8.4 to v0.9.0 (#175, #190)
  • changelog
  • diff
• Bump gdUnit 4 from v4.5.0 to v5.0.0 (#185)
  • changelog
  • diff

Breaking changes

• Remove logger argument from SentrySDK.capture_message(...). This shouldn't be disruptive as the logger argument is seldom used and it had a default value. (#162)

Features

• Capture scene tree hierarchy data by enabling attach_scene_tree option (#143)

Dependencies

• Bump Native SDK from v0.8.3 to v0.8.4 (#161)
  • changelog
  • diff

Various fixes & improvements

• Fix release branch ref in CI (#158) by @limbonaut