Enabling crash reporting on iOS

MobileFirst Quality Assurance automatically handles uncaught exceptions from your application and sends them to the IBM MobileFirst™ Quality Assurance server. When your app crashes, MobileFirst Quality Assurance records the relevant information, and then sends the data to the server the next time the app starts.

• To enable the exception handler in Objective-C, complete these steps:
  1. Open the projectDelegate.m file and search for the didFinishLaunchingWithOptions method.
  2. Add the following line of code inside the didFinishLaunchingWithOptions method:

     NSSetUncaughtExceptionHandler(&MQAUncaughtExceptionHandler);

• To enable the exception handler in Swift, complete these steps:
  1. Create a header file (for example, MQAExceptionHandler.h) and add the following two lines in it:

     volatile void exceptionHandler(NSException *exception);
     extern NSUncaughtExceptionHandler *exceptionHandlerPointer;

     The header file looks similar to this example:

         #ifndef MQASampleAppiOSSwift_MQAExceptionHandler_h
         #define MQASampleAppiOSSwift_MQAExceptionHandler_h
         volatile void exceptionHandler(NSException *exception);
         extern NSUncaughtExceptionHandler *exceptionHandlerPointer;
         #endif

  2. Create an Objective-C class (for example, MQAExceptionHandler.m). If you are prompted to configure an Objective-C bridging header, click Yes. This action configures the new class to use the same bridging header.
     
     Note: If you do not already have a bridging header file, a bridging header file is generated in the project folder.

     If you already have a bridging header file, then a copy of the file is generated. One file is located in the project folder and the other is in the project root.

     
  3. Add an implementation to the MQAExceptionHandler.m file. You can implement the MQAExceptionHandler method anyway that you want. However, you must add an Objective-C pointer for that method by adding the following lines in the new Objective-C class:

     void exceptionHandler(NSException *exception) {}
     NSUncaughtExceptionHandler *exceptionHandlerPointer = &exceptionHandler;

  4. Add the Objective-C class to your bridging header by adding this line: #import "MQAExceptionHandler.h
  5. Enable the crash report. In the AppDelegate.swift file, enable crash reporting by adding NSSetUncaughtExceptionHandler(exceptionHandlerPointer) at the end of the same application(_:didFinishLaunchingWithOptions:) method.
  This example shows the code:

           //Enable MQA Crash report detection
          NSSetUncaughtExceptionHandler(exceptionHandlerPointer)

  If your app crashes, the exception information is captured and sent to the MobileFirst Quality Assurance server through the NSSetUnchaughtExceptionHandler() method.