[native assets] Split debug info into `.dsym` files by dcharkes · Pull Request #181533 · flutter/flutter

dcharkes · 2026-01-27T09:59:56Z

This PR splits the debug info from code assets into separate dsym files for MacOS and iOS.

The splitting only happens if the build mode is not debug. This aligns with whether the debug symbols are separated out for the Flutter framework and the app Framework.

Closes: #181377

Testing: Added some tests to the integration test

gemini-code-assist

Code Review

This pull request introduces functionality to split debug information from native code assets into separate .dsym files for macOS and iOS, and to strip the dylibs for non-debug builds. This aligns with standard release build practices to reduce binary size while retaining debuggability via dSYM files. New utility functions dsymutilDylib and stripDylib have been added to handle these operations, along with corresponding integration tests to verify the behavior. The changes are well-documented and logically applied.

packages/flutter_tools/test/integration.shard/isolated/native_assets_test.dart

bkonyi

LGTM!

vashworth · 2026-01-29T02:39:13Z

I tried this out, and it does not put the dsym in the right place and will lead to App Store failure:

The dSYM needs to be copied to the BUILT_PRODUCTS_DIR. It should not be within framework itself

vashworth · 2026-01-29T02:41:23Z

packages/flutter_tools/lib/src/isolated/native_assets/macos/native_assets_host.dart

+    'dsymutil',
+    dylibFile.path,
+    '-o',
+    dsymPath,


See comment: #181533 (comment)

This likely needs to be changed to output to somewhere outside of the framework, and then copied into the BUILT_PRODUCTS_DIR, likely in xcode_backend.dart

dcharkes · 2026-01-29T14:15:27Z

Okay, a separate dsym framework for the DWARF file, and output to the BUILT_PRODUCTS_DIR instead of inside the .app. It looks like now it's the same as the Flutter framework:

vashworth · 2026-01-29T19:16:21Z

test/general.shard/xcode_backend_test.dart needs to be updated

vashworth · 2026-01-29T19:19:26Z

Also, the stripping does not change correctly when switching between build modes. If you do

flutter build ios --debug
otool -l /path/to/my_app/build/native_assets/ios/my_ffi_plugin.framework/my_ffi_plugin -> LC_DYSYMTAB nlocalsym > 1 as expected

then do

flutter build ios --release
otool -l /path/to/my_app/build/native_assets/ios/my_ffi_plugin.framework/my_ffi_plugin -> LC_DYSYMTAB nlocalsym == 1 as expected

then do

flutter build ios --debug
otool -l /path/to/my_app/build/native_assets/ios/my_ffi_plugin.framework/my_ffi_plugin -> LC_DYSYMTAB nlocalsym is NOT > 1 as expected ❌

dcharkes · 2026-01-30T12:16:06Z

Also, the stripping does not change correctly when switching between build modes. If you do

flutter build ios --debug otool -l /path/to/my_app/build/native_assets/ios/my_ffi_plugin.framework/my_ffi_plugin -> LC_DYSYMTAB nlocalsym > 1 as expected

then do

flutter build ios --release otool -l /path/to/my_app/build/native_assets/ios/my_ffi_plugin.framework/my_ffi_plugin -> LC_DYSYMTAB nlocalsym == 1 as expected

then do

flutter build ios --debug otool -l /path/to/my_app/build/native_assets/ios/my_ffi_plugin.framework/my_ffi_plugin -> LC_DYSYMTAB nlocalsym is NOT > 1 as expected ❌

Oh nice catch!

This is a separate issue (and is already an issue before this PR), let's address it in a separate PR. The root cause is a Target writing to a directory outside .dart_tool/flutter_build/<hash>/, while the Targets assume that if their inputs don't change their outputs don't have to change. This is most likely also an issue for code assets for Android.

…r/flutter#181533)

flutter/flutter@1d9d6a9...9eafba4 2026-02-01 [email protected] Roll Skia from a8ceddc2bca0 to 4ee9eb659ae0 (1 revision) (flutter/flutter#181773) 2026-02-01 [email protected] Roll Skia from a5a535bc21a3 to a8ceddc2bca0 (1 revision) (flutter/flutter#181772) 2026-02-01 [email protected] Roll Dart SDK from cde322c518b9 to 84abc8d58ec8 (1 revision) (flutter/flutter#181767) 2026-02-01 [email protected] Roll Dart SDK from c72b3f527a07 to cde322c518b9 (1 revision) (flutter/flutter#181763) 2026-01-31 [email protected] Roll Dart SDK from 43de79f08887 to c72b3f527a07 (1 revision) (flutter/flutter#181762) 2026-01-31 [email protected] Roll Fuchsia Linux SDK from 27OsrsrKcrr2pOaqY... to nI52U4LJMrBv8G1M9... (flutter/flutter#181760) 2026-01-31 [email protected] Roll Dart SDK from a0aac59705e5 to 43de79f08887 (1 revision) (flutter/flutter#181758) 2026-01-31 [email protected] Roll Skia from b704afbcd8e7 to a5a535bc21a3 (1 revision) (flutter/flutter#181757) 2026-01-31 [email protected] Roll Dart SDK from d6f77f9098e1 to a0aac59705e5 (1 revision) (flutter/flutter#181756) 2026-01-31 [email protected] Roll Skia from 6f9511ce11ba to b704afbcd8e7 (4 revisions) (flutter/flutter#181753) 2026-01-31 [email protected] Roll Dart SDK from 0cf997832948 to d6f77f9098e1 (2 revisions) (flutter/flutter#181749) 2026-01-31 [email protected] Roll Skia from 33c00c0f3b8b to 6f9511ce11ba (1 revision) (flutter/flutter#181744) 2026-01-31 [email protected] Roll Dart SDK from be3ffc51d407 to 0cf997832948 (1 revision) (flutter/flutter#181740) 2026-01-30 [email protected] Roll Skia from b62d43b59dd6 to 33c00c0f3b8b (1 revision) (flutter/flutter#181735) 2026-01-30 [email protected] [Impeller] Fix type conversion warnings seen on Windows when Impeller GL API wrappers log arguments with function types (flutter/flutter#181734) 2026-01-30 [email protected] Update New Android API Docs (flutter/flutter#180604) 2026-01-30 [email protected] Roll Fuchsia Linux SDK from isy1ARvK-3bsvtfc-... to 27OsrsrKcrr2pOaqY... (flutter/flutter#181733) 2026-01-30 [email protected] Fix P3-to-sRGB color conversion to operate in linear light (flutter/flutter#181720) 2026-01-30 [email protected] chore: deflake Linux_mokey flutter_engine_group_performance (flutter/flutter#181624) 2026-01-30 [email protected] Roll Dart SDK from 2703fd9733ce to be3ffc51d407 (1 revision) (flutter/flutter#181729) 2026-01-30 [email protected] Ensure content-sizing resize is run on UI thread (flutter/flutter#181686) 2026-01-30 [email protected] [ Tool ] Cleanup `ResidentCompiler` initialization logic (flutter/flutter#181421) 2026-01-30 [email protected] [native assets] Split debug info into `.dsym` files (flutter/flutter#181533) 2026-01-30 [email protected] Roll Skia from 4745eb2fe837 to b62d43b59dd6 (1 revision) (flutter/flutter#181727) 2026-01-30 [email protected] add ccache support for custom toolchain (flutter/flutter#180737) 2026-01-30 [email protected] update GLFW to latest and use EGL context creation on linux (flutter/flutter#181259) 2026-01-30 [email protected] add stacktrace support when requested for host builds (flutter/flutter#181264) If this roll has caused a breakage, revert this CL and stop the roller using the controls here: https://autoroll.skia.org/r/flutter-packages Please CC [email protected],[email protected] on the revert to ensure that a human is aware of the problem. To file a bug in Packages: https://github.com/flutter/flutter/issues/new/choose To report a problem with the AutoRoller itself, please file a bug: https://issues.skia.org/issues/new?component=1389291&template=1850622 Documentation for the AutoRoller is here: https://skia.googlesource.com/buildbot/+doc/main/autoroll/README.md

This PR splits the debug info from code assets into separate dsym files for MacOS and iOS. The splitting only happens if the build mode is not debug. This aligns with whether the debug symbols are separated out for the Flutter framework and the app Framework. Closes: flutter#181377 Testing: Added some tests to the integration test

odedsolutions · 2026-02-18T07:11:54Z

Still happening on Flutter 3.41.1.

Saw the issue above was merged, when can it be expected to be included in an update? Is there a workaround until then?

thanks for all your relentless efforts!

This PR splits the debug info from code assets into separate dsym files for MacOS and iOS. The splitting only happens if the build mode is not debug. This aligns with whether the debug symbols are separated out for the Flutter framework and the app Framework. Closes: flutter#181377 Testing: Added some tests to the integration test

dcharkes · 2026-02-20T08:59:28Z

Saw the issue above was merged, when can it be expected to be included in an update? Is there a workaround until then?

https://github.com/flutter/flutter/blob/master/docs/releases/Flutter-build-release-channels.md explains how fixes reach stable for Flutter.

dcharkes requested review from bkonyi, gmackall and vashworth January 27, 2026 09:59

dcharkes requested a review from a team as a code owner January 27, 2026 09:59

github-actions bot added tool Affects the "flutter" command-line tool. See also t: labels. a: desktop Running on desktop team-ios Owned by iOS platform team labels Jan 27, 2026

gemini-code-assist bot reviewed Jan 27, 2026

View reviewed changes

bkonyi approved these changes Jan 28, 2026

View reviewed changes

vashworth requested changes Jan 29, 2026

View reviewed changes

vashworth mentioned this pull request Jan 29, 2026

[native_assets] Fix flutter build ios-framework #181507

Merged

dcharkes requested a review from vashworth January 29, 2026 14:15

dcharkes mentioned this pull request Jan 29, 2026

[objective_c] Warning when uploading to App Store Connect - Upload Symbols Failed dart-lang/native#3004

Open

dcharkes mentioned this pull request Jan 30, 2026

[native assets] Changing build modes bundles old assets #181724

Closed

[native assets] Split debug info into .dsym frameworks

7db8781

dcharkes force-pushed the code-assets-dsym branch from f036f96 to 7db8781 Compare January 30, 2026 15:01

vashworth approved these changes Jan 30, 2026

View reviewed changes

dcharkes added the autosubmit Merge PR when tree becomes green via auto submit App label Jan 30, 2026

auto-submit bot added this pull request to the merge queue Jan 30, 2026

Merged via the queue into master with commit b877bae Jan 30, 2026
147 checks passed

auto-submit bot deleted the code-assets-dsym branch January 30, 2026 18:57

flutter-dashboard bot removed the autosubmit Merge PR when tree becomes green via auto submit App label Jan 30, 2026

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Jan 31, 2026

b877bae05 [native assets] Split debug info into .dsym files (flutte…

40bb3a5

…r/flutter#181533)

engine-flutter-autoroll mentioned this pull request Jan 31, 2026

Roll Flutter from 1d9d6a9a5ef6 to 2cff642bd705 (19 revisions) flutter/packages#10934

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Jan 31, 2026

b877bae05 [native assets] Split debug info into .dsym files (flutte…

623fa00

…r/flutter#181533)

engine-flutter-autoroll mentioned this pull request Jan 31, 2026

Roll Flutter from 1d9d6a9a5ef6 to 59df2c8eee44 (20 revisions) flutter/packages#10935

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Feb 1, 2026

b877bae05 [native assets] Split debug info into .dsym files (flutte…

b73226a

…r/flutter#181533)

engine-flutter-autoroll mentioned this pull request Feb 1, 2026

Roll Flutter from 1d9d6a9a5ef6 to 11bda918fffc (26 revisions) flutter/packages#10936

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Feb 1, 2026

b877bae05 [native assets] Split debug info into .dsym files (flutte…

1c5146b

…r/flutter#181533)

engine-flutter-autoroll mentioned this pull request Feb 1, 2026

Roll Flutter from 1d9d6a9a5ef6 to 9eafba4f46a6 (27 revisions) flutter/packages#10937

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Feb 1, 2026

b877bae05 [native assets] Split debug info into .dsym files (flutte…

92dbb15

…r/flutter#181533)

engine-flutter-autoroll mentioned this pull request Feb 1, 2026

Roll Flutter from 1d9d6a9a5ef6 to 9eafba4f46a6 (27 revisions) flutter/packages#10938

Merged

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Feb 2, 2026

b877bae05 [native assets] Split debug info into .dsym files (flutte…

18a5acd

…r/flutter#181533)

engine-flutter-autoroll mentioned this pull request Feb 2, 2026

Roll Flutter from 1d9d6a9a5ef6 to a12f07d9b791 (34 revisions) flutter/packages#10951

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Feb 2, 2026

b877bae05 [native assets] Split debug info into .dsym files (flutte…

ba82e70

…r/flutter#181533)

engine-flutter-autoroll mentioned this pull request Feb 2, 2026

Roll Flutter from 1d9d6a9a5ef6 to 224d29a10550 (35 revisions) flutter/packages#10952

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Feb 2, 2026

b877bae05 [native assets] Split debug info into .dsym files (flutte…

6347359

…r/flutter#181533)

engine-flutter-autoroll mentioned this pull request Feb 2, 2026

Roll Flutter from 1d9d6a9a5ef6 to 54b8778c78c3 (36 revisions) flutter/packages#10953

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Feb 2, 2026

b877bae05 [native assets] Split debug info into .dsym files (flutte…

9f48979

…r/flutter#181533)

engine-flutter-autoroll mentioned this pull request Feb 2, 2026

Roll Flutter from 1d9d6a9a5ef6 to f4674dce834d (37 revisions) flutter/packages#10954

Closed

dcharkes mentioned this pull request Feb 4, 2026

[path_provider_foundation] objective_c.framework minimum OS Version error and missed dSYM dart-lang/native#3049

Closed

dcharkes mentioned this pull request Feb 6, 2026

"Target native_assets required define SdkRoot but it was not provided" during hot reload on iOS with native FFI packages #180603

Closed

Piinks mentioned this pull request Feb 6, 2026

Flutter Notable Commits - 2026 #181433

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[native assets] Split debug info into `.dsym` files#181533

[native assets] Split debug info into `.dsym` files#181533
auto-submit[bot] merged 1 commit intomasterfrom
code-assets-dsym

dcharkes commented Jan 27, 2026

Uh oh!

gemini-code-assist bot left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

bkonyi left a comment

Uh oh!

vashworth commented Jan 29, 2026

Uh oh!

vashworth Jan 29, 2026

Uh oh!

dcharkes commented Jan 29, 2026

Uh oh!

vashworth commented Jan 29, 2026

Uh oh!

vashworth commented Jan 29, 2026

Uh oh!

dcharkes commented Jan 30, 2026

Uh oh!

Uh oh!

odedsolutions commented Feb 18, 2026 •

edited

Loading

Uh oh!

dcharkes commented Feb 20, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

dcharkes commented Jan 27, 2026

Uh oh!

gemini-code-assist bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

bkonyi left a comment

Choose a reason for hiding this comment

Uh oh!

vashworth commented Jan 29, 2026

Uh oh!

vashworth Jan 29, 2026

Choose a reason for hiding this comment

Uh oh!

dcharkes commented Jan 29, 2026

Uh oh!

vashworth commented Jan 29, 2026

Uh oh!

vashworth commented Jan 29, 2026

Uh oh!

dcharkes commented Jan 30, 2026

Uh oh!

Uh oh!

odedsolutions commented Feb 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

dcharkes commented Feb 20, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

odedsolutions commented Feb 18, 2026 •

edited

Loading