webOS Open Source Edition (OSE) provides an emulator that enables you to test the webOS application and platform on a virtual environment. With the emulator, you can test major features of webOS on your PC without the need of a physical device such as Raspberry Pi.
Key characteristics of the emulator are as follows:
The emulator is optimized for the following host environment.
The emulator is provided as a pre-built package in GitHub. Clone or download the pre-built emulator package from the GitHub repository.
Create a JSON configuration file.
By default, the emulator package includes a template for configuration file, webos-config-sample.json. You can create your own configuration file webos-config.json from the template by modifying the option values according to your environment.
Create a configuration file from the template, and edit the file.
$ cd <emulator directory path>
$ mv webos-config-sample.json webos-config.json
$ vi webos-config.json
Change the option values to the ones suitable for your environment. Especially, vmdk_file_path must be set to the file path of the built .vmdk image. For example, if build-webos is under your home directory, the path must be set to ~/build-webos/BUILD/deploy/images/qemux86/webos-image-qemux86.vmdk.
For detailed description of all the options in the JSON file, refer to the README file inside the package.
Run the emulator.
Use the run script (emulator) to launch the emulator.
$ ./emulator webos-config.json
sudo command, because of KVM permission.On the host machine, you can connect to the emulator using one of the two options:
Connect from the Shell
To connect to the emulator on a Linux shell, use the command below. The port number must match the value set in the portforwarding.SSH option (default: 6622) of JSON configuration file.
$ ssh -p <PortNumber> -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null root@localhost
Connect from the Web Browser
To connect to the emulator using Web Inspector, connect to localhost:<PortNumber> on a web browser (for example, Chrome). The port number must match the value set in the portforwarding.inspector option (default: 9998) of JSON configuration file.
To build a custom emulator package, you need to build virglrenderer and QEMU, and copy the results to the pre-built emulator package.
virglrenderer is a library that allows graphics rendering by using the host GPU.
Before you begin, upgrade all the installed packages to the latest version and install the dependency packages.
$ sudo apt-get update
$ sudo apt-get upgrade
$ sudo apt-get -f install git libtool libdrm-dev libepoxy-dev libgbm-dev libegl1-mesa-dev libgtk-3-dev autoconf
To build virglrenderer, run the following commands one by one.
$ git clone git://anongit.freedesktop.org/virglrenderer
$ cd virglrenderer
$ git checkout virglrenderer-0.6.0
$ ./autogen.sh
$ ./configure --with-glx
$ make && sudo make install
Before you begin, make sure that the virglrenderer package has been built successfully.
After that, upgrade all the installed packages to the latest version and install the dependency packages.
$ sudo apt-get update
$ sudo apt-get upgrade
$ sudo apt-get -f install libsdl2-dev libpixman-1-dev
To build QEMU, run the following commands one by one.
$ git clone https://github.com/webosose-emulator/qemu.git
$ cd qemu
$ ./configure --target-list=i386-softmmu --enable-sdl --with-sdlabi=2.0 --audio-drv-list=alsa,pa
$ make
As the last step, copy the build results to the pre-built emulator package. Note that you must specify a different target directory depending on whether the host operating system is 64-bit or 32-bit.
If you have not cloned or downloaded the package previously, clone the prebuilt-emulator repository first.
$ git clone https://github.com/webosose-emulator/prebuilt-emulator.git
Copy the virglrenderer library.
$ cp /usr/local/lib/libvirglrenderer.so* prebuilt-emulator/lib/x86_64
Copy the qemu library.
$ cp <qemu directory path>/i386-softmmu/qemu-system-i386 prebuilt-emulator/bin/x86_64
$ cp -rf pc-bios prebuilt-emulator/bin
Copy the virglrenderer library.
$ cp /usr/local/lib/libvirglrenderer.so* prebuilt-emulator/lib/x86
Copy the qemu library.
$ cp <qemu directory path>/i386-softmmu/qemu-system-i386 prebuilt-emulator/bin/x86
$ cp -rf pc-bios prebuilt-emulator/bin
If you encounter the error message “qemu_gl_create_compile_shader: compile vertex error: GLSL ES 3.00 is not supported. …” when you run the emulator, that means the OpenGL/Mesa of your host PC doesn’t support OpenGL 3.0.
To fix the issue, refer to the following steps.
Step 1. Check the installed Mesa package.
$ sudo apt list --installed | grep mesa
Step 2. Check the OpenGL & Mesa library version.
$ glxinfo | grep "OpenGL version"
Step 3. Delete old Mesa package.
Step 4. Update the system.
$ sudo apt-get update
$ sudo apt-get upgrade (or sudo apt-get dist-upgrade)
$ sudo apt-get -f install
Step 5. Install the latest Mesa package.
$ sudo apt-get install -f libegl1-mesa-lts-xenial
Step 6. Install dependency packages.
$ sudo apt-get install libegl1-mesa-drivers
$ sudo apt-get install epoxy0
$ sudo apt-get install libsdl2-2.0-0
Contents