feat: Add onCrashedLastRun

Samples/iOS-Swift/iOS-Swift/AppDelegate.swift

@@ -8,9 +8,15 @@ class AppDelegate: UIResponder, UIApplicationDelegate {
 
         SentrySDK.start { options in
             options.dsn = "https://387714a4f3654858a6f0ff63fd551485@o447951.ingest.sentry.io/5428557"
+
             options.beforeSend = { event in
                 return event
             }
+
+            options.onCrashedLastRun = { event in
+                self.displayUserFeedback(event: event)
+            }
+
             options.debug = true
             options.logLevel = SentryLogLevel.verbose
             options.attachStacktrace = true
@@ -19,6 +25,14 @@ class AppDelegate: UIResponder, UIApplicationDelegate {
 
         return true
     }
+
+    private func displayUserFeedback(event: Event) {
+        let userFeedback = UserFeedback(eventId: event.eventId)
+        userFeedback.comments = "It broke on iOS-Swift from onCrashedLastRun."
+        userFeedback.email = "john@me.com"
+        userFeedback.name = "John Me"
+        SentrySDK.capture(userFeedback: userFeedback)
+    }
 
     // MARK: UISceneSession Lifecycle
 

Sources/Sentry/Public/SentryDefines.h

@@ -22,7 +22,7 @@
     -(instancetype)init NS_UNAVAILABLE;                                                            \
     +(instancetype) new NS_UNAVAILABLE;
 
-@class SentryEvent, SentryBreadcrumb;
+@class SentryEvent, SentryBreadcrumb, SentryId;
 
 /**
  * Block used for returning after a request finished
@@ -48,6 +48,11 @@ typedef SentryBreadcrumb *_Nullable (^SentryBeforeBreadcrumbCallback)(
  */
 typedef SentryEvent *_Nullable (^SentryBeforeSendEventCallback)(SentryEvent *_Nonnull event);
 
+/**
+ * A callback to be notified when the last program execution terminated with a crash.
+ */
+typedef void (^SentryOnCrashedLastRunCallback)(SentryEvent *_Nonnull event);
+
 /**
  * Block can be used to determine if an event should be queued and stored
  * locally. It will be tried to send again after next successful send. Note that

Sources/Sentry/Public/SentryOptions.h

@@ -79,6 +79,16 @@ NS_SWIFT_NAME(Options)
  */
 @property (nonatomic, copy) SentryBeforeBreadcrumbCallback _Nullable beforeBreadcrumb;
 
+/**
+ * This gets called shortly after the initialization of the SDK when the last program execution
+ * terminated with a crash.
+ *
+ * @discussion When the SDK has to send multiple crash events, which can happen when the program
+ * terminates with a crash before the SDK can send the crash event, this callback is only executed
+ * for the first crash event. You can look into beforeSend if you prefer a callback for every event.
+ */
+@property (nonatomic, copy) SentryOnCrashedLastRunCallback _Nullable onCrashedLastRun;
+
 /**
  * Array of integrations to install.
  */

Sources/Sentry/SentryClient.m

@@ -17,6 +17,8 @@
 #import "SentryMessage.h"
 #import "SentryMeta.h"
 #import "SentryOptions.h"
+#import "SentrySDK+Private.h"
+#import "SentrySDK.h"
 #import "SentryScope.h"
 #import "SentryStacktraceBuilder.h"
 #import "SentryThreadInspector.h"
@@ -366,6 +368,17 @@ - (SentryEvent *_Nullable)prepareEvent:(SentryEvent *)event
         event = self.options.beforeSend(event);
     }
 
+    // The callback is also called when SentrySDK.crashedLastRun is true and the
+    // SentryCrashReportSink didn't capture the crash event yet and the user manually captures an
+    // event with level fatal.
+    // We could also call this callback in SentryHub.captureCrashEvent, but then the event would
+    // miss detail from SentryClient.prepareEvent.
+    if (nil != self.options.onCrashedLastRun && SentrySDK.crashedLastRun
+        && !SentrySDK.crashedLastRunCalled && event.level == kSentryLevelFatal) {
+        SentrySDK.crashedLastRunCalled = YES;
+        self.options.onCrashedLastRun(event);
+    }
+
     return event;
 }
 

Sources/Sentry/SentryOptions.m

@@ -124,6 +124,10 @@ - (void)validateOptions:(NSDictionary<NSString *, id> *)options
         self.beforeBreadcrumb = options[@"beforeBreadcrumb"];
     }
 
+    if (nil != options[@"onCrashedLastRun"]) {
+        self.onCrashedLastRun = options[@"onCrashedLastRun"];
+    }
+
     if (nil != options[@"integrations"]) {
         self.integrations = options[@"integrations"];
     }

Sources/Sentry/include/SentrySDK+Private.h

@@ -8,6 +8,8 @@ NS_ASSUME_NONNULL_BEGIN
 
 + (void)captureCrashEvent:(SentryEvent *)event;
 
+@property (nonatomic, class) BOOL crashedLastRunCalled;
+
 @end
 
 NS_ASSUME_NONNULL_END