Target Device

This topic describes how to test your Web application by running or debugging it on a device.

If you have developed your application on the simulator, it is ready for uploading and testing on a device. It is highly recommended that you also test your application on a target device because there are some unsupported features on the simulator.

Prerequisites

To install your application on a device in common:

Connecting the Device and SDK

To connect the device to the SDK as a remote device:

  1. Enable Developer Mode on the device:

    1. On the device, go to the menu "URL Launcher Settings > Developer Mode".

    2. Switch "Developer mode" to "On".

      Figure 1. Developer Mode location

      Figure 1. Developer Mode location

    3. Enter the IP address of the computer that you want to connect to the device, and click "OK".

    4. Reboot the device.

      Figure 2. Enter the IP address

      Figure 2. Enter the IP address

  2. Connect the device to the SDK:

    1. In the Tizen Studio, select "Tools > Device Manager".
      The Device Manager launches.
      Figure 3. Device Manager

      Figure 3. Device Manager

    2. To add a device, click "Remote Device Manager" and "+".
      Figure 4. Remote Device Manager

      Figure 4. Remote Device Manager

    3. In the "Add Device" popup, define the information for the device you want to connect to, such as the name, IP address, and port number, and click "Add".
      Figure 5. Add Device dialog

      Figure 5. Add Device dialog

    4. In the Device Manager window, select the device from the list, and switch "Connection" to "On".
      Figure 6. Switch connection on

      Figure 6. Switch connection on


      Now you can launch applications on the device directly from the Tizen Studio.

Launching Applications on the Device

You can launch your application on the target device in normal or debug mode:

  • To launch the application in normal mode, right-click the project in the "Project Explorer" view, and select "Run As" and a specific launch mode:

    • "Tizen Web Application": Run the application on the connected device.
    • "Tizen Web Unit Test Application": Run the application with unit tests.
  • To launch the application in debug mode, right-click the project in the "Project Explorer" view, and select "Debug As > Tizen Web Application".
    The Web Inspector runs automatically when you launch the application in debug mode. It is based on the WebKit Web Inspector, and has been modified to support remote debugging.

    Figure 7. Web Inspector

    Figure 7. Web Inspector

Troubleshooting

The following are common issues you can encounter when working with an application on the device:

  • Error codes

    • "1009 : App uninstall fail"
      The application cannot be uninstalled through the Tizen Studio due to internal device problems.
      Uninstall the application from the "Apps" panel on the TV.
    • "1010 : App install fail"
      Application installation can fail for many reasons. A problem with the signing certificates is a common reason.
      Check your certificates and try again.
    • "1013 : App run fail"
      The application cannot be launched through the Tizen Studio due to internal device problems.
      Try to run the application again, or reboot the device.
  • "You are not an authorized user!" error and "Null Pointer" error (NPE)

    • These error messages occur if you are using older versions of the device firmware or SDK. Make sure you are using the newest firmware and SDK versions.
  • "Failed to get a device information" message

    • This message occurs only on 2015 devices, and has no effect on running the application. You can ignore the message.
  • On a macOS computer, the Tizen Studio freezes or hangs

    • Update your Java Development Kit installation.