From 4a0a3bc63bdb93ac21dd918dc46a38323e35a89c Mon Sep 17 00:00:00 2001 From: Nicolas Musset Date: Mon, 12 Feb 2024 12:31:37 +0100 Subject: [PATCH 1/3] Update stride doesn't run troubleshooting page --- .../media/installing-vs-build-tools-dark.webp | 3 ++ .../media/installing-vs-build-tools.webp | 3 ++ .../programs-and-features-redistributable.png | 3 -- ...programs-and-features-redistributable.webp | 3 ++ .../media/programs-and-features.png | 3 -- .../troubleshooting/stride-doesnt-run.md | 54 ++++++++++--------- 6 files changed, 39 insertions(+), 30 deletions(-) create mode 100644 en/manual/get-started/media/installing-vs-build-tools-dark.webp create mode 100644 en/manual/get-started/media/installing-vs-build-tools.webp delete mode 100644 en/manual/troubleshooting/media/programs-and-features-redistributable.png create mode 100644 en/manual/troubleshooting/media/programs-and-features-redistributable.webp delete mode 100644 en/manual/troubleshooting/media/programs-and-features.png 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..ae6e26d88 100644 --- a/en/manual/troubleshooting/stride-doesnt-run.md +++ b/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 From d75e6819bff3c9dcf107d0a452e5411e2f73a53b Mon Sep 17 00:00:00 2001 From: Nicolas Musset Date: Mon, 12 Feb 2024 12:35:41 +0100 Subject: [PATCH 2/3] Change section order --- .../troubleshooting/stride-doesnt-run.md | 28 +++++++++---------- 1 file changed, 13 insertions(+), 15 deletions(-) diff --git a/en/manual/troubleshooting/stride-doesnt-run.md b/en/manual/troubleshooting/stride-doesnt-run.md index ae6e26d88..ff891696a 100644 --- a/en/manual/troubleshooting/stride-doesnt-run.md +++ b/en/manual/troubleshooting/stride-doesnt-run.md @@ -4,22 +4,18 @@ If you're having trouble running Stride, make sure you've installed all the prerequisites: -* .NET Framework 4.7.2 (required for the Visual Studio plugin) +* .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 (or later) - -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). +### .NET SDK 8.0 -If it's not installed, you can download it from the [Microsoft Download Center](https://dotnet.microsoft.com/en-us/download/dotnet-framework). +.NET SDK 8.0 should have been installed by Stride prerequisite installer, if Visual Studio 2022 didn't do it previously. -> [!Note] -> 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. +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). ### Visual C++ Redistributable 2019 (or later) @@ -32,6 +28,14 @@ If it's not installed, you can download the Redistributable from [Visual Studio > [!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) + +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 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 have .NET 4.8 installed, you don't need to install .NET 4.7.2. Each 4.x version is cumulative. ### Visual Studio 2022 (optional) @@ -52,12 +56,6 @@ You need to have the following workloads and/or components installed: > 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 8.0 - -.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/en-us/download/dotnet/thank-you/sdk-8.0.101-windows-x64-installer). - ## See also * [Install Stride](../get-started/install-stride.md) \ No newline at end of file From 58ded23e9ee6a43e339cbc3313eafd747c7e7b6d Mon Sep 17 00:00:00 2001 From: Nicolas Musset Date: Mon, 12 Feb 2024 13:29:29 +0100 Subject: [PATCH 3/3] Update link for downloading the SDK --- en/manual/troubleshooting/stride-doesnt-run.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/en/manual/troubleshooting/stride-doesnt-run.md b/en/manual/troubleshooting/stride-doesnt-run.md index ff891696a..dfb20a46b 100644 --- a/en/manual/troubleshooting/stride-doesnt-run.md +++ b/en/manual/troubleshooting/stride-doesnt-run.md @@ -15,7 +15,7 @@ Alternatively, uninstall Stride, restart the Stride installer, and install the p .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/en-us/download/dotnet/thank-you/sdk-8.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/8.0) and select the latest .NET 8 SDK for Windows. ### Visual C++ Redistributable 2019 (or later) @@ -58,4 +58,4 @@ You need to have the following workloads and/or components installed: ## See also -* [Install Stride](../get-started/install-stride.md) \ No newline at end of file +* [Install Stride](../get-started/install-stride.md)