How to build the Windows version

(Instructions for Compiling)
 
(7 intermediate revisions not shown)
Line 1: Line 1:
-
This page describes the build and packaging process on windows. You need Visual Studio 11 or higher, the free express version works fine. VS 2010 and earlier are unsupported (though you can use VS 2010 if you either disable USE_WIIUSE, or set the (advanced) option BUILD_WIIUSE).
+
This page describes the build and packaging process on Windows. You need Visual Studio 2013 (or higher), the free express version works fine. Visual Studio Community, a free version that is licensed for open-source projects, can be found [https://www.dreamspark.com/Product/Product.aspx?productid=89 here]. VS 2012 and earlier do not compile STK anymore. You have to follow the instructions in order – later steps will not work unless previous steps are completed.
=== Instructions for Compiling ===
=== Instructions for Compiling ===
-
* Install VS 2012 or later. The free express versions work fine.
+
* Install VS 2013 or later. The free express versions work fine. Visual Studio Community, a free version that is licensed for open-source projects, can be found [https://www.dreamspark.com/Product/Product.aspx?productid=89 here].
-
* Download and install a source package - either a released package or from our [http://supertuxkart.sourceforge.net/Source_control git/svn repositories].
+
* Download and install a source package - either a released package or from our [http://supertuxkart.sourceforge.net/Source_control git/svn repositories]. You can use [https://windows.github.com GitHub for Windows] to do this step.
-
* Download the latest dependency package depdendencies_for_0.8.2.zip from [https://sourceforge.net/projects/supertuxkart/files/SuperTuxKart%20Dependencies/Windows/ here]. Unzip it in the root directory, so that the dependencies directory is next to the src and data directory (if you are updating from a previous dependency package, you can delete the .dll files in the root directory, they are not needed anymore).
+
* Download the latest dependency package, depdendencies_for_0.9.2.zip from [http://sourceforge.net/projects/supertuxkart/files/SuperTuxKart%20Dependencies/Windows/dependencies_for_0.9.2.zip/download here]. Unzip it in the root directory, so that the dependencies directory is next to the src and data directory (if you are updating from a previous dependency package, you can delete the .dll files in the root directory, they are not needed anymore).
-
* Download [http://www.cmake.org cmake] and install it. Then start cmake-gui and select the STK root directory as 'Where is the source code', and a new directory in the root directory (next to src, data etc) as build directory (for now I assume that this directory is called bld).
+
* Download the latest assets. You can use [http://www.sliksvn.com/en/download svn] or [http://tortoisesvn.net/downloads.html tortoisesvn]. Run this command in the folder where you want to put SuperTuxKart (needs to be right beside the git/svn repository you cloned in the second step). <code>svn checkout https://svn.code.sf.net/p/supertuxkart/code/stk-assets stk-assets</code> These two repositories should be downloaded in the same folder, so that folders "stk-code" and "stk-assets" are next to each other.
-
* Click on configure. You will be asked to create the directory (yes), then for your VS version. Make sure to select the right version (be aware of the easy to confuse version numbers: VS 2012 = version 11; VS 2013 = version 12). Click on configure, then generate. This will create the directory 'bld', and a VS solution in that directory.
+
* Download [http://www.cmake.org cmake] and install it. Then start cmake-gui and select the STK code directory (stk-code by default) as 'Where is the source code', and a new directory in the root directory (next to src, data etc) as build directory. Use a folder name “bld” or “build” (for now I assume that this directory is called bld).
-
* In Visual Studio open the project file generated in the 'bld' folder
+
* Click on configure. You will be asked to create the directory (yes), then for your VS version. Make sure to select the right version (be aware of the easy to confuse version numbers: VS 2013 = version 12). Click on configure, then generate. This will create the directory 'bld', and a VS solution in that directory.
 +
* In Visual Studio open the project file generated in the 'bld' folder. Make sure to compile for 32-bit (64-bit compilation is not supported atm).
 +
* In the upper set of toolbars, select the dropdown menu for Solution Configurations and select “Release.” If you are a developer, you might want to use the “debug” configuration, but it does have decreased performance.
* Right click on the supertuxkart project in the solution explorer, and select "Set as StartUp Project".
* Right click on the supertuxkart project in the solution explorer, and select "Set as StartUp Project".
* Select Build->Build Solution (or press F7) to compile.
* Select Build->Build Solution (or press F7) to compile.
You can also start STK from the command line: change into STK's root directory, and do:
You can also start STK from the command line: change into STK's root directory, and do:
-
./bld/Debug/supertuxkart.exe
+
./bld/Release/supertuxkart.exe
=== Instructions for Creating the Installer ===
=== Instructions for Creating the Installer ===

Latest revision as of 02:03, 23 October 2015

This page describes the build and packaging process on Windows. You need Visual Studio 2013 (or higher), the free express version works fine. Visual Studio Community, a free version that is licensed for open-source projects, can be found here. VS 2012 and earlier do not compile STK anymore. You have to follow the instructions in order – later steps will not work unless previous steps are completed.

Instructions for Compiling

You can also start STK from the command line: change into STK's root directory, and do: ./bld/Release/supertuxkart.exe

Instructions for Creating the Installer

Note that this step is only necessary if you want to create an installer package. To just run or debug STK, only the above Instructions for Compiling need to be followed.

Retrieved from "http://supertuxkart.sourceforge.net/How_to_build_the_Windows_version"

User Tools