[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

2.4.3 Windows using MinGW

Written by Eric Sunshine, sunshine@sunshineco.com. Originally written by Philip Wyett, philipwyett@dsl.pipex.com. Last updated 7 February 2003.

These instructions are for building Crystal Space with MinGW, the Minimalist GNU compiler for Windows.

http://www.mingw.org/

Necessary Resources

Download the following packages:

Installation

Follow these instructions to install the packages which you downloaded. Be sure to install them in the order shown.

Note: If you ever install a new version of MSYS, then you must also re-install the `csmingwlibs' package.

Building Crystal Space

You must configure and build Crystal Space from within the MSYS shell environment. To launch this environment, click on the MSYS icon which the installation procedure placed upon your desktop, or choose the MSYS item from the Programs menu. This will launch a Unix-like shell window into which you type commands.

From this shell, go to your `CS' directory with the `cd' command. For example, if Crystal Space resides at `C:\work\CS', invoke the command `cd /c/work/CS'. Next, build the project with the following sequence of commands:

 
./configure
make depend
make -k all

Note that the `depend' target is optional and can be omitted if you do not plan to make any changes to the Crystal Space source or header files.

The `-k' option used in `make -k all' instructs the `make' utility to ignore errors and continue building the project. This may be necessary in cases where some Crystal Space modules require resources not installed on your computer and not included with `csmingwlibs'. It may also be necessary if you are using the bleeding-edge version of Crystal Space from the CVS repository, and some module fails to build correctly.

If you prefer to build a debug version of Crystal Space, substitute the following commands for those shown above:

 
./configure --enable-debug
make depend
make -k all

Additional Build Options

Sometimes it is a good idea to remove all of the built programs and executable files and start from scratch. You can do this with the following commands:

 
make clean
make -k all

Once in a while it is even a good idea to completely clean and re-configure the project. This may be required if you are using the bleeding-edge version of Crystal Space from the CVS repository after some radical change.

 
make distclean
./configure
make depend
make -k all

Troubleshooting

If you successfully compiled Crystal Space, yet find that you can not run the applications from the `CS\' root directory, a possible cause might be that the pathname leading up to the `CS\' directory might have embedded whitespace. For instance, if you installed the project in `C:\my stuff\CS', try renaming the path to `C:\my_stuff\CS' or `C:\mystuff\CS'.

Blasting the Past

If you were previously using the older, deprecated `cs_mingw_0.??.exe' package which contained the entire MinGW distribution along with other unrelated tools and resources, it is highly recommend that you first remove that package, as well as any residual files and resources before installing the newer MinGW, MSYS, and `csmingwlibs' packages. For best results, it would probably be wise to remove the entire old `MinGW' directory (though you may want to make a backup copy of it just in case) and clean your environment variables of any references to the old resource directories.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

This document was generated using texi2html