Building FlightGear - Windows: Difference between revisions

Jump to navigation Jump to search

Building FlightGear - Windows (view source)

Revision as of 12:32, 30 September 2008

99 bytes removed ,  30 September 2008
m
no edit summary
mNo edit summary
Line 1: Line 1:
__TOC__
'''NOTE: This page is a work in progress and is wrong. Use at your own peril. This notice will be removed when this page is ready.'''
'''NOTE: This page is a work in progress and is wrong. Use at your own peril. This notice will be removed when this page is ready.'''


This section describes how to build [[FlightGear]] on Windows using Visual C++ 2008 Express Edition (the "free" for personal use version). These procedures will be very similar if you have the full Visual Studio 2008 and mostly similar if you're using older versions of Visual C++.


 
Keep in mind that FlightGear is a large project with external dependencies and compiling it is not a task for novice users. If you just want to fly, we recommend you get the binary distribution and have fun. If you intend to get hip deep in the code, please proceed...
 
 
This section describes how to build FlightGear on Windows using Visual C++ 2008 Express Edition (the "free" for personal use version). These procedures will be very similar if you have the full Visual Studio 2008 and mostly similar if you're using older versions of Visual C++.
 
Keep in mind that FlightGear is a large project with external dependencies and compiling it is not a task for novice users. If you just want to fly, we recommend you get the binary distribution and have fun. If you intend to get hip deep in the code, please proceed...
 


== Requirements ==
== Requirements ==
Before you can compile FlightGear, you need to have the following installed on your computer:
Before you can compile FlightGear, you need to have the following installed on your computer:


'''C++ compiler'''
===C++ compiler===
 
You may [http://www.microsoft.com/express/download/#webInstall download] the Express ("free" for personal use) version of Visual C++ 2008 from Microsoft. C++ Builder and Turbo C++ Explorer (by CodeGear, formerly by Borland) should work as well with some effort. We have not tried this.
You may [http://www.microsoft.com/express/download/#webInstall download] the Express ("free" for personal use) version of Visual C++ 2008 from Microsoft. C++ Builder and Turbo C++ Explorer (by CodeGear, formerly by Borland) should work as well with some effort. We have not tried this.


You will also need the Platform SDK (Software Developer's Kit). ''Note: add instructions/link for that''
You will also need the Platform SDK (Software Developer's Kit). ''Note: add instructions/link for that''


'''CVS'''
===CVS===
 
FlightGear uses [[FlightGear CVS|CVS]] (Concurrent Versions System) for version control. You will need a CVS client to download the latest source code for both FlightGear and SimGear. Traditionally, these are command line tools, but TortoiseCVS provides a graphic interface for Windows users.  Download the installer for the latest stable version of [http://www.tortoisecvs.org/download.shtml TortoiseCVS], run the installer, using all of its default settings (the installation destination folder is up to you). It will ask you to restart the computer when it's finished <grumble>. Do that.
FlightGear uses CVS (Concurrent Versions System) for version control. You will need a CVS client to download the latest source code for both FlightGear and SimGear. Traditionally, these are command line tools, but TortoiseCVS provides a graphic interface for Windows users.  Download the installer for the latest stable version of [http://www.tortoisecvs.org/download.shtml TortoiseCVS], run the installer, using all of its default settings (the installation destination folder is up to you). It will ask you to restart the computer when it's finished <grumble>. Do that.


== Dependencies ==
== Dependencies ==
FlightGear is dependent on quite a few number of libraries.  You do not need to compile all of them yourself, but you will at least need to have their development version installed.
FlightGear is dependent on quite a few number of libraries.  You do not need to compile all of them yourself, but you will at least need to have their development version installed.


 
# Glut. Most distributions include glut packages, although you may have to hunt for them. Make sure you install both the glut and glut-devel packages, otherwise FlightGear may be able to compile but won't run correctly.
1. Glut. Most distributions include glut packages, although you may have to hunt for them. Make sure you install both the glut and glut-devel packages, otherwise FlightGear may be able to compile but won't run correctly.
# Zlib. Most distributions install the basic zlib libraries by default, but not the development portions. If you don't have zlib.h, you probably need to install the zlib-devel package for your distribution.  
 
# [[Plib]] - portability libraries and scene graph.  
2. Zlib. Most distributions install the basic zlib libraries by default, but not the development portions. If you don't have zlib.h, you probably need to install the zlib-devel package for your distribution.  
# [[OpenSceneGraph]]
 
# [[SimGear]] - Simulation support libraries. If you are building FlightGear from CVS, you need the CVS version of SimGear. If you have strange build errors, one of the first things to check is that you have an up-to-date version of SimGear built and installed.
3. Plib - portability libraries and scene graph.  
 
4. [[ OpenSceneGraph ]]
 
5. SimGear - Simulation support libraries. If you are building FlightGear from CVS, you need the CVS version of SimGear. If you have strange build errors, one of the first things to check is that you have an up-to-date version of SimGear built and installed.


== Compiling ==
== Compiling ==
=== Getting and compiling SimGear ===
=== Getting and compiling SimGear ===


'''Step 1:'''
====Step 1====
 
----
 
Navigate to the base folder for your FlightGear stuff; In this example, we've chosen "C:\FlightGear"
Navigate to the base folder for your FlightGear stuff; In this example, we've chosen "C:\FlightGear"


Line 55: Line 37:
At the "Module" section near the bottom of the "Module" tab, click the "Fetch List" button. You will see some brief action and may see an error and a prompt for a password. Enter "guest" for the password (without the quote symbols). From the drop-down "Module" list, select "source" and click the "OK" button to begin the checkout.
At the "Module" section near the bottom of the "Module" tab, click the "Fetch List" button. You will see some brief action and may see an error and a prompt for a password. Enter "guest" for the password (without the quote symbols). From the drop-down "Module" list, select "source" and click the "OK" button to begin the checkout.


'''Step 2:'''
====Step 2====
 
Since all the source code will be downloaded into a directory called '''source''', you will need to rename that directory to '''simgear'''.
Since all the source code will be downloaded into a directory called '''source''', you will need to rename that directory to '''simgear'''.


''NOTE: add instructions for compilation here''
''NOTE: add instructions for compilation here''


'''Step 3:'''
====Step 3====
 
''NOTE: add instructions for compilation here''
''NOTE: add instructions for compilation here''


''Note:'' with the default settings, Visual C++ will yield many compiler warnings. Unfortunately, this is normal.
''Note:'' with the default settings, Visual C++ will yield many compiler warnings. Unfortunately, this is normal.


=== Getting and compiling FlightGear ===
=== Getting and compiling FlightGear ===
 
====Step 1====
'''Step 1:'''
 
Make a base folder for your FlightGear stuff; In this example, we've chosen "C:\FlightGear"
Make a base folder for your FlightGear stuff; In this example, we've chosen "C:\FlightGear"


Line 83: Line 59:
A directory with the name '''source''' will then be created with all of Flightgear's source code downloaded into it. Rename this directory from '''source''' to '''flightgear'''.
A directory with the name '''source''' will then be created with all of Flightgear's source code downloaded into it. Rename this directory from '''source''' to '''flightgear'''.


'''Step 2:'''
====Step 2====
 
Next... make preparations for the compilation:
Next... make preparations for the compilation:


 
====Step 3====
'''Step 3:'''
 
Now you can compile and install Flightgear by:
Now you can compile and install Flightgear by:


==Checking out the FlightGear data==
==Checking out the FlightGear data==
The binary distribution package contains '''data''' for only a small subset of the existing aircraft and other objects. The instructions below tell you how to obtain the full set of data, in their latest, greatest form.
The binary distribution package contains '''data''' for only a small subset of the existing aircraft and other objects. The instructions below tell you how to obtain the full set of data, in their latest, greatest form.


Line 108: Line 80:


== External links ==
== External links ==
=== Instructions ===
* [http://www.oflebbe.de/oflebbe/FlightGear/index.html MSVC8 aka Visual 2005]
* [http://www.oflebbe.de/oflebbe/FlightGear/index.html MSVC8 aka Visual 2005]


{{Building}}
{{Building}}
''If you are lost see [[Portal:User]] or [[Portal:Developer]]''
Retrieved from "https://wiki.flightgear.org/Special:MobileDiff/7786"

Navigation menu