index.rst 2.3 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071
  1. :allow_comments: False
  2. Building from source
  3. ====================
  4. .. highlight:: shell
  5. Godot prides itself on being very easy to build, by C++ projects' standards.
  6. :ref:`Godot uses the SCons build system <doc_faq_why_scons>`, and after the initial
  7. setup compiling the engine for your current platform should be as easy as running::
  8. scons
  9. But you will probably need to use at least some of the available options to configure
  10. the build to match your specific needs, be it a custom engine fork, a lightweight build
  11. stripped of extra modules, or an executable targeting engine development.
  12. The articles below should help you navigate configuration options available, as well as
  13. prerequisites required to compile Godot exactly the way you need.
  14. .. rubric:: Basics of building Godot
  15. :heading-level: 2
  16. Let's start with basics, and learn how to get Godot's source code, and then which options
  17. to use to compile it regardless of your target platform.
  18. .. toctree::
  19. :maxdepth: 1
  20. :name: toc-devel-compiling
  21. getting_source
  22. introduction_to_the_buildsystem
  23. .. rubric:: Building for target platforms
  24. :heading-level: 2
  25. Below you can find instructions for compiling the engine for your specific target platform.
  26. Note that Godot supports cross-compilation, which means you can compile it for a target platform
  27. that doesn't match your current platform (say, target Linux while being on Windows). The guides
  28. will try their best to cover all possible situations.
  29. .. toctree::
  30. :maxdepth: 1
  31. :name: toc-devel-compiling-platforms
  32. compiling_for_windows
  33. compiling_for_linuxbsd
  34. compiling_for_macos
  35. compiling_for_android
  36. compiling_for_ios
  37. cross-compiling_for_ios_on_linux
  38. compiling_for_web
  39. .. rubric:: Other compilation targets and options
  40. :heading-level: 2
  41. Some additional universal compilation options require further setup. Namely, while Godot
  42. does have C#/.NET support as a part of its main codebase, it does not get compiled by
  43. default to reduce the executable size for users who don't need C# for their projects.
  44. Articles below explain how to configure the buildsystem for cases like this, and also
  45. cover some optimization techniques.
  46. .. toctree::
  47. :maxdepth: 1
  48. :name: toc-devel-compiling-options
  49. compiling_with_dotnet
  50. compiling_with_script_encryption_key
  51. optimizing_for_size