How to solve symbolication problems

General

In most cases the symbolication process doesn't work, since there is no dSYM uploaded to HockeyApp, or the dSYM doesn't match the application binary. So this is also about the rules of binary UUIDs and dSYMs.

IMPORTANT: Each time you run the build command, your app gets a new unique UUID which is placed into the crash report to idenfiy the build. You also get a new dSYM package which contains the same UUID. So if you upload a new binary to the app store, you also have to upload the new dSYM to HockeyApp!

Bitcode

When uploading an app to the App Store and leaving the "Bitcode" checkbox enabled, Apple will use that Bitcode build and re-compile it on their end before distributing it to devices. This will result in the binary getting a new UUID and there is an option to download a corresponding dSYM through Xcode.

Please note: Bitcode is not necessary to profit from other App Thinning features such as slicing! Both features work independently from each other.

To download the dSYMs for Bitcode enabled apps please open the Xcode's Organizer. Select the specific Archive of your app that you uploaded to iTunes Connect and click on the "Download dSYMs" button which will insert the Bitcode compiled dSYMs into the original archive. Then manually upload the symbols to the corresponding app and version on HockeyApp.

If the Xcode organizer doesn't provide any new symbols, you need to download the dSYM from the iTunes Connect portal. Please follow these steps:

Select your app

Select the Activity tab on top

Select the build version of your app which has the missing symbols

Click the Download dSYM link

Upload the file you downloaded to HockeyApp (It is a zip file with the symbols included)