Skip to content

Symbol File Upload

Symbol File Upload

Generate dSYM Archive

If you need to automatically organize .dSYM files during the build phase, you can add a Run Script in Xcode to package the symbol files into a zip archive and then upload it via the public DataWay.

  1. Add a custom Run Script Phase in Xcode: Build Phases -> + -> New Run Script Phase
  2. Copy the script into the Run Script Phase of your Xcode project's build phases to package the .dSYM files.
  3. Script: FTdSYMUploader.sh
# Whether to only package dSYM files into a zip. You can search for FT_DSYM_ZIP_FILE in the script output log to view the generated path.
FT_DSYM_ZIP_ONLY=1

If you need to distinguish between multiple environments or versions, ensure that the applicationId, env, and version match the actual build artifacts when uploading the SourceMap.

Package Symbol Files via Terminal

Script: FTdSYMUploader.sh

Compress Symbol Files Only

sh FTdSYMUploader.sh -dSYMFolderPath <dSYMBOL_src_dir> -z

Example:

sh FTdSYMUploader.sh -dSYMFolderPath /Users/mock/Desktop/dSYMs -z

You can search for FT_DSYM_ZIP_FILE in the script output log to view the Zip file path.

Parameter Description:

  • <dSYMBOL_src_dir>: The directory path containing all .dSYM files.

Manual or Script Upload

After generating the zip file, please upload the corresponding SourceMap file via the public DataWay.

For more details, please refer to: