Building FlightGear - Debian: Difference between revisions

updated for FG 2.8.0
(update to Atlas install)
(updated for FG 2.8.0)
Line 1: Line 1:
{{out of date}}
HowTo build [[FlightGear]] [[Changelog_2.8.0|2.8.0]] or bleeding edge development version, hereinafter simply called ''[[GIT]]'', on GNU/Linux [http://www.debian.org/ Debian] '''Stable''' 6.x (Squeeze) and '''Testing''' (Wheezy).
 
HowTo build FlightGear [[Changelog_2.6.0|2.6.0]] or bleeding edge development version, hereinafter simply called ''[[GIT]]'', on GNU/Linux [http://www.debian.org/ Debian] '''Stable''' 6.x (Squeeze) and '''Testing''' (Wheezy).


The meaning of this article is to be a short, '''checklist''' like, overview of the specific steps to compile FlightGear and components on Debian. For more detailed information please refer to the main article [[Building_FlightGear_-_Linux | Building FlightGear on Linux]].
The meaning of this article is to be a short, '''checklist''' like, overview of the specific steps to compile FlightGear and components on Debian. For more detailed information please refer to the main article [[Building_FlightGear_-_Linux | Building FlightGear on Linux]].
Line 35: Line 33:


== Build and install ==
== Build and install ==
Because we are going to install versions different to the ones in the repositories, it is recommended to install FlightGear in a place independent of the base system, such as <code>/usr/local/FG-2.6.0</code> or <code>$HOME/FG-2.6.0</code>. This way also has the advantage of easily managing several FlightGear versions, even with different versions of OpenSceneGraph and/or plib. I suggest to make this directory writeable by the user so there is no need to become root for the <code>make install</code> commands. We'll use <code>$prefix</code> as a placeholder for this directory. <br />
Because we are going to install versions different to the ones in the repositories, it is recommended to install FlightGear in a place independent of the base system, such as <code>/usr/local/FG-2.8.0</code> or <code>$HOME/FG-2.8.0</code>. This way also has the advantage of easily managing several FlightGear versions, even with different versions of OpenSceneGraph and/or plib. I suggest to make this directory writeable by the user so there is no need to become root for the <code>make install</code> commands. We'll use <code>$prefix</code> as a placeholder for this directory. <br />
Another placeholder will be <code>$srcdir</code>, it stands for the absolute path to the directory which is supposed to keep the folders of the various source codes. So, in the following instructions, you have to replace these with the local paths or even <code>export</code> them during the process:
Another placeholder will be <code>$srcdir</code>, it stands for the absolute path to the directory which is supposed to keep the folders of the various source codes. So, in the following instructions, you have to replace these with the local paths or even <code>export</code> them during the process:
  export prefix=$HOME/FG-2.6.0 && mkdir $prefix
  export prefix=$HOME/FG-2.8.0 && mkdir $prefix
  export srcdir=$HOME/src && mkdir $srcdir
  export srcdir=$HOME/src && mkdir $srcdir


Have in mind that the data is a relatively large download (GIT about 4.4 GB and 2.6.0 540 MB). So, to save some time, it is a good idea to [[#FlightGear data|fetch]] it while building the sources.
Have in mind that the data is a relatively large download (GIT about 5 GB and 2.8.0 650 MB). So, to save some time, it is a good idea to [[#FlightGear data|fetch]] it while building the sources.


For some basic info on git commands for FlightGear users we have a [[Git#For dummies|git for dummies]] section.
For some basic info on git commands for FlightGear users we have a [[Git#For dummies|git for dummies]] section.
Line 49: Line 47:
<u>Lenny only!</u> The libopenal-dev package in Lenny is too old for [[fgcom]]. For FlightGear it does work but not all features (like doppler) are available, so installing an up to date version is recommended anyway.
<u>Lenny only!</u> The libopenal-dev package in Lenny is too old for [[fgcom]]. For FlightGear it does work but not all features (like doppler) are available, so installing an up to date version is recommended anyway.
  cd $srcdir
  cd $srcdir
  wget http://kcat.strangesoft.net/openal-releases/openal-soft-1.11.753.tar.bz2
  wget http://kcat.strangesoft.net/openal-releases/openal-soft-1.12.854.tar.bz2
  tar xjf openal-soft-1.11.753.tar.bz2
  tar xjf openal-soft-1.12.854.tar.bz2
  cd openal-soft-1.11.753/build
  cd openal-soft-1.12.854/build
  cmake  -D CMAKE_INSTALL_PREFIX:PATH="$prefix" ..
  cmake  -D CMAKE_INSTALL_PREFIX:PATH="$prefix" ..
  make install
  make install
Line 57: Line 55:


=== [[plib]] ===
=== [[plib]] ===
<u>2.6.0 and GIT:</u>
<u>2.8.0 and GIT:</u>
Latest SVN is [http://www.mail-archive.com/flightgear-devel@lists.sourceforge.net/msg20793.html recommended], yet package plib1.8.5-dev for Squeeze does work as well.
Latest SVN is [http://www.mail-archive.com/flightgear-devel@lists.sourceforge.net/msg20793.html recommended], yet package plib1.8.5-dev for Squeeze does work as well.
  cd $srcdir
  cd $srcdir
Line 69: Line 67:


=== [[OpenSceneGraph]] ===
=== [[OpenSceneGraph]] ===
<u>GIT</u> users, especially developers, may want to use the latest release or even bleeding edge code here instead. <br />
For <u>2.8.0</u> at least version 3.0.1 is recommended. <u>GIT</u> users, especially developers, may want to use the latest release or even bleeding edge code here instead. <br />
<u>2.6.0 and GIT:</u>
<u>2.8.0 and GIT:</u>
  cd $srcdir
  cd $srcdir
  svn co http://www.openscenegraph.org/svn/osg/OpenSceneGraph/tags/OpenSceneGraph-3.0.1 OpenSceneGraph
  svn co http://www.openscenegraph.org/svn/osg/OpenSceneGraph/tags/OpenSceneGraph-3.0.1 OpenSceneGraph
Line 80: Line 78:


=== [[SimGear]] ===
=== [[SimGear]] ===
<u>2.6.0 and GIT:</u>
<u>2.8.0 and GIT:</u>
  cd $srcdir
  cd $srcdir
  git clone git://mapserver.flightgear.org/simgear
  git clone git://mapserver.flightgear.org/simgear


<u>2.6.0 only:</u>
<u>2.8.0 only:</u>
  cd simgear
  cd simgear
  git checkout -b 2.6.0 origin/release/2.6.0
  git checkout -b 2.8.0 origin/release/2.8.0


<u>2.6.0 and GIT:</u>
<u>2.8.0 and GIT:</u>
  mkdir $srcdir/sg-build && cd $srcdir/sg-build
  mkdir $srcdir/sg-build && cd $srcdir/sg-build
  cmake -D CMAKE_INSTALL_PREFIX:PATH="$prefix" $srcdir/simgear
  cmake -D CMAKE_INSTALL_PREFIX:PATH="$prefix" $srcdir/simgear
Line 95: Line 93:


=== FlightGear source ===
=== FlightGear source ===
<u>2.6.0 and GIT:</u>
<u>2.8.0 and GIT:</u>
  cd $srcdir
  cd $srcdir
  git clone git://mapserver.flightgear.org/flightgear
  git clone git://mapserver.flightgear.org/flightgear


<u>2.6.0 only:</u>
<u>2.8.0 only:</u>
  cd flightgear
  cd flightgear
  git checkout -b 2.6.0 origin/release/2.6.0
  git checkout -b 2.8.0 origin/release/2.8.0


<u>2.6.0 and GIT:</u>
<u>2.8.0 and GIT:</u>
  mkdir $srcdir/fg-build && cd $srcdir/fg-build
  mkdir $srcdir/fg-build && cd $srcdir/fg-build
  cmake -D CMAKE_INSTALL_PREFIX:PATH="$prefix" $srcdir/flightgear
  cmake -D CMAKE_INSTALL_PREFIX:PATH="$prefix" $srcdir/flightgear
Line 110: Line 108:


=== FlightGear data ===
=== FlightGear data ===
<u>2.6.0 only:</u> Please have a look at the [http://flightgear.org/mirrors.html mirror list] for a server close to your location.
<u>2.8.0 only:</u> Please have a look at the [http://flightgear.org/mirrors.html mirror list] for a server close to your location.
  cd $prefix
  cd $prefix
  wget http://mirrors.ibiblio.org/pub/mirrors/flightgear/ftp/Shared/FlightGear-data-2.6.0.tar.bz2
  wget http://mirrors.ibiblio.org/pub/mirrors/flightgear/ftp/Shared/FlightGear-data-2.8.0.tar.bz2
  tar xjf FlightGear-data-2.6.0.tar.bz2
  tar xjf FlightGear-data-2.8.0.tar.bz2


<u>GIT only:</u>
<u>GIT only:</u>
Line 134: Line 132:


== Optional Software ==
== Optional Software ==
[[File:Zeichen_101_icon.png|21px]] Many of the below instructions are most likely not up to date. Please feel free to revise them.
[[File:Zeichen_101_icon.png|21px]] Some of the below instructions possibly are not up to date. Please feel free to revise them.


Feel free to add the commands to install other FlightGear related projects.
Feel free to add the commands to install other FlightGear related projects.
392

edits