download_dsyms

Download dSYM files from App Store Connect for Bitcode apps

This action downloads dSYM files from App Store Connect after the ipa gets re-compiled by Apple. Useful if you have Bitcode enabled.

lane :refresh_dsyms do
  download_dsyms                  # Download dSYM files from iTC
  upload_symbols_to_crashlytics   # Upload them to Crashlytics
  clean_build_artifacts           # Delete the local dSYM files
end
download_dsyms
Supported platforms ios
Author @KrauseFx

3 Examples

download_dsyms
download_dsyms(version: "1.0.0", build_number: "345")
download_dsyms(min_version: "1.2.3")

Parameters

Key Description Default
username Your Apple ID Username for App Store Connect *
app_identifier The bundle identifier of your app *
team_id The ID of your App Store Connect team if you're in multiple teams *
team_name The name of your App Store Connect team if you're in multiple teams *
platform The app platform for dSYMs you wish to download (ios, appletvos) :ios
version The app version for dSYMs you wish to download, pass in 'latest' to download only the latest build's dSYMs
build_number The app build_number for dSYMs you wish to download
min_version The minimum app version for dSYMs you wish to download
output_directory Where to save the download dSYMs, defaults to the current path

* = default value is dependent on the user's system


Documentation

To show the documentation in your terminal, run

fastlane action download_dsyms

CLI

It is recommended to add the above action into your Fastfile, however sometimes you might want to run one-offs. To do so, you can run the following command from your terminal

fastlane run download_dsyms

To pass parameters, make use of the : symbol, for example

fastlane run download_dsyms parameter1:"value1" parameter2:"value2"

It's important to note that the CLI supports primative types like integers, floats, booleans, and strings. Arrays can be passed as a comma delimited string (e.g. param:"1,2,3"). Hashes are not currently supported.

It is recommended to add all fastlane actions you use to your Fastfile.


Source code

This action, just like the rest of fastlane, is fully open source, view the source code on GitHub


Back to actions