# 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.