webOS Studio FAQ

General

Q. What are the different types of projects that can be created in the extension?

Supported types are as follows:

TypeDescription
Basic Web AppCreates a sample HTML "hello world" app that has a standard webOS file system.
Hosted Web AppCreates a sample HTML app with an example to show some external page in-app with standard webOS file system.
Web App InfoA dummy web app, which contains only appinfo file to use with any already developed HTML app.
JS ServiceA simple JS service with a service file.
JS Service InfoA dummy service info directory, which is used for reference of standard service information.
Basic Enact AppCreates an enact Sample app as per selected template.

Q. What is "Add webOS library", and when is it needed?

This feature adds webos-service library to your project. The webos-service library is to call LS2 APIs in the app/service.

Q. Getting an error while packaging the app, when my folder path contains special characters.

Workspace path and name should not contain any escape or special characters. It can trigger errors on add, package, install operations.

Q. How to resolve errors in Notification Area?

This is the list of errors you may see with their meaning and possible ways to resolve them.

ErrorDescription
ERROR! Failed to get the device list.Some dependent packages are not available on the local system. To resolve this issue, install the packages either manually or by clicking Yes when prompted (if you previously closed the prompt without installing, click the refresh button in the KNOWN DEVICE view to get prompted again).
ERROR! Failed to list the applications installed on (device)The device is not running.
ERROR! Failed to list the applications running on (device)The device is not running.
ERROR! Please check IP address or port of(device)The device is not reachable.
ERROR! Unable to find the Virtual BoxUpdate the environment path variable to point to the VirtualBox installation directory.

ERROR! Packaging App Failed. Details As follows:(errMsg)

Failed to package the app due to one of the following:

  • Check the ID format. Only lowercase letters(a-z), digits(0-9), minus signs, and periods are allowed.

  • Check the version format. It should be something like 1.0.0.

  • Only a valid app can be packaged. Make sure the directory includes 'appinfo.json'.

  • Some dependent resources (such as images, libraries, and modules) that are required for the project are missing. Add manually or through the npm command.

Package Manager

Q. I am trying to install a tool through the Package Manager on my Windows PC, but it shows infinite verifying message.

It happens on some Windows PCs. In such case, add wmic to the system PATH environment variable.

Emulator

Q. I have not added any device in the KNOWN DEVICE view, yet I can see the device named emulator.

By default, emulator is added in the KNOWN DEVICE view. This emulator is running on the local system. If your emulator instance is not set up, go to the EMULATOR MANAGER view and add the emulator instance.

Q. I installed an Emulator but cannot see or launch it on the Emulator Manager.

If you are a Windows user and want to use Emulators, the installation directory of VirtualBox should be included in the system PATH environment variable.

Debugging

Q. The "Run and Debug" view is not opened. How can I open it?

Click View > Open View... > Run and Debug.

Q. The debugging session is not launched. How can I launch it?

Close all running apps on the webOS device and re-try to click Debug on.

Q. (Very rare to happen) A notification says the debugging session is already activated. What shall I do?

If you get this notification, even when all debug sessions are closed, restart the VS Code and try to start a debugging session again.

Q. "Debug on VS Code" does not work for older webOS TV platforms. How can I debug?

No Headings