Qt API | Qtopia API | Qtopia Documentation |

# Instructions for Building Qtopia Desktop

## Windows

1. Qt 3.1.2 and commercial source code for Qtopia are required to build Qtopia Desktop. Download and install Qt 3.1.2 for windows with default settings, (ie install to c:\qt\3.1.2, substitute below if different)
2. From a command prompt,
   If QMAKESPEC has not been set, set QMAKESPEC appropriately for the compiler which is to be used.
   For MS Visual C++:

                       set QMAKESPEC=win32-msvc

   Otherwise if the newer .NET compiler is to be used:

                       set QMAKESPEC=win32-msvc.net

   Compile Qt with the -qwinexport configuration option:

                       set QTDIR=c:\qt\3.1.2
                       set PATH=%QTDIR%\bin;%PATH%
                       cd %QTDIR%
                       configure -thread -qwinexport -lean
                       cd src
                       nmake clean
                       nmake

   Ensure assistant.exe and qaxcontainer.dll were built in step one, if not compile them with:

                       cd %QTDIR%\tools\assistant
                       nmake
                       cd %QTDIR%\extensions\activeqt
                       nmake

   Qt is now ready to be used with Qtopia Desktop
3. Download and install tmake 1.11 (ftp://ftp.trolltech.com/freebies/tmake/tmake-1.11.zip) (example commands assumes it is installed to c:\tmake-1.11)
4. Install Qtopia source to c:\qtopia\1.7 (substitute below if different)
5. From command prompt, Compile Qtopia Desktop and all of its plugins:

                       set QTDIR=c:\qt\3.1.2
                       set QPEDIR=c:\qtopia\1.7
                       set TMAKEDIR=c:\tmake-1.11
                       set TMAKEPATH=%TMAKEDIR%\lib\win32-msvc
                       set PATH=%QPEDIR%\bin;%QTDIR%\bin;%TMAKEDIR%\bin;%PATH%
                       cd %QPEDIR%\src
                       configure -product qtopiadesktop
                       nmake -f Makefile

6. Using the regedit program ensure that the qtopiadir registry entry in the path \HKEY_LOCAL_MACHINE\SOFTWARE\Trolltech\palmcenter points to c:\qtopia\1.7\src\qtopiadesktop\

## Linux

1. Qt 3.1.2 and commercial source code for Qtopia are required to build Qtopia Desktop. Download and extract Qt 3.1.x for X11.
2. Compile qt:

                       tar xfz qt-x11-commercial-3.1.x.tar.gz
                       cd qt-x11-commercial-3.1.x
                       export QTDIR=$PWD
                       export PATH=$QTDIR/bin:$PATH
                       cd $QTDIR
                       ./configure -thread
                       make
                       cd ..

3. Extract Qtopia source package for example to ~/qtopia-source-1.7.0 (substitute below if different)
4. Install tmake..

                       tar xfz tmake-1.11.tar.gz
                       export TMAKEDIR=$PWD/tmake-1.11
                       export TMAKEPATH=$TMAKEDIR/lib/linux-g++
                       export PATH=$PATH:$TMAKEDIR/bin

5. Compile Qtopia Desktop as follows:

                       tar xfz qtopia-source-1.7.0.tar.gz
                       cd qtopia-source-1.7.0
                       export QPEDIR=$PWD
                       export PATH=$QPEDIR/bin:$QTDIR/bin:$PATH
                       cd $QPEDIR/src
                       ./configure -qtopiadesktop
                       make
                       cd $QPEDIR/bin
                       ln -s ../src/qtopiadesktop/bin/qtopiadesktop qtopiadesktop