CLI Developer Guide

This guide will take you through the app development process for webOS TV with CLI from creation to debugging. The process comprises creation, packaging, installation, launching, and debugging of an app, and if you are to use webOS TV Simulator, packaging and installation will not be necessary.

Create a web app

The first step is creating a web app using the ares-generate command from a template. There are two web app templates available.

• Basic web app template: A template of a basic web app that displays the “Hello World” message on a screen
• Hosted web app template: A template of a hosted web app

The webOS TV CLI further provides templates for JS services, config files, etc. For the list of all available templates, see App Templates, or use the following command.

ares-generate --list

Create a basic web app

The basic template provides a “Hello World” web app with the minimum essential files. This template is useful if you are to use other UI frameworks.

Execute the following command to create a basic web app into the./sampleApp directory.

ares-generate -t basic ./sampleApp

The following table lists the files of a web app that the template provides:

Create a hosted web app

The hosted_webapp template provides a hosted web app that contains a redirect URL with the minimum essential files.

Execute the following command to create a hosted web app into the ./sampleApp directory.

ares-generate -t hosted_webapp ./sampleApp

The following table lists the files of a hosted web app that the template provides:

Create a JS service

The js_service template provides a sample JS service running as a background service on webOS TV. The sample JS service responds to simple messages for a service request.

Execute the following command to create a JS service from the template to the ./sampleService directory.

ares-generate -t js_service ./sampleService

The following table lists the files of the sample JS service with the description:

Create an appinfo.json file from template

The webappinfo template provides anappinfo.json file with sample values. If you are building a new web app without a template or using the existing web app which was not made from a template, you should add the appinfo.json file into your app. This file holds the app’s name, ID, app type, icon image, and the main page information.

Execute the following command to create an appinfo.json file from the template into the sampleApp directory.

ares-generate -t webappinfo ./sampleApp

The following is the sample appinfo.json file created from the template.

{
  "id": "com.domain.app",
  "version": "0.0.1",
  "vendor": "My Company",
  "type": "web",
  "main": "index.html",
  "title": "new app",
  "icon": "icon.png",
  "largeIcon": "largeIcon.png"
}

Deploy the web app on a TV device

This section describes how to package the web app and install it on a webOS TV device. You will be using ares-package, ares-install, and ares-setup-device to deploy web apps.

If you are using webOS TV Simulator, skip this step and move to Launch the web app.

Package the web app

The first step is to create a package file (.ipk) of your app using the ares-package command.

Before executing the packaging command, you need to check if the essential files exist. The ares-package command finds and reads the appinfo.json file, where required fields, such as main and icon, are defined, from the app directory. For the same reason, the icon image file and main page file also must exist in the correct path.

Package the web app only

Execute the following command to package the app in the ./sampleApp directory.

ares-package ./sampleApp

Package the web app with JavaScript service

Execute the following command to package the app in the sampleApp directory together with the service in the sampleService directory.

ares-package ./sampleApp ./sampleService

Now you can see that the package file exists in the directory from which you execute the command.

Install the web app

Install the created package file on your device using theares-install command. You can also see the list of target devices using the ares-install command. Use theares-setup-device command to modify the settings of a device.

List target devices

Use the ares-setup-device command to check the name, platform type, description, and SSH access address of target devices.

Execute the following command to see the list of target devices.

ares-setup-device --list

The following is the sample result of the command. The emulator is included in the default device list.

name        deviceinfo                 connection    profile
---------   ------------------------   ------------  --------
emulator    developer@127.0.0.1:6622   ssh           tv
tv          prisoner@10.123.45.67      ssh           tv

With the ares-setup-device command, you can check the list with more details with -F, --listfulloptions. The following shows the command and the sample result.

ares-setup-device --listfull
[
  {
    "profile": "tv",
    "name": "tv",
    "deviceinfo": {
        "ip": "10.123.45.67",
        "port": "9922",
        "user": "prisoner"
    },
    "connection": [
        "ssh"
    ],
    "details": {
        "platform": "starfish",
        "privatekey": "tv_webos",
        "passphrase": "ares-setup-device --full",
        "description": "new device"
    }
  },
  {
    "profile": "tv",
    "name": "emulator",
    "deviceinfo": {
        "ip": "127.0.0.1",
        "port": "6622",
        "user": "developer"
    },
    "connection": [
    "ssh"
    ],
    "details": {
        "platform": "starfish",
        "privatekey": "webos_emul",
        "description": "LG webOS TV Emulator"
    }
  }
]

Modify the settings of a target device

The default loopback address needs to be changed to the remote host address if you are using the emulator on the remote computer for testing. The following example describes how to set the host address of the emulator to the target device.

ares-setup-device --modify emulator --info "host=10.177.231.137"

Re-check the device list to confirm if the host address of the target device has been modified as shown in the following example.

ares-setup-device --list

name     deviceinfo                     connection  profile
-------- -----------------------------  ----------  -------
tv       prisoner@10.123.45.67          ssh         tv
emulator developer@10.177.231.137:6622  ssh         tv

There is another way to change the target device’s information with the interactive mode of the ares-setup-device command. The following example shows how to change the target device’s host address in the interactive mode. Run the ares-setup-device command with no option, and it will show the list of target devices and start the interactive mode as below.

ares-setup-device

name     deviceinfo                connection  profile
-------- ------------------------  ----------  --------
tv       prisoner@10.123.45.67     ssh         tv
emulator developer@127.0.0.1:6622  ssh         tv

** You can modify the device info in the above list, or add new device.
? Select
> add
  modify
  remove

If you do not want to change the previous value, press the enter key without any value. For more information about the command usage, see ares-setup-device.

Install the package file of your web app

Make sure that your target device is running. Execute the following command with the name of the target device and package file as parameters to to install the package file on the target device.

ares-install --device myTV ./com.domain.app_0.0.1_all.ipk

If the installation is successful, you will see a success message.

To verify the installation, execute the following command to see the list of installed app IDs and check that your app ID exists in the result.

ares-install --device myTV --list

Remove a web app

Use the ares-install command with the--remove option to remove an app from the device. You need to enter the app ID to remove as a parameter. Execute the following command to remove your app from the target device.

ares-install --device myTV --remove com.domain.app

Run the web app

Use the ares-launch command to launch or close your web app.

Launch the web app

Execute the ares-launch command with the device name and app ID as parameters to launch the app on the target device.

ares-launch --device myTV com.domain.app

After executing the command, check if your app started on the target device.

Close the web app

Execute the ares-launch command with the--close option, in addition to the name of the target device and the app ID used to launch the app, to close the app on the target device.

ares-launch --device myTV --close com.domain.app

Debug the web app

You can monitor the execution information of web apps or JS services running on the target device with Web Inspector and Node Inspector, and to do so, you need to create a package file (.ipk) without minifying. This section describes how to create a package file and execute Web Inspector and Node Inspector for debugging purposes.

Package the web app without minifying

When creating a package file (.ipk), the ares-packagecommand reduces and merges the source code and adjusts and shrinks variable names and line spacing, which is called minifying. Minifying makes debugging difficult.

Therefore, for debugging purposes, use the --no-minifyoption of the ares-package command to omit the minifying task.

ares-package --no-minify ./sampleApp

Launch Inspectors

The webOS TV provides Web Inspector and Node Inspector for debugging of web apps and JS services, respectively.

Launch Web Inspector

For debugging of web apps, the ares-inspect command provides Web Inspector that displays the execution information of apps.

Execute the following command while the app is running:

ares-inspect --device myTV --app com.domain.app --open

With the --open option, Web Inspector opens on the default browser of your PC. Note that Web Inspector and Node Inspector work properly on Chromium-based browsers.

To use the Inspectors, the proper version of Chromium, compatible with the webOS TV version, should be installed on your PC. The following table lists the compatible Chromium version by webOS TV version and their download links.

You will see Web Inspector as in the below image.

Launch Node Inspector

For debugging of JS services, the ares-inspect command also provides Node Inspector that displays the execution information of JS services.

Execute the following command while the JS service is working:

ares-inspect --device myTV --service com.domain.app.myservice --open

You will see Node Inspector as in the below image:

Test the web app

This section describes how to test your web app on the TV device or the Simulator with CLI. About debugging of a web app on VS Code Extension, see Debug the web app on VS Code Extension.

Test without installation

You can test code changes to your web app without packaging, installing, and running the app on a TV device.

The the --hosted(-H) option of theares-launch command allows you to test the code changes easily on the TV device. If the --hosted option is used with the app directory, an app with idcom.sdk.ares.hostedapp is launched on the device and it opens the files in the directory. From CLI v1.12.0, the auto-reloading function is added, so as soon as you make and save modification to your app files, the app on the TV device is automatically reloaded.

Example

The following is an example of testing a sample app after creating it using CLI without steps for packaging and installation.

# Generate the sample app for test
$ ares-generate ./sampleApp
? app id com.domain.app
? title new app
? version 0.0.1
Generating basic in ./sampleApp
Success

# Test the sample app on the target device (name: myTV) without packaging and installation
$ ares-launch -H ./sampleApp -d myTV
Installing package
./sampleApp/com.domain.app.ipk
Ares Hosted App is now running...

• To terminate, enter Ctrl + C.

How to ignore specific files from auto-reloading

To exclude certain files with specific extensions or under specific directories from auto-reloading, create a .reloadignore file. This .reloadignore file should be located in the root directory of the app to test, and the file itself will be excluded from packaging of the app.

Add the absolute or relative path of the files or directories to exclude from auto-reloading into the .reloadignore file. Each item will be distinguished by a line feed, and the relative path of items (except for cases starting with **) will be converted into an absolute path based on the root directory of the app before being applied.

Even if you modify the .reloadignore file while auto-reloading is on, the modification will apply immediately without needing to terminate and re-run the command.

The following is an example of a .reloadignore file.

appinfo.json
tests
**/tmp
**/*.png

• appinfo.json - The appinfo.json file in the root directory will be ignored.
• tests - Directories and files under the tests directory in the root directory will be ignored.
• **/tmp - Any tmp directories and files in the app’s working directory will be ignored.
• **/*.png - Any files with the .png extension in the app’s working directory will be ignored.

With this option, however, you cannot test apps that include JS services.

Test on the Simulator

The ares-launch command with the--simulator option runs webOS TV Simulator to test an app.

With the command, the location of the simulator is identified based on the environment variable, LG_WEBOS_TV_SDK_HOME, and the execution file of webOS TV Simulator, of the specified version by the--simulator option, is run.

For how to install and use Simulator, see Simulator Installation and Simulator Developer Guide.

The following is an example of running the selected-version simulator and testing ./sampleApp using CLI.

$ ares-launch --simulator 24 ./sampleApp

Finding simulator in /webOS_TV_SDK/Simulator
Launched webOS_TV_24_Simulator_1.0.0.appimage

Test on a local server

The ares-server command runs a web server for testing a local file. The web server will run on the given path.

Execute the command to start a web server on your app source directory.

ares-server ./sampleApp

You can open your app with the given URL.

Local server running on http://localhost:7496

If you want to open with the default browser of your PC directly, use--open option as below:

ares-server ./sampleApp --open

Monitor the resource usage

The function for monitoring the usage of CPU and memory, which has been provided in Beanviser, is added in CLI from v1.12.0.

Using the ares-device-info command with the--resource-monitor (-r) option, you can monitor the usage of CPU and memory at system or process level. You can also set the time interval to get the usage data periodically and save the data in a .csv file.

For details about each option and parameter, see ares-device-info.

Monitor at system level

This example displays the system-level CPU and memory usage.

# Display resource usage
$ ares-device-info -d myTV -r
 
2022-02-17 08:46:13
 
(%)   overall  usermode  kernelmode  others
----  -------  --------  ----------  ------
cpu   2.41     0         1.38        1.03
cpu0  1.05     0         1.05        0
cpu1  1.03     0         1.03        0
cpu2  4.12     0         1.03        3.09
 
(KB)    total    used    free    shared  buff/cache  available
------  -------  ------  ------  ------  ----------  ---------
memory  1023356  245668  458604  1552    319084      727128
swap    0        0       0
 
=================================================================
 
 
# Display resource usage every one second and save them to the resource.csv file
$ ares-device-info -d myTV -r -s resource.csv -t 1
 
Create resource.csv to D:webOS_TV_SDK\CLI\bin
2022-02-17 08:47:02
 
(%)   overall  usermode  kernelmode  others
----  -------  --------  ----------  ------
cpu   1.37     0         1.37        0
cpu0  1.02     0         1.02        0
cpu1  1.03     0         1.03        0
cpu2  2.04     0         2.04        0
 
(KB)    total    used    free    shared  buff/cache  available
------  -------  ------  ------  ------  ----------  ---------
memory  1023356  245576  458688  1552    319092      727220
swap    0        0       0
 
=================================================================
2022-02-17 08:47:03
 
(%)   overall  usermode  kernelmode  others
----  -------  --------  ----------  ------
cpu   1.02     0         1.02        0
cpu0  3        1         2           0
cpu1  0        0         0           0
cpu2  2.04     0         1.02        1.02
 
(KB)    total    used    free    shared  buff/cache  available
------  -------  ------  ------  ------  ----------  ---------
memory  1023356  245684  458580  1552    319092      727112
swap    0        0       0
 
=================================================================

To terminate the periodic monitoring of resource usage, enterCtrl + C.

Monitor at process level

This example displays the process-level CPU and memory usage.

# Launch your app before test
$ ares-launch -d myTV com.domain.app
Launched application com.domain.app
 
# Display resource usage of running apps and services
$ ares-device-info -d myTV -r -l
 
2022-02-17 08:51:51
 
PID   ID                 CPU(%)  MEMORY(%)  MEMORY(KB)
----  -----------------  ------  ---------  ----------
2336  com.domain.app  0.34    8.01       76060
2439  test               0       8.21       77924
 
======================================================================
 
# Display resource usage of specified running app
$ ares-device-info -d myTV -r -id com.domain.app
 
2022-02-17 08:52:53
 
PID   ID                 CPU(%)  MEMORY(%)  MEMORY(KB)
----  -----------------  ------  ---------  ----------
2336  com.domain.app  0.34    8.01       76060
 
======================================================================

Commands

The following table lists the commands you can use.

ares-generate

Creates an app from a template. The ares-generatecommand with the --list option displays a list of available templates.

Usages

ares-generate [OPTION...] APP_DIR|SERVICE_DIR
ares-generate --list|-l
ares-generate --version
ares-generate --help|-h

Options

Parameters

Examples

Here are some examples of CLI usage:

• Check the list of templates

  ares-generate -l
  
  basic          Web App          -  (default) basic web app for webOS
  TV
  hosted_webapp  Web App          -  hosted web app for webOS TV
  webappinfo     Web App Info     -  appinfo.json for web app
  js_service     JS Service       -  js service for webOS TV
  jsserviceinfo  JS Service Info  -  services.json, package.json for JS
  service
  packageinfo    Package Info     -  packageinfo.json for webOS package
  

• Create a web app from the default template

  ares-generate sampleApp
  
  ? app id com.example.sampleapp
  ? title Sample App
  ? version 0.0.1
  Generating basic in C:\webOS_TV_SDK\CLI\sampleApp
  Success
  

• Create a web app with a custom app ID in the./sampleApp directory

  ares-generate -p "id=com.example.sampleapp" sampleApp
  
  Generating basic in C:\webOS_TV_SDK\CLI\sampleApp
  Success
  

• Create a web app from the hosted web app template in the./sampleApp directory

  ares-generate -t hosted_webapp sampleApp
  
  ? app id com.example.hostedapp
  ? title Hosted App
  ? version 0.0.1
  ? url http://webostv.hostedapp.lge.com
  Generating hosted_webapp in C:\webOS_TV_SDK\CLI\sampleApp
  Success
  

• Create a JS service with a custom service ID in the./sampleService directory. Note that the service ID must be the sub-domain of the app ID to which the service belongs.

  ares-generate -t js_service -s com.example.sampleapp.sampleservice sampleService
  

• Create a web app in the ./sampleApp directory and set properties with JSON strings

  ares-generate -p "{'id':'com.example.sampleapp', 'version':'0.0.1', 'icon':'icon.png', 'type':'web', 'title':'Sample App', 'main':'index'}" sampleApp

ares-package

Packages your app and JS service into a package file (.ipk) stored in a specified directory. With the info orinfo-detail option, you can check the information about the package file.

The packaging process has two phases: minifying source code; and creating a package file. The ares-package command reduces the size of the source code by getting rid of as much redundant code as possible and merges it when creating a package file. The ares-package command adjusts and shrinks the variable names and line spacing and merges multiple files into a single file to reduce the code size and file load time.

Usages

ares-package [OPTION...] APP_DIR [[SERVICE_DIR][PKG_DIR][...]]
ares-package -i, --info PACKAGE_FILE
ares-package -I, --info-detail PACKAGE_FILE
ares-package --version
ares-package -help|-h

Options

Parameters

Examples

Here are some examples of different uses:

• Create a package file from the ./sampleApp directory and output it in the working directory

  ares-package sampleApp

• Create a package file from the ./sampleApp directory and output it in ./output directory

  ares-package -o output sampleApp

• Create a package file for debugging (without minifying)

  ares-package --no-minify sampleApp

• Create a package file except for testCode1sub-directory, README.md file and all text files (.txt)

  ares-package -e "testCode1" -e "README.md" -e "*.txt" samplePrj

• Create a package file with a external JS service directory

  ares-package sampleApp sampleService

• Analyze a package file

  ares-package -i ./com.examples.app_1.0.0_all.ipk

• Analyze a package file in detail

  ares-package -I ./com.examples.app_1.0.0_all.ipk

ares-setup-device

Displays a list of registered target devices. You can also add, modify, or remove a device from the list. This command is mainly used to modify a target host address that is running on a remote host.

Usages

ares-setup-device
ares-setup-device [OPTIONS...] --add|-a [TARGET_NAME] [--info|-i [DEVICE_INFO]]
ares-setup-device [OPTIONS...] --modify|-m [TARGET_NAME] [--info|-i [DEVICE_INFO]]
ares-setup-device [OPTIONS...] --remove|-r [TARGET_NAME]
ares-setup-device [OPTIONS...] -f, --default [TARGET_NAME]
ares-setup-device --search|-s
ares-setup-device [--search|-s] --timeout|-t [TIMEOUT]
ares-setup-device --reset|-R
ares-setup-device --list|-l
ares-setup-device --listfull|-F
ares-setup-device --version|-V
ares-setup-device --help|-h

Options

Parameters

The following example shows a DEVICE_INFO written in JSON format:

{"host":"127.0.0.1", "port":"6622"}

Examples

Here are some examples of CLI usages:

• List target devices

  ares-setup-device --list

• Add a target device (Target device name: sampleEmulator, Host address: 10.123.45.67, Port number: 6622 User: developer)

  ares-setup-device --add sampleEmulator -i "host=10.123.45.67" -i "port=6622" -i "username=developer"

• Add a target device with JSON format (Target device name: sampleEmulator, Host address: 10.123.45.67, Port number:6622 User: developer)

  ares-setup-device --add sampleEmulator --info "{'host':'10.123.45.67', 'port':'6622', 'username':'developer'}"
  

• Add a target device with interactive mode (Target device name: sampleEmulator, Host address: 10.123.45.67, Port number: 6622, User: developer)

  ares-setup-device
  
  name deviceinfo connection Profile
  -------- ------------------------ ---------- -------
  emulator developer@127.0.0.1:6622 ssh        tv
  
  ** You can modify the device info in the above list, or add a new device.
  
  ? Select: add
  ? Enter Device Name: sampleEmulator
  ? Enter Device IP address: 10.123.45.67
  ? Enter Device Port: 6622
  ? Enter ssh user: developer
  ? Enter description: sample
  ? Select authentification: ssh key
  ? Enter ssh private key filename: webOS_emul
  ? Enter keys passphrase:
  ? Save? Yes
  
  name deviceinfo connection profile
  -------- --------------------------- ---------- -------
  emulator developer@127.0.0.1:6622 ssh tv
  sampleEmulator developer@10.123.45.67:6622 ssh tv
  

  Note

  If you want to input the default value or set it empty, press the enter key without any value.
• Modify a target device (Target device name: sampleEmulator, Port Number: 9922)

  ares-setup-device --modify sampleEmulator -i "port=9922"

• Modify a target device with interactive mode (Target device name: sampleEmulator, Port number: 9922)

  ares-setup-device
  
  name deviceinfo connection profile
  -------------- --------------------------- ---------- -------
  emulator       developer@127.0.0.1:6622    ssh        tv
  sampleEmulator developer@10.123.45.67:6622 ssh tv
  
  ** You can modify the device info in the above list, or add a new device.
  ? Select: modify
  ? Enter Device Name: sampleEmulator
  ? Enter Device IP address: 10.123.45.67
  ? Enter Device Port: 6622
  ? Enter ssh user: developer
  ? Enter description: sample
  ? Select authentification: ssh key
  ? Enter ssh private key filename: webOS_emul
  ? Enter keys passphrase:
  ? Save? Yes
  
  name deviceinfo connection
  -------------- --------------------------- ----------
  emulator       developer@127.0.0.1:6622    ssh
  sampleEmulator developer@10.123.45.67:9922 ssh
  
  Success to modify a device!!
  

  Note

  If you want to keep the previous value, press Enter without any value.
• Remove a target device (Target device name: sampleEmulator)

  ares-setup-device --remove sampleEmulator

• Search for webOS devices

  ares-setup-device --search

• Set a device as the default device

  ares-setup-device -f DEVICE

ares-install

Installs your app for a specified app package file (.ipk) on a target device. You can also see the list of apps installed on the target device or remove them using this command.

Usages

ares-install [OPTION...] PKG_FILE
ares-install [OPTION...] --remove APP_ID
ares-install [OPTION...] --list|-l [--type|-t APPLICATION_TYPE]
ares-install [OPTION...] --listfull|-F [--type|-t APPLICATION_TYPE]
ares-install --device-list|-D
ares-install --version|-V
ares-install --help|-h

Options

Parameters

Examples

Here are some examples of CLI usages:

• List available target devices

  ares-install --device-list

• Install the app of which the package name iscom.example.sampleapp_0.0.1_all.ipk on the emulator

  ares-install --device emulator com.example.sampleapp_0.0.1_all.ipk

• List the apps that are installed on the emulator

  ares-install --device emulator --list

• List the apps of which the app type is web

  ares-install --device emulator --list --type web

• Remove the app of which the app ID iscom.example.sampleapp from the emulator

  ares-install --device emulator --remove com.example.sampleapp

ares-launch

Runs or terminates an app installed on a target device. This command can also display the list of apps running on the target device.

Usages

ares-launch [OPTION...] APP_ID
ares-launch [OPTION...] --hosted|-H APP_DIR [--host-ip|-I HOST_IP]
ares-launch [OPTION...] --close|-c APP_ID
ares-launch [OPTION...] --running|-r
ares-launch [OPTION...] --simulator|-s WEBOS_TV_VERSION APP_DIR
ares-launch --device-list|-D
ares-launch --version|-V
ares-launch --help|-h

Options

Parameters

Examples

Here are some examples of different usages:

• Run the app of which the app ID iscom.example.sampleapp on the emulator

  ares-launch --device emulator com.example.sampleapp

• Run the app with the URL parameter

  ares-launch --device emulator com.example.sampleapp --params "{'url':'www.lge.com'}"

  Note

  When you use a parameter, the app receives the parameter with thewebOSLaunch event. For more information about webOSLaunch event, see App Lifecycle.
• List the apps that are running on the emulator

  ares-launch --device emulator --running

• Terminate the app of which the app ID iscom.example.sampleapp on the emulator

  ares-launch --device emulator --close com.example.sampleapp

• Run the app in the sampleApp directory without installation

  ares-launch --device emulator --hosted sampleApp

• Run the app in the sampleApp directory without installation using the host IP address 192.168.0.10 on the emulator

  ares-launch --device emulator --hosted sampleApp --host-ip 192.168.0.10

• Run the app in the sampleApp directory on the webOS TV 23 Simulator

  ares-launch -s 23 sampleApp

• Run the app in the sampleApp directory with two parameters on the webOS TV 23 Simulator

  ares-launch -s 23 APP_DIR -p "{'data1':'foo', 'data2':'bar'}"

  ares-launch -s 23 APP_DIR -p "data1=foo" -p "data2=bar"

ares-inspect

Provides Web Inspector and Node Inspector.

Web Inspector and Node Inspector run on a web browser. Each inspector displays the running information about your web app or JS service.

Usages

ares-inspect [OPTION...] [--app|-a] APP_ID
ares-inspect [OPTION...] --service|-s SERVICE_ID
ares-inspect --version|-V
ares-inspect --help|-h

Options

Parameters

Examples

Here are some examples of different usages:

• Launch Web Inspector for the app of which the app ID iscom.example.sampleapp

  ares-inspect --device emulator --app com.example.sampleapp

• Launch Node Inspector for the JS service of which the app ID iscom.example.sampleapp.sampleservice

  ares-inspect --device emulator --service com.example.sampleapp.sampleservice

ares-server

Runs a web server for testing local files.

The web server runs on the given path. You can terminate the web server with control-C (in Windows, Linux) or Command-C (in macOS).

Usages

ares-server [OPTION...] APP_DIR
ares-server --version|-V
ares-server --help|-h

Options

Parameters

Examples

Here are some examples of different usages:

• Run the web server in a source directory

  ares-server ./source

• Run the web server with the browser

  ares-server ./source --open

ares-novacom

Gets a private key from webOS TV for the Developer Mode app.
After getting the private key, you can install and launch apps or run a command on webOS TV.

Usages

ares-novacom [OPTION...] --forward|-f [--port|-p DEVICE_PORT1[:HOST_PORT1]][--port|-p DEVICE_PORT2]][...]
ares-novacom [OPTION...] --getkey|-k
ares-novacom [OPTION...] --run|-r DEVICE_COMMAND
ares-novacom --device|-d
ares-novacom --device-list
ares-novacom --version|-V
ares-novacom --help|-h

Options

Parameters

Examples

Here are some examples of different usages:

• Get the private key from webOS TV named tv (Needed the Developer Mode app setting)

  ares-novacom --device tv --getkey

• Set port forwarding between emulator (6622) and host PC (3030)

  ares-novacom --device emulator --forward --port 6622:3030

• Run the ps aux command on webOS TV namedtv

  ares-novacom --device tv --run "ps aux"

ares-device-info

Retrieves the following system information of a device.

• Model name
• SDK version
• Firmware version
• Board type
• OTA (Over The Air) ID

Note that only retrieved information is shown if this command fails to retrieve some system information. With theresource-monitor option, you can monitor CPU (%) and memory (KB) usage of the target device or running apps and services.

Usages

ares-device-info
ares-device-info [OPTION...]
ares-device-info [OPTION...] --resource-monitor|-r
ares-device-info --device|-d
ares-device-info --device-list|-D
ares-device-info --version|-V
ares-device-info --help|-h

Options

Parameters

Examples

Here are some examples of CLI usages:

• List available target devices

  ares-device-info --device-list

• Retrieve a device’s valid system information

  ares-device-info --device target**
  
  modelName: WEBOS4.0
  sdkVersion: 04.00.00
  firmwareVersion: 04.00.00
  boardType: M16PP_ATSC_KR
  otaId: HE_DTV_W18H_AFADATAA
  

• Display the resource usage

  ares-device-info -d Device -r

• Display the resource usage periodically and saving the data into a CSV file

  ares-device-info -d DEVICE -r -s resource.csv -t 1

• Display the resource usage by running apps and services

  ares-device-info -d DEVICE -r -l

• Display the resource usage by the specified running app every three seconds

  ares-device-info -d DEVICE -r -id com.example.app -t 3

ares-extend-dev

Extends the session time of the developer mode for the Developer Mode app.

Note that this command only works when the Developer Mode is on and the session time remains longer than 0 minutes.  If this command does not update the session time, check your network connection or the developer mode status.  DO NOT use this command on the emulator as the Developer Mode app cannot be installed on the emulator.

Usages

ares-extend-dev [OPTION...]
ares-extend-dev --device-list|-D
ares-extend-dev --version|-V
ares-extend-dev --help|-h

Options

Parameters

Examples

Here are some examples of CLI usages:

• List available target devices

  ares-extend-dev --device-list

• Extend the session time of the Developer Mode on webOS TV namedtv

  ares-extend-dev -d tv