this README describes how to set up libdui 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 libdui 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 libdui 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 libdui

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:\dui. in the following i will

list the commands needed to get a working widgets gallery.

# go to this empty directory...

c:

cd \dui

# now do a git checkout of duitheme

git co git+ssh://git@dvcs.projects.maemo.org:af/duitheme

# now install the theme files

cd duitheme

qmake

# for msvc

nmake

nmake install

# or for mingw

make

make install

#for all

cd ..

# in this dir do a git checkout of libdui.

# right now we still need the holger-msvc branch, but it

# will be merged to master in short time.

git co git+ssh://git@dvcs.projects.maemo.org:af/libdui

# now switch to holger-msvc branch

cd libdui

git co -b holger-msvc origin/holger-msvc

cd ..

# sources are now in libdui.

# now create build directory

mkdir libduibuild

cd libduibuild

# run qmake

qmake ..\libdui\projects.pro

# for msvc:

# run nmake to build it.

nmake

# currently this will fail with an error about a missing

# duigen executable

# actually right now under windows i was not able to build

# the duigen 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" duigen

# before we build the rest of libdui.

cd duigen

nmake

nmake install

cd ..

# and now we continue with the normal libdui build

nmake

# now install libdui

nmake install

# for mingw

# run make to build it.

make

# currently this will fail with an error about a missing

# duigen executable

# actually right now under windows i was not able to build

# the duigen 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" duigen

# before we build the rest of libdui.

cd duigen

make

make install

cd ..

# and now we continue with the normal libdui build

make

# now install libdui

make install

# for all

# now we built libdui 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 dui.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