flutter / website

Flutter documentation web site
https://docs.flutter.dev
Other
2.83k stars 3.23k forks source link

Create a central place on flutter.dev on how to upgrade from a version of the framework to the next #7755

Open reke592 opened 2 years ago

reke592 commented 2 years ago

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.

Do we need to re-create a new project everytime we upgrade the sdk? or there is something that we need to run aside from the migrate command.

huycozy commented 2 years ago

Hi @reke592, I think this is a requested feature that is captured in flutter/flutter#40460. It'll be great if you could add a comment on that issue for web.

reke592 commented 2 years ago

thanks for the reply, will do your suggestion

ditman commented 2 years ago

@reke592 For now, we don't update automatically the index.html file (or the web directory), because you own it, and we don't exactly know what customizations you might have made or want to keep with the new process.

In order to get the new index.html, you can follow the instructions here:

Remember to re-apply the customizations you had before to the web directory! (icons, changes to the index.html, etc...)

Let me know if this is enough information to consider this issue resolved, or we need to improve some process(es) here!

reke592 commented 2 years ago

@ditman thank you for pointing out the documentation link, will try this one.

for the process improvement, the framework update is really fast and we need keep the project in latest sdk, much better if we have a single link in documentation where we can find delails specific only for migration/upgrading the current project from version A to B.

ditman commented 2 years ago

much better if we have a single link in documentation where we can find delails specific only for migration/upgrading the current project from version A to B.

Yes, that's a good idea, I'll bring it up.

Let's re-write this issue to track progress in that common "how to ugprade" path. I know we have it for non-backwards compatible changes, but I don't know if it exists just to update from one version to the next!

yjbanov commented 2 years ago

For this specific feature it's probably too late, but the general idea of having a common place that talks about upgrading the Flutter SDK sounds useful. Will make it a feature request for the website.