Document PDB symbol files for obfuscated Windows x64 builds - #13787
Open
linzj wants to merge 1 commit into
Open
Conversation
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Code Review
This pull request updates the obfuscation documentation to include specific instructions for Windows x64 builds, noting that they generate a PDB file instead of a SYMBOLS file and require a Windows debugger like WinDbg. The review feedback suggests improving consistency by referencing the PDB file in the backup instructions and moving the Windows-specific note to the beginning of the stack trace section to prevent Windows users from following unnecessary steps.
linzj
force-pushed
the
obfuscate-windows-pdb
branch
from
August 25, 2026 00:58
77d5963 to
dd90298
Compare
With PE/COFF AOT snapshots, Windows x64 obfuscated builds produce a PDB file instead of a SYMBOLS file, and flutter symbolize does not support PDB files. Document this in the obfuscation guide: note the PDB output in the build and backup steps, and explain at the top of the 'Read an obfuscated stack trace' section that Windows x64 users should load the PDB in a Windows debugger such as WinDbg.
linzj
force-pushed
the
obfuscate-windows-pdb
branch
from
August 25, 2026 01:21
dd90298 to
6dcfa69
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
With PE/COFF AOT snapshots (flutter/flutter#187594), Windows x64 builds using
--split-debug-infoproduce a PDB file (app.windows-x64.pdb) instead of anapp.windows-x64.symbolsDWARF file, andflutter symbolizedoesn't support PDB files.This updates the obfuscation docs to:
app.windows-x64.pdbinstead of a SYMBOLS file.flutter symbolizedoesn't support PDB files, and that stack traces from obfuscated Windows x64 builds are read with a Windows debugger (for example, WinDbg) and the PDB file.Do not merge until flutter/flutter#187594 lands and reaches the stable channel, since this page documents stable-channel behavior.
Fixes the docs question raised in flutter/flutter#187594 (comment)