Installing Harmattan Platform SDK on a non-Debian system

Installing Scratchbox

1. Download the Harmattan Platform SDK installer from MeeGo 1.2 Harmattan Platform SDK downloads.
2. To provide executable permission to the script, enter the following command:

   $ chmod +x harmattan-sdk-setup.py

3. To run the script with root permission, enter the following commands:

   sudo su

   env https_proxy=<if any> DISPLAY=$DISPLAY ./harmattan-sdk-setup.py ai

4. Follow the instructions in the GUI installer.

You can now start using the installed Scratchbox. It contains the following targets:

• HARMATTAN_ARMEL
• HARMATTAN_X86

Note: On OpenSUSE, before triggering the installation, you must add the following repositories manually to install Xephyr:

$ zypper ar http://download.opensuse.org/repositories/X11:/Sugar/openSUSE_11.2 x11matchbox 

Xephyr X11 server software is needed on your host system before you can run any applications inside Scratchbox. Xephyr is an X11 server that provides a device screen so that you can see all the application windows and visuals on your host system. The Xephyr software is available on most Linux distributions.

Logging into Scratchbox

1. Since Scratchbox is a chroot environment, you must log in as you would with a real workstation. Enter the following command in the command prompt:

   $ sudo /scratchbox/sbin/sbox_ctl start

   $ /scratchbox/login

   The Scratchbox prompt [sbox-HARMATTAN_ARMEL: ~] > shows that you are in the Scratchbox ARMEL target.

2. To switch to HARMATTAN_X86 target, enter the following command:

   [sbox-HARMATTAN_ARMEL: ~] > sb-conf se HARMATTAN_X86

   Output example:

   [sbox-HARMATTAN_X86: ~] >

Running X server on your host system

Start Xephyr outside Scratchbox, enter the following command:

$ Xephyr :2 -host-cursor -screen 480x854x16 -dpi 96 -ac -extension Composite &

Running a simple Qt application

1. To start the UI framework services, enter the following command:

   [sbox-HARMATTAN_X86: ~] > meego-sb-session start

2. To run a simple Qt application called <TODO>, enter the following command:

   [sbox-HARMATTAN_X86: ~] > meego-run <TODO_app>

Uninstalling Platform SDK

Uninstalling Platform SDK removes the content from your Scratchbox home directory. It is therefore recommended to take a backup of your /scratchbox/users/<username>/home/<username> directory before proceeding with the uninstallation.

You can also uninstall the Platform SDK with the harmattan-sdk-setup.py install script by running the script and selecting the adminremove option.

To remove the Platform SDK manually:

1. To shut down all running processes such as the UI framework, enter the following command in Scratchbox:

   meego-sb-session stop

2. To exit Scratchbox and stop Scratchbox, enter the following command in the workstation terminal:

   $ sudo /scratchbox/sbin/sbox_ctl stop

3. To remove Scratchbox, enter the following command:

$ sudo rm -rf /scratchbox