Home · All Classes · Main Classes · Grouped Classes · Modules · Functions

Deploying Qtopia Core Applications

The procedure of deploying an Qt application on Qtopia Core is essentially the same as the deployment procedure on Qt/X11 which is described in detail in the Deploying an Application on Qt/X11 documentation. See also the general remarks about deploying Qt applications.

In addition, there is a couple of Qtopia Core specific issues to keep in mind:

• Qtopia Core Specific: Fonts
• Qtopia Core Specific: Environment Variables
• Qtopia Core Specific: Framebuffer Support

Qtopia Core Specific: Fonts

When Qtopia Core applications run, they look for a file called fontdir in Qtopia Core's /lib/fonts/ directory defining the fonts that are available to the application (i.e. the fonts located in the mentioned directory).

For that reason, the preferred fonts must be copied to the /lib/fonts/ directory, and the fontdir file must be customized accordingly. See the fonts documentation for more details about the supported font formats.

Note that the application will look for the /lib/fonts/ directory relative to the path set using the -prefix parameter when running the configure script; ensure that this is a sensible path in the target device environment. See the installation documentation for more details.

Qtopia Core Specific: Environment Variables

In general, any variable value that differs from the provided default values must be set explicitly in the target device environment. Typically, these include the QWS_MOUSE_PROTO, QWS_KEYBOARD and QWS_DISPLAY variables specifying the drivers for pointer handling, character input and display management, respectively.

For example, without the proper mouse and keyboard drivers, there is no way to give any input to the application when it is installed on the target device. By running the configure script using the -qt-kbd-<keyboarddriver> and -qt-mouse-<mousedriver> options, the drivers are enabled, but in addition the drivers and the preferred devices must be specified as the ones to use in the target environment, by setting the environment variables.

See the pointer handling, character input and display management documentation for more information.

Qtopia Core Specific: Framebuffer Support

No particular actions are required to enable the framebuffer on target devices: The Linux framebuffer is enabled by default on all modern Linux distributions. For information on older versions, see http://en.tldp.org/HOWTO/Framebuffer-HOWTO.html.

To test that the Linux framebuffer is set up correctly, and that the device permissions are correct, use the program provided by the Testing the Linux Framebuffer document.