Emulator Developer Guide


From webOS TV 22, Emulator will not be provided. Instead, we provide Simulator with better development convenience. About Simulator, see Simulator Introduction.

This article describes how to use the main functions of the webOS TV emulator.

Using App Manager


If you have installed webOS CLI v3.0.0 or higher, you cannot use App Manager of the Emulator. Instead, you can install apps on the Emulator using webOS CLI or webOS Studio.

App Manager is a tool for developers to easily install, launch, close, and remove packaged app files (.IPK) from a window. With this tool, you do not need to enter CLI commands manually in the terminal for simple testing on an emulator. To start, click MENU in remote control emulator and select App Manager.

In the App Manager window, currently running apps are listed in Running Apps, and installed apps are listed in Installed Apps. Note that on the webOS TV Emulator v2.0.0 or later, the Installed Apps list shows user-installed apps only, and on the webOS TV emulator v1.2.0, it shows all installed apps, including preloaded apps.

Installing app

  1. Click INSTALL.
  2. In [Open] window, select a packaged app file (.ipk) and click Open. You can select multiple files to install.
  3. During installation, the progress bar is shown for each app installation progress. If you click the icon x, the installation gets canceled. Screenshot of installing an app on the App Manager
  4. When the installation is finished, the icon is shown, and the installed app ID is added at the end of Installed Apps. Note that the installed app ID might be added to the list after a delay. Screenshot of the installed app list on the App Manager

Launching app

  1. Select an app ID from Installed Apps.
  2. Click LAUNCH.
  3. Then, the selected app is launched on the emulator, and you can see the app ID is added on Running Apps.

Closing app

  1. Select an app ID from Running Apps.
  2. Click TERMINATE.
  3. The selected app is closed, and the app ID is removed from Running Apps.

Removing app

  1. Select an app ID from Running Apps or Installed Apps.
  2. Click REMOVE.
  3. The selected app is removed, and the app ID is removed from Installed Apps.

Reloading app

If you install or remove an app without using App Manager, you must click RELOAD to make it applied to Running Apps and Installed Apps immediately.

Taking screenshot

You can take a screenshot of the main screen and save it.

  1. Click MENU and select Take Screenshot.
  2. In Take Screenshot window, click Take.
  3. The screenshot image is saved in PNG format with the automatically generated filename. The screenshot file name format is "screenshot\_{yyyymmdd_hhmmss}.png" and the screenshot file is saved under {UserProfileFolder}\webOS_SDK\Screenshot.

If you remove the Screenshot folder when the emulator is executed, the image is not saved by Take Screenshot. Once the emulator is restarted, the Screenshot folder is regenerated, and the image is saved normally.

No Headings