Skip to content

Add LLDB Init Instructions for Add to App #12131

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Jun 20, 2025

Conversation

vashworth
Copy link
Contributor

Add instructions on how to manually add Flutter's LLDB Init File. This is added to prevent crashes in debug mode on iOS 26.

Presubmit checklist

  • This PR is marked as draft with an explanation if not meant to land until a future stable release.
  • This PR doesn’t contain automatically generated corrections (Grammarly or similar).
  • This PR follows the Google Developer Documentation Style Guidelines — for example, it doesn’t use i.e. or e.g., and it avoids I and we (first person).
  • This PR uses semantic line breaks of 80 characters or fewer.

@flutter-website-bot
Copy link
Collaborator

flutter-website-bot commented Jun 17, 2025

Visit the preview URL for this PR (updated for commit 61f5a13):

https://flutter-docs-prod--pr12131-lldb-instructions-2hqj4n73.web.app

1. Set the **LLDB Init File** to the following:

```console
$(SRCROOT)/$(FLUTTER_APPLICATION_PATH)/.ios/Flutter/ephemeral/flutter_lldbinit
Copy link
Member

Choose a reason for hiding this comment

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

What happens if this file doesn't exist, for example after a flutter clean? Will the build succeed, or fail with an inscrutable error?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

It will succeed and give a warning that it couldn't find the file.

I'll add some instructions to make sure the file exists

@vashworth vashworth marked this pull request as ready for review June 17, 2025 22:31
@vashworth vashworth requested review from sfshaza2, parlough, a team and antfitch as code owners June 17, 2025 22:31
@vashworth
Copy link
Contributor Author

@jmagman FYI I decided to change it to not use a build setting and just put the relative path in the LLDB Init File setting because 1) the build setting can't be used in CocoaPods so what's the point and 2) the build setting can't be used if you're adding the Flutter LLDB init to a preexisting LLDB init file

Copy link
Contributor

@sfshaza2 sfshaza2 left a comment

Choose a reason for hiding this comment

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

lgtm

@sfshaza2 sfshaza2 merged commit 4c98eb9 into flutter:main Jun 20, 2025
9 checks passed
ericwindmill pushed a commit that referenced this pull request Jun 24, 2025
Add instructions on how to manually add Flutter's LLDB Init File. This
is added to prevent crashes in debug mode on iOS 26.

## Presubmit checklist

- [ ] This PR is marked as draft with an explanation if not meant to
land until a future stable release.
- [x] This PR doesn’t contain automatically generated corrections
(Grammarly or similar).
- [x] This PR follows the [Google Developer Documentation Style
Guidelines](https://developers.google.com/style) — for example, it
doesn’t use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first person).
- [x] This PR uses [semantic line
breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks)
of 80 characters or fewer.
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.

4 participants