SDK 4.5 Installation Guide for Windows / Mac OS X / Linux

Hardware Requirements

• Processor: Dual Core 1.5GHz / Single Core 3GHz or higher
• RAM: 1 GB or higher
• OS:
  • Windows: Windows XP Service Pack 2 or higher, Windows 7
  • Mac OS X: 10.6 and above
  • Linux: any OS that supports Virtual Box 4.2.4 and later should support the Smart TV SDK 4.5. A full list of supported OS’s can be found at: https://www.virtualbox.org/wiki/Linux_Downloads
• Screen resolution: 1280 x 1024 or higher
• HDD: 5GB or higher

Software Requirements

• The VirtualBox virtualization tool is required to run the Emulator. VirtualBox can be downloaded here: http://www.virtualbox.org/
• Java Standard Edition(Java SE) 1.6 or higher is required. Please download and install the Java Runtime Environment(JRE) from: http://www.oracle.com/technetwork/java/javase/downloads/index.html

Install VirtualBox

VirtualBox is a virtualization product that allows virtual machines to run on a variety of host operating systems. The Samsung Smart TV SDK uses VirtualBox to run the TV Emulator. Please download and install VirtualBox. A guide for installing can be found at the following link: https://www.virtualbox.org/manual/ch02.html#idp5512464

Installing the Emulator

After installing VirtualBox, start the Oracle VM VirtualBox Manager.

1. Select File ‣ Import Appliance.
2. Select Open Appliance and select the 2013_Smart_TV_Emulator_4_5.ova Emulator file that was downloaded.
3. Select Next and then Import.
4. After the Emulator is imported, a share folder must be set. Select the 2013_Smart_TV_Emulator and choose Settings ‣ Shared Folders.
5. The image below shows the default settings. If you would like to use a different location, please choose a new folder called Apps (it can be located anywhere).

Figure 1: Setting the Shared Folder

Installing the Apps Editor IDE

1. Unzip the Samsung_SmartTV_SDK_IDE_4_5_OperatingSystem.zip install file.

2. To start the IDE, run the executable file: <Install Directory>/eclipse.exe (the file extension will vary depending on operating system)

3. When the IDE starts, choose a workspace for your projects. Any location you choose is acceptable:

   

   Figure 2: Choosing the workspace path for the IDE

Installing Additional Features

Web Inspector (Debugger)

To enable the debugging tool (Web Inspector), please install the Google Chrome web browser: https://www.google.com/intl/en/chrome/browser/

Verify that the Google Chrome path is set in the App Editor IDE’s menu Samsung Smart TV SDK ‣ Samsung Smart TV SDK Preferences ‣ PNaCl ‣ Chrome Path.

Figure 3: Setting the Chrome path in the IDE

Apache Web Server

To deploy apps to a real TV, please install a web server on your development PC. Any standard web server will work, but this guide will focus on the Apache Web Server. The Apache Web Server is available at: http://httpd.apache.org/

After installing the web server, please set web server’s document root directory in Samsung Smart TV SDK ‣ Samsung Smart TV SDK Preferences ‣ Server ‣ Root Folder and Server PC IP.

Figure 4: Setting the Server’s Root Folder and IP Address

Further Reading

For further information about using the Smart TV Emulator and Troubleshooting, please refer to the Using the Smart TV Emulator with VirtualBox and Troubleshooting document.