History: Building Ogre

• «
• »

            {BOX(width="100%",class="Layout_box9",title="Building OGRE From Source")}{SPLIT(colsize=10%|70%)}{IMG(src="img/wiki_up/OGRE_Libraries.png",imalign="left")}{IMG}
---
For developers with more experience, building OGRE from source is usually the more attractive option. For some, it is the only option as prebuilt binaries are not available. Source provides the fastest access to bug fixes and allows the developer to debug any aspect of their code or OGRE. It is also necessary for contributing patches.
{DIV(class="Layout_box13")}%info% As of version 1.7 (Cthugha), the Ogre project uses CMake as its primary build system. See ((Building Ogre Shoggoth)) for previous versions.{DIV}
For the latest stable code (all platforms), you can [http://www.ogre3d.org/developers/mercurial|check out the source from Mercurial]. 
If using windows, you might also want to read ((Getting Sources With TortoiseHG|a quick guide about getting the sources with tortoisehg, a windows client)).

The actual stable revision is always in a specific branch, e.g. "v1-7" for Cthugha, and not the default branch. The 'default' branch is the latest unstable version and is not fully API-compatible with the stable stream, and may have temporary issues. Recommended only for experienced developers.

!!!!-Quick Mercurial Guide {DIV(type="span", class="nxOgre_sup")}(Click the ''+'' sign to view){DIV}
To clone OGRE directly to the stable version (Cthugha) do this:
{CODE(wrap="1")}hg clone http://bitbucket.org/sinbad/ogre/ -u v1-7{CODE}
For the unstable 'default' branch:
{CODE(wrap="1")}hg clone http://bitbucket.org/sinbad/ogre/{CODE}

%note% __Note:__ You can always switch branches at any time. For instance, this command switches to the current stable branch:
{CODE(wrap="1")}hg update v1-7{CODE}
!!!!
{SPLIT}{BOX}

{BOX(width="100%",class="Layout_box9")}{SPLIT(colsize=10%|70%)}{IMG(src="img/wiki_up/CMake.png",imalign="left")}{IMG}
---
{DIV(class="bigBold")}((Building Ogre with CMake)){DIV}
As of version 1.7 (Cthugha), the Ogre project uses CMake as its primary build system. On the following pages you can familiarise yourself with CMake and how to use it to build Ogre from source (and, if you like, your own projects using Ogre).
{SPLIT}{BOX}
{BOX(width="100%",class="Layout_box9")}{SPLIT(colsize=10%|70%)}{IMG(src="img/wiki_up/Star.png",imalign="left")}{IMG}
---
{DIV(class="bigBold")}((CMake Quick Start Guide|Quick Start Guide)){DIV}
For the impatient: Learn how to build Ogre with CMake in two minutes. If you encounter any problems or need some more advanced procedures, do read the rest of the sections below!
{SPLIT}{BOX}
{BOX(width="100%",class="Layout_box9")}{SPLIT(colsize=10%|70%)}{IMG(src="img/wiki_up/Faq.jpg",imalign="left")}{IMG}
---
{DIV(class="bigBold")}((Getting started with CMake)){DIV}
This section introduces you to CMake and explains the concepts as well as how you can get and use CMake.
{SPLIT}{BOX}
{BOX(width="100%",class="Layout_box9")}{SPLIT(colsize=10%|70%)}{IMG(src="img/wiki_up/Libraries.png",imalign="left")}{IMG}
---
{DIV(class="bigBold")}((Building Your Projects With CMake)){DIV}
This section is an introduction on how to use CMake to build your own projects and have them link against Ogre. For more detailed information about CMake, refer to the official CMake website: [http://www.cmake.org]
{SPLIT}{BOX}
{BOX(width="100%",class="Layout_box9")}{SPLIT(colsize=10%|70%)}{IMG(src="img/wiki_up/Development_Tools.png",imalign="left")}{IMG}
---
For developers: Working with and extending Ogre's CMake build system
{DIV(class="bigBold")}((CMake Build System Overview)){DIV}
This section describes in some detail how Ogre's CMake build system works and how you can extend it. This is meant for developers who may need to add source files or entire targets to the build system.
{SPLIT}{BOX}

---
Alias: (alias(Building With CMake))
Alias: (alias(Building From Source))