Retrieve dSYMs for Bitcode apps

Bitcode is a feature that gives Apple the ability to re-compile iOS and tvOS applications for specific users' hardware. This provides a smaller download size for end users. For more about this process, see Apple's Bitcode and app thinning documentation.

When Apple compiles an app, the dSYM files are also compiled. For New Relic to be able to symbolicate crashes of your Bitcode-enabled app, these dSYM files need to be downloaded from Apple and then uploaded to New Relic.

Identify missing dSYMs

When a Bitcode-enabled app is uploaded to Apple for App Store review or ad-hoc distribution, dSYMs need to be manually downloaded from Apple and uploaded to New Relic to allow the mobile crash reports to be properly symbolicated. These dSYMs can be downloaded through the archives organizer in Xcode within several minutes of uploading the app. In this situation follow the procedures to find the archive and download dSYMs.

If an app is missing a dSYM file, three indicators are available in the New Relic Mobile UI:

  • Banner notification: A banner warning appears on the Crash report page. The warning reads:

    We were unable to locate your dsym.
  • Upload prompt: from the Crash type summary page you will be automatically prompted to upload a dSYM file if it is missing.
  • Machine code: The crash stack trace on the Crash report page displays machine code and not a human-readable error message.

Download dSYM files using iTunes Connect

To download the dSYM files you need for your app:

  1. Log in to Apple iTunes Connect.
  2. Select My Apps > (selected app) > Activity.
  3. From the list of builds for your application, select the build number you need for the dSYM.
  4. Select Download dSYM.

Then, to upload the resulting zip file directly to New Relic:

  1. Follow the instructions to manually upload dSYM, and skip step 1.
  2. Unpack one dSYM contained in this zip file to retrieve a build UUID that you can upload. (Follow the last step in the manual upload instructions.)

Once New Relic receives the zip file, the build UUIDs for all other dSYMs contained in that zip file will be identified.

Download dSYM files using Xcode's app archive

Use the app version and build number to identify the applicable app archive in the Xcode Organizer and download the dSYMs.

Download dSYMs for mobile app version/build
Using Xcode to download dSYMs: From the Archives tab, select the app and version/build, then select Download dSYMs.
  1. Open the Xcode Organizer: From the Xcode menu, select Window > Organizer > Archives > (select a mobile app).
  2. From Version, select the archive that matches the app version (listed first) and build number (following the app version in parentheses).
  3. Select Download dSYMs.

The dSYMs will be downloaded from Apple if available and if the file names contain a series of letters and numbers. If the dSYM files are named after the the dependencies in your project, the download will not be successful.

Upload dSYMs

Once you have located the dSYMs, follow the instructions to upload a dSYM for each zipped dSYM.

For more help

Recommendations for learning more: