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/webos-ports/images/qemux86/. The archives are prefixed with webos-ports-emulator-qemux86-. If you want to use always the latest image you can just use http://build.webos-ports.org/webos-ports/images/qemux86/webos-ports-emulator-qemux86.zip 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 (please note that in the bottom option there will be a path to the Virtual Disk Image that will be automatically created and the vmdk image will be automatically copied there). 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.