feat: Add a breadcrumb when the library starts

CHANGELOG.md

@@ -3,6 +3,11 @@ Changelog
 
 ## TBD
 
+## Enhancements
+
+* Add a breadcrumb when Bugsnag first starts with the message "Bugsnag loaded"
+  [#445](https://github.com/bugsnag/bugsnag-cocoa/pull/445)
+
 ## Bug fixes
 
 * Fix possible report corruption when using `notify()` from multiple threads

Source/BugsnagNotifier.m

@@ -411,6 +411,11 @@ - (void)start {
 
     [self.sessionTracker startNewSessionIfAutoCaptureEnabled];
 
+    [self addBreadcrumbWithBlock:^(BugsnagBreadcrumb *_Nonnull breadcrumb) {
+         breadcrumb.type = BSGBreadcrumbTypeState;
+         breadcrumb.name = @"Bugsnag loaded";
+    }];
+
     // notification not received in time on initial startup, so trigger manually
     [self willEnterForeground:self];
 }

features/breadcrumbs.feature

@@ -0,0 +1,15 @@
+Feature: Attaching a series of notable events leading up to errors
+    A breadcrumb contains supplementary data which will be sent along with
+    events. Breadcrumbs are intended to be pieces of information which can
+    lead the developer to the cause of the event being reported.
+
+    Scenario: An app lauches and subsequently sends a manual event using notify()
+        When I run "HandledErrorScenario"
+        And I wait for a request
+        Then the event breadcrumbs contain "Bugsnag loaded" with type "state"
+
+    Scenario: An app lauches and subsequently crahes
+        When I crash the app using "BuiltinTrapScenario"
+        And I relaunch the app
+        And I wait for a request
+        Then the event breadcrumbs contain "Bugsnag loaded" with type "state"

features/steps/ios_steps.rb

@@ -98,6 +98,15 @@
   assert_true(delta.abs < threshold_secs, "Expected current timestamp, but received #{value}")
 end
 
+Then("the event breadcrumbs contain {string} with type {string}") do |string, type|
+  crumbs = read_key_path(find_request(0)[:body], "events.0.breadcrumbs")
+  assert_not_equal(0, crumbs.length, "There are no breadcrumbs on this event")
+  match = crumbs.detect do |crumb|
+    crumb["name"] == string && crumb["type"] == type
+  end
+  assert_not_nil(match, "No crumb matches the provided message and type")
+end
+
 Then("the event breadcrumbs contain {string}") do |string|
   crumbs = read_key_path(find_request(0)[:body], "events.0.breadcrumbs")
   assert_not_equal(0, crumbs.length, "There are no breadcrumbs on this event")