How to Build Aerosol on Windows

/!\ This page is a work in progress. Unfortunately, I have put off documenting this long enough that the details are sketchy. I am taking the approach of creating a more generic page and filling in details later, in attempt to make this page at least somewhat useful. I will have to try the setup from scratch once these instructions are done.

There are three main steps to building Aerosol (or most pieces of software, really)

1. Setup the Build Environment - MinGW and MSys
2. Build or Install Dependencies - Ruby, OpenGL, OpenAL, SDL, etc.
• Note to self: Check with Scott about exact deps again
3. Build Aerosol

Setup Environment

Aerosol is written in C99, so Microsoft's Visual C compiler cannot be used. Instead, we use GCC, in this case provided by MinGW.

Install MinGW

Download the MinGW installer from SourceForge. Choose the "Automated MinGW Installer" package. MinGW v5.1.3 was used for this build.

Install MinGW to C:\MinGW

See MinGW Downloads for more information about MinGW.

Install MSys

Download the MSys installer.

Install to C:\MSys

Build/Install Dependencies

Ruby

See http://ruby-gnome2.sourceforge.jp/hiki.cgi?compile_mingw#Compile+Guide+for+MS+Windows+%28mswin32%2C+mingw32%29

OpenGL

The headers/libraries for OpenGL that Windows supports (GL 1.1) come with MinGW.

See http://www.opengl.org/wiki/index.php/Getting_started

OpenAL

This is a little not obvious because development files are not provided for MinGW. However, recent versions of MinGW support the VC .lib format. Install the OpenAL development package provided by Creative. Copy the header files into include/AL and the library files into lib.

SDL

See http://www.netadelica.com/coding/sdl/install.html See http://blog.pantokrator.net/2006/08/08/setting-up-msysmingw-build-system-for-compiling-sdlopengl-applications/

zlib

See http://blog.pantokrator.net/2006/08/13/compiling-sdl_image-with-msysmingw/

libPNG

See http://blog.pantokrator.net/2006/08/13/compiling-sdl_image-with-msysmingw/

libJPEG

See http://blog.pantokrator.net/2006/08/13/compiling-sdl_image-with-msysmingw/

SDL_image (?)

See http://blog.pantokrator.net/2006/08/13/compiling-sdl_image-with-msysmingw/

libOgg

See http://wiki.scummvm.org/index.php/Compiling_ScummVM/MinGW

libVorbis

See http://wiki.scummvm.org/index.php/Compiling_ScummVM/MinGW See http://www.hydrogenaudio.org/forums/index.php?showtopic=45488

Build Aerosol

There is a non-rake (so that rake is not another dep) ruby file for compiling Aerosol in Windows. Just run "ruby make_win32.rb" from the Aerosol source root directory.