The TestFairy Jenkins plugin

If you have never used the TestFairy Jenkins plugin before, see the installation instructions.

Setup Xcode to create debug symbols

Open Xcode on the machine that runs Jenkins and follow these instructions:

  1. Click on your project and select Build-Settings.
  2. In the search box, type "Debug Information Format".
  3. Click on "Debug Information Format", search for "DWARF" and select "DWARF with dSYM File"
    alt dsym

Setup Xcode to upload DSYMs for every build

If your Jenkins is configured to build your app, it will pick up those build phases configured on Xcode and run them as well.

Open Xcode on the machine that runs Jenkins and follow these instructions:

  1. Click on your project in the left sidebar, then click on Build Phases.

alt

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

alt

  1. 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.

alt

Fatal: Can't find .dSYM folder!

If, while compiling, you get the error Fatal: Can't find .dSYM folder!, your project may not be configured to generate debug symbols. Here is how you setup Xcode to generate dSYMs