Building FlightGear - Debian: Difference between revisions

Jump to navigation Jump to search

Building FlightGear - Debian (view source)

Revision as of 18:23, 21 September 2013

582 bytes added ,  21 September 2013
update for 2.12
m (Robot: Automated text replacement (-http://www.openscenegraph.org/svn/ +http://svn.openscenegraph.org/))
(update for 2.12)
Line 1: Line 1:
HowTo build [[FlightGear]] <u>[[Changelog_2.10.0|2.10.0]]</u> or bleeding edge development version, hereinafter simply called <u>[[GIT]]</u>, on GNU/Linux [http://www.debian.org/ Debian] Stable/<u>Squeeze</u>. Users of Oldstable, Testing/<u>Wheezy</u> or Unstable at least have to change package names (version numbering) accordingly.
HowTo build [[FlightGear]] <u>[[Changelog_2.12|2.12]]</u> or bleeding edge development version, hereinafter simply called <u>[[GIT]]</u>, on GNU/Linux [http://www.debian.org/ Debian] Oldstable/<u>Squeeze</u>. Users of Stable/<u>Wheezy</u>, Testing or Unstable at least have to change package names (version numbering) accordingly.


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 12: Line 12:


; Tools
; Tools
  su -c "apt-get install automake cmake g++ gcc git make subversion"
  su -c "apt-get install automake cmake g++ gcc git make sed subversion"
: Additionally install "fluid" if you intend to use [[FlightGear_Admin_Wizard|fgadmin]].
: Additionally install "fluid" if you intend to use [[FlightGear_Admin_Wizard|fgadmin]].


Line 34: Line 34:


== Build and install ==
== Build and install ==
Because we are going to install versions different to the ones in the Debian repositories, it is recommended to install FlightGear in a place independent of the base system, such as <code>/usr/local/FG-2.10.0</code> or <code>$HOME/FG-2.10.0</code>. This way also has the advantage of easily managing several FlightGear versions, even with different versions of OpenSceneGraph and/or plib, simply by altering the installation prefix. I suggest to make this directory writeable by the user so there is no need to become root for the <code>make -j2 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 Debian repositories, it is recommended to install FlightGear in a place independent of the base system, such as <code>/usr/local/FG-2.12</code> or <code>$HOME/FG-2.12</code>. This way also has the advantage of easily managing several FlightGear versions, even with different versions of OpenSceneGraph and/or plib, simply by altering the installation prefix. I suggest to make this directory writeable by the user so there is no need to become root for the <code>make -j2 install</code> commands. We'll use <code>$FG_INSTALL_DIR</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 instructions below, you have to replace these with the local paths or even <code>export</code> them (in every terminal you're using them) for the process:
Another placeholder will be <code>$FG_SRC_DIR</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 instructions below, you have to replace these with the local paths or even <code>export</code> them (in every terminal you're using them) for the process:
  export prefix=$HOME/FG-2.10.0 && mkdir $prefix
  export FG_INSTALL_DIR=$HOME/FG-2.12 && mkdir $FG_INSTALL_DIR
  export srcdir=$HOME/src && mkdir $srcdir
  export FG_SRC_DIR=$HOME/src && mkdir $FG_SRC_DIR


Have in mind that the data is a relatively large download (GIT about 5 GB and 2.10.0 650 MB). So, to save some time, it is a good idea to [[#FlightGear data|fetch]] it while building the sources. <br />
Have in mind that the data is a relatively large download (GIT more than 7 GB and growing / 2.12 960 MB). So, to save some time, it is a good idea to [[#FlightGear data|fetch]] it while building the sources. <br />
For some basic info on git commands for FlightGear users we have a [[Git#For dummies|git for dummies]] section. <br />
For some basic info on git commands for FlightGear users we have a [[Git#For dummies|git for dummies]] section. <br />
To have a build with debugging symbols add <code>-D CMAKE_BUILD_TYPE="RelWithDebInfo"</code> to SimGear's and FlightGear's cmake options.
To have a build with debugging symbols add <code>-D CMAKE_BUILD_TYPE="RelWithDebInfo"</code> to SimGear's and FlightGear's cmake options.
Line 48: Line 48:
<u>Wheezy</u>: Just install package "libfltk1.3-dev" if you're planning to use either of them. <br />
<u>Wheezy</u>: Just install package "libfltk1.3-dev" if you're planning to use either of them. <br />
<u>Squeeze</u>: For fgadmin just install package "libfltk1.1-dev". To compile fgrun, too, build and install FLTK-1.3 instead:
<u>Squeeze</u>: For fgadmin just install package "libfltk1.1-dev". To compile fgrun, too, build and install FLTK-1.3 instead:
  cd $srcdir
  cd $FG_SRC_DIR
  wget http://ftp.easysw.com/pub/fltk/1.3.2/fltk-1.3.2-source.tar.gz
  wget http://ftp.easysw.com/pub/fltk/1.3.2/fltk-1.3.2-source.tar.gz
  tar xzf fltk-1.3.2-source.tar.gz
  tar xzf fltk-1.3.2-source.tar.gz
  cd fltk-1.3.2
  cd fltk-1.3.2
  ./configure --enable-shared --prefix=$prefix
  ./configure --enable-shared --prefix=$FG_INSTALL_DIR
  make -j2 install
  make -j2 install




=== [[plib]] ===
=== [[plib]] ===
<u>2.10.0</u> and <u>GIT</u>:
<u>2.12</u> and <u>GIT</u>:
Latest SVN is [http://www.mail-archive.com/flightgear-devel@lists.sourceforge.net/msg20793.html required].
Latest SVN is [http://www.mail-archive.com/flightgear-devel@lists.sourceforge.net/msg20793.html required].
  cd $srcdir
  cd $FG_SRC_DIR
  svn co https://plib.svn.sourceforge.net/svnroot/plib/trunk plib
  svn co https://svn.code.sf.net/p/plib/code/trunk plib.svn
  cd plib
  cd plib
  sed s/PLIB_TINY_VERSION\ \ 5/PLIB_TINY_VERSION\ \ 6/ -i src/util/ul.h
  sed s/PLIB_TINY_VERSION\ \ 5/PLIB_TINY_VERSION\ \ 6/ -i src/util/ul.h
  ./autogen.sh
  ./autogen.sh
  ./configure --prefix=$prefix
  ./configure --prefix=$FG_INSTALL_DIR
  make -j2 install
  make -j2 install




=== [[OpenSceneGraph]] ===
=== [[OpenSceneGraph]] ===
For <u>2.10.0</u> on <u>Wheezy</u> skip that step and install package "libopenscenegraph-dev" instead. <br />
On <u>Wheezy</u> skip that step and install package "libopenscenegraph-dev" instead. <br />
<u>GIT</u> users, especially developers, most likely want to use the latest [http://www.openscenegraph.org/projects/osg/wiki/Downloads/DeveloperReleases DeveloperRelease] or even bleeding edge code here. <br />
Last version known to work for 2.12 is OpenSceneGraph 3.1.4. <br />
<u>2.10.0</u> and <u>GIT</u>:
<!--
  cd $srcdir
<u>GIT</u> users, especially developers, may want to use the latest [http://www.openscenegraph.org/index.php/download-section/developer-releases DeveloperRelease] or even bleeding edge code here. <br />
  svn co http://svn.openscenegraph.org/osg/OpenSceneGraph/tags/OpenSceneGraph-3.1.1 OpenSceneGraph
-->
<u>2.12</u> and <u>GIT</u>:
  cd $FG_SRC_DIR
  svn co http://svn.openscenegraph.org/svn/osg/OpenSceneGraph/tags/OpenSceneGraph-3.1.4 OpenSceneGraph-3.1.4.svn
  mkdir build-osg; cd build-osg
  mkdir build-osg; cd build-osg
  cmake -D CMAKE_BUILD_TYPE="Release" -DLIB_POSTFIX="" \
  cmake -D CMAKE_BUILD_TYPE="Release" -DLIB_POSTFIX="" \
       -D CMAKE_INSTALL_PREFIX:PATH="$prefix" $srcdir/OpenSceneGraph
       -D CMAKE_INSTALL_PREFIX:PATH="$FG_INSTALL_DIR" $FG_SRC_DIR/OpenSceneGraph-3.1.4.svn
  make -j2 install
  make -j2 install




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


<u>2.10.0</u> only:
<u>2.12</u> only:
  cd simgear
  cd simgear.git
  git checkout -b 2.10.0 origin/release/2.10.0
  git checkout -b 2.12 origin/release/2.12.0


<u>2.10.0</u> and <u>GIT</u>:
<u>2.12</u> and <u>GIT</u>:
  mkdir $srcdir/build-sg; cd $srcdir/build-sg
  mkdir $FG_SRC_DIR/build-sg; cd $FG_SRC_DIR/build-sg
  cmake -D CMAKE_INSTALL_PREFIX:PATH="$prefix" $srcdir/simgear
  cmake -D CMAKE_INSTALL_PREFIX:PATH="$FG_INSTALL_DIR" $FG_SRC_DIR/simgear.git
  make -j2 install
  make -j2 install




=== FlightGear source ===
=== FlightGear source ===
<u>2.10.0</u> and <u>GIT</u>:
<u>2.12</u> and <u>GIT</u>:
  cd $srcdir
  cd $FG_SRC_DIR
  git clone git://mapserver.flightgear.org/flightgear
  git clone git://mapserver.flightgear.org/flightgear flightgear.git


<u>2.10.0</u> only:
<u>2.12</u> only:
  cd flightgear
  cd flightgear.git
  git checkout -b 2.10.0 origin/release/2.10.0
  git checkout -b 2.12 origin/release/2.12.0


<u>2.10.0</u> and <u>GIT</u>:
<u>2.12</u> and <u>GIT</u>:
  mkdir $srcdir/build-fg; cd $srcdir/build-fg
  mkdir $FG_SRC_DIR/build-fg; cd $FG_SRC_DIR/build-fg
  cmake -D CMAKE_INSTALL_PREFIX:PATH="$prefix" $srcdir/flightgear
  cmake -D CMAKE_INSTALL_PREFIX:PATH="$FG_INSTALL_DIR" $FG_SRC_DIR/flightgear.git
  make -j2 install
  make -j2 install




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


<u>GIT</u> only:
<u>GIT</u> only:
For slow/unstable internet connections it is recommended to download the [[Git#fgdata.bundle|fgdata.bundle]] instead of cloning the data.<br />
For slow/unstable internet connections it is recommended to download the [[Git#fgdata.bundle|fgdata.bundle]] instead of cloning the data.<br />
  cd $prefix
  cd $FG_INSTALL_DIR
  git clone git://mapserver.flightgear.org/fgdata data
  git clone git://mapserver.flightgear.org/fgdata data


Line 124: Line 127:
== Trial run and finishing process ==
== Trial run and finishing process ==
When all the builds are done and the data download has finished it is time for a test run:
When all the builds are done and the data download has finished it is time for a test run:
  export LD_LIBRARY_PATH=$prefix/lib/:$LD_LIBRARY_PATH
  export LD_LIBRARY_PATH=$FG_INSTALL_DIR/lib/:$LD_LIBRARY_PATH
  $prefix/bin/fgfs --fg-root=$prefix/data
  $FG_INSTALL_DIR/bin/fgfs --fg-root=$FG_INSTALL_DIR/data
: The <code>fgfs</code> binary needs to find our self compiled libraries at runtime and therefore we have to tell the linker (ld) where to find them. That is what the first line here does. You might want to add this line to your <code>$HOME/.bashrc</code> to have this as a persistent setting (may cause problems, if one has installed more than one version of FlightGear!).
: The <code>fgfs</code> binary needs to find our self compiled libraries at runtime and therefore we have to tell the linker (ld) where to find them. That is what the first line here does. You might want to add this line to your <code>$HOME/.bashrc</code> to have this as a persistent setting (may cause problems, if one has installed more than one version of FlightGear!).
: Have in mind, the <code>$prefix</code> and <code>$srcdir</code> variables are available for this session only. For future use of these lines, replace them by the real paths.
: Have in mind, the <code>$FG_INSTALL_DIR</code> and <code>$FG_SRC_DIR</code> variables are available for this session only. For future use of these lines, replace them by the real paths.


To avoid the need to give the path to the <code>fgfs</code> command each time, you might consider to create a symlink at a place that is listed in $PATH:
To avoid the need to give the path to the <code>fgfs</code> command each time, you might consider to create a symlink at a place that is listed in $PATH:
  ln -s $prefix/bin/fgfs $HOME/bin/fgfs
  ln -s $FG_INSTALL_DIR/bin/fgfs $HOME/bin/fgfs


For the future, if you want to start FlightGear from command line have a look at [[fgfsrc]], if you prefer a graphical user interface continue with [[#fgrun|compiling fgrun]]<!--or check [[FGo!]]-->.  
For the future, if you want to start FlightGear from command line have a look at [[fgfsrc]], if you prefer a graphical user interface continue with [[#fgrun|compiling fgrun]] or check out another [http://wiki.flightgear.org/Category:FlightGear_front_ends launcher].  




Line 142: Line 145:
=== [[Atlas]] ===
=== [[Atlas]] ===
One more Package has to be installed: "libglew1.5-dev"
One more Package has to be installed: "libglew1.5-dev"
  cd $srcdir
  cd $FG_SRC_DIR
  git clone http://mapserver.flightgear.org/git/atlas
  git clone http://mapserver.flightgear.org/git/atlas
  cd atlas
  cd atlas
  ./autogen.sh
  ./autogen.sh
  ./configure --prefix=$prefix --with-fgbase=$prefix/data
  ./configure --prefix=$FG_INSTALL_DIR --with-fgbase=$FG_INSTALL_DIR/data
  make -j2 install
  make -j2 install
  cp -R $srcdir/atlas/src/data/* $prefix/data/Atlas
  cp -R $FG_SRC_DIR/atlas/src/data/* $FG_INSTALL_DIR/data/Atlas
<!--If it does not compile, go back some commits. Before invoking the <code>autogen.sh</code> command do:
<!--If it does not compile, go back some commits. Before invoking the <code>autogen.sh</code> command do:
  git reset --hard 5a27c351a8c03c7fa47cba0b4af7f4e23e4c31b0-->
  git reset --hard 5a27c351a8c03c7fa47cba0b4af7f4e23e4c31b0-->


  $prefix/bin/Atlas
  $FG_INSTALL_DIR/bin/Atlas




=== fgcom ===
=== fgcom ===
For [[fgcom]] install package "libasound2-dev".
For [[fgcom]] install package "libasound2-dev".
  cd $srcdir
  cd $FG_SRC_DIR
<!--git clone http://mapserver.flightgear.org/git/fgcom -->
<!--git clone http://mapserver.flightgear.org/git/fgcom -->
  svn co https://appfgcom.svn.sourceforge.net/svnroot/fgcom/trunk fgcom
  svn co https://appfgcom.svn.sourceforge.net/svnroot/fgcom/trunk fgcom
  cd fgcom/src
  cd fgcom/src
  make -j2 install_BIN=$prefix/bin INSTALL_DIR=$prefix/fgcom \
  make -j2 install_BIN=$FG_INSTALL_DIR/bin INSTALL_DIR=$FG_INSTALL_DIR/fgcom \
     PLIB_PREFIX=$prefix [OPENAL_PREFIX=$prefix] install
     PLIB_PREFIX=$FG_INSTALL_DIR [OPENAL_PREFIX=$FG_INSTALL_DIR] install
Create an .alsoftrc file as shown in [[FGCOM_Testing#Special_for_Linux_.28.alsoftrc.29|FGCOM Testing]].
Create an .alsoftrc file as shown in [[FGCOM_Testing#Special_for_Linux_.28.alsoftrc.29|FGCOM Testing]].


Line 169: Line 172:
To build [[fgrun]] libfltk1.3 is required, see [[#libfltk|libfltk above]]. <br />
To build [[fgrun]] libfltk1.3 is required, see [[#libfltk|libfltk above]]. <br />
<u>2.10.0</u> and <u>GIT</u>:
<u>2.10.0</u> and <u>GIT</u>:
  cd $srcdir
  cd $FG_SRC_DIR
  git clone git://gitorious.org/fg/fgrun.git
  git clone git://gitorious.org/fg/fgrun.git


Line 177: Line 180:


<u>2.10.0</u> and <u>GIT</u>:
<u>2.10.0</u> and <u>GIT</u>:
  mkdir $srcdir/build-fgrun; cd $srcdir/build-fgrun
  mkdir $FG_SRC_DIR/build-fgrun; cd $FG_SRC_DIR/build-fgrun
  cmake -D CMAKE_INSTALL_PREFIX:PATH="$prefix" $srcdir/fgrun
  cmake -D CMAKE_INSTALL_PREFIX:PATH="$FG_INSTALL_DIR" $FG_SRC_DIR/fgrun
  make -j2 install
  make -j2 install


<u>2.10.0</u> and <u>GIT</u>:
<u>2.10.0</u> and <u>GIT</u>:
  export LD_LIBRARY_PATH=$prefix/lib/:$LD_LIBRARY_PATH
  export LD_LIBRARY_PATH=$FG_INSTALL_DIR/lib/:$LD_LIBRARY_PATH
  $prefix/bin/fgrun
  $FG_INSTALL_DIR/bin/fgrun




Line 192: Line 195:
* "wx2.8-headers" (at least, maybe even more than just that one. Please [http://wiki.flightgear.org/index.php?title=Talk:Building_FlightGear_-_Debian&action=edit&redlink=1 report]!
* "wx2.8-headers" (at least, maybe even more than just that one. Please [http://wiki.flightgear.org/index.php?title=Talk:Building_FlightGear_-_Debian&action=edit&redlink=1 report]!
  su -c "aptitude install [libcurl4-gnutls-dev|libcurl4-openssl-dev]"
  su -c "aptitude install [libcurl4-gnutls-dev|libcurl4-openssl-dev]"
  cd $srcdir
  cd $FG_SRC_DIR
  git clone git://mapserver.flightgear.org/taxidraw
  git clone git://mapserver.flightgear.org/taxidraw
  cd taxidraw
  cd taxidraw
  ./autogen.sh
  ./autogen.sh
  ./configure --prefix=$prefix
  ./configure --prefix=$FG_INSTALL_DIR
  make -j2 install
  make -j2 install


Line 222: Line 225:
<u>Squeeze</u> users have to compile the CGAL dependency.
<u>Squeeze</u> users have to compile the CGAL dependency.
On <u>Wheezy</u> just install package "libcgal-dev" instead.
On <u>Wheezy</u> just install package "libcgal-dev" instead.
  cd $srcdir
  cd $FG_SRC_DIR
  wget https://gforge.inria.fr/frs/download.php/31174/CGAL-4.0.2.tar.bz2
  wget https://gforge.inria.fr/frs/download.php/31174/CGAL-4.0.2.tar.bz2
  tar xjf CGAL-4.0.2.tar.bz2
  tar xjf CGAL-4.0.2.tar.bz2
  mkdir $srcdir/build-cgal; cd $srcdir/build-cgal
  mkdir $FG_SRC_DIR/build-cgal; cd $FG_SRC_DIR/build-cgal
  cmake -D CMAKE_INSTALL_PREFIX:PATH="$prefix" $srcdir/CGAL-4.0.2
  cmake -D CMAKE_INSTALL_PREFIX:PATH="$FG_INSTALL_DIR" $FG_SRC_DIR/CGAL-4.0.2
  make -j2 install
  make -j2 install


<!--
<!--
  # gpc install
  # gpc install
  mkdir $srcdir/gpc232 && cd $srcdir/gpc232
  mkdir $FG_SRC_DIR/gpc232 && cd $FG_SRC_DIR/gpc232
  wget ftp://ftp.cs.man.ac.uk/pub/toby/gpc/gpc232-release.zip
  wget ftp://ftp.cs.man.ac.uk/pub/toby/gpc/gpc232-release.zip
  unzip gpc232-release.zip
  unzip gpc232-release.zip
  sed s/DBL_EPSILON/0.000001/ -i gpc.h
  sed s/DBL_EPSILON/0.000001/ -i gpc.h
  grep -A 18 '# Unix/Linux makefile' $srcdir/terragear-cs/README.gpc > Makefile
  grep -A 18 '# Unix/Linux makefile' $FG_SRC_DIR/terragear-cs/README.gpc > Makefile
  sed "s|/usr/local/lib|$prefix/lib|" -i Makefile
  sed "s|/usr/local/lib|$FG_INSTALL_DIR/lib|" -i Makefile
  sed "s|/usr/local/include|$prefix/include|" -i Makefile
  sed "s|/usr/local/include|$FG_INSTALL_DIR/include|" -i Makefile
  make -j2 install
  make -j2 install


  # newmat install
  # newmat install
  mkdir $srcdir/newmat11 && cd $srcdir/newmat11
  mkdir $FG_SRC_DIR/newmat11 && cd $FG_SRC_DIR/newmat11
  wget http://www.robertnz.net/ftp/newmat11.tar.gz
  wget http://www.robertnz.net/ftp/newmat11.tar.gz
  tar xzfv newmat11.tar.gz
  tar xzfv newmat11.tar.gz
  make -f nm_gnu.mak
  make -f nm_gnu.mak
  cp libnewmat.a $prefix/lib
  cp libnewmat.a $FG_INSTALL_DIR/lib
  mkdir $prefix/include/newmat
  mkdir $FG_INSTALL_DIR/include/newmat
  cp *.h $prefix/include/newmat
  cp *.h $FG_INSTALL_DIR/include/newmat
-->
-->
Compile TerraGear:
Compile TerraGear:
  cd $srcdir
  cd $FG_SRC_DIR
  git clone git://git.gitorious.org/fg/terragear.git
  git clone git://git.gitorious.org/fg/terragear.git
  mkdir $srcdir/build-tg; cd $srcdir/build-tg
  mkdir $FG_SRC_DIR/build-tg; cd $FG_SRC_DIR/build-tg
  cmake -D CMAKE_INSTALL_PREFIX:PATH="$prefix" $srcdir/terragear
  cmake -D CMAKE_INSTALL_PREFIX:PATH="$FG_INSTALL_DIR" $FG_SRC_DIR/terragear
  make -j2 install
  make -j2 install


Flughund
392

edits

Retrieved from "https://wiki.flightgear.org/Special:MobileDiff/62843"

Navigation menu