On Mac OS X 10.7.5 (also known as Mac OS X Lion) or later, the Install Manager might fail due to the security settings of the operating system. These settings have to be modified to temporarily prevent the Mac OS X Gatekeeper from blocking the Install Manager and to allow you to proceed with the Tizen SDK installation. Please perform the following steps to configure Gatekeeper on Mac OS X and to solve the issue:

Click on the Apple Menu button in the upper-left corner of the main screen of the Mac OS X interface.
Select System Preferences.
Click on Security & Privacy.
Select the General tab.
To configure the settings, click on the locker icon in the lower-right corner, enter the administrative user's password, and click on Unlock.
Set Allow apps download from to Anywhere and confirm the change.
Launch the Tizen Install Manager again and complete the installation.

Note

After successful installation, the security settings can be reverted to their previous configuration. Alternatively, you can exempt the installer as a single application from Gatekeeper. For more details, please visit Apple's support page at http://support.apple.com/kb/HT5290.

How to do it...

Download the .dmg file and launch it by following the provided instructions in the recipe Installing the Tizen SDK.

Click on the Apple Menu button in the upper-left corner of the main screen of the Mac OS X interface.
Select System Preferences.
Click on Security & Privacy.
Select the General tab.
To configure the settings, click on the locker icon in the lower-right corner, enter the administrative user's password, and click on Unlock.
Set Allow apps download from to Anywhere and confirm the change.
Launch the Tizen Install Manager again and complete the installation.

Note

Installing the Tizen SDK on Ubuntu

Ubuntu is the only Linux distribution that is recommended and fully supported by the Tizen SDK. Additional software has to be installed prior to launching the Tizen SDK Install Manager on Ubuntu.

This recipe contains four major steps to install all the required software components and successfully complete the SDK installation on Ubuntu. Before you start, make sure that at least 6 GB free space is present on the computer.

Getting ready

Officially, Tizen SDK 2.2.1 is compatible only with two versions of Ubuntu: 12.04 and 12.10. Despite this, it is absolutely possible to install and run the SDK on newer versions too. This is applicable to the following versions of Ubuntu:

12.10 32-bit
13.04 32-bit
13.10 64-bit

Although Ubuntu 13.10 is not officially supported, the Tizen SDK can be installed successfully on it as well, but a workaround related to libudev.so.1 should be applied to run SDB. Please check the troubleshooting section of the recipe for more information about fixing SDB on Ubuntu 13.10.

How to do it...

The full installation process can be divided into four milestones:

Downloading the Tizen SDK.
Installing Oracle Java Runtime Environment (JRE).
Installing dependencies.
Installing the Tizen SDK.

Visit tizen.org to get the Tizen SDK or just execute the following commands to download Tizen SDK 2.2.1 using your web browser or command-line tool such as wget. For example, if you have a 32-bit version of Ubuntu, then you can run the following command in the terminal:

wget https://cdn.download.tizen.org/sdk/InstallManager/tizen-sdk-2.2.1/tizen-sdk-ubuntu32-v2.2.71.bin

The URL of the installation file for the 64-bit version is slightly different, so it can be downloaded by executing the following command:

wget https://cdn.download.tizen.org/sdk/InstallManager/tizen-sdk-2.2.1/tizen-sdk-ubuntu64-v2.2.71.bin

Note

Any of these URLs might change over time. To download another version of the SDK, please check the available links at the download page at https://developer.tizen.org/downloads/tizen-sdk.

Oracle JRE must be installed before launching the Tizen SDK.Please note that OpenJDK is not supported. Please follow these steps if you do not have Oracle JRE installed:

Visit the Oracle website and, depending on the version of Ubuntu that you are using, download the 32-bit or 64-bit JRE 7 for Linux as a tar archive available at http://www.oracle.com/technetwork/java/javase/downloads/jre7-downloads-1880261.html.
Decompress all files from the downloaded archive.tar -xzf jre-*.tar.gz file.
Create a directory for the JRE files. After that, move the extracted files into the directory by executing the following command:
```
sudo mkdir -p /usr/lib/jvm/jre1.7.0sudo mv jre1.7.0_45/* /usr/lib/jvm/jre1.7.0/.
```
Note
The names of the JRE files and directories may be different depending on the version that you have downloaded.
If Java is not present, please install it. Otherwise, it is recommended that you update it by using the following command:
```
sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/jre1.7.0/bin/java 0
```

Furthermore, Java can be enabled for the Mozilla Firefox web browser that is shipped as the default web browser for Ubuntu. A couple of additional steps must be executed:

Create a directory to store the Mozilla plugin for the current user by executing the following command:
```
mkdir ~/.mozilla/plugins
```
Create a symbolic link of Java that points to the directory that was made in the previous step:
```
ln -s /usr/lib/jvm/jre1.7.0/lib/i386/libnpjp2.so ~/.mozilla/plugins/
```
Tip
Create a symbolic link of the plugin to /usr/lib/firefox/plugins/, or /usr/lib/firefox/browser/plugins/ for Ubuntu 13.10 to enable it for all users of the system. The web browser must be restarted after enabling Java.

We are almost ready to launch the Tizen SDK installer, but before that, some dependencies must be installed.

Ensure that the following packages are installed:

expect
gtk2-engines-pixbuf
libgnome2-0
qemu-user-static
gettext
module-init-tools
gksudo
libwebkitgtk-1.0-0

If you are wondering whether a package has already been installed on your development platform, please check it by executing the command dpkg -s followed by the package's name or the list of packages. To install any of the packages from the preceding list, open a terminal and execute sudo apt-get install followed by the name of the package, as follows:

sudo apt-get install expect gtk2-engines-pixbuf libgnome2-0 qemu-user-static libwebkitgtk-1.0-0 gettext module-init-tools libudev-dev

Users of Ubuntu 12.10 or any older version should install the package gksudo as well by executing the following command:

sudo apt-get install gksudo

Please note that if you are using Ubuntu 13.04 or a newer version, you will not be able to install this package as it is not available any more. Instead, you should install package gksu by executing the following command:

sudo apt-get install gksu

Finally, it is time to proceed with the installation of the Tizen SDK. Make sure that the binary file of the Install Manager has executable permissions and launch it. Please note that <version> and <bits> must be replaced with values that match the file downloaded at the beginning of the tutorial:

chmod +x tizen-sdk-ubuntu<bits>-v<version>.bin
./tizen-sdk-ubuntu<bits>-v<version>.bin

When the Install Manager launches, follow the instructions from the Installing the Tizen SDK recipe to complete the installation.

If you are unsure which install type is appropriate for your needs, it is recommended that you select Typical.

There's more…

In this section, you will learn how to troubleshoot your GNU/Linux installation of Tizen.

Unable to launch the Tizen IDE due to missing or incompatible version of JRE (SDK runs on Eclipse, which requires JRE, JRE 6, or a newer package is required).
If you encounter such a problem, please make sure that an appropriate JRE version has been installed on the development system before launching the installer of the Tizen SDK.
Unable to run the installation due to missing packages (Missing "expect" "gtk2-engines-pixbuf" "libgnome2-0" "qemu-user-static" "libwebkitgtk-1.0-0" package(s)).
If you encounter such a problem, please install the missing packages using the shell command apt-get.
Problem with installing Oracle Java on an Ubuntu machine.
If you encounter such a problem, install java-package. Then, convert the downloaded Oracle JDK/JRE archive into a .deb file.
Exception when Eclipse is launched (Exception in thread "main" org.eclipse.swt.SWTError: No more handles [Unknown Mozilla path (MOZILLA_FIVE_HOME not set)] error pops up).
If you encounter such a problem, please install the libwebkitgtk-1.0-0 package using apt-get.
The Tizen IDE does not display the Event Injector.
If you encounter such a problem, make sure that the Ajax Tool Framework plugin for Eclipse is installed.
Vertical scroll bars are not shown properly.
To disable the overlay scrollbar in the latest versions of Ubuntu, execute the following command:
```
>gsettings set com.canonical.desktop.interface scrollbar-mode normal
```
SDB not working on Ubuntu 13.10 64-bit (sdb: error while loading shared libraries: libudev.so.0: cannot open shared object file: No such file or directory).
If you encounter such a problem, apply the following workaround for Ubuntu 13.10 64-bit at your own risk to temporarily solve the issue until an update of the SDK is available:
```
sudo ln -s /lib/x86_64-linux-gnu/libudev.so.1.3.5 /lib/x86_64-linux-gnu/libudev.so.0
```

Note

Please note that libudev.so.1 is essential for Ubuntu 13.10, and if you accidentally delete it or mess with its file permissions, the operating system will not be able to start properly after reboot!

How to do it...

The full installation process can be divided into four milestones:

Downloading the Tizen SDK.
Installing Oracle Java Runtime Environment (JRE).
Installing dependencies.
Installing the Tizen SDK.

wget https://cdn.download.tizen.org/sdk/InstallManager/tizen-sdk-2.2.1/tizen-sdk-ubuntu32-v2.2.71.bin

The URL of the installation file for the 64-bit version is slightly different, so it can be downloaded by executing the following command:

wget https://cdn.download.tizen.org/sdk/InstallManager/tizen-sdk-2.2.1/tizen-sdk-ubuntu64-v2.2.71.bin

Note

Any of these URLs might change over time. To download another version of the SDK, please check the available links at the download page at https://developer.tizen.org/downloads/tizen-sdk.

Oracle JRE must be installed before launching the Tizen SDK.Please note that OpenJDK is not supported. Please follow these steps if you do not have Oracle JRE installed:

Visit the Oracle website and, depending on the version of Ubuntu that you are using, download the 32-bit or 64-bit JRE 7 for Linux as a tar archive available at http://www.oracle.com/technetwork/java/javase/downloads/jre7-downloads-1880261.html.
Decompress all files from the downloaded archive.tar -xzf jre-*.tar.gz file.
Create a directory for the JRE files. After that, move the extracted files into the directory by executing the following command:
```
sudo mkdir -p /usr/lib/jvm/jre1.7.0sudo mv jre1.7.0_45/* /usr/lib/jvm/jre1.7.0/.
```
Note
The names of the JRE files and directories may be different depending on the version that you have downloaded.
If Java is not present, please install it. Otherwise, it is recommended that you update it by using the following command:
```
sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/jre1.7.0/bin/java 0
```

Furthermore, Java can be enabled for the Mozilla Firefox web browser that is shipped as the default web browser for Ubuntu. A couple of additional steps must be executed:

Create a directory to store the Mozilla plugin for the current user by executing the following command:
```
mkdir ~/.mozilla/plugins
```
Create a symbolic link of Java that points to the directory that was made in the previous step:
```
ln -s /usr/lib/jvm/jre1.7.0/lib/i386/libnpjp2.so ~/.mozilla/plugins/
```
Tip
Create a symbolic link of the plugin to /usr/lib/firefox/plugins/, or /usr/lib/firefox/browser/plugins/ for Ubuntu 13.10 to enable it for all users of the system. The web browser must be restarted after enabling Java.

We are almost ready to launch the Tizen SDK installer, but before that, some dependencies must be installed.

Ensure that the following packages are installed:

expect
gtk2-engines-pixbuf
libgnome2-0
qemu-user-static
gettext
module-init-tools
gksudo
libwebkitgtk-1.0-0

sudo apt-get install expect gtk2-engines-pixbuf libgnome2-0 qemu-user-static libwebkitgtk-1.0-0 gettext module-init-tools libudev-dev

Users of Ubuntu 12.10 or any older version should install the package gksudo as well by executing the following command:

sudo apt-get install gksudo

sudo apt-get install gksu

chmod +x tizen-sdk-ubuntu<bits>-v<version>.bin
./tizen-sdk-ubuntu<bits>-v<version>.bin

When the Install Manager launches, follow the instructions from the Installing the Tizen SDK recipe to complete the installation.

If you are unsure which install type is appropriate for your needs, it is recommended that you select Typical.

There's more…

In this section, you will learn how to troubleshoot your GNU/Linux installation of Tizen.

Unable to launch the Tizen IDE due to missing or incompatible version of JRE (SDK runs on Eclipse, which requires JRE, JRE 6, or a newer package is required).
If you encounter such a problem, please make sure that an appropriate JRE version has been installed on the development system before launching the installer of the Tizen SDK.
Unable to run the installation due to missing packages (Missing "expect" "gtk2-engines-pixbuf" "libgnome2-0" "qemu-user-static" "libwebkitgtk-1.0-0" package(s)).
If you encounter such a problem, please install the missing packages using the shell command apt-get.
Problem with installing Oracle Java on an Ubuntu machine.
If you encounter such a problem, install java-package. Then, convert the downloaded Oracle JDK/JRE archive into a .deb file.
Exception when Eclipse is launched (Exception in thread "main" org.eclipse.swt.SWTError: No more handles [Unknown Mozilla path (MOZILLA_FIVE_HOME not set)] error pops up).
If you encounter such a problem, please install the libwebkitgtk-1.0-0 package using apt-get.
The Tizen IDE does not display the Event Injector.
If you encounter such a problem, make sure that the Ajax Tool Framework plugin for Eclipse is installed.
Vertical scroll bars are not shown properly.
To disable the overlay scrollbar in the latest versions of Ubuntu, execute the following command:
```
>gsettings set com.canonical.desktop.interface scrollbar-mode normal
```
SDB not working on Ubuntu 13.10 64-bit (sdb: error while loading shared libraries: libudev.so.0: cannot open shared object file: No such file or directory).
If you encounter such a problem, apply the following workaround for Ubuntu 13.10 64-bit at your own risk to temporarily solve the issue until an update of the SDK is available:
```
sudo ln -s /lib/x86_64-linux-gnu/libudev.so.1.3.5 /lib/x86_64-linux-gnu/libudev.so.0
```

Note

There's more…

In this section, you will learn how to troubleshoot your GNU/Linux installation of Tizen.

Unable to launch the Tizen IDE due to missing or incompatible version of JRE (SDK runs on Eclipse, which requires JRE, JRE 6, or a newer package is required).
If you encounter such a problem, please make sure that an appropriate JRE version has been installed on the development system before launching the installer of the Tizen SDK.
Unable to run the installation due to missing packages (Missing "expect" "gtk2-engines-pixbuf" "libgnome2-0" "qemu-user-static" "libwebkitgtk-1.0-0" package(s)).
If you encounter such a problem, please install the missing packages using the shell command apt-get.
Problem with installing Oracle Java on an Ubuntu machine.
If you encounter such a problem, install java-package. Then, convert the downloaded Oracle JDK/JRE archive into a .deb file.
Exception when Eclipse is launched (Exception in thread "main" org.eclipse.swt.SWTError: No more handles [Unknown Mozilla path (MOZILLA_FIVE_HOME not set)] error pops up).
If you encounter such a problem, please install the libwebkitgtk-1.0-0 package using apt-get.
The Tizen IDE does not display the Event Injector.
If you encounter such a problem, make sure that the Ajax Tool Framework plugin for Eclipse is installed.
Vertical scroll bars are not shown properly.
To disable the overlay scrollbar in the latest versions of Ubuntu, execute the following command:
```
>gsettings set com.canonical.desktop.interface scrollbar-mode normal
```
SDB not working on Ubuntu 13.10 64-bit (sdb: error while loading shared libraries: libudev.so.0: cannot open shared object file: No such file or directory).
If you encounter such a problem, apply the following workaround for Ubuntu 13.10 64-bit at your own risk to temporarily solve the issue until an update of the SDK is available:
```
sudo ln -s /lib/x86_64-linux-gnu/libudev.so.1.3.5 /lib/x86_64-linux-gnu/libudev.so.0
```

Note

Managing extension packages

Tizen is an open source software platform and it is very flexible. Third-party individual developers or companies can develop extension packages for the Tizen SDK. Other developers can use and abuse third-party packages in their applications using specific repositories. Some extensions for the Tizen SDK are available at https://developer.tizen.org/downloads/add-on-sdks.

How to do it...

Please perform the following steps to add extra repositories and install additional packages:

Launch the Tizen SDK Install Manager.
Click on Next to proceed.
Select Extra Repository to open a dialog.
Click on Add.
Set an external server as well as the name of a repository and click on OK. The repository information will be displayed in the previous window. Click on OK again.
Select the required packages and click on Install.

Perform the following actions to remove an extra repository and all packages installed from it:

Launch the Tizen SDK Install Manager.
Select Install or update Tizen SDK and click on Next.
Click on Extra Repository.
Select the repository that you want to delete and after that click on Remove.

How it works…

Each repository contains additional packages that are optional and can be added or deleted by the developer at any time. A repository is specified by a URL, so it is mandatory to have a network connection to the repository's server to download any of its packages. If you are experiencing issues connecting to a repository using HTTP Secure (HTTPS), you can try using the same URL with HTTP.

A proxy has to be used if you want to access repositories from a computer behind a firewall. To configure a proxy, launch Install Manager and click on the Proxy settings button.

How to do it...

Please perform the following steps to add extra repositories and install additional packages:

Launch the Tizen SDK Install Manager.

Click on Next to proceed.

Select Extra Repository to open a dialog.

Click on Add.

Set an external server as well as the name of a repository and click on OK. The repository information will be displayed in the previous window. Click on OK again.

Select the required packages and click on Install.

Perform the

following actions to remove an extra repository and all packages installed from it:

Launch the Tizen SDK Install Manager.
Select Install or update Tizen SDK and click on Next.
Click on Extra Repository.
Select the repository that you want to delete and after that click on Remove.

How it works…

A proxy has to be used if you want to access repositories from a computer behind a firewall. To configure a proxy, launch Install Manager and click on the Proxy settings button.

How it works…

, you can try using the same URL with HTTP.

A proxy has to be used if you want to access repositories from a computer behind a firewall. To configure a proxy, launch Install Manager and click on the Proxy settings button.

Customizing the Tizen IDE

The default and recommended IDE that is included in the Tizen SDK is based on Eclipse. Eclipse is an open source software, and through the years it has become a de facto standard for the development of applications for mobile platforms. Developers with experience in Android, Bada, Symbian, and BlackBerry 10 are already familiar with Eclipse as it, or IDEs based on it, is used for application development for these platforms.

Note

Android developers should note that there is a difference in the way Eclipse is provided for Tizen compared to Android. Android Development Tools (ADT) is a plugin for Eclipse that can be downloaded and installed. Unlike ADT, the Tizen IDE is provided in the Tizen SDK bundle, and at the moment, a separate plugin is not available.

Getting ready

The first step of the journey into application development for Tizen starts with the launch of the Tizen IDE. It is based on Eclipse, so it is not a surprise that the Tizen IDE also asks you to select a workspace. If you do not want to be asked to select the workspace every time you start the IDE, just check the option Use this as default and do not ask again. To change the workspace when the Tizen IDE is running, just navigate to File | Switch Workspace.

A welcome screen will be displayed on the first start screen of the Tizen IDE. Click on Workbench to open the Tizen Web perspective and start developing applications. If you want to have a look at the documentation, select any of the other three options. You can get back to the home screen at any time by navigating to Help | Welcome. If you are searching for Tizen's official development documentation, just navigate to Help | Help Contents.

How to do it...

For a lot of developers, the look and feel of their IDE is a key factor for their productivity. Tizen IDE supports all customization options provided by Eclipse. This recipe contains only a few hints for customization of the background and text colors. For more information, please have a look at Tizen IDE and Eclipse documentation or just delve into the preferences.

Execute the following actions to change the background color of the text editor:

Navigate to Windows | Preferences and a dialog box will appear.
Navigate to General | Editors | Text Editors.
Adjust the background color from the list of Appearance color options.
Change the text colors.

Text colors depend on the syntax coloring of the programming languages. Tizen web applications are developed using HTML, CSS, and JavaScript, while the development of native mobile applications relies on C++. Follow these simple steps to change the syntax coloring:

Navigate to Windows | Preferences and a dialog box will appear.
Select the desired programming language and navigate to Editor | Syntax Coloring.
Adjust the colors.

Perform the following steps if you want to change the fonts:

Navigate to Windows | Preferences and a dialog box will appear.
Navigate to General | Appearance | Colors and Fonts.
Select a programming language from the list and click on Edit.

There's more...

These are the most popular and important views in the Tizen IDE:

Project Explorer View: This view shows all resources in the current workspace. From the Project Explorer View, you can manage projects, open and edit files, and execute operations such as building packaging and signing and validating widgets or applications. Right-click inside this view to open a context menu with all options. If the Project Explorer View is missing from the current perspective of the Tizen IDE, you can add it by selecting Window | Show View | Other... | General | Project Explorer.
Properties View: This view shows the name and the basic properties of a selected resource. To view more details about a resource, right-click on it and select Properties. To add it to the current perspective of the Tizen IDE, navigate to Window | Show View | Other… | General | Properties.
Log View: This is a vital tool to track bugs and investigate the behavior of applications running on the Tizen Emulator or a device connected to the development system. Log messages are displayed within Log View while an application is running. The following message types are supported: verbose, debug, info, warning, error, and fatal. The log output can be configured to filter only specific message types using the V, D, Z, I, W, E, and F software buttons. Next to them are situated the buttons for additional tabs for logging with more filtering options that can be added, edited, and removed. An option to export logs is also available. If Log View is not visible, enable it by activating the following option, Window | Show View | Log.
Console View: This view offers several types of consoles that are useful during the deployment and debugging of Tizen applications. If the console is not visible, navigate to Window | Show View | Console to add it to the current perspective of the Tizen IDE. To change the settings of the console, go to Window | Preferences | Run/Debug | Console.
Connection Explorer View: The list of connected devices and emulators is displayed at this view. It provides options for exploring their filesystems and transferring files. Select an item from the list and right-click on the item to see a menu with all available actions. To add the Connection Explorer to the current perspective of the Tizen IDE, navigate to Window | Show View | Other... | Tizen.

Getting ready

official development documentation, just navigate to Help | Help Contents.

How to do it...

Execute the following actions to change the background color of the text editor:

Navigate to Windows | Preferences and a dialog box will appear.
Navigate to General | Editors | Text Editors.
Adjust the background color from the list of Appearance color options.
Change the text colors.

Navigate to Windows | Preferences and a dialog box will appear.
Select the desired programming language and navigate to Editor | Syntax Coloring.
Adjust the colors.

Perform the following steps if you want to change the fonts:

Navigate to Windows | Preferences and a dialog box will appear.
Navigate to General | Appearance | Colors and Fonts.
Select a programming language from the list and click on Edit.

There's more...

These are the most popular and important views in the Tizen IDE:

Project Explorer View: This view shows all resources in the current workspace. From the Project Explorer View, you can manage projects, open and edit files, and execute operations such as building packaging and signing and validating widgets or applications. Right-click inside this view to open a context menu with all options. If the Project Explorer View is missing from the current perspective of the Tizen IDE, you can add it by selecting Window | Show View | Other... | General | Project Explorer.
Properties View: This view shows the name and the basic properties of a selected resource. To view more details about a resource, right-click on it and select Properties. To add it to the current perspective of the Tizen IDE, navigate to Window | Show View | Other… | General | Properties.
Log View: This is a vital tool to track bugs and investigate the behavior of applications running on the Tizen Emulator or a device connected to the development system. Log messages are displayed within Log View while an application is running. The following message types are supported: verbose, debug, info, warning, error, and fatal. The log output can be configured to filter only specific message types using the V, D, Z, I, W, E, and F software buttons. Next to them are situated the buttons for additional tabs for logging with more filtering options that can be added, edited, and removed. An option to export logs is also available. If Log View is not visible, enable it by activating the following option, Window | Show View | Log.
Console View: This view offers several types of consoles that are useful during the deployment and debugging of Tizen applications. If the console is not visible, navigate to Window | Show View | Console to add it to the current perspective of the Tizen IDE. To change the settings of the console, go to Window | Preferences | Run/Debug | Console.
Connection Explorer View: The list of connected devices and emulators is displayed at this view. It provides options for exploring their filesystems and transferring files. Select an item from the list and right-click on the item to see a menu with all available actions. To add the Connection Explorer to the current perspective of the Tizen IDE, navigate to Window | Show View | Other... | Tizen.

How to do it...

Execute the following actions to change the background color of the text editor:

Navigate to Windows | Preferences and a dialog box will appear.

Navigate to General | Editors | Text Editors.

Adjust the background color from the list of Appearance color options.

Change the text colors.

Navigate to Windows | Preferences and a dialog box will appear.

Select the desired programming language and navigate to Editor | Syntax Coloring.

Adjust the colors.

Perform the following

steps if you want to change the fonts:

Navigate to Windows | Preferences and a dialog box will appear.
Navigate to General | Appearance | Colors and Fonts.
Select a programming language from the list and click on Edit.

There's more...

These are the most popular and important views in the Tizen IDE:

Project Explorer View: This view shows all resources in the current workspace. From the Project Explorer View, you can manage projects, open and edit files, and execute operations such as building packaging and signing and validating widgets or applications. Right-click inside this view to open a context menu with all options. If the Project Explorer View is missing from the current perspective of the Tizen IDE, you can add it by selecting Window | Show View | Other... | General | Project Explorer.
Properties View: This view shows the name and the basic properties of a selected resource. To view more details about a resource, right-click on it and select Properties. To add it to the current perspective of the Tizen IDE, navigate to Window | Show View | Other… | General | Properties.
Log View: This is a vital tool to track bugs and investigate the behavior of applications running on the Tizen Emulator or a device connected to the development system. Log messages are displayed within Log View while an application is running. The following message types are supported: verbose, debug, info, warning, error, and fatal. The log output can be configured to filter only specific message types using the V, D, Z, I, W, E, and F software buttons. Next to them are situated the buttons for additional tabs for logging with more filtering options that can be added, edited, and removed. An option to export logs is also available. If Log View is not visible, enable it by activating the following option, Window | Show View | Log.
Console View: This view offers several types of consoles that are useful during the deployment and debugging of Tizen applications. If the console is not visible, navigate to Window | Show View | Console to add it to the current perspective of the Tizen IDE. To change the settings of the console, go to Window | Preferences | Run/Debug | Console.
Connection Explorer View: The list of connected devices and emulators is displayed at this view. It provides options for exploring their filesystems and transferring files. Select an item from the list and right-click on the item to see a menu with all available actions. To add the Connection Explorer to the current perspective of the Tizen IDE, navigate to Window | Show View | Other... | Tizen.

There's more...

These are the most popular and important views in the

Tizen IDE:

Project Explorer View: This view shows all resources in the current workspace. From the Project Explorer View, you can manage projects, open and edit files, and execute operations such as building packaging and signing and validating widgets or applications. Right-click inside this view to open a context menu with all options. If the Project Explorer View is missing from the current perspective of the Tizen IDE, you can add it by selecting Window | Show View | Other... | General | Project Explorer.
Properties View: This view shows the name and the basic properties of a selected resource. To view more details about a resource, right-click on it and select Properties. To add it to the current perspective of the Tizen IDE, navigate to Window | Show View | Other… | General | Properties.
Log View: This is a vital tool to track bugs and investigate the behavior of applications running on the Tizen Emulator or a device connected to the development system. Log messages are displayed within Log View while an application is running. The following message types are supported: verbose, debug, info, warning, error, and fatal. The log output can be configured to filter only specific message types using the V, D, Z, I, W, E, and F software buttons. Next to them are situated the buttons for additional tabs for logging with more filtering options that can be added, edited, and removed. An option to export logs is also available. If Log View is not visible, enable it by activating the following option, Window | Show View | Log.
Console View: This view offers several types of consoles that are useful during the deployment and debugging of Tizen applications. If the console is not visible, navigate to Window | Show View | Console to add it to the current perspective of the Tizen IDE. To change the settings of the console, go to Window | Preferences | Run/Debug | Console.
Connection Explorer View: The list of connected devices and emulators is displayed at this view. It provides options for exploring their filesystems and transferring files. Select an item from the list and right-click on the item to see a menu with all available actions. To add the Connection Explorer to the current perspective of the Tizen IDE, navigate to Window | Show View | Other... | Tizen.

Setting the Active Secure profile

It is mandatory to create and set a secure profile in order to successfully deploy and debug applications on a Tizen device. My personal observation is that a lot of developers experience issues due to the secure profile when they are deploying an application on a device for the first time. This recipe explains a couple of ways to generate a certificate and set it on the Tizen IDE.

Getting ready

If an Active Secure profile is not set, the following error message will be displayed on the screen when you try to run an application on a device or emulator from the Tizen IDE:

Signing issue due to missing Active Secure profile

Please set up a secure profile before launching any applications from the Tizen IDE to avoid this annoying warning.

How to do it...

The Active Secure profile can be created manually through the command line or using the integrated graphical user interface from the Tizen IDE.

Launch the Tizen IDE.
Navigate to Window | Preferences.
Navigate to Tizen SDK | Security Profiles.
Click on the Add button.
Enter a name for the profile.
Click on the Generate button to fill the author's details.
Click on OK to save the profile settings.

An alternative approach is to create a certificate using the command line and set it as secure profile on the Tizen IDE. Perform the following steps if you prefer to use a terminal:

Launch a terminal and navigate to the directory <Tizen SDK install directory>/tools/certificate-generator/.
If you are working on a Unix-like operating system, such as Mac OS or Linux, execute certificate-generator.sh. If you are using Windows, you should run certificate-generator.bat.
You will be prompted to type the information about the certificate. After filling in all details, the certificate will be generated.
Launch the Tizen IDE because the generated certificate has to be set in it.
Navigate to Window | Preferences.
Navigate to Tizen SDK | Security Profiles.
Click on the Add button.
Enter a name for the profile.
Type in the path to the certificate's file.
Finally, click on the OK button to save all settings.

How it works…

The creation process of the certificate is similar no matter which approach or operating system you prefer to use. Both the batch file for Windows and the bash script for Linux and Mac OS run CertificateGenerator.jar through the java -jar command. This tool is written in Java and its file format is Java archive (JAR). The advantage of using Java for these kinds of applications is the multiplatform compatibility of Java, as the same code works on any of the operating systems supported by the Tizen SDK: Linux, Mac OS, and Windows.

Getting ready

If an Active Secure profile

is not set, the following error message will be displayed on the screen when you try to run an application on a device or emulator from the Tizen IDE:

Signing issue due to missing Active Secure profile

Please set up a secure profile before launching any applications from the Tizen IDE to avoid this annoying warning.

How to do it...

The Active Secure profile can be created manually through the command line or using the integrated graphical user interface from the Tizen IDE.

Launch the Tizen IDE.
Navigate to Window | Preferences.
Navigate to Tizen SDK | Security Profiles.
Click on the Add button.
Enter a name for the profile.
Click on the Generate button to fill the author's details.
Click on OK to save the profile settings.

An alternative approach is to create a certificate using the command line and set it as secure profile on the Tizen IDE. Perform the following steps if you prefer to use a terminal:

Launch a terminal and navigate to the directory <Tizen SDK install directory>/tools/certificate-generator/.
If you are working on a Unix-like operating system, such as Mac OS or Linux, execute certificate-generator.sh. If you are using Windows, you should run certificate-generator.bat.
You will be prompted to type the information about the certificate. After filling in all details, the certificate will be generated.
Launch the Tizen IDE because the generated certificate has to be set in it.
Navigate to Window | Preferences.
Navigate to Tizen SDK | Security Profiles.
Click on the Add button.
Enter a name for the profile.
Type in the path to the certificate's file.
Finally, click on the OK button to save all settings.

How it works…

How to do it...

The Active Secure profile can be created manually through the command line or using the integrated graphical user interface from the Tizen IDE.

The recommended way is to

generate a certificate through the Tizen IDE. The steps are as follows:

Launch the Tizen IDE.
Navigate to Window | Preferences.
Navigate to Tizen SDK | Security Profiles.
Click on the Add button.
Enter a name for the profile.
Click on the Generate button to fill the author's details.
Click on OK to save the profile settings.

An alternative approach is to create a certificate using the command line and set it as secure profile on the Tizen IDE. Perform the following steps if you prefer to use a terminal:

Launch a terminal and navigate to the directory <Tizen SDK install directory>/tools/certificate-generator/.
If you are working on a Unix-like operating system, such as Mac OS or Linux, execute certificate-generator.sh. If you are using Windows, you should run certificate-generator.bat.
You will be prompted to type the information about the certificate. After filling in all details, the certificate will be generated.
Launch the Tizen IDE because the generated certificate has to be set in it.
Navigate to Window | Preferences.
Navigate to Tizen SDK | Security Profiles.
Click on the Add button.
Enter a name for the profile.
Type in the path to the certificate's file.
Finally, click on the OK button to save all settings.

How it works…

The creation process of the certificate is similar no matter which approach or operating system you prefer to use. Both the

batch file for Windows and the bash script for Linux and Mac OS run CertificateGenerator.jar through the java -jar command. This tool is written in Java and its file format is Java archive (JAR). The advantage of using Java for these kinds of applications is the multiplatform compatibility of Java, as the same code works on any of the operating systems supported by the Tizen SDK: Linux, Mac OS, and Windows.

Tizen Web Simulator

Tizen Web Simulator is a simplified tool to test and debug web applications. It is included in the Tizen SDK. Web Simulator is available under Apache Software License v.2.0 because it is based on the Ripple-UI Framework, which was initially developed by BlackBerry (known in the past as research in motion) to test BB10 HTML5 WebWorks applications. Web Simulator offers the following features:

Guest modifications that provide a JavaScript backend that simulates Tizen Web APIs
Configuration panes to emit events and messages related to the geolocation, sensors, acceleration, and messaging capabilities of the Tizen software platform
Customization of the behavior of the simulator via a variety of preferences

The Google Chrome web browser must be installed because it powers the Tizen Web Simulator. This actually means that HTML5 applications that run on Google Chrome will also be running on Tizen. Another benefit is that all development features of the Google Chrome browser are available in the simulator, including the Remote Inspector tool that can be accessed by pressing F12.

Getting ready

It is mandatory to download and install Google Chrome on the development system if you intend to test applications on Tizen Web Simulator. The installation path of the Google Chrome browser can be specified in the Preferences of the simulator.

How to do it...

Three options are available to launch an application inside the Web Simulator:

Click on Run on the toolbar of the Tizen IDE.
Navigate to Run | Run Configurations from the menu of the Tizen IDE and click on Tizen Web Simulator Application.
Select a project at the Project Explorer View and right-click on it. After that, navigate to Run As | Tizen Web Simulator Application.

How it works…

Google Chrome will be started automatically with the Web Simulator. Adjust the orientation and zooming of the simulator by editing the configurations from the panel on the left-hand side of the browser.

Please note that the Web Simulator is compatible only with HTML5 web applications and it is useless for native applications. The simulator loads the HTML file specified at config.xml when the web application is launched. By default, the name of the file is index.html.

How to do it...

Three options are available to launch an application inside the Web Simulator:

Click on Run on the toolbar of the Tizen IDE.
Navigate to Run | Run Configurations from the menu of the Tizen IDE and click on Tizen Web Simulator Application.
Select a project at the Project Explorer View and right-click on it. After that, navigate to Run As | Tizen Web Simulator Application.

How it works…

Tizen Emulator

Although it is highly recommended to deploy and debug applications directly on a real Tizen device, it is not mandatory to have a Tizen device in order to develop applications. A virtual device Emulator is delivered along with the other tools of the Tizen SDK. Developers can create virtual machines with custom hardware specifications that match their requirements for testing.

The device Emulator is a virtual machine based on the open source project Quick Emulator (QEMU). It provides full stacks of the Tizen platform. Emulator Manager and Event Injector are also provided among the Emulator tools of the SDK. Unlike the simulator, the emulator provides strict implementation of the device specifications and there are no guest modifications. Please note that Tizen SDK 2.2.1 supports only the x86 machine architecture for guests.

QEMU, the engine behind the Tizen Emulator, is an open source project for a visualization machine that allows you to run a separate operating system as just another task on the desktop of your development machine. The Android emulator is also based on QEMU. For more information about QEMU and details regarding its licenses, please visit http://wiki.qemu.org/.

The Tizen Emulator supports a variety of features, and the most important features are as follows:

Full system emulation, including CPU, RAM, and peripheral devices such as the camera
Event Injector for simulation of events
Animation and OpenGL ES for hardware-accelerated 3D rendering support
Telephony

Of course, the emulator has some limitations compared to a real Tizen device. The differences impact the behavior of features:

Input system: The emulator provides a virtual touchscreen and its drivers are different from the ones for the physical devices.
Virtual sensor: Values related to acceleration, light, gyroscope, proximity, motion, location, and battery are received through the Event Injector.
Telephony: Voice calls, call waiting, outgoing call barring, and messaging are supported through the Event Injector. Video calls, call forwarding, incoming call barring, emulator-to-emulator calls, and SMS are not supported.
Power management: The emulator offers internal implementation to turn on and off the display.
Supported media formats and codes: Encoding of H.264 and decoding of AAC+, enhanced AAC+, and FLAC are not supported on the emulator.

Getting ready

Please ensure that you are running the Tizen Emulator on a computer with a minimum screen resolution of 1280 x 1024 pixels and the latest version of graphical drivers with OpenGL support. It is recommended to use an Intel CPU with Virtualization Technology (VTx). The performance of the emulator depends on the hardware of the computer and it might work slowly on low resource machines. Details about the requirements for the Tizen Emulator are available at https://developer.tizen.org/downloads/sdk/installing-sdk/prerequisites-tizen-sdk.

How to do it...

To create new instances of the Tizen Emulator, launch the Emulator Manager and click on the button with the label Create New VM.

Select the name of the emulator, display resolution, density, skin, and size of RAM. Then, enable or disable the GPU and the hardware visualization of the CPU. When all configurations are set, click on Confirm, as shown in the following screenshot:

The Tizen Emulator

The emulator will appear within the window of the Emulator Manager. Hit the play button to launch it. The loading of Tizen on the virtual machine may vary depending on the hardware of the development system. Wait until Tizen is completely loaded and then use it.

As an alternative, advanced users may launch the emulator from a terminal through a command with the following syntax:

/emulator-x86 --skin-args <skin options> --qemu-args <QEMU options>

Both skin options such as the height and width of the resolution as well as various QEMU options can be specified as arguments of the command. For details of the supported options, please check the user manual in the official Tizen SDK 2.2.1 development documentation:

https://developer.tizen.org/dev-guide/2.2.1/org.tizen.gettingstarted/html/dev_env/emulator_startup_options.htm

How to do it...

To create new instances of the Tizen Emulator, launch the Emulator Manager and click on the button with the label Create New VM.

The Tizen Emulator

As an alternative, advanced users may launch the emulator from a terminal through a command with the following syntax:

/emulator-x86 --skin-args <skin options> --qemu-args <QEMU options>

https://developer.tizen.org/dev-guide/2.2.1/org.tizen.gettingstarted/html/dev_env/emulator_startup_options.htm

Getting started with Smart Development Bridge

Smart Development Bridge (SDB) is a command-line tool for communication with the Tizen emulator or connected Tizen devices. Its role in Tizen is the same as the role of Android Debug Bridge (ADB) in Android. SDB is an essential part of the Tizen SDK and it is installed with it. SDB manages multiple device connections and provides basic commands for application development and debugging. The main features of SDB are as follows:

Manage connections to devices and/or the emulator
File transfer between development systems and the connected Tizen Emulator/device
Remote shell to execute commands on the Tizen Emulator/device
Port forwarding from the host to the Tizen Emulator/device
Debugging applications

SDB works as a typical client-server application and it consists of three main components:

A client that runs on the development system and can be invoked from the command line using the SDB command.
A server that manages the connection and the communication with the Tizen Emulator and devices. It runs as a background process on the development system.
A daemon that runs on each Tizen Emulator or device.

Although not mandatory, it is convenient to add SDB to the environmental path. To do it, follow the steps given in this recipe, depending on the operating system of your development machine.

Right-click on the Computer icon located on the desktop.
Select the Advanced System settings.
Click on the Environmental Variables button on the Advanced tab of System Properties.
Carefully append the location of SDB to the Path variable.

If you are using Windows XP, the following steps will be helpful if you want to add SDB to the environmental path:

Right-click on the Computer icon located on the desktop.
Click on Properties.
Select the Advanced tab of System Properties.
Click on the Environmental Variables button.
Carefully append the location of SDB to the Path variable.
Note
On Windows, the changes will take effect only after reboot.

To add SDB to the environmental path for all users on Ubuntu, append the SDB directory to the path that is defined at file /etc/environment. Log out and log in again or just reboot to apply the changes.

To add SDB to the environmental path for all users on Mac OS X Leopard and above, create a text file at the directory /etc/paths.d/ and set the location of SDB within it using root privileges, for example, sudo -s 'echo "<tizen_sdk>/sdb" > /etc/paths.d/sdb'.

A quick and easy alternative approach to achieve a similar result on UNIX-like operating systems, such as Linux and Mac OS, without modifying /etc/environment or creating a file at /etc/paths.d is to create a symbolic link to SDB in the bin directory using root privileges, for example, sudo ln –s <tizen_sdk>/sdb /bin/sdb.

Please note that <tizen_sdk> in both examples must be replaced with the actual path, depending on the installation.

How to do it...

To add SDB to the environmental path of Windows 7, perform the following steps:

Right-click on the Computer icon located on the desktop.
Select the Advanced System settings.
Click on the Environmental Variables button on the Advanced tab of System Properties.
Carefully append the location of SDB to the Path variable.

If you are using Windows XP, the following steps will be helpful if you want to add SDB to the environmental path:

Right-click on the Computer icon located on the desktop.
Click on Properties.
Select the Advanced tab of System Properties.
Click on the Environmental Variables button.
Carefully append the location of SDB to the Path variable.
Note
On Windows, the changes will take effect only after reboot.

Please note that <tizen_sdk> in both examples must be replaced with the actual path, depending on the installation.

Using Smart Development Bridge

SDB is a powerful tool with a lot of capabilities and features. Although you can successfully develop applications using the Tizen IDE without even knowing what SDB is, it is recommended to explore the options of the tool. SDB is a developer's best friend when it comes to management of a connected device, transferring files, and debugging applications.

How to do it...

Perform the following steps to enable and use SDB:

Make sure that the date and time on your devices is correct.
Enable the developer mode and USB debugging on a Tizen device by navigating to Settings | Developer options | USB debugging.
Connect the Tizen device to a computer.
Run the SDB command in a console using the following syntax:
```
sdb [option] <command> [parameters]
```

According to the Tizen 2.2.1 official development guide, the values provided for option in the preceding command can be:

-d: This stands for select device. This sends the specified command to a connected USB device. Please note that this option will fail if multiple Tizen devices are attached over USB.
-e: This option is used to control an emulator. The error handling is similar to that of the option -d. If multiple emulators are running, this command will fail and an error will be returned. Direct the command to the only running emulator and return an error if more than one emulators are present.
-s <serial number>: Tizen devices or emulators that are attached to a developer's computer are identified by their serial number. The -s option should be followed by the serial number of the device and SDB will take care to target the command only to the specified device.

The following is a list of all the supported SDB commands with some brief information about them:

Command	Details
`devices`	This provides a list of connected devices.
`connect <host>[:<port>]`	This connects to a device through TCP/IP.
`disconnect <host>[:<port>]`	This disconnects a device. The host and port parameters are optional. If they are not specified, all devices will be disconnected.
`push <local> <remote> [-with-utf8]`	This transfers a file from the development system to the connected Tizen device.
`pull <remote> [<local>]`	This transfers a file from the connected Tizen device to the development system.
`shell`	This accesses a remote shell of the connected Tizen device or emulator.
`shell <command>`	This remotely runs a single shell command to a connected Tizen device or emulator. Execution of the following commands is allowed: `ls`, `rm`, `mv`, `cd`, `mkdir`, `cp`, `touch`, `echo`, `tar`, `grep`, `cat`, `chmod`, `rpm`, `find`, `uname`, `netstat`, and `killall`.
`dlog [option] [<filter-spec>]`	This prints the current log out of the buffers of a connected device or emulator.
`install <path_to_tpk>`	This installs a `tpk` package.
`uninstall <appid>`	This uninstalls an application using its ID.
`forward <local> <remote>`	This specifies the `local` and `remote` socket to configure port forwarding.
`help`	This displays SDB help information and usage guides.
`version`	This prints the SDB version number.
`start-server`	This launches the SDB server if it is not already running.
`kill-server`	This terminates the SDB server if it is running.
`get-state`	This displays the status of the connection to devices.
`get-serialno`	This displays the serial number of a connected Tizen device.
`status-window`	This displays the status of a connected device until the developer manually terminates the command.
`root <on\|off>`	This enables or disables the root account mode.