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

Минимальная матрица локализует сбой за пять минут

  1. На том же телефоне поменяйте Text внутри build и вызовите `r` из flutter run.
  2. Если не сработало, запишите первую ошибку консоли и статус устройства из flutter devices.
  3. Если Text обновился, повторите исходную правку и вызовите `R` для новой инициализации.
  4. Если менялся нативный код или platform configuration, остановите процесс и выполните полный запуск.
  5. Повторите тест в эмуляторе только для сравнения; не считайте его доказательством исправления физического подключения.

Результат считается устойчивым, когда debug-сессия однозначно привязана к устройству, контрольный UI reload проходит, а команда знает, какие классы изменений требуют restart. Такой протокол избавляет от ритуального `flutter clean`: очистка сборки полезна для отдельных проблем артефактов, но не заменяет проверку режима и активного VM service.

Проверенные источники