Qtopia Home - Classes - Hierachy - Annotated - Functions - Qt Embedded

Building Qtopia from Source

• Acceptable directory characters
  • Details on building Qtopia
• Now what?
• Touchscreen Phone Calibration
• Troubleshooting

This document should be read inconjunction with Getting Started which explains the process of downloading and installing Qtopia. It assumes that you have already gathered the necessary files and are ready to build Qtopia from the source code.

If you have installed Qtopia using an rpm then you cannot compile Qtopia yourself. Please proceed to Running Qtopia or go to the "Building and Compiling" section in the reference documentation which tells you more about building and compiling your own Qtopia applications.

If you have installed all the packages and have set the environment variables:

 TMAKEDIR, QT2DIR, DQTDIR, QTEDIR 

 QPEDIR 

Note: Qt/X11 2.3.2 will attempt to locate and use the freetype 1.x library for font smoothing (freetype 2.x is a different thing that doesn't work with Qt/X11 2.3.2). Unfortunately this can happen even if you don't have the freetype development library and headers installed. Either install the freetype-devel package or configure with -no-xft.

Acceptable directory characters

There are some limits to the acceptable characters in directories. The details are in the Build Environment document.

Details on building Qtopia

Click on the link below to suit the product that you are building

• Qtopia Reference Board kit
• Qtopia Phone OEM kit
• Qtopia PDA OEM kit
• Qtopia Core OEM kit

Now what?

After running the script or building Qtopia manually you should have a set of Qtopia binaries and be ready to run them. The binaries are put into places like $QPEDIR/bin, $QPEDIR/lib and $QPEDIR/plugins but these are not the ones you should install onto a device. In order to make integrating Qtopia on a device easier we have provided an image directory that contains all the files (and only those files) that should be installed onto the device. This image directory is located at $QPEDIR/image/opt/Qtopia and if you cd into it you'll see a bin dir, a lib dir and so on.

IMPORTANT: Depending on the device you are installing Qtopia on you may or may not need the additional libraries libjpeg and libc. For backward compatibility reasons we have provided these libraries in the arm/lib directory. If you run Qtopia on your device and you get error messages referring to one of these libraries then please move them to a different location and ensure that you have the correct version of these libraries on your device.

For information about running Qtopia please go to Running Qtopia

Touchscreen Phone Calibration

If you are building Qtopia Phone edition for a touchscreen device, you will need to calibrate the touchscreen manually as Calibration is not run automatically. With Qtopia Phone running, enter the following command to start Calibration.

qcop "QPE/System" "execute(QString)" "calibrate"

This outputs calibration information to the $HOME/Settings/pointercal file which you should copy to /etc/ so you won't have to repeat this process.

NOTE : You must have QPE_NEED_CALIBRATION defined in your custom-<platform-spec>.h file. See also Qtopia - Customizing Qtopia for a Device .

Troubleshooting

• If a Qt/Embedded application does not appear inside QVfb then try removing the old Qt/Embedded temporary data. For example:

      killall qpe quicklauncher qvfb
      rm -rf "/tmp/qtembedded-$LOGNAME/"
      rm -rf /tmp/qtembedded-0/
      

• If you are intending to connect your Qt/Embedded application to QVFb you must not configure Qt/Embedded with the -no-qvfb command.

• If you are experiencing trouble with your Qtopia image then do a clean install of Qtopia via:

      cd $QPEDIR
      make cleaninstall
      

  and try running your application again.