Building FlightGear - Debian: Difference between revisions

prepared for 2.0.0 - not finished because of missing data
m (new language options)
(prepared for 2.0.0 - not finished because of missing data)
Line 1: Line 1:
= HowTo build on Debian checklist =
= HowTo build on Debian =


HowTo build FG-CVS (and also 1.9.1) on Etch and Lenny.
HowTo build FlightGear 2.0.0 or CVS on GNU/Linux Debian '''Stable''' 5.x (Lenny).


Eine deutsche Version dieses HowTos findet man im http://wiki.debianforum.de/FlightgearOnEtch.
This HowTo may also work with '''Testing'''/'''Unstable''' except that some things are easier because of more up to date packages. So, before fetching something check the version of the available -dev package for it.


If you don't want to make your hands dirty, have a look at this: http://wiki.flightgear.org/index.php/Scripted_Compilation_on_Linux_Debian/Ubuntu
It even *should* work with '''Etch''', but I am not certain about some dependencies. [http://wiki.flightgear.org/index.php?title=Talk:Building_Flightgear_-_Debian&action=edit Reports] are welcome.
 
If you don't want to make your hands dirty, have a look at [[Scripted_Compilation_on_Linux_Debian/Ubuntu]].




Line 14: Line 16:
*gcc, g++, make, automake1.9
*gcc, g++, make, automake1.9
*mawk (or gawk)
*mawk (or gawk)
*cmake  min. version 2.6.0-5,  for Etch available on backports.org!
*cmake  (min. version 2.6.0-5,  for Etch available on backports.org!)
*cvs, subversion
*cvs, subversion
<!--*libsvn-dev, for [[Terrasync]]s proper operation.-->
*freeglut3-dev, libgl1-mesa-dev, libxrandr-dev
*freeglut3-dev, libgl1-mesa-dev, libxrandr-dev
*libxi-dev, libxmu-dev, libxext-dev
*libxi-dev, libxmu-dev, libxext-dev
*libopenal-dev, libalut-dev
*libopenal-dev (see [[#libopenal|libopenal]]), libalut-dev
*libjpeg62-dev, libtiff4-dev, zlib1g-dev
*libjpeg62-dev, libtiff4-dev, libpng12-dev
*libboost1.35-dev   for Etch available on backports.org!
*libboost1.37-dev (Not available for Lenny atm, see [[#Boost Library|Boost Library]] below.)


During installation packages ''simgear-dev'' and ''openscenegraph-dev'' *must not* be installed. They can safely be re-installed after compilation.
During installation packages ''simgear-dev'' and ''openscenegraph-dev'' *must not* be installed. They can safely be re-installed after compilation.


==== Add backports.org repository ====
(only needed on Etch)


'''hardcore:''' add this line to /etc/apt/sources.list:
== Build and install ==
  deb http://ftp.de.debian.org/backports.org/ etch-backports main contrib
Because we are going to install versions different to the ones in the repositries it is recommended to install FG-2.0.0 and/or CVS in a place independet to the base system such as /usr/local/FG-2.0.0, /opt/FG-2.0.0 or in a subdirectory of your $HOME. I suggest to make it writeable by the user that there is no need to become root for the 'make install' commands. I'll use <code>$prefix</code> as a placeholder for this directory.
 
Another one will be <code>$srcdir</code>, it stands for the absolute path to the directory which contains the folders of the various source codes. So in the following instructions one have to replace it by the local path.
 
Subsequent the instructions to fetch the sources and the data needed by FG and the commands to build/install each source.
 
Have in mind that the data is relatively huge (CVS about 2 GB and 2.0.0 xxx MB) so, to save some time, it is a good idea to fetch it while building the sources.
 
 
=== libopenal ===
The libopenal-dev package in Lenny/Etch is too old for fgcom. For FG it does work but not all features (like Doppler) are avaiable, so installing an up to date version is recommended anyway. Get the latest source from http://connect.creativelabs.com/openal/Downloads/Forms/AllItems.aspx (file openal-soft-[version]) and extract it into <code>$srcdir</code>.
 
cd $srcdir/openal-soft-[version]/build
cmake  -D CMAKE_INSTALL_PREFIX:PATH="$prefix" ..
make install
 
 
=== plib ===
Version 1.8.5 is needed, packages are available for Testing/Unstable, plib1.8.5-dev. Lenny/Etch users have to compile and install it:
  cd $srcdir
wget http://plib.sourceforge.net/dist/plib-1.8.5.tar.gz
tar xzf plib-1.8.5.tar.gz
cd plib-1.8.5
./configure --prefix=$prefix
make install


'''Synaptic:'''
Binaries (deb)
Address:      http://ftp.de.debian.org/backports.org/
Distribution:  etch-backports
Section(s):    main contrib


Do not forget to update after adding! <BR>
=== Boost Library ===
More mirrors can be found on: http://www.backports.org/debian/README.mirrors.html
Version 1.37 is needed. At least for Lenny/Etch this means getting the sources because this is not available atm on backports.org. Testing/Unstable users may have more luck and a package is available, libboost-1.37-dev or newer.


To build SimGear, FlightGear, fgrun and fgcom some boostlib header files are required, no need to compile and install it. If you have installed a libboost1.37-dev (or highter) package on your system you don't have to bother at all with it. If not, you have to tell each ./configure where the header files are. To do so, add the option <code>CPPFLAGS=-I$prefix/include</code> to the SimGear, FlightGear and fgrun <code>./configure</code> commands. We copy the header files to $prefix/include because fgcom will need them there.


== Fetch the Sources ==
Get a tar ball from http://sourceforge.net/projects/boost/files/boost/, extract it into <code>$srcdir</code> then:
cp -R $srcdir/boost-[version]/boost $prefix/include


'''plib'''<BR>
No need to fetch it by CVS because there was no update for a long time...<BR>
http://plib.sourceforge.net/dist/plib-1.8.5.tar.gz <BR>
http://plib.sourceforge.net/download.html


=== OpenSceneGraph ===
For FlightGear 2.0.0 one may use the latest developer release from http://www.openscenegraph.org/projects/osg/wiki/Downloads/DeveloperReleases (extract into <code>$srcdir</code>).<BR>
Mostly this is ok for FlightGear CVS as well as it is stable. However, sometimes the release is not fresh enough and one have to get the latest developments via SVN:
cd $srcdir
svn co http://www.openscenegraph.org/svn/osg/OpenSceneGraph/trunk OpenSceneGraph
cmake demands a build directory separate to its source directory. So <code>mkdir</code> one and <code>cd</code> into it.
cmake -D CMAKE_BUILD_TYPE="Release" -D CMAKE_CXX_FLAGS="-O3" -D CMAKE_C_FLAGS="-O3" \
    -D CMAKE_INSTALL_PREFIX:PATH="$prefix" $srcdir/OpenSceneGraph[-version]
make install


'''OpenSceneGraph'''<BR>
For CVS one may use the latest developer release (for FG 1.9.1 OSG 2.7.8 is known to work):<BR>
http://www.openscenegraph.org/projects/osg/wiki/Downloads/DeveloperReleases<BR>
or fetch it via SVN:
svn checkout http://www.openscenegraph.org/svn/osg/OpenSceneGraph/trunk OpenSceneGraph


=== SimGear ===
2.0.0:
cd $srcdir
wget ftp://ftp.simgear.org/pub/simgear/Source/SimGear-....tar.gz
tar ...
cd ...


'''SimGear''' <BR>
CVS:
1.9.1: ftp://ftp.simgear.org/pub/simgear/Source/SimGear-1.9.1.tar.gz <BR>
cd $srcdir
or CVS: <BR>
mkdir simgear
cd simgear
  cvs -d :pserver:cvsguest@cvs.simgear.org:/var/cvs/SimGear-0.3 login
  cvs -d :pserver:cvsguest@cvs.simgear.org:/var/cvs/SimGear-0.3 login
  #CVS passwd: guest
  #CVS passwd: guest
  cvs -d :pserver:cvsguest@cvs.simgear.org:/var/cvs/SimGear-0.3 co source
  cvs -d :pserver:cvsguest@cvs.simgear.org:/var/cvs/SimGear-0.3 co source
cd source


2.0.0 and CVS:
./autogen.sh
./configure --prefix=$prefix [CPPFLAGS=-I$prefix/include]
make install


'''FlightGear source'''<BR>
 
1.9.1: http://www.very-clever.com/download/flightgear/Source/ <BR>
=== FlightGear source ===
or CVS:<BR>
2.0.0:
cd $srcdir
wget http://www.very-clever.com/download/flightgear/Source/
tar xjf ...
cd ...
 
CVS:
cd $srcdir
mkdir flightgear
cd flightgear
  cvs -d :pserver:cvsguest@cvs.flightgear.org:/var/cvs/FlightGear-0.9 login
  cvs -d :pserver:cvsguest@cvs.flightgear.org:/var/cvs/FlightGear-0.9 login
  #CVS passwd: guest
  #CVS passwd: guest
  cvs -d :pserver:cvsguest@cvs.flightgear.org:/var/cvs/FlightGear-0.9 co source
  cvs -d :pserver:cvsguest@cvs.flightgear.org:/var/cvs/FlightGear-0.9 co source
cd source


'''FlightGear data''' <BR>
2.0.0 and CVS:
1.9.1: http://www.very-clever.com/download/flightgear/Shared/FlightGear-data-1.9.0.tar.bz2 <BR>
./autogen.sh
or CVS: <BR>
./configure --prefix=$prefix [--with-openal=$prefix] [CPPFLAGS=-I$prefix/include/]
cvs -d :pserver:cvsguest@cvs.flightgear.org:/var/cvs/FlightGear-0.9 co data
make install


While data (CVS: ~ 2 GB / 1.9.1: 230 MB) gets downloaded we have plenty of time to...


=== FlightGear data ===
2.0.0:
cd $prefix/share
wget http://www.very-clever.com/download/flightgear/Shared/FlightGear-data-...
tar xjf ...
CVS:
cd $prefix/share
cvs -d :pserver:cvsguest@cvs.flightgear.org:/var/cvs/FlightGear-0.9 co data


== Build and install ==
=== Trial run ===
Because we are going to install versions different to the ones in the repositries it is hardly recommended to install FG-CVS in a place independet to the base system such as /usr/local/fg-cvs, /opt/fg-cvs or in a subdirectory of your $HOME. I suggest to make this directory writeable by the user that there is no need to become root for the 'make install' commands. I'll use ''$prefix'' as a placeholder for this, so in the following instructions one have to replace it by the local path.
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
$prefix/bin/fgfs --fg-root=$prefix/share/data


Subsequent the commands to build each source. Execute them in the according source directory, except for OSG.
For the furure, 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]].


'''plib'''
./configure --prefix=$prefix
make
make install


== Optional Software ==


'''OpenSceneGraph'''<BR>
=== fgrun ===
Here you'll encounter another placeholder ''$osgsrcdir'' which has to be replaced by path of the OSG source directory. This is because cmake demands a build directory separate to its source directory. So 'mkdir' one and 'cd' into it.
To build [[ fgrun ]] one more package is required:
cmake -D CMAKE_BUILD_TYPE="Release" -D CMAKE_CXX_FLAGS="-O3" -D CMAKE_C_FLAGS="-O3" \
*libfltk1.1-dev
    -D CMAKE_INSTALL_PREFIX:PATH="$prefix" $osgsrcdir
make
make install


  export LD_LIBRARY_PATH=$prefix/lib:$LD_LIBRARY_PATH
  cd $srcdir
svn co http://fgrun.svn.sourceforge.net/svnroot/fgrun/trunk fgrun
cd fgrun


'''SimGear'''
  ./autogen.sh
  ./autogen.sh
  ./configure --prefix=$prefix --with-jpeg-factory
  ./configure --prefix=$prefix [CPPFLAGS=-I$prefix/include/]
make
  make install
  make install


'''FlightGear'''
./autogen.sh
./configure --prefix=$prefix
make
make install


=== fgcom ===
For [[FGCOM|fgcom]] unfortunately there is one more dependency which cannot be solved with packages on Lenny/Etch, see [[#libopenal|libopenal]].
cd $srcdir
svn co https://appfgcom.svn.sourceforge.net/svnroot/fgcom/trunk fgcom
cd fgcom/src
make INSTALL_BIN=$prefix/bin INSTALL_DIR=$prefix/fgcom \
    PLIB_PREFIX=$prefix OPENAL_PREFIX=$prefix install


'''Trial run:'''
export LD_LIBRARY_PATH=$prefix/lib:$LD_LIBRARY_PATH
$prefix/bin/fgfs --fg-root=/path/to/data


== Keeping the CVS version up to date ==


== fgrun ==
...to be continued. ;-)
To build [[ fgrun ]] some more packages are required:
*libfltk1.1-dev
*fluid


Fetch the source:
svn co http://fgrun.svn.sourceforge.net/svnroot/fgrun/trunk fgrun


Build it: <BR>
''$prefix'' like above
./autogen.sh
./configure --prefix=$prefix
make
make install


{{Building}}
{{Building}}


[[de:FlightGear_bauen_-_Debian]]
[[de:FlightGear_bauen_-_Debian]]
392

edits