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.