Add migration note about how PUB_CACHE has moved (#4882)

Context: dart-lang/sdk#52386 --------- Co-authored-by: Anthony Sansone <[email protected]> Co-authored-by: Parker Lougheed <[email protected]>
dart-lang · May 23, 2023 · 19a68f2 · 19a68f2
1 parent 0b55016
commit 19a68f2
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/src/resources/dart-3-migration.md b/src/resources/dart-3-migration.md
@@ -596,6 +596,12 @@ analyzer:
   have been cleaned up [#50700](https://github.com/dart-lang/sdk/issues/50700).
 * The output of `dart format` changed a bit for
   [some code](https://github.com/dart-lang/sdk/blob/main/CHANGELOG.md#formatter).
+* Ending backwards compatibility for the old location of pub-cache on Windows.
+  Prior to Dart 3 `%APPDATA%\Pub\Cache` was a fallback location for pub-cache.
+  Starting with Dart 3, the default pub-cache is located at
+  `%LOCALAPPDATA%\Pub\Cache`.
+  If you have added globally activated packages to your `PATH`, consider
+  updating `PATH` to contain `%LOCALAPPDATA%\Pub\Cache\bin`.
 
 #### Scope