Home · All Classes · Grouped Classes · Annotated · Functions

Installing a Qtopia SDK

Introduction

This document describes how to install a Qtopia SDK package. It should be read after:

Before continuing, you must ensure that the SDK package has been downloaded, or that you have a CD/DVD available that contains the Qtopia SDK.

Installing a Software Development Kit (SDK)

SDKs are typically delivered as an ISO image or are pre-written on a CD/DVD. The ISO image can be downloaded and then written onto a CD/DVD using a regular CD/DVD writer, or on Linux can be alternatively mounted as a loopback device. For Windows, there is 'Virtual CD-ROM Control Panel' available from Microsoft, which can mount an iso and be displayed as a drive in Windows Explorer.

The procedure for writing a CD/DVD falls outside the scope of this document and won't be discussed any further, please read the user manual of your CD/DVD writer for detailed instructions.

For the Qtopia SDK to work properly you also need to install VmPlayer. This package needs to be downloaded from the VmWare website. The install program will prompt you at the appropriate time and give some hints on how to install VmPlayer. For a detailed instruction on how to set up VmPlayer, please refer to the VmWare website.

Installing the SDK on Windows.

On Windows the SDK can only be installed via a CD/DVD.

To install the SDK, simply put the CD/DVD in the drive. If autorun is working properly the installer should start up and the installation process will begin. Just follow the prompts and the SDK will be installed.

Installing the SDK on Linux.

On Linux the SDK can both be installed using a CD/DVD and/or using a loopback device. Using a loopback device is convenient if you have downloaded an ISO image and don't want to waste time burning a CD.

Using a CD/DVD

To install the SDK from a CD/DVD:

    put the CD/DVD in the drive.
    The CD should automount into /media/cdrom (or something similar)
    Don't forget to install VmPlayer.

Using a loopback device

To use the iso image as a loopback device, please do the following:

    su (login as root, enter password if needed)
    mkdir <mountpoint> (create a directory where the ISO needs to be mounted)
    mount -o loop <filename> <mountpoint>
    exit (logout as root, i.e. logged in as normal user again)

Installing the SDK (continued)

    cd <mountpoint> (You MUST cd into the mounted directory)
    ./install.sh (run the install script)

Answer the questions asked in the installer program and make sure VmPlayer is installed.

Running the SDK

To run the SDK:

    cd /home/<username>/QtopiaGreenphoneSDK (or wherever the SDK is installed)
    vmplayer greenphone.vmx

Once the VMPlayer is running a fully functional Linux environment is available inside the VMPlayer that contains all the Qtopia SDK tools, pre-build Qtopia binaries, documentation, etc to be used. To run Qtopia, click on runqtopia.

The SDK does not come with any source code, Qtopia comes in a pre-build form. The starting point of an SDK is where a Source Package user would be after having configured and build Qtopia both for the desktop and for the device. If you want to rebuild Qtopia, you must download the source code package separately.

The Qtopia binaries are located (from within the VmPlayer environment) in /opt/Qtopia/SDK/<version>/x86 and /opt/Qtopia/SDK/<version>/<device>. The <device> directory contains all the files (and only the files) that should be installed onto the device. Note that we have passed -prefix to specify the location that Qtopia will run from /opt/Qtopia.

For further information about running Qtopia refer to Running Qtopia.


Copyright © 2008 Nokia Trademarks
Qtopia 4.3.3