Repository navigation
Flutter migrate #40460
Description
Use case
The platforms that Flutter supports introduce new features every year. To support these features, the Flutter tool may need to change the files in an existing project.
Features introduced in Flutter may also require changes to the underlaying project structure.
Because developers may configure project files in ways that we don't see ahead of time, changes to the project files may cause issues that are hard to revert. Even when the files are source controlled, the developer could have unstaged changes.
As a result, changes performed by the tool must ensure that they won't disrupt the developer's workflow.
Proposal
Create a new subcommand: flutter migrate that tracks all the migrations performed to an existing project and provides an option to revert the change.
DevX: If flutter build apk updated some files, the changes can be reverted by using flutter migrate --revert.
There are still more details to figure out:
- What happen if they are multiple migrations?
- Can a migration depend on another migration?
- Can the order of the migrations cause issues?
Design doc
https://flutter.dev/go/flutter-migrate
Activity
jmagman commentedon Jan 16, 2020
@blasten Is this a duplicate of #12573?
See also #12983.
blasten commentedon Jan 16, 2020
@jmagman they are related, but not a full duplicate.
Jonas-Sander commentedon Mar 11, 2020
One example we had with our app was that we could not build it reliably with XCode on codemagic.
Our app was created about 1 1/2 years ago which meant that new configurations of projects created with a recent flutter version were not in our project.
In the end we fixed it by making a new flutter project and replacing the old files with these.
flutter migratewould be way easier in this regard.jmagman commentedon Mar 11, 2020
Examples of Xcode project changes with automatic migration:
#51453 (bonus doc: https://flutter.dev/docs/development/ios-project-migration)
#52288
#13011
Examples of updating template for new Xcode projects, no migration for existing projects:
#33684
#49654
#34293
#41882
#8971
GaryQian commentedon Feb 17, 2022
#95708
GaryQian commentedon Mar 29, 2022
#100284
GaryQian commentedon Apr 19, 2022
#101937 - Utils PR
reke592 commentedon May 26, 2022
Hi, We have an app created from the old sdk version, then we upgrade the sdk and run the migration.
what we notice is the /web/index.html has no changes and is different compare to the updated sdk web/index when creating a new project.
will it be possible for the migration tool to upgrade also the web build process
regards,
reidbaker commentedon Feb 9, 2023
Gary is no longer working on flutter issues. Removing him to correctly reflect bug status.
1b289e2 Revert "[Impeller] change default sampler descriptor to use n…
github-actions commentedon Jul 11, 2025
This thread has been automatically locked since there has not been any recent activity after it was closed. If you are still experiencing a similar issue, please open a new bug, including the output of
flutter doctor -vand a minimal reproduction of the issue.