Migrate a Windows project to the idiomatic run loop
Flutter 2.5 replaced Windows apps' run loop with an idiomatic Windows message pump to reduce CPU usage.
Projects created before Flutter version 2.5 need to be
migrated to get this improvement. You should follow the
migration steps below if the windows/runner/run_loop.h
file exists in your project.
Migration steps
#Your project can be updated using these steps:
- Verify you are on Flutter version 2.5 or newer using
flutter --version -
If needed, use
flutter upgradeto update to the latest version of the Flutter SDK - Backup your project with git (or your preferred version control system), since you need to reapply any local changes you've made (if any) to your project in a later step
- Delete all files under the
windows/runnerfolder - Run
flutter create --platforms=windows .to recreate the Windows project - Review the changes to files in the
windows/runnerfolder -
Reapply any custom changes made to the files in the
windows/runnerfolder prior to this migration - Verify that your app builds using
flutter build windows
Unless stated otherwise, the documentation on this site reflects Flutter 3.35.5. Page last updated on 2025-10-28. View source or report an issue.