this README describes how to set up libmeegotouch on a windows
computer.

right now we support the MinGW GCC compiler and the
Microsoft Visual Studio cl C++ compiler. this document
describes how to compile libmeegotouch for both compilers.

general prerequisites:

- install git, i installed it from http://code.google.com/p/msysgit/

- install perl, strawberry perl works for me.

- install coreutils from gnuwin32.sf.net. this is needed, because
  in the qmake build files there are some calls for the unix touch
  command. and this package installs touch for windows.

- install debugview. i got it from
  http://technet.microsoft.com/en-us/sysinternals/bb896647.aspx
  it shows the qDebug statements that libmeegotouch will print when 
  something goes wrong.


prerequisities for visual studio:

- install visual studio, express version worked for me.

- install a qt version with dbus support. either do it
  on your own, or use the version that is distributed by
  kde. go to http://winkde.org/pub/kde/ports/win32/installer/
  and download the latest installer. then install kde.
  you can install everything, but for this purpose it is important
  to install the qt package and also the qt development package
  (the header files etc.). kde for windows comes in two "versions",
  one is compiles with visual studio express, and the other is
  compiles with mingw. make sure you select to install the 
  msvc version.


prerequisities for mingw:

- install MinGW. the version that can be installed at the
  installation routine of qt for windows is ok.

- install a qt version with dbus support. either do it
  on your own, or use the version that is distributed by
  kde. go to http://winkde.org/pub/kde/ports/win32/installer/
  and download the latest installer. then install kde.
  you can install everything, but for this purpose it is important
  to install the qt package and also the qt development package
  (the header files etc.). kde for windows comes in two "versions",
  one is compiles with visual studio express, and the other is
  compiles with mingw. make sure you select to install the 
  mingw version.


now you should have all the tools you need to build and execute libmeegotouch
and its programs.

# now you should check that youe environment is setup in a way
# that the needed tools can be found. for the following commands,
# execute them in a cmd.exe window and check if they are found.
# (when you know konsole on linux as a shell window, try out
# console2, you might like it: http://sourceforge.net/projects/console/ )
touch
perl
git
qmake

# for mingw
gcc
g++
make

# for msvc
cl
nmake

# if all the commands are found, you are fine. if not, you have to add
# the pathes to these commands to your PATH environment variable,
# like this:
# set PATH=%PATH%;c:\KDE\bin

now go to some directory, e.g. c:\meegotouch. in the following i will
list the commands needed to get a working widgets gallery.

# go to this empty directory...
c:
cd \meegotouch

# now do a git clone of meegotouch-theme
git clone http://git.gitorious.org/meegotouch/meegotouch-theme.git

# now install the theme files
cd meegotouch-theme
qmake

# for msvc
nmake
nmake install

# or for mingw
make
make install

#for all
cd ..

# in this dir do a git clone of libmeegotouch.
git clone http://git.gitorious.org/meegotouch/libmeegotouch.git

# sources are now in libmeegotouch.

# now create build directory
mkdir libmeegotouchbuild

cd libmeegotouchbuild

# run qmake
qmake ..\libmeegotouch\projects.pro

# for msvc:

# run nmake to build it.
nmake
# currently this will fail with an error about a missing
# mgen executable

# actually right now under windows i was not able to build
# the mgen executable in the same location no matter if
# we build a debug or release build. for that the following
# steps in between are needed. we build and "install" mgen
# before we build the rest of libmeegotouch.
cd mgen
nmake
nmake install
cd ..

# and now we continue with the normal libmeegotouch build
nmake

# now install libmeegotouch
nmake install



# for mingw
# run make to build it.
make
# currently this will fail with an error about a missing
# mgen executable

# actually right now under windows i was not able to build
# the mgen executable in the same location no matter if
# we build a debug or release build. for that the following
# steps in between are needed. we build and "install" mgen
# before we build the rest of libmeegotouch.
cd mgen
make
make install
cd ..

# and now we continue with the normal libmeegotouch build
make

# now install libmeegotouch
make install



# for all

# now we built libmeegotouch and installed it, but the theme files
# are not yet in the right places. let's see if widgetsgallery
# tries to start anyway. it is expected that when you start
# widgetsgallery, it only prints some output in the stderr channel
# and exits again. first start the debugview program to catch
# messages on stderr.
debugview

# now we set the PATH environment variable to contain the path to
# the installed qt with dbus support. in this case we use the
# KDE-on-windows version.
set PATH=c:\d\kde\bin;%PATH%

# now we add the directories which contain libmeegotouch.dll and the executables.
# qmake by default installs to /usr prefix. this is c:\usr\ under windows.
set PATH=c:\usr\bin;c:\usr\lib;%PATH%

# now everything that is needed should be in place.
# start widgets gallery:
widgetsgallery

# now you should see the same widgets gallery window as you see
# on linux.
# if you do: Congratulations :-)
# if you don't: contact me and i will try to help you:
# holger.schroeder.ext@basyskom.de