Building the source to Stride engine | Stride contributors (original) (raw)

Prerequisites

  1. Latest Git with Large File Support selected during setup. For convenience, you might also use a Git UI client like GitExtensions.
  2. .NET 8.0 SDK
    • Run dotnet --info in a console or PowerShell window to see which versions you have installed.
  3. Visual Studio 2022 (the Community edition is free) with the following workloads:
    • .NET desktop development with .NET Framework 4.7.2 targeting pack (should be enabled by default)
    • Desktop development with C++ with:
      * Windows 11 SDK (10.0.22621.0) or a later version (should be enabled by default)
      * MSVC v143 - VS2022 C++ x64/x86 build tools (Latest) (should be enabled by default)
      * C++/CLI support for v143 build tools (Latest) (not enabled by default)
    • Optional (to target iOS/Android): .NET Multi-platform App UI development and the Android SDK setup individual component (enabled by default). Then, in Visual Studio, go to Tools > Android > Android SDK Manager and install NDK (version 20.1+) from the Tools tab.
    • Optional (to build the VSIX package): Visual Studio extension development
Note

The installation of Visual Studio with the required components may require up to 14 GB of disk space, depending on your system and selected components.

Warning

If this is your first time installing the .NET SDK, you might need to restart your system after the installation so that the system can recognize the new environment variables.

Build Stride with Visual Studio 2022

Here are the steps to build Stride with Visual Studio. If you do not have or want to use Visual Studio, see building with other IDEs

  1. Clone the repository using a Git UI client or from the command line:
git lfs clone https://github.com/stride3d/stride.git  
  1. Open the solution:
    • Open <StrideDir>\build\Stride.sln with Visual Studio 2022.
    • Build the Stride.GameStudio project in the 60-Editor solution folder (it should be the default startup project) or run it directly from Visual Studio's toolbar.
    • Optionally, open and build Stride.Android.sln, Stride.iOS.sln, etc.
Warning

Do NOT use GitHub -> Code -> Download ZIP option, as this won't include the LFS files.

If building failed

Do note that test solutions might fail but it should not prevent you from building Stride.GameStudio.

Other IDEs

You are not required to use Visual Studio to build the Stride engine with Visual Studio. You can also build entirely from command line or other IDE's such as Rider or Visual Studio Code.