We recommend uploading dSYM files together with the app build files.
Use our upload API and add the dSYM files when the app is ready for distribution and testing.

1. Create a zip file from the contents of your symbols directory. The best way to locate this path can be found here.

   For example, the following command creates a zip file called symbols.zip from the symbols of my ‘Hi’ app and stores it in the /tmp directory.

   zip -r /tmp/symbols.zip
~/Library/Developer/Xcode/DerivedData/Hi/Build/Products/Debug-iphoneos/Hi.app.dSYM/*

2. Run the upload command:

   curl https://app.testfairy.com/api/upload \
   -F api_key='UPLOAD_API_KEY' \
   -F file='YOUR IPA FILE GOES HERE' \
   -F symbols_file='YOUR ZIPPED SYMBOLS FILE GOES HERE' \
   -F testers_groups='friends,beta' \
   -F notify='on'

If you need further instructions regarding our upload API, read about it here

If you are not planning to upload your app to TestFairy and you are not using Xcode, follow these instrucitons to upload your debug symbols:

1. Locate your DSYM_PATH directory. The best way to locate this path can be found here.

2. Download the upload dSYM script from here

3. Run this script:

   ./upload-dsym.sh -f UPLOAD_API_KEY -p DSYM_PATH

Once you run the script it will compress the symbols directory and upload the symbols to TestFairy.

If you upload apps straight from the TestFairy dashboard, upload your debug symbols from the build-settings page. Here is how you do it:

1. Create a zip file from the contents of your symbols directory. The best way to locate this path can be found here.

   For example, the following command creates a zip file called symbols.zip from the symbols of my ‘Hi’ app and stores it in the /tmp directory.

   zip -r /tmp/symbols.zip
~/Library/Developer/Xcode/DerivedData/Hi/Build/Products/Debug-iphoneos/Hi.app.dSYM/*

2. Login to TestFairy and go to the "App Overview" page by clicking the name of your app.

3. Enter the build overview page by clicking on the build you wish to upload symbols for (If you only have one build, you will not see a list of builds, but rather land directly on the correct build overview page).

4. Click on 'Build-Settings' from the top menu, then select the 'Symbolication' section.

5. Select the zip files with the dSYM you just created and click "Upload"

If you have never used the TestFairy Jenkins plugin before, see the installation instructions.. Once set up, Xcode will build your app on the Jenkins server, and upload the app's symbols.

1. Open Xcode on the machine that runs on Jenkins, click on your project in the left sidebar, then click on Build Phases.

   
   

2. Click on plus sign on the left and select New Run Script Build Phase

   
   

3. Open the newly added Run Script and add this line at the bottom:

   sh "$SRCROOT/TestFairy/upload-dsym.sh" UPLOAD_API_KEY
                           

   Make sure the specified path includes the upload-dsym.sh file.

   Make sure to replace UPLOAD_API_KEY with the your secret upload API key, found in the Settings page.

   

If you are using Xamarin, please refer to instructions in this page.