392
edits
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. | 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. | 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>$ | 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 | export FG_INSTALL_DIR=$HOME/FG-2.12 && mkdir $FG_INSTALL_DIR | ||
export | export FG_SRC_DIR=$HOME/src && mkdir $FG_SRC_DIR | ||
Have in mind that the data is a relatively large download (GIT | 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 $ | 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=$ | ./configure --enable-shared --prefix=$FG_INSTALL_DIR | ||
make -j2 install | make -j2 install | ||
=== [[plib]] === | === [[plib]] === | ||
<u>2. | <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 $ | cd $FG_SRC_DIR | ||
svn co https:// | 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=$ | ./configure --prefix=$FG_INSTALL_DIR | ||
make -j2 install | make -j2 install | ||
=== [[OpenSceneGraph]] === | === [[OpenSceneGraph]] === | ||
On <u>Wheezy</u> skip that step and install package "libopenscenegraph-dev" instead. <br /> | |||
<u>GIT</u> users, especially developers, | Last version known to work for 2.12 is OpenSceneGraph 3.1.4. <br /> | ||
<u>2. | <!-- | ||
cd $ | <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 | --> | ||
<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="$ | -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. | <u>2.12</u> and <u>GIT</u>: | ||
cd $ | cd $FG_SRC_DIR | ||
git clone git://mapserver.flightgear.org/simgear | git clone git://mapserver.flightgear.org/simgear simgear.git | ||
<u>2. | <u>2.12</u> only: | ||
cd simgear | cd simgear.git | ||
git checkout -b 2. | git checkout -b 2.12 origin/release/2.12.0 | ||
<u>2. | <u>2.12</u> and <u>GIT</u>: | ||
mkdir $ | mkdir $FG_SRC_DIR/build-sg; cd $FG_SRC_DIR/build-sg | ||
cmake -D CMAKE_INSTALL_PREFIX:PATH="$ | 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. | <u>2.12</u> and <u>GIT</u>: | ||
cd $ | cd $FG_SRC_DIR | ||
git clone git://mapserver.flightgear.org/flightgear | git clone git://mapserver.flightgear.org/flightgear flightgear.git | ||
<u>2. | <u>2.12</u> only: | ||
cd flightgear | cd flightgear.git | ||
git checkout -b 2. | git checkout -b 2.12 origin/release/2.12.0 | ||
<u>2. | <u>2.12</u> and <u>GIT</u>: | ||
mkdir $ | mkdir $FG_SRC_DIR/build-fg; cd $FG_SRC_DIR/build-fg | ||
cmake -D CMAKE_INSTALL_PREFIX:PATH="$ | 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. | <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 $ | cd $FG_INSTALL_DIR | ||
wget http://mirrors.ibiblio.org/pub/mirrors/flightgear/ftp/Shared/FlightGear-data-2. | wget http://mirrors.ibiblio.org/pub/mirrors/flightgear/ftp/Shared/FlightGear-data-2.12.0.tar.bz2 | ||
tar xjf FlightGear-data-2. | 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 $ | 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=$ | export LD_LIBRARY_PATH=$FG_INSTALL_DIR/lib/:$LD_LIBRARY_PATH | ||
$ | $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>$ | : 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 $ | 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]] | 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 $ | 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=$ | ./configure --prefix=$FG_INSTALL_DIR --with-fgbase=$FG_INSTALL_DIR/data | ||
make -j2 install | make -j2 install | ||
cp -R $ | 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--> | ||
$ | $FG_INSTALL_DIR/bin/Atlas | ||
=== fgcom === | === fgcom === | ||
For [[fgcom]] install package "libasound2-dev". | For [[fgcom]] install package "libasound2-dev". | ||
cd $ | 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=$ | make -j2 install_BIN=$FG_INSTALL_DIR/bin INSTALL_DIR=$FG_INSTALL_DIR/fgcom \ | ||
PLIB_PREFIX=$ | 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 $ | 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 $ | mkdir $FG_SRC_DIR/build-fgrun; cd $FG_SRC_DIR/build-fgrun | ||
cmake -D CMAKE_INSTALL_PREFIX:PATH="$ | 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=$ | export LD_LIBRARY_PATH=$FG_INSTALL_DIR/lib/:$LD_LIBRARY_PATH | ||
$ | $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 $ | 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=$ | ./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 $ | 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 $ | mkdir $FG_SRC_DIR/build-cgal; cd $FG_SRC_DIR/build-cgal | ||
cmake -D CMAKE_INSTALL_PREFIX:PATH="$ | 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 $ | 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' $ | grep -A 18 '# Unix/Linux makefile' $FG_SRC_DIR/terragear-cs/README.gpc > Makefile | ||
sed "s|/usr/local/lib|$ | sed "s|/usr/local/lib|$FG_INSTALL_DIR/lib|" -i Makefile | ||
sed "s|/usr/local/include|$ | sed "s|/usr/local/include|$FG_INSTALL_DIR/include|" -i Makefile | ||
make -j2 install | make -j2 install | ||
# newmat install | # newmat install | ||
mkdir $ | 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 $ | cp libnewmat.a $FG_INSTALL_DIR/lib | ||
mkdir $ | mkdir $FG_INSTALL_DIR/include/newmat | ||
cp *.h $ | cp *.h $FG_INSTALL_DIR/include/newmat | ||
--> | --> | ||
Compile TerraGear: | Compile TerraGear: | ||
cd $ | cd $FG_SRC_DIR | ||
git clone git://git.gitorious.org/fg/terragear.git | git clone git://git.gitorious.org/fg/terragear.git | ||
mkdir $ | mkdir $FG_SRC_DIR/build-tg; cd $FG_SRC_DIR/build-tg | ||
cmake -D CMAKE_INSTALL_PREFIX:PATH="$ | cmake -D CMAKE_INSTALL_PREFIX:PATH="$FG_INSTALL_DIR" $FG_SRC_DIR/terragear | ||
make -j2 install | make -j2 install | ||
edits