diff --git a/src/_includes/docs/install/admonitions/install-paths.md b/src/_includes/docs/install/admonitions/install-paths.md new file mode 100644 index 00000000000..00f57b6ae17 --- /dev/null +++ b/src/_includes/docs/install/admonitions/install-paths.md @@ -0,0 +1,12 @@ + + {{site.alert.warning}} + + Don't install Flutter to a directory or path that meets + one or both of the following conditions: + + * The path contains special characters or spaces. + * The path requires elevated privileges. + + As an example, `C:\Program Files\` fails both conditions. + + {{site.alert.end}} diff --git a/src/_includes/docs/install/flutter/download.md b/src/_includes/docs/install/flutter/download.md index a05029aadc0..80da33bb84c 100644 --- a/src/_includes/docs/install/flutter/download.md +++ b/src/_includes/docs/install/flutter/download.md @@ -12,32 +12,26 @@ {% endif -%} 1. Download the following installation bundle to get the latest - {{site.sdk.channel}} release of the Flutter SDK: + {{site.sdk.channel}} release of the Flutter SDK. [(loading...)](#){:.download-latest-link-{{osl}}.btn.btn-primary} For other release channels, and older builds, check out the [SDK archive][]. -1. Extract the zip file. +1. Create a folder where you can install Flutter. - ```terminal - {{unzip}} [(loading...)](#){:.download-latest-link-{{osl}}} - ``` + Consider `%USERPROFILE%` or `D:\dev`. -1. Move the contained `flutter` directory - to where you want to store the Flutter SDK. + {% include docs/install/admonitions/install-paths.md %} - {{site.alert.warning}} - Do not install Flutter to a directory or path that meets - one or both of the following conditions: +1. Move the zip file into the directory you want to store the Flutter SDK. - - The path contains special characters or spaces. - - The path requires elevated privileges. +1. Extract the zip file. - As an example, `C:\Program Files\` fails both conditions. - You could use `%USERPROFILE%\flutter` or `D:\dev\flutter`. - {{site.alert.end}} + ```terminal + {{unzip}} {:.download-latest-link-{{osl}}} + ``` [SDK archive]: {{site.url}}/release/archive diff --git a/src/_includes/docs/install/flutter/vscode.md b/src/_includes/docs/install/flutter/vscode.md index ba542afcfdf..b7baf38bd95 100644 --- a/src/_includes/docs/install/flutter/vscode.md +++ b/src/_includes/docs/install/flutter/vscode.md @@ -4,6 +4,8 @@ #### Start Flutter install {:.no_toc} +1. Open VS Code. + 1. To open the Command Palette, press Control + Shift + P. @@ -13,6 +15,7 @@ 1. VS Code prompts you to locate the Flutter SDK on your computer. + {:type="a"} 1. If you have the Flutter SDK installed, click **Locate SDK**. 1. If you do not have the Flutter SDK installed, click **Download SDK**. @@ -20,6 +23,10 @@ This option sends you the Flutter install page if you have not installed Git for Windows as directed in the [development tools prerequisites][]. +1. When prompted **Which Flutter template?**, ignore it. + Press Esc. + You can create a test project after checking your development setup. + #### Download the Flutter SDK {:.no_toc} @@ -29,6 +36,10 @@ VS Code places you in your user profile to start. Choose a different location. + Consider `%USERPROFILE%` or `D:\dev`. + + {% include docs/install/admonitions/install-paths.md %} + 1. Click **Clone Flutter**. While downloading Flutter, a notification displays: @@ -37,6 +48,10 @@ Downloading the Flutter SDK. This may take a few minutes. ``` + This download takes a few minutes. + If you suspect that the download has hung, click **Cancel** then + start the installation again. + 1. Once it finishes downloading Flutter, the **Output** panel displays. ```terminal @@ -67,7 +82,9 @@ Downloading windows-x64/font-subset tools... ``` - This process also runs `flutter doctor -v`. _Ignore this output._ + This process also runs `flutter doctor -v`. + At this point in the procedure, _ignore this output._ + Flutter Doctor might show errors that don't apply to this quick start. When the Flutter install succeeds, a notification displays: @@ -88,4 +105,10 @@ If you agree, click **OK**. +1. To enable `flutter` in all terminal windows: + + {:type="a"} + 1. Close, then reopen all Powershell windows. + 1. Restart VS Code. + [development tools prerequisites]: #development-tools diff --git a/src/_includes/docs/install/reqs/windows/base.md b/src/_includes/docs/install/reqs/windows/base.md index 5a71c9c318e..995f9c80da2 100644 --- a/src/_includes/docs/install/reqs/windows/base.md +++ b/src/_includes/docs/install/reqs/windows/base.md @@ -36,14 +36,15 @@ These versions of Windows should include the required Download and install the Windows version of the following packages: - [Git for Windows][] {{site.appmin.github_win}} or later to manage source code. -- [Visual Studio Code][] {{site.appmin.vscode}} or later - and the [Flutter extension][] to edit and debug Flutter code. +- [Visual Studio Code][] {{site.appmin.vscode}} or later to write code. {% include docs/install/reqs/windows/software.md target=include.target %} -Flutter doesn't support any of these packages. +The developers of the preceding software provide support for those products. To troubleshoot installation issues, consult that product's documentation. +Install the [Flutter extension for VS Code][] to edit and debug Flutter code. + [Visual Studio Code]: https://code.visualstudio.com/docs/setup/windows -[Flutter extension]: https://marketplace.visualstudio.com/items?itemName=Dart-Code.flutter +[Flutter extension for VS Code]: https://marketplace.visualstudio.com/items?itemName=Dart-Code.flutter [Windows PowerShell]: https://docs.microsoft.com/powershell/scripting/install/installing-windows-powershell [Git for Windows]: https://gitforwindows.org/