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:
 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.
 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]
 > [!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**.
 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]
 > [!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
 ## See also