-
Notifications
You must be signed in to change notification settings - Fork 3.2k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
docs: Propose Windows Visual Studio Build Tools #7484
Conversation
@@ -57,7 +57,8 @@ you need the following software: | |||
For Windows desktop development, | |||
you need the following in addition to the Flutter SDK: | |||
|
|||
* [Visual Studio 2022][] When installing Visual Studio, | |||
* [Visual Studio 2022][] or [Visual Studio Build Tools 2022][] | |||
When installing Visual Studio or only the Build Tools, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Here and below: Since most users will be more comfortable with a graphical IDE to go with their install, and because it's analogous to what we recommend for macOS (a full Xcode install), I'd phrase this something like:
* [Visual Studio 2022][] When installing Visual Studio,
select the "Desktop development with C++" workload,
including all of its default components,
to install the necessary C++ toolchain and
Windows SDK header files. Alternatively,
[Visual Studio Build Tools 2022][] can be installed if
only the Windows command-line tools are desired.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This sounds like you don't need to install the C++ workload with Build tools in order to be able to develop in windows.
My proposal:
Alternatively, [Visual Studio Build Tools 2022][]
can be installed with the same workload if
only the Windows command-line tools are desired.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@cbracken any opinions? Thx :)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for the patch! Overall looks good - just a wording suggesting.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM once @cbracken's change is merged
UPDATE: https://visualstudio.microsoft.com/visual-cpp-build-tools/ should be the best link. It is not bothered by multi-language redirection, and is the home page for VSBT. For developers in China, https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022 will be redirected to https://visualstudio.microsoft.com/zh-hans/downloads/, in which I think https://aka.ms/vs/17/release/vs_buildtools.exe should be included in docs as well, with which I can download an evergreen (online) bootstrapper in one click. Also, a winget install --id=Microsoft.VisualStudio.2022.BuildTools -e |
_Description of what this PR is changing or adding, and why:_ Re-add the Build Tools for Visual Studio 2022 option. This is a significantly smaller download than a full Visual Studio installation. This was originally added by #7484 but was removed by #9238. _Issues fixed by this PR (if any):_ ## Presubmit checklist - [x] This PR doesn’t contain automatically generated corrections (Grammarly or similar). - [x] This PR follows the [Google Developer Documentation Style Guidelines](https://developers.google.com/style) — for example, it doesn’t use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first person). - [x] This PR uses [semantic line breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks) of 80 characters or fewer. --------- Co-authored-by: Anthony Sansone <atsansone@users.noreply.github.com>
_Description of what this PR is changing or adding, and why:_ Re-add the Build Tools for Visual Studio 2022 option. This is a significantly smaller download than a full Visual Studio installation. This was originally added by flutter#7484 but was removed by flutter#9238. _Issues fixed by this PR (if any):_ ## Presubmit checklist - [x] This PR doesn’t contain automatically generated corrections (Grammarly or similar). - [x] This PR follows the [Google Developer Documentation Style Guidelines](https://developers.google.com/style) — for example, it doesn’t use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first person). - [x] This PR uses [semantic line breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks) of 80 characters or fewer. --------- Co-authored-by: Anthony Sansone <atsansone@users.noreply.github.com>
Description of what this PR is changing or adding, and why:
Add alternative to VS without Editor, to only install Build tools.
Issues fixed by this PR (if any):
flutter/flutter#77638 (comment)
Presubmit checklist