Qtopia Free Developer Kit


Snapshot version

This is a snapshot version representing the state of development at a particular point in time. While we make an effort to keep the software stable, the software may have stability problems or even fail to compile or run. Please upgrade to the latest version before reporting problems with this snapshot.

This is a development version for Qtopia. See the LICENSE file for information on LICENSE of this software.

You can only develop GPL licensed applications using the Qtopia Free edition. If you wish to develop a commercial application, please go to Qtopia Download Page to purchase the commercial SDK.

Getting Started

You can either download and install the Qtopia RPM or the Qtopia source. Using the RPM will save you compile time and will allow you to start developing sooner. To download the RPM, go to Qtopia Download Page to download the rpm for your platform. If you are using the RPM, goto Running Qtopia.

Compile Qtopia from source

You will need the software listed below to be able to compile and use Qtopia.

Below is a description of how to get everything built quickly without having to read the detailed instructions provided with each of the packages above.

  1. Unpack Qtopia...
    
       tar xfz qtopia-free-1.7.x.tar.gz 
       cd qtopia-1.7.x 
       export QPEDIR=$PWD
       cd ..
    
    
  2. Install Qt/Embedded...
    
       tar xfz qt-embedded-2.3.x.tar.gz 
       cd qt-2.3.x 
       export QTDIR=$PWD
       export QTEDIR=$QTDIR 
       export PATH=$QTDIR/bin:$PATH 
       export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH 
       cp $QPEDIR/src/qt/qconfig-qpe.h src/tools/ 
       ./configure -qconfig qpe -qvfb -depths 4,8,16,32 
       make sub-src 
       cd ..
    
    
    You may also want to use the configure options -system-jpeg and -gif for jpeg and gif support.

  3. Install Qt/X11 2.3.2... Note that you must use 2.3.x, not 3.x, as this step is done to provide Qt 2 tools.
    
       tar xfz qt-x11-2.3.2.tar.gz 
       cd qt-2.3.2 
       export QTDIR=$PWD
       export PATH=$QTDIR/bin:$PATH 
       export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH 
       ./configure 
       make 
       make -C tools/qvfb 
       mv tools/qvfb/qvfb bin 
       cp bin/uic $QTEDIR/bin 
       cd ..
    
    
    You may also pass other configure options such as -no-opengl or -no-xft as suitable to your environment. Use ./configure -help for more information. You may also want to build Qt Designer (in tools/designer/).

  4. Build Qtopia...
    
       cd qtopia-1.7.x 
       export QTDIR=$QTEDIR 
       export QPEDIR=$PWD 
       export PATH=$QPEDIR/bin:$PATH 
       cd src 
       ./configure 
       make 
       cd ../..
    
    

Running Qtopia

  1. Ensure your environment has the following variables set.
       export QPEDIR=/opt/Qtopia
       export QTDIR=/opt/Qtopia
       export PATH=$QTDIR/bin:$PATH
       export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH
    
  2. Run the Qt Virtual Framebuffer (an X11 application)...
    
       qvfb &
    
    
  3. Run Qtopia (a Qt/Embedded application, will show in QVFb)...
    
       export QTDIR=$QTEDIR 
       qpe &
    
    

Documentation

Qtopia documentation also includes the Qt 2.3.x documentation. You can always get the most up to date documentation by going online and visiting the Trolltech Documentation Site

If you are using the SDK then the documentation has been already installed on your system:

Support

The free edition comes with no official Trolltech support. Trolltech maintains support mailing lists where the open-source community can ask and answer questions. The Trolltech team also tries to assist these mailing lists by answering new questions.

Please go to Trolltech Mailing List index to join our mailing lists or to browse the archives. There is a specific mailing list for Qtopia related issues.


Copyright © 2001-2003 Trolltech Trademarks
Qtopia version 1.7.0