App Testing

After you complete developing the app, you might need to test your app. The Developer Mode app provides a faster way to install, debug, and test webOS TV apps on the TV. The following introduces the concept behind the Developer Mode app that connects between the TV and the PC.

The Developer Mode app on the webOS TV connecting with a laptop

To use the Developer Mode app, the following should be ready in advance:

  • webOS TV connected with a network

  • PC connected with a network and installed with the webOS TV SDK

  • LG Developer site account
    The Developer Mode app requires you to sign in to the LG Developer site. If you do not have an account yet, see Preparing a Login Account.

This article provides:

Preparing a Login Account

To use the Developer Mode app, you must be a member of the LG Developer site. If you are not a member of the site, follow the below steps to create an account on the LG Account. If you already have the account for the LG Developer site, skip this section and go on to Installing Developer Mode App

  1. Go to the Sign In.

  2. Select the CREATE ACCOUNT tab. The Select Country pop-up appears.
    Create Account tab

  3. Select your country from the drop-down menu and click CONFIRM.

  4. Read through and accept our Terms & Conditions and Privacy Policy on the Accept Terms & Conditions screen.

  5. Click AGREE to create your new LG Account.

  6. Enter your email address as User ID, password, and date of birth.

  7. Select whether to subscribe to our mailing list, then click CONFIRM.

  8. We will send you a verification email to your address. Click CONFIRM in the verification email to complete verification.

  9. Verification Email

  10. Once the Account Created screen appears, go to the Sign In again.

  11. Sign in to LG Developer using your new LG Account credentials.

  12. From the My Account screen, enter additional information required and click Save.

Installing Developer Mode App

To install the Developer Mode app, follow the steps below:

  1. Turn on your webOS TV and check if your webOS TV is connected to a network.

  2. Sign in with your LG Developer site account.

  3. Go to the LG Content Store.

  4. Search for "Developer Mode."

  5. Select the Developer Mode app and click the Install button.

Turning Developer Mode On

After installing the Developer Mode app, you can enable Developer Mode on your TV.

  1. Run the Developer Mode app from the webOS TV Launcher.

  2. Enter your email-based ID and password of the LG Developer site. See Preparing Account.
    The sign in screenshot of the Developer Mode app

  3. Click the Dev Mode Status button to enable the Developer Mode. The TV will reboot.
    The screenshot of Developer Mode app

Developer Mode is disabled when:

  • The TV has been rebooted ten times while the TV is not connected to a network (webOS TV v1.x and v2.0).

  • Developer Mode has been enabled for 50 hours.

  • The Developer Mode login session is terminated.

If you sign in to multiple TVs with one account, only the session of the latest TV that you sign in to is maintained. 

After Developer Mode is disabled, the apps that are installed while you were using on Developer Mode are uninstalled, and you will be taken to the log-in screen of the Developer Mode app.

Connecting TV and PC

This section describes how to connect webOS TV and your PC. You can use either the CLI or IDE for the Developer Mode app.

Connecting with CLI

Follow the instructions below to add the target TV with the CLI:

  1. Run the webOS TV CLI.

  2. Execute the ares-setup-device command. Then, select add.

    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 new device.
    ? Select: (Use arrow keys)
    > add
    modify
    remove

  3. Input the information about your TV as below example:

    You do not need to enter the password. When using the Developer Mode app, a password is not required.

    ** You can modify the device info in the above list, or add new device.
    ? Select: add
    ? Enter Device Name: tv2
    ? Enter Device IP address: 10.123.45.67
    ? Enter Device Port: 9922
    ? Enter ssh user: prisoner
    ? Enter description: new device
    ? Select authentification: password
    ? Enter password:
    ? Save ? Yes
    name deviceinfo connection profile
    -------- -------------------------- ---------- -------
    tv2 prisoner@10.123.45.67:9922 ssh tv
    emulator developer@127.0.0.1:6622 ssh tv

  4. After adding your TV as the target device, check the result with the command below:

    ares-setup-device -list
  5. Click the Key Server button in the Developer Mode app.
    The Key Server button on the Developer Mode app

  6. Get the key file from your webOS TV with the following command on your PC:

    ares-novacom --device tv2 --getkey

  7. A command prompt appears to enter Passphrase. Enter the exact characters (case sensitive) as displayed on your TV screen.
    You can see Passphrase, which consists of 6 characters on the bottom left side of the Developer Mode app screen.

    input passphrase [default: webos]:

  8. Check the connection with your TV and PC with the following command:

    ares-install --device tv2 --list

  9. Now, you are ready to install and launch your app on your real TV. To find out how to install and launch your app on your TV, go to Installing and launching your app using CLI.

Connecting with IDE

Follow the instructions below to add your TV as the target device using the IDE:

  1. Run the webOS TV IDE.

  2. Click New Connection (New Connection icon) from the Target Configuration screen.

  3. Enter the information about your TV as below example:

    • Set Device Type as LG Smart TV.

    • Change Device Name as you want

    • Input the IP address of your TV.

    The New Target Connection window of webOS TV IDE

  4. Click the Key Server button in the Developer Mode app.
    The Key Server Button of the Developer Mode app

  5. Right-click the created target device and select Generate Key.
    The Generate Key menu of webOS TV IDE

  6. The webOS key window appears to enter Passphrase. Enter the exact characters (case sensitive) as displayed on your TV screen.
    You can see Passphrase, which consists of 6 characters on the bottom left side of the Developer Mode app screen.
    The Passphrase on the webOS key generator

  7. Connect your TV using the right-click menu. Then you can see the apps you installed on the TV under tv > Installed. If it is your first time using the Developer Mode app, no app is shown on the screen.
    Installed app icon on the Target Configuration tab in webOS TV IDE

  8. Now, you are ready to install and launch your app on your real TV. To find out how to install and launch your app on your TV, go to Installing and launching your app using IDE.

Extending Developer Mode Time

Developer Mode enables for a limited time. When you turn on Developer Mode, you can check the remaining session time on the Remain Session field. To extend the remaining time, click the EXTEND button. Even the session time has run out, if you do not turn your TV off, you can extend the time with the EXTEND button.

The Extend button on the Developer Mode app

Clearing Cache Data of Apps

The Developer Mode app provides the Clear Cache Data feature for testing. Note that all apps' cache data is removed. To clear cache data of all apps, follow the instructions below:

  1. Click the ON button on the Clear Cache Data field.
    The Clear Cache Data button on the Developer Mode app

  2. Reboot the TV.

Navigation