SDK/Docs/1.2/Installing and configuring MeeGo SDK for Linux

Revision as of 16:11, 19 May 2011

This page is in progress and is likely to contain incorrect instructions at present -- Elliot Smith 11:24, 4 May 2011 (UTC)

This page describes how to install and configure the MeeGo 1.2 SDK on your Linux development system.

Prerequisites

• Hardware: Any reasonably modern hardware, such as 32-bit Intel Atom or Intel Core 2 CPU. To use QEMU to run MeeGo in a virtual machine your system should have support for Virtualization Technology (VT). Without this, performance is likely to be very poor. See the Graphics Acceleration page for details.
• Software: The MeeGo 1.2 SDK has been validated on 32-bit versions of Fedora 13, Fedora 14, Ubuntu 10.04 LTS, and Ubuntu 10.10. Note that support for Fedora 12 and Ubuntu 9.10 has been deprecated in MeeGo 1.2 SDK. http://qa-reports.meego.com/1.2 shows tested distros (see the SDK column).
• Root privileges: To install the SDK you will need root privileges. Commands that require root privileges are prefaced with sudo. For convenience, you may wish to setup sudo capabilities to easily switch between root and normal user privileges (use man sudo in a terminal for more details).
• Commands: Terminal commands are prefaced with $. Do not enter $ when entering the commands in your terminal.

Install the MeeGo SDK

The MeeGo SDK installer configures a package repository for your specific Linux distribution and installs SDK packages from it. The main packages installed are Qt Creator (IDE), QEMU (emulator) and MADDE (compilation and runtime environment). For convenience, the package installation process is wrapped inside a graphical installer which will run on any of the supported Linux distributions.

Download the graphical installer from: http://s3.amazonaws.com/MeeGoSDK/installer/Linux/meego-sdk-installer-online-20110503

Run the installer from a terminal:

 $ chmod +x meego-sdk-installer-online-20110503
 $ ./meego-sdk-installer-online-201100503 --verbose

(--verbose is optional but can be reassuring and helpful if things seem to have gone wrong or failed)

Follow the graphical installer prompts to install the SDK:

1. Wait for the installer to retrieve remote data. Then click on Next.
2. Select the components you want to install. Qt Creator is the IDE for MeeGo development; MADDE is a tool for developing against different MeeGo targets, allowing you to cross-compile and run your applications in different environments; Qt Simulator enables you to run applications on simulated devices (handset etc.).

   The SDK targets tree enables you to select different SDK targets to download immediately. Be warned that these are large files, so selecting more than one will leave you waiting a long time for the installer to finish. Note that you can add new targets later, so you don't have to select any now.

   Once you've selected components to install, click on Next.

3. Accept the licence and click Next again; then click on Install to start the installer downloading the required components.

   During this process, you will be prompted for a sudo password: enter it and press return.

Note that it may appear that nothing is happening for a long period of time. Be patient and it should eventually complete.

Install a MeeGo Target

A Target is used to build programs using the MeeGo toolchain and libraries (sysroot). It is downloaded as a large (~250MB) .bz2 file using the MeeGo SDK maintenance tool. You can use it to install one or more Targets; once installed, you can switch between them in Qt Creator to compile your application for different environments (described later).

Note that if you selected a target as part of SDK installation, you may not need to do this step. However, if at a later date you want to add, remove or otherwise manage targets for the SDK, follow the instructions below.

Determine the target you want to use

???use the maintenance tool to display the list of available targets

The available targets will be listed under the ???: heading.

A hint about the build environment is provided by the target prefix; for example:

• meego-core-armv7l: For ARM handheld devices (such as N900)
• meego-handset-ia32: For x86 handheld devices
• meego-netbook-ia32: For x86 netbooks (such as EeePC)
• meego-tablet-ia32: For x86 tablet devices (such as WeTab)

Create the target

???use the UI

Verify the target is installed correctly

???wait until you're in Qt Creator?

Verify the target can build software correctly

???again, from Qt Creator

Install a MeeGo Runtime (optional)

A Runtime is the MeeGo OS image which runs under QEMU, for debugging applications on your host system. A runtime is a large (~650MB) .bz2 file which you download with MADDE.

A Runtime is not required if you develop against real hardware running MeeGo. Even if you do require a Runtime, you won't need it until you have finished configuring Qt Creator. However, as this step may take some time, it is recommended that you start it now so it can run in the background while you finish installing the SDK.

See Downloading a Runtime and Using QEMU.

Configure Qt Creator to use the MeeGo toolchain(s)

Start Qt Creator by selecting main menu > MeeGo SDK 1.2 > MeeGo SDK Qt Creator.

Next, configure Qt Creator to use the MeeGo toolchain(s):

1. Go to Tools > Options > Qt4 > Qt Versions.
2. On the right side of the Qt Versions view, click on the plus sign button to add a new version.

   A blank, new version appears in the Qt Versions view.

3. On the Version Name line, specify a name for the new version.
4. On the qmake location line, specify a qmake location for the new version. The toolchain installs by default to usr/lib/madde/linux-i686/targets/<target>/bin/qmake.
5. Click Rebuild, Apply and OK.

Adding the MeeGo toolchain(s) in Qt Creator

Using the MeeGo SDK Qt version

It is also possible to use Qt Creator without a MeeGo toolchain. This option can be useful if you don't need to cross-compile your software: for example, if you are doing QML development with no use of C++.

The steps are the same as above, but the qmake location is set to the qmake installed with the meego-sdk-qt libraries. The usual location for this on Linux is:

$ /opt/meego/meego-sdk-qt/bin/qmake

Note: On Ubuntu 10.10, you may need to install g++ in order for this step to work. If necessary, do this:

$ sudo apt-get install g++

Developing with the SDK

To start developing with the MeeGo SDK, the hello world tutorial is a good first step. This tutorial covers how to start a project, package it, and deploy it to a device (either a real device, or a QEMU runtime set up through MADDE).