Changes between Initial Version and Version 1 of dev/WindowsMinGW/345

Timestamp:

Sep 17, 2010, 7:23:19 PM (14 years ago)

Author:

landauf

Comment:

—

dev/WindowsMinGW/345

@@ +1 @@
+= Windows with MingW with GCC v3.4.5 (outdated) = 
+
+== MinGW ==
+
+{{{
+#!div style="background-color: #D0D0F0; border: solid 1px #000000; margin-right: 200px;"
+''MinGW is a collection of tools (like GCC and more), used to compile source code on Windows.''
+}}}
+
+Download and install [http://sourceforge.net/projects/mingw/files/Automated%20MinGW%20Installer/ MinGW].
+ 1. Select "Download and install"
+ 1. Select "Current"
+ 1. Select "MinGW base tools", "g++ compiler", and "MinGW Make"
+ 1. Chose an install path, default is {{{c:\mingw}}} but every other '''path without whitespaces''' works
+
+== MSYS ==
+
+{{{
+#!div style="background-color: #D0D0F0; border: solid 1px #000000; margin-right: 200px;"
+''MSYS is a command shell, used to execute build scripts and more.''
+}}}
+
+Download and install [http://downloads.sourceforge.net/mingw/MSYS-1.0.11.exe MSYS].
+ 1. Chose an install path without whitespaces and install MSYS
+ 1. (On some systems the post installation doesn't start (cmd.exe shows up with an error)[[br]]In this case execute {{{c:\<msys-install-path>\postinstall\pi.bat}}})
+ 1. Answer yes (y) twice
+ 1. Specify the path to your MinGW directory (by default this is {{{c:/mingw}}}). 
+
+Switch to the home-directory of your MSYS installation: {{{c:\<msys-install-path>\home\<username>\}}}[[br]]
+This is your homedirectory in MSYS, this is where the action takes place.
+
+'''In the following, we'll call this directory {{{c:\<msys-homedir>\}}} to make things shorter.'''
+
+
+== SVN ==
+To use [wiki:SVN] on your system we recommend TortoiseSVN, a very useful GUI-client. [http://tortoisesvn.net/downloads Download]
+
+TortoiseSVN is a shell extension. You can use it within Windows Explorer, which is very practical. Most options are available through the context menu (right mouse button).
+
+
+== Get the source ==
+Check out the Orxonox-repository into a folder named "trunk", for example {{{c:\<msys-homedir>\trunk\}}}. '''It's very important to use a directory inside your MSYS homedirectory, otherwise you can't compile.'''
+ * URL: {{{https://svn.orxonox.net/game/code/trunk/}}}
+ * Checkout directory: {{{c:\<msys-homedir>\trunk\}}}
+
+Now do the same with the data repository and store it in a directoy called "data_extern":
+ * URL: {{{https://svn.orxonox.net/game/data/trunk}}}
+ * Checkout directory: {{{c:\<msys-homedir>\data_extern}}}
+
+Now you should have the following directories in your home:
+{{{
+c:\<msys-homedir>\data_extern
+c:\<msys-homedir>\trunk
+}}}
+
+{{{
+#!div style="background-color: #D0F0D0; border: solid 1px #000000;"
+In TortoiseSVN this is done by right clicking into {{{c:\<msys-homedir>\}}} and chosing "SVN checkout...". ([attachment:wiki:WindowsMinGW:orxonox_svn_checkout.gif see this picture])
+
+Then set the URL of the repository to {{{https://svn.orxonox.net/game/code/trunk/}}} and the checkout directory to {{{c:\<msys-homedir>\trunk\}}} (checkout depth should be "Fully recursive" and revision "HEAD").
+Accept the certificate and enter your username and password in the authentication form (only if it's the first time you check out code from our server). ([attachment:wiki:WindowsMinGW:orxonox_svn_checkout_trunk.gif see this picture])
+}}}
+{{{
+#!div style="background-color: #D0F0D0; border: solid 1px #000000; margin-top: 10px;"
+If you're not using TortoiseSVN, use the "svn co <repository> <directory>" command. See [wiki:SVN] for more information.
+}}}
+
+== Dependencies ==
+Download the Orxonox dependencies: [http://svn.orxonox.net/downloads/windows/precompiled_dependencies/OrxonoxDeps_091009_4.0_MinGW.7z Download] (get 7-Zip [http://www.7-zip.org/ here]).[[br]]
+Extract the archive into {{{c:\<msys-homedir>\}}}
+
+Now you should have the following directories in your home: ([attachment:wiki:WindowsMinGW:orxonox_directories.gif see this picture])
+{{{
+c:\<msys-homedir>\data_extern
+c:\<msys-homedir>\dependencies
+c:\<msys-homedir>\trunk
+}}}
+
+== OpenAL ==
+Make sure you have installed OpenAL (might not be shipped with Windows 7). Otherwise you can compile and run everything but no sound will be played.
+
+== CMake ==
+Now we can build Orxonox. To do so, we need CMake. CMake is a cross-platform system for build automation. Download the latest binary release ('''at least version 2.6''') from [http://cmake.org/HTML/Download.html here] and install it.
+ * '''While installing check the option to "add CMake to the system PATH"'''
+
+Open {{{c:\<msys-install-path>\etc\profile}}} and add the following line at the bottom of the file:
+{{{
+alias cm='cmake .. -G "MSYS Makefiles"'
+}}}
+
+== Building Orxonox ==
+Open the MSYS console, change into your trunk folder and create an output directory for the binaries:
+{{{
+$ cd trunk
+$ mkdir build
+$ cd build
+}}}
+
+Now we use the alias "cm" from the previous section. This shortcut will invoke CMake and create the Makefiles. Type the following into the MSYS console:
+{{{
+$ cm
+$ make
+}}}
+The first command "cm" will check your system (and the dependency directory) for all needed libraries, create the configuration and generate the makefiles. The second "make" command builds Orxonox. If you have a multicore CPU, use "make -j3" instead of just "make". If you get an error while executing one of those steps, report it in the [http://forum.orxonox.net/ Forum] or ask us in [irc://irc.orxonox.net/orxonox IRC].
+
+Compiling will take some time (CMake shows you the percentage). Be patient.[[br]]
+
+If everything worked fine, start Orxonox with {{{c:\<msys-homedir>\trunk\build\run.bat}}} (you can't execute orxonox.exe directly).