Skip to content

docs: clarify Dart symbols vs Shorebird engine symbols for crash reporting - #706

Merged
AbhishekDoshi26 merged 9 commits into
mainfrom
docs/clarify-engine-vs-dart-symbols
Sep 30, 2026
Merged

AbhishekDoshi26 merged 9 commits into
mainfrom
docs/clarify-engine-vs-dart-symbols

Conversation

@AbhishekDoshi26

@AbhishekDoshi26 AbhishekDoshi26 commented Sep 30, 2026 •

Copy link
Copy Markdown
Member

Adds a caution to Uploading Symbols explaining that Shorebird engine symbols (native libflutter.so / Flutter.framework frames) and Dart symbols (--obfuscate / --split-debug-info output) are separate uploads. Uploading only the --split-debug-info output with firebase crashlytics:symbols:upload leaves native engine crashes unsymbolicated. Also notes that Crashlytics needs Dart symbols uploaded before an obfuscated build reports a crash, so they should be uploaded as part of each build.

Adds an "Uploading engine symbols to Crashlytics" section covering Android (NDK crash reporting, unzipping each architecture's symbols.zip, firebase crashlytics:symbols:upload) and iOS (console dSYMs tab or the upload-symbols script).

Corrects the console section, based on the console source: the Artifacts tab only links the engine dSYM for iOS and macOS releases (not Android engine symbols) and needs the Developer role or higher (org or app collaborator), and its URL is now org-scoped (/orgs/<org-id>/apps/<app-id>/releases/<release-id>/artifacts; the old /apps/... URL returns 404). Notes that older Flutter versions name the iOS file Flutter.dSYM.zip.

Adds a short pointer to the same distinction near the top of the Crashlytics page.

Builds on #702 (Dart symbols for obfuscated builds).

@AbhishekDoshi26 AbhishekDoshi26 left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Self-review. One claim needs fixing and two wording points are worth tightening; details inline. Checked and fine: the #dart-symbols-for-obfuscated-builds anchor exists on main (#702), "the console or the URLs below" points at real content, the cspell:words comment matches the CI pages, and no agent entry points need updating since no command, flag, or workflow page is added.

Comment thread src/content/docs/code-push/crash-reporting/uploading-symbols.mdx Outdated
Comment thread src/content/docs/code-push/crash-reporting/uploading-symbols.mdx Outdated
Comment thread src/content/docs/code-push/crash-reporting/uploading-symbols.mdx Outdated
Comment thread src/content/docs/code-push/crash-reporting/crashlytics.mdx Outdated
@AbhishekDoshi26
AbhishekDoshi26 merged commit 229b5f5 into main Sep 30, 2026
4 checks passed
@AbhishekDoshi26
AbhishekDoshi26 deleted the docs/clarify-engine-vs-dart-symbols branch September 30, 2026 12:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant