Configure your project for symbolication

Before you can analyze crash reports, the stack traces need to be symbolicated―that is, replacing memory addresses with human-readable function names and line numbers. These debug symbols are contained in dSYM bundles that are updated periodically. For every build you release to testers or users, you must get the latest dSYM bundle and upload it to Splunk MINT Management Console.

Get the latest dSYM bundle

To automate uploading dSYM bundles and to view real-time stats in your desktop, get BugSense Menu Bar. Otherwise, get the dSYM bundle from your Xcode build archive:

1. In Xcode, after you build and archive your project, on the Window menu click Organizer.
2. Click the Archives tab.
3. Right-click your project archive and click Show in Finder.
4. In Finder, right-click the archived build file and select Show Package Contents.
5. In the /dSYM folder, copy the your-project-name.app.dSYM file to your Desktop, then compress it (right-click the file and click Compress). You will upload this compressed file to Splunk MINT Management Console for server-side symbolication.

Configure server-side symbolication

1. In Xcode, open your project and select the target.
2. Make sure that your binary name (usually the target name) contains only Latin characters (e.g., only those within ISO-8859-1 character set also known as Latin-1). Otherwise, symbolication may not be successful.
3. On the Build Settings tab, verify the following are set for all configurations (typically Debug and Release):
• Strip Debug Symbols During Copy: Yes
• Strip Linked Product: Yes
4. Go to your Splunk MINT Management Console dashboard and upload the latest .dSYM file:
• On the Settings page under General Settings, select dSYMs.
• Click Browse & Upload.
• Navigate to and select the compressed dSYM bundle (see Get the dSYM bundle, above).

Configure on-device symbolication

You can symbolicate the crash reports on the device, although on-device symbolication does not provide as much useful information, such as the line of code that crashed your application.

Note Do not configure your mobile app for on-device symbolication if you are targeting iOS version 9.

1. In Xcode, open your project and select the target.
2. On the Build Settings tab, verify the following are set for all configurations (typically Debug and Release):
• Strip Debug Symbols During Copy: No
• Strip Linked Product: No
• Deployment Postprocessing: No
• Generate Debug Symbols: Yes