Symbolication using Zoho Apptics
Overview
Symbolicating the crash reports into a human-readable format is essential for any developer to understand the reason behind the crash quickly.
What is a dSYM file?
A dSYM file is a debug symbol file generated by Apple Xcode along with the executable binary whenever you build an Apple app. The dSYM file contains all the debugging information you need to symbolicate crash reports.
Apptics automatically processes your dSYM files to give you human-readable crash reports.
If the dSYM upload fails because of unique project configurations or bitcode in your app, you can upload the dSYM file manually in the Apptics console.
Check if Xcode is producing dSYM files
-
Open your project in Xcode and select the project file in the Xcode navigator.
-
Select your main build target from the Select Project or target dropdown.
-
Open the target's build settings tab.
-
Click All near the top of the tab.
-
Search for 'debug formation format'.
-
Set Debug information format to DWARF with dSYM file.
- Build your app again and check the Apptics console to see if the dSYM is uploaded.
Steps to take if crash logs aren't symbolicated
-
If the logs aren't symbolicated in the crashes, choose one of the below options to provide the symbols needed to symbolicate the crash.
Option 1: Find the .dSYM on your Mac.
-
Locate your application's .xcarchive file in the finder.
-
Right-click the .xcarchive file in the finder and select show package contents.
-
You will see a folder named dSYMs that contains the dSYM bundle.
-
Zip this directory and upload it to the Apptics server on the manage dSYM page.
Option 2: Download dSYMs using Xcode organizer.
-
Follow the below steps and download the dSYM files from the Xcode organizer.
-
Open the Organizer window from the Xcode menu.
-
Select Archives in the Products section in the organizer window.
-
Click download debug symbols from the details tab on the right.
-
Zip this directory and upload it on the Manage dSYM page in the Apptics console.
Option 3: Download the symbols from iTunesConnect for your bitcode enabled apps.
- After you create an archive and upload your app to iTunes Connect, it will be processed by Apple. To get the correct version of your app dSYM from the AppStore, you can use the Xcode Archives Organizer or log in to iTunes Connect.
-
Follow the below steps to download the dSYM files for bitcode enabled version from the iTunes Connect portal.
-
Log in to Apple iTunes Connect.
-
Select My Apps > (selected app) > Activity.
-
From the list of builds for your application, select the build number you need for the dSYM.
-
Click Download dSYM.
- Zip this directory and upload it to the Apptics server on the Manage dSYM page.
Upload dSYM files manually in Apptics
- Navigate to Quality > Symbols & Mapping. Select the dSYM file and the application ID for which you want to upload from the drop-down menu.
- Click Upload and a popup will appear.
- Select the appropriate app version and build version from the drop down.
- Click on Choose file and select the .zip file.
- Click Upload and the dSYM file will be listed in the console.
NOTE: When multiple builds of the same version are uploaded to the AppStore, multiple dSYM files will be uploaded to the apptics server. In that case, the developer can choose which dSYM should be used to symbolicate the crashes arriving from the released version (by default, the latest dSYM file will be chosen).
Troubleshooting unsymbolicated crash reports
If the crashes are still unsymbolicated after uploading proper symbols, it might be because the uploaded dSYM files don't match the app version of the crash report.
You can make sure whether your dSYM files have the UUIDs that match with the UUIDs of your crash reports by using a command called dwarfdump.
- To find the UUID in the dSYM file:
dwarfdump -u YourApplication.app.dSYM
- It should print something like this:
UUID: 331EB9D3-5C70-3143-80BF-8D5B5FC394BC (armv7)YourApplication.app.dSYM/Contents/Resources/DWARF/YourApplication UUID: 7071835B-8205-3DDC-ACC5-67E60740F27A (arm64)YourApplication.app.dSYM/Contents/Resources/DWARF/YourApplication
- Check if the UUID printed in the terminal matches the UUIDs of your application binary which you can find under the "Binary Inages" section of the crash report.
Binary Images:
0x100a04000 - 0x10193bfff +YourApplication arm64 <7071835b82053ddcacc567e60740f27a> /private/var/containers/Bundle/Application/FCEBD58B-724E-477E-890A-D27E438A1D20/YourApplication.app/YourApplication
Access your files securely from anywhere
Zoho CRM Training Programs
Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.
Zoho DataPrep Personalized Demo
If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
New to Zoho Writer?
Create. Review. Publish.
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.
New to Zoho Survey?
Zoho Sheet Resources
Zoho Forms Resources
New to Zoho Sign?
Zoho Sign Resources
Sign, Paperless!
New to Zoho TeamInbox?
Zoho TeamInbox Resources
New to Zoho ZeptoMail?
Design. Discuss. Deliver.
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
New to Bigin?
Related Articles
Getting started with Zoho Apptics
Getting Started Welcome to Zoho Apptics! The right place for your apps. Zoho Apptics is the privacy-friendly product analytics solution that provides you with in-app usage, engagement, performance, and growth monitoring for your mobile and web apps– ...Deobfuscation using Zoho Apptics
Overview Obfuscation of your code is the process of renaming all the classes and their methods names in a way that is difficult to reverse-engineer but will still function correctly. ProGuard (it's successor R8) is the default Java code optimizer and ...Flows in Zoho Apptics
Overview User flows help in providing an overview of how users navigate through your app and show the different user pathways they take to interact with your app. In Apptics, you can analyze user flows based on screen and event traversal. Sankey flow ...Retention in Zoho Apptics
Overview Retention analysis gives a clear picture of your app's ability to retain users and provide an engaging user experience. By analyzing the user retention and app stickiness of your app, you can optimize app engagement to reduce churn rates and ...Zoho Projects integration in Zoho Apptics
Overview Zoho Projects integration helps you carry out your day-to-day tasks effectively. You can assign any crashes, non-fatal, in-app feedback, or store reviews that you receive for the app as bugs and track their progress. You will be able to do ...
New to Zoho LandingPage?
Zoho LandingPage Resources