LastCrash iOS Sample Application

SDK Setup Instructions

Add LastCrash to your project:

• Copy LastCrash.xcframework from this repository into your project
• Make sure it's included under Targets > YOUR TARGET > General > Frameworks, Libraries, and Embedded Content

Initialize SDK:

• Replace LASTCRASH_API_KEY with your LastCrash API key.

Optional Delegate

Setting the delegate is optional. If you would like to control the logic behind sending crash reports then implement the LastCrashDelegate interface and call setDelegate.

The lastCrashDidCrash method will be called when crash reports are available to send. This allows you to implement your own logic or ask the user for permission to send crash reports.

LastCrash.send() must be called to send the crash reports if the delegate is used.

Freeze support

A call to LastCrash.applicationInitialized() must be made after your app is initialized in order to track freeze (application not responding or ANR) errors.

The reason this call to LastCrash.applicationInitialized() is required is to starting Freeze monitoring only after everything in your app is initialized/loaded so false positives can be avoided.

Networking support

A call to LastCrash.addNetworkTrackingToDefaultSession() must be made to track networking errors and get summarized networking statistics including bytes sent/recieveed and response time.

The call to LastCrash.addNetworkTrackingToDefaultSession() will add support to any usage of the default URLSession URLSession.shared.

If a custom URLSession is used then the URLSessionConfiguration used during creation must have the LastCrashURLProtocol class configured.

let configuration = URLSessionConfiguration.default
configuration.protocolClasses = [LastCrashURLProtocol.self] + configuration.protocolClasses!
let myURLSession = URLSession(configuration: configuration)

Swift:

import LastCrash
...
class AppDelegate: UIResponder, UIApplicationDelegate, LastCrashDelegate {

  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    ...
    LastCrash.configure("LASTCRASH_API_KEY")
    LastCrash.enabledLogging()
    LastCrash.setDelegate(self)
    LastCrash.addNetworkTrackingToDefaultSession()
    LastCrash.applicationInitialized()
    ...
  }

  func lastCrashDidCrash() {
    // logic to handle crash here
    LastCrash.send()
  }

}

Objective-C:

AppDelegate.h:

#import <LastCrash/LastCrash.h>
...
@interface AppDelegate : UIResponder <UIApplicationDelegate, LastCrashDelegate>

AppDelegate.m:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  ...
  [LastCrash configure:@"LASTCRASH_API_KEY"];
  [LastCrash enabledLogging];
  [LastCrash setDelegate:self];
  [LastCrash addNetworkTrackingToDefaultSession];
  [LastCrash applicationInitialized];
  ...
}

- (void)lastCrashDidCrash {
  // logic here to handle crash
  [LastCrash send];
}
...

Testing

Run app in Release mode with debugging turned off. For best results, run on a physical device, rather than a simulator.

Tap Test Crash to trigger a crash. Then re-run the app and watch the output log for the crash being uploaded. Go to your LastCrash account to view the crash recording.