Testing Your Application on a TV for 2013

Published 2014-10-27 | (Compatible with SDK 4.5 and 2013 models)

Setting the environment for developing Samsung Smart TV application

Once you have finished testing and debugging your application on the emulator, it is time to upload Samsung Smart TV applications to a TV set for testing on a full target system.

The functionality of a Samsung Smart TV application can be easily tested using the emulator. The results of any code change can be viewed immediately, thereby enabling incremental development. However, note that the emulator is never an exact simulation of the TV as it runs on different hardware. Therefore, to be certain of how an application will behave, you must also run it on a Samsung Smart TV.

The TV environment is different from the computer environment in the following ways:

  • Less memory is available; therefore an application may run out of memory.
  • A real TV picture can be seen and the blending of widget graphics over a TV picture can be evaluated.
  • The response to remote control keys may have a different timing; therefore the responsiveness to user key presses must be separately tested.

Applications uploaded directly from the development PC to a TV set are known as User Applications. The Smart Hub’s User Application feature allows developers to upload applications from the local server directly to the TV for testing, without affecting other users of Samsung Smart TV.

Configuring the Computer

To configure the computer for testing your application on a TV, you must:

  1. Install the Web Server.
  2. Set the SDK Preferences.
  3. Package application for upload.

Installing the Web Server

You are prompted to install the Apache web server during the Samsung Smart TV SDK installation. It is recommended that you choose all default options. If you skip the Apache installation, you can either:

  • Re-install the SDK and choose Apache
  • Manually install Apache (version 2.2.16).

If you wish, you may also use a different web server.

Setting SDK Preferences

You must configure the SDK to set the correct location for uploading widgets by doing the following:

  • Close the emulator.
  • Select the Samsung Smart TV SDK Preferences option from the Samsung Smart TV SDK menu. A number of tabs are listed on the left.
  • Enter Server PC IP.
  • Enter Root folder(ex. [$Apache install directory]\htdocs).

Figure. Location for uploading Apps using Apache

Use the Browse button to select a folder that is either directly accessed by a web server or another directory where files can be stored for later uploads (for example by FTP).

Packaging Applications for Upload

Before packaging applications for uploading to the TV, you must first develop and test the application using the emulator.


To package the user application for uploading to a TV:

  1. Mark your application as a user application by adding a line to the config.xml file, between the <widget> and </widget> tags, as follows:

  2. Click the App Packaging button at the bottom of the Samsung Smart TV SDK

    Figure: App Packaging button

    A Packaging dialog box is displayed (see the figure below).

    Figure: Packaging dialog

  3. Enter:

    • Application name and version number
    • Region where the application will be used
    • Package date (the default is the current date)

    These settings determine the file name that is used for the package.

  4. Select Update the packaged files on the server, and enter a title and description for the App (see the figure below).

    Figure: Update the packaged files on the server

  5. Click OK.

    The message Packaging complete is displayed. If you are using the default installation folder, the packaged application is on the Apache web server.

  6. Transfer the widgetlist.xml file, the widget folder and its contents to the web server so that they can be accessed:

    http://<ip  address>/widgetlist.xml
    http://<ip  address>/widget/...

    Multiple applications can be packaged and stored on the web server to be uploaded together. Give each each one a description in the widgetlist.xml file and store the files for each in the widget folder.

Configuring the TV

To configure the TV for testing applications:

Setting up the Network

To set-up the network:

  1. Connect the TV by Ethernet cable to an IP network that has access to the web server where the packaged application is stored.
  2. In the TV Settings menu, select Network, and enter Network Setup.
  3. Choose either automatic configuration (for DHCP) or manual configuration (for fixed IP address).
  4. For manual configuration, enter IP address, subnet mask, and gateway and DNS servers.
  5. To see that the network is functioning correctly, select Network Test. If the test fails, contact your network administrator. If the test succeeds, the TV is correctly connected to the network.
  6. Press the Return key to go back to the menu.

Login to User App and Install an application

To login to the User App tool as a developer:

  1. Ensure that the TV country is set to a location where Samsung applications on Samsung Smart TV are used. (see the figure below).

  2. Press Menu button on the remote control

  3. Click Smart Features.

    Figure: Smart Features

  4. Click Samsung Account. (see the figure below).

    Figure: Samsung Account

  5. To activate the User Application feature, click Log In. (see the figure below).

    Figure: Log In

  6. Login with “develop” ID (password leave blank).

    If you are using a 2013 Samsung Smart TV, you do not need to create an account. (develop account has been created in advance).

  7. Click the More Apps menu. (see the figure below)

    Figure: More Apps

  8. Click the Options menu. (see the upper right-hand corner of the following figure)

    Figure: Options

  9. Click IP Setting to enter IP develop

    Figure: IP Setting

  10. In the boxes, enter the IP address of the web server that contains the packaged application.

    Figure: IP Setting box

  11. From the Options menu, Start App Sync.

    Figure: Start App Sync

The TV indicates that it is installing a new service, and displays the name of your application. (see the figure below)

Figure: Install

Running and Testing an Application

  1. To enter the application, select it and press the Enter key on the remote control. This action loads the index.html file in the TV web browser.
  2. Press the Return key on the remote control to return to Smart Hub display.
  3. Press the Exit key to exit Samsung Smart TV (unless the key is handled by the widget and the API function blockNavigation has been used).
  4. After further changes are made to the application using the SDK, package it again.
  5. Synchronize the TV with the server. After this, the updated application is available in Smart Hub for further testing.

Deleting an Application

Sometimes, user applications on TV can have errors or must be deleted for some other reason. To delete a user application:

  1. Connect the Ethernet cable and start the Samsung Smart TV.
  2. Login with “develop” ID.
  3. Look for Edit My Apps. (More Apps - Options - Edit My Apps)
  4. Choose the user application that you want to delete and press the Enter button.