Development Environment
Currently, HoverRace only builds on Windows, using Microsoft Visual Studio 2010. All editions of Visual Studio 2010, including the free Visual C++ Express edition, are supported.
A native Linux port is planned for the HoverRace 2.0 timeframe, and portability is a high priority for current development. See ticket #20 and LinuxDevEnvironment.
Checking out the source code
See SVN for more information about how to check out the source code. The repository is at
svn://svn.igglybob.com/hoverrace/
Visual Studio .suo setup
Since the user-dependent .suo files are not included in the Subversion repository, The 'client' project should be set to the default build project. Everything else should work out of the box.
Library dependencies
In general, because of the hassle of building and installing development libraries in Windows environments, we provide some precompiled DLLs and headers in the Subversion checkout.
Exceptions are:
- Boost
- OpenAL SDK
- DirectX SDK
Boost
The Boost library is quite large. Until precompiled Boost libraries are available, you will need to compile Boost yourself.
Don't worry! It's not hard. Here's how: http://stackoverflow.com/questions/2629421/how-to-use-boost-in-visual-studio-2010/2655683#2655683
Once installed, you'll need to point Visual Studio at where you installed the Boost library:
- View -> Property Manager
- Open any of the projects, then any configuration, and double-click on the "Microsoft.Cpp.Win32.user" item.
- Select "VC++ Directories"
- In "Include Directories", add the folder for where Boost was installed (e.g. "C:\Program Files\boost\boost_1_43_0").
- In "Library Directories", add the "lib" folder under where Boost was installed (e.g. "C:\Program Files\boost\boost_1_43_0\lib").
OpenAL SDK
Creative Labs distributes a Windows installer for the OpenAL SDK:
http://connect.creativelabs.com/openal/Downloads/Forms/AllItems.aspx
However, the OpenAL SDK is not listed on that page, and as of September 2009, can be found here:
http://connect.creativelabs.com/openal/Downloads/OpenAL11CoreSDK.zip
Once installed, you'll need to point Visual Studio at where you installed the OpenAL SDK:
- View -> Property Manager
- Open any of the projects, then any configuration, and double-click on the "Microsoft.Cpp.Win32.user" item.
- Select "VC++ Directories"
- In "Include Directories", add the "include" folder under where the SDK was installed (e.g. "C:\OpenAL\include").
- In "Library Directories", add the "libs\Win32" folder under where the SDK was installed (e.g. "C:\OpenAL\libs\Win32").
DirectX SDK
Install the June 2010 DirectX SDK:
http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=3021d52b-514e-41d3-ad02-438a3ba730ba
(Note: The February 2010 release of the DirectX SDK will also probably work, but no guarantees).
Once installed (like Boost) you will need to tell Visual Studio where to find the DirectX SDK:
- View -> Property Manager
- Open any of the projects, then any configuration, and double-click on the "Microsoft.Cpp.Win32.user" item.
- Select "VC++ Directories"
- In "Include Directories", add the "Include" folder under where the SDK was installed (e.g. "D:\DirectX SDK\Include").
- In "Library Directories", add the "Lib\x86" folder under where the SDK was installed (e.g. "D:\DirectX SDK\Lib\x86").
