flutter/packages/flutter_tools/lib/src/commands
Victoria Ashworth eb07c51230
Add lldb init file (#164344)
Adds an .lldbinit file to iOS app xcscheme.

Adding to scheme files can be error prone since a developer may be using
custom schemes (flavors). If we can't add it to the scheme, we print an
error without failing.

Since it is part of the scheme, it will be added to the project and will
be used on every run regardless of the device type/version. The Dart
side handles limiting to specific devices. If needed, we can alter the
.lldbinit file during `flutter assemble` to rewrite it since it doesn't
read the file until launch time (therefore it can be changed during
build time).

During `flutter assemble`, if the project doesn't have an LLDB Init File
set for any schemes, it'll throw an error if running in debug mode with
an iOS 18.4+ device.

## Pre-launch Checklist

- [x] I read the [Contributor Guide] and followed the process outlined
there for submitting PRs.
- [x] I read the [Tree Hygiene] wiki page, which explains my
responsibilities.
- [x] I read and followed the [Flutter Style Guide], including [Features
we expect every widget to implement].
- [x] I signed the [CLA].
- [ ] I listed at least one issue that this PR fixes in the description
above.
- [x] I updated/added relevant documentation (doc comments with `///`).
- [x] I added new tests to check the change I am making, or this PR is
[test-exempt].
- [x] I followed the [breaking change policy] and added [Data Driven
Fixes] where supported.
- [x] All existing and new tests are passing.

If you need help, consider asking for advice on the #hackers-new channel
on [Discord].

<!-- Links -->
[Contributor Guide]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#overview
[Tree Hygiene]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md
[test-exempt]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#tests
[Flutter Style Guide]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md
[Features we expect every widget to implement]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#features-we-expect-every-widget-to-implement
[CLA]: https://cla.developers.google.com/
[flutter/tests]: https://github.com/flutter/tests
[breaking change policy]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#handling-breaking-changes
[Discord]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Chat.md
[Data Driven Fixes]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Data-driven-Fixes.md
2025-03-06 21:21:52 +00:00
..
analyze_base.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
analyze_continuously.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
analyze_once.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
analyze.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
android_analyze.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
assemble.dart [reland] delete FlutterCommand.usageValues (#162550) 2025-02-03 20:26:04 +00:00
attach.dart Remove the last vestiges of null-unsafety in flutter_tools. (#164026) 2025-02-27 16:31:22 +00:00
build_aar.dart Remove the last vestiges of null-unsafety in flutter_tools. (#164026) 2025-02-27 16:31:22 +00:00
build_apk.dart Remove the last vestiges of null-unsafety in flutter_tools. (#164026) 2025-02-27 16:31:22 +00:00
build_appbundle.dart Remove the last vestiges of null-unsafety in flutter_tools. (#164026) 2025-02-27 16:31:22 +00:00
build_bundle.dart Finish removing null-safety mode, checks, and reporting. (#163153) 2025-02-12 21:52:02 +00:00
build_ios_framework.dart Add lldb init file (#164344) 2025-03-06 21:21:52 +00:00
build_ios.dart Remove the last vestiges of null-unsafety in flutter_tools. (#164026) 2025-02-27 16:31:22 +00:00
build_linux.dart Finish removing null-safety mode, checks, and reporting. (#163153) 2025-02-12 21:52:02 +00:00
build_macos_framework.dart Finish removing null-safety mode, checks, and reporting. (#163153) 2025-02-12 21:52:02 +00:00
build_macos.dart Finish removing null-safety mode, checks, and reporting. (#163153) 2025-02-12 21:52:02 +00:00
build_web.dart Remove the last vestiges of null-unsafety in flutter_tools. (#164026) 2025-02-27 16:31:22 +00:00
build_windows.dart Finish removing null-safety mode, checks, and reporting. (#163153) 2025-02-12 21:52:02 +00:00
build.dart Finish removing null-safety mode, checks, and reporting. (#163153) 2025-02-12 21:52:02 +00:00
channel.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
clean.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
config.dart remove more (simple) usage of package:usage (#162354) 2025-01-30 18:09:19 +00:00
create_base.dart remove usage of Usage from build system (#160663) 2025-01-16 21:54:58 +00:00
create.dart Make releaseMode explicit, inform determineDevDependencies entirely on the flag (#163780) 2025-02-21 00:07:48 +00:00
custom_devices.dart route CLI command usage information through the logger instead of using print (#161533) 2025-01-16 21:53:58 +00:00
daemon.dart Align web terminal messages with the VM (#163268) 2025-02-14 19:57:53 +00:00
debug_adapter.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
devices.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
doctor.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
downgrade.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
drive.dart Align web terminal messages with the VM (#163268) 2025-02-14 19:57:53 +00:00
emulators.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
generate_localizations.dart Fix tests to prepare for --explicit-package-dependencies and a bug. (#162289) 2025-01-29 02:04:50 +00:00
generate.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
ide_config.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
install.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
ios_analyze.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
logs.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
make_host_app_editable.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
packages.dart Remove the last vestiges of null-unsafety in flutter_tools. (#164026) 2025-02-27 16:31:22 +00:00
precache.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
run.dart Remove the last vestiges of null-unsafety in flutter_tools. (#164026) 2025-02-27 16:31:22 +00:00
screenshot.dart 🔊 [tool] Add a wirelessly connected device name as displayName (#160497) 2025-01-10 20:51:34 +00:00
shell_completion.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
symbolize.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
test.dart Remove the last vestiges of null-unsafety in flutter_tools. (#164026) 2025-02-27 16:31:22 +00:00
update_packages.dart Remove outdated ignores (#162773) 2025-02-06 18:40:25 +00:00
upgrade.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
validate_project.dart Auto-format Framework (#160545) 2024-12-19 20:06:21 +00:00
widget_preview.dart Remove legacy scenec stuff from flutter_tool (#163569) 2025-02-21 17:41:02 +00:00