Skip to content
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

Merged
merged 3 commits into from
Sep 7, 2022

Conversation

Gustl22
Copy link
Contributor

@Gustl22 Gustl22 commented Aug 31, 2022

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

@khanhnwin
Copy link
Contributor

Thanks @Gustl22! PTAL @cbracken

@@ -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,
Copy link
Member

@cbracken cbracken Sep 1, 2022

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.

Copy link
Contributor Author

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.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@cbracken any opinions? Thx :)

Copy link
Member

@cbracken cbracken left a 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.

Copy link
Contributor

@domesticmouse domesticmouse left a 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

@khanhnwin
Copy link
Contributor

This looks ready to land! Thanks @Gustl22 @cbracken!

@khanhnwin khanhnwin merged commit e167fbf into flutter:main Sep 7, 2022
@Gustl22 Gustl22 deleted the windows-vs-build-tools branch September 7, 2022 22:15
@YouJiacheng
Copy link

YouJiacheng commented Dec 9, 2022

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 can't find Build Tools version or download Build Tools only I need to find https://visualstudio.microsoft.com/zh-hans/downloads/#build-tools-for-visual-studio-2022. (It seems that M$ redirection doesn't preserve hash, fortunately I can change the language setting to English to avoid this redirection since the language setting will be preserved by cookies.) This might also apply to other regions where the default language setting is not English(e.g. fr and de) and developers who set the language setting to fr/de/zh-hans etc.

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.
I found this link in https://learn.microsoft.com/en-us/visualstudio/install/create-an-offline-installation-of-visual-studio?view=vs-2022 and https://learn.microsoft.com/en-us/visualstudio/releases/2022/release-history#release-dates-and-build-numbers.

Also, a winget alternative can be helpful:

winget install --id=Microsoft.VisualStudio.2022.BuildTools  -e

atsansone added a commit that referenced this pull request Feb 21, 2024
_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>
atsansone added a commit to atsansone/website that referenced this pull request Apr 5, 2024
_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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants