Compiling with Microsoft Visual C++ (OpenXcom)
Getting the source
You will need a Windows Git client to grab the latest source code.
- Install Git for Windows. When asked, select Use Git Bash only, Use OpenSSH and Checkout Windows-style, commit Unix-style line endings.
- Install TortoiseGit. Restart the computer if asked.
- Configure TortoiseGit by right-clicking any folder and selecting TortoiseGit > Settings. Select Git > Config, fill out your Username and E-mail as will be displayed in your commits, and make sure AutoCrlf and SafeCrlf are checked.
- Go to the folder where you wanna put the code, right-click on it and select Git Clone.
- Fill out the Url to the repository (the official one or your own fork), check the Directory is correct and press OK. Better get a drink, it's gonna be a while.
- In the future, you can stay up to date by right-clicking your folder and selecting Git Sync to Pull the latest code.
- Install Git Extensions for your system.
Put the required library files in a deps folder inside the codebase folder with the following structure:
- deps\include\SDL - SDL headers
- deps\include\yaml-cpp - yaml-cpp headers
- deps\lib - library DLL and LIB files
Alternatively, you can grab the pre-compiled dependencies with all the files already in place, and extract it to your codebase folder.
Compiling and running
- Install Microsoft Visual C++ (part of Visual Studio). If you don't have it, you can get VC++ 2010 Express Edition for free.
- Go to the src subfolder inside your codebase folder and open OpenXcom.2010.sln if you have VC++ 2010 or OpenXcom.2008.sln if you have VC++ 2008. You might get issues using older versions, but you can try just editing the version number in OpenXcom.2008.sln and OpenXcom.2008.vcproj to match.
- Right-click the OpenXcom project file and select Properties.
- Pick All Configurations, go to Debugging and replace the Working Directory with ..\bin.
- Compile and run the project by pressing the Start Debugging button with a green arrow on the top toolbar.