Emulator

= Overview =

We're providing a emulator with the webOS ports project which enables you to play with the Luna Next UI on your local PC without the need to use a target device. The base for the emulator is Virtual Box.

= Installation =

First you need to download emulator. Currently we don't have an update mechanism implemented so you have to download and update your virtual machine on your own.

You will find the appliances for Virtual Box at http://build.webos-ports.org/luneos-stable/images/qemux86/ (32 bits) or http://build.webos-ports.org/luneos-stable/images/qemux86-64/ (64 bits). The archives are prefixed with webos-ports-dev-emulator-qemux86 (32 bits) and webos-ports-dev-emulator-qemux86-64 (64 bits). If you want to use always the latest image you can just use http://build.webos-ports.org/luneos-testing/images/qemux86/webos-ports-dev-emulator-qemux86.zip (32 bits) or http://build.webos-ports.org/luneos-testing/images/qemux86-64/webos-ports-dev-emulator-qemux86-64.zip (64 bits) which always points to the latest image.

As next step you need to download and install Virtual Box. Please see https://www.virtualbox.org/ for any further details.

After you've installed Virtual Box you need to extract the downloaded emulator archive. It contains two files (webos-ports-emulator-disk.vmdk and webos-ports-emulator.ovf) which needs to be placed within the same directory. Now the appliance can be imported into Virtual Box. Start Virtual Box and select "File -> Import Appliance" from the application menu. In the following dialog select the extracted file webos-ports-emulator.ovf as the appliance to import and just follow the wizard. You don't need to change any of the preconfigured values. After the appliance was successfully imported you can start the emulator as any other virtual machine inside Virtual Box.

= Access the virtual machine with SSH =

The emulator has been configured to forward the port 22 (the port SSH is listening on) to the port 5522 of your PC. You can connect with SSH by running

ssh -p 5522 root@localhost

on the command prompt of your Linux system or by using Putty on Windows.

= Keyboard shortcuts = End: Opens and closes the launcher

Esc: Performs the back gesture (or swipe back)

Home: Minimizes and maximizes the card

Left/Right Arrow: Switches the application left or right in the Card view

F5: Simulate shaking (Not yet implemented)

F6: Simulate "up" (12:00 or normal) orientation

F7: Simulate "down" (6:00) orientation

F8: Simulate "right" (3:00) orientation

F9: Simulate "left" (9:00) orientation

Note that the orientation keys will only be active if Window Orientation has been set to "free".

Alt (Windows and Linux) or Option (Mac)	Option key: Not yet implemented

Control	Sym (symbol) key: Not yet implemented