Browse Source

Update stride doesn't run troubleshooting page

Nicolas Musset 1 year ago
parent
commit
4a0a3bc63b

+ 3 - 0
en/manual/get-started/media/installing-vs-build-tools-dark.webp

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:cc300cf18585c12f7f50140ff372bdc56df8c75bc012958c2e040d7394700304
+size 23178

+ 3 - 0
en/manual/get-started/media/installing-vs-build-tools.webp

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:3c3c3a671b6908146848f4168695c4ac5a9c5f5c3beb46141706c5feb527c0c3
+size 23432

+ 0 - 3
en/manual/troubleshooting/media/programs-and-features-redistributable.png

@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:6a1f4d4843701e1bdf9a89c02161784fbd76bdd288cd1c54e5074db3d41c5d3e
-size 44973

+ 3 - 0
en/manual/troubleshooting/media/programs-and-features-redistributable.webp

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:7a137d2ca99b17254d2fa3ed1d7dd2c0152455fee00a7a9c97084f54d0d722ee
+size 27464

+ 0 - 3
en/manual/troubleshooting/media/programs-and-features.png

@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:adc6ef8e3b147b4865f4e14e0ebaa51ced79e266a7e3f09d00c0e06863cd9965
-size 64018

+ 30 - 24
en/manual/troubleshooting/stride-doesnt-run.md

@@ -4,53 +4,59 @@
 
 If you're having trouble running Stride, make sure you've installed all the prerequisites:
 
-* .NET Framework 4.7.2
-* Visual C++ Redistributable 2019
-* Build Tools for Visual Studio
+* .NET Framework 4.7.2 (required for the Visual Studio plugin)
+* Visual C++ Redistributable 2019 (or later)
+* Visual Studio or Build Tools (optional but recommended)
 
 Alternatively, uninstall Stride, restart the Stride installer, and install the prerequisites when prompted.
 
-### .NET Framework 4.7.2
+### .NET Framework 4.7.2 (or later)
 
-To check if this is installed, see **Control Panel > Programs > Programs and Features** and look for an entry containing **.NET 4.7.2**.
+To check if this is installed, follow the instructions on [this page](https://learn.microsoft.com/en-us/dotnet/framework/migration-guide/how-to-determine-which-versions-are-installed).
 
-![Programs and features](media/programs-and-features.png)
-
-If it's not installed, you can download it from the [Microsoft Download Center](https://dotnet.microsoft.com/download/dotnet-framework/thank-you/net472-web-installer).
+If it's not installed, you can download it from the [Microsoft Download Center](https://dotnet.microsoft.com/en-us/download/dotnet-framework).
 
 > [!Note]
-> If you install Visual Studio, make sure you also install the .Net Framework support. Just the Visual Studio base installation isn't enough.
+> If you have .NET 4.8 installed, you don't need to install .NET 4.7.2. Each 4.x version is cumulative.
+>
+> If you install Visual Studio, make sure you also select the **.Net Desktop development** workload. The base Visual Studio installation isn't enough.
 
-### Visual C++ Redistributable 2019
+### Visual C++ Redistributable 2019 (or later)
 
 To check if this is installed, see **Control Panel > Programs > Programs and Features** and look for **2015-2019 Redistributable**.
 
-![Programs and features](media/programs-and-features-redistributable.png)
+![Programs and features](media/programs-and-features-redistributable.webp)
+
+If it's not installed, you can download the Redistributable from [Visual Studio Downloads](https://www.visualstudio.com/downloads/) (under **Other Tools and Frameworks**). Make sure to install both **x86** and **x64** versions.
 
-If it's not installed, you can download the 2019 Redistributable from [Visual Studio Downloads](https://www.visualstudio.com/downloads/) (under **Other Tools and Frameworks**).
+> [!Note]
+> If you see **2015-2022 Redistributable** instead, it's ok. Since 2015, they are cumulative. Just make sure the last year is at least 2019.
 
 
-### Visual Studio (only for .NET Framework version)
+### Visual Studio 2022 (optional)
 
-If you have Visual Studio 2019 installed, you need to have the following workloads and/or components installed:
-* **.NET desktop development**
-* **.NET core cross-platform development**, with **.NET Core 2.1 Runtime (LTS)** optional component enabled.
+If you have Visual Studio 2022 (or later) installed, you need to have the following workloads and/or components installed:
+* **.NET desktop development** with **Development tools for .NET** optional component enabled.
+
+> [!Note]
+> Earlier versions might work with older version of Stride. However, for Stride 4.2 and later you need to have .NET 8 support.
 
-On top of that, if you still have Visual Studio 2017 installed, it should be version 15.9+.
+### Build Tools for Visual Studio 2022 (optional)
 
-### Build Tools for Visual Studio (only for .NET Framework version)
+If you **don't** have Visual Studio installed and don't want to install it, you can install **Build Tools for Visual Studio** instead. You can download this from [Visual Studio Downloads](https://www.visualstudio.com/downloads/) (under **Tools for Visual Studio**).
 
-If you **don't** have Visual Studio installed and don't want to install it, you need to install **Build Tools for Visual Studio**. You can download this from [Visual Studio Downloads](https://www.visualstudio.com/downloads/) (under **Other Tools and Frameworks**).
+You need to have the following workloads and/or components installed:
+* **.NET desktop build tools** with **.NET SDK** optional component enabled.
 
 > [!Note]
-> Windows uses the Visual Studio installer to install the Visual C++ Redistributable and Build Tools for Visual Studio prerequisites. If you don't need Visual Studio, don't worry – it doesn't install it.
->![Installing VS build tools](../get-started/media/installing-vs-build-tools.png)
+> If you don't need Visual Studio, don't worry – it doesn't install it.
+>![Installing VS build tools](../get-started/media/installing-vs-build-tools.webp)
 
-### .NET SDK 5.0 (only for .NET version)
+### .NET SDK 8.0
 
-.NET SDK 5.0 should have been installed by Stride prerequisite installer, if Visual Studio 2019 didn't do it previously.
+.NET SDK 8.0 should have been installed by Stride prerequisite installer, if Visual Studio 2022 didn't do it previously.
 
-If for some reason you need to install it manually, you can use [this link](https://dotnet.microsoft.com/download/dotnet-core/thank-you/sdk-5.0.101-windows-x64-installer).
+If for some reason you need to install it manually, you can use [this link](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-8.0.101-windows-x64-installer).
 
 ## See also