Qtopia Free Developer Kit

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.

• Qtopia 1.7.x (this package)
• Qt/Embedded 2.3.x (upon which Qtopia is built)
• Qt 2.3.2 for X11 (for emulated desktop development)

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:

• Qtopia documentation index.
  • Qtopia Platform introduction.
  • Getting Started page
• Qt documentation index and the Qt Whitepaper

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