Difference between revisions of "How to build from source"

From OdaWiki
(FreeBSD)
(Compiling Odamex)
Line 15: Line 15:
 
You have all the pieces of the puzzle...now it's time to build.
 
You have all the pieces of the puzzle...now it's time to build.
  
Depending on what operating system and hardware you are running, you have many options of compilers.  Some of the more popular choices are below:
+
==Code::Blocks IDE==
 
+
Most Odamex developers use Code::Blocks, so there is a specific project file just for that editor.
==Windows==
+
===Code::Blocks IDE and MinGW===
+
This is the prefered method of compiling Odamex on Windows.  Code::Blocks project and workspace files are included in the [[Subversion]].
+
 
* See [[Compiling using Code::Blocks]]
 
* See [[Compiling using Code::Blocks]]
  
===MinGW and MSYS===
+
==CMake==
This method of compiling utilizes the command line to compile Odamex.  This is useful if you prefer not to use an IDE.
+
In most other cases we use CMake to create project files or Makefiles that are tailored to each system.
* See [[Compiling using MSYS]]
+
 
+
===Microsoft Visual Studio===
+
Odamex currently supports compiling under Microsoft Visual C++ 6.0, and a Visual C++ 6.0 project file is included in [[Subversion]].  Support for later versions of Visual Studio is unconfirmed.
+
* See [[Compiling using Microsoft Visual Studio]]
+
 
+
===Cygwin and GCC===
+
Support for native Cygwin binaries is not supported at this time, though is both feasable and desirable in the future.  You can, however, compile Odamex without Cygwin support under Cygwin, with minor adjustments, though this is not considered "Cygwin GCC".
+
* See [[Compiling using GCC]]
+
 
+
===CMake===
+
An experimental CMake build system is available via the bugtracker.  As of right now, it is known to create working Microsoft Visual Studio 2010 project files.
+
 
* See [[Compiling using CMake]]
 
* See [[Compiling using CMake]]
  
=== Installer ===
+
==Outdated==
* See [[NSIS]]
+
The following build methods no longer exist as of 0.6.1However, if you are building 0.6.0 or earlier, you might be interested in the information below.
 
+
==Linux==
+
===GCC===
+
This is the prefered method of compiling Odamex in Linux. Makefiles are included in the [[Subversion]].
+
* See [[Compiling using GCC]]
+
 
+
=== Debian/Ubuntu Package ===
+
* See [[Debian package]]
+
 
+
===CMake===
+
An experimental CMake build system is available via the bugtrackerIt uses the same GCC and make that you would use with the standard makefile, however it offers additional support for alternate SDL installations and out-of-source build trees.
+
* See [[Compiling using CMake]]
+
 
+
==FreeBSD==
+
===GCC===
+
This is the prefered method of compiling Odamex in FreeBSD. Makefiles are included in [[Subversion]], and should work with the FreeBSD version of GNU Make (gmake) and GCC.
+
* See [[Compiling using GCC]]
+
 
+
===CMake===
+
An experimental CMake build system is available via the bugtracker.  It uses the same GCC as the standard makefile, however it generates makefiles that are compatible with BSD make and offers additional support for alternate SDL installations and out-of-source build trees.
+
* See [[Compiling using CMake]]
+
  
==OSX==
+
* [[Compiling using GCC]]
===Xcode===
+
* [[Debian package]]
* See [[Compiling using Xcode]]
+
* [[Compiling using Xcode]]
  
 
=Cross compiling=
 
=Cross compiling=

Revision as of 16:41, 14 July 2012

Odamex is open source. This means that it is possible to obtain and compile Odamex from source if you so desire. The Odamex team wishes to make this process as painless as possible, therefore detailed instructions for how to build Odamex are provided in this section.

Getting the source

There are two ways to obtain the source to Odamex:

  • Download the latest stable version from the official Odamex website
  • Get the absolute latest modifications through anonymous Subversion access

Getting required files

When you download Odamex, it's almost ready to go, right out of the box. However, you need something to compile it with. In addition, Odamex relies on extra libraries in order to function.

Compiling Odamex

You have all the pieces of the puzzle...now it's time to build.

Code::Blocks IDE

Most Odamex developers use Code::Blocks, so there is a specific project file just for that editor.

CMake

In most other cases we use CMake to create project files or Makefiles that are tailored to each system.

Outdated

The following build methods no longer exist as of 0.6.1. However, if you are building 0.6.0 or earlier, you might be interested in the information below.

Cross compiling

You can build the windows version of odamex on linux:

Compiling the Launcher

So you want to mess around with the Launcher? Here's how to do it.

Note: Versions of FreeBSD (7+) require a change in the launcher Makefile:

  • WXCONFIG = wxgtk2-*.*-config
  • WXRC = wxrc-gtk2-*.*

The *'s indicate the version of wxWidgets you are running

Building odamex.wad

This will show you how to build the latest odamex.wad file

Note: odamex.wad gets built automatically when using the Makefile