Building using CMake: Difference between revisions
(Adding tip to troubleshooting.) |
(→Mac) |
||
Line 36: | Line 36: | ||
===Mac=== | ===Mac=== | ||
* Install Xcode (from the App Store) and MacPorts (for Boost | * 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: [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
See Building Flightgear for the main article about this subject. |
Build Environment & Dependencies
Linux / Unix
- Install Boost, OpenAL, ALUT, PLIB and other OpenSceneGraphDependencies (eg, libpng).
- Fedora 16 Package List
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.
|