Сначала воспроизведите текущую сборку и сохраните версии Flutter, Dart, зависимостей и native-инструментов. Затем выберите целевой SDK и изучите миграции между версиями. Массовое обновление SDK, всех пакетов и Android/iOS-конфигурации одним действием затруднит поиск причины первого отказа.
Рабочая база включает больше pubspec.yaml
| Слой | Что сохранить |
|---|---|
| Flutter и Dart | Фактические версии и канал |
| Пакеты | pubspec.yaml и lock-файл приложения |
| Android | Версии инструментов и настройки сборки |
| iOS | Xcode и зависимости native-части |
| Проверка продукта | Критические сценарии и старую установку |
Если исходный проект уже не собирается, сначала выясните, можно ли восстановить прежнее окружение. Ошибка старой зависимости и breaking change нового SDK — разные задачи. Не называйте миграцию успешной только потому, что новый пустой проект запускается на том же компьютере.
SDK и пакеты обновляются разными механизмами
Руководство Flutter указывает, что flutter upgrade обновляет SDK до наиболее новой версии текущего канала. Для известных breaking changes опубликованы migration guides. Источник проверен 26 октября 2026 года. Если проекту нужна конкретная версия, сначала выберите и закрепите её по официальной инструкции, а не полагайтесь на изменяющуюся цель «latest».
# Диагностика из каталога приложения до изменений
flutter --version
flutter doctor -v
dart pub outdated
# Сохранить результаты без путей с секретами и токенов.
# Затем отдельно выбрать целевой SDK и план миграции.Dart pub outdated показывает устаревшие зависимости и варианты обновления. Официальная документация рекомендует после изменений проверять поведение пакета; проверено 26 октября 2026 года. Различайте прямую зависимость и транзитивное ограничение. Замена всего дерева на произвольные версии через overrides может скрыть конфликт, но не доказать совместимость.
Составьте небольшие этапы: SDK и исправления его API, затем совместимые пакеты, затем затронутые native-настройки. Конкретный порядок может потребовать корректировки из-за требований плагина, но каждый этап должен иметь понятную причину и проверяемый результат. Сохраняйте изменения так, чтобы их можно было сопоставить с первой ошибкой.
Не переносите автоматически старые native-файлы в новый шаблон и не заменяйте всю папку Android/iOS без разбора. Там могут быть deep links, разрешения, подпись и настройки уведомлений. Сравните требуемую миграцию с собственными изменениями проекта и сохраните назначение каждого существенного блока.
Запуск с нуля не заменяет обновление пользователя
- Собрать и проверить исходную версию в сохранённом окружении.
- Выполнить один этап миграции и разобрать анализатор и сборку.
- Пройти критические сценарии в затронутых платформах.
- Установить новую версию поверх тестовой старой.
- Проверить данные, вход, разрешения и фоновую работу.
Миграция локальной базы и хранилища сессии может проявиться только при обновлении существующей установки. Чистый запуск не содержит старых данных. Используйте искусственный профиль с характерной историей и заранее определите, что произойдёт при частичном отказе миграции.
Откат исходников не обязательно откатывает формат данных на устройстве. Если новая версия изменила схему, предусмотрите совместимость или отдельный план восстановления. Не проверяйте это удалением данных реального пользователя; тестовая копия должна воспроизводить нужный путь обновления.
Для завершения подготовьте матрицу исходных и целевых версий, список миграций и результаты сценариев. Успех означает воспроизводимую release-сборку и сохранение поведения после обновления старой установки. Отсутствие ошибок в IDE само по себе не подтверждает работоспособность подписи, API и native-плагинов.