Marble/WindowsCompiling: Difference between revisions

From KDE TechBase
No edit summary
(Page moved to community wiki)
 
(20 intermediate revisions by 6 users not shown)
Line 1: Line 1:
This page present only how to build Marble on windows. [[Projects/Marble/MarbleWindows|Here]] is an other howto about using libmarblewidget in a application built for windows. You should also have already read [http://edu.kde.org/marble/obtain.php this] too.
{{ Moved To Community }}
 
 
 
===== Preliminaries: =====
 
#The Marble project uses [http://www.cmake.org/ CMake] to manage the building process depending of your needs&nbsp;: operating system, build options. So, first of all, you need to download the latest [http://www.cmake.org/cmake/resources/software.html CMake binary for windows]. Install it and don't forget during the installation to check "define cmake path in environment variables" or something like that.<br><br>
#Marble is a Qt dependent application ("No way!?" "Way!!"&nbsp;:) ) so you also need Qt. Download the latest [http://qt.nokia.com/downloads Qt sdk] for windows and install it.<br><br>From hereon, there are two ways to compile Marble - both are currently working (as of 1st of july 2010):
 
*using the open source MingW compiler provided with Qt, or ...
*
using the Microsoft Visual C++ compiler (steps below were tested with MSVC++ 2008 Express edition).
 
=== Compiling Marble using MingW ===
 
#You have to add mingw's path and qmake's path in the environment variable. (use C:\Qt\20xx.xx.x\MinGW\bin and C:\Qt\20xx.xx.x\qt\bin )(follow those [http://www.computerhope.com/issues/ch000549.htm instructions] if needed). To check that cmake.exe, gcc.exe and qmake.exe are in your&nbsp;%PATH%&nbsp;:
##open a commandline-window (start-&gt;run program-&gt;cmd)
##run "cmake" , it should give you a help message and show you what compilation options it found
##run "gcc -v" , it should give you version info
##run "qmake" , it should give you help output
##(Hint: make sure not to add the directory&nbsp;%QT-installation-dir%/bin but rather&nbsp;%QT-installation-dir%/qt/bin, there are for some reason incompatible dll's that might lead to crashes)
##If one of those command are not known then something is wrong.
#Then check out marble's svn&nbsp;: <code bash="bash">svn co svn://anonsvn.kde.org/home/kde/trunk/KDE/kdeedu/marble</code> (Note: this is for the development version. You may want a more stable version. So look for the appropriate url)
#now you can compile marble&nbsp;:
##open the cmd-window
##cd to the marble dir
##create a build directory (mkdir build)
##<code bash="bash">cd build</code>
##<code bash="bash">cmake -G "MinGW Makefiles" -DQTONLY=ON -DCMAKE_BUILD_TYPE=Release ..</code> (add -DWITH_DESIGNER_PLUGIN=ON if you want the MarbleWidget Plugin )(note that the "-DCMAKE_BUILD_TYPE=Release" '''is''' important because without it you will have trouble like no downloading tiles etc)
##<code bash="bash">mingw32-make</code> (you can add "-j2" if you have a 2 cores cpu)
##<code bash="bash">mingw32-make install</code> (Note: if you are under Windows seven you must be root to install marble in the standard place. See [http://www.howtogeek.com/howto/windows-vista/run-a-command-as-administrator-from-the-windows-vista-run-box/ this] )
#Now if all went well you should find marble.exe in Program Files&gt;marble&gt; directory.
 
Test it... Yeah!
 
 
 
 
 
=== Compiling Marble using Microsoft Visual C++ ===
 
#The Windows version of Marble distributed on the KDE website is compiled using the <br>Microsoft VC++ compiler. For Marble to work right, you'll need the [http://qt.nokia.com/downloads/windows-cpp-vs2008 MSVC+ compiled <br>version of QT].&nbsp;
#Once you got these installed, make sure that you add the bin Path of the <br>framework to your PATH variable. E.g. "C:\Qt\4.6.3\bin". This will point <br>the system to the DLLs of the framework eventually needed.
#Get the Marble sources from SVN into a fresh directory (see above for steps). Then you can open a command line window (with administrator privileges - on Vista <br>and Windows 7, you need to hold down SHIFT and Control when executing <br>"CMD.exe" from the start button menu). You need to make sure that you <br>got those privileges, otherwise the build will fail due to missing <br>rights to write files later on during linking and installing.
#Make sure to set the environment variables for the MS Visual C++ <br>compiler by doing "vcvarsall.bat" in the tool subdirectory of your <br>Microsoft Visual C++ installation.<br><br>Example:<br>C:\&gt;cd "\Program Files\Microsoft Visual Studio 9.0\VC<br>C:\Program Files\Microsoft Visual Studio 9.0\VC&gt;vcvarsall<br>Setting environment for using Microsoft Visual Studio 2008 x86 tools.<br>C:\<br>
#Change to the directory with the Marble sources, and enter the following build commands (thanks to Patrick Spendrin for that):<br><br>C:\Marble-Src\cmake -G "NMake Makefiles" -DQTONLY=ON <br>-DCMAKE_INSTALL_PREFIX=C:\marble-tmp &amp;&amp; nmake &amp;&amp; nmake install<br>
#Once issued, you will get the build kicked off. First, the cmake&nbsp;cross-compiler will make the MakeFile, and Nmake will then compile it, while nmake install will install the application at the path specified at CMAKE_IMSTALL_PATH Prefix.<br>
#Once you got your version of Marble &nbsp;"installed", you need to manually copy the missing Qt Framework DLLs as well as the missing imageformat DLL for importing tiles.The following DLLs go from the Qt/bin directory right next to the <br>marble.exe file in the installation directory:<br><br>QtCore4.dll<br>QtGui4.dll<br>QtNetwork4.dll<br>QtSvg4.dll<br>QtWebKit4.dll<br>QtXml4.dll<br>
#Additionally, you need to create a directory in the "plugins" folder <br>named "imageformats". This is the plugin for different image formats. In <br>Marble 0.8.0, there was just one DLL in there, namely "qjpeg4.dll", <br>which is the support for JPEG file tiles in Marble.<br>[NOTE: what about PNG support? Would that be "qmng4.dll" to be added?]<br>
#The "qjpeg4.dll" is not build yet after downloading and installing the <br>MSVC version of the Qt Framework, yet you will find a MS VC Project file <br>in your Qt source directory (e.g.&nbsp;"C:\Qt\4.6.3\src\plugins\imageformats\imageformats.dsw"). Open that up, <br>set the release configuration in the compiler and compile the project.<br>
#Note that the output files will be found in another place! Namely in the <br>plugins folder of Qt (e.g. "C:\Qt\4.6.3\plugins\imageformats").&nbsp;From there, you can copy the qjpeg4.dll needed, and you should be all set - you now got a fresh Marble version compiled with MSVC.<br>
 
<br> Tested with CMake 2.8.1, Qt sdk 2010.02.1 (&nbsp;Qt 4.6.2&nbsp;; Qt Creator 1.3.1&nbsp;; MinGW 3.15&nbsp;; GCC4.4.0 ) and rev. 1128605 of marble for the MingW part, and the&nbsp;Qt SDK 4.6.3 for MSVC.

Latest revision as of 17:39, 25 October 2016

This page is now on the community wiki.