CMake Quick Start Guide

From Ogre Wiki

Jump to: navigation, search

Contents


Introduction

This guide is designed to get you building OGRE from source with the default settings in the shortest possible time, showing you the barest minimum of CMake to do that, and minus any real discussion. Remember that there is a lot more to the hows and whys of this process, so it's a good idea to go back to the Getting Started With CMake page and read the whole thing when you have time.

We assume here that you've already downloaded / extracted the OGRE source code into a folder on your local machine. From here, go to the section for your platform.

Windows

  1. Make sure you have downloaded, extracted and built the dependencies package
  2. Download CMake. You want the 'Win32 installer' release in the binary distribution section
  3. Run the CMake installer, install wherever you like
  4. Launch CMake via Start > Program Files > CMake 2.8 > CMake
  5. In the "Where is the source code" box, type or browse to the root directory of your OGRE source (the one that contains the OgreMain folder)
  6. In the "Where to build the binaries" box, type or browse to any folder you like - this will be where the build output will go (libraries, headers, dlls & sample exes). The folder does not have to exist yet. Note that you can run this process more than once with different output folders if you want (but we won't complicate matters now)
  7. Hit the 'Configure' button near the bottom of the screen
  8. Pick your target compiler, e.g. "Visual Studio 8 2005"
  9. Answer 'Ok' when asked if you want to create the build directory
  10. Wait for the configure process to finish
  11. The screen will now have a bunch of configuration options on it, which will be red (this is to indicate this is the first time you've seen them). You can see the potential for customising your build here, but for now just click the 'Configure' button again
  12. The values will turn grey, and the 'Generate' button at the bottom will now be enabled. Click 'Generate'
  13. Build files will now be generated in the location you picked, and CMake will say "Generating done"

That's it for CMake! You now have a set of project files that are very much like you're used to in previous versions of OGRE, in the output folder you chose. Just browse there and open the main project file (e.g. OGRE.sln). You can build as before, but there is now a special target called 'ALL_BUILD' which is a quick way to build all targets for a specific configuration. Note that all build output is now stored in a subfolder of this build folder, and not in the original OGRE source folder - so you can create multiple builds from one source directory now.

Linux / Unix

  1. Install CMake via your distribution's package repository. For example, on Ubuntu type 
    sudo apt-get install cmake
    If your distribution does not provide an official CMake package, go to the CMake website and either download a binary package or download and compile CMake from source.
  2. Create a build directory somewhere on your filesystem - this will be where the build output will go.
  3. In a console, cd to the build directory and call cmake with the path to the source dir (i. e. where you extracted the Ogre source files): 
    cmake /path/to/Ogre/source/dir
  4. Compile Ogre. Type: 
    make
    Don't forget that make provides the -j option which you can use to spawn multiple make processes to speed up compiling on a multi-core PC! For example, this works well on a dual-core: 
    make -j3
  5. Install Ogre. Type as root: 
    make install (or: sudo make install)
    This will install the Ogre libraries to /usr/local

Essentially, building with CMake is very similar to a traditional autoconf build. CMake simply takes the role of ./configure! In order to learn how to change build settings, please refer to Getting Started With CMake and Building Ogre With CMake.

Mac OS X

  1. Extract the dependencies into your ogre source root
  2. Download CMake. You want the 'Mac OS X Universal' release in the binary distribution section
  3. The .dmg will probably auto-mount when it downloads, if not, double-click it to open
  4. Double-click the .pkg installer, install on your main drive and opt to install the command-line tools too (in case you want to use them later, we will use the GUI here)
  5. Launch CMake via Applications
  6. In the "Where is the source code" box, type or browse to the root directory of your OGRE source (the one that contains the OgreMain folder)
  7. In the "Where to build the binaries" box, type or browse to any folder you like - this will be where the build output will go (libraries, headers, dlls & sample exes). The folder does not have to exist yet. Note that you can run this process more than once with different output folders if you want (but we won't complicate matters now)
  8. Hit the 'Configure' button near the bottom of the screen
  9. Pick 'Xcode' as the generator and opt to use native compilers
  10. Answer 'Ok' when asked if you want to create the build directory
  11. Wait for the configure process to finish
  12. The screen will now have a bunch of configuration options on it, which will be red (this is to indicate this is the first time you've seen them). You can see the potential for customising your build here, but for now just click the 'Configure' button again
  13. The values will turn grey, and the 'Generate' button at the bottom will now be enabled. Click 'Generate'
  14. Build files will now be generated in the location you picked

Now, open OGRE.xcodeproj in the build directory you picked, open it in Xcode. ALL_BUILD will build everything!

iPhone

Detailed instructions on building OGRE for iPhone can be found on this page Building From Source (for iPhone)

Retrieved from "http://www.ogre3d.org/wiki/index.php/CMake_Quick_Start_Guide"
Personal tools
administration