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

# Qtopia Porting issues

- Introduction
- Qtopia - Porting from 1.x to 2.0
- Pro file handling

## Introduction

This document describes the issues that have to be dealt with when porting Qtopia 1.x applications to Qtopia 2.0.

## Qtopia - Porting from 1.x to 2.0

- FileSelector::selected() is removed; use FileSelector::selectedDocument()

- Use:

        int result = QPEApplication::execDialog(dlg);

rather than:

        dlg->showMaximized();
        int result = dlg->exec();

(and similar)

## Pro file handling

Qtopia 1.7 and earlier used tmake to create Makefiles from .pro files. Qtopia 2.0 and above use qmake to do this. qmake attempts to be backwards compatible with the tmake syntax but there may be problems you will need to address. The qmake User Guide contains information about qmake syntax.

Qtopia 2.0 defines all projects that live inside $QPEDIR/src as "depot" projects. These projects are subject to some extra checks that third party projects are not subjected to. Most importantly, a "depot" project must be listed in one of the project lists (see the build system documentation for more information about these lists and how to modify them). It is therefore recommended that third party projects reside outside the Qtopia source tree.

Additionally, the way Makefile is used has changed slightly with Qtopia 2.0. For more information about how Makefiles are used please see the build system documentation.

One thing that can cause confusion is the automatic processing of various .pri files. Mostly, this will be unnoticed and serves to help compatibility with Qtopia 1.7. Details about the process can be found in the build system documentation. Specifically, global.pri changes various rules based on the values in CONFIG.