diff --git a/en/manual/get-started/media/installing-vs-build-tools-dark.webp b/en/manual/get-started/media/installing-vs-build-tools-dark.webp new file mode 100644 index 000000000..626e614e6 --- /dev/null +++ b/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 diff --git a/en/manual/get-started/media/installing-vs-build-tools.webp b/en/manual/get-started/media/installing-vs-build-tools.webp new file mode 100644 index 000000000..72110d29c --- /dev/null +++ b/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 diff --git a/en/manual/troubleshooting/media/programs-and-features-redistributable.png b/en/manual/troubleshooting/media/programs-and-features-redistributable.png deleted file mode 100644 index bad6da602..000000000 --- a/en/manual/troubleshooting/media/programs-and-features-redistributable.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:6a1f4d4843701e1bdf9a89c02161784fbd76bdd288cd1c54e5074db3d41c5d3e -size 44973 diff --git a/en/manual/troubleshooting/media/programs-and-features-redistributable.webp b/en/manual/troubleshooting/media/programs-and-features-redistributable.webp new file mode 100644 index 000000000..1bcbf3a35 --- /dev/null +++ b/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 diff --git a/en/manual/troubleshooting/media/programs-and-features.png b/en/manual/troubleshooting/media/programs-and-features.png deleted file mode 100644 index 0624052db..000000000 --- a/en/manual/troubleshooting/media/programs-and-features.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:adc6ef8e3b147b4865f4e14e0ebaa51ced79e266a7e3f09d00c0e06863cd9965 -size 64018 diff --git a/en/manual/troubleshooting/stride-doesnt-run.md b/en/manual/troubleshooting/stride-doesnt-run.md index b274ebded..dfb20a46b 100644 --- a/en/manual/troubleshooting/stride-doesnt-run.md +++ b/en/manual/troubleshooting/stride-doesnt-run.md @@ -4,54 +4,58 @@ 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 8 SDK +* Visual C++ Redistributable 2019 (or later) +* .NET Framework 4.7.2 (required for the Visual Studio plugin) +* 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 SDK 8.0 -To check if this is installed, see **Control Panel > Programs > Programs and Features** and look for an entry containing **.NET 4.7.2**. +.NET SDK 8.0 should have been installed by Stride prerequisite installer, if Visual Studio 2022 didn't do it previously. -![Programs and features](media/programs-and-features.png) +If for some reason you need to install it manually, you can use [this link](https://dotnet.microsoft.com/en-us/download/dotnet/8.0) and select the latest .NET 8 SDK for Windows. -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). - -> [!Note] -> If you install Visual Studio, make sure you also install the .Net Framework support. Just the Visual Studio base 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. +### .NET Framework 4.7.2 (or later) -### Visual Studio (only for .NET Framework version) +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). -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 it's not installed, you can download it from the [Microsoft Download Center](https://dotnet.microsoft.com/en-us/download/dotnet-framework). -On top of that, if you still have Visual Studio 2017 installed, it should be version 15.9+. +> [!Note] +> If you have .NET 4.8 installed, you don't need to install .NET 4.7.2. Each 4.x version is cumulative. -### Build Tools for Visual Studio (only for .NET Framework version) +### Visual Studio 2022 (optional) -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**). +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] -> 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) +> Earlier versions might work with older version of Stride. However, for Stride 4.2 and later you need to have .NET 8 support. -### .NET SDK 5.0 (only for .NET version) +### Build Tools for Visual Studio 2022 (optional) -.NET SDK 5.0 should have been installed by Stride prerequisite installer, if Visual Studio 2019 didn't do it previously. +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 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). +You need to have the following workloads and/or components installed: +* **.NET desktop build tools** with **.NET SDK** optional component enabled. + +> [!Note] +> 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) ## See also -* [Install Stride](../get-started/install-stride.md) \ No newline at end of file +* [Install Stride](../get-started/install-stride.md)