top

Installing TV SDK

This topic describes how to install, update, and uninstall the Samsung TV SDK.

The Samsung TV SDK is a set of tools for developing applications for Samsung TV, using Tizen. It consists of the following components:

Prerequisites

Before installing the Samsung TV SDK, make sure that your development computer fulfills the prerequisites.

OS and System Requirements

The following table lists the supported operating systems and hardware requirements for the Samsung TV SDK.

Table 1. OS and system requirements
CategoryRequirement
Operating systemWindows®64-bit recommended
Windows XP Service Pack 2 or higher
LinuxUbuntu 14.x or higher
macOSOS version 10.6 or higher on Intel-based hardware
Mac OS X 10.10 (Yosemite) 64-bit, 10.11 (El Capitan) 64-bit, 10.12 (Sierra) 64-bit
ProcessorDual-core: 2.8 GHz or faster
Single-core: 3 GHz or faster
RAM4 GB or more
Disk space6 GB or more
Insufficient disk space can cause the SDK to display undesired behavior.
Screen resolution1280x1024 px or higher
Java Development KitJava Development Kit1.8 or higher

Emulator Requirements

To use the TV emulator:

  • Your CPU must support hardware-assisted virtualization:
    • For Windows® and macOS, check the Intel® product specifications to make sure that your CPU supports Intel® VT-x.
    • For Linux, check the KVM site to make sure that your CPU supports either Intel® VT-x or AMD-V™.
  • You must upgrade to the latest vendor-provided version of the graphic card driver for OpenGL® ES acceleration.
  • On Ubuntu 14.04/16.04, the Intel driver version must be 8.0.1 or higher.
  • If the host machine is using the NVIDIA® Optimus® technology, the emulator works with the on-board graphics card. To prevent this, either disable the Optimus® technology, or set the emulator to run with the external NVIDIA graphics card.
Note

Emulator Limitation

On Windows®, depending on your OS theme (such as Non-Aero themes and Windows XP themes), a display surface can be erased for a while if the emulator window is covered with another window. If you click the emulator window, the display surface runs correctly again.

Installing Samsung TV SDK

To work with the Samsung TV SDK, you must install:

  • Tizen Studio IDE
  • Samsung TV Extensions
  • Samsung Certificate Extension

Tizen Studio IDE Installation

To install the Tizen Studio IDE:

  1. Download and run the Tizen Studio installer.

  2. Accept the software license.
    The license contains important legal notices for using the Tizen Studio. Read it in full, and click "Accept" only if you agree with the license statement.

    Figure 1. Software license agreement

    Figure 1. Software license agreement

  3. Set the SDK and data location.
    The Tizen Studio and its data directory are installed in the location specified in the "Installation Settings" step. To change the directory, click the "..." button and specify a new directory. If the new directory is valid (no errors are shown), click "Install".

    Figure 2. Set SDK and data location

    Figure 2. Set SDK and data location

  4. Wait while the Tizen Studio is installed.
    Once you click Install, the installer installs the required packages and tools in the specified directory. You can monitor the installation process or cancel the installation. The installation process is completed in a few minutes, unless you cancel it.

  5. Install additional tools.
    After the installation is finished, launch the Package Manager by checking the "Launch the Package Manager" check box before clicking "Finish".

    Figure 3. Installation completed

    Figure 3. Installation completed


    The Package Manager launches.
    If the Package Manager does not launch, run "<install path>/package-manager/package-manager.exe".
    Figure 4. Package Manager

    Figure 4. Package Manager


    For more information, see Installing Tizen Studio.

Extension Installations

You can install the required extensions using the online repository. If your firewall settings do not allow you to access the repository, you can also install the extensions from local images.

To install the extensions using the online repository:

  1. In the Package Manager, select the "Extension SDK" tab.

    Figure 5. Extension SDK tab

    Figure 5. Extension SDK tab

  2. Click "install" next to "TV Extensions-<version>" and "Samsung Certificate Extension".

    Figure 6. Required extensions

    Figure 6. Required extensions

  3. Accept the software licenses.
    The licenses contain important legal notices. Read them in full, and click "Accept All" only if you agree with the license statements.

    Figure 7-1. Extension license agreements

    Figure 7-1. Extension license agreements


    Figure 7-2. Certificate license agreements

    Figure 7-2. Certificate license agreements

  4. Wait while the extensions are installed.

    Figure 8-1. Extensions installing

    Figure 8-1. Extensions installing


    Figure 8-2. Certificate installing

    Figure 8-2. Certificate installing

To install the extensions from local images:

  1. Download the following images:

  2. In the Package Manager, click "Configuration".

    Figure 9. Configuration button

    Figure 9. Configuration button

  3. Unfold the Extension SDK configuration panel by clicking "Extension SDK" at the bottom of the dialog box.

    Figure 10. Unfold Extension SDK panel

    Figure 10. Unfold Extension SDK panel

  4. To add a local image, click "+".

    Figure 11. Add button

    Figure 11. Add button


    The "Add Repository" dialog opens.

  5. Enter values to the "Name" and "Repository" fields. Enter the full path of the SDK image file in the "Repository" box, or click "..." next to the field to open the file browser and select the image file.

  6. Click "OK" to close the "Add Repository" dialog.

    Figure 12. Add Repository dialog

    Figure 12. Add Repository dialog


    When you select the image file in the repository list, the image's origin information is displayed.

  7. Click "OK" to confirm.

    Figure 13. Confirm added images

    Figure 13. Confirm added images

  8. Select the "Extension SDK" tab.

  9. Click "Install" next to the added extensions.

  10. Accept the software licenses.
    The licenses contain important legal notices. Read them in full, and click "Accept" only if you agree with the license statements.

  11. Wait while the extensions are installed.

For more information, see Configuring the Package Manager.

Updating Samsung TV SDK

You can update the SDK using the online repository or from an image file.

To update packages using the online repository:

  1. Launch the Package Manager.
    If you are connected to the Internet and updates are available for your installed Tizen Studio packages, an "Updates available" button appears.

    Figure 14. Package updates available

    Figure 14. Package updates available

  2. Click "Updates available" to update all the packages you have installed. To ensure system integrity across all packages in the Tizen Studio, the Package Manager does not support updating packages individually.

To update an extension package using an image file, follow the same steps as for installing the required extensions.

For more information, see Updating Tizen Studio.

Uninstalling Samsung TV SDK

  1. Launch the uninstaller at "<install path>/package-manager/uninstaller.exe".

  2. Select the components to uninstall.
    If you do not select the SDK data component, you can keep the SDK data files in their directories for future re-use. The SDK data directory typically contains user-created data files, including emulator images, log files, and tool configuration files.

    Important

    Before proceeding, back up all data and files that you want to keep. Once started, uninstallation cannot be canceled and removed files cannot be restored.

  3. Click "Uninstall".

    Figure 15. Uninstall SDK

    Figure 15. Uninstall SDK

  4. Confirm the directory deletion.
    To remove all installed platforms and tools, as well as user-created data and files, click "Yes".
    If you have selected to uninstall the SDK data component, it is also removed.

    Figure 16. Confirm directory deletion

    Figure 16. Confirm directory deletion

  5. When uninstallation is complete, click "Finish".

    Figure 17. Uninstall finished

    Figure 17. Uninstall finished

For more information, see Uninstalling Tizen Studio.

Reference Videos

The following video shows how to install the Tizen Studio and the TV Extension SDK.