Difference between revisions of "Building Horde3D"

From Horde3D Wiki
Jump to: navigation, search
(Created unified build instructions article)
 
m
Line 1: Line 1:
__NOTOC__
+
__NOTOC__ __NOEDITSECTION__{{ContentBlock|color=white|content={{!!}}
 
 
 
This article contains instructions for building Horde3D from source on all supported platforms. Since Horde3D is very lightweight and has a minimal amount of external dependencies, getting it to compile and run is usually quite straightforward.
 
This article contains instructions for building Horde3D from source on all supported platforms. Since Horde3D is very lightweight and has a minimal amount of external dependencies, getting it to compile and run is usually quite straightforward.
  
Line 42: Line 41:
  
 
''TODO''
 
''TODO''
 +
}}

Revision as of 17:44, 3 January 2010

This article contains instructions for building Horde3D from source on all supported platforms. Since Horde3D is very lightweight and has a minimal amount of external dependencies, getting it to compile and run is usually quite straightforward.

Obtaining the SDK

Besides the official releases, there is also a subversion repository hosted at SourceForge which is usually more up-to-date than the stable point releases.

The repository has the common SVN structure branches, tags and trunk. The latest development snapshot can be found in the trunk folder, while the official releases are tagged in the tags folder. If you check out the trunk folder, you will get the SDK along with all official extensions.

The following command can be used to check out the latest WIP version of Horde3D:

svn co https://horde3d.svn.sourceforge.net/svnroot/horde3d/trunk Horde3D

Building on Windows

The preferred way of building Horde3D on Windows is using Visual Studio. The SDK comes with a solution file for Visual Studio 2005 that can be opened with the Visual C++ Express Edition as well. If you have Visual Studio 2008 (Standard/Professional or Express), you can simply use the VS Conversion Wizard to update the solution and project files. The solution contains the samples that can be started directly from Visual Studio. Just set the desired sample as startup project.

It is also possible to use CMake to create the Visual Studio solution files. The process is similar to what you do on Linux then. However, if you want to use Visual Studio's nmake, you usually have to use the Visual Studio Command Prompt instead of the standard cmd shell. Sample batch files for creating VS 2005 and 2008 projects can be found in the CMake folder located in the Horde3D repository.

Building on Linux

The Horde3D SDK is compatible with gcc and ships with CMake configuration files. To build Horde3D, just switch to the Horde3D root directory. Create a new directory which will contain the makefiles created by CMake, for example CMake and change into it. After that, type

 cmake ..

which will create the makefiles. Once they are created, you can type make to build the code or make clean to remove all generated files.

Building on Max OS X

Mac OS X is an advanced graphical system layered over a traditional Unix core. Because of this, you can either use Apple's graphical Xcode IDE to develop Horde3D based applications, or you can go the traditional Unix way using gcc and makefiles.

The Mac Way Using Xcode

To create the Xcode project files, you have to install CMake first. After installing the CMake command line tools, you should be able to run CMake from the console. Switch to Horde3D root directory and create a new directory in which the CMake output will be stored, for example CMake. Change the current directory to that newly created one and type

 cmake -G "Xcode" ..

You should now be able to open the newly created project in Xcode in order to build Horde3D.

The Unix Way Using the Command Line

TODO