Compiling with Microsoft Visual C++ (OpenXcom)

2013-05-08T21:42:58Z

Xrabohrok: /* Installing dependencies */

== Getting the source ==

You will need a Windows Git client to grab the latest source code.

=== TortoiseGit ===

# Install [http://code.google.com/p/msysgit Git for Windows]. When asked, select '''Use Git Bash only''', '''Use OpenSSH''' and '''Checkout Windows-style, commit Unix-style line endings'''.
# Install [http://code.google.com/p/tortoisegit/ 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.

=== Git Extensions ===

# Install [http://code.google.com/p/gitextensions/ Git Extensions] for your system.
# TODO

== Installing dependencies ==

Put the required library files in a '''deps''' folder inside the codebase folder(above the src folder) with the following structure:
* '''deps\include\SDL''' - SDL headers
* '''deps\include\yaml-cpp''' - yaml-cpp headers
* '''deps\lib\Win32''' - library x86 DLL and LIB files
* '''deps\lib\x64''' - library x64 DLL and LIB files

Alternatively, you can grab the [http://openxcom.org/download/dev/openxcom-deps-win-vc.zip 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 [http://www.microsoft.com/visualstudio/en-us/products/2010-editions/visual-cpp-express 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.
# Compile and run the project by pressing the '''Start Debugging''' button with a green arrow on the top toolbar.
# See the [http://msdn.microsoft.com/library/dd831853.aspx Visual Studio Documentation] for more information on the IDE.

== FAQ ==

'''Q: I get a Failed To Load Palette error.'''<br>
A: Copy the X-Com resources to your '''bin''' folder, see [[Installing (OpenXcom)|Installing]] for more details.

'''Q: I get an error about afxres.h not being found.'''<br>
A: You're using a Visual C++ Express Edition which doesn't support Resource files, just remove '''resource.h''' and '''OpenXcom.rc''' from the project.

'''Q: I get an error about MSVCR100.DLL not being found.'''<br>
A: You're using the pre-built dependencies with an old Visual C++ version so you need to install the [http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=5555 VC++ 2010 Redist].

'''Q: I get a warning about Platform 'x64' cannot be found.'''<br>
A: You're using a Visual C++ Express Edition which doesn't support x64 builds, but you can still compile for Win32.

[[Category:OpenXcom]]

UFOpaedia - User contributions [en]

Compiling with Microsoft Visual C++ (OpenXcom)