Difference between revisions of "Compiling using Code::Blocks"

From OdaWiki
(Step 2: Getting MinGW)
 
(18 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<b>Overview:</b>
 
---------
 
 
The ODAMEX Source package comes with a variety of project and workspace files.
 
The ODAMEX Source package comes with a variety of project and workspace files.
  
 
This tutorial will show you how to build ODAMEX using the Code::Blocks IDE.
 
This tutorial will show you how to build ODAMEX using the Code::Blocks IDE.
  
==Windows==
+
==Step 1: Getting Code::Blocks==
  
===Step 1: Getting Code::Blocks===
+
You can download Code::Blocks from its website here: [http://www.codeblocks.org/ Code::Blocks]. '''Be sure to get the latest release installer WITH MinGW'''
  
You can download Code::Blocks from its website here: [http://www.codeblocks.org/ Code::Blocks].  Be sure to get the '''latest nightly build'', and not Release Canadate 2 as this is the one that works with the current project files.
+
==Step 2: Setting up the compiler==
  
===Step 2: Getting MinGW===
+
=== Windows ===
 +
Download the installer and run it, but don't start Code::Blocks yet.
  
This step is only required if you are using the Code::Blocks nightly builds. Once an official Code::Blocks package is released (rc3 or 1.0), MinGW will be included with Code::Blocks and you can skip this step.
+
===Linux===
 +
Chances are, your linux installation already has all the necessary programs. If not, refer to your individual distribution's installation methods for installing gcc, gnu make and their appropriate libraries.
  
You need the latest version of MinGW from [http://www.mingw.org/download.shtml this website].  You need the latest stable versions of the following packages...
+
==Step 3: Required Libraries==
* mingw-runtime
+
* w32api
+
* binutils
+
* gcc
+
* g++
+
  
Downlaod all of them and extract them to C:\cygwin.  If you're using windows and don't have an archiver capable of handling tar.gz files, stop living in the stone age and download [http://www.7-zip.org/ 7-zip].  If you are compiling Odamex for the purpose of debugging, grab gdb as well.
+
Odamex requires the following libraries to compile:
  
===Step 3: Required Libraries ===
+
* [http://www.libsdl.org/download-1.2.php SDL Development Library]
 +
* [http://www.libsdl.org/projects/SDL_mixer/ SDL_mixer Development Library]
  
For ODAMEX to successfully compile, you must obtain some libraries for it, which are:
+
===Windows===
 +
Copy the '''include\SDL''' and '''lib''' folders from the archives and paste them into your '''path-to-codeblocks\MinGW''' directory, overwriting the old '''include''' and '''lib''' folders respectively.
  
<b>SDL Development Libraries</b>
+
'''Note:''' You may need to copy the files from '''include\SDL''' to the '''include''' directory in the '''path-to-codeblocks\MinGW''', otherwise when it comes time to build the client, it will complain about SDL.h missing.
  
You can get the latest version of SDL [http://www.libsdl.org/download-1.2.php  here]
+
===Linux===
 +
Refer to your individual distribution's installation methods for installing SDL and SDL_mixer libraries.
  
Unzip the appropriate archive (SDL-devel-1.2.11-mingw32.tar.gz as the time of this writing) onto the desktop (don't worry, it comes in its own tidy little folder).  Copy the bin, include and lib folders from the archive and paste them into your C:\MinGW directory.
+
==Step 4: Getting the source code for ODAMEX==
  
<b>SDL_mixer Development Libraries</b>
+
The source code can be obtained through the [http://odamex.net website] or from the [[SVN]] repository using a SVN client.
  
You can get the latest version of SDL_mixer [http://www.libsdl.org/projects/SDL_mixer/ here]
+
==Step 5: Compiling the ODAMEX source code==
  
Unzip the appropriate archive (SDL_mixer-devel-1.2.7-VC6.zip as the time of this writing) onto the desktop (don't worry, it comes in its own tidy little folder).  Copy the include and lib folders from the archive and paste them into your C:\MinGW directory.
+
After you've extracted the source code to a directory, open the workspace file (currently named '''odamex.workspace''').
  
===Step 4: Getting the source code for ODAMEX===
+
Select GCC as the default compiler.
  
The source code can be obtained through the [http://odamex.net website] or from the [[SVN]] repository
+
If a dialog box asking for information about a global variable "wx" comes up, simply enter C:\mingw\ under base and click enter unless you're planning on compiling the launcher.
using  an svn client.  For Windows, we recommend [http://tortoisesvn.tigris.org/ tortoisesvn].  For linux and other platforms, you can use the standard [http://subversion.tigris.org/ svn tools].
+
  
===Step 5: Compiling the ODAMEX source code===
+
Once the environment is loaded, double click on the project name (client, server, master), select your target (Debug or Release), go to the '''Build menu''' and click '''Rebuild'''.
  
After you've extracted the source code to a directory, open the workspace file (currently named odamex.workspace)
+
==Step 6: Obtaining the runtime libraries==
and go to the '''Build menu''' and click '''Rebuild workspace'''
+
  
===Conclusion===
+
[[Image:codeblocks_bin_directory_final.png|thumb|The required contents of trunk/bin]]
  
Once its all built (and no errors have occurred), you should find some binary files located in the '''bin''' directory
+
Once its all built (and no errors have occurred), you should find some binary files located in the '''bin''' directory. The only thing that you're likely missing is the SDL and SDL_mixer runtime librariesDownload the appropriate library for your system from [http://www.libsdl.org/download-1.2.php here] and [http://www.libsdl.org/projects/SDL_mixer/ here]. Also, make sure to copy odamex.wad and your IWAD of choice to the '''bin''' directory as well.  Once finished, your directory should probably look something like shown in the screenshot.
and these are ready to use.
+
 
+
==Linux==
+
Unfortuniatly, we do not support building Odamex in Code::Blocks under Linux at this time.  This is due to the fact that Odamex's project files were created with nightly builds of Code::Blocks, which are incompatable with the latest version avalable for Linux (Release Canadate 2)Please see [[Compiling using a Makefile]] for more information on how to compile Odamex under Linux.
+
 
+
==External Links==
+
* [http://www.codeblocks.org/ Code::Blocks]
+
* [http://www.libsdl.org SDL]
+
* [http://www.libsdl.org/projects/SDL_mixer SDL_mixer]
+

Latest revision as of 04:53, 29 February 2008

The ODAMEX Source package comes with a variety of project and workspace files.

This tutorial will show you how to build ODAMEX using the Code::Blocks IDE.

Step 1: Getting Code::Blocks

You can download Code::Blocks from its website here: Code::Blocks. Be sure to get the latest release installer WITH MinGW

Step 2: Setting up the compiler

Windows

Download the installer and run it, but don't start Code::Blocks yet.

Linux

Chances are, your linux installation already has all the necessary programs. If not, refer to your individual distribution's installation methods for installing gcc, gnu make and their appropriate libraries.

Step 3: Required Libraries

Odamex requires the following libraries to compile:

Windows

Copy the include\SDL and lib folders from the archives and paste them into your path-to-codeblocks\MinGW directory, overwriting the old include and lib folders respectively.

Note: You may need to copy the files from include\SDL to the include directory in the path-to-codeblocks\MinGW, otherwise when it comes time to build the client, it will complain about SDL.h missing.

Linux

Refer to your individual distribution's installation methods for installing SDL and SDL_mixer libraries.

Step 4: Getting the source code for ODAMEX

The source code can be obtained through the website or from the SVN repository using a SVN client.

Step 5: Compiling the ODAMEX source code

After you've extracted the source code to a directory, open the workspace file (currently named odamex.workspace).

Select GCC as the default compiler.

If a dialog box asking for information about a global variable "wx" comes up, simply enter C:\mingw\ under base and click enter unless you're planning on compiling the launcher.

Once the environment is loaded, double click on the project name (client, server, master), select your target (Debug or Release), go to the Build menu and click Rebuild.

Step 6: Obtaining the runtime libraries

The required contents of trunk/bin

Once its all built (and no errors have occurred), you should find some binary files located in the bin directory. The only thing that you're likely missing is the SDL and SDL_mixer runtime libraries. Download the appropriate library for your system from here and here. Also, make sure to copy odamex.wad and your IWAD of choice to the bin directory as well. Once finished, your directory should probably look something like shown in the screenshot.