Hot reload на физическом устройстве поддерживается, но только когда приложение запущено Flutter-инструментами в debug-режиме и debug-сессия всё ещё подключена. Откройте терминал, выполните `flutter devices`, запустите конкретный телефон через `flutter run -d <device-id>` и нажмите `r` в этом же терминале. Строка об успешной перезагрузке или точная ошибка полезнее, чем повторные клики по молнии в IDE.
Для контрольного теста измените видимый `Text` внутри уже выполняемого метода `build()`. Если эта правка появляется, канал работает, а исходная правка относится к состоянию или коду, который hot reload не переисполняет. Если не появляется даже текст, ищите потерянное соединение, другую выбранную цель, compilation error или запуск в profile/release.
Три команды решают разные задачи
| Действие | Что сохраняется | Когда применять |
|---|---|---|
| hot reload (`r`) | состояние Dart-объектов | правка UI и методов, которые снова вызываются при rebuild |
| hot restart (`R`) | код загружается заново, состояние приложения теряется | изменён startup-код, initState или инициализаторы |
| full restart | ничего; нативная часть пересобирается | изменены Kotlin, Java, Swift, Objective-C, плагины или настройки платформы |
Официальная документация Flutter отдельно отмечает: hot reload не запускает повторно `main()` и `initState()`, а глобальные и static-поля считаются состоянием. Поэтому сообщение «Reloaded … libraries» может быть честным, хотя ожидаемая переменная на экране не изменилась. В таком случае это не сбой телефона — нужен hot restart.
Сначала закрепите правильное устройство за сессией
flutter doctor -v
flutter devices
flutter run -d <device-id>
# изменить Text внутри build(), сохранить файл
r # hot reload
R # hot restart, если нужна новая инициализацияСверьте device ID и имя приложения в выводе команды. Телефон может быть виден операционной системе, но иметь состояние `unauthorized`, потерять доверие к компьютеру или отключиться при блокировке экрана. На Android снова подтвердите USB debugging; на iOS проверьте доверие устройству и условия запуска разработки. После смены кабеля или сети проще остановить старую сессию и создать новую, чем посылать reload в уже закрытый VM service.
- Не запускайте установленный APK/IPA вручную и не ждите, что терминал сам к нему подключится.
- Не выбирайте устройство по порядковому номеру из вчерашнего списка: используйте текущий device ID.
- Смотрите на консоль `flutter run`; IDE иногда показывает только общий баннер без первичной ошибки.
- Если приложение было выгружено системой в фоне, перезапустите debug-сессию.
Успешный reload может не выполнить изменённую строку
После загрузки нового Dart-кода Flutter перестраивает существующее дерево виджетов, но исполняется только код, к которому приводит rebuild. Правка в конструкторе уже созданного объекта, `initState()`, ленивом static initializer или ветке, которая сейчас не вызывается, визуально не проявится. Перейдите на экран заново, вызовите действие, которое исполняет метод, или используйте hot restart.
Есть и изменения структуры типов, которые механизм не может применить безопасно: например, превращение enum в class или изменение числа параметров generic-типа. В консоли появляется rejected reload. Это ожидаемое ограничение; исправлять настройки USB здесь бессмысленно.
Ошибка компиляции оставляет на устройстве старый код
При синтаксической или type-ошибке Flutter отклоняет reload и продолжает выполнять предыдущую рабочую версию. Найдите первую ошибку компилятора, исправьте её и снова нажмите `r`. Не ориентируйтесь только на то, что приложение не закрылось: сохранение старого состояния после отказа — нормальное поведение инструмента.
Контрольный журнал:
[21:18:04] target=Pixel_8_API34 / physical
[21:18:10] mode=debug, VM service connected
[21:18:25] changed=lib/profile/view.dart: build()
[21:18:27] action=hot reload
[21:18:28] result=Reloaded 3 of 1267 libraries
[21:18:30] visible_text=TEST-2107Минимальная матрица локализует сбой за пять минут
- На том же телефоне поменяйте Text внутри build и вызовите `r` из flutter run.
- Если не сработало, запишите первую ошибку консоли и статус устройства из flutter devices.
- Если Text обновился, повторите исходную правку и вызовите `R` для новой инициализации.
- Если менялся нативный код или platform configuration, остановите процесс и выполните полный запуск.
- Повторите тест в эмуляторе только для сравнения; не считайте его доказательством исправления физического подключения.
Результат считается устойчивым, когда debug-сессия однозначно привязана к устройству, контрольный UI reload проходит, а команда знает, какие классы изменений требуют restart. Такой протокол избавляет от ритуального `flutter clean`: очистка сборки полезна для отдельных проблем артефактов, но не заменяет проверку режима и активного VM service.