---
title: "#225: Downloading dSYMs with Fastlane 🤖"
url: https://littlebitesofcocoa.com/225-downloading-dsyms-with-fastlane
author: Jake Marsh
published: 2016-04-01
topics: ["Tools","Fastlane"]
description: "It's another fastlane Friday! Bitcode is awesome. It lets our users download much smaller versions of our apps, containing only the bits they need to run it..."
---

# #225: Downloading dSYMs with Fastlane 🤖

By Jake Marsh, April 1, 2016. HTML: https://littlebitesofcocoa.com/225-downloading-dsyms-with-fastlane

It's another [fastlane Friday](https://www.littlebitesofcocoa.com/topics/56-fastlane?v=l)!

[Bitcode](https://developer.apple.com/library/tvos/documentation/IDEs/Conceptual/AppDistributionGuide/AppThinning/AppThinning.html#Bitcode) is awesome. It lets our users download much smaller versions of our apps, containing only the bits they need to run it on their devices.

Unfortunately, it creates a few challenges for using third-party crash-reporting services. 

Not to worry, [fastlane](https://fastlane.tools/) has our backs. Today we'll look at a new built-in _fastlane_ action ([Bite #140](https://www.littlebitesofcocoa.com/140)) that can automate all of this.

The issue is that **Crashlytics** (or any service analyzing our crash logs) needs our **dSYM** **files** to convert raw crash logs to ones that containing line numbers and function names and all the other useful information we'll need to actually fix the bug causing the crash.

We'll begin by making sure we have the latest version of _fastlane_. (A quick `gem update fastlane` will do the trick).

Then, we'll add a new lane:

``` ruby
lane :refresh_dsyms do
  download_dsyms                  # Download dSYM files from iTunes Connect
  upload_symbols_to_crashlytics   # Upload them to Crashlytics
  clean_build_artifacts           # Delete the local dSYM files
end
```

Now we can just run `fastlane refresh_dsyms` at anytime and everything will be synced up to **Crashlytics**. Apple seems to recompile our apps at will, and whenever their systems need. 

For these reasons, it's probably best to toss this command into a CI server or some other system that will run it once or twice a day.

<img src="https://static1.squarespace.com/static/545299aae4b0e9514fe30c95/t/56fdd79622482e392236a02c/1459476473900/?format=2500w" style="max-width: 500px;" />

Support is already in for [Crashlytics](https://fabric.io/kits/ios/crashlytics), [Sentry](https://getsentry.com/welcome/) and [HockeyApp](http://hockeyapp.net/features/). 

Everything is open source, so we can add support for our own service if needed.

More info about all of this can be found in _fastlane's_ docs, [found here](https://github.com/fastlane/fastlane/blob/master/fastlane/docs/Actions.md#download_dsyms).
