Skip to content

dsym_verify

Verify that a dSYM (debug symbols) file matches a compiled binary by comparing their UUIDs. When crash reports come in from production, you need the matching dSYM to symbolicate stack traces back to source code. This tool confirms the pairing is correct before you upload symbols to a crash reporting service or attempt local symbolication.

Parameters

Parameter	Type	Required	Default	Description
`dsymPath`	string	Yes	—	Absolute path to the `.dSYM` bundle
`binaryPath`	string	Yes	—	Absolute path to the Mach-O binary executable to verify against

Usage Examples

Verify a dSYM from an archive

“Verify the dSYM matches the FitnessTracker binary from my latest archive”

{
  "dsymPath": "/Users/dev/Library/Developer/Xcode/Archives/2025-01-15/FitnessTracker.xcarchive/dSYMs/FitnessTracker.app.dSYM",
  "binaryPath": "/Users/dev/Library/Developer/Xcode/Archives/2025-01-15/FitnessTracker.xcarchive/Products/Applications/FitnessTracker.app/FitnessTracker"
}

Verify symbols before uploading to Crashlytics

“Make sure this dSYM is correct before I upload it to Firebase Crashlytics”

{
  "dsymPath": "/Users/dev/Desktop/dSYMs/FitnessTracker.app.dSYM",
  "binaryPath": "/Users/dev/Desktop/builds/FitnessTracker.app/FitnessTracker"
}

Verify a framework’s dSYM

“Check if the Charts framework dSYM matches the embedded framework binary”

{
  "dsymPath": "/Users/dev/Library/Developer/Xcode/Archives/2025-01-15/FitnessTracker.xcarchive/dSYMs/Charts.framework.dSYM",
  "binaryPath": "/Users/dev/Library/Developer/Xcode/Archives/2025-01-15/FitnessTracker.xcarchive/Products/Applications/FitnessTracker.app/Frameworks/Charts.framework/Charts"
}

Example Output

When the dSYM matches the binary:

dSYM Verification: MATCH

Binary:  /Users/dev/.../FitnessTracker.app/FitnessTracker
dSYM:    /Users/dev/.../dSYMs/FitnessTracker.app.dSYM

Binary UUID:  A1B2C3D4-E5F6-7890-ABCD-EF1234567890
dSYM UUID:    A1B2C3D4-E5F6-7890-ABCD-EF1234567890
Architecture: arm64

Status: UUIDs match. This dSYM can be used to symbolicate crash reports for this binary.

When they do not match:

dSYM Verification: MISMATCH

Binary:  /Users/dev/.../FitnessTracker.app/FitnessTracker
dSYM:    /Users/dev/.../dSYMs/FitnessTracker.app.dSYM

Binary UUID:  A1B2C3D4-E5F6-7890-ABCD-EF1234567890
dSYM UUID:    F9E8D7C6-B5A4-3210-FEDC-BA9876543210
Architecture: arm64

Status: UUIDs DO NOT match. This dSYM was generated from a different build and cannot symbolicate crashes from this binary.

binary_size — Analyze the size of the binary whose dSYM you are verifying
ipa_analyze — Extract metadata from the IPA that contains this binary
xcode_archive — Create an archive that produces both the binary and its dSYM

Tips