DarkRadiant - Compilation Guide: Difference between revisions

From The DarkMod Wiki
Jump to navigationJump to search
No edit summary
 
(112 intermediate revisions by 4 users not shown)
Line 1: Line 1:
= Compiling under Windows =
DarkRadiant's codebase is open source, the main part of the source code is hosted on github. To compile the sources you can either use
This should hopefully cover the steps to prepare your machine to be able to compile the DarkRadiant Editor from source.


== Needed Software ==
* Windows: ''Visual Studio 2022 Community Edition'' (higher editions also possible: Professional, Ultimate, ...)
You'll need to download these pieces of software (these are all free, you don't need to pay for anything):
* Linux: gcc/g++ (Automake)
* [http://tortoisesvn.tigris.org '''TortoiseSVN'''] for obtaining the sources
* Mac OS X: Automake (after installing XCode and using MacPorts)
* [http://www.mingw.org/download.shtml '''MinGW'''] the actual compiler
* [http://www.activestate.com/store/activepython/download '''ActivePython'''] to run scons
* [http://www.scons.org/download.php '''scons'''] to run the compilation scripts
* [http://gimp-win.sourceforge.net/stable.html '''The GTK+ Framework'''] (choose the latest stable version)
== Step 1: Install the Tools ==
First, download and install '''TortoiseSVN'''. Nothing special here, just install it into any folder of your preference. After installation it probably will ask to reboot your machine, as Tortoise integrates into the Explorer shell. (You can do that later, when all the other components have been installed).


Second, install the compiler '''MinGW'''. Launch the setup and choose the package '''Current''', then be sure to check the box of the '''g++''' compiler. Choose '''Download and Install''' in the next steps and let setup do the rest.
All compilers can be acquired for free. In any case, since DarkRadiant is using part of the C++17 feature set, a compiler supporting the C++17 standard is required.


Third, install the '''ActivePython''' interpreter, which is needed to run the SconScript. Nothing spectacular here as well. After Python has been installed, run the '''scons''' installer (version 0.96.1 works for sure, don't know about others).
= Compilation Guides =
There are separate articles for Windows and Linux, select one to learn more:


Lastly, install '''GTK+''' and reboot the machine.
* [[DarkRadiant - Compiling in Windows|Compiling in Windows / Visual Studio]]
* [[DarkRadiant - Compiling in Linux|Compiling in Linux]]
* [[DarkRadiant - Compiling in macOS|Compiling in macOS]] (experimental)


== Step 2: Obtain the Sources ==
Note: The articles are always referring to the latest revision of the source code, not to a specific release.
The complete codebase is available at SourceForge. To check out the sources, open up Explorer and create the folder you want to store them.  


Right-click somewhere in the white space and choose '''SVN Checkout'''. A new dialog appears asing you for the repository URL and the checkout folder. You can copy and paste the URL from here into the dialog window:
{{coding}}
https://darkradiant.svn.sourceforge.net/svnroot/darkradiant/trunk/darkradiant/
{{darkradiant|sort=Compilation}}
Click OK and prepare for a few minutes of downloading, the trunk repository is some ten megs large.
 
[http://img256.imageshack.us/img256/6370/drcheckoutuj0.jpg http://img256.imageshack.us/img256/6370/drcheckoutuj0.th.jpg]
== Step 3: Compile the Sources ==
If you're finished downloading the sources, open up the console by pressing '''Win-R''' or click '''Start''' > '''Run...''', then type '''cmd''' and confirm.
Once the DOS box is there, head to the according source folder by typing
cd C:\DarkRadiant
or whatever your path is where you downloaded them. Now type:
scons BUILD="release"
and the sources should start to compile (in release mode).
 
It's likely that I forgot something here and you might get scons complaining about a missing compiler or something. In that case, please tell greebo to update this tutorial accordingly.
 
The time neede to compile DarkRadiant strongly depends on your CPU power and may take up to ten minutes for a release build (a debug build may take much longer for whatever reasons).
 
= Compiling under Linux =
Instructions go here (WIP)
 
[[Category:Coding]]
[[Category:DarkRadiant]]

Latest revision as of 19:34, 1 April 2022

DarkRadiant's codebase is open source, the main part of the source code is hosted on github. To compile the sources you can either use

  • Windows: Visual Studio 2022 Community Edition (higher editions also possible: Professional, Ultimate, ...)
  • Linux: gcc/g++ (Automake)
  • Mac OS X: Automake (after installing XCode and using MacPorts)

All compilers can be acquired for free. In any case, since DarkRadiant is using part of the C++17 feature set, a compiler supporting the C++17 standard is required.

Compilation Guides

There are separate articles for Windows and Linux, select one to learn more:

Note: The articles are always referring to the latest revision of the source code, not to a specific release.