stride3d / stride-docs

This repository hosts the source code for the Stride documentation. Contributors can follow the build instructions provided to run the website locally.
https://doc.stride3d.net/
MIT License
31 stars 65 forks source link

Guide on how to build and run the source of each Stride build solution #346

Open Doprez opened 1 month ago

Doprez commented 1 month ago

in the Stride contributors page we should add a section to show the steps needed to build each Stride solution file and why someone would need to use them to contribute.

Basic examples: Stride.sln Requirements:

Use cases:

Stride.Android.sln Requirements:

Use cases:

Stride.VisualStudio.sln Requirements:

Use cases:

The list goes on but these are just rough ideas of what we can add to help contributors get started. I think most of the contributors understand how the main Stride.sln works but not many understand the android, IOS, Visual Studio and other build solutions. Having these in a central place would help newer contributors easily get started and may be more motivated to even try and get started.

VaclavElias commented 1 month ago

This is good idea!

Doprez commented 1 month ago

from Feralnex in Discord:

Android build

  1. Go to C:\Users\USERNAME\.nuget\packages and delete all the stride folders (it might cause missing references etc. by how the nuget packages are cached) as @SolarChrome suggested a while ago

  2. Open and build Stride.sln by executing command: msbuild Stride.sln /t:Build /p:Configuration=Debug

If there're errors restore solution by executing: msbuild Stride.sln /t:Restore

and build solution again.

  1. Close Stride.sln -> open and build Android.sln by executing command: msbuild Stride.Android.sln /t:Build /p:Configuration=Debug

If there're errors restore solution by executing: msbuild Stride.Android.sln /t:Restore

and build solution again.

  1. Close solution and DON'T REBUILD OR TRY TO DEBUG Stride.sln (Stride.GameStudio.sln) it will force some .dlls to rebuild and might cause missing references when trying to build project for Android platform
  2. Open GameStudio.exe from the stride/sources/editor/Stride.GameStudio/bin... and You can try to debug it by debugging the process from the list through Visual Studio
  3. You should be able to build project for both Windows and Android platform