[flutter_tools] A new flutter update should show version info

[royarg02]

Continuing from #67532.

Use case

Running any flutter command from a stale install would occasionally display the following message:

  ╔════════════════════════════════════════════════════════════════════════════╗
  ║ A new version of Flutter is available!                                     ║
  ║                                                                            ║
  ║ To update to the latest version, run "flutter upgrade".                    ║
  ╚════════════════════════════════════════════════════════════════════════════╝

Since #68866 and #69420 users can check for updates manually by running flutter upgrade --verify-only.

$ flutter upgrade --verify-only
A new version of Flutter is available on channel <user channel>

The latest revision: <update version>
Your current version: <user installed version>

To upgrade now, run "flutter upgrade".
$

Provided that the user is on the stable channel, the url for release notes is also shown.

Proposal

The freshness check message needs to be updated to include the update version:

A new version of Flutter is available!

The latest revision: <update version>
Your current version: <user installed version>

To update to the latest version, run "flutter upgrade".

The freshness check uses a cache to prevent network calls at every flutter command; in case the tool determines an update from the cache, we can recommend the user to run flutter upgrade --verify-only themselves instead of displaying a "stale" latest version from the cache.

A new version of Flutter is available!

To update to the latest version, run "flutter upgrade".
To compare versions, run "flutter upgrade --verify-only".

cc @christopherfujino

[Oklahomawhore]

I think a release note is what we need

[royarg02]

The url to view the release notes is displayed running flutter upgrade --verify-only if the user is on stable channel (I didn't update the PR message then, sorry).

See #68866 (comment) for context.

I wonder whether we should follow proposal no. 2, as the changelog has now been included in #68866.

We could maybe take the middle ground:

A new version of Flutter(<update version>) is available!

For more information, run "flutter upgrade --verify-only".
To upgrade now, run "flutter upgrade".

[maheshmnj]

This is currently supported (verified on the latest master)

mahesh@Maheshs-MacBook-Air-M1 sample % flutter upgrade --verify-only
A new version of Flutter is available on channel master

The latest version: 3.1.0-0.0.pre.2057 (revision a880c4ed35)
Your current version: 3.1.0-0.0.pre.2009 (revision 9d96c7b8be)

To upgrade now, run "flutter upgrade".
mahesh@Maheshs-MacBook-Air-M1 sample % 

Closing as fixed, Incase anyone disagrees feel free to write in the comments and we will reopen it.

Thank you.

[royarg02]

This is still a valid request; the subject of this issue is the message which is displayed occasionally on a freshness check, when a flutter command is run from a stale install, flutter upgrade --verify-only is a manual update check for the user.

[maheshmnj]

Thanks for the clarification, Reopening based on the above comment