Skip to content

Add SwiftUI minimal display-list LLDB hook - #974

Merged
Kyle-Ye merged 1 commit into
mainfrom
feature/text_dl
Aug 2, 2026
Merged

Add SwiftUI minimal display-list LLDB hook#974
Kyle-Ye merged 1 commit into
mainfrom
feature/text_dl

Conversation

@Kyle-Ye

@Kyle-Ye Kyle-Ye commented Aug 2, 2026

Copy link
Copy Markdown
Member

Summary

  • Add an LLDB command that redirects SwiftUI DisplayList.description calls to minimalDescription inside the debugged process.
  • Avoid breakpoint-based interception and restore the original instruction and conflicting breakpoint locations when disabled.
  • Automatically import the command for the SUI_Example, SUI_HostingExample, and SUI_TestingHost schemes.
  • Document setup, usage, compatibility, and recovery behavior.

Motivation

SWIFTUI_PRINT_TREE=1 always prints the full display-list description, which becomes difficult to scan for large view hierarchies. SwiftUI also provides a compact minimalDescription, but does not expose an environment switch for selecting it.

Validation

  • Confirmed that .lldbinit-swiftui imports the command independently of LLDB's working directory.
  • Regenerated the Example workspace and verified the custom LLDB init path on all three SwiftUI run schemes.
  • Verified minimal output, conflicting-breakpoint handling, and instruction restoration on an arm64 iOS 18.5 Simulator.

@github-actions github-actions Bot added area: example Example apps, previews, sample projects, screenshots, or demo assets. area: rendering DisplayList, render backends, renderer hosts, drawing, and effects. area: tooling Developer tooling, package manifests, Tuist, scripts, formatting, or release tooling. type: docs Documentation, README, guides, or package index metadata. type: feature New API, behavior, platform support, or user-facing capability. labels Aug 2, 2026
@Kyle-Ye
Kyle-Ye marked this pull request as ready for review August 2, 2026 18:59
@Kyle-Ye
Kyle-Ye merged commit b92eeb2 into main Aug 2, 2026
2 of 8 checks passed
@Kyle-Ye
Kyle-Ye deleted the feature/text_dl branch August 2, 2026 19:23
@tuist

tuist Bot commented Aug 2, 2026

Copy link
Copy Markdown

🛠️ Tuist Run Report 🛠️

Tests 🧪

Scheme Status Cache hit rate Tests Skipped Ran Commit
OpenSwiftUI 0 % 82 0 82 ac505248a

Builds 🔨

Scheme Status Duration Commit
OpenSwiftUI 2m 45s ac505248a

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: example Example apps, previews, sample projects, screenshots, or demo assets. area: rendering DisplayList, render backends, renderer hosts, drawing, and effects. area: tooling Developer tooling, package manifests, Tuist, scripts, formatting, or release tooling. type: docs Documentation, README, guides, or package index metadata. type: feature New API, behavior, platform support, or user-facing capability.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant