Skip to content

Commit

Permalink
Merge pull request #253 from stride3d/master
Browse files Browse the repository at this point in the history
Initiating deployment of latest docs updates to staging
  • Loading branch information
VaclavElias authored Feb 12, 2024
2 parents 8e978e2 + 2d1caca commit d5c05a3
Show file tree
Hide file tree
Showing 6 changed files with 40 additions and 33 deletions.
Git LFS file not shown
3 changes: 3 additions & 0 deletions en/manual/get-started/media/installing-vs-build-tools.webp
Git LFS file not shown

This file was deleted.

Git LFS file not shown
3 changes: 0 additions & 3 deletions en/manual/troubleshooting/media/programs-and-features.png

This file was deleted.

58 changes: 31 additions & 27 deletions en/manual/troubleshooting/stride-doesnt-run.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
* [Install Stride](../get-started/install-stride.md)

0 comments on commit d5c05a3

Please sign in to comment.