From eb2e979d686b28ed20670b9148498181d7dc361e Mon Sep 17 00:00:00 2001 From: Rob B Date: Thu, 6 Jul 2023 04:10:18 -0500 Subject: [PATCH] Add vsconfig file as a possible component selection option --- .../BeginnersGuide/dependencies/SML.vsconfig | 59 +++++++++++++++++++ .../BeginnersGuide/dependencies.adoc | 51 ++++++++++------ 2 files changed, 92 insertions(+), 18 deletions(-) create mode 100644 modules/ROOT/attachments/BeginnersGuide/dependencies/SML.vsconfig diff --git a/modules/ROOT/attachments/BeginnersGuide/dependencies/SML.vsconfig b/modules/ROOT/attachments/BeginnersGuide/dependencies/SML.vsconfig new file mode 100644 index 00000000..518fd1f4 --- /dev/null +++ b/modules/ROOT/attachments/BeginnersGuide/dependencies/SML.vsconfig @@ -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" + ] +} \ No newline at end of file diff --git a/modules/ROOT/pages/Development/BeginnersGuide/dependencies.adoc b/modules/ROOT/pages/Development/BeginnersGuide/dependencies.adoc index 9665501b..13e46e5c 100644 --- a/modules/ROOT/pages/Development/BeginnersGuide/dependencies.adoc +++ b/modules/ROOT/pages/Development/BeginnersGuide/dependencies.adoc @@ -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}". @@ -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] ====