Skip to content

Commit

Permalink
Add vsconfig file as a possible component selection option
Browse files Browse the repository at this point in the history
  • Loading branch information
budak7273 committed Jul 6, 2023
1 parent 3df8320 commit eb2e979
Show file tree
Hide file tree
Showing 2 changed files with 92 additions and 18 deletions.
59 changes: 59 additions & 0 deletions modules/ROOT/attachments/BeginnersGuide/dependencies/SML.vsconfig
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
{
"version": "1.0",
"components": [
"Microsoft.VisualStudio.Component.CoreEditor",
"Microsoft.VisualStudio.Workload.CoreEditor",
"Microsoft.Net.Component.4.8.SDK",
"Microsoft.Net.Component.4.7.2.TargetingPack",
"Microsoft.Net.ComponentGroup.DevelopmentPrerequisites",
"Microsoft.VisualStudio.Component.TypeScript.TSServer",
"Microsoft.VisualStudio.ComponentGroup.WebToolsExtensions",
"Microsoft.VisualStudio.Component.JavaScript.TypeScript",
"Microsoft.VisualStudio.Component.Roslyn.Compiler",
"Microsoft.Component.MSBuild",
"Microsoft.VisualStudio.Component.Roslyn.LanguageServices",
"Microsoft.VisualStudio.Component.TextTemplating",
"Microsoft.VisualStudio.Component.NuGet",
"Microsoft.VisualStudio.Component.SQL.CLR",
"Microsoft.Component.ClickOnce",
"Microsoft.VisualStudio.Component.ManagedDesktop.Core",
"Microsoft.NetCore.Component.Runtime.6.0",
"Microsoft.NetCore.Component.Runtime.7.0",
"Microsoft.NetCore.Component.SDK",
"Microsoft.VisualStudio.Component.FSharp",
"Microsoft.ComponentGroup.ClickOnce.Publish",
"Microsoft.NetCore.Component.DevelopmentTools",
"Microsoft.Net.Component.4.8.TargetingPack",
"Microsoft.Net.ComponentGroup.4.8.DeveloperTools",
"Microsoft.VisualStudio.Component.DiagnosticTools",
"Microsoft.VisualStudio.Component.EntityFramework",
"Microsoft.VisualStudio.Component.Debugger.JustInTime",
"Component.Microsoft.VisualStudio.LiveShare.2022",
"Microsoft.VisualStudio.Component.IntelliCode",
"Microsoft.VisualStudio.Component.VC.CoreIde",
"Microsoft.VisualStudio.Component.Windows10SDK",
"Microsoft.VisualStudio.Component.VC.Tools.x86.x64",
"Microsoft.VisualStudio.Component.Graphics.Tools",
"Microsoft.VisualStudio.Component.VC.DiagnosticTools",
"Microsoft.VisualStudio.Component.Windows11SDK.22000",
"Microsoft.VisualStudio.Component.ManagedDesktop.Prerequisites",
"Microsoft.VisualStudio.Component.DotNetModelBuilder",
"Microsoft.ComponentGroup.Blend",
"Microsoft.VisualStudio.Workload.ManagedDesktop",
"Microsoft.VisualStudio.Component.VC.ATL",
"Microsoft.VisualStudio.Component.SecurityIssueAnalysis",
"Microsoft.VisualStudio.Component.VC.Redist.14.Latest",
"Microsoft.VisualStudio.ComponentGroup.NativeDesktop.Core",
"Microsoft.VisualStudio.ComponentGroup.WebToolsExtensions.CMake",
"Microsoft.VisualStudio.Component.VC.CMake.Project",
"Microsoft.VisualStudio.Component.VC.TestAdapterForBoostTest",
"Microsoft.VisualStudio.Component.VC.TestAdapterForGoogleTest",
"Microsoft.VisualStudio.Component.VC.ASAN",
"Microsoft.VisualStudio.Component.Vcpkg",
"Microsoft.VisualStudio.Workload.NativeDesktop",
"Microsoft.VisualStudio.Component.HLSL",
"Component.Unreal.Ide",
"Microsoft.VisualStudio.Workload.NativeGame",
"Microsoft.VisualStudio.Component.VC.14.34.17.4.x86.x64"
]
}
51 changes: 33 additions & 18 deletions modules/ROOT/pages/Development/BeginnersGuide/dependencies.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -40,12 +40,32 @@ Launch the game at least once to ensure all files get set up correctly.
== Visual Studio

Visit the https://visualstudio.microsoft.com/downloads/[Microsoft Visual Studio downloads page]
and download the version you want.
We suggest Visual Studio 2022 Community,
because it is free of charge and modern.
It may force you to sign up to access the older versions, but they are free.
and select the button for Visual Studio 2022 Community, which is free of charge.

If you already have Visual Studio installed,
you can run the installer again and still follow the steps below to modify your existing installation.

After the installer has downloaded, run it and agree to any authorization prompts you receive along the way.
Once you are prompted to install Visual Studio 2022
you have two options for selecting the relevant components.

[id="ImportConfiguration"]
=== Option 1: Import an Installer Configuration

If the installer took you directly to the component selection screen
you'll have to use the smaller X button in the top right to close out of that prompt first.

Instead of clicking "Install" next to Visual Studio 2022,
click the 'More' dropdown and select `Import Configuration`.

// cspell:ignore vsconfig
Download link:{attachmentsdir}/BeginnersGuide/dependencies/SML.vsconfig[this configuration file]
and select it in the installer's prompt.
Next, press `Review details` and continue with the installation.

[id="ManuallySelectComponents"]
=== Option 2: Manually Select Components

Run the installer, and agree to prompts you receive along the way.
From the "Workloads" tab select
"Desktop & Mobile > Desktop development with {cpp}"
and "Gaming > Game development with {cpp}".
Expand All @@ -54,21 +74,16 @@ You might have to scroll a bit to find them.
Next, from the "Individual Components" tab,
search for and select `MSVC v143 - VS2022 C++ x64/x86 build tools (v14.34-17.4)`

If you already have Visual Studio installed,
you can run the installer again
and choose `Modify` to select these two workloads to add them to your installation.
You will also need the .NET Framework SDK version 4.8 or higher (but not Core/v5).
If you do not know if you have the .NET Framework SDK,
the VS installer should provide an option to install it.
It is recommended to tick it.

Continue through the rest of the prompts to install Visual Studio.
Downloading and installing Visual Studio can take a while,
so we advise you to find some lizard doggos to pet while you wait,
or working on some of the other install steps below.
=== While Visual Studio Installs

[WARNING]
====
You will also need the .NET Framework SDK, version 4.6 or higher (but not Core/v5).
If you do not know if you have the .NET Framework SDK,
the VS installer should provide an option to install it. It is recommended to tick it.
====
Downloading and installing Visual Studio can take a while.
We advise you to find some lizard doggos to pet while you wait,
or work on some of the other install steps below.

[TIP]
====
Expand Down

0 comments on commit eb2e979

Please sign in to comment.