Building using CMake: Difference between revisions

From FlightGear wiki
Jump to navigation Jump to search
(Adding tip to troubleshooting.)
Line 36: Line 36:
===Mac===
===Mac===


* Install Xcode (from the App Store) and MacPorts (for Boost & PLIB - or build them some other way if you prefer)
* Install Xcode (from the App Store) and MacPorts (for Boost, or just install directly from source)
* Grab James' ALUT framework and add it to /Library/Frameworks
* Install the Subversion client libraries and PLIB.  These are included in the 'Mac 3rd-party dependencies' zip file. PLIB is also available through MacPorts, and Subversion is available by default on Snow Leopard (10.6) and Lion (10.7) but NOT on Mountain Lion (10.8)
* Get the OpenSceneGraph sources, either from subversion or a zip
* Install OpenSceneGraph.
 
The easiest solution is to grab the 3rd-party dependencies build from Jenkins: [http://flightgear.simpits.org:8080/job/Mac-3rdparty-deps/lastSuccessfulBuild/artifact/*zip*/archive.zip]. This will give you a 'dist' directory containing PLIB, Subversion and OpenSceneGraph correctly configured.


===Windows===
===Windows===

Revision as of 22:16, 22 August 2012

1rightarrow.png See Building Flightgear for the main article about this subject.

Build Environment & Dependencies

Linux / Unix

FIXME - provide a list of package names for Ubuntu

  • Get the OpenSceneGraph sources, either from subversion or a zip
  • NOTE: On Debian AMD64 (or not 32-bit) systems (maybe including Ubuntu) there is currently a packaging error which leads to false detection of OpenAL. Until it got repaired, you have 2 options left:

1. Goto /usr/share/cmake-2.8/Modules/ (it is the right patch on my Debian system) and expand the search path with lib/x86_64-linux-gnu/:

sudo su # to become root
cd /usr/share/cmake-2.8/Modules/ # again, use the proper path of your system
$EDITOR FindOpenAL.cmake
# Search for FIND_LIBRARY(OPENAL_LIBRARY
# Search again for PATH_SUFFIXES
# Append behind "lib": lib/x86_64-linux-gnu/
# Save it
# Quit your editor
exit # to leave root

2. (As I did) Set a symbolic link so cmake can find it:

sudo su # again, become root
cd /usr/lib/
ln -s x86_64-linux-gnu/* . # ignore that error for pkconfig for now
cd pkconfig/
ln -s ../x86_64-linux-gnu/pkgconfig/* .
  • Both steps have advantages and disadvantages, e.g. when it comes to updates, so you might need to repeat your desired path and fix your symbolic links by removing them first (!) and then re-create them. A big "thanks" to James for giving me the hints. :)
  • If you have OSG/PLIB on different directories than the usual, use environmental variables OSG_DIR/PLIBDIR, e.g. addd to ~/.bashrc:
# OSG/PLIB special directory
export OSG_DIR=/opt/my-osg-path
export PLIBDIR=/opt/my-plib-path

Mac

  • Install Xcode (from the App Store) and MacPorts (for Boost, or just install directly from source)
  • Install the Subversion client libraries and PLIB. These are included in the 'Mac 3rd-party dependencies' zip file. PLIB is also available through MacPorts, and Subversion is available by default on Snow Leopard (10.6) and Lion (10.7) but NOT on Mountain Lion (10.8)
  • Install OpenSceneGraph.

The easiest solution is to grab the 3rd-party dependencies build from Jenkins: [1]. This will give you a 'dist' directory containing PLIB, Subversion and OpenSceneGraph correctly configured.

Windows

See Building using CMake - Windows

Getting started with CMake

(These instructions apply to Unix-like systems, including Cygwin and Mac. To build using Visual Studio or some other IDE supported by CMake, most of the information below still applies)

Always compile in a separate directory to the code. For example, if the code (eg, from Git) is at /home/curt/projects/flightgear, you might create /home/curt/projects/fgbuild. Change into the new directory, and run

   cmake ../flightgear

To generate standard Unix Makefiles in fgbuild.

All these instructions apply equally to OpenSceneGraph, SimGear and finally FlightGear.

Probably you want to specify an install prefix:

   cmake -DCMAKE_INSTALL_PREFIX=/usr ../flightgear

Note the install prefix is automatically searched for required libraries and header files, so if you install PLIB, OpenSceneGraph and SimGear to the same prefix, most configuration options are unnecessary.

If for some reason you have a dependency (or several) at a different prefix, you can specify one or more via CMAKE_PREFIX_PATH:

   cmake -DCMAKE_PREFIX_PATH="/opt/local;/opt/fgfs" ../flightgear

(note the use of semi-colons to specify multiple prefix paths)

Standard prefixes are searched automatically (/usr, /usr/local, /opt/local)

Most dependencies also expose an environment variable to specify their installation directory explicitly eg OSG_DIR or PLIBDIR. Any of the methods described above will work, but specifying an INSTALL_PREFIX or PREFIX_PATH is usually simpler.

By default, we select a release build. To create a debug build, use

   cmake -DCMAKE_BUILD_TYPE=Debug ../flightgear

(or MinSizeRel, or RelWithDbg)

Debug builds will automatically use corresponding debug builds of required libraries, if they are available. For example you can install debug builds of SimGear and OpenSceneGraph, and a debug FlightGear build will use them.

(Debug builds of libraries have the 'd' suffix by default - Release builds have no additional suffix)

Note most IDE projects (eg Xcode and Visual Studio) support building all the build types from the same project, so you can omit the CMAKE_BUILD_TYPE option when running cmake, and simply pick the build configuration as normal in the IDE.

It's common to have several build directories with different build configurations, eg

   /home/curt/projects/flightgear (the git clone)
   /home/curt/projects/fgdebug
   /home/curt/projects/fgrelease
   /home/curt/projects/fg-with-svn-osg

To set an optional feature, do

   cmake -DFEATURE_NAME=ON  ../flightgear

(or 'OFF' to disable )

To see the variables that can be configured / are currently defined, you can run one of the GUI front ends, or the following command:

   cmake -L ../flighgear

Add 'A' to see all the options (including advanced options), or 'H' to see the help for each option (similar to running configure --help under autoconf):

   cmake -LH ../flightgear

Build Targets

For a Unix makefile build, 'make dist', 'make uninstall' and 'make test' are all available and should work as expected. 'make clean' is also as normal, but there is *no* 'make distclean' target. The equivalent is to completely remove your build directory, and start with a fresh one.

Troubleshooting

If you have strange errors when invoking cmake, for example you installed SimGear and when configuring flightgear to compile you get the error "Oops, you have installed SimGear includes, however test compiling failed. Try removing 'CMakeCache.txt' and reconfigure with 'cmake'." even though everything is apparently fine you should check how your filesystem is mounted, because if it is another partition it could be that is mounted with the "noexec" flag and cmake cannot work in that conditions.