Compiling Uplink with MS Developer Studio


This guide is intended to get you up and running with the Uplink Dev CD as quickly as possible. It will show you how to get Uplink to compile on your PC, using Microsoft Visual C++ 6.0. We will be assuming you have some knowledge at least of compilers, C++ etc.


1. Follow the Getting Started guide

This ensures your have Uplink and the Dev Studio installed in the right places. Click here.


2. Apply Patch

The Developer CD does have a couple of bugs in it amazingly...a couple of the projects have some linker problems. Download this zip file and extract it over the top of your Uplink directory. It replaces the project files for lib/gucci and lib/soundgarden.


2. Prepare project file

Load the workspace uplink/source/uplink.dsw into Developer Studio. We used version 6.0, but you shouldn't have any problems with any other versions. You should see all of our internal libraries listed in your workspace, as well as the Uplink project itself. Make sure Uplink is the currently active project.

We need to tell Developer Studio where the base directory is for the Uplink source code. Bring up the project settings dialog (project->settings) and select the project "Uplink". Click the "C/C++" tab and select the "Preprocessor" category from the drop down menu. There should be a box that says "Additional Include Directories". Currently it will say something like "C:\Development\UplinkDevCD\source", plus a bunch of other library directories. You need to change that first location to point to your Uplink source directory, eg "C:\games\Uplink\source".

Put DevStudio into FileView mode (use the tab at the bottom of the Workspace window). Open the Lib folder. You'll see a bunch of libs that are included as part of the build. The files glu32.lib and opengl32.lib currently link to the location C:\Program Files\Microsoft Visual Studio\VC98\Lib\. If you've installed Visual Studio there then great, otherwise you'll need to remove these files and re-add them from wherever you have installed Visual Studio. The files can be found in its VC98\lib directory.

Click Ok, cross your fingers, and press F7 to build everything. The compiler will now build all of the support libraries in sequence, followed by Uplink itself. The whole process takes about ten minutes on my computer.


3. Running your new Exe

The compiler will have replaced your uplink.exe file with the newly compiled one. Just run the new Uplink.exe as normal from your Uplink directory. If you are preparing a patch you might want to generate different filenames to avoid clashing with other people's exes, eg "Uplink_MyNewPatch.exe". That way people will be able to have different patches in operation at once.