<p><img alt="Mobile" src="../images/mobile_s_wn.png"/> <img alt="Wearable" src="../images/wearable_s_wn.png"/></p>
</div>
<h1>Dynamic Analyzer</h1>
- <p>You can monitor the performance and reliability of your native application on a target device or the Emulator by <a href="../../../org.tizen.tutorials/html/native/process/performance_n.htm#running">running the dynamic analyzer tool</a> included within the Tizen SDK.</p>
+ <p>You can monitor the performance and reliability of your native application on a target device or the Emulator by <a href="../../../org.tizen.training/html/native/process/performance_n.htm#running">running the dynamic analyzer tool</a> included within the Tizen SDK.</p>
<p>Dynamic Analyzer provides various functions for profiling applications. To better understand the profiling result, you need to know about each component that tool screen contains, providing you with the tracing information of your application.</p>
<p class="figure">Figure: Dynamic Analyzer screen</p>
<p align="center"> <img alt="Dynamic Analyzer screen" src="../images/dynamic_analyzer.png" /> </p>
<p>The analysis result helps you to recognize and fix bottlenecks, bugs, and memory and resource leaks.
For instructions on running the dynamic analyzer and ways to analyze the result and utilize the result
- for improving your application performance, see <a href="../../../org.tizen.tutorials/html/native/process/performance_n.htm#dynamic_analysis">Dynamic Analysis</a>.</p>
+ for improving your application performance, see <a href="../../../org.tizen.training/html/native/process/performance_n.htm#dynamic_analysis">Dynamic Analysis</a>.</p>
<p>You can use <a href="da_table_filtering.htm">table filtering</a> to see only the information you want in the result table.</p>
</div>
<h1>API and Privilege Checker</h1>
- <p>The Tizen IDE provides the API and privilege checker tool to identify potential problems in the application code related to API and <a href="../../../org.tizen.tutorials/html/native/details/sec_privileges_n.htm">privilege usage</a>.</p>
- <p>In <a href="../../../org.tizen.tutorials/html/native/process/setting_properties_n.htm">project properties</a>, you can enable the checker during the <a href="../../../org.tizen.tutorials/html/native/process/app_dev_process_n.htm#build">building process</a> or code editing stage. You can also perform the checks manually in the <strong>Project Explorer</strong> view by choosing a project, opening the context menu, and selecting <strong>Check API and Privilege Violations With Build</strong>.</p>
+ <p>The Tizen IDE provides the API and privilege checker tool to identify potential problems in the application code related to API and <a href="../../../org.tizen.training/html/native/details/sec_privileges_n.htm">privilege usage</a>.</p>
+ <p>In <a href="../../../org.tizen.training/html/native/process/setting_properties_n.htm">project properties</a>, you can enable the checker during the <a href="../../../org.tizen.training/html/native/process/app_dev_process_n.htm#build">building process</a> or code editing stage. You can also perform the checks manually in the <strong>Project Explorer</strong> view by choosing a project, opening the context menu, and selecting <strong>Check API and Privilege Violations With Build</strong>.</p>
<p>The results of the check are displayed in the <strong>Problems</strong> view. The following tables define the different alarms that the checks can generate.</p>
<table id="API" border="1">
<caption>
<h1>Manifest Text Editor</h1>
<p>A Tizen native application package consists of exactly 1 manifest file, called <span style="font-family: Courier New,Courier,monospace;">tizen-manifest.xml</span>, which is used to describe the application information. The manifest file is composed of XML elements, which include the root <a href="#manifest"><manifest></a> element and its child elements representing application information, such as <span style="font-family: Courier New,Courier,monospace;"><version></span>, and <span style="font-family: Courier New,Courier,monospace;"><privileges></span>. The <a href="#hierarchy">child elements are organized into a specific hierarchy</a>. The elements can have attributes associated with them, providing more information about the element.</p>
-<p>The manifest file information can be edited using the <a href="../../../org.tizen.tutorials/html/native/process/setting_properties_n.htm#manifest">manifest editor</a>, or you can modify the XML structure directly using the text editor. To open the manifest editor, double-click the <span style="font-family: Courier New,Courier,monospace;">tizen-manifest.xml</span> file in the <strong>Project Explorer</strong> view of the IDE. To use the text editor, right-click the <span style="font-family: Courier New,Courier,monospace;">tizen-manifest.xml</span> file in the <strong>Project Explorer</strong> view and select <strong>Open with > Text Editor</strong>.</p>
+<p>The manifest file information can be edited using the <a href="../../../org.tizen.training/html/native/process/setting_properties_n.htm#manifest">manifest editor</a>, or you can modify the XML structure directly using the text editor. To open the manifest editor, double-click the <span style="font-family: Courier New,Courier,monospace;">tizen-manifest.xml</span> file in the <strong>Project Explorer</strong> view of the IDE. To use the text editor, right-click the <span style="font-family: Courier New,Courier,monospace;">tizen-manifest.xml</span> file in the <strong>Project Explorer</strong> view and select <strong>Open with > Text Editor</strong>.</p>
<p>The following example illustrates the content and structure of a <span style="font-family: Courier New,Courier,monospace;">tizen-manifest.xml</span> file:</p>
</pre>
<h2 name="privileges" id="privileges"><privileges> Element</h2>
-<p>The <span style="font-family: Courier New,Courier,monospace"><privileges></span> element represents required privileges for the Tizen application. Applications that use sensitive APIs must declare the required privileges in the <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file. Since the privilege categories differ for each API type, make sure you define a <a href="../../../org.tizen.tutorials/html/native/details/sec_privileges_n.htm">correct privilege related to the API you need</a>.</p>
+<p>The <span style="font-family: Courier New,Courier,monospace"><privileges></span> element represents required privileges for the Tizen application. Applications that use sensitive APIs must declare the required privileges in the <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file. Since the privilege categories differ for each API type, make sure you define a <a href="../../../org.tizen.training/html/native/details/sec_privileges_n.htm">correct privilege related to the API you need</a>.</p>
<p>Press <strong>Add</strong> to open the <strong>Add Privilege</strong> dialog.</p>
<p class="figure">Figure: Editing the <privileges> element in the manifest editor</p>
<li><span style="font-family: Courier New,Courier,monospace">http://tizen.org/privilege/account.read</span></li>
</ul>
-<p>For more information on the expected values, see <a href="../../../org.tizen.tutorials/html/native/details/sec_privileges_n.htm">Security and API Privileges</a>.</p>
+<p>For more information on the expected values, see <a href="../../../org.tizen.training/html/native/details/sec_privileges_n.htm">Security and API Privileges</a>.</p>
</td>
</tr>
</tbody></table>
<li><span style="font-family: Courier New,Courier,monospace">"http://tizen.org/feature/camera"</span></li>
<li><span style="font-family: Courier New,Courier,monospace">"http://tizen.org/feature/fmradio"</span></li>
</ul>
-<p>For more information on the expected values and the application filtering mechanism, see <a href="../../../org.tizen.tutorials/html/native/details/app_filtering_n.htm">Application Filtering</a>.</p>
+<p>For more information on the expected values and the application filtering mechanism, see <a href="../../../org.tizen.training/html/native/details/app_filtering_n.htm">Application Filtering</a>.</p>
</td>
</tr>
</tbody></table>
</script>
</body>
-</html>
\ No newline at end of file
+</html>
<li><strong>Massif</strong> <p>Heap memory profiler.</p> </li>
</ul>
- <p>Tizen IDE provides the interface for <a href="../../../org.tizen.tutorials/html/native/process/performance_n.htm#running_valgrind">running Valgrind with your application</a> easily. After performance profiling is terminated, you can see the <a href="../../../org.tizen.tutorials/html/native/process/performance_n.htm#valgrind_result">profiling result</a> and use it for improving performance. </p>
+ <p>Tizen IDE provides the interface for <a href="../../../org.tizen.training/html/native/process/performance_n.htm#running_valgrind">running Valgrind with your application</a> easily. After performance profiling is terminated, you can see the <a href="../../../org.tizen.training/html/native/process/performance_n.htm#valgrind_result">profiling result</a> and use it for improving performance. </p>
<table class="note">
<tbody>
</script>
</body>
-</html>
\ No newline at end of file
+</html>
<h1>Configuration Editor</h1>\r
\r
<p>The Tizen Web application configuration file is composed of XML elements, including the <span style="font-family: Courier New,Courier,monospace"><widget></span> element as its root and other elements representing the application information, such as <a href="#elements">configuration elements</a> and Tizen extending configuration elements for <a href="#mw_extend">mobile</a> and <a href="#ww_extend">wearable</a> applications. Note that although the <span style="font-family: Courier New,Courier,monospace"><feature></span> element is a W3C element, a modified Tizen extended version of it is used.</p>\r
- <p>The configuration file can be edited with the <a href="../../../org.tizen.tutorials/html/web/process/setting_properties_w.htm#set_widget">Web application configuration editor</a>, or you can modify the XML structure directly using the configuration text editor. To open the Web application configuration editor, double-click the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file in the <strong>Project Explorer</strong> view of the IDE. To use the configuration text editor, right-click the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file in the Project Explorer view and select <strong>Open with > Text Editor</strong>.\r
+ <p>The configuration file can be edited with the <a href="../../../org.tizen.training/html/web/process/setting_properties_w.htm#set_widget">Web application configuration editor</a>, or you can modify the XML structure directly using the configuration text editor. To open the Web application configuration editor, double-click the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file in the <strong>Project Explorer</strong> view of the IDE. To use the configuration text editor, right-click the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file in the Project Explorer view and select <strong>Open with > Text Editor</strong>.\r
</p>\r
<table class="note">\r
<tbody>\r
</ul>\r
<p><strong>Attributes:</strong> </p>\r
<ul>\r
- <li><span style="font-family: Courier New,Courier,monospace;">name</span> <p>Mandatory; <a href="../../../org.tizen.tutorials/html/web/process/setting_properties_w.htm#feature">feature key</a> URI</p></li>\r
+ <li><span style="font-family: Courier New,Courier,monospace;">name</span> <p>Mandatory; <a href="../../../org.tizen.training/html/web/process/setting_properties_w.htm#feature">feature key</a> URI</p></li>\r
</ul><p><strong>Example:</strong> </p><pre class="prettyprint"><feature name="http://tizen.org/feature/network.bluetooth" /></pre> </td>\r
</tr>\r
</tbody>\r
</ul>\r
<p><strong>Attributes:</strong> </p>\r
<ul>\r
- <li><span style="font-family: Courier New,Courier,monospace;">name</span> <p>Mandatory; <a href="../../../org.tizen.tutorials/html/web/process/setting_properties_w.htm#feature">feature key</a> URI</p></li>\r
+ <li><span style="font-family: Courier New,Courier,monospace;">name</span> <p>Mandatory; <a href="../../../org.tizen.training/html/web/process/setting_properties_w.htm#feature">feature key</a> URI</p></li>\r
</ul><p><strong>Example:</strong> </p><pre class="prettyprint"><feature name="http://tizen.org/feature/network.bluetooth" /></pre> </td>\r
</tr>\r
</tbody>\r
</script>\r
\r
</body>\r
-</html>
\ No newline at end of file
+</html>\r
</tr>
</tbody>
</table>
- <p>For more information, see <a href="../../../org.tizen.tutorials/html/web/process/setting_properties_w.htm#privilege">Specifying Privileges in the Privilege Tab</a>.</p>
+ <p>For more information, see <a href="../../../org.tizen.training/html/web/process/setting_properties_w.htm#privilege">Specifying Privileges in the Privilege Tab</a>.</p>
<p>To expand content assist functionality to user-defined and third-party APIs:</p>
<ol>
<li>Prepare an API definition document using the WIDL standard. The Tizen IDE supports the <span style="font-family: Courier New,Courier,monospace">.xml</span> and <span style="font-family: Courier New,Courier,monospace">.widlprocxml</span> files.</li>
</div>\r
\r
<h1>Privilege Checker</h1> \r
-<p>You can enable the privilege checks in the <a href="set_ide_preference_w.htm#privilege">preferences</a> during the <a href="../../../org.tizen.tutorials/html/web/process/app_dev_process_w.htm#build">build process</a> or code editing. You can also perform the checks manually in the IDE by selecting <strong>Project > Check Privilege</strong>.</p>\r
+<p>You can enable the privilege checks in the <a href="set_ide_preference_w.htm#privilege">preferences</a> during the <a href="../../../org.tizen.training/html/web/process/app_dev_process_w.htm#build">build process</a> or code editing. You can also perform the checks manually in the IDE by selecting <strong>Project > Check Privilege</strong>.</p>\r
<p>The Privilege Checker tool is based on the <a href="content_assist_w.htm">Content Assist</a> Engine for Tizen IDE. It is used for codes that do not operate Content Assist and cannot perform checks. Therefore, the check results can possibly have missing (unsound) values.</p>\r
<p>The check results are displayed in the <strong>Problems</strong> view and vertical ruler. To resolve an alarm, click the annotation on the vertical ruler and select an entry from the proposal list. The required privilege is automatically added into <span style="font-family: Courier New,Courier,monospace">config.xml</span> file (for a quick fix, use the <strong>Ctrl+1</strong> keyboard shortcut).</p>\r
<table border="1">\r
</ul>
<p class="toc-title">Related Info</p>
<ul class="toc">
- <li><a href="../../../org.tizen.tutorials/html/web/process/run_debug_app_w.htm">Running and Debugging Applications</a></li>
+ <li><a href="../../../org.tizen.training/html/web/process/run_debug_app_w.htm">Running and Debugging Applications</a></li>
</ul>
</div></div>
</div>
<div id="container"><div id="contents"><div class="content">
<h1>Web Inspector</h1>
- <p>You can <a href="../../../org.tizen.tutorials/html/web/process/run_debug_app_w.htm">debug Web applications</a> using the JavaScript Debugger tool. The JavaScript Debugger is based on Webkit Web Inspector, and has been modified to support remote debugging. </p>
+ <p>You can <a href="../../../org.tizen.training/html/web/process/run_debug_app_w.htm">debug Web applications</a> using the JavaScript Debugger tool. The JavaScript Debugger is based on Webkit Web Inspector, and has been modified to support remote debugging. </p>
<p>The JavaScript Debugger supports the following panels:</p>
<ul>
<li><a href="#element">Elements Panel</a></li>
</script>
</body>
-</html>
\ No newline at end of file
+</html>
<li>Create a DALi project:
<ol type="a">
<li>In the Tizen Studio menu, go to <strong>File > New > Tizen Project</strong>.
-<p>Select a template for a mobile native application and create a project using the <strong>Basic UI with DALi</strong> template. Click <strong>Finish</strong>, and your project is created at the default location. If you want to change the location, uncheck <strong>Use default location</strong> and set a new location. For more information, see <a href="../../../../org.tizen.tutorials/html/native/process/app_dev_process_n.htm#creating">Creating the Application Project</a>.</p>
+<p>Select a template for a mobile native application and create a project using the <strong>Basic UI with DALi</strong> template. Click <strong>Finish</strong>, and your project is created at the default location. If you want to change the location, uncheck <strong>Use default location</strong> and set a new location. For more information, see <a href="../../../../org.tizen.training/html/native/process/app_dev_process_n.htm#creating">Creating the Application Project</a>.</p>
<p align="center"><img alt="Create a DALi project" src="../../images/tizen_project_dali.png" /></p>
</li>
</script>
</body>
-</html>
\ No newline at end of file
+</html>
Evas_Object *next_btn, Evas_Object *content, const char *item_style);
</pre>
<ul>
-<li><p>In Tizen, the <span style="font-family: Courier New,Courier,monospace">next_btn</span> (fourth parameter) is not shown, so use <span style="font-family: Courier New,Courier,monospace">NULL</span>. The <span style="font-family: Courier New,Courier,monospace">prev_btn</span> (third parameter) is supported, but auto pushing is also supported over Tizen 2.4. As a result, use <span style="font-family: Courier New,Courier,monospace">NULL</span> for <span style="font-family: Courier New,Courier,monospace">prev_btn</span> too, and set the auto-pushed flag (about the <span style="font-family: Courier New,Courier,monospace">prev_btn</span>) to <span style="font-family: Courier New,Courier,monospace">true</span> (like below).</p>
+<li><p>In Tizen, the <span style="font-family: Courier New,Courier,monospace">next_btn</span> (fourth parameter) is not shown, so use <span style="font-family: Courier New,Courier,monospace">NULL</span>. The <span style="font-family: Courier New,Courier,monospace">prev_btn</span> (third parameter) is supported, but auto pushing is also supported from Tizen 2.4. As a result, use <span style="font-family: Courier New,Courier,monospace">NULL</span> for <span style="font-family: Courier New,Courier,monospace">prev_btn</span> too, and set the auto-pushed flag (about the <span style="font-family: Courier New,Courier,monospace">prev_btn</span>) to <span style="font-family: Courier New,Courier,monospace">true</span> (like below).</p>
<pre class="prettyprint">
/* Make prev_btn automatically, if multiple items are pushed (default: EINA_FALSE) */
elm_naviframe_prev_btn_auto_pushed_set(nf, EINA_TRUE);
</pre></li>
<li>
-<p>The last parameter is the style of the naviframe item. In Tizen
2.4 mobile, various <a href="#style">item styles</a> are provided:</p>
+<p>The last parameter is the style of the naviframe item. In Tizen mobile, various <a href="#style">item styles</a> are provided:</p>
<ul><li>If an item style supports text parts, fill the text parts with the <span style="font-family: Courier New,Courier,monospace">elm_object_item_part_text_set()</span> function:
<pre class="prettyprint">
elm_object_item_part_text_set(nf_it, "subtitle", "subtitle");
<h2 id="style">Item Styles</h2>
-<p>The following table lists the item styles available for Tizen 2.4 mobile applications.</p>
+<p>The following table lists the item styles available for Tizen mobile applications.</p>
<table>
<caption>Table: Naviframe item styles</caption>
<?xml version="1.0" encoding="UTF-8"?>\r
<projectDescription>\r
- <name>org.tizen.tutorials_3.0.0</name>\r
+ <name>org.tizen.training_3.0.0</name>\r
<comment></comment>\r
<projects>\r
</projects>\r
Manifest-Version: 1.0\r
Bundle-ManifestVersion: 1\r
-Bundle-Name: Getting Started\r
-Bundle-SymbolicName: org.tizen.tutorials;singleton=true\r
+Bundle-Name: Training\r
+Bundle-SymbolicName: org.tizen.training;singleton=true\r
Bundle-Version: 3.0.0\r
Bundle-Vendor: The Linux Foundation\r
\r
<li><a href="native/feature/ui_builder_app_design_mn.htm">Designing Your Native Application</a></li>
<li><a href="native/details/details_n.htm">Understanding Tizen Programming</a>
<ul>
+ <li><a href="native/details/tizen_apis_n.htm">Tizen APIs</a></li>
+ <li><a href="native/details/sec_privileges_n.htm">Security and API Privileges</a></li>
<li><a href="native/details/app_filtering_n.htm">Application Filtering</a></li>
- <li><a href="native/details/error_handling_n.htm">Error Handling</a></li>
- <li><a href="native/details/event_handling_n.htm">Event Handling</a></li>
+ <li><a href="native/details/event_handling_n.htm">Event Handling</a></li>
+ <li><a href="native/details/error_handling_n.htm">Error Handling</a></li>
<li><a href="native/details/io_overview_n.htm">File System Directory Hierarchy</a></li>
- <li><a href="native/details/sec_privileges_n.htm">Security and API Privileges</a></li>
- <li><a href="native/details/tizen_apis_n.htm">Tizen APIs</a></li>
<li><a href="native/details/deprecation_policy_n.htm">API Versioning and Deprecation Policy of the Tizen Platform</a></li>
<li><a href="native/details/sign_certificate_n.htm">Application Signing and Certificates</a></li>
</ul>
<li><a href="web/details/sec_privileges_w.htm">Security and API Privileges</a></li>
<li><a href="web/details/app_filtering_w.htm">Application Filtering</a></li>
<li><a href="web/details/web_runtime_w.htm">Web Runtime</a></li>
- <li><a href="web/details/event_handling_w.htm">Event Handling</a></li>
+ <li><a href="web/details/event_handling_w.htm">Event Handling</a></li>
+ <li><a href="web/details/deprecation_policy_w.htm">API Versioning and Deprecation Policy of the Tizen Platform</a></li>
<li><a href="web/details/sign_certificate_w.htm">Application Signing and Certificates</a></li>
</ul>
</li>
<p>The following list shows the directory hierarchy:</p>
<ul>
-<li><span style="font-family: Courier New,Courier,monospace;">bin</span>
-<p>Executable binary path</p></li>
-<li><span style="font-family: Courier New,Courier,monospace;">lib</span>
-<p>Library path</p></li>
-<li><span style="font-family: Courier New,Courier,monospace;">res</span>
-<p>Resource path</p></li>
-<li><span style="font-family: Courier New,Courier,monospace;">data</span>
-<p>The application's own directory (read or write): no initial data</p></li>
-<li><span style="font-family: Courier New,Courier,monospace;">shared/</span>
-<p>For sharing with other applications</p>
+<li><span style="font-family: Courier New,Courier,monospace;">bin</span>: Executable binary path</li>
+<li><span style="font-family: Courier New,Courier,monospace;">lib</span>: Library path</li>
+<li><span style="font-family: Courier New,Courier,monospace;">res</span>: Resource path</li>
+<li><span style="font-family: Courier New,Courier,monospace;">data</span>: The application's own directory (read or write); no initial data</li>
+<li><span style="font-family: Courier New,Courier,monospace;">shared/</span>: For sharing with other applications
<p>Sandboxing refers to an application package which can access its own directories only. It is used to share resources in the <span style="font-family: Courier New,Courier,monospace;">shared</span> directories.</p>
<p>In sandboxing, <a href="#installer">SMACK</a> is used, and discretionary access control (DAC) is applied to application package directories and files. The
uid(root, app) is applied to directories and files.</p></li>
<div id="toc-navigation">
<div id="profile">
- <p><img alt="Mobile native" src="../../images/mobile_s_n.png"/> <img alt="Wearable native" src="../../images/wearable_s_n.png"/></p>
+ <p><img alt="Mobile" src="../../images/mobile_s_wn.png"/> <img alt="Wearable" src="../../images/wearable_s_wn.png"/></p>
</div>
<div id="toc_border"><div id="toc">
<p class="toc-title">Content</p>
<p>When designing Tizen native applications, you need to take into account the following programming concepts:</p>
<ul>
+ <li><a href="tizen_apis_n.htm">Tizen APIs</a></li>
+ <li><a href="sec_privileges_n.htm">Security and API Privileges</a></li>
<li><a href="app_filtering_n.htm">Application Filtering</a></li>
- <li><a href="error_handling_n.htm">Error Handling</a></li>
<li><a href="event_handling_n.htm">Event Handling</a></li>
+ <li><a href="error_handling_n.htm">Error Handling</a></li>
<li><a href="io_overview_n.htm">File System Directory Hierarchy</a></li>
- <li><a href="sec_privileges_n.htm">Security and API Privileges</a></li>
- <li><a href="tizen_apis_n.htm">Tizen APIs</a></li>
<li><a href="deprecation_policy_n.htm">API Versioning and Deprecation Policy of the Tizen Platform</a></li>
<li><a href="sign_certificate_n.htm">Application Signing and Certificates</a></li>
</ul>
<li>The platform level is the highest privilege level, and an application that needs these privileges requires at least a platform-signed certificate, which is granted to vendor developers.</li>
</ul>
-<p>Since Tizen platform 3.0, some privileges are categorized as privacy related and gives option to the users to switch them on and off. If an application invokes a privileged API, the Tizen system checks whether the privilege is <strong>allowed</strong> to it. For application to get a required privilege, the privilege must be declared in the <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file. If the platform version is 3.0 or higher and the privilege is included in privacy group, it must not be switched off.</p>
+<p>Since Tizen platform 3.0, some privileges are categorized as privacy-related and give an option to the user to switch them on and off. If an application invokes a privacy-related privileged API, the Tizen system checks whether the privilege is <strong>allowed</strong> for the application. For the application to use the API, the privilege must be declared in the <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file and the user must have switched it on.</p>
+
+ <table class="note">
+ <tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">In applications with the platform version 3.0 or higher, if you use privacy-related privileged APIs, make sure that the user has switched the privilege on before making the function call. Otherwise, the application does not work as expected.</td>
+ </tr>
+ </tbody>
+ </table>
<p>The Tizen Studio also provides privilege checker tools to check whether the Tizen application source code contains any privilege violations. For more information, see <a href="../../../../org.tizen.studio/html/native_tools/api_checker_n.htm">Verifying APIs and Privileges</a>.</p>
<td>2.3</td>
<td>The application can set alarms and wake the device up at scheduled times.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/antivirus.admin</span></td>
<td>platform</td>
<td></td>
<td>3.0</td>
<td>The application can enable or disable antivirus programs and manage detected malware.</td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/antivirus.scan</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can request to scan files in other applications or on the device to detect harmful content.</td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/antivirus.webprotect</span></td>
<td>partner</td>
<td></td>
<td>2.4</td>
<td>The application can read the statistics of application usage, such as which applications have been used frequently or recently.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/appmanager.kill</span></td>
<td>platform</td>
<td></td>
<td>2.3</td>
<td>The application can perform unrestricted actions using Bluetooth, such as scanning for and connecting to other devices.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/bluetooth.admin</span></td>
<td>platform</td>
<td></td>
<td>2.3</td>
-<td>The application can change Bluetooth settings, such as turning Bluetooth on or off, set the device name, and enable or disable the AV remote control.</td>
+<td>The application can change Bluetooth settings, such as switching Bluetooth on or off, setting the device name, and enabling or disabling the AV remote control.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/bookmark.admin</span></td>
<td>platform</td>
<td>Bookmark</td>
<td>public</td>
<td>Camera</td>
<td>2.3</td>
-<td>The application can take pictures and turn the camera flash on and off while using the camera.</td>
+<td>The application can take pictures and switch the camera flash on and off while using the camera.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/contact.read</span></td>
<td>2.3</td>
<td>The application can manage HTTP downloads. This can result in additional charges depending on the user's payment plan.</td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.bluetooth</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can restrict Bluetooth connections. This can prevent applications that use Bluetooth from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.browser</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can prevent the use of browser applications. This can prevent applications that use browser applications from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.camera</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can restrict the use of the camera. This can prevent applications that use the camera from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.clipboard</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can restrict the use of the clipboard. This can prevent applications that use the clipboard from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.debugging</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can restrict the use of debugging. This can prevent applications that use debugging from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.email</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can restrict POP and IMAP email access. This can prevent applications that use email services from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.location</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can restrict the use of location functions. This can prevent applications that use location functions from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.lock</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can lock the device.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.message</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can restrict the use of text, multimedia, and chat messaging services. This can prevent applications that use messaging services from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.microphone</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can restrict the use of the microphone. This can prevent applications that use the microphone from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.password</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can manage password policies and reset the passwords used to unlock the device and recover data.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.security</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
-<td>The application can change security settings such as those for certificate installation, data encryption, and factory data resets.<p><strong>Allowed to licensed partners.</strong></p></td>
+<td>The application can change security settings
, such as those for certificate installation, data encryption, and factory data resets.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.storage</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
-<td>The application can prevent the use of external storage such as SD cards and USB storage devices. This can prevent applications that use external storage from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
+<td>The application can prevent the use of external storage
s, such as SD cards and USB storage devices. This can prevent applications that use external storage from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.usb</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can prevent USB connections, including the use of USB tethering. This can prevent applications that use USB connections from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.wifi</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
-<td>The application can restrict the use of Wi-Fi networks and mobile hotspots. If the device can
't connect to a Wi-Fi network, it can connect to a mobile network. This can result in additional charges depending on the user's payment plan.<p><strong>Allowed to licensed partners.</strong></p></td>
+<td>The application can restrict the use of Wi-Fi networks and mobile hotspots. If the device can
not connect to a Wi-Fi network, it can connect to a mobile network. This can result in additional charges depending on the user's payment plan.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.wipe</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can erase all data from the user's device and reset the user's device to its factory default settings.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.zone</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
-<td>The application can create and remove containers. Containers are private workspaces which provide separate app runtime environments and data storage.<p><strong>Allowed to licensed partners.</strong></p></td>
+<td>The application can create and remove containers. Containers are private workspaces which provide separate app
lication runtime environments and data storage.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/email</span></td>
<td>2.3</td>
<td>The application can manage the user's email accounts, including the user's folders and emails, POP3 and IMAP downloads, and SMTP uploads. This can result in additional charges depending on the user's payment plan.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/email.admin</span></td>
<td>platform</td>
<td></td>
<td>2.4</td>
<td>The application can manage installed input methods.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/inputgenerator</span></td>
<td>platform</td>
<td></td>
<td>2.4</td>
<td>The application can simulate keys being pressed and touch interactions with the screen.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/keygrab</span></td>
<td>platform</td>
<td></td>
<td>public</td>
<td></td>
<td>2.3</td>
-<td>The application can save keys, certificates, and data to, and retrieve and delete them from,
password-protected storage. Checking the statuses of certificates while connected to a mobile network can result in additional charges depending on the user's payment plan. <p><strong>Deprecated since 3.0.</strong></p></td>
+<td>The application can save keys, certificates, and data to, and retrieve and delete them from,
a password-protected storage. Checking the status of certificates while connected to a mobile network can result in additional charges depending on the user's payment plan. <p><strong>Deprecated since 3.0.</strong></p></td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/keymanager.admin</span></td>
<td>platform</td>
<td></td>
<td>public</td>
<td></td>
<td>2.3</td>
-<td>The application can turn LEDs on or off, such as the LED on the front of the device and the camera flash.</td>
+<td>The application can switch LEDs on or off, such as the LED on the front of the device and the camera flash.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/location</span></td>
<td>public</td>
<td>Location</td>
<td>3.0</td>
-<td>The application can determine the user's approximate location including the user's device's Cell ID, LAC (Location Area Code), and TAC (Tracking Area Code).</td>
+<td>The application can determine the user's approximate location including the user device's Cell ID, LAC (Location Area Code), and TAC (Tracking Area Code).</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/location.enable</span></td>
<td>platform</td>
<td>Location</td>
<td>public</td>
<td>Message</td>
<td>2.3</td>
-<td>The application can write, send, delete, and move text and multimedia messages, and change the settings and statuses of the messages, such as read or unread.</td>
+<td>The application can write, send, delete, and move text and multimedia messages, and change the settings and status of the messages, such as read or unread.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/minicontrol.provider</span></td>
<td>public</td>
<td></td>
<td>2.3</td>
-<td>The application can retrieve network information such as the status of each network, its type, and detailed network profile information.</td>
+<td>The application can retrieve network information, such as the status of each network, its type, and detailed network profile information.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/network.profile</span></td>
<td>public</td>
<td></td>
<td>2.3</td>
-<td>The application can turn Wi-Fi on and off, and connect to and disconnect from Wi-Fi and mobile networks. This can result in additional charges depending on the user's payment plan.</td>
+<td>The application can switch Wi-Fi on and off, and connect to and disconnect from Wi-Fi and mobile networks. This can result in additional charges depending on the user's payment plan.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/nfc</span></td>
<td>2.3</td>
<td>The application can read and write NFC tag information, and send NFC messages to other devices.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/nfc.admin</span></td>
<td>platform</td>
<td></td>
<td>2.3</td>
-<td>The application can change NFC settings, such as turning NFC on or off.</td>
+<td>The application can change NFC settings, such as switching NFC on or off.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/nfc.cardemulation</span></td>
<td>2.3</td>
<td>The application can show and hide its own notifications and badges.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/packagemanager.admin</span></td>
<td>platform</td>
<td></td>
<td>2.3</td>
<td>The application can receive notifications from the Internet. This can result in additional charges depending on the user's payment plan.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/reboot</span></td>
<td>platform</td>
<td></td>
<td>2.3</td>
<td>The application can record video and audio.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/screenshot</span></td>
<td>platform</td>
<td></td>
<td>2.3</td>
<td>The application can read and write unrestricted system settings.<p><strong>Deprecated since 2.3.1.</strong></p></td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/systemsettings.admin</span></td>
<td>platform</td>
<td></td>
<td>public</td>
<td></td>
<td>2.3</td>
-<td>The application can retrieve telephony information, such as the network and SIM card used, the IMEI, and the statuses of calls.</td>
+<td>The application can retrieve telephony information, such as the network and SIM card used, the IMEI, and the status of calls.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/telephony.admin</span></td>
<td>platform</td>
<td></td>
<td>2.3</td>
<td>The application can manage telephony settings, such as those for incoming and outgoing calls, forwarding and holding calls, networks, and SIM cards.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/tethering.admin</span></td>
<td>platform</td>
<td></td>
<td>3.0</td>
<td>The application can manage the VPN (virtual private network) and change its settings.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/web-history.admin</span></td>
<td>platform</td>
<td>User history</td>
<td>public</td>
<td></td>
<td>2.3</td>
-<td>The application can enable and disable Wi-Fi Direct, manage Wi-Fi Direct connections, and change Wi-Fi Direct settings.</td>
+<td>The application can enable and disable Wi-Fi Direct™, manage Wi-Fi Direct™ connections, and change Wi-Fi Direct™ settings.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/window.priority.set</span></td>
<td>2.3.1</td>
<td>The application can set alarms and wake the device up at scheduled times.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/antivirus.admin</span></td>
<td>platform</td>
<td></td>
<td>3.0</td>
<td>The application can enable or disable antivirus programs and manage detected malware.</td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/antivirus.scan</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
-<td>The application can request to scan files in any other applications or on the device to detect harmful content.</td>
+<td>The application can request to scan files in other applications or on the device to detect harmful content.</td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/antivirus.webprotect</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
-<td>The application can check the reputation of a web address and determine whether accessing it can put the user's device at risk.</td>
+<td>The application can check the reputation of a Web address and determine whether accessing it can put the user's device at risk.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/appmanager.kill</span></td>
<td>platform</td>
<td></td>
<td>2.3.1</td>
<td>The application can perform unrestricted actions using Bluetooth, such as scanning for and connecting to other devices.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/bluetooth.admin</span></td>
<td>platform</td>
<td></td>
<td>2.3.1</td>
-<td>The application can change Bluetooth settings, such as turning Bluetooth on or off, set the device name, and enable or disable the AV remote control.</td>
+<td>The application can change Bluetooth settings, such as switching Bluetooth on or off, setting the device name, and enabling or disabling the AV remote control.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/call</span></td>
<td>public</td>
<td>Camera</td>
<td>2.3.1</td>
-<td>The application can take pictures and turn the camera flash on and off while using the camera.</td>
+<td>The application can take pictures and switch the camera flash on and off while using the camera.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/contact.read</span></td>
<td>2.3.1</td>
<td>The application can manage HTTP downloads. This can result in additional charges depending on the user's payment plan.</td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.bluetooth</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can restrict Bluetooth connections. This can prevent applications that use Bluetooth from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.browser</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can prevent the use of browser applications. This can prevent applications that use browser applications from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.camera</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can restrict the use of the camera. This can prevent applications that use the camera from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.clipboard</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can restrict the use of the clipboard. This can prevent applications that use the clipboard from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.debugging</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can restrict the use of debugging. This can prevent applications that use debugging from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.email</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can restrict POP and IMAP email access. This can prevent applications that use email services from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.location</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can restrict the use of location functions. This can prevent applications that use location functions from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.lock</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can lock the device.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.message</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can restrict the use of text, multimedia, and chat messaging services. This can prevent applications that use messaging services from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.microphone</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can restrict the use of the microphone. This can prevent applications that use the microphone from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.password</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can manage password policies and reset the passwords used to unlock the device and recover data.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.security</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
-<td>The application can change security settings such as those for certificate installation, data encryption, and factory data resets.<p><strong>Allowed to licensed partners.</strong></p></td>
+<td>The application can change security settings
, such as those for certificate installation, data encryption, and factory data resets.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.storage</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
-<td>The application can prevent the use of external storage such as SD cards and USB storage devices. This can prevent applications that use external storage from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
+<td>The application can prevent the use of external storage
s, such as SD cards and USB storage devices. This can prevent applications that use external storage from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.usb</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can prevent USB connections, including the use of USB tethering. This can prevent applications that use USB connections from working properly.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.wifi</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
-<td>The application can restrict the use of Wi-Fi networks and mobile hotspots. If the
phone can't connect to a Wi-Fi network, it can connect to a mobile network. This can result in additional charges depending on the user's payment plan.<p><strong>Allowed to licensed partners.</strong></p></td>
+<td>The application can restrict the use of Wi-Fi networks and mobile hotspots. If the
device cannot connect to a Wi-Fi network, it can connect to a mobile network. This can result in additional charges depending on the user's payment plan.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.wipe</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
<td>The application can erase all data from the user's device and reset the user's device to its factory default settings.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
-<tr>
+<tr class="partner-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/dpm.zone</span></td>
<td>partner</td>
<td></td>
<td>3.0</td>
-<td>The application can create and remove containers. Containers are private workspaces which provide separate app runtime environments and data storage.<p><strong>Allowed to licensed partners.</strong></p></td>
+<td>The application can create and remove containers. Containers are private workspaces which provide separate app
lication runtime environments and data storage.<p><strong>Allowed to licensed partners.</strong></p></td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/email</span></td>
<td>3.0</td>
<td>The application can manage installed input methods.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/inputgenerator</span></td>
<td>platform</td>
<td></td>
<td>3.0</td>
<td>The application can simulate keys being pressed and touch interactions with the screen.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/keygrab</span></td>
<td>platform</td>
<td></td>
<td>public</td>
<td></td>
<td>2.3.1</td>
-<td>The application can save keys, certificates, and data to, and retrieve and delete them from password-protected storage.</td>
+<td>The application can save keys, certificates, and data to, and retrieve and delete them from, a password-protected storage.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/keymanager.admin</span></td>
<td>platform</td>
<td></td>
<td>public</td>
<td></td>
<td>2.3.1</td>
-<td>The application can turn LEDs on or off, such as the LED on the front of the device and the camera flash.</td>
+<td>The application can switch LEDs on or off, such as the LED on the front of the device and the camera flash.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/location</span></td>
<td>public</td>
<td>Location</td>
<td>3.0</td>
-<td>The application can determine the user's approximate location including the user's device's Cell ID, LAC (Location Area Code), and TAC (Tracking Area Code).</td>
+<td>The application can determine the user's approximate location including the user device's Cell ID, LAC (Location Area Code), and TAC (Tracking Area Code).</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/location.enable</span></td>
<td>platform</td>
<td>Location</td>
<td>2.3.1</td>
-<td>The application can control your location service settings.</td>
+<td>The application can control the user's location service settings.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/mapservice</span></td>
<td>public</td>
<td>Message</td>
<td>2.3.1</td>
-<td>The application can write, send, delete, and move text and multimedia messages, download multimedia messages, and change the settings and statuses of messages, such as read or unread. This can result in additional charges depending on the user's payment plan.</td>
+<td>The application can write, send, delete, and move text and multimedia messages, download multimedia messages, and change the settings and status of the messages, such as read or unread. This can result in additional charges depending on the user's payment plan.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/network.get</span></td>
<td>public</td>
<td></td>
<td>2.3.1</td>
-<td>The application can retrieve network information such as the status of each network, its type, and detailed network profile information.</td>
+<td>The application can retrieve network information, such as the status of each network, its type, and detailed network profile information.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/network.profile</span></td>
<td>public</td>
<td></td>
<td>2.3.1</td>
-<td>The application can turn Wi-Fi on and off, and connect to and disconnect from Wi-Fi and mobile networks. This can result in additional charges depending on the user's payment plan.</td>
+<td>The application can switch Wi-Fi on and off, and connect to and disconnect from Wi-Fi and mobile networks. This can result in additional charges depending on the user's payment plan.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/nfc</span></td>
<td>2.3.1</td>
<td>The application can read and write NFC tag information, and send NFC messages to other devices.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/nfc.admin</span></td>
<td>platform</td>
<td></td>
<td>2.3.1</td>
-<td>The application can change NFC settings, such as turning NFC on or off.</td>
+<td>The application can change NFC settings, such as switching NFC on or off.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/nfc.cardemulation</span></td>
<td>2.3.1</td>
<td>The application can show and hide its own notifications and badges.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/packagemanager.admin</span></td>
<td>platform</td>
<td></td>
<td>2.3.1</td>
<td>The application can receive notifications from the Internet. This can result in additional charges depending on the user's payment plan.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/reboot</span></td>
<td>platform</td>
<td></td>
<td>2.3.1</td>
<td>The application can record video and audio.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/screenshot</span></td>
<td>platform</td>
<td></td>
<td>3.0</td>
<td>The application can read system information, including information from the CPU and RAM.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/systemsettings.admin</span></td>
<td>platform</td>
<td></td>
<td>public</td>
<td></td>
<td>2.3.1</td>
-<td>The application can retrieve telephony information, such as the network and SIM card used, the IMEI, and the statuses of calls.</td>
+<td>The application can retrieve telephony information, such as the network and SIM card used, the IMEI, and the status of calls.</td>
</tr>
-<tr>
+<tr class="platform-level">
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/telephony.admin</span></td>
<td>platform</td>
<td></td>
<td>public</td>
<td></td>
<td>2.3.1</td>
-<td>The application can appear on top of other windows and screens, including the lock screen, according to the order of priority of the windows. This can prevent you from interacting with other applications or screens until the window for the application is closed.</td>
+<td>The application can appear on top of other windows and screens, including the lock screen, according to the order of priority of the windows. This can prevent the user from interacting with other applications or screens until the window for the application is closed.</td>
</tr>
</tbody>
</table>
<td><span style="font-family: Courier New,Courier,monospace;">http://tizen.org/privilege/appdir.shareddata</span></td>
<td>public</td>
<td>3.0 / 3.0</td>
-<td>Since Tizen 3.0, application must have this privilege to support shared/data directory.
-<p>The <span style="font-family: Courier New,Courier,monospace;">app_get_shared_data_path()</span> and <span style="font-family: Courier New,Courier,monospace;">app_manager_get_shared_data_path()</span> functions return an error when the application does not have this privilege. Note that the <span style="font-family: Courier New,Courier,monospace;">shared/data</span> directory is writable for the application itself and readable for all other applications. You must be careful when you use this privilege and share data through the <span style="font-family: Courier New,Courier,monospace;">shared/data</span> directory. To share files with another application, try to pass the file path through an app control. It is a more secure way for sharing files between applications.</p></td>
+<td>Since Tizen 3.0, the application must have this privilege to support the <span style="font-family: Courier New,Courier,monospace;">shared/data</span> directory.
+<p>The <span style="font-family: Courier New,Courier,monospace;">app_get_shared_data_path()</span> and <span style="font-family: Courier New,Courier,monospace;">app_manager_get_shared_data_path()</span> functions return an error when the application does not have this privilege. Note that the <span style="font-family: Courier New,Courier,monospace;">shared/data</span> directory is writable for the application itself and readable for all other applications. You must be careful when you use this privilege and share data through the <span style="font-family: Courier New,Courier,monospace;">shared/data</span> directory. For a more secure way of sharing files with another application, try to pass the file path through an application control.</p></td>
</tr>
</tbody>
</table>
<caption>Table: Mobile native API modules</caption>
<tbody>
<tr>
- <th>API module</th>
- <th>Description</th>
+ <th>API module</th>
<th>API submodule</th>
- <th>Functionality</th>
+ <th>Functionality</th>
+ <th>Description</th>
</tr>
<tr>
<td rowspan="5"><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__ACCOUNT__FRAMEWORK.html">Account</a></td>
+ <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__ACCOUNT__MANAGER__MODULE.html">Account Manager</a></td>
+ <td>Provides CRUD (Create, Read, Update, Delete) account management functionality.</td>
<td rowspan="5">The Account API module features include managing various account information, such as receiving sync operation notifications and obtaining an access token by using the OAuth 2.0 authorization.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/personal/personal_cover_n.htm">Personal Data</a></li></ul>
</td>
- <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__ACCOUNT__MANAGER__MODULE.html">Account Manager</a></td>
- <td>Provides CRUD (Create, Read, Update, Delete) account management functionality.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__FIDO__MODULE.html">FIDO Client</a>
</tr>
<tr>
<td rowspan="12"><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__APPLICATION__FRAMEWORK.html">Application Framework</a></td>
+ <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__APPLICATION__MODULE.html">Application</a></td>
+ <td>Manages the application's main event loop, state change events, and basic system events, and gets information about the application. It is also used to launch other applications.
+ </td>
<td rowspan="12">The Application Framework API contains submodule APIs for application development. The submodule APIs enable application life-cycle management, usage of functionality that is exported by other applications, and access to a user's application preferences.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/app_management/app_management_cover_n.htm">Application Management</a></li>
<li><a href="../../../../org.tizen.guides/html/native/notification/notification_cover_n.htm">Notifications and Content Sharing</a></li></ul>
</td>
- <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__APPLICATION__MODULE.html">Application</a></td>
- <td>Manages the application's main event loop, state change events, and basic system events, and gets information about the application. It is also used to launch other applications.
- </td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__SERVICE__APP__MODULE.html">Service Application</a></td>
</tr>
<tr>
<td rowspan="9"><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__BASE__FRAMEWORK.html">Base</a></td>
+ <td><a href="../../../../org.tizen.native.mobile.apireference/group__OPENSRC__STL__GCC__FRAMEWORK.html">C++ Standard Library</a></td>
+ <td>Provides a standard C++ library.</td>
<td rowspan="9">The Base API contains submodule APIs for internationalization support and contains various open source libraries.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/data/data_cover_n.htm">Data Storage and Management</a></li>
<li><a href="../../../../org.tizen.guides/html/native/internationalization/internationalization_cover_n.htm">Internationalization</a></li>
</ul></td>
- <td><a href="../../../../org.tizen.native.mobile.apireference/group__OPENSRC__STL__GCC__FRAMEWORK.html">C++ Standard Library</a></td>
- <td>Provides a standard C++ library.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.mobile.apireference/group__OPENSRC__ZLIB__FRAMEWORK.html">zlib</a><p><strong>(since 2.4)</strong></p></td>
</tr>
<tr>
<td rowspan="3"><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__CONTENT__FRAMEWORK.html">Content</a></td>
+ <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__WEB__DOWNLOAD__MODULE.html">Download</a></td>
+ <td>Creates and manages one or more download requests. Content is downloaded from servers through an HTTP connection.</td>
<td rowspan="3">The Content API module contains submodule APIs for managing the most common device media data types, such as image, audio, and video files. It provides operations to search for content, search for content information stored on the device, create playlists, download content from servers through an HTTP connection, and access the EXIF information of an image file.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/connectivity/connectivity_cover_n.htm">Connectivity and Wireless</a></li>
<li><a href="../../../../org.tizen.guides/html/native/media/media_cover_n.htm">Media and Camera</a></li></ul></td>
- <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__WEB__DOWNLOAD__MODULE.html">Download</a></td>
- <td>Creates and manages one or more download requests. Content is downloaded from servers through an HTTP connection.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__CONTENT__MIME__TYPE__MODULE.html">MIME Type</a></td>
</tr>
<tr>
<td rowspan="4"><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__CONTEXT__FRAMEWORK.html">Context</a></td>
+ <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__CONTEXT__ACTIVITY__MODULE.html">Activity Recognition</a></td>
+ <td>Detects user activities, such as walking, running, and being in a moving vehicle with a device.</td>
<td rowspan="4">The Context API module contains submodule APIs to detect user information such as when a user is running with a device and device information such as gestures when a device is tilted.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/alarm/alarm_cover_n.htm">Alarms and Scheduling</a></li>
<li><a href="../../../../org.tizen.guides/html/native/location_sensors/location_sensors_cover_n.htm">Location and Sensors</a></li></ul></td>
- <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__CONTEXT__ACTIVITY__MODULE.html">Activity Recognition</a></td>
- <td>Detects user activities, such as walking, running, and being in a moving vehicle with a device.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__CONTEXT__GESTURE__MODULE.html">Gesture Recognition</a></td>
</tr>
<tr>
<td rowspan="3"><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__LOCATION__FRAMEWORK.html">Location</a></td>
+ <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__LOCATION__MANAGER__MODULE.html">Location Manager</a></td>
+ <td>Acquires information about the geographical location of the device. It also allows the receiving of notifications about position changes, velocity changes, and when a given geographical area is left.</td>
<td rowspan="3">The Location API module allows the geographical position of a device to be determined for use with location-based services.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/location_sensors/location_sensors_cover_n.htm">Location and Sensors</a></li></ul></td>
- <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__LOCATION__MANAGER__MODULE.html">Location Manager</a></td>
- <td>Acquires information about the geographical location of the device. It also allows the receiving of notifications about position changes, velocity changes, and when a given geographical area is left.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__GEOFENCE__MANAGER__MODULE.html">Geofence Manager</a><p><strong>(since 2.4)</strong></p></td>
<tr>
<td rowspan="3"><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__MESSAGING__FRAMEWORK.html">Messaging</a></td>
+ <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__MESSAGING__EMAIL__MODULE.html">Email</a></td>
+ <td>Allows composing, sending, and receiving of email messages.</td>
<td rowspan="3">The Messaging API module contains submodule APIs which grant access to the messaging capabilities, such as SMS, MMS and email, of the device.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/messaging/messaging_cover_n.htm">Messaging</a></li></ul>
</td>
- <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__MESSAGING__EMAIL__MODULE.html">Email</a></td>
- <td>Allows composing, sending, and receiving of email messages.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__MESSAGING__MESSAGES__MODULE.html">Messages</a></td>
</tr>
<tr>
- <td rowspan="24"><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__MEDIA__FRAMEWORK.html">Multimedia</a></td>
- <td rowspan="24">The Multimedia API module contains submodule APIs for easily integrating an application with audio, image, and video files. It can also be used for image editing.
+ <td rowspan="23"><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__MEDIA__FRAMEWORK.html">Multimedia</a></td>
+ <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__MEDIA__AUDIO__IO__MODULE.html">Audio I/O</a></td>
+ <td>Manages the system audio devices by granting access to the hardware layer of the sound card. This API must be used for tasks that require raw audio data buffers in PCM format.</td>
+ <td rowspan="23">The Multimedia API module contains submodule APIs for easily integrating an application with audio, image, and video files. It can also be used for image editing.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/media/media_cover_n.htm">Media and Camera</a></li></ul></td>
- <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__MEDIA__AUDIO__IO__MODULE.html">Audio I/O</a></td>
- <td>Manages the system audio devices by granting access to the hardware layer of the sound card. This API must be used for tasks that require raw audio data buffers in PCM format.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__MEDIA__CAMERA__MODULE.html">Camera</a></td>
<tr>
<td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__MEDIADEMUXER__MODULE.html">Media Demuxer</a><p><strong>(since 3.0)</strong></p></td>
<td>Provides functions for demuxing media data.</td>
- </tr>
- <tr>
- <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__SYSTEM__MEDIA__KEY__MODULE.html">Media key</a></td>
- <td>Provides functions to handle media keys from external devices that are connected to the Tizen device, such as the volume control buttons on a headset.</td>
- </tr>
+ </tr>
<tr>
<td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__MEDIAMUXER__MODULE.html">Media Muxer</a><p><strong>(since 3.0)</strong></p></td>
<td>Provides functions for muxing media data.</td>
<tr>
<td rowspan="13"><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__NETWORK__FRAMEWORK.html">Network</a></td>
+ <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__NETWORK__BLUETOOTH__MODULE.html">Bluetooth</a></td>
+ <td>Manages Bluetooth devices. This involves launching the Bluetooth adapter and discovering, connecting, and bonding with other Bluetooth devices. </td>
<td rowspan="13">The Network API module contains submodule APIs, which can be used for data communication. It is responsible for managing connections, maintaining IP addresses, and connecting to the system through Bluetooth, Hypertext Transfer Protocol (HTTP), Near Field Communication (NFC), Sockets, and Wi-Fi. It also provides functions for retrieving information about a specific host from the Internet Domain Name System (DNS).
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/connectivity/connectivity_cover_n.htm">Connectivity and Wireless</a></li></ul>
</td>
- <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__NETWORK__BLUETOOTH__MODULE.html">Bluetooth</a></td>
- <td>Manages Bluetooth devices. This involves launching the Bluetooth adapter and discovering, connecting, and bonding with other Bluetooth devices. </td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__NETWORK__CONNECTION__MODULE.html">Connection</a></td>
</tr>
<tr>
<td rowspan="3"><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__SECURITY__FRAMEWORK.html">Security</a></td>
+ <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__KEY__MANAGER__MODULE.html">Key Manager</a></td>
+ <td>Provides functions to store keys, certificates, and sensitive data related to users and their password-protected applications in a secure repository. It also provides cryptographic operations to prevent key value names from being revealed to clients.</td>
<td rowspan="3">The Security API module contains submodule APIs which provide basic cryptographic functions, various utility functions through the OpenSSL open source library, and a secure password-protected repository for keys, certificates, and sensitive data.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/security/security_cover_n.htm">Security</a></li></ul></td>
- <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__KEY__MANAGER__MODULE.html">Key Manager</a></td>
- <td>Provides functions to store keys, certificates, and sensitive data related to users and their password-protected applications in a secure repository. It also provides cryptographic operations to prevent key value names from being revealed to clients.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.mobile.apireference/group__OPENSRC__OPENSSL__FRAMEWORK.html">OpenSSL</a></td>
</tr>
<tr>
<td rowspan="3"><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__SOCIAL__FRAMEWORK.html">Social</a></td>
+ <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__SOCIAL__CALENDAR__SVC__MODULE.html">Calendar</a></td>
+ <td>Manages calendars, including events and tasks. It also stores and queries calendar information.</td>
<td rowspan="3">The Social API module contains submodule APIs to manage personal data, such as contacts and calendars on a device.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/personal/personal_cover_n.htm">Personal Data</a></li>
<li><a href="../../../../org.tizen.guides/html/native/connectivity/connectivity_cover_n.htm">Connectivity and Wireless</a></li> </ul></td>
- <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__SOCIAL__CALENDAR__SVC__MODULE.html">Calendar</a></td>
- <td>Manages calendars, including events and tasks. It also stores and queries calendar information.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__SOCIAL__CONTACTS__SVC__MODULE.html">Contacts</a></td>
<td>Provides common interfaces, such as using a local service for various service infra.</td>
</tr>
<tr>
- <td rowspan="9"><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__SYSTEM__FRAMEWORK.html">System</a></td>
- <td rowspan="9">The System API module contains submodule APIs for system management.
+ <td rowspan="10"><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__SYSTEM__FRAMEWORK.html">System</a></td>
+ <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__SYSTEM__DEVICE__MODULE.html">Device</a></td>
+ <td>Controls devices and monitors their status. For example, this submodule API can be used to control and monitor the device battery, display, and LED.</td>
+ <td rowspan="10">The System API module contains submodule APIs for system management.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/data/data_cover_n.htm">Data Storage and Management</a></li>
<li><a href="../../../../org.tizen.guides/html/native/device/device_cover_n.htm">Device Settings and Systems</a></li>
<li><a href="../../../../org.tizen.guides/html/native/error/error_cover_n.htm">Error Handling</a></li>
<li><a href="../../../../org.tizen.guides/html/native/location_sensors/location_sensors_cover_n.htm">Location and Sensors</a></li>
+ <li><a href="../../../../org.tizen.guides/html/native/media/media_cover_n.htm">Media and Camera</a></li>
<li><a href="../../../../org.tizen.guides/html/native/performance/performance_cover_n.htm">Performance</a></li> </ul>
</td>
- <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__SYSTEM__DEVICE__MODULE.html">Device</a></td>
- <td>Controls devices and monitors their status. For example, this submodule API can be used to control and monitor the device battery, display, and LED.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__SYSTEM__FEEDBACK__MODULE.html">Feedback</a><p><strong>(since 2.4)</strong></p></td>
<td>Provides functions to play sound or vibration associated with properties.</td>
</tr>
+ <tr>
+ <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__SYSTEM__MEDIA__KEY__MODULE.html">Media key</a></td>
+ <td>Provides functions to handle media keys from external devices that are connected to the Tizen device, such as the volume control buttons on a headset.</td>
+ </tr>
<tr>
<td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__SYSTEM__RUNTIME__INFO__MODULE.html">Runtime information</a></td>
<td>Obtains runtime information of a mobile device. For example, this submodule API can obtain information about the device's GPS.</td>
<tr>
<td rowspan="2"><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__TELEPHONY__FRAMEWORK.html">Telephony</a></td>
+ <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__TELEPHONY__INFORMATION.html">Telephony Information</a></td>
+ <td>Obtains call, network, and SIM information.</td>
<td rowspan="2">The Telephony API module contains a submodule API to enable an application to access the telephony capabilities of the device, such as the call facility (call information and status), the network query services, and the SIM module.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/connectivity/connectivity_cover_n.htm">Connectivity and Wireless</a></li>
<li><a href="../../../../org.tizen.guides/html/native/internationalization/internationalization_cover_n.htm">Internationalization</a></li></ul></td>
- <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__TELEPHONY__INFORMATION.html">Telephony Information</a></td>
- <td>Obtains call, network, and SIM information.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__TELEPHONY__PHONE__NUMBER__UTILS__MODULE.html">Phonenumber utils</a><p><strong>(since 2.4)</strong></p></td>
<tr>
<td rowspan="10"><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__UI__FRAMEWORK.html">UI Framework</a></td>
+ <td><a href="../../../../org.tizen.native.mobile.apireference/group__OPENSRC__CAIRO__FRAMEWORK.html">Cairo</a></td>
+ <td>Provides a library for 2D vector graphics drawing. Vector graphics are advantageous because they have small file sizes and can be scaled to any size without any loss of image quality. Cairo EvasGL APIs have been newly added since 2.3.1.</td>
<td rowspan="10">The UI Framework API module contains submodule APIs and open source libraries for 2D and 3D graphics and text.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/graphics/graphics_cover_n.htm">Graphics</a></li>
<li><a href="../../../../org.tizen.guides/html/native/notification/notification_cover_n.htm">Notifications and Content Sharing</a></li>
<li><a href="../../../../org.tizen.guides/html/native/ui/ui_cover_n.htm">User Interface</a></li></ul></td>
- <td><a href="../../../../org.tizen.native.mobile.apireference/group__OPENSRC__CAIRO__FRAMEWORK.html">Cairo</a></td>
- <td>Provides a library for 2D vector graphics drawing. Vector graphics are advantageous because they have small file sizes and can be scaled to any size without any loss of image quality. Cairo EvasGL APIs have been newly added since 2.3.1.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.mobile.apireference/group__dali.html">DALi</a></td>
</tr>
<tr>
<td rowspan="6"><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__UIX__FRAMEWORK.html">UIX</a></td>
+ <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__UIX__STT__MODULE.html">STT</a></td>
+ <td>Provides functions to recognize speech.</td>
<td rowspan="6">The UIX API module contains submodule APIs for managing sound data, such as voice commands.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/text_input/text_input_cover_n.htm">Text Input and Voice</a></li></ul></td>
- <td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__UIX__STT__MODULE.html">STT</a></td>
- <td>Provides functions to recognize speech.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__UIX__TTS__MODULE.html">TTS</a></td>
</tr>
<tr>
<td rowspan="2"><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__WEB__FRAMEWORK.html">Web</a></td>
+ <td><a href="../../../../org.tizen.native.mobile.apireference/group__OPENSRC__JSONGLIB__FRAMEWORK.html">Json-Glib</a></td>
+ <td>Allows reading and parsing of JavaScript Object Notation (JSON) documents.</td>
<td rowspan="2">The Web API module contains submodule APIs for browsing the Internet, tracking browsing history, downloading Web content, and manipulating JavaScript Object Notation (JSON) documents.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/connectivity/connectivity_cover_n.htm">Connectivity and Wireless</a></li></ul></td>
- <td><a href="../../../../org.tizen.native.mobile.apireference/group__OPENSRC__JSONGLIB__FRAMEWORK.html">Json-Glib</a></td>
- <td>Allows reading and parsing of JavaScript Object Notation (JSON) documents.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.mobile.apireference/group__WEBVIEW.html">WebView</a></td>
<caption>Table: Wearable native API modules</caption>
<tbody>
<tr>
- <th>API module</th>
- <th>Description</th>
+ <th>API module</th>
<th>API submodule</th>
- <th>Functionality</th>
+ <th>Functionality</th>
+ <th>Description</th>
</tr>
<tr>
<td rowspan="5"><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__ACCOUNT__FRAMEWORK.html">Account</a></td>
+ <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__ACCOUNT__MANAGER__MODULE.html">Account Manager</a></td>
+ <td>Provides CRUD (Create, Read, Update, Delete) account management functionality.</td>
<td rowspan="5">The Account API module features include managing various account information, such as receiving sync operation notifications and obtaining an access token by using the OAuth 2.0 authorization.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/personal/personal_cover_n.htm">Personal Data</a></li></ul>
</td>
- <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__ACCOUNT__MANAGER__MODULE.html">Account Manager</a></td>
- <td>Provides CRUD (Create, Read, Update, Delete) account management functionality.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__FIDO__MODULE.html">FIDO Client</a>
</tr>
<tr>
<td rowspan="10"><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__APPLICATION__FRAMEWORK.html">Application Framework</a></td>
+ <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__APPLICATION__MODULE.html">Application</a></td>
+ <td>Manages the application's main event loop, state change events, and basic system events, and gets information about the application. It is also used to launch other applications.
+ </td>
<td rowspan="10">The Application Framework API contains submodule APIs for application development. The submodule APIs enable application life-cycle management, usage of functionality that is exported by other applications, and access to a user's application preferences.
<p>Guides:</p>
<li><a href="../../../../org.tizen.guides/html/native/alarm/alarm_cover_n.htm">Alarms and Scheduling</a></li>
<li><a href="../../../../org.tizen.guides/html/native/app_management/app_management_cover_n.htm">Application Management</a></li></ul>
</td>
- <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__APPLICATION__MODULE.html">Application</a></td>
- <td>Manages the application's main event loop, state change events, and basic system events, and gets information about the application. It is also used to launch other applications.
- </td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__SERVICE__APP__MODULE.html">Service Application</a></td>
</tr>
<tr>
<td rowspan="8"><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__BASE__FRAMEWORK.html">Base</a></td>
+ <td><a href="../../../../org.tizen.native.wearable.apireference/group__OPENSRC__STL__GCC__FRAMEWORK.html">C++ Standard Library</a></td>
+ <td>Provides a standard C++ library.</td>
<td rowspan="8">The Base API contains submodule APIs for internationalization support and contains various open source libraries.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/data/data_cover_n.htm">Data Storage and Management</a></li>
<li><a href="../../../../org.tizen.guides/html/native/internationalization/internationalization_cover_n.htm">Internationalization</a></li>
</ul></td>
- <td><a href="../../../../org.tizen.native.wearable.apireference/group__OPENSRC__STL__GCC__FRAMEWORK.html">C++ Standard Library</a></td>
- <td>Provides a standard C++ library.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.wearable.apireference/group__OPENSRC__EGLIBC__FRAMEWORK.html">EGlibc</a></td>
</tr>
<tr>
<td rowspan="2"><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__CONTENT__FRAMEWORK.html">Content</a></td>
+ <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__CONTENT__MIME__TYPE__MODULE.html">MIME Type</a></td>
+ <td>Maps MIME types to file extensions and vice versa. For example, the <span style="font-family: Courier New,Courier,monospace;">.jpeg</span> file extension is mapped to the <span style="font-family: Courier New,Courier,monospace;">image/jpeg</span> MIME type, which is required when using other API modules, such as the AppControl API in the Application submodule API, because it operates with MIME types.</td>
<td rowspan="2">The Content API module contains submodule APIs for managing the most common device media data types, such as image, audio, and video files. It provides operations to search for content, search for content information stored on the device, create playlists, and access the EXIF information of an image file.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/media/media_cover_n.htm">Media and Camera</a></li></ul></td>
- <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__CONTENT__MIME__TYPE__MODULE.html">MIME Type</a></td>
- <td>Maps MIME types to file extensions and vice versa. For example, the <span style="font-family: Courier New,Courier,monospace;">.jpeg</span> file extension is mapped to the <span style="font-family: Courier New,Courier,monospace;">image/jpeg</span> MIME type, which is required when using other API modules, such as the AppControl API in the Application submodule API, because it operates with MIME types.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__MEDIA__CONTENT__MODULE.html">Media Content</a></td>
</tr>
<tr>
<td rowspan="2"><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__CONTEXT__FRAMEWORK.html">Context</a></td>
+ <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__CONTEXT__ACTIVITY__MODULE.html">Activity Recognition</a></td>
+ <td>Detects user activities, such as walking, running, and being in a moving vehicle with a device.</td>
<td rowspan="2">The Context API module contains submodule APIs to detect user information such as when a user is running with a device and device information such as gestures when a device is tilted.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/location_sensors/location_sensors_cover_n.htm">Location and Sensors</a></li> </ul></td>
- <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__CONTEXT__ACTIVITY__MODULE.html">Activity Recognition</a></td>
- <td>Detects user activities, such as walking, running, and being in a moving vehicle with a device.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__CONTEXT__GESTURE__MODULE.html">Gesture Recognition</a></td>
</tr>
<tr>
<td rowspan="1"><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__LOCATION__FRAMEWORK.html">Location</a></td>
+ <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__LOCATION__MANAGER__MODULE.html">Location Manager</a></td>
+ <td>Acquires information about the geographical location of the device. It also allows the receiving of notifications about position changes, velocity changes, and when a given geographical area is left.</td>
<td rowspan="1">The Location API module allows the geographical position of a device to be determined for use with location-based services.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/location_sensors/location_sensors_cover_n.htm">Location and Sensors</a></li></ul></td>
- <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__LOCATION__MANAGER__MODULE.html">Location Manager</a></td>
- <td>Acquires information about the geographical location of the device. It also allows the receiving of notifications about position changes, velocity changes, and when a given geographical area is left.</td>
</tr>
<tr>
<td rowspan="2"><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__MESSAGING__FRAMEWORK.html">Messaging</a></td>
+ <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__MESSAGING__MESSAGES__MODULE.html">Messages</a></td>
+ <td>Allows composing, sending, and receiving of SMS, MMS, and WAP push messages.</td>
<td rowspan="2">The Messaging API module contains submodule APIs which grant access to the messaging capabilities, such as SMS and MMS, of the device.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/messaging/messaging_cover_n.htm">Messaging</a></li></ul>
</td>
- <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__MESSAGING__MESSAGES__MODULE.html">Messages</a></td>
- <td>Allows composing, sending, and receiving of SMS, MMS, and WAP push messages.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__MESSAGING__PUSH__PUBLIC__MODULE.html">Push</a></td>
<td>Allows receiving of push notifications from a push server.</td>
- </tr>
-
- <tr>
- <td rowspan="18"><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__MEDIA__FRAMEWORK.html">Multimedia</a></td>
- <td rowspan="18">The Multimedia API module contains submodule APIs for easily integrating an application with audio, image, and video files. It can also be used for image editing.
+ </tr>
+ <tr>
+ <td rowspan="17"><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__MEDIA__FRAMEWORK.html">Multimedia</a></td>
+ <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__MEDIA__AUDIO__IO__MODULE.html">Audio I/O</a></td>
+ <td>Manages the system audio devices by granting access to the hardware layer of the sound card. This API must be used for tasks that require raw audio data buffers in PCM format.</td>
+ <td rowspan="17">The Multimedia API module contains submodule APIs for easily integrating an application with audio, image, and video files. It can also be used for image editing.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/media/media_cover_n.htm">Media and Camera</a></li></ul></td>
- <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__MEDIA__AUDIO__IO__MODULE.html">Audio I/O</a></td>
- <td>Manages the system audio devices by granting access to the hardware layer of the sound card. This API must be used for tasks that require raw audio data buffers in PCM format.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__MEDIA__CAMERA__MODULE.html">Camera</a></td>
<tr>
<td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__MEDIADEMUXER__MODULE.html">Media Demuxer</a><p><strong>(since 3.0)</strong></p></td>
<td>Provides functions for demuxing media data.</td>
- </tr>
- <tr>
- <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__SYSTEM__MEDIA__KEY__MODULE.html">Media key</a></td>
- <td>Provides functions to handle media keys from external devices that are connected to the Tizen device, such as the volume control buttons on a headset.</td>
- </tr>
+ </tr>
<tr>
<td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__MEDIAMUXER__MODULE.html">Media Muxer</a><p><strong>(since 3.0)</strong></p></td>
<td>Provides functions for muxing media data.</td>
<tr>
<td rowspan="11"><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__NETWORK__FRAMEWORK.html">Network</a></td>
+ <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__NETWORK__BLUETOOTH__MODULE.html">Bluetooth</a></td>
+ <td>Manages Bluetooth devices. This involves launching the Bluetooth adapter and discovering, connecting, and bonding with other Bluetooth devices.</td>
<td rowspan="11">The Network API module contains submodule APIs, which can be used for data communication. It is responsible for managing connections, maintaining IP addresses, and connecting to the system through Bluetooth, Hypertext Transfer Protocol (HTTP), Near Field Communication (NFC), Sockets, and Wi-Fi. It also provides functions for retrieving information about a specific host from the Internet Domain Name System (DNS).
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/connectivity/connectivity_cover_n.htm">Connectivity and Wireless</a></li></ul>
</td>
- <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__NETWORK__BLUETOOTH__MODULE.html">Bluetooth</a></td>
- <td>Manages Bluetooth devices. This involves launching the Bluetooth adapter and discovering, connecting, and bonding with other Bluetooth devices. </td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__NETWORK__CONNECTION__MODULE.html">Connection</a></td>
</tr>
<tr>
<td rowspan="3"><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__SECURITY__FRAMEWORK.html">Security</a></td>
+ <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__KEY__MANAGER__MODULE.html">Key Manager</a></td>
+ <td>Provides functions to store keys, certificates, and sensitive data related to users and their password-protected applications in a secure repository. It also provides cryptographic operations to prevent key value names from being revealed to clients.</td>
<td rowspan="3">The Security API module contains submodule APIs which provide basic cryptographic functions, various utility functions through the OpenSSL open source library, and a secure password-protected repository for keys, certificates, and sensitive data.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/security/security_cover_n.htm">Security</a></li> </ul></td>
- <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__KEY__MANAGER__MODULE.html">Key Manager</a></td>
- <td>Provides functions to store keys, certificates, and sensitive data related to users and their password-protected applications in a secure repository. It also provides cryptographic operations to prevent key value names from being revealed to clients.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.wearable.apireference/group__OPENSRC__OPENSSL__FRAMEWORK.html">OpenSSL</a></td>
</tr>
<tr>
<td rowspan="1"><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__SOCIAL__FRAMEWORK.html">Social</a></td>
+ <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__SOCIAL__CONTACTS__SVC__MODULE.html">Contacts</a><p><strong>(since 3.0)</strong></p></td>
+ <td>Manages phone contact information, such as address books, persons, and phone logs.</td>
<td rowspan="1">The Social API module contains submodule APIs to manage personal data, such as contacts on a device.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/personal/personal_cover_n.htm">Personal Data</a></li></ul></td>
- <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__SOCIAL__CONTACTS__SVC__MODULE.html">Contacts</a><p><strong>(since 3.0)</strong></p></td>
- <td>Manages phone contact information, such as address books, persons, and phone logs.</td>
</tr>
<tr>
- <td rowspan="7"><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__SYSTEM__FRAMEWORK.html">System</a></td>
- <td rowspan="7">The System API module contains submodule APIs for system management.
+ <td rowspan="8"><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__SYSTEM__FRAMEWORK.html">System</a></td>
+ <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__SYSTEM__DEVICE__MODULE.html">Device</a></td>
+ <td>Controls devices and monitors their status. For example, this submodule API can be used to control and monitor the device battery, display, and LED.</td>
+ <td rowspan="8">The System API module contains submodule APIs for system management.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/data/data_cover_n.htm">Data Storage and Management</a></li>
<li><a href="../../../../org.tizen.guides/html/native/device/device_cover_n.htm">Device Settings and Systems</a></li>
<li><a href="../../../../org.tizen.guides/html/native/error/error_cover_n.htm">Error Handling</a></li>
- <li><a href="../../../../org.tizen.guides/html/native/location_sensors/location_sensors_cover_n.htm">Location and Sensors</a></li> </ul>
+ <li><a href="../../../../org.tizen.guides/html/native/location_sensors/location_sensors_cover_n.htm">Location and Sensors</a></li>
+ <li><a href="../../../../org.tizen.guides/html/native/media/media_cover_n.htm">Media and Camera</a></li></ul>
</td>
- <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__SYSTEM__DEVICE__MODULE.html">Device</a></td>
- <td>Controls devices and monitors their status. For example, this submodule API can be used to control and monitor the device battery, display, and LED.</td>
+ </tr>
+ <tr>
+ <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__SYSTEM__MEDIA__KEY__MODULE.html">Media key</a></td>
+ <td>Provides functions to handle media keys from external devices that are connected to the Tizen device, such as the volume control buttons on a headset.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__SYSTEM__RUNTIME__INFO__MODULE.html">Runtime information</a></td>
<tr>
<td rowspan="2"><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__TELEPHONY__FRAMEWORK.html">Telephony</a></td>
+ <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__TELEPHONY__INFORMATION.html">Telephony Information</a></td>
+ <td>Obtains call, network, and SIM information.</td>
<td rowspan="2">The Telephony API module contains a submodule API to enable an application to access the telephony capabilities of the device, such as the call facility (call information and status), the network query services, and the SIM module.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/connectivity/connectivity_cover_n.htm">Connectivity and Wireless</a></li>
<li><a href="../../../../org.tizen.guides/html/native/internationalization/internationalization_cover_n.htm">Internationalization</a></li></ul></td>
- <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__TELEPHONY__INFORMATION.html">Telephony Information</a></td>
- <td>Obtains call, network, and SIM information.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__TELEPHONY__PHONE__NUMBER__UTILS__MODULE.html">Phonenumber utils</a><p><strong>(since 3.0)</strong></p></td>
<td>Provides functions for parsing and formatting phone numbers.</td>
</tr>
<tr>
- <td rowspan="6"><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__UI__FRAMEWORK.html">UI Framework</a></td>
- <td rowspan="6">The UI Framework API module contains submodule APIs and open source libraries for 2D and 3D graphics and text.
+ <td rowspan="7"><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__UI__FRAMEWORK.html">UI Framework</a></td>
+ <td><a href="../../../../org.tizen.native.wearable.apireference/group__OPENSRC__CAIRO__FRAMEWORK.html">Cairo</a></td>
+ <td>Provides a library for 2D vector graphics drawing. Vector graphics are advantageous because they have small file sizes and can be scaled to any size without any loss of image quality. This module also includes Cairo EvasGL APIs which have been designed to support hardware-accelerated rendering.</td>
+ <td rowspan="7">The UI Framework API module contains submodule APIs and open source libraries for 2D and 3D graphics and text.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/graphics/graphics_cover_n.htm">Graphics</a></li>
<li><a href="../../../../org.tizen.guides/html/native/ui/ui_cover_n.htm">User Interface</a></li></ul></td>
- <td><a href="../../../../org.tizen.native.wearable.apireference/group__OPENSRC__CAIRO__FRAMEWORK.html">Cairo</a></td>
- <td>Provides a library for 2D vector graphics drawing. Vector graphics are advantageous because they have small file sizes and can be scaled to any size without any loss of image quality. This module also includes Cairo EvasGL APIs which have been designed to support hardware-accelerated rendering.</td>
- </tr>
+ </tr>
+ <tr>
+ <td><a href="../../../../org.tizen.native.wearable.apireference/group__dali.html">DALi</a></td>
+ <td>Provides a cross-platform 3D UI Toolkit for embedded systems.</td>
+ </tr>
<tr>
<td><a href="../../../../org.tizen.native.wearable.apireference/group__EFL__Group.html">EFL</a></td>
<td>Provides a collection of libraries that are independent and can be built on top of each other to provide useful features that complement the existing environment.</td>
<tr>
<td rowspan="2"><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__UIX__FRAMEWORK.html">UIX</a></td>
+ <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__UIX__STT__MODULE.html">STT</a></td>
+ <td>Provides functions to recognize speech.</td>
<td rowspan="2">The UIX API module contains submodule APIs for managing sound data.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/text_input/text_input_cover_n.htm">Text Input and Voice</a></li></ul></td>
- <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__UIX__STT__MODULE.html">STT</a></td>
- <td>Provides functions to recognize speech.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__UIX__TTS__MODULE.html">TTS</a></td>
<td>Provides functions for synthesizing voice from text and playing synthesized sound data.</td>
</tr>
<tr>
- <td rowspan="3"><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__WEB__FRAMEWORK.html">Web</a></td>
- <td rowspan="3">The Web API module contains submodule APIs for browsing the Internet, tracking browsing history, downloading Web content, and manipulating JavaScript Object Notation (JSON) documents.
+ <td rowspan="2"><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__WEB__FRAMEWORK.html">Web</a></td>
+ <td><a href="../../../../org.tizen.native.wearable.apireference/group__OPENSRC__JSONGLIB__FRAMEWORK.html">Json-Glib</a></td>
+ <td>Allows reading and parsing of JavaScript Object Notation (JSON) documents.</td>
+ <td rowspan="2">The Web API module contains submodule APIs for browsing the Internet, tracking browsing history, downloading Web content, and manipulating JavaScript Object Notation (JSON) documents.
<p>Guides:</p>
<ul>
<li><a href="../../../../org.tizen.guides/html/native/connectivity/connectivity_cover_n.htm">Connectivity and Wireless</a></li></ul></td>
- <td><a href="../../../../org.tizen.native.wearable.apireference/group__OPENSRC__JSONGLIB__FRAMEWORK.html">Json-Glib</a></td>
- <td>Allows reading and parsing of JavaScript Object Notation (JSON) documents.</td>
</tr>
<tr>
<td><a href="../../../../org.tizen.native.wearable.apireference/group__WEBVIEW.html">WebView</a></td>
<td>Displays and controls Web pages. This submodule API contains interfaces for browsing, tracking browsing history, and downloading Web content.</td>
- </tr>
- <tr>
- <td><a href="../../../../org.tizen.native.wearable.apireference/group__OPENSRC__LIB__OAUTH__FRAMEK.html">libOAuth</a></td>
- <td>Provides a library for using an open standard for secure authorization. This library enables users to securely log into an account on an application by using their logon credentials from another secondary account that they can have with another account provider or application. </td>
</tr>
</tbody>
</table>
<h2 id="privileges">Required Privileges</h2>
-<p>To use the location service, the application must declare the required privileges in the <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file. For more information on the Tizen privileges, see <a href="../../../../org.tizen.tutorials/html/native/details/sec_privileges_n.htm">Security and API Privileges</a>.</p>
+<p>To use the location service, the application must declare the required privileges in the <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file. For more information on the Tizen privileges, see <a href="../../../../org.tizen.training/html/native/details/sec_privileges_n.htm">Security and API Privileges</a>.</p>
<p>For this example, the application manifest must include the following privileges:</p>
<pre class="prettyprint">
</script>
</body>
-</html>
\ No newline at end of file
+</html>
/* Load a file to parse */
json_parser_load_from_file(parser, file_name, &error);
- dlog_print(DLOG_DEBUG, LOG_TAG, "parsing %s", file_name);
+ dlog_print(DLOG_DEBUG, LOG_TAG, "parsing %s", file_name);
if (error) {
dlog_print(DLOG_DEBUG, LOG_TAG, "parsing failed");
;
JsonObject *object;
object = json_node_get_object(root);
- json_object_foreach_member(object, object_member_cb, (gpointer) root_associated);
+ json_object_foreach_member(object, object_member_cb, (gpointer)root_associated);
break;
case JSON_NODE_ARRAY:
;
JsonArray *array;
array = json_node_get_array(root);
- json_array_foreach_element(array, array_element_cb, (gpointer) root_associated);
+ json_array_foreach_element(array, array_element_cb, (gpointer)root_associated);
break;
default:
;
<h2 id="efl_structure">EFL Structure on Tizen</h2>
<p>EFL is a collection of libraries that cover a range of functionality from managing the application life-cycle to rendering graphical objects. EFL libraries build on top of each other in layers, steadily becoming higher-level, yet allowing access to lower levels. The higher up you go, the less you have to do yourself. Elementary is at the top, but you still access the layers below it for common tasks, as there is no need for Elementary to wrap things that work perfectly well as-is.</p>
-<p>To learn more about each library, go to <a href="../../../../org.tizen.guides/html/native/ui/efl/efl_n.htm">Enlightenment Foundation Libraries (EFL)</a>. This section only briefly describes the hierarchical structure of your application on Tizen.</p>
+<p>To learn more about each library, go to <a href="../../../../org.tizen.guides/html/native/ui/efl/introduction_n.htm">Introduction</a>. This section only briefly describes the hierarchical structure of your application on Tizen.</p>
<p class="figure">Figure: EFL structure</p>
<p align="center"><img alt="EFL structure" src="../../images/ui_builder_efl_structure.png" /></p>
<li><p>Launch the Tizen Studio.</p></li>
<li>
-<p>Make sure the <strong>Tizen Native</strong> perspective is selected in the top right corner of the Tizen Studio window. </p>
+<p>Make sure the <strong>Native</strong> perspective is selected in the top right corner of the Tizen Studio window. </p>
<p align="center"><img alt="Checking the perspective" src="../../images/change_perspective_n.png" /></p>
-<p>If not, select it. If the perspective is not visible, in the Tizen Studio menu, select <strong>Window > Open Perspective > Other > Tizen Native</strong>, and click <strong>OK</strong>.</p>
+<p>If not, select it. If the perspective is not visible, in the Tizen Studio menu, select <strong>Window > Perspective > Open Perspective > Other > Native</strong>, and click <strong>OK</strong>.</p>
</li>
<li>
-<p>In the Tizen Studio menu, select <strong>File > New > Tizen Native Project</strong>.</p>
+<p>In the Tizen Studio menu, select <strong>File > New > Tizen Project</strong>.</p>
<p align="center"><img alt="Creating a new Tizen Native project" src="../../images/create_project_1_n.png" /></p>
<p>The Project Wizard opens.</p>
</li>
<p>In the Project Wizard, define the project details.</p>
<p>The Project Wizard is used to create the basic application skeleton with the required folder structure and mandatory files. You can easily create different applications by selecting an applicable template or sample for the Project Wizard to use.</p>
<ol type="a">
-<li><p>Select the <strong>Template</strong> tab and the <strong>MOBILE-[version] > Basic UI</strong> template. The version depends on the SDK version you have installed and with which you are developing the application.</p></li>
-<li><p>Change the project name, if you want.</p></li>
-<li><p>Leave all other fields in the Project Wizard to their default values, and click <strong>Finish</strong>.</p></li>
+<li><p>Select the <strong>Template</strong> project type and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the project type" src="../../images/create_project_wizard_type.png" /></p>
+</li>
+<li><p>Select the profile (<strong>Mobile</strong>) and version from a drop-down list and click <strong>Next</strong>.</p>
+<p>The version depends on the platform version you have installed and with which you are developing the application.</p>
+<p align="center"><img alt="Selecting the profile and version" src="../../images/create_project_wizard_version.png" /></p>
+</li>
+<li><p>Select the <strong>Native Application</strong> application type and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the application type" src="../../images/create_project_wizard_app.png" /></p>
+</li>
+<li><p>Select the <strong>Basic UI</strong> template and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the template" src="../../images/create_project_wizard_template.png" /></p>
+</li>
+<li><p>Define the project properties and click <strong>Finish</strong>.</p>
+<p>You can fill the project name (3-50 characters) and the unique package ID. You can also select the location and working sets by clicking <strong>More properties</strong>.</p>
+<p align="center"><img alt="Defining properties" src="../../images/create_project_wizard_properties.png" /></p>
+
+<p>The Project Wizard sets up the project, creates the application files using the default content from the template, and closes. For more information about the Project Wizard and the available templates, see <a href="../../../../org.tizen.studio/html/native_tools/project_wizard_n.htm">Creating Tizen Projects with Tizen Project Wizard</a>.</p></li>
</ol>
-<p align="center"><img alt="Defining the project details" src="../../images/create_project_2_mn.png" /></p>
-<p>The Project Wizard sets up the project, creates the application files using the default content from the template, and closes. For more information about the Project Wizard and the available templates, see <a href="../../../../org.tizen.studio/html/native_tools/project_wizard_n.htm">Creating Tizen Projects with Tizen Project Wizard</a>.</p>
</li>
</ol>
<li><p><strong>Localization</strong>: Define localized values for the application label, description, and icon.</p></li>
<li><p><strong>Advanced</strong>: Define advanced features, such as application metadata, data control for services, application control functionalities, and account details.</p></li>
<li>
-<p><strong>tizen-manifest.xml</strong>: View and edit the source code of the <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file. Changes made and saved on the other tabs are reflected in the source code and vice versa.</p>
+<p><strong>Source</strong>: View and edit the source code of the <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file. Changes made and saved on the other tabs are reflected in the source code and vice versa.</p>
<table class="note">
<tbody>
<tr>
<th class="note">Note</th>
</tr>
<tr>
- <td class="note">The <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file must conform to both the XML file format and the Tizen native application specification requirements. Editing the file in the source code view is intended for advanced users only.</td>
+ <td class="note">The <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file must conform to both the XML file format and the Tizen native application specification requirements. Editing the file in the <strong>Source</strong> tab is intended for advanced users only.</td>
</tr>
</tbody>
</table>
</ul>
</li>
-<li><p>To save any changes, in the Tizen Studio menu, select <strong>File > Save</strong>.</p></li>
+<li><p>To save any changes, in the Tizen Studio menu, select <strong>File > Save All</strong>.</p></li>
</ol>
<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and do one of the following:</p>
<ul><li>In the Tizen Studio menu, select <strong>Project > Build Project</strong>.</li>
<li>Press the <strong>F10</strong> key.</li>
-<li>Click the hammer icon (<img alt="Building the application from the toolbar" src="../../images/build_icon_mn.png" />) in the toolbar.
-</li>
</ul>
</li>
</ul>
<li>In the <strong>Connection Explorer</strong> view, launch the Emulator Manager by clicking the related icon.
<p align="center"><img src="../../images/emulator_icon.png" alt="Emulator manager icon" /></p>
</li>
-
-<li>In the Emulator Manager, open the <strong>Create New Emulator</strong> drop-down list and select <strong>mobile</strong>.
-<p align="center"><img src="../../images/emulator_new_mobile.png" alt="Emulator manager" /></p>
+<li>In the Emulator Manager, click <strong>Create</strong>.
+<p align="center"><img src="../../images/emulator_instance_create.png" alt="Creating an emulator instance" /></p>
</li>
-
-<li>Modify the emulator options, and click <strong>Confirm</strong>.
+<li>Select the applicable platform (in this case, <strong>mobile-2.4 (basic)</strong>), and click <strong>Next</strong>.
+<p align="center"><img src="../../images/emulator_instance_platform.png" alt="Selecting the platform" /></p>
+</li>
+<li>Select the device definition along with the platform version (in this case, <strong>HD Mobile</strong>), and click <strong>Next</strong>.
+<p align="center"><img src="../../images/emulator_instance_version.png" alt="Selecting the platform version" /></p>
+</li>
+<li>Define the emulator properties, and click <strong>Finish</strong>.
<p>You can leave the options to their default values.</p>
-<p align="center"><img src="../../images/emulator_settings_mobile.png" alt="Emulator options" /></p>
+<p align="center"><img src="../../images/emulator_instance_properties.png" alt="Defining the properties" /></p>
</li>
+<li>To launch the emulator instance, select the emulator from the list and click <strong>Launch</strong>.
+<p align="center"><img src="../../images/emulator_instance_launch.png" alt="Launching the emulator" /></p>
-<li>To launch the emulator instance, select the emulator from the list and click the play icon.
-<p align="center"><img src="../../images/emulator_launch_mobile.png" alt="Launch the emulator" /></p>
-
-<p>The emulator is launched in its own window.</p>
-<p>You can also see the new emulator instance in the <strong>Connection Explorer</strong> view. To view the emulator folder structure, click the arrow next to the emulator instance.</p>
+<p>The emulator is launched in its own window. You can also see the new emulator instance in the <strong>Connection Explorer</strong> view. To view the emulator folder structure, click the arrow next to the emulator instance.</p>
<p align="center"><img src="../../images/emulator_window_mobile.png" alt="Emulator" /></p>
</li>
</ol>
</li>
<li>Generate a security profile.
- <p>Before you run the application, you must sign your application package by <a href="https://developer.tizen.org/community/tip-tech/issuing-tizen-certificate-certificate-extension-ver-1.2#emulator" target="_blank">generating an author certificate and registering it</a> in the Tizen Studio.</p>
+ <p>Before you run the application, you must <a href="../../../../org.tizen.studio/html/common_tools/certificate_registration.htm">sign your application package with a certificate profile</a> in the Tizen Studio.</p>
</li>
<li>Run the application:
<ol type="a">
<li>In the <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Tizen Native Application</strong>.
-<p align="center"><img src="../../images/app_run_mn.png" alt="Run the application" /></p>
+<p align="center"><img src="../../images/app_run_mn.png" alt="Running the application" /></p>
<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and do one of the following:</p>
<ul><li>Press the <strong>Ctrl+F11</strong> key.</li>
-<li>Click the play icon (<img src="../../images/emulator_play.png" alt="Play icon" />) in the toolbar.</li></ul>
+<li>Click the run icon in the toolbar.</li></ul>
+
+<p>If you have created multiple emulator instances, select the instance you want from the combo box in the toolbar before selecting to run the application. If you select an offline emulator, it is automatically launched when you select to run the application.</p>
+
+<p align="center"><img src="../../images/app_run_multiple_emulators.png" alt="Selecting the emulator to use" /></p>
</li>
<li>Confirm that the application launches on the emulator.
<ol>
<li>Connect the mobile target device to your computer using a USB cable.</li>
<li>Generate an author certificate.
-<p>Before you run the application, you must sign your application package by <a href="https://developer.tizen.org/community/tip-tech/issuing-tizen-certificate-certificate-extension-ver-1.2#CommercialDevices" target="_blank">generating an author certificate and registering it</a> in the Tizen Studio.</p>
+<p>Before you run the application, you must <a href="../../../../org.tizen.studio/html/common_tools/certificate_registration.htm">sign your application package with a certificate profile</a> in the Tizen Studio.</p>
</li>
<li>Run the application:
<ol type="a">
<li>In the <strong>Connection Explorer</strong> view, select the device.</li>
<li>In <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Tizen Native Application</strong>.
-<p align="center"><img src="../../images/app_run_mn.png" alt="Run the application on a target device" /></p>
+<p align="center"><img src="../../images/app_run_mn.png" alt="Running the application on a target device" /></p>
<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and do one of the following:</p>
<ul><li>Press the <strong>Ctrl+F11</strong> key.</li>
-<li>Click the play icon (<img src="../../images/emulator_play.png" alt="Play icon" />) in the toolbar.</li></ul>
+<li>Click the run icon in the toolbar.</li></ul>
+
+<p>If you have both a connected device and existing emulator instances, select the device from the combo box in the toolbar before selecting to run the application.</p>
+
+<p align="center"><img src="../../images/app_run_multiple_emulators.png" alt="Selecting the device to use" /></p>
</li>
<li>Confirm that the application launches in the target device.</li>
<td class="note">The application is launched using the default debug run configuration. To create and use another configuration:
<ol>
<li>In the <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Run Configurations</strong>.</li>
- <li>In the <strong>Run Configurations</strong> window, click the <strong>New Launch Configuration</strong> icon (<img alt="New Launch Configuration" src="../../images/run_new_config_wn.png" />), define the configuration details, and launch the application by clicking <strong>Run</strong>.
- <p align="center"><img alt="Run Configurations" src="../../images/run_configurations_n.png" /></p></li>
+ <li>In the <strong>Run Configurations</strong> window, click the <strong>New Launch Configuration</strong> icon (<img alt="New Launch Configuration icon" src="../../images/run_new_config_wn.png" />), define the configuration details, and launch the application by clicking <strong>Run</strong>.
+ <p align="center"><img alt="Run Configurations window" src="../../images/run_configurations_n.png" /></p></li>
</ol></td>
</tr>
</tbody>
<h2 id="creating" name="creating">Creating the Application Project</h2>
-<p>After you have planned and designed your application, you are ready to <a href="creating_app_project_n.htm">create the application project</a> in the Tizen Studio.</p>
-
<p>The Tizen Studio provides various project templates that make it easier for you to start coding your application. When you create a new project, you can select a specific template or sample. Based on the selection, the Tizen native <a href="../../../../org.tizen.studio/html/native_tools/project_wizard_n.htm">Project Wizard</a> automatically creates basic functionalities that the application has to implement to be able to run. The default project files and folders are also created.</p>
<h2 id="setting" name="setting">Setting Project Properties</h2>
<p>Tizen supports multi-project applications that combine different types of application templates.</p>
- <p>You can develop a UI project and service or shared library projects as a package.</p>
+ <p>You can develop a UI project with service or widget projects as a package.</p>
<p>To develop a multi-project native application:</p>
<ol>
<li><a href="#creating">Create a UI application</a>.</li>
- <li>Create a service application.</li>
+ <li>Create a service or widget application.</li>
<li>Package a multi-project application using Tizen Studio:
<ol type="a">
<li>In the Tizen Studio, make sure all the applications you want to include in the package are located in the <strong>Project Explorer</strong> view. <p>To make the projects appear in the <strong>Project Explorer</strong> view, you can create new applications, or import existing projects or sample applications into the Tizen Studio.</p> </li>
- <li><p>To establish a project reference between UI application and service application:</p>
+ <li><p>To establish a project reference between a UI application and a service or widget application:</p>
<ul>
<li>In the <strong>Project Explorer</strong> view, right-click the UI application.</li>
<li>Select <strong> Properties > Tizen Studio > Package > Multi</strong>.</li>
<li>Select the check box for the service or widget application, and click <strong>OK</strong>.
- <p>In the <strong>Project Explorer</strong> view, a message (with the UI application) appears next to the referenced project name for all the applications you have added to the package.</p> </li>
+ <p>In the <strong>Project Explorer</strong> view, a message (with the UI application) appears next to the referenced project name for all the applications you have added to the package.</p> </li>
</ul> </li>
</ol>
<p>After packaging the multi-project application, the package consists of the application binary, resource, and data files of the root and referenced applications. Their <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> files are merged into one. <a href="../app_model/application_model_n.htm#packageID">The application ID in the <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> must be assigned with the package ID as a prefix.</a></p>
</li>
- <li><a href="building_app_n.htm">Build</a> and <a href="running_app_n.htm">run</a> the UI application. <p>The service application is built and run automatically while the UI application is built and run.</p> </li>
+ <li><a href="building_app_n.htm">Build</a> and <a href="running_app_n.htm">run</a> the UI application. <p>The service or widget application is built and run automatically while the UI application is built and run.</p></li>
</ol>
<table class="note">
<h1>Creating the Application Project</h1>
-<p>You can create a native application project by selecting from a variety of templates and samples. The following instructions are specific for creating the project with a template.</p>
-
-<p>To create a native application project:</p>
-<ol>
-<li>In the Tizen Studio, select <strong>File > New > Tizen Native Project</strong>.
-<p>If the project option you want is not visible, make sure that you are using the correct perspective (Tizen native). To switch perspectives, go to <strong>Window > Open Perspective > Other</strong> and select the perspective you need.</p>
+ <p>You can create a native application project by selecting from a variety of templates and samples. The following instructions are specific for creating the project with a template.</p>
+ <p>To create a native application project:</p>
+ <ol>
+ <li>In the Tizen Studio, select <strong>File > New > Tizen Project</strong>.
+ <p align="center"><img alt="Creating a new project" src="../../images/create_project_1_n.png" /></p>
+ <p>The Project Wizard opens.</p></li>
+ <li>In the Project Wizard, define the project details.
+ <p>The Project Wizard is used to create the basic application skeleton with the required folder structure and mandatory files. You can easily create different applications by selecting an applicable template or sample for the Project Wizard to use.</p>
+ <ol type="a">
+ <li><p>Select the <strong>Template</strong> project type and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the project type" src="../../images/create_project_wizard_type.png" /></p>
+</li>
+<li><p>Select the profile (<strong>Mobile</strong> or <strong>Wearable</strong>) and version from a drop-down list and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the profile and version" src="../../images/create_project_wizard_version_wearable.png" /></p>
</li>
-<li>In the <strong>New Tizen Native Project</strong> window, define the project details:
-<ol type="a">
-<li>Select the project type.</li>
-<li>Define the name of your project.
-<p>The default location for your application project is defined.</p>
+<li><p>Select the <strong>Native Application</strong> application type and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the application type" src="../../images/create_project_wizard_app_wearable.png" /></p>
+</li>
+<li><p>Select the template you want to use and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the template" src="../../images/create_project_wizard_template_wn.png" /></p>
+</li>
+<li><p>Define the project properties and click <strong>Finish</strong>.</p>
+<p>You can fill the project name. You can also select the location and working sets by clicking <strong>More properties</strong>.</p>
<table class="note">
<tbody>
<tr>
</tr>
</tbody>
</table>
-</li>
-</ol>
-</li>
-<li>Click <strong>Finish</strong>.</li>
-</ol>
-
-<p>The new application project is shown in the <strong>Project Explorer</strong> view of the Tizen Studio, with default content in the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file as well as in several project folders.</p>
-
-<p class="figure">Figure: Creating a Tizen mobile native project</p>
-<p align="center"><img src="../../images/hello_world_n.png" alt="Creating a Tizen mobile native project" /></p>
-
-<h2 id="import">Importing a Project</h2>
+<p align="center"><img alt="Defining properties" src="../../images/create_project_wizard_properties_wn.png" /></p>
+<p>The Project Wizard sets up the project, creates the application files using the default content from the template, and closes. For more information about the Project Wizard and the available templates, see <a href="../../../../org.tizen.studio/html/native_tools/project_wizard_n.htm">Creating Tizen Projects with Tizen Project Wizard</a>.</p></li>
+ </ol> </li></ol>
+ <p>The new application project is shown in the <strong>Project Explorer</strong> view of the Tizen Studio, with default content in the <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file as well as in several project folders.</p>
+
+ <h2 id="import" name="import">Importing a Project</h2>
<p>If you have an existing Tizen application project, you can import it into the Tizen Studio:</p>
<ol>
<li>Select <strong>File > Import > Tizen > Tizen Project</strong>, and click <strong>Next</strong>.</li>
- <li>Click <strong>Browse</strong> and select the root directory, which contains your existing project, or native application package file.</li>
- <li>Select a profile and version from the <strong>Platform</strong> drop-down lists.</li>
+ <li>Click <strong>Browse</strong> and select the root directory, which contains your existing project, or native application package file (with the <span style="font-family: Courier New,Courier,monospace">.tpk</span> extension).</li>
+ <li>With the <strong>Platform</strong> drop-down lists, select the platform profile and version.</li>
<li>Click <strong>Finish</strong>.</li>
- </ol>
-
-
-
+ </ol>
<script type="text/javascript" src="../../scripts/jquery.zclip.min.js"></script>
<script type="text/javascript" src="../../scripts/showhide.js"></script>
<li>In the Tizen Studio menu, go to <strong>Debug > Debug As > Tizen native Application</strong>.</li>
<li>On the Tizen Studio toolbar, click <strong>Debug</strong>.</li>
</ul> <p>If the application binary does not exist, it is built automatically for the Emulator.</p> <p>If many active Emulator instances are connected, select the Emulator to run the application from the dialog box.</p></li>
- <li><p>The debug messages are displayed in the Tizen Studio
's <strong>Console</strong> view. To see the GDB console, in the <strong>Console</strong> view, click the <strong>Display Selected Console</strong> button and select the option containing <strong>gdb</strong>. With the GDB console, you can also execute GDB commands.</p> <p>To display verbose GDB output in the GDB console:</p>
+ <li><p>The debug messages are displayed in the Tizen Studio <strong>Console</strong> view. To see the GDB console, in the <strong>Console</strong> view, click the <strong>Display Selected Console</strong> button and select the option containing <strong>gdb</strong>. With the GDB console, you can also execute GDB commands.</p> <p>To display verbose GDB output in the GDB console:</p>
<ul>
<li>Right-click the <strong>Project Explorer</strong> view and select <strong>Debug As > Debug Configurations</strong>.</li>
<li>On the <strong>Remote</strong> tab, select the <strong>Show verbose messages in console</strong> check box.</li>
</ul> </li>
<li><p>Use the application in the Emulator as you would in a target device.</p>
- <p>While the application is running, the Tizen Studio
's <a href="../../../../org.tizen.studio/html/common_tools/log_view.htm">Log view</a> shows the log, debug, and exception messages from the methods defined in the log macros.</p> </li>
+ <p>While the application is running, the Tizen Studio <a href="../../../../org.tizen.studio/html/common_tools/log_view.htm">Log view</a> shows the log, debug, and exception messages from the methods defined in the log macros.</p> </li>
<li><p>To stop debugging, do one of the following:</p>
<ul>
</li>
</ul>
-<p>The performance details of your application retrieved during tracing are stored in the trace files. You can manage the trace files through the toolbar and menu.</p>
-<p>For usage details, see <a href="../../../../org.tizen.studio/html/common_tools/da_common.htm" >Handling Common Dynamic Analyzer Tasks</a> and <a href="../../../../org.tizen.studio/html/common_tools/da_advanced.htm">Handling Advanced Dynamic Analyzer Tasks</a>.</p>
+<p>The performance details of your application retrieved during tracing are stored in trace files. You can manage the trace files through the Dynamic Analyzer toolbar. For usage details, see <a href="../../../../org.tizen.studio/html/common_tools/da_common.htm" >Handling Common Dynamic Analyzer Tasks</a> and <a href="../../../../org.tizen.studio/html/common_tools/da_advanced.htm">Handling Advanced Dynamic Analyzer Tasks</a>.</p>
<h4>Using the Command Line Interface to Access Dynamic Analyzer Features</h4>
<p>The Dynamic Analyzer provides access to its features through the Command Line Interface (CLI) tool. This possibility can be useful, for example, in the following cases:</p>
<p>To detect and fix the methods consuming the most time:</p>
<ul>
<li>Select the <strong>View > Report > Function Profiling</strong> in the menu to show the Function Profiling table displaying the methods consuming the most time. Click the title of a column to view the sorted results.</li>
- <li>To view the execution time of the methods called within a specific time period, use the <a href="../../../../org.tizen.studio/html/common_tools/da_advanced.htm#range">range information feature</a> of the Dynamic Analyzer.</li>
+ <li>To view the execution time of the methods called within a specific time period, use the <a href="../../../../org.tizen.studio/html/common_tools/da_advanced.htm#range">range inspection feature</a> of the Dynamic Analyzer.</li>
</ul>
<p class="figure">Figure: Function Profiling table</p>
<p align="center"><img alt="Function Profiling table" src="../../images/optimizingappper_funprof.png" /></p>
</li>
<li>Timeline CPU chart
<p>When analyzing application performance, the CPU load is one of the most significant factors. A CPU load peak can result in a performance bottleneck. High CPU load leads to increased memory consumption, which shortens the battery life of the device running the application. To avoid this, you need to optimize your code.</p>
- <p>To detect and fix CPU load peak with the CPU load feature of the Dynamic Analyzer:</p>
+
+ <p>To detect and fix CPU load peaks with the CPU load feature of the Dynamic Analyzer:</p>
<ol>
<li>Select the <strong>Timeline</strong> tab and view the CPU chart.</li>
<li>Hover the mouse on a CPU peak to view the CPU load value in a tooltip.</li>
</ul> <p>If the application binary does not exist, it is built automatically for the Emulator.</p>
<p>If many active Emulator instances are connected, select the Emulator to run the application from the dialog box.</p></li>
<li><p>Use the application in the Emulator as you would in a target device.</p>
- <p>While the application is running, the <strong>Log</strong> view in the Tizen Studio shows the log, debug, and exception messages from the methods defined in the log macros.</p></li>
+ <p>While the application is running, the Tizen Studio <strong>Log</strong> view shows the log, debug, and exception messages from the methods defined in the log macros.</p></li>
<li><p>To terminate the run, exit the application on the Emulator.</p></li>
</ol>
<p>In the Emulator settings, you can change the display language settings, keyboard language settings, proxy address, and location settings. In addition, you can use the Event Injector view to generate application events (such as sensor data, incoming calls, or location data) for debugging and testing purposes.</p>
<div id="toc_border"><div id="toc">
<p class="toc-title">Content</p>
<ul class="toc">
- <li><a href="#api">Checking API Usage</a></li>
- <li><a href="#chapi">Checking API Privileges</a></li>
+ <li><a href="#api">Checking API and Privilege Usage</a></li>
<li><a href="#manifest">Setting the Application Manifest</a></li>
</ul>
<p class="toc-title">Related Info</p>
<ul class="toc">
- <li><a href="../details/app_filtering_n.htm">Feature Filtering</a></li>
+ <li><a href="../details/app_filtering_n.htm#filter_n">Feature-based Filtering</a></li>
<li><a href="../details/sec_privileges_n.htm">Security and API Privileges</a></li>
+ <li><a href="../../../../org.tizen.studio/html/native_tools/manifest_text_editor_n.htm">Configuring the Application Manifest</a></li>
</ul>
</div></div>
</div>
<div id="container"><div id="contents"><div class="content">
<h1>Setting Project Properties</h1>
- <p>Before you implement the actual application functionality, define all the necessary properties for your application project. To set the application project properties, right-click the project in the Tizen Studio <strong>Project Explorer</strong> view and select <strong>Properties</strong>. After setting or changing a property, click <strong>Apply</strong>.</p>
-
-<p>The settings that you can define in the application project properties include:</p>
- <ul>
-<li><a href="#api">API usage check</a></li>
-<li><a href="#chapi">API privilege check</a></li>
- </ul>
+ <p>Before you implement the actual application functionality, define all the necessary properties for your application project:</p>
-<p>You can define the <a href="#manifest">application manifest settings</a> in the <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file.</p>
+ <ul>
+ <li>To set the <a href="#api">application project properties for API and privilege checks</a>, right-click the project in the Tizen Studio <strong>Project Explorer</strong> view and select <strong>Properties</strong>. After setting or changing a property, click <strong>OK</strong>.</li>
+<li>To define the <a href="#manifest">application manifest settings</a>, edit the <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file.
<table class="note"><tbody>
<tr>
<td class="note">Only modify the manifest file by using the manifest editor in the Tizen Studio. If you create or edit the <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file using any other text editor, your application may not work as expected.</td>
</tr>
</tbody></table>
+</li></ul>
<p>After you have finished setting the project properties, you are ready to <a href="app_dev_process_n.htm#designing">design the UI and implement the application code</a>.</p>
- <h2 id="api" name="api">Checking API Usage</h2>
- <p>You can <a href="../../../../org.tizen.studio/html/native_tools/api_checker_n.htm">check the source code in your project for any violation of API usage</a>. To enable the API check:</p>
+ <h2 id="api" name="api">Checking API and Privilege Usage</h2>
+ <p>You can <a href="../../../../org.tizen.studio/html/native_tools/api_checker_n.htm">check the source code in your project for any violation of API and privilege usage</a>. To enable the non-default checks (the default checks are always performed):</p>
<ol>
-<li><p>In the <strong>Properties</strong> window, select <strong>C/C++ Build > Tizen Settings > API and Privilege Checker</strong>.</p></li>
+<li><p>In the <strong>Properties</strong> window, select <strong>C/C++ Build > Tizen Settings > API and Privilege Checker Properties</strong>.</p></li>
<li>
-<p>Select the required API problems in the <strong>API Check</strong> panel.</p> </li>
+<p>Select the required checks in the <strong>Privilege Check</strong> panel.</p> </li>
</ol>
-<p>To perform API usage checks automatically, select the required option in the <strong>Launching</strong> panel: </p>
+<p>To perform the usage checks automatically during specific tasks, select the required option in the <strong>Launching</strong> panel: </p>
<ul>
<li>During the <a href="app_dev_process_n.htm#build">build process</a>, select the <strong>Run API and privilege checks with build</strong> option.</li>
<li>During code editing, select the <strong>Run API and privilege checks while editing</strong> option.</li>
</ul>
-<p>You can also perform the API usage checks manually after building the application by selecting <strong>Project > Check API and Privilege Violations With Build</strong>. The results are displayed in the <strong>Problems</strong> view.</p>
+<p>You can also perform the usage checks manually after building the application, by right-clicking the project in the <strong>Project Explorer</strong> view and selecting <strong>Check API and Privilege Violations With Build</strong>. The results are displayed in the <strong>Problems</strong> view.</p>
<table class="note"><tbody>
<tr>
<th class="note">Note</th>
<td class="note">If the application has conflicting API versions, the build fails and the results are displayed in the <strong>Problems</strong> view.</td>
</tr>
</tbody></table>
-<h2 id="chapi" name="chapi">Checking API Privileges</h2>
- <p>You can <a href="../../../../org.tizen.studio/html/native_tools/api_checker_n.htm">check the source code in your project for any violation of privileges</a>. To enable the privilege check:</p>
- <ol>
-<li>In the <strong>Properties</strong> window, select <strong>C/C++ Build > Tizen Settings > API and Privilege Checker</strong>.</li>
- <li>
-<p>Select the required privilege problems in the <strong>Privilege Check</strong> panel.</p> </li>
- </ol>
-<p>To perform privilege checks automatically, select the required option in the <strong>Launching</strong> panel:</p>
- <ul>
-<li>During the <a href="app_dev_process_n.htm#build">build process</a>, select the <strong>Run API and privilege checks with build</strong> option.</li>
- <li>During code editing, select the <strong>Run API and privilege checks while editing</strong> option.</li>
- </ul>
-<p>You can also perform privilege checks manually after building the application by selecting <strong>Project > Check API and Privilege Violations With Build</strong>. The results are displayed in the <strong>Problems</strong> view.</p>
<h2 id="manifest" name="manifest">Setting the Application Manifest</h2>
- <p>The application manifest consists of application information, such as package, version, features, and privileges, which are available for the application. To configure the application information in the manifest editor, double-click the <span style="font-family: Courier New, Courier, monospace">tizen-manifest.xml</span> file present in the project folder of the application.</p>
+ <p>The application manifest consists of application information, such as package, version, features, and privileges, which are available for the application. To configure the application information in the manifest editor, double-click the application <span style="font-family: Courier New, Courier, monospace">tizen-manifest.xml</span> file in the <strong>Project Explorer</strong> view.</p>
<p class="figure">Figure: Setting the application manifest</p>
<p align="center"><img alt="Setting the application manifest" src="../../images/tizen_project_explorer.png"/></p>
- <p>You can edit application properties using the tabs of the manifest editor.</p>
+ <p>You can <a href="../../../../org.tizen.studio/html/native_tools/manifest_text_editor_n.htm#editing">edit the application properties using the form tabs of the manifest editor</a>.</p>
<h3 id="overview" name="overview">Defining and Editing General Information in the Overview Tab</h3>
- <p>You can set and edit general and project-related information about the application, such as application package, version, author, description, in the <strong>Overview</strong> tab of the manifest editor. Additionally, you can specify the application icon.</p>
+ <p>You can set and edit general and project-related information about the application, such as application package, version, author, and description, in the <strong>Overview</strong> tab of the manifest editor.</p>
<p>You can perform the following tasks using the <strong>Overview</strong> tab:</p>
<ul>
-<li>Set the package name of the application. <p>The package name represents the package identifier of the application</p></li>
+ <li>View the application ID. <p>The Tizen Studio creates automatically an application ID, which uniquely identifies the application within the package.</p></li>
+ <li>Set the package name of the application. <p>The package name represents the package identifier of the application</p></li>
<li>Set the application version (x.y.z). <p>The application version format has the following constraints: 0 ≤ {x, y} ≤ 255, 0 ≤ z ≤ 65535. You can change the application version in the <strong>Version</strong> field.</p> </li>
- <li>Set the application label. <p>The application label represents the label of the application.</p> </li>
- <li>Set the API version. <p>The API version format is "x.y.z".</p> </li>
- <li>Add application icon. <p>You can add a launcher icon to your application by defining it in the <strong>Icon</strong> panel. If your application supports both HD and WVGA, it is best to provide an icon for HD for better image quality in both cases.</p>
+ <li>Set the API version. <p>The API version format is "x.y.z".</p> </li>
+ <li>Set the application label. <p>The application label represents the name of the application.</p> </li>
+ <li>View the application executable file path.</li>
+ <li>Add an application icon. <p>You can add a launcher icon to your application by defining it in the <strong>Icon</strong> panel. If your application supports both HD and WVGA, it is best to provide an icon for HD for better image quality in both cases.</p>
<p>The following table describes the available icons.</p>
<table border="1">
<caption>
<col width="10%"/>
<col width="5%"/>
<col width="20%"/>
-<col width="17%"/>
-<col width="17%"/>
-<col width="30%"/>
-</colgroup>
+<col width="10%"/>
+<col width="10%"/>
+<col width="35%"/>
+</colgroup>
<tbody>
<tr>
-<th rowspan="2" style="text-align:center;margin-left:auto;margin-right:auto;">Icon</th>
- <th rowspan="2" style="text-align:center;margin-left:auto;margin-right:auto;">Mandatory</th>
- <th rowspan="2" style="text-align:center;margin-left:auto;margin-right:auto;">Format</th>
- <th colspan="2" style="text-align:center;margin-left:auto;margin-right:auto;">Size</th>
- <th rowspan="2" style="text-align:center;margin-left:auto;margin-right:auto;">Description</th>
+ <th rowspan="2">Profile</th>
+ <th rowspan="2">Mandatory</th>
+ <th rowspan="2">Format</th>
+ <th colspan="2">Size</th>
+ <th rowspan="2">Description</th>
</tr>
-<tr>
-<th style="text-align:center;margin-left:auto;margin-right:auto;">Xhigh (HD)</th>
- <th style="text-align:center;margin-left:auto;margin-right:auto;">High (WVGA)</th>
+<tr>
+<th>Xhigh (HD)</th>
+ <th>High (WVGA)</th>
</tr>
<tr>
-<td>MainMenu</td>
+<td>Mobile</td>
<td>Yes</td>
<td>32-bit PNG with alpha</td>
<td>117 x 117 pixels</td>
<td>78 x 78 pixels</td>
<td>Image displayed in the main menu.</td>
</tr>
+<tr>
+<td>Wearable</td>
+ <td>Yes</td>
+ <td>32-bit PNG with alpha</td>
+ <td colspan="2">152 x 152 pixels</td>
+ <td>Image displayed in the main menu.</td>
+ </tr>
</tbody>
</table>
+
</li>
<li>Set the application author.
<p>The application author represents the creator of the Tizen native application package. You can set the name, email ID, and Web site of the author.</p>
</li>
<li>Set the application description.
- <p>The application description represents the human-readable descriptions of the Tizen native application package.</p>
+ <p>The application description represents the human-readable description of the Tizen native application package.</p>
</li>
</ul>
<h3 id="features" name="features">Declaring Required Software or Hardware Features in the Features Tab</h3>
- <p>You can declare required software or hardware features. This declaration can be used for <a href="../details/app_filtering_n.htm">application filtering in the Tizen Store</a>.</p>
+ <p>You can declare any device software or hardware features that your application requires to run properly. The declaration can be used for application filtering in the Tizen Store.</p>
<p>To enable filtering for your native application:</p>
<ol>
-<li>In the <strong>Features</strong> tab of the manifest editor, click <strong>Add</strong>.</li>
+<li>In the <strong>Features</strong> tab, click <strong>+</strong>.</li>
<li>Select a feature from the <a href="../details/app_filtering_n.htm">predefined list of features available for filtering</a>.
<p>To check which features are necessary for using a specific API, see the related feature in the native <a href="../../../../org.tizen.native.mobile.apireference/index.html">API Reference</a>.</p> </li>
-<li>Click <strong>Save</strong>.</li>
+<li>Click <strong>OK</strong>.</li>
<li>Upload and publish the application package on the Tizen Store.
<p>If a Tizen-powered device requests applications, the store displays a list containing only applications compatible with the user's device.</p>
</li>
</ol>
-<p>After setting the feature information with the manifest editor, you can see the added code in the <strong>tizen-manifest.xml</strong> tab.</p>
-<p>The following example shows the setting in the <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file code:</p>
+<p>After setting the feature information with the manifest editor, you can see the added code in the <strong>Source</strong> tab:</p>
<pre class="prettyprint">
<feature name="http://tizen.org/feature/network.nfc">true</feature>
</pre>
-<h3 id="privileges" name="privileges">Specifying Privileges in the Privilege Tab</h3>
+<h3 id="privileges" name="privileges">Specifying Privileges in the Privileges Tab</h3>
- <p>You can <a href="../details/sec_privileges_n.htm">use features and services provided by privileged APIs</a>, which handle platform and user-sensitive data. You can specify a privilege in the <strong>Privilege</strong> tab of the manifest editor.</p>
+ <p>You can use features and services provided by privileged APIs, which handle platform and user-sensitive data. You can specify a privilege in the <strong>Privileges</strong> tab of the manifest editor.</p>
<p>To add a privilege:</p>
<ol>
- <li>In the <strong>Privilege</strong> tab of the manifest editor, click <strong>Add</strong>.</li>
- <li>In the <strong>Add privilege</strong> window, select a privilege from the <a href="../details/sec_privileges_n.htm">predefined list of available API privileges</a>.
- <p>You can select multiple privileges by holding the <strong>CTRL</strong> key.</p>
- </li>
+ <li>In the <strong>Privileges</strong> tab, click <strong>+</strong>.</li>
+ <li>Select a privilege from the <a href="../details/sec_privileges_n.htm">predefined list of available API privileges</a>.</li>
<li>Click <strong>OK</strong>.</li>
</ol>
- <p>After setting the privilege information with the manifest editor, you can see the added code in the <strong>tizen-manifest.xml</strong> tab.</p>
-<p>The following example shows the setting in the <span style="font-family: Courier New, Courier, monospace">tizen-manifest.xml</span> file code:</p>
+ <p>After setting the privilege information with the manifest editor, you can see the added code in the <strong>Source</strong> tab:</p>
<pre class="prettyprint">
<privileges>
<privilege>http://tizen.org/privilege/appmanager.launch</privilege>
</pre>
-<h3 id="localization" name="localization">Setting the Supported Locales in the Localization Tab</h3>
+<h3 id="localization" name="localization">Adding Localized Application Details in the Localization Tab</h3>
- <p>You can set the supported locales for selected node elements of the <span style="font-family: Courier New, Courier, monospace">tizen-manifest.xml</span> file. You can provide localization support for the application label and description in the <strong>Localization</strong> tab of the manifest editor.</p>
+ <p>You can provide localized versions of the application name (label) and description in the <strong>Localization</strong> tab of the manifest editor.</p>
- <p>To add localization:</p>
- <ol>
-<li>In the <strong>Localization</strong> tab, click <strong>Add</strong> next to <strong>Label</strong>. Select the language, define the label text for that language, and click <strong>OK</strong>.
+ <p>To add a localized name or description:</p>
+ <ul>
+<li>In the <strong>Name</strong> panel, click <strong>+</strong>. Select the language, define the application name for that language, and click <strong>OK</strong>.
<p>The following example shows the setting in the <span style="font-family: Courier New, Courier, monospace">tizen-manifest.xml</span> file code:</p>
<pre class="prettyprint">
<label xml:lang="en-us">This is a sample</label>
</pre>
</li>
- <li>In the <strong>Localization</strong> tab, click <strong>Add</strong> next to <strong>Description</strong>. Select the language, define the description text for that language, and click <strong>OK</strong>.
+ <li>In the <strong>Description</strong> panel, click <strong>+</strong>. Select the language, define the application description text for that language, and click <strong>OK</strong>.
<p>The following example shows the setting in the <span style="font-family: Courier New, Courier, monospace">tizen-manifest.xml</span> file code:</p>
<pre class="prettyprint">
<description xml:lang="en-us">This is a sample</description>
</pre>
</li>
-</ol>
+</ul>
+
+<p>You can localize a native application to adapt to various languages and cultural environments by creating different native application versions for different languages. For more information see <a href="../../../../org.tizen.studio/html/native_tools/po_file_editor_n.htm">Localizing Application Resources</a>.</p>
<h3 id="advanced" name="advanced">Defining Advanced Features in the Advanced Tab</h3>
- <p>You can define advanced features of the application, such as metadata and data and application control functionalities, account, and miscellaneous options, in the <strong>Advanced</strong> tab of the manifest editor.</p>
+ <p>You can define advanced application features, such as metadata and data and application control functionalities, account, and miscellaneous options, in the <strong>Advanced</strong> tab of the manifest editor.</p>
<p>You can perform the following tasks using the <strong>Advanced</strong> tab:</p>
<ul>
- <li>Add metadata. <p>You can add user-defined key-value pairs to the application to be used for filtering in the package manager.</p> </li>
+ <li>Add metadata. <p>In the <strong>Meta Data</strong> section, you can add user-defined key-value pairs to the application to be used for filtering in the package manager.</p> </li>
+ <li>Export <a href="../../../../org.tizen.guides/html/native/app_management/data_control_n.htm">data control</a> functionality.
+ <p>A service application can act as a service provider and allow other applications to access specific data.</p>
+ <p>To define the kind of access and data your service application provides to other applications, click <strong>+</strong> in the <strong>Data Control</strong> section, and define the data control details.</p> </li>
<li>Set miscellaneous options.
- <p>You can set as true or false various application options:</p>
+ <p>In the <strong>Miscellaneous Options</strong> section, you can set various application options:</p>
<ul>
- <li>Set multiple <p>This attribute indicates whether the application can be launched as multiple.</p></li>
- <li>Set taskmanage <p>This attribute indicates whether the application is shown in the task manager.</p></li>
- <li>Set nodisplay for UI application<p>This attribute indicates whether the application is shown in the app-tray. For service applications, nodisplay is always true.</p></li>
- <li>Set auto-restart <p>This attribute indicates whether the application is relaunched automatically when it is terminated abnormally.</p></li>
- <li>Set on-boot <p>This attribute indicates whether the application is launched automatically on device booting time or application installation time.</p></li>
- </ul>
-
- <table class="note">
- <tbody>
- <tr>
- <th class="note">Note</th>
- </tr>
- <tr>
- <td class="note">The auto-restart and on-boot attributes are not supported in Tizen wearable devices. Since Tizen 2.4, both attributes are not supported in all Tizen devices. Because of this, if they are used in a lower API version package than 2.4, they are ignored in the devices with the Tizen platform version 2.4 and higher.</td>
- </tr>
- </tbody>
- </table>
+ <li><strong>Manage task</strong>
+ <p>Define whether the application is shown in the task manager.</p></li>
+ <li><strong>No display</strong>
+ <p>In UI applications, define whether the application is hidden in the device application tray. In service applications, this settings is always <strong>true</strong>.</p></li>
+ <li><strong>Hardware acceleration</strong>
+ <p>Define whether hardware acceleration is enabled for the application.</p></li>
+ <li><strong>Launch Mode</strong>
+ <p>Define the launch mode of the application (whether the application is launched as a main or sub application, or whether a caller application defines the launch mode when the application is launched by an application control request).</p></li>
+ </ul>
</li>
-<li>Define application control.
-<p>You can <a href="../../../../org.tizen.guides/html/native/app_management/app_controls_n.htm#export_appcontrol">export the application control functionality</a> of your application. To define an application control used to access the functionality of your application, click <strong>Add</strong> in the <strong>Application Control</strong> section of the <strong>Advanced</strong> tab of the manifest editor.</p>
-<p>Each application control can have multiple operation, mime type, and uri attributes.</p> </li>
- <li>Add an account (in mobile applications only).
- <p>Account providers, such as Google and Facebook, represent specific service provider-related information or protocol that provides the user accounts. To add, update, or remove accounts, you must register a specific account provider in your application.</p>
- <p>To register an account provider, define the account provider information by clicking <strong>Add</strong> in the <strong>Account</strong> section of the <strong>Advanced</strong> tab of the manifest editor, as described in the following table.</p>
+<li>Define application controls.
+<p>You can <a href="../../../../org.tizen.guides/html/native/app_management/app_controls_n.htm#export_appcontrol">export the application control functionality</a> of your application.</p>
+<p>To define an application control used to access the functionality of your application, click <strong>+</strong> in the <strong>Application Control</strong> section.</p>
+<p>Each application control can have multiple operation, MIME type, and URI attributes.</p> </li>
+
+ <li>Add accounts (in mobile applications only).
+ <p>Account providers, such as Google and Facebook, represent specific service provider-related information or protocol that provides user accounts. To add, update, or remove accounts, you must register a specific account provider in your application.</p>
+ <p>To register an account provider, click <strong>+</strong> in the <strong>Account</strong> section and define the account provider information, as described in the following table.</p>
<table border="1">
<caption>
Table: Account provider properties
</caption>
<tbody>
<tr>
-<th>Account property</th>
+<th colspan="2">Account property</th>
<th>Data type</th>
<th>Property type</th>
</tr>
<tr>
-<td>Multiple accounts support</td>
+<td colspan="2">Multiple account</td>
<td>
<span style="font-family: Courier New,Courier,monospace">bool</span> </td>
<td>
</td>
</tr>
<tr>
-<td>Provider ID</td>
+<td colspan="2">Provider ID</td>
<td>
<span style="font-family: Courier New,Courier,monospace">String</span> </td>
<td>
</td>
</tr>
<tr>
-<td>Display label</td>
+<td colspan="2">Default label</td>
<td>
<span style="font-family: Courier New,Courier,monospace">String</span> </td>
<td>
</td>
</tr>
<tr>
+<td rowspan="2">Icons</td>
<td>Icon</td>
<td>
<span style="font-family: Courier New,Courier,monospace">String</span> </td>
</td>
</tr>
<tr>
-<td>Small icon</td>
+<td>Icon small</td>
<td>
<span style="font-family: Courier New,Courier,monospace">String</span> </td>
<td>
</tr>
<tr>
-<td>Labels</td>
+<td colspan="2">Name</td>
<td>
<span style="font-family: Courier New,Courier,monospace">String</span> </td>
<td>
<p>Localization support for the display name.</p>
+<p>To add a localized name, click <strong>+</strong> in the <strong>Name</strong> panel, select the language, define the display name for that language, and click <strong>OK</strong>.</p>
</td>
</tr>
<tr>
-<td>Capabilities</td>
+<td colspan="2">Capabilities</td>
<td><span style="font-family: Courier New,Courier,monospace">String</span></td>
<td> <p>Capability of the account provider.</p>
<p>Capabilities are defined in the <span style="font-family: Courier New,Courier,monospace">http://<VENDOR_INFORMATION>/accounts/capability/<NAME></span> IRI format.</p> <p>The following predefined capabilities can be used in Tizen:</p>
</li>
</ul>
+<p>To add a capability, click <strong>+</strong> in the <strong>Capabilities</strong> panel. A default capability is added to the table. Click the default capability and change it to the one you need.</p>
<p>This is an optional property.</p>
</td>
</tr>
</tbody>
</table>
</li>
- <li>Export DataControl functionality. <p>You can <a href="../../../../org.tizen.guides/html/native/app_management/data_control_n.htm#export">export data functionalities</a> of your Tizen native application.</p> <p>To define a data control used to export application data, click <strong>Add</strong> and define the data control details.</p> </li>
- <li>Add the background category type (since Tizen 2.4). <p>You can <a href="../../../../org.tizen.guides/html/native/app_management/ui_app_n.htm#bg-category">describe the background category</a> of your Tizen native application.</p> <p>To add background category types to allow running on the background, click <strong>Add</strong> and select the category type.</p> </li>
+
+ <li>Add the background category type (since Tizen 2.4). <p>You can <a href="../../../../org.tizen.guides/html/native/app_management/ui_app_n.htm#bg-category">describe the background category</a> of your Tizen native application.</p> <p>To add background category types to allow running on the background, click <strong>+</strong> in the <strong>Background Category</strong> panel, select the category type, and click <strong>OK</strong>.</p> </li>
+
+ <li>Add shortcuts. <p>To add a shortcut for the application, click <strong>+</strong> in the <strong>Shortcut List</strong> panel, define the shortcut details, and click <strong>OK</strong>.</p> </li>
</ul>
-<h3 id="source" name="source">Editing the tizen-manifest.xml File in the tizen-manifest.xml Tab</h3>
+<h3 id="source" name="source">Editing the tizen-manifest.xml File in the Source Tab</h3>
- <p>The <strong>
tizen-manifest.xml</strong> tab of the manifest editor shows the code of the <span style="font-family: Courier New, Courier, monospace">tizen-manifest.xml</span> file. You can <a href="../../../../org.tizen.studio/html/native_tools/manifest_text_editor_n.htm">edit the basic syntax of the XML document</a> and also see how changes made on the other tabs are reflected in the raw XML source content.</p>
+ <p>The <strong>
Source</strong> tab of the manifest editor shows the code of the <span style="font-family: Courier New, Courier, monospace">tizen-manifest.xml</span> file. You can <a href="../../../../org.tizen.studio/html/native_tools/manifest_text_editor_n.htm">edit the basic syntax of the XML document</a> and also see how changes made on the other tabs are reflected in the raw XML source content.</p>
<table class="note">
<tbody>
<tr>
<p>When you are developing a more complex application, you can take advantage of the <a href="../../../../org.tizen.studio/html/native_tools/cover_native_n.htm">native tools included in the Tizen Studio</a> to ease the tasks of creating functionality and designing the application UI.</p>
-<p><strong>Updating 2.3.1 Wearable Packages</strong></p>
-
-<p>To develop wearable applications in the latest Tizen SDK, you must install the 2.3.1 wearable packages separately:</p>
-
-<ol>
-<li>Launch the Update Manager by going to <strong>Start > All Programs > Tizen SDK-<version> > Update Manager-<version></strong>.</li>
-<li>In the <strong>All Packages</strong> tab, download all packages for <strong>2.3.1 Wearable</strong>.
-<p align="center"><img alt="Download packages" src="../../images/first_app_download_wn.png" /></p></li>
-</ol>
-
<h2 id="create">Creating a Project</h2>
<p>The following example shows you how to create and configure a basic wearable native application project in the Tizen Studio. An application project contains all the files that make up an application.</p>
<li><p>Launch the Tizen Studio.</p></li>
<li>
-<p>Make sure the <strong>Tizen Native</strong> perspective is selected in the top right corner of the Tizen Studio window. </p>
+<p>Make sure the <strong>Native</strong> perspective is selected in the top right corner of the Tizen Studio window. </p>
<p align="center"><img alt="Checking the perspective" src="../../images/change_perspective_n.png" /></p>
-<p>If not, select it. If the perspective is not visible, in the Tizen Studio menu, select <strong>Window > Open Perspective > Other > Tizen Native</strong>, and click <strong>OK</strong>.</p>
+<p>If not, select it. If the perspective is not visible, in the Tizen Studio menu, select <strong>Window > Perspective > Open Perspective > Other > Native</strong>, and click <strong>OK</strong>.</p>
</li>
<li>
-<p>In the Tizen Studio menu, select <strong>File > New > Tizen Native Project</strong>.</p>
+<p>In the Tizen Studio menu, select <strong>File > New > Tizen Project</strong>.</p>
<p align="center"><img alt="Creating a new Tizen Native project" src="../../images/create_project_1_n.png" /></p>
<p>The Project Wizard opens.</p>
</li>
<p>In the Project Wizard, define the project details.</p>
<p>The Project Wizard is used to create the basic application skeleton with the required folder structure and mandatory files. You can easily create different applications by selecting an applicable template or sample for the Project Wizard to use.</p>
<ol type="a">
-<li><p>Select the <strong>Template</strong> tab and the <strong>WEARABLE-[version] > Basic UI</strong> template. The version depends on the SDK version you have installed and with which you are developing the application.</p></li>
-<li><p>Change the project name, if you want.</p></li>
-<li><p>Leave all other fields in the Project Wizard to their default values, and click <strong>Finish</strong>.</p></li>
+<li><p>Select the <strong>Template</strong> project type and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the project type" src="../../images/create_project_wizard_type.png" /></p>
+</li>
+<li><p>Select the profile (<strong>Wearable</strong>) and version from a drop-down list and click <strong>Next</strong>.</p>
+<p>The version depends on the platform version you have installed and with which you are developing the application.</p>
+<p align="center"><img alt="Selecting the profile and version" src="../../images/create_project_wizard_version_wearable.png" /></p>
+</li>
+<li><p>Select the <strong>Native Application</strong> application type and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the application type" src="../../images/create_project_wizard_app_wearable.png" /></p>
+</li>
+<li><p>Select the <strong>Basic UI</strong> template and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the template" src="../../images/create_project_wizard_template_wn.png" /></p>
+</li>
+<li><p>Define the project properties and click <strong>Finish</strong>.</p>
+<p>You can fill the project name (3-50 characters) and the unique package ID. You can also select the location and working sets by clicking <strong>More properties</strong>.</p>
+<p align="center"><img alt="Defining properties" src="../../images/create_project_wizard_properties_wn.png" /></p>
+
+<p>The Project Wizard sets up the project, creates the application files using the default content from the template, and closes. For more information about the Project Wizard and the available templates, see <a href="../../../../org.tizen.studio/html/native_tools/project_wizard_n.htm">Creating Tizen Projects with Tizen Project Wizard</a>.</p></li>
</ol>
-<p align="center"><img alt="Defining the project details" src="../../images/create_project_2_wn.png" /></p>
-<p>The Project Wizard sets up the project, creates the application files using the default content from the template, and closes. For more information about the Project Wizard and the available templates, see <a href="../../../../org.tizen.studio/html/native_tools/project_wizard_n.htm">Creating Tizen Projects with Tizen Project Wizard</a>.</p>
</li>
</ol>
<li><p><strong>Localization</strong>: Define localized values for the application label, description, and icon.</p></li>
<li><p><strong>Advanced</strong>: Define advanced features, such as application metadata, data control for services, application control functionalities, and account details.</p></li>
<li>
-<p><strong>tizen-manifest.xml</strong>: View and edit the source code of the <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file. Changes made and saved on the other tabs are reflected in the source code and vice versa.</p>
+<p><strong>Source</strong>: View and edit the source code of the <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file. Changes made and saved on the other tabs are reflected in the source code and vice versa.</p>
<table class="note">
<tbody>
<tr>
<th class="note">Note</th>
</tr>
<tr>
- <td class="note">The <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file must conform to both the XML file format and the Tizen native application specification requirements. Editing the file in the source code view is intended for advanced users only.</td>
+ <td class="note">The <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file must conform to both the XML file format and the Tizen native application specification requirements. Editing the file in the <strong>Source</strong> tab is intended for advanced users only.</td>
</tr>
</tbody>
</table>
</ul>
</li>
-<li><p>To save any changes, in the Tizen Studio menu, select <strong>File > Save</strong>.</p></li>
+<li><p>To save any changes, in the Tizen Studio menu, select <strong>File > Save All</strong>.</p></li>
</ol>
<ol>
<li>Select the project in the <strong>Project Explorer</strong> view.</li>
<li>In the Tizen Studio menu, select <strong>Project > Build Automatically</strong>.
-<p align="center"><img alt="Using the automatic build" src="../../images/build_automatic_n.png" /></p>
+<p align="center"><img alt="Using the automatic build" src="../../images/build_automatic_wn.png" /></p>
<p>A check mark appears next to the menu option.</p></li>
</ol>
<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and do one of the following:</p>
<ul><li>In the Tizen Studio menu, select <strong>Project > Build Project</strong>.</li>
<li>Press the <strong>F10</strong> key.</li>
-<li>Click the hammer icon (<img alt="Building the application from the toolbar" src="../../images/build_icon_mn.png" />) in the toolbar.
-</li>
</ul>
</li>
</ul>
<li>In the <strong>Connection Explorer</strong> view, launch the Emulator Manager by clicking the related icon.
<p align="center"><img src="../../images/emulator_icon.png" alt="Emulator manager icon" /></p>
</li>
-
-<li>In the Emulator Manager, open the <strong>Create New Emulator</strong> drop-down list and select <strong>wearable</strong>.
-<p align="center"><img src="../../images/emulator_new_wearable.png" alt="Emulator manager" /></p>
+<li>In the Emulator Manager, click <strong>Create</strong>.
+<p align="center"><img src="../../images/emulator_instance_create.png" alt="Creating an emulator instance" /></p>
</li>
-
-<li>Modify the emulator options, and click <strong>Confirm</strong>.
+<li>Select the applicable platform (in this case, <strong>wearable-2.3.2-circle (basic)</strong>), and click <strong>Next</strong>.
+<p align="center"><img src="../../images/emulator_instance_platform_wearable.png" alt="Selecting the platform" /></p>
+</li>
+<li>Select the device definition along with the platform version (in this case, <strong>Wearable Circle</strong>), and click <strong>Next</strong>.
+<p align="center"><img src="../../images/emulator_instance_version_wearable.png" alt="Selecting the platform version" /></p>
+</li>
+<li>Define the emulator properties, and click <strong>Finish</strong>.
<p>You can leave the options to their default values.</p>
-<p align="center"><img src="../../images/emulator_settings_wearable.png" alt="Emulator options" /></p>
+<p align="center"><img src="../../images/emulator_instance_properties_wearable.png" alt="Defining the properties" /></p>
</li>
-<li>To launch the emulator instance, select the emulator from the list and click the play icon.
-<p align="center"><img src="../../images/emulator_launch_wearable.png" alt="Launch the emulator" /></p>
+<li>To launch the emulator instance, select the emulator from the list and click <strong>Launch</strong>.
+<p align="center"><img src="../../images/emulator_instance_launch_wearable.png" alt="Launching the emulator" /></p>
-<p>The emulator is launched in its own window.</p>
-<p>You can also see the new emulator instance in the <strong>Connection Explorer</strong> view. To view the emulator folder structure, click the arrow next to the emulator instance.</p>
+<p>The emulator is launched in its own window. You can also see the new emulator instance in the <strong>Connection Explorer</strong> view. To view the emulator folder structure, click the arrow next to the emulator instance.</p>
<p align="center"><img src="../../images/emulator_window_wearable.png" alt="Emulator" /></p>
</li>
</ol>
</li>
<li>Generate a security profile.
- <p>Before you run the application, you must sign your application package by <a href="https://developer.tizen.org/community/tip-tech/issuing-tizen-certificate-certificate-extension-ver-1.2#emulator" target="_blank">generating an author certificate and registering it</a> in the Tizen Studio.</p>
+ <p>Before you run the application, you must <a href="../../../../org.tizen.studio/html/common_tools/certificate_registration.htm">sign your application package with a certificate profile</a> in the Tizen Studio.</p>
</li>
<li>Run the application:
<ol type="a">
<li>In the <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Tizen Native Application</strong>.
-<p align="center"><img src="../../images/app_run_wn.png" alt="Run the application" /></p>
+<p align="center"><img src="../../images/app_run_wn.png" alt="Running the application" /></p>
<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and do one of the following:</p>
<ul><li>Press the <strong>Ctrl+F11</strong> key.</li>
-<li>Click the play icon (<img src="../../images/emulator_play.png" alt="Play icon" />) in the toolbar.</li></ul>
+<li>Click the run icon in the toolbar.</li></ul>
+<p>If you have created multiple emulator instances, select the instance you want from the combo box in the toolbar before selecting to run the application. If you select an offline emulator, it is automatically launched when you select to run the application.</p>
+
+<p align="center"><img src="../../images/app_run_multiple_emulators.png" alt="Selecting the emulator to use" /></p>
</li>
<li>Confirm that the application launches on the emulator.
</li>
</ol>
-<p>For more information on using the emulator features, see <a href="../../../../org.tizen.studio/html/common_tools/emulator_control_panel.htm">
Emulator Control Keys and Menu</a> and <a href="../../../../org.tizen.studio/html/common_tools/emulator_features.htm">Using Extended Emulator Features</a>.</p>
+<p>For more information on using the emulator features, see <a href="../../../../org.tizen.studio/html/common_tools/emulator_control_panel.htm">
Using Emulator Control Keys, Menu, and Panel</a> and <a href="../../../../org.tizen.studio/html/common_tools/emulator_features.htm">Using Extended Emulator Features</a>.</p>
<li>In the <strong>Connection Explorer</strong> view, launch the Remote Device Manager by clicking the related icon.
<p align="center"><img src="../../images/remote_conn_mgr_ww.png" alt="Launch the Remote Device Manager" /></p>
</li>
-<li>In the <strong>Remote Device Manager</strong> window, click <strong>New</strong>.
+<li>In the <strong>Remote Device Manager</strong> window, click <strong>+</strong>.
<p align="center"><img src="../../images/remote_conn_new_ww.png" alt="Add new device" /></p>
</li>
<li>In the <strong>Add Device</strong> window, enter the device and network details (use the IP address you noted before), and click <strong>Add</strong>.
</ol>
</li>
<li>Generate an author certificate.
-<p>Before you run the application, you must sign your application package by <a href="https://developer.tizen.org/community/tip-tech/issuing-tizen-certificate-certificate-extension-ver-1.2#CommercialDevices" target="_blank">generating an author certificate and registering it</a> in the Tizen Studio.</p>
+<p>Before you run the application, you must <a href="../../../../org.tizen.studio/html/common_tools/certificate_registration.htm">sign your application package with a certificate profile</a> in the Tizen Studio.</p>
</li>
<li>Run the application:
<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and do one of the following:</p>
<ul><li>Press the <strong>Ctrl+F11</strong> key.</li>
-<li>Click the play icon (<img src="../../images/emulator_play.png" alt="Play icon" />) in the toolbar.</li></ul>
+<li>Click the run icon in the toolbar.</li></ul>
+
+<p>If you have both a connected device and existing emulator instances, select the device from the combo box in the toolbar before selecting to run the application.</p>
+
+<p align="center"><img src="../../images/app_run_multiple_emulators.png" alt="Selecting the device to use" /></p>
</li>
<li>Confirm that the application launches in the target device.</li>
<td class="note">The application is launched using the default debug run configuration. To create and use another configuration:
<ol>
<li>In the <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Run Configurations</strong>.</li>
- <li>In the <strong>Run Configurations</strong> window, click the <strong>New Launch Configuration</strong> icon (<img alt="New Launch Configuration" src="../../images/run_new_config_wn.png" />), define the configuration details, and launch the application by clicking <strong>Run</strong>.
- <p align="center"><img alt="Run Configurations" src="../../images/run_configurations_n.png" /></p></li>
+ <li>In the <strong>Run Configurations</strong> window, click the <strong>New Launch Configuration</strong> icon (<img alt="New Launch Configuration icon" src="../../images/run_new_config_wn.png" />), define the configuration details, and launch the application by clicking <strong>Run</strong>.
+ <p align="center"><img alt="Run Configurations window" src="../../images/run_configurations_n.png" /></p></li>
</ol></td>
</tr>
</tbody>
<p>When you are developing a more complex application, you can take advantage of the <a href="../../../../org.tizen.studio/html/native_tools/cover_native_n.htm">native tools included in the Tizen Studio</a> to ease the tasks of creating functionality and designing the application UI.</p>
-<p><strong>Updating 2.3.1 Wearable Packages</strong></p>
-
-<p>To develop wearable applications in the latest Tizen SDK, you must install the 2.3.1 wearable packages separately:</p>
-
-<ol>
-<li>Launch the Update Manager by going to <strong>Start > All Programs > Tizen SDK-<version> > Update Manager-<version></strong>.</li>
-<li>In the <strong>All Packages</strong> tab, download all packages for <strong>2.3.1 Wearable</strong>.
-<p align="center"><img alt="Download packages" src="../../images/first_app_download_wn.png" /></p></li>
-</ol>
-
<h2 id="project">Creating a Project</h2>
<p>The following example shows you how to create and configure a basic wearable native watch application project in the Tizen Studio. An application project contains all the files that make up an application.</p>
<li><p>Launch the Tizen Studio.</p></li>
<li>
-<p>Make sure the <strong>Tizen Native</strong> perspective is selected in the top right corner of the Tizen Studio window. </p>
+<p>Make sure the <strong>Native</strong> perspective is selected in the top right corner of the Tizen Studio window. </p>
<p align="center"><img alt="Checking the perspective" src="../../images/change_perspective_n.png" /></p>
-<p>If not, select it. If the perspective is not visible, in the Tizen Studio menu, select <strong>Window > Open Perspective > Other > Tizen Native</strong>, and click <strong>OK</strong>.</p>
+<p>If not, select it. If the perspective is not visible, in the Tizen Studio menu, select <strong>Window > Perspective > Open Perspective > Other > Native</strong>, and click <strong>OK</strong>.</p>
</li>
<li>
-<p>In the Tizen Studio menu, select <strong>File > New > Tizen Native Project</strong>.</p>
+<p>In the Tizen Studio menu, select <strong>File > New > Tizen Project</strong>.</p>
<p align="center"><img alt="Creating a new Tizen Native project" src="../../images/create_project_1_n.png" /></p>
<p>The Project Wizard opens.</p>
</li>
<p>In the Project Wizard, define the project details.</p>
<p>The Project Wizard is used to create the basic application skeleton with the required folder structure and mandatory files. You can easily create different applications by selecting an applicable template or sample for the Project Wizard to use.</p>
<ol type="a">
-<li><p>Select the <strong>Template</strong> tab and the <strong>WEARABLE-[version] > Watch</strong> template. The version depends on the SDK version you have installed and with which you are developing the application.</p></li>
-<li><p>Change the project name, if you want.</p></li>
-<li><p>Leave all other fields in the Project Wizard to their default values, and click <strong>Finish</strong>.</p></li>
+<li><p>Select the <strong>Template</strong> project type and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the project type" src="../../images/create_project_wizard_type.png" /></p>
+</li>
+<li><p>Select the profile (<strong>Wearable</strong>) and version from a drop-down list and click <strong>Next</strong>.</p>
+<p>The version depends on the platform version you have installed and with which you are developing the application.</p>
+<p align="center"><img alt="Selecting the profile and version" src="../../images/create_project_wizard_version_wearable.png" /></p>
+</li>
+<li><p>Select the <strong>Native Application</strong> application type and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the application type" src="../../images/create_project_wizard_app_wearable.png" /></p>
+</li>
+<li><p>Select the <strong>Watch</strong> template and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the template" src="../../images/create_project_wizard_template_wn_watch.png" /></p>
+</li>
+<li><p>Define the project properties and click <strong>Finish</strong>.</p>
+<p>You can fill the project name (3-50 characters) and the unique package ID. You can also select the location and working sets by clicking <strong>More properties</strong>.</p>
+<p align="center"><img alt="Defining properties" src="../../images/create_project_wizard_properties_wn_watch.png" /></p>
+
+<p>The Project Wizard sets up the project, creates the application files using the default content from the template, and closes. For more information about the Project Wizard and the available templates, see <a href="../../../../org.tizen.studio/html/native_tools/project_wizard_n.htm">Creating Tizen Projects with Tizen Project Wizard</a>.</p></li>
</ol>
-<p align="center"><img alt="Defining the project details" src="../../images/create_project_2_wn_watch.png" /></p>
-<p>The Project Wizard sets up the project, creates the application files using the default content from the template, and closes. For more information about the Project Wizard and the available templates, see <a href="../../../../org.tizen.studio/html/native_tools/project_wizard_n.htm">Creating Tizen Projects with Tizen Project Wizard</a>.</p>
</li>
</ol>
<li><p><strong>Localization</strong>: Define localized values for the application label, description, and icon.</p></li>
<li><p><strong>Advanced</strong>: Define advanced features, such as application metadata and some miscellaneous options.</p></li>
<li>
-<p><strong>tizen-manifest.xml</strong>: View and edit the source code of the <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file. Changes made and saved on the other tabs are reflected in the source code and vice versa.</p>
+<p><strong>Source</strong>: View and edit the source code of the <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file. Changes made and saved on the other tabs are reflected in the source code and vice versa.</p>
<table class="note">
<tbody>
<tr>
<th class="note">Note</th>
</tr>
<tr>
- <td class="note">The <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file must conform to both the XML file format and the Tizen native application specification requirements. Editing the file in the source code view is intended for advanced users only.</td>
+ <td class="note">The <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file must conform to both the XML file format and the Tizen native application specification requirements. Editing the file in the <strong>Source</strong> tab is intended for advanced users only.</td>
</tr>
</tbody>
</table>
</ul>
</li>
-<li><p>To save any changes, in the Tizen Studio menu, select <strong>File > Save</strong>.</p></li>
+<li><p>To save any changes, in the Tizen Studio menu, select <strong>File > Save All</strong>.</p></li>
</ol>
<ol>
<li>Select the project in the <strong>Project Explorer</strong> view.</li>
<li>In the Tizen Studio menu, select <strong>Project > Build Automatically</strong>.
-<p align="center"><img alt="Using the automatic build" src="../../images/build_automatic_n.png" /></p>
+<p align="center"><img alt="Using the automatic build" src="../../images/build_automatic_wn_watch.png" /></p>
<p>A check mark appears next to the menu option.</p></li>
</ol>
<p>To manually build the application, right-click the project in the <strong>Project Explorer</strong> view and select <strong>Build Project</strong>.</p>
<p class="figure">Figure: Manually building the application</p>
-<p align="center"><img alt="Manually building the application" src="../../images/build_manual_watch_wn.png" /></p>
+<p align="center"><img alt="Manually building the application" src="../../images/build_manual_wn_watch.png" /></p>
<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and do one of the following:</p>
<ul><li>In the Tizen Studio menu, select <strong>Project > Build Project</strong>.</li>
<li>Press the <strong>F10</strong> key.</li>
-<li>Click the hammer icon (<img alt="Building the application from the toolbar" src="../../images/build_icon_mn.png" />) in the toolbar.
-</li>
</ul>
</li>
</ul>
<li>In the <strong>Connection Explorer</strong> view, launch the Emulator Manager by clicking the related icon.
<p align="center"><img src="../../images/emulator_icon.png" alt="Emulator manager icon" /></p>
</li>
-
-<li>In the Emulator Manager, open the <strong>Create New Emulator</strong> drop-down list and select <strong>wearable</strong>.
-<p align="center"><img src="../../images/emulator_new_wearable.png" alt="Emulator manager" /></p>
+<li>In the Emulator Manager, click <strong>Create</strong>.
+<p align="center"><img src="../../images/emulator_instance_create.png" alt="Creating an emulator instance" /></p>
</li>
-
-<li>Modify the emulator options, and click <strong>Confirm</strong>.
+<li>Select the applicable platform (in this case, <strong>wearable-2.3.2-circle (basic)</strong>), and click <strong>Next</strong>.
+<p align="center"><img src="../../images/emulator_instance_platform_wearable.png" alt="Selecting the platform" /></p>
+</li>
+<li>Select the device definition along with the platform version (in this case, <strong>Wearable Circle</strong>), and click <strong>Next</strong>.
+<p align="center"><img src="../../images/emulator_instance_version_wearable.png" alt="Selecting the platform version" /></p>
+</li>
+<li>Define the emulator properties, and click <strong>Finish</strong>.
<p>You can leave the options to their default values.</p>
-<p align="center"><img src="../../images/emulator_settings_wearable.png" alt="Emulator options" /></p>
+<p align="center"><img src="../../images/emulator_instance_properties_wearable.png" alt="Defining the properties" /></p>
</li>
-<li>To launch the emulator instance, select the emulator from the list and click the play icon.
-<p align="center"><img src="../../images/emulator_launch_wearable.png" alt="Launch the emulator" /></p>
+<li>To launch the emulator instance, select the emulator from the list and click <strong>Launch</strong>.
+<p align="center"><img src="../../images/emulator_instance_launch_wearable.png" alt="Launching the emulator" /></p>
-<p>The emulator is launched in its own window.</p>
-<p>You can also see the new emulator instance in the <strong>Connection Explorer</strong> view. To view the emulator folder structure, click the arrow next to the emulator instance.</p>
+<p>The emulator is launched in its own window. You can also see the new emulator instance in the <strong>Connection Explorer</strong> view. To view the emulator folder structure, click the arrow next to the emulator instance.</p>
<p align="center"><img src="../../images/emulator_window_wearable.png" alt="Emulator" /></p>
</li>
</ol>
</li>
<li>Generate a security profile.
- <p>Before you run the application, you must sign your application package by <a href="https://developer.tizen.org/community/tip-tech/issuing-tizen-certificate-certificate-extension-ver-1.2#emulator" target="_blank">generating an author certificate and registering it</a> in the Tizen Studio.</p>
+ <p>Before you run the application, you must <a href="../../../../org.tizen.studio/html/common_tools/certificate_registration.htm">sign your application package with a certificate profile</a> in the Tizen Studio.</p>
</li>
<li>Run the application:
<ol type="a">
<li>In the <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Tizen Native Application</strong>.
-<p align="center"><img src="../../images/app_run_wn_watch.png" alt="Run the application" /></p>
+<p align="center"><img src="../../images/app_run_wn_watch.png" alt="Running the application" /></p>
<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and do one of the following:</p>
<ul><li>Press the <strong>Ctrl+F11</strong> key.</li>
-<li>Click the play icon (<img src="../../images/emulator_play.png" alt="Play icon" />) in the toolbar.</li></ul>
-
+<li>Click the run icon in the toolbar.</li></ul>
+<p>If you have created multiple emulator instances, select the instance you want from the combo box in the toolbar before selecting to run the application. If you select an offline emulator, it is automatically launched when you select to run the application.</p>
+<p align="center"><img src="../../images/app_run_multiple_emulators.png" alt="Selecting the emulator to use" /></p>
<p>In the <strong>Console</strong> view, you can see that the application is successfully installed. However, it does not run on the emulator screen until you change the watch face in the emulator <strong>Settings</strong> menu.</p>
<p align="center"><img alt="Successful installation" src="../../images/watch_run_install_wn.png" /></p>
</li>
</ol>
</li></ol>
-<p>For more information on using the emulator features, see <a href="../../../../org.tizen.studio/html/common_tools/emulator_control_panel.htm">
Emulator Control Keys and Menu</a> and <a href="../../../../org.tizen.studio/html/common_tools/emulator_features.htm">Using Extended Emulator Features</a>.</p>
+<p>For more information on using the emulator features, see <a href="../../../../org.tizen.studio/html/common_tools/emulator_control_panel.htm">
Using Emulator Control Keys, Menu, and Panel</a> and <a href="../../../../org.tizen.studio/html/common_tools/emulator_features.htm">Using Extended Emulator Features</a>.</p>
<h3 id="target">Running on a Target Device</h3>
</li>
<li>Generate an author certificate.
-<p>Before you run the application, you must sign your application package by <a href="https://developer.tizen.org/community/tip-tech/issuing-tizen-certificate-certificate-extension-ver-1.2#CommercialDevices" target="_blank">generating an author certificate and registering it</a> in the Tizen Studio.</p>
+<p>Before you run the application, you must <a href="../../../../org.tizen.studio/html/common_tools/certificate_registration.htm">sign your application package with a certificate profile</a> in the Tizen Studio.</p>
</li>
<li>Run the application:
<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and do one of the following:</p>
<ul><li>Press the <strong>Ctrl+F11</strong> key.</li>
-<li>Click the play icon (<img src="../../images/emulator_play.png" alt="Play icon" />) in the toolbar.</li></ul>
+<li>Click the run icon in the toolbar.</li></ul>
+
+<p>If you have both a connected device and existing emulator instances, select the device from the combo box in the toolbar before selecting to run the application.</p>
+
+<p align="center"><img src="../../images/app_run_multiple_emulators.png" alt="Selecting the device to use" /></p>
</li>
<li>Confirm that the application launches in the target device.
<td class="note">The application is launched using the default debug run configuration. To create and use another configuration:
<ol>
<li>In the <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Run Configurations</strong>.</li>
- <li>In the <strong>Run Configurations</strong> window, click the <strong>New Launch Configuration</strong> icon (<img alt="New Launch Configuration" src="../../images/run_new_config_wn.png" />), define the configuration details, and launch the application by clicking <strong>Run</strong>.
- <p align="center"><img alt="Run Configurations" src="../../images/run_configurations_n_watch.png" /></p></li>
+ <li>In the <strong>Run Configurations</strong> window, click the <strong>New Launch Configuration</strong> icon (<img alt="New Launch Configuration icon" src="../../images/run_new_config_wn.png" />), define the configuration details, and launch the application by clicking <strong>Run</strong>.
+ <p align="center"><img alt="Run Configurations window" src="../../images/run_configurations_wn_watch.png" /></p></li>
</ol></td>
</tr>
</tbody>
<h3 id="ambient" name="ambient">Using the Ambient Mode</h3>
<p>In a low-powered wearable device, an ambient mode is available. In this mode, the watch application shows a limited UI and receives only the ambient tick event every minute to reduce power consumption.</p>
-<p>The details of the limited UI drawn in the ambient mode depend on the device. Usually, when designing the ambient mode UI, draw a black and white UI only, and use less than 20% of the pixels on the screen. If you do not want to draw your own ambient mode UI, set the <span style="font-family: Courier New,Courier,monospace">ambient-support</span> attribute to <span style="font-family: Courier New,Courier,monospace">false</span> in the watch application manifest file to allow the platform to show a default ambient mode UI.</p>
+<p>The details of the limited UI drawn in the ambient mode depend on the device. In addition, due to the ambient mode being a low power mode, there are limits to the colors that can be shown on the screen. Usually, when designing the ambient mode UI, draw a black and white UI only, and use less than 15% of the pixels on the screen. If you do not want to draw your own ambient mode UI, set the <span style="font-family: Courier New,Courier,monospace">ambient-support</span> attribute to <span style="font-family: Courier New,Courier,monospace">false</span> in the watch application manifest file to allow the platform to show a default ambient mode UI.</p>
<table class="note">
<p>When you are developing a more complex application, you can take advantage of the <a href="../../../../org.tizen.studio/html/native_tools/cover_native_n.htm">native tools included in the Tizen Studio</a> to ease the tasks of creating functionality and designing the application UI.</p>
-<p><strong>Updating 2.3.1 Wearable Packages</strong></p>
-
-<p>To develop wearable applications in the latest Tizen SDK, you must install the 2.3.1 wearable packages separately:</p>
-
-<ol>
-<li>Launch the Update Manager by going to <strong>Start > All Programs > Tizen SDK-<version> > Update Manager-<version></strong>.</li>
-<li>In the <strong>All Packages</strong> tab, download all packages for <strong>2.3.1 Wearable</strong>.
-<p align="center"><img alt="Download packages" src="../../images/first_app_download_wn.png" /></p></li>
-</ol>
-
<h2 id="create">Creating a Project</h2>
<p>The following example shows you how to create and configure a basic wearable native widget application project in the Tizen Studio. An application project contains all the files that make up an application.</p>
<li><p>Launch the Tizen Studio.</p></li>
<li>
-<p>Make sure the <strong>Tizen Native</strong> perspective is selected in the top right corner of the Tizen Studio window. </p>
+<p>Make sure the <strong>Native</strong> perspective is selected in the top right corner of the Tizen Studio window. </p>
<p align="center"><img alt="Checking the perspective" src="../../images/change_perspective_n.png" /></p>
-<p>If not, select it. If the perspective is not visible, in the Tizen Studio menu, select <strong>Window > Open Perspective > Other > Tizen Native</strong>, and click <strong>OK</strong>.</p>
+<p>If not, select it. If the perspective is not visible, in the Tizen Studio menu, select <strong>Window > Perspective > Open Perspective > Other > Native</strong>, and click <strong>OK</strong>.</p>
</li>
<li>
-<p>In the Tizen Studio menu, select <strong>File > New > Tizen Native Project</strong>.</p>
+<p>In the Tizen Studio menu, select <strong>File > New > Tizen Project</strong>.</p>
<p align="center"><img alt="Creating a new Tizen Native project" src="../../images/create_project_1_n.png" /></p>
<p>The Project Wizard opens.</p>
</li>
<p>In the Project Wizard, define the project details.</p>
<p>The Project Wizard is used to create the basic application skeleton with the required folder structure and mandatory files. You can easily create different applications by selecting an applicable template or sample for the Project Wizard to use.</p>
<ol type="a">
-<li><p>Select the <strong>Template</strong> tab and the <strong>WEARABLE-[version] > Widget</strong> template. The version depends on the SDK version you have installed and with which you are developing the application.</p></li>
-<li><p>Change the project name, if you want.</p></li>
-<li><p>Leave all other fields in the Project Wizard to their default values, and click <strong>Finish</strong>.</p></li>
+<li><p>Select the <strong>Template</strong> project type and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the project type" src="../../images/create_project_wizard_type.png" /></p>
+</li>
+<li><p>Select the profile (<strong>Wearable</strong>) and version from a drop-down list and click <strong>Next</strong>.</p>
+<p>The version depends on the platform version you have installed and with which you are developing the application.</p>
+<p align="center"><img alt="Selecting the profile and version" src="../../images/create_project_wizard_version_wearable.png" /></p>
+</li>
+<li><p>Select the <strong>Native Application</strong> application type and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the application type" src="../../images/create_project_wizard_app_wearable.png" /></p>
+</li>
+<li><p>Select the <strong>Widget</strong> template and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the template" src="../../images/create_project_wizard_template_wn_widget.png" /></p>
+</li>
+<li><p>Define the project properties and click <strong>Finish</strong>.</p>
+<p>You can fill the project name (3-50 characters) and the unique package ID. You can also select the location and working sets by clicking <strong>More properties</strong>.</p>
+<p align="center"><img alt="Defining properties" src="../../images/create_project_wizard_properties_wn_widget.png" /></p>
+
+<p>The Project Wizard sets up the project, creates the application files using the default content from the template, and closes. For more information about the Project Wizard and the available templates, see <a href="../../../../org.tizen.studio/html/native_tools/project_wizard_n.htm">Creating Tizen Projects with Tizen Project Wizard</a>.</p></li>
</ol>
-<p align="center"><img alt="Defining the project details" src="../../images/create_project_2_wn_widget.png" /></p>
-<p>The Project Wizard sets up the project, creates the application files using the default content from the template, and closes. For more information about the Project Wizard and the available templates, see <a href="../../../../org.tizen.studio/html/native_tools/project_wizard_n.htm">Creating Tizen Projects with Tizen Project Wizard</a>.</p>
</li>
</ol>
<li><p><strong>Localization</strong>: Define localized values for the application label, description, and icon.</p></li>
<li><p><strong>Advanced</strong>: Define advanced features, such as application metadata, widget (preview image and supported size), and miscellaneous options.</p></li>
<li>
-<p><strong>tizen-manifest.xml</strong>: View and edit the source code of the <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file. Changes made and saved on the other tabs are reflected in the source code and vice versa.</p>
+<p><strong>Source</strong>: View and edit the source code of the <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file. Changes made and saved on the other tabs are reflected in the source code and vice versa.</p>
<table class="note">
<tbody>
<tr>
<th class="note">Note</th>
</tr>
<tr>
- <td class="note">The <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file must conform to both the XML file format and the Tizen native application specification requirements. Editing the file in the source code view is intended for advanced users only.</td>
+ <td class="note">The <span style="font-family: Courier New,Courier,monospace">tizen-manifest.xml</span> file must conform to both the XML file format and the Tizen native application specification requirements. Editing the file in the <strong>Source</strong> tab is intended for advanced users only.</td>
</tr>
</tbody>
</table>
</ul>
</li>
-<li><p>To save any changes, in the Tizen Studio menu, select <strong>File > Save</strong>.</p></li>
+<li><p>To save any changes, in the Tizen Studio menu, select <strong>File > Save All</strong>.</p></li>
</ol>
<ol>
<li>Select the project in the <strong>Project Explorer</strong> view.</li>
<li>In the Tizen Studio menu, select <strong>Project > Build Automatically</strong>.
-<p align="center"><img alt="Using the automatic build" src="../../images/build_automatic_n.png" /></p>
+<p align="center"><img alt="Using the automatic build" src="../../images/build_automatic_wn_widget.png" /></p>
<p>A check mark appears next to the menu option.</p></li>
</ol>
<p>The manual build means that you determine yourself when the application is built.</p>
<p>To manually build the application, right-click the project in the <strong>Project Explorer</strong> view and select <strong>Build Project</strong>.</p>
<p class="figure">Figure: Manually building the application</p>
-<p align="center"><img alt="Manually building the application" src="../../images/build_manual_widget_wn.png" /></p>
+<p align="center"><img alt="Manually building the application" src="../../images/build_manual_wn_widget.png" /></p>
<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and do one of the following:</p>
<ul><li>In the Tizen Studio menu, select <strong>Project > Build Project</strong>.</li>
<li>Press the <strong>F10</strong> key.</li>
-<li>Click the hammer icon (<img alt="Building the application from the toolbar" src="../../images/build_icon_mn.png" />) in the toolbar.
-</li>
</ul>
</li>
</ul>
<li>In the <strong>Connection Explorer</strong> view, launch the Emulator Manager by clicking the related icon.
<p align="center"><img src="../../images/emulator_icon.png" alt="Emulator manager icon" /></p>
</li>
-
-<li>In the Emulator Manager, open the <strong>Create New Emulator</strong> drop-down list and select <strong>wearable</strong>.
-<p align="center"><img src="../../images/emulator_new_wearable.png" alt="Emulator manager" /></p>
+<li>In the Emulator Manager, click <strong>Create</strong>.
+<p align="center"><img src="../../images/emulator_instance_create.png" alt="Creating an emulator instance" /></p>
</li>
-
-<li>Modify the emulator options, and click <strong>Confirm</strong>.
+<li>Select the applicable platform (in this case, <strong>wearable-2.3.2-circle (basic)</strong>), and click <strong>Next</strong>.
+<p align="center"><img src="../../images/emulator_instance_platform_wearable.png" alt="Selecting the platform" /></p>
+</li>
+<li>Select the device definition along with the platform version (in this case, <strong>Wearable Circle</strong>), and click <strong>Next</strong>.
+<p align="center"><img src="../../images/emulator_instance_version_wearable.png" alt="Selecting the platform version" /></p>
+</li>
+<li>Define the emulator properties, and click <strong>Finish</strong>.
<p>You can leave the options to their default values.</p>
-<p align="center"><img src="../../images/emulator_settings_wearable.png" alt="Emulator options" /></p>
+<p align="center"><img src="../../images/emulator_instance_properties_wearable.png" alt="Defining the properties" /></p>
</li>
-<li>To launch the emulator instance, select the emulator from the list and click the play icon.
-<p align="center"><img src="../../images/emulator_launch_wearable.png" alt="Launch the emulator" /></p>
+<li>To launch the emulator instance, select the emulator from the list and click <strong>Launch</strong>.
+<p align="center"><img src="../../images/emulator_instance_launch_wearable.png" alt="Launching the emulator" /></p>
-<p>The emulator is launched in its own window.</p>
-<p>You can also see the new emulator instance in the <strong>Connection Explorer</strong> view. To view the emulator folder structure, click the arrow next to the emulator instance.</p>
+<p>The emulator is launched in its own window. You can also see the new emulator instance in the <strong>Connection Explorer</strong> view. To view the emulator folder structure, click the arrow next to the emulator instance.</p>
<p align="center"><img src="../../images/emulator_window_wearable.png" alt="Emulator" /></p>
</li>
</ol>
</li>
<li>Generate a security profile.
- <p>Before you run the application, you must sign your application package by <a href="https://developer.tizen.org/community/tip-tech/issuing-tizen-certificate-certificate-extension-ver-1.2#emulator" target="_blank">generating an author certificate and registering it</a> in the Tizen Studio.</p>
+ <p>Before you run the application, you must <a href="../../../../org.tizen.studio/html/common_tools/certificate_registration.htm">sign your application package with a certificate profile</a> in the Tizen Studio.</p>
</li>
<li>Run the application:
<ol type="a">
<li>In the <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Tizen Native Application</strong>.
-<p align="center"><img src="../../images/app_run_wn_widget.png" alt="Run the application" /></p>
+<p align="center"><img src="../../images/app_run_wn_widget.png" alt="Running the application" /></p>
<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and do one of the following:</p>
<ul><li>Press the <strong>Ctrl+F11</strong> key.</li>
-<li>Click the play icon (<img src="../../images/emulator_play.png" alt="Play icon" />) in the toolbar.</li></ul>
+<li>Click the run icon in the toolbar.</li></ul>
+<p>If you have created multiple emulator instances, select the instance you want from the combo box in the toolbar before selecting to run the application. If you select an offline emulator, it is automatically launched when you select to run the application.</p>
+
+<p align="center"><img src="../../images/app_run_multiple_emulators.png" alt="Selecting the emulator to use" /></p>
</li>
<li>Confirm that the application launches on the emulator.
</li>
<li>Generate an author certificate.
-<p>Before you run the application, you must sign your application package by <a href="https://developer.tizen.org/community/tip-tech/issuing-tizen-certificate-certificate-extension-ver-1.2#CommercialDevices" target="_blank">generating an author certificate and registering it</a> in the Tizen Studio.</p>
+<p>Before you run the application, you must <a href="../../../../org.tizen.studio/html/common_tools/certificate_registration.htm">sign your application package with a certificate profile</a> in the Tizen Studio.</p>
</li>
<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and do one of the following:</p>
<ul><li>Press the <strong>Ctrl+F11</strong> key.</li>
-<li>Click the play icon (<img src="../../images/emulator_play.png" alt="Play icon" />) in the toolbar.</li></ul>
+<li>Click the run icon in the toolbar.</li></ul>
+
+<p>If you have both a connected device and existing emulator instances, select the device from the combo box in the toolbar before selecting to run the application.</p>
+
+<p align="center"><img src="../../images/app_run_multiple_emulators.png" alt="Selecting the device to use" /></p>
</li>
<li>Confirm that the application launches in the target device.
<td class="note">The application is launched using the default debug run configuration. To create and use another configuration:
<ol>
<li>In the <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Run Configurations</strong>.</li>
- <li>In the <strong>Run Configurations</strong> window, click the <strong>New Launch Configuration</strong> icon (<img alt="New Launch Configuration" src="../../images/run_new_config_wn.png" />), define the configuration details, and launch the application by clicking <strong>Run</strong>.
- <p align="center"><img alt="Run Configurations" src="../../images/run_configurations_n_widget.png" /></p></li>
+ <li>In the <strong>Run Configurations</strong> window, click the <strong>New Launch Configuration</strong> icon (<img alt="New Launch Configuration icon" src="../../images/run_new_config_wn.png" />), define the configuration details, and launch the application by clicking <strong>Run</strong>.
+ <p align="center"><img alt="Run Configurations window" src="../../images/run_configurations_wn_widget.png" /></p></li>
</ol></td>
</tr>
</tbody>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">data</span></td>
- <td>Native or Web application private data</td>
+ <td>Web or native application private data</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">info</span></td>
--- /dev/null
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+ <meta http-equiv="content-type" content="text/html; charset=utf-8" />
+ <meta http-equiv="X-UA-Compatible" content="IE=9" />
+ <link rel="stylesheet" type="text/css" href="../../css/styles.css" />
+ <link rel="stylesheet" type="text/css" href="../../css/snippet.css" />
+ <script type="text/javascript" src="../../scripts/snippet.js"></script>
+ <script type="text/javascript" src="../../scripts/jquery.util.js" charset="utf-8"></script>
+ <script type="text/javascript" src="../../scripts/common.js" charset="utf-8"></script>
+ <script type="text/javascript" src="../../scripts/core.js" charset="utf-8"></script>
+ <script type="text/javascript" src="../../scripts/search.js" charset="utf-8"></script>
+
+ <title>API Versioning and Deprecation Policy of the Tizen Platform</title>
+</head>
+
+<body onload="prettyPrint()" style="overflow: auto;">
+
+<div id="toc-navigation">
+ <div id="profile">
+ <p><img alt="Mobile" src="../../images/mobile_s_wn.png"/> <img alt="Wearable" src="../../images/wearable_s_wn.png"/></p>
+ </div>
+ <div id="toc_border"><div id="toc">
+ <p class="toc-title">Content</p>
+ <ul class="toc">
+ <li><a href="#versioning">API Versioning</a></li>
+ <li><a href="#policy">Deprecation Policy and Schedule</a></li>
+ <li><a href="#identify">Identifying a Deprecated API</a></li>
+ <li><a href="#compatibility">API Backward Compatibility</a></li>
+ </ul>
+ </div></div>
+</div>
+
+<div id="container"><div id="contents"><div class="content">
+
+<h1>API Versioning and Deprecation Policy of the Tizen Platform</h1>
+
+<p>As much as the Tizen team wants to have a completely stable API, the evolution of both hardware technology and software capabilities is rapid. To be maximally useful, the API set must evolve to reflect those changes to enable the development of compelling applications that use those features. As an inevitable side effect, APIs may become obsolete and need to be replaced by more feature-rich versions.</p>
+
+<p>To mitigate the effect of the API deprecations, the Tizen team has decided to support deprecated APIs for 2 releases. You are encouraged to use the best API set that meets your needs at the time of development. If the application needs a specific API version, you can indicate it in the packaging information for Web, native, and hybrid application packages.</p>
+
+<h2 id="versioning">API Versioning</h2>
+
+<p>The version format used to identify the APIs of the Tizen platform is <strong>X.Y.Z</strong> (Major.Minor.Micro). All changes, including any kind of version upgrade, maintain the application binary interface (ABI) compatibility excepting only critical security reasons.</p>
+
+<h2 id="policy">Deprecation Policy and Schedule</h2>
+
+<p>API deprecation is used to inform you that some APIs are no longer recommended for use in your applications. The Tizen team is trying to keep the API as stable as possible, but sometimes APIs must be deprecated due to, for example, critical security issues, or new and better alternatives.</p>
+
+<p>Based on a careful analysis, the following deprecation policy has been adopted in Tizen:</p>
+
+<ul>
+<li>This policy comes into effect beginning with Tizen 2.4.</li>
+<li>The functionality of the deprecated API is available for 2 releases, as indicated in the following table.
+
+<table>
+<caption>Table: Deprecation schedule</caption>
+<tbody>
+<tr>
+ <th></th>
+ <th>V1 (Tizen 2.4/2.3.1/2.3.2)
+ <p><strong>Deprecation notice</strong></p></th>
+ <th>V2 (Tizen 3.0)
+ <p>Deprecated since V1</p></th>
+ <th>V3 (Tizen 3.x)
+<p>Deprecated since V1</p></th>
+</tr>
+ <tr>
+ <th>API functionality</th>
+ <td>Available</td>
+ <td>Available</td>
+ <td><strong>Not available</strong></td>
+ </tr>
+ <tr>
+ <th>API symbol</th>
+ <td>Available</td>
+ <td>Available</td>
+ <td><strong>Not available</strong></td>
+ </tr>
+ <tr>
+ <th>API Reference
+<p><strong>API Guides</strong></p>
+<p><strong>Samples</strong></p></th>
+ <td>Available</td>
+ <td>Available</td>
+ <td><strong>Not available</strong></td>
+ </tr>
+ <tr>
+ <th>TCT</th>
+ <td>Available</td>
+ <td>Available</td>
+ <td><strong>Not available</strong></td>
+ </tr>
+ </tbody></table>
+</li>
+<li>Deprecated APIs are removed after 2 version releases (including the notice version).
+<p>During the 2 version releases, the functionality of the deprecated API may also be removed immediately for security reasons or as an unavoidable part of the platform evolution.</p></li>
+<li>Alternatives must be described within the reference of the deprecated API, if possible.</li>
+<li>All version changes are considered 1 release for purposes of the deprecation policy.</li>
+</ul>
+
+<h2 id="identify">Identifying a Deprecated API</h2>
+
+<p>The Tizen Studio continues to provide deprecation warnings. From the API reference, you can find a highlighted tag starting with <strong>Deprecated</strong>. If there is an alternative for the deprecated API, it is specified within that tag.</p>
+
+<p>The following examples illustrate how the deprecation info is shown in the API reference:</p>
+
+<ul>
+<li>Deprecated API in the Native API:
+
+<pre class="prettyprint">
+<strong>int app_context_get_package(app_context_h app_context, char ** package)</strong>
+
+Gets the package with the given application context.
+
+<strong>Deprecated:</strong>
+ Deprecated since 2.3.1. Use app_context_get_app_id() instead.
+<strong>Since:</strong>
+ 2.3
+</pre>
+</li>
+<li>Deprecated API in the Web API:
+<pre class="prettyprint">
+<strong>addAppInfoEventListener</strong>
+Adds a listener for receiving notifications for changes
+in the list of installed applications on a device.
+<strong>Deprecated</strong>. It is deprecated since Tizen 2.4. Instead, set a listener for getting notified
+of the application changes (add/remove/update) on a device using tizen.package.setPackageInfoEventListener().
+
+<strong>long addAppInfoEventListener(ApplicationInformationEventCallback eventCallback);</strong>
+
+<strong>Since</strong>: 2.0
+</pre>
+</li>
+<li>Deprecated enumeration in the Native API:
+<pre class="prettyprint">
+<strong>enum telephony_call_state_e</strong>
+Enumeration for the call state.
+<strong>Deprecated:</strong>
+ Deprecated Since 2.4. Use telephony_call_status_e instead.
+<strong>Since:</strong>
+ 2.3
+</pre>
+</li>
+<li>Deprecated type definition in the Native API:
+
+<pre class="prettyprint">
+<strong>typedef void* bt_gatt_attribute_h</strong>
+The attribute handle of GATT (Generic Attribute Profile)
+<strong>Deprecated:</strong>
+ Deprecated since 2.3.1. Use bt_gatt_h instead.
+<strong>Since:</strong>
+ 2.3
+</pre>
+</li>
+</ul>
+
+<p>You can also see the API deprecation warning in log messages:</p>
+
+<ul>
+<li>In a log message:
+<pre class="prettyprint">
+DEPRECATION WARNING: app_context_get_package() is deprecated and
+will be removed from next release. Use app_context_get_app_id() instead.
+</pre>
+</li>
+<li>In a build log message:
+<pre class="prettyprint">
+[2/3] Building src/basicuiwithedc.o
+../src/basicuiwithedc.c:26:19: warning: 'app_get_resource_path' is deprecated [-Wdeprecated-declarations]
+ char *res_path = app_get_resource_path();
+</pre>
+</li>
+</ul>
+
+<h2 id="compatibility">API Backward Compatibility</h2>
+
+<p>With the best efforts, the Tizen platform tries to provide a backward compatibility of public APIs documented in the API reference. Therefore, you must use the listed APIs in the API reference to make the applications compatible.</p>
+
+<script type="text/javascript" src="../../scripts/jquery.zclip.min.js"></script>
+<script type="text/javascript" src="../../scripts/showhide.js"></script>
+</div></div></div>
+
+<a class="top sms" href="#"><img src="../../images/btn_top.gif" alt="Go to top" /></a>
+
+<div id="footer">
+<p class="footer">Except as noted, this content - excluding the Code Examples - is licensed under <a href="http://creativecommons.org/licenses/by/3.0/legalcode" target="_blank">Creative Commons Attribution 3.0</a> and all of the Code Examples contained herein are licensed under <a href="https://www.tizen.org/bsd-3-clause-license" target="_blank">BSD-3-Clause</a>.<br/>For details, see the <a href="https://www.tizen.org/content-license" target="_blank">Content License</a>.</p>
+</div>
+
+<script type="text/javascript">
+var _gaq = _gaq || [];
+_gaq.push(['_setAccount', 'UA-25976949-1']);
+_gaq.push(['_trackPageview']);
+(function() {
+var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+})();
+</script>
+
+</body>
+</html>
+
<li><a href="sec_privileges_w.htm">Security and API Privileges</a></li>
<li><a href="app_filtering_w.htm">Application Filtering</a></li>
<li><a href="web_runtime_w.htm">Web Runtime</a></li>
- <li><a href="event_handling_w.htm">Event Handling</a> (in <strong>wearable applications only</strong>)</li>
+ <li><a href="event_handling_w.htm">Event Handling</a> (in <strong>wearable applications only</strong>)</li>
+ <li><a href="deprecation_policy_w.htm">API Versioning and Deprecation Policy of the Tizen Platform</a></li>
<li><a href="sign_certificate_w.htm">Application Signing and Certificates</a></li>
</ul>
<p>In low-powered wearable devices, the Tizen platform supports an ambient mode for watch applications. When the device enables the ambient mode, the Tizen watch application displayed on an idle screen can show a limited UI to reduce power consumption. The watch application also receives a tick event every minute in the ambient mode.</p>
-<p>The details of the limited UI drawn in the ambient mode depend on the device. Usually, when designing the ambient mode UI, draw a black and white UI only, and use less than 15% of the pixels on the screen. If you do not want to draw your own ambient mode UI, set the <span style="font-family: Courier New,Courier,monospace">ambient-support</span> attribute to <span style="font-family: Courier New,Courier,monospace">disable</span> in the watch application manifest file to allow the platform to show a default ambient mode UI.</p>
+<p>The details of the limited UI drawn in the ambient mode depend on the device. In addition, due to the ambient mode being a low power mode, there are limits to the colors that can be shown on the screen. Usually, when designing the ambient mode UI, draw a black and white UI only, and use less than 15% of the pixels on the screen. If you do not want to draw your own ambient mode UI, set the <span style="font-family: Courier New,Courier,monospace">ambient_support</span> attribute to <span style="font-family: Courier New,Courier,monospace">disable</span> in the watch application <span style="font-family: Courier New,Courier,monospace">config.xml</span> file to allow the platform to show a default ambient mode UI.</p>
<p>Since Tizen 2.3.2, some devices introduce a high color mode for the ambient mode. In the high color mode, you can use more colors (usually, 24-bit color) for drawing the ambient mode UI. To check whether the device supports the high color mode, use the following code:</p>
<style>
td.key { font-family: Courier New,Courier,monospace }
tr.partner-level, tr.platform-level { background-color: #cff }
-</style>
+</style>
</head>
<body class="no-toc" onload="prettyPrint()" style="overflow: auto;">
<li>The platform level is the highest privilege level, and an application that needs these privileges requires at least a platform-signed certificate, which is granted to vendor developers.</li>
</ul>
-<p>Since Tizen platform 3.0, some privileges are categorized as privacy related and gives option to the users to on and off them. If an application invokes a privileged API, the Tizen system checks whether the privilege is <strong>allowed</strong> to it. For application to get a required privilege, the privilege must be declared in the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file. If the platform version is 3.0 or higher and the privilege is included in privacy group, it must not be switched off by the user.</p>
+<p>Since Tizen platform 3.0, some privileges are categorized as privacy-related and give an option to the user to switch them on and off. If an application invokes a privacy-related privileged API, the Tizen system checks whether the privilege is <strong>allowed</strong> for the application. For the application to use the API, the privilege must be declared in the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file and the user must have switched it on.</p>
+
+ <table class="note">
+ <tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">In applications with the platform version 3.0 or higher, if you use privacy-related privileged APIs, make sure that the user has switched the privilege on before making the function call. Otherwise, the application does not work as expected.</td>
+ </tr>
+ </tbody>
+ </table>
<p>The Tizen Studio also provides privilege checker tools to check whether the Tizen application source code contains any privilege violations. For more information, see <a href="../../../../org.tizen.studio/html/web_tools/privilege_checker_w.htm">Verifying Privilege Usage</a>.</p>
<td>public</td>
<td></td>
<td>2.2.1</td>
- <td>The application can change Bluetooth settings, such as turning Bluetooth on or off and setting the device name. <strong>Deprecated since 2.4</strong>. Use <span style="font-family: Courier New,Courier,monospace">http://tizen.org/privilege/bluetooth</span> instead.
+ <td>The application can change Bluetooth settings, such as switching Bluetooth on or off and setting the device name. <strong>Deprecated since 2.4</strong>. Use <span style="font-family: Courier New,Courier,monospace">http://tizen.org/privilege/bluetooth</span> instead.
</td>
</tr>
<tr>
<td>public</td>
<td></td>
<td>2.4</td>
- <td>The application can turn LEDs on or off, such as the LED on the front of the device and the camera flash.</td>
+ <td>The application can switch LEDs on or off, such as the LED on the front of the device and the camera flash.</td>
</tr>
<tr>
<td class="key">http://tizen.org/privilege/location</td>
<td>public</td>
<td></td>
<td>2.3.1</td>
- <td>The application can retrieve telephony information, such as the network and SIM card used, the IMEI, and the statuses of calls.</td>
+ <td>The application can retrieve telephony information, such as the network and SIM card used, the IMEI, and the status of calls.</td>
</tr>
<tr>
<td class="key">http://tizen.org/privilege/volume.set</td>
<td>public</td>
<td></td>
<td>2.3.1</td>
- <td>The application can change Bluetooth settings, such as turning Bluetooth on or off and setting the device name. <strong>Deprecated since 3.0</strong>. Use <span style="font-family: Courier New,Courier,monospace">http://tizen.org/privilege/bluetooth</span> instead.</td>
+ <td>The application can change Bluetooth settings, such as switching Bluetooth on or off and setting the device name. <strong>Deprecated since 3.0</strong>. Use <span style="font-family: Courier New,Courier,monospace">http://tizen.org/privilege/bluetooth</span> instead.</td>
</tr>
<tr>
<td class="key">http://tizen.org/privilege/bluetooth.gap</td>
<td>public</td>
<td></td>
<td>3.0</td>
- <td>The application can turn LEDs on or off, such as the LED on the front of the device and the camera flash.</td>
+ <td>The application can switch LEDs on or off, such as the LED on the front of the device and the camera flash.</td>
</tr>
<tr>
<td class="key">http://tizen.org/privilege/location</td>
<td>public</td>
<td></td>
<td>2.3.1</td>
- <td>The application can retrieve telephony information, such as the network and SIM card used, the IMEI, and the statuses of calls.</td>
+ <td>The application can retrieve telephony information, such as the network and SIM card used, the IMEI, and the status of calls.</td>
</tr>
<tr>
<td class="key">http://tizen.org/privilege/volume.set</td>
<li>Guides:
<p><a href="../../../../org.tizen.guides/html/web/alarm/alarms_w.htm">Alarms</a></p>
<p><a href="../../../../org.tizen.guides/html/web/app_management/app_management_cover_w.htm">Application Management</a></p>
- <p><a href="../../../../org.tizen.guides/html/web/notification/notification_w.htm">Notifications</a></p></li>
+ <p><a href="../../../../org.tizen.guides/html/web/notification/notification_w.htm">Notifications</a></p>
+ <p><a href="../../../../org.tizen.guides/html/web/text_input/text_input_cover_w.htm">Text Input</a></p></li>
<li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/mobile/index.html#Application">Application Framework</a></li>
</ul></td>
</tr>
<li>Guides:
<p><a href="../../../../org.tizen.guides/html/web/alarm/alarms_w.htm">Alarms</a></p>
<p><a href="../../../../org.tizen.guides/html/web/app_management/app_management_cover_w.htm">Application Management</a></p>
- <p><a href="../../../../org.tizen.guides/html/web/notification/notification_w.htm">Notifications</a></p></li>
+ <p><a href="../../../../org.tizen.guides/html/web/notification/notification_w.htm">Notifications</a></p>
+ <p><a href="../../../../org.tizen.guides/html/web/text_input/text_input_cover_w.htm">Text Input</a></p></li>
<li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/wearable/index.html#Application">Application Framework</a></li>
</ul></td>
</tr>
</tr>
<tr>
<td>Network</td>
- <td>These APIs contain classes and interfaces that enable you to manage Bluetooth, NFC (Near Field Communication), push, and secure element features.
+ <td>These APIs contain classes and interfaces that enable you to manage Bluetooth, NFC (Near Field Communication), and secure element features.
<p>You can transfer data over a Bluetooth connection, share contacts, photos, and videos using NFC, and access secure elements, such as SIM card and secure SD card, in a device.</p></td>
<td>
<ul>
<p>The following figure illustrates the application to be created:</p>
-<p>The following figure illustrates the application to be created:</p>
-
<ul>
<li><p>On the left, the figure shows the application screen when the application starts. The screen displays the <strong>Basic</strong> text.</p></li>
<li><p>On the right, the figure shows the application screen after you tap the text. The screen now displays the <strong>Tizen</strong> text. Tapping the text area switches between the 2 texts.</p></li>
<li><p>Launch the Tizen Studio.</p></li>
<li>
-<p>Make sure the <strong>Tizen Web</strong> perspective is selected in the top right corner of the Tizen Studio window. </p>
+<p>Make sure the <strong>Web</strong> perspective is selected in the top right corner of the Tizen Studio window. </p>
<p align="center"><img alt="Checking the perspective" src="../../images/change_perspective_w.png" /></p>
-<p>If not, select it. If the perspective is not visible, in the Tizen Studio menu, select <strong>Window > Open Perspective > Other > Tizen Web</strong>, and click <strong>OK</strong>.</p>
+<p>If not, select it. If the perspective is not visible, in the Tizen Studio menu, select <strong>Window > Perspective > Open Perspective > Other > Web</strong>, and click <strong>OK</strong>.</p>
</li>
<li>
-<p>In the Tizen Studio menu, select <strong>File > New > Tizen Web Project</strong>.</p>
+<p>In the Tizen Studio menu, select <strong>File > New > Tizen Project</strong>.</p>
<p align="center"><img alt="Creating a new Tizen Web project" src="../../images/create_project_1_w.png" /></p>
<p>The Project Wizard opens.</p>
</li>
<p>The Project Wizard is used to create the basic application skeleton with the required folder structure and mandatory files. You can easily create different applications by selecting an applicable template or sample for the Project Wizard to use.</p>
<ol type="a">
-<li><p>Select the <strong>Template</strong> tab and the <strong>MOBILE-[version] > Basic</strong> template. The version depends on the SDK version you have installed and with which you are developing the application.</p></li>
-<li><p>Change the project name, if you want.</p></li>
-<li><p>Leave all other fields in the Project Wizard to their default values, and click <strong>Finish</strong>.</p></li>
+<li><p>Select the <strong>Template</strong> project type and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the project type" src="../../images/create_project_wizard_type.png" /></p>
+</li>
+<li><p>Select the profile (<strong>Mobile</strong>) and version from a drop-down list and click <strong>Next</strong>.</p>
+<p>The version depends on the platform version you have installed and with which you are developing the application.</p>
+<p align="center"><img alt="Selecting the profile and version" src="../../images/create_project_wizard_version.png" /></p>
+</li>
+<li><p>Select the <strong>Web Application</strong> application type and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the application type" src="../../images/create_project_wizard_app_web.png" /></p>
+</li>
+<li><p>Select the <strong>Basic UI</strong> template and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the template" src="../../images/create_project_wizard_template_mw.png" /></p>
+</li>
+<li><p>Define the project properties and click <strong>Finish</strong>.</p>
+<p>You can fill the project name (3-50 characters) and the unique package ID. You can also select the location and working sets by clicking <strong>More properties</strong>.</p>
+<p align="center"><img alt="Defining properties" src="../../images/create_project_wizard_properties_mw.png" /></p>
+
+<p>The Project Wizard sets up the project, creates the application files using the default content from the template, and closes. For more information about the Project Wizard and the available templates, see <a href="../../../../org.tizen.studio/html/web_tools/project_wizard_w.htm">Creating Tizen Projects with Tizen Project Wizard</a>.</p></li>
</ol>
-<p align="center"><img alt="Defining the project details" src="../../images/create_project_2_mw.png" /></p>
-<p>The Project Wizard sets up the project, creates the application files using the default content from the template, and closes. For more information about the Project Wizard and the available templates, see <a href="../../../../org.tizen.studio/html/web_tools/project_wizard_w.htm">Creating Tizen Projects with Tizen Project Wizard</a>.</p>
</li>
</ol>
<p align="center"><img alt="Configuring the application" src="../../images/basic_app_config_w.png" /></p>
<ul>
<li><p><strong>Overview</strong>: Define general information, such as the name and icon of the application.</p></li>
-<li><p><strong>Widget</strong>: Define author and license information and UI preferences.</p></li>
<li><p><strong>Features</strong>: Define required software and hardware features. This information is used for application filtering in the Tizen market place.</p></li>
<li><p><strong>Privileges</strong>: Define the security-sensitive APIs or API groups accessed and used by the application.</p></li>
<li><p><strong>Policy</strong>: Request network resource permissions to access external network resources.</p></li>
<th class="note">Note</th>
</tr>
<tr>
- <td class="note">The <span style="font-family: Courier New,Courier,monospace">config.xml</span> file must conform to both the XML file format and the W3C specification requirements. Editing the file in the source code view is intended for advanced users only.</td>
+ <td class="note">The <span style="font-family: Courier New,Courier,monospace">config.xml</span> file must conform to both the XML file format and the W3C specification requirements. Editing the file in the <strong>Source</strong> tab is intended for advanced users only.</td>
</tr>
</tbody>
</table>
</ul>
</li>
-<li><p>To save any changes, in the Tizen Studio menu, select <strong>File > Save</strong>.</p></li>
+<li><p>To save any changes, in the Tizen Studio menu, select <strong>File > Save All</strong>.</p></li>
</ol>
<li>In the <strong>Connection Explorer</strong> view, launch the Emulator Manager by clicking the related icon.
<p align="center"><img src="../../images/emulator_icon.png" alt="Emulator manager icon" /></p>
</li>
-
-<li>In the Emulator Manager, open the <strong>Create New Emulator</strong> drop-down list and select <strong>mobile</strong>.
-<p align="center"><img src="../../images/emulator_new_mobile.png" alt="Emulator manager" /></p>
+<li>In the Emulator Manager, click <strong>Create</strong>.
+<p align="center"><img src="../../images/emulator_instance_create.png" alt="Creating an emulator instance" /></p>
</li>
-
-<li>Modify the emulator options, and click <strong>Confirm</strong>.
+<li>Select the applicable platform (in this case, <strong>mobile-2.4 (basic)</strong>), and click <strong>Next</strong>.
+<p align="center"><img src="../../images/emulator_instance_platform.png" alt="Selecting the platform" /></p>
+</li>
+<li>Select the device definition along with the platform version (in this case, <strong>HD Mobile</strong>), and click <strong>Next</strong>.
+<p align="center"><img src="../../images/emulator_instance_version.png" alt="Selecting the platform version" /></p>
+</li>
+<li>Define the emulator properties, and click <strong>Finish</strong>.
<p>You can leave the options to their default values.</p>
-<p align="center"><img src="../../images/emulator_settings_mobile.png" alt="Emulator options" /></p>
+<p align="center"><img src="../../images/emulator_instance_properties.png" alt="Defining the properties" /></p>
</li>
+<li>To launch the emulator instance, select the emulator from the list and click <strong>Launch</strong>.
+<p align="center"><img src="../../images/emulator_instance_launch.png" alt="Launching the emulator" /></p>
-<li>To launch the emulator instance, select the emulator from the list and click the play icon.
-<p align="center"><img src="../../images/emulator_launch_mobile.png" alt="Launch the emulator" /></p>
-
-<p>The emulator is launched in its own window.</p>
-<p>You can also see the new emulator instance in the <strong>Connection Explorer</strong> view. To view the emulator folder structure, click the arrow next to the emulator instance.</p>
+<p>The emulator is launched in its own window. You can also see the new emulator instance in the <strong>Connection Explorer</strong> view. To view the emulator folder structure, click the arrow next to the emulator instance.</p>
<p align="center"><img src="../../images/emulator_window_mobile.png" alt="Emulator" /></p>
</li>
</ol>
</li>
<li>Generate a security profile.
- <p>Before you run the application, you must sign your application package by <a href="https://developer.tizen.org/community/tip-tech/issuing-tizen-certificate-certificate-extension-ver-1.2#emulator" target="_blank">generating an author certificate and registering it</a> in the Tizen Studio.</p>
+ <p>Before you run the application, you must <a href="../../../../org.tizen.studio/html/common_tools/certificate_registration.htm">sign your application package with a certificate profile</a> in the Tizen Studio.</p>
</li>
<li>Run the application:
<li>In the <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Tizen Web Application</strong>.
-<p align="center"><img src="../../images/app_run_mw.png" alt="Run the application" /></p>
+<p align="center"><img src="../../images/app_run_mw.png" alt="Running the application" /></p>
<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and do one of the following:</p>
<ul><li>Press the <strong>Ctrl+F11</strong> key.</li>
-<li>Click the play icon (<img src="../../images/emulator_play.png" alt="Play icon" />) in the toolbar.</li></ul>
+<li>Click the run icon in the toolbar.</li></ul>
+
+<p>If you have created multiple emulator instances, select the instance you want from the combo box in the toolbar before selecting to run the application. If you select an offline emulator, it is automatically launched when you select to run the application.</p>
+
+<p align="center"><img src="../../images/app_run_multiple_emulators.png" alt="Selecting the emulator to use" /></p>
</li>
<li>Confirm that the application launches on the emulator.
</li>
</ol>
-<p>For more information on using the emulator features, see <a href="../../../../org.tizen.studio/html/common_tools/emulator_control_panel.htm">
Emulator Control Keys and Menu</a> and <a href="../../../../org.tizen.studio/html/common_tools/emulator_features.htm">Using Extended Emulator Features</a>.</p>
+<p>For more information on using the emulator features, see <a href="../../../../org.tizen.studio/html/common_tools/emulator_control_panel.htm">
Using Emulator Control Keys, Menu, and Panel</a> and <a href="../../../../org.tizen.studio/html/common_tools/emulator_features.htm">Using Extended Emulator Features</a>.</p>
<h3 id="simulator">Running on the Web Simulator</h3>
<ol>
<li>
<p>In the <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Tizen Web Simulator Application</strong>.</p>
-<p align="center"><img src="../../images/simulator_run_mw.png" alt="Run the application" /></p>
+<p align="center"><img src="../../images/simulator_run_mw.png" alt="Running the application" /></p>
-<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and click the play icon (<img src="../../images/emulator_play.png" alt="Play icon" />) in the toolbar.</p>
+<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and click the run icon in the toolbar.</p>
</li>
<li>
<p>Confirm that the application launches on the Web Simulator.</p>
<ol>
<li>Connect the mobile target device to your computer using a USB cable.</li>
<li>Generate an author certificate.
-<p>Before you run the application, you must sign your application package by <a href="https://developer.tizen.org/community/tip-tech/issuing-tizen-certificate-certificate-extension-ver-1.2#CommercialDevices" target="_blank">generating an author certificate and registering it</a> in the Tizen Studio.</p>
+<p>Before you run the application, you must <a href="../../../../org.tizen.studio/html/common_tools/certificate_registration.htm">sign your application package with a certificate profile</a> in the Tizen Studio.</p>
</li>
<li>Run the application:
<ol type="a">
<li>In the <strong>Connection Explorer</strong> view, select the device.</li>
<li>In <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Tizen Web Application</strong>.
-<p align="center"><img src="../../images/app_run_mw.png" alt="Run the application on a target device" /></p>
+<p align="center"><img src="../../images/app_run_mw.png" alt="Running the application on a target device" /></p>
<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and do one of the following:</p>
<ul><li>Press the <strong>Ctrl+F11</strong> key.</li>
-<li>Click the play icon (<img src="../../images/emulator_play.png" alt="Play icon" />) in the toolbar.</li></ul>
+<li>Click the run icon in the toolbar.</li></ul>
+
+<p>If you have both a connected device and existing emulator instances, select the device from the combo box in the toolbar before selecting to run the application.</p>
+
+<p align="center"><img src="../../images/app_run_multiple_emulators.png" alt="Selecting the device to use" /></p>
</li>
<li>Confirm that the application launches in the target device.</li>
<td class="note">The application is launched using the default debug run configuration. To create and use another configuration:
<ol>
<li>In the <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Run Configurations</strong>.</li>
- <li>In the <strong>Run Configurations</strong> window, click the <strong>New Launch Configuration</strong> icon (<img alt="New Launch Configuration" src="../../images/run_new_config_wn.png" />), define the configuration details, and launch the application by clicking <strong>Run</strong>.
- <p align="center"><img alt="Run Configurations" src="../../images/run_configurations_w.png" /></p></li>
+ <li>In the <strong>Run Configurations</strong> window, click the <strong>New Launch Configuration</strong> icon (<img alt="New Launch Configuration icon" src="../../images/run_new_config_wn.png" />), define the configuration details, and launch the application by clicking <strong>Run</strong>.
+ <p align="center"><img alt="Run Configurations window" src="../../images/run_configurations_w.png" /></p></li>
</ol></td>
</tr>
</tbody>
<ol>
<li>Install TAU templates.
-<p>The Tizen 2.4 SDK comes with the Update Manager tool, which you can use to install the TAU packages required for TAU application development.</p>
+<p>The Tizen Studio comes with the Package Manager tool, which you can use to install the TAU packages required for TAU application development.</p>
<p>The TAU packages enable you to create the Web application using a TAU template.</p>
-<p align="center"><img src="../../images/simple_ui_update_mgr_mw.png" alt="Update manager installation" /></p>
+<p align="center"><img src="../../images/simple_ui_update_mgr_ww.png" alt="TAU package installation" /></p>
</li>
<li>Start the application development with the TAU library.
<p>You can get the TAU library using a TAU template or a sample application as a basis for your application. The easiest way to start your first TAU application is to create a new project with a TAU template.</p>
<p>To create a project with a TAU template:</p>
<ol type="a">
-<li>Go to <strong>File > New > Tizen Web Project</strong>.</li>
-<li>Go to <strong>Template > Mobile-2.4 > TAU SinglePage</strong>.
-<p align="center"><img src="../../images/simple_ui_tau_create_mw.png" alt="Create a new project" /></p>
+<li>Go to <strong>File > New > Tizen Project</strong>.</li>
+<li>Select <strong>Template > Mobile v2.4 > Web Application > TAU SinglePage</strong>.
+<p align="center"><img src="../../images/simple_ui_tau_create_mw.png" alt="Creating a new project" /></p>
</li>
-<li>Enter the project name and select <strong>2.4</strong> for version.</li>
-<li>Click <strong>Finish</strong>.</li>
+<li>Change the project name and properties and click <strong>Finish</strong>.
+<p align="center"><img src="../../images/simple_ui_tau_properties_mw.png" alt="Changing properties" /></p></li>
+
<li>In the <strong>Project Explorer</strong> view, view the project.
<p>The TAU library is located in the <span style="font-family: Courier New,Courier,monospace">lib</span> folder.</p>
<p align="center"><img src="../../images/simple_ui_tau_dir_mw.png" alt="TAU library directory" /></p>
</body>
</pre></li>
-<li>In the <strong>Project Explorer</strong> view, right-click the project and select <strong>New > JavaScript Source File</strong>.
+<li>In the <strong>Project Explorer</strong> view, right-click the project and select <strong>New > JavaScript Source File</strong>.
<p align="center"><img src="../../images/simple_ui_tau_new_js_mw.png" alt="Create a new JavaScript file" /></p></li>
-<li>Write the file name as <strong>app.js</strong> and click <strong>Finish</strong>.
-<p align="center"><img src="../../images/simple_ui_tau_new_js_name_mw.png" alt="Name the new file" /></p></li>
+<li>Write the file name as <strong>app.js</strong> and click <strong>Finish</strong>.</li>
<li>
<p>In the <span style="font-family: Courier New,Courier,monospace">app.js</span> file, all kinds of logic can be added to the application. In this case, add several lines for handling navigation:</p>
<p>The Tizen Studio provides various project templates that make it easier for you to start coding your application. When you create a new project, you can select a specific template or sample. Based on the selection, the Tizen Web <a href="../../../../org.tizen.studio/html/web_tools/project_wizard_w.htm">Project Wizard</a> automatically creates basic functionalities that the application has to implement to be able to run. The default project files and folders are also created.</p>
-<p>You can also create <a href="creating_app_project_w.htm#user">custom user templates</a>.</p>
-
<h2 id="set" name="set" >Setting Project Properties</h2>
<p>After creating the application project, you can <a href="setting_properties_w.htm">configure the properties of the project and the Web application</a> to achieve the required functionality and features for your application.</p>
<title>Creating the Application Project</title>
</head>
-<body onload="prettyPrint()" style="overflow: auto;">
+<body class="no-toc" onload="prettyPrint()" style="overflow: auto;">
<div id="toc-navigation">
- <div id="profile">
- <p><img alt="Mobile Web" src="../../images/mobile_s_w.png"/> <img alt="Wearable Web" src="../../images/wearable_s_w.png"/> <img alt="TV Web" src="../../images/tv_s_w.png"/></p>
- </div>
-
- <div id="toc_border"><div id="toc">
- <p class="toc-title">Content</p>
- <ul class="toc">
- <li><a href="#import">Importing a Project</a></li>
- <li><a href="#export">Exporting a Project User Template</a></li>
- <li><a href="#user">User Template</a></li>
- </ul>
- </div></div>
</div>
<div id="container"><div id="contents"><div class="content">
+ <div id="profile">
+ <p><img alt="Mobile Web" src="../../images/mobile_s_w.png"/> <img alt="Wearable Web" src="../../images/wearable_s_w.png"/> <img alt="TV Web" src="../../images/tv_s_w.png"/></p>
+ </div>
<h1>Creating the Application Project</h1>
<p>You can create a Web application project by selecting from a variety of templates and samples. The following instructions are specific for creating the project with a template.</p>
<p>To create a Web application project:</p>
<ol>
- <li>In the Tizen Studio, select <strong>File > New > Tizen Web Project</strong>. <p>If the project option you want is not visible, make sure that you are using the correct perspective (Tizen Web). To switch perspectives, go to <strong>Window > Open Perspective > Other</strong> and select the perspective you need.</p></li>
- <li>In the <strong>New Tizen Web Project</strong> window, define the project details:
+ <li>In the Tizen Studio, select <strong>File > New > Tizen Project</strong>.
+ <p align="center"><img alt="Creating a new project" src="../../images/create_project_1_w.png" /></p>
+ <p>The Project Wizard opens.</p></li>
+ <li>In the Project Wizard, define the project details.
+ <p>The Project Wizard is used to create the basic application skeleton with the required folder structure and mandatory files. You can easily create different applications by selecting an applicable template or sample for the Project Wizard to use.</p>
<ol type="a">
- <li>Select the project type.</li>
- <li>Define the name of your project. <p>The default location for your application project is defined.</p>
+ <li><p>Select the <strong>Template</strong> project type and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the project type" src="../../images/create_project_wizard_type.png" /></p>
+</li>
+<li><p>Select the profile (<strong>Mobile</strong> or <strong>Wearable</strong>) and version from a drop-down list and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the profile and version" src="../../images/create_project_wizard_version_wearable.png" /></p>
+</li>
+<li><p>Select the <strong>Web Application</strong> application type and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the application type" src="../../images/create_project_wizard_app_web_wearable.png" /></p>
+</li>
+<li><p>Select the template you want to use and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the template" src="../../images/create_project_wizard_template_ww.png" /></p>
+</li>
+<li><p>Define the project properties and click <strong>Finish</strong>.</p>
+<p>You can fill the project name. You can also select the location and working sets by clicking <strong>More properties</strong>.</p>
<table class="note">
<tbody>
<tr>
<td class="note">The Tizen API names cannot be used as project names. The project name must be more than 2 characters and is restricted to the following regular expression: [a-zA-Z][a-zA-Z0-9-]{2,49}.</td>
</tr>
</tbody>
- </table></li>
- </ol> </li>
- <li>Click <strong>Finish</strong>.</li>
- </ol>
- <p>The new application project is shown in the <strong>Project Explorer</strong> view of the Tizen Studio, with default content in the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file as well as in several project folders.</p>
- <p class="figure">Figure: Creating a Tizen mobile Web project</p>
- <p align="center"><img alt="Creating a Tizen mobile Web project" src="../../images/web_application_wizard.png" /></p>
-
-<p class="figure">Figure: Creating a Tizen wearable Web project</p>
-<p align="center"><img alt="Creating a Tizen wearable Web project" src="../../images/hello_wearable.png" /></p>
+ </table>
+<p align="center"><img alt="Defining properties" src="../../images/create_project_wizard_properties_ww.png" /></p>
+<p>The Project Wizard sets up the project, creates the application files using the default content from the template, and closes. For more information about the Project Wizard and the available templates, see <a href="../../../../org.tizen.studio/html/web_tools/project_wizard_w.htm">Creating Tizen Projects with Tizen Project Wizard</a>.</p></li>
+ </ol> </li></ol>
+ <p>The new application project is shown in the <strong>Project Explorer</strong> view of the Tizen Studio, with default content in the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file as well as in several project folders.</p>
<h2 id="import" name="import">Importing a Project</h2>
<p>If you have an existing Tizen application project, you can import it into the Tizen Studio:</p>
<ol>
- <li>Select <strong>File > Import > Tizen > Tizen Project</strong>.</li>
+ <li>Select <strong>File > Import > Tizen > Tizen Project</strong>, and click <strong>Next</strong>.</li>
<li>Click <strong>Browse</strong> and select the root directory, which contains your existing project, or Web application package file (with the <span style="font-family: Courier New,Courier,monospace">.wgt</span> extension).</li>
- <li>Select a profile and version from the <strong>Platform</strong> drop-down lists.</li>
+ <li>With the <strong>Platform</strong> drop-down lists, select the platform profile and version.</li>
<li>Click <strong>Finish</strong>.</li>
- </ol>
-
-
- <h2 id="export" name="export">Exporting a Project User Template</h2>
- <p>To export an existing project as a <a href="#user">user template</a> that you can use as a basis for creating other projects:</p>
- <ol>
- <li>Select <strong>File > Export > Tizen > Tizen Web User Template</strong>.</li>
- <li>In the <strong>User Template Export Wizard</strong> window, define the project and user template details:
- <ol type="a">
- <li>Select the source project.</li>
- <li>Define the name of your user template.</li>
- <li>Click <strong>Browse</strong> and select the export location. <p>You can add the template to the <strong>User Template</strong> tab of the <strong>New Tizen Web Project</strong> window by selecting the <strong>Import a template to the new project wizard automatically</strong> check box. To select a template description, preview image, and icon files to be shown in the Project Wizard, click <strong>Next</strong>.</p></li>
- </ol> </li>
- <li>Click <strong>Finish</strong>.</li>
- </ol>
-
- <h2 name="user" id="user">User Template</h2>
- <p>You can <a href="#export">create custom user templates from existing projects</a> and use these templates to create new projects. The created user templates are located in the <span style="font-family: Courier New,Courier,monospace"><TIZEN_STUDIO_DATA>/ide/user-templates/web</span> directory and a user-defined directory. When you create a user template, you can define the export location in the User Template Export Wizard.</p>
- <p class="figure">Figure: User template export location</p>
- <p align="center"><img alt="User template export location" src="../../images/user_template_export.png" /></p>
-
- <p>The <span style="font-family: Courier New,Courier,monospace"><TIZEN_STUDIO_DATA></span> directory is different for different platforms:</p>
- <ul>
- <li>In Ubuntu: <span style="font-family: Courier New,Courier,monospace">/home/${USER_NAME}/tizen-sdk-data</span> (in mobile Web projects) or <span style="font-family: Courier New,Courier,monospace">/home/${USER_NAME}/tizen-wearable-sdk-data</span> (in wearable Web projects)</li>
- <li>In Windows® XP: <span style="font-family: Courier New,Courier,monospace">C:\tizen-sdk-data</span> (in mobile Web projects) or <span style="font-family: Courier New,Courier,monospace">C:\tizen-wearable-sdk-data</span> (in wearable Web projects)</li>
- <li>In Windows® 7: <span style="font-family: Courier New,Courier,monospace">C:\tizen-sdk-data</span> (in mobile Web projects) or <span style="font-family: Courier New,Courier,monospace">C:\tizen-wearable-sdk-data</span> (in wearable Web projects)</li>
- </ul>
- <p>The <span style="font-family: Courier New,Courier,monospace">project</span> folder of a user template consists of project-related files that are copied into new projects created using the user template. You can modify these files in your new project.</p>
- <p>The following table describes the files included in a user template in addition to the <span style="font-family: Courier New,Courier,monospace">project</span> folder content.</p>
- <table border="1">
- <caption>
- Table: User template files
- </caption>
- <tbody>
- <tr>
- <th>File</th>
- <th>Contents</th>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace">description.xml</span></td>
- <td>This file consists of the following template description information that is displayed in the Project Wizard:
- <ul>
- <li><span style="font-family: Courier New,Courier,monospace"><SampleName></span> tag: Project type name. Several project types can be created using the same user template.</li>
- <li><span style="font-family: Courier New,Courier,monospace"><SampleVersion></span> tag: Project type version.</li>
- <li><span style="font-family: Courier New,Courier,monospace"><Preview></span> tag: Preview file name.</li>
- <li><span style="font-family: Courier New,Courier,monospace"><Description></span> tag: Description title.</li>
- </ul></td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace">tizen-app-template.xml</span></td>
- <td>This file consists of the following template definition information that is displayed in the Project Wizard:
- <ul>
- <li><span style="font-family: Courier New,Courier,monospace"><template-name></span> tag: User template name.</li>
- <li><span style="font-family: Courier New,Courier,monospace"><widget-type></span> tag: Widget type, which is set as <span style="font-family: Courier New,Courier,monospace">TIZEN</span> by default.</li>
- <li><span style="font-family: Courier New,Courier,monospace"><description-file-name></span> tag: Description file name, which is set as <span style="font-family: Courier New,Courier,monospace">description.xml</span> by default.</li>
- <li><span style="font-family: Courier New,Courier,monospace">icon64</span> and <span style="font-family: Courier New,Courier,monospace">icon32</span> attributes: Icon image file name. The number suffixes refer to the icon size.</li>
- </ul></td>
- </tr>
- </tbody>
- </table>
- <p>To create a new user template from an existing user template (instead of an exporting the template from an existing project):</p>
- <ol>
- <li>Copy and rename the <span style="font-family: Courier New,Courier,monospace"><TIZEN_STUDIO_DATA>/ide/user-templates/web</span> folder. <p>The folder contains a default template layout.</p></li>
- <li>Edit the files within the new folder, or add new files (such as snapshot or icon images and JavaScript and CSS files), as needed.</li>
- </ol>
-
+ </ol>
<script type="text/javascript" src="../../scripts/jquery.zclip.min.js"></script>
<script type="text/javascript" src="../../scripts/showhide.js"></script>
<h1>Running and Debugging Applications</h1>
-<p>You can run your application on the <a href="#emulator">
Emulator</a> or the <a href="#target">target device</a>. You can also run mobile applications on the <a href="#simulator">simulator</a>. Use the <a href="#rds">Rapid Development Support</a> feature to speed up the development tasks. If your application does not run without problems, you can <a href="#debug">debug</a> it.</p>
+<p>You can run your application on the <a href="#emulator">
emulator</a> or the <a href="#target">target device</a>. You can also run mobile applications on the <a href="#simulator">simulator</a>. Use the <a href="#rds">Rapid Development Support</a> feature to speed up the development tasks. If your application does not run without problems, you can <a href="#debug">debug</a> it.</p>
<h2 name="emulator" id="emulator">Running Web Applications on the Emulator</h2>
- <p>You can debug Tizen Web applications on the <a href="../../../../org.tizen.studio/html/common_tools/emulator.htm">Emulator</a> using the <strong>Project Explorer</strong> view or the Tizen Studio menu.</p>
+ <p>You can debug Tizen Web applications on the <a href="../../../../org.tizen.studio/html/common_tools/emulator.htm">emulator</a> using the <strong>Project Explorer</strong> view or the Tizen Studio menu.</p>
- <p>To launch the Emulator, do one of the following:</p>
+ <p>To launch the emulator, do one of the following:</p>
<ul>
<li>Use the <a href="../../../../org.tizen.studio/html/common_tools/emulator_manager.htm">Emulator Manager</a>:
<ol>
<li>Start the Emulator Manager using the Desktop (in Ubuntu) or Start menu (in Windows®), or using the command line.</li>
- <li>In the <strong>Emulator Manager</strong> window, select the Emulator image in the <strong>Name</strong> column. <p>If you are using the Emulator Manager for the first time, you must create an Emulator image. To create an Emulator image, click <strong>Create New</strong>, set the image details, and click <strong>Save</strong>.</p></li>
+ <li>In the <strong>Emulator Manager</strong> window, select the emulator instance from the list. <p>If you are using the Emulator Manager for the first time, you must create an emulator instance: click <strong>Create</strong>, select the platform (system image) and template (device definition), and click <strong>Finish</strong>.</p></li>
<li>Click <strong>Launch</strong>.</li>
</ol> </li>
<li>Use the <a href="../../../../org.tizen.studio/html/common_tools/emulator_features.htm#startup">command line</a>.</li>
</ul>
- <p>To run the application on the Emulator, do one of the following:</p>
+ <p>To run the application on the emulator, do one of the following:</p>
<ul>
<li>In the <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Tizen Web Application</strong>.</li>
<li>In the Tizen Studio menu, go to <strong>Run > Run As > Tizen Web Application</strong>.</li>
<li>On the Tizen Studio toolbar, click <strong>Run</strong>.</li>
</ul>
- <p>To stop the Emulator, right-click the Emulator and click <strong>Close</strong>.</p>
+ <p>To stop the emulator, right-click the emulator and click <strong>Close</strong>.</p>
<table class="note">
<tbody>
<th class="note">Note</th>
</tr>
<tr>
- <td class="note">Running an Emulator image requires a minimum free disk space of 20 MB. The image can occupy up to 10 GB of disk space.</td>
+ <td class="note">Running an emulator instance requires a minimum free disk space of 20 MB. The emulator image can occupy up to 10 GB of disk space.</td>
</tr>
</tbody>
</table>
</ul>
<p class="toc-title">Related Info</p>
<ul class="toc">
- <li><a href="../details/app_filtering_w.htm">Feature Filtering</a></li>
+ <li><a href="../details/app_filtering_w.htm#filter_w">Feature-based Filtering</a></li>
<li><a href="../details/sec_privileges_w.htm">Security and API Privileges</a></li>
</ul>
</div></div>
<div id="container"><div id="contents"><div class="content">
<h1>Setting Project Properties</h1>
- <p>Before you implement the actual application functionality, define all the necessary properties for your application project. To set the application project properties, right-click the project in the Tizen Studio <strong>Project Explorer</strong> view and select <strong>Properties</strong>. After setting or changing a property, click <strong>Apply</strong>.</p>
-
- <p>The settings that you can define in the application project properties include:</p>
- <ul>
- <li><a href="#set">Setting build properties</a></li>
- <li><a href="#set_json">Setting the JSON property</a></li>
- </ul>
-
- <p>You can <a href="#set_widget">set the Web application configuration</a> in the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file.</p>
+ <p>Before you implement the actual application functionality, define all the necessary properties for your application project:</p>
+ <ul>
+ <li>To set the application project properties for <a href="#set">build</a> and <a href="#set_json">JSON properties</a>, right-click the project in the Tizen Studio <strong>Project Explorer</strong> view and select <strong>Properties</strong>. After setting or changing a property, click <strong>OK</strong>.</li>
+<li>To define the <a href="#set_widget">Web application configuration</a>, edit the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file.
<table class="note">
<tbody>
</tr>
</tbody>
</table>
-
+ </li></ul>
<p>After you have finished setting the project properties, you are ready to <a href="app_dev_process_w.htm#design">design the UI</a>.</p>
</ol>
<h2 name="set_widget" id="set_widget">Setting the Web Application Configuration</h2>
- <p>Every application has a <span style="font-family: Courier New,Courier,monospace">config.xml</span> configuration file. The Tizen Studio provides a Web application configuration editor for configuring the application.</p>
- <p>To edit the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file, open it by double-clicking the file in the <strong>Project Explorer</strong> view.</p>
- <p>You can edit Web application properties using the tabs of the Web application configuration editor.</p>
+
+ <p>The Web application configuration consists of application information, such as version, features, and privileges, which are available for the application. To configure the application information in the Web application configuration editor, double-click the application <span style="font-family: Courier New, Courier, monospace">config.xml</span> file in the <strong>Project Explorer</strong> view.</p>
+ <p class="figure">Figure: Setting the application configuration</p>
+ <p align="center"><img alt="Setting the application configuration" src="../../images/tizen_project_explorer_w.png"/></p>
+ <p>You can <a href="../../../../org.tizen.studio/html/web_tools/config_editor_w.htm#edit">edit the application properties using the form tabs of the Web application configuration editor</a>.</p>
<h3 id="overview" name="overview" >Defining and Editing General Information in the Overview Tab</h3>
- <p>You can define and edit general information of the Web application in the <strong>Overview</strong> tab of the Web application configuration editor.</p>
+ <p>You can define and edit general information of the application in the <strong>Overview</strong> tab of the Web application configuration editor.</p>
- <p>The following table lists the Web application properties you can edit in the <strong>Overview</strong> tab.</p>
- <table border="1">
- <caption>
- Table: Web application general information
- </caption>
- <tbody>
- <tr>
- <th>Property</th>
- <th>Description</th>
- </tr>
- <tr>
- <td>Identifier</td>
- <td>Web application identifier</td>
- </tr>
- <tr>
- <td>Version</td>
- <td>Current version of the Web application</td>
- </tr>
- <tr>
- <td>Name</td>
- <td>Web application name that is displayed in an application menu or in other contexts</td>
- </tr>
- <tr>
- <td>Content</td>
- <td>Start-up file of the Web application </td>
- </tr>
- <tr>
- <td>Icon </td>
- <td>Custom icon for the Web application, displayed in the main menu.
- <p>The following icon format and sizes can be used:</p>
+ <p>You can perform the following tasks using the <strong>Overview</strong> tab:</p>
+
+ <ul>
+ <li>View the application identifier.
+ <p>The Tizen Studio creates automatically an application ID, which uniquely identifies the application within the package.</p></li>
+ <li>Set the content.
+ <p>The content represents the start-up file of the Web application.</p></li>
+ <li>Set the application name.
+ <p>The application name is displayed in an application menu or in other contexts.</p></li>
+ <li>Set the version.
+ <p>The format of the current application version is "x.y.z".</p></li>
+ <li>Add an application icon.
+ <p>You can add a launcher icon to your application by defining it in the <strong>Icon</strong> panel.</p>
+ <p>The following table describes the available icon format and size.</p>
<table border="1">
<caption>
- Table: Icon formats and sizes
+ Table: Icon format and size
</caption>
<tbody>
<tr>
</tr>
</tbody>
</table>
- </td>
- </tr>
- </tbody>
- </table>
-
-<h3 id="widget" name="widget">Defining Web Application License Information and UI Preferences in the Widget Tab</h3>
-
- <p>You can define license information and UI preferences of the Web application in the <strong>Widget</strong> tab of the Web application configuration editor.</p>
-
- <p>The following table lists the Web application properties you can edit in the <strong>Widget</strong> tab.</p>
- <table border="1">
- <caption>
- Table: Web application license and UI information
- </caption>
- <tbody>
- <tr>
- <th>Property</th>
- <th>Description</th>
- </tr>
- <tr>
- <td colspan="2"><strong>Managing the Web application</strong></td>
- </tr>
- <tr>
- <td>Author </td>
- <td>Person or organization that created the Web application </td>
- </tr>
- <tr>
- <td>E-mail</td>
- <td>Email address of the author</td>
- </tr>
- <tr>
- <td>Web Site </td>
- <td> IRI associated with the Web application, such as a homepage or a profile on a social network </td>
- </tr>
- <tr>
- <td>License</td>
- <td>Software license, which can include content, such as a usage agreement, redistribution statement, and copyright license terms, under which the content of the Web application package is provided </td>
- </tr>
- <tr>
- <td>License URL</td>
- <td> Valid IRI or path associated with the software or content license </td>
- </tr>
- <tr>
- <td>Description</td>
- <td>Free-form Web application description</td>
- </tr>
- <tr>
- <td colspan="2"><strong>Managing the Web application UI</strong></td>
- </tr>
- <tr>
- <td>Width</td>
- <td> Start-up file viewport width </td>
- </tr>
- <tr>
- <td>Height</td>
- <td>Start-up file viewport height</td>
- </tr>
- <tr>
- <td>View Modes</td>
- <td> Preferred view mode (maximized fullscreen)</td>
- </tr>
- </tbody>
- </table>
+ </li>
+ <li>Define the application author, license, and description in the <strong>Managing the Application</strong> section:
+ <ul><li><strong>Author</strong> field represents the person or organization that created the Web application.</li>
+ <li><strong>E-mail</strong> field represents the email address of the author.</li>
+ <li><strong>Web Site</strong> field represents the IRI associated with the Web application, such as a homepage or a profile on a social network.</li>
+ <li><strong>License</strong> field represents the software license, which can include content, such as a usage agreement, redistribution statement, and copyright license terms, under which the content of the Web application package is provided.</li>
+ <li><strong>License URL</strong> field represents the valid IRI or path associated with the software or content license.</li>
+ <li><strong>Description</strong> field represents the human-readable description of the Tizen Web application package.</li>
+ </ul>
+</li>
+ <li>Define the UI preferences of the application in the <strong>Managing the Application UI</strong> section:
+ <ul><li><strong>Width</strong> field represents the start-up file viewport width.</li>
+ <li><strong>Height</strong> field represents the start-up file viewport height.</li>
+ <li><strong>View Modes</strong> field represents the preferred view mode (maximized fullscreen).</li>
+ </ul>
+</li>
+</ul>
<h3 id="feature" name="feature">Declaring Required Software or Hardware Features in the Features Tab</h3>
- <p>You can declare required software or hardware features. This declaration can be used for <a href="../details/app_filtering_w.htm">application filtering in the Tizen Store</a>.</p>
+ <p>You can declare any device software or hardware features that your application requires to run properly. The declaration can be used for application filtering in the Tizen Store.</p>
<p>To enable filtering for your Web application:</p>
<ol>
- <li>In the <strong>Features</strong> tab of the Web application configuration editor, click <strong>Add</strong>.</li>
- <li>Select
a feature from the <a href="../details/app_filtering_w.htm">predefined list of features available for filtering</a>.</li>
- <li>Click <strong>Save</strong>.</li>
+ <li>In the <strong>Features</strong> tab, click <strong>+</strong>.</li>
+ <li>Select
the needed features from the <a href="../details/app_filtering_w.htm">predefined list of features available for filtering</a>.</li>
+ <li>Click <strong>Finish</strong>.</li>
<li>Upload and publish the application package on the Tizen Store.
<p>If a Tizen-powered device requests applications, the store displays a list containing only applications compatible with the user's device.</p>
</li>
</ol>
- <p>After setting the feature information with the Web application configuration editor, you can see the added code in the <strong>Source</strong> tab.</p>
-
- <p> The following example shows the setting in the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file code:</p>
+ <p>After saving the feature information with the Web application configuration editor, you can see the added code in the <strong>Source</strong> tab:</p>
<pre class="prettyprint">
-<tizen:feature name="http://tizen.org/feature/network.nfc"/>
+<feature name="http://tizen.org/feature/network.nfc"/>
</pre>
-<h3 id="privilege" name="privilege">Specifying Privileges in the Privilege Tab</h3>
+<h3 id="privilege" name="privilege">Specifying Privileges in the Privileges Tab</h3>
- <p>You can <a href="../details/sec_privileges_w.htm">use features and services provided by privileged APIs</a>, which handle platform and user-sensitive data. You can specify an API, or API groups, accessed and used by the Web application in the <strong>Privilege</strong> tab of the Web application configuration editor. The tab serves as a standardized tool to request the binding of an IRI-identifiable runtime component for a Web application to use at runtime.</p>
+ <p>You can use features and services provided by privileged APIs, which handle platform and user-sensitive data. You can specify an API, or API groups, accessed and used by the Web application in the <strong>Privileges</strong> tab of the Web application configuration editor. The tab serves as a standardized tool to request the binding of an IRI-identifiable runtime component for a Web application to use at runtime.</p>
<p>To add a privilege:</p>
<ol>
- <li>In the <strong>Privilege</strong> tab of the Web application configuration editor, click <strong>Add</strong>.</li>
+ <li>In the <strong>Privileges</strong> tab, click <strong>+</strong>.</li>
<li>In the <strong>Add privilege</strong> window, select an option:
<ul>
- <li><strong>Internal</strong>: Select a privilege from the <a href="../details/sec_privileges_w.htm">predefined list of API privileges</a>.
- <p>You can select multiple privileges by holding the <strong>CTRL</strong> key.</p></li>
+ <li><strong>Internal</strong>: Select the needed privileges from the <a href="../details/sec_privileges_w.htm">predefined list of API privileges</a>.</li>
<li><strong>Privilege name</strong>: Manually enter the URL containing a privilege definition.</li>
<li><strong>File</strong>: Click <strong>Browse</strong> and select a privilege file (with the <span style="font-family: Courier New,Courier,monospace">.xml</span> or <span style="font-family: Courier New,Courier,monospace">.widlprocxml</span> extension).</li>
</ul> </li>
<li>Click <strong>Finish</strong>.</li>
</ol>
- <p>After setting the privilege information with the Web application configuration editor, you can see the added code in the <strong>Source</strong> tab.</p>
- <p>The following example shows the setting in the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file code:</p>
+ <p>After saving the privilege information with the Web application configuration editor, you can see the added code in the <strong>Source</strong> tab:</p>
<pre class="prettyprint"><tizen:privilege name="http://tizen.org/privilege/application.launch"/></pre>
<h3 id="policy" name="policy">Defining External Access Policies in the Policy Tab</h3>
<th>Description</th>
</tr>
<tr>
- <td>content-security-policy</td>
+ <td><strong>content-security-policy</strong></td>
<td>Used to define an additional content security policy for a packaged or hosted application. The policy string is defined according to <a href="http://www.w3.org/TR/CSP/" target="_blank">http://www.w3.org/TR/CSP/ (v1.0)</a>.
- <p>The following example shows the setting in the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file code:</p>
- <pre class="prettyprint"><tizen:content-security-policy>
- script-src 'self'
-</tizen:content-security-policy></pre>
</td>
</tr>
<tr>
- <td>content-security-policy-report-only</td>
+ <td><strong>content-security-policy-report-only</strong></td>
<td>Used to define an additional content security policy for a packaged or hosted application (for monitoring purposes only).
-<p>The following example shows the setting in the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file code:</p>
-<pre class="prettyprint"><tizen:content-security-policy-report-only>
- script-src 'self';
- report-uri="http://example.com/report.cgi"
-</tizen:content-security-policy-report-only></pre>
</td>
</tr>
<tr>
- <td>allow-navigation</td>
+ <td><strong>allow-navigation</strong></td>
<td>Used to define a list of URL domains allowed for the Web application.
<p>This attribute is optional.</p>
-<p>The following example shows the setting in the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file code:</p>
-<pre class="prettyprint"><tizen:allow-navigation>
- tizen.org *.tizen.org
-<tizen:allow-navigation/></pre>
</td>
</tr>
<tr>
- <td>access</td>
+ <td><strong>Access</strong></td>
<td>Used to define network resource permissions.
- <p>To request network resource permissions, click <strong>Add</strong> and enter the resource URLs in the <strong>Network URL</strong> column. You can allow the Web application to access the URL sub-domains by setting the <strong>Allow subdomain</strong> column value as <span style="font-family: Courier New,Courier,monospace">true</span>.</p>
- <p>The following example shows the setting in the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file code:</p>
- <pre class="prettyprint">
-<access origin="http://www.tizen.org" subdomains="true"/></pre> </td>
+ <p>To request network resource permissions, click <strong>+</strong> and enter the resource URLs in the <strong>Network URL</strong> column. You can allow the Web application to access the URL sub-domains by setting the <strong>Allow subdomain</strong> column value as <strong>true</strong>.</p>
+ </td>
</tr>
</tbody>
</table>
- <p>After setting the policy information with the Web application configuration editor, you can see the added code in the <strong>Source</strong> tab.</p>
+ <p>After setting the policy information with the Web application configuration editor, you can see the added code in the <strong>Source</strong> tab:</p>
+ <pre class="prettyprint">
+<access origin="http://www.tizen.org" subdomains="true"/>
+<tizen:allow-navigation>tizen.org *.tizen.org<tizen:allow-navigation/>
+<tizen:content-security-policy>script-src 'self'</tizen:content-security-policy>
+<tizen:content-security-policy-report-only>script-src 'self';</tizen:content-security-policy-report-only></pre>
-<h3 id="localization" name="localization">Setting the Supported Locales in the Localization Tab</h3>
+<h3 id="localization" name="localization">Adding Localized Application Details in the Localization Tab</h3>
- <p>You can provide localization support for the application name, description, and license elements in the <strong>Localization</strong> tab of the Web application configuration editor.</p>
+ <p>You can provide localized versions of the application name, description, and license in the <strong>Localization</strong> tab of the Web application configuration editor.</p>
-<p>To add localization:</p>
-<ol><li>In the <strong>Name</strong> panel, click <strong>Add</strong>.
-<p>Select a language and enter your name.</p>
+<p>To add a localized name, description, or license:</p>
+<ul><li>In the <strong>Name</strong> panel, click <strong>+</strong>. Select the language, define the application name for that language, and click <strong>OK</strong>.
<p>The following example shows the setting in the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file:</p>
<pre class="prettyprint">
<name xml:lang="en-gb">Lee</name>
</pre></li>
-<li>In the <strong>Description</strong> panel, click <strong>Add</strong>.
-<p>Select a language and enter the description of the Web application.</p>
+<li>In the <strong>Description</strong> panel, click <strong>+</strong>. Select the language, define the application description for that language, and click <strong>OK</strong>.
<p>The following example shows the setting in the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file:</p>
<pre class="prettyprint">
<description xml:lang="en-gb">Widget</description>
</pre></li>
-<li>In the <strong>License</strong> panel, click <strong>Add</strong>.
-<p>Select a language and manually enter the license and license URI.</p>
+<li>In the <strong>License</strong> panel, click <strong>+</strong>. Select a language, define the license and license URI for that language, and click <strong>OK</strong>.
<p>The following example shows the setting in the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file code:</p>
<pre class="prettyprint">
<license xml:lang="en-gb" href=" http://www.apache.org/licenses/LICENSE-2.0.html">
Apache License, Version 2.0
</license>
</pre> </li>
-</ol>
- <p>After setting the localization information with the Web application configuration editor, you can see the added code in the <strong>Source</strong> tab.</p>
-
-<p>You can localize a Web application to adapt to various languages and cultural environments by creating different Web application versions for different languages.</p>
-<p>To localize a Web application:</p>
-<ol>
- <li>Launch the Localization Wizard by doing one of the following:
- <ul>
- <li>In the <strong>Project Explorer</strong> view, right-click the Web application and select <strong>Localization > Localization Wizard</strong>.</li>
- <li>In the Tizen Studio menu, go to <strong>Project > Localization > Localization Wizard</strong>.</li>
- </ul>
- </li>
- <li>In the <strong>Localization Wizard</strong> view, select the files to localize from the list of files and click <strong>Next</strong>. <p>The files that are already localized are grayed out.</p></li>
- <li>In the <strong>Available locales</strong> list, select the locales and add them to the <strong>Selected locales</strong> list. Click <strong>Next</strong>. <p>The locales that are already supported are grayed out.</p></li>
- <li>Associate the selected files with the specified locales by selecting the check boxes under the desired locale column. <p>The check boxes for files that are already localized for a particular locale are grayed out.</p></li>
- <li>Click <strong>Finish</strong>. <p>In the <strong>Project Explorer</strong> view, a new <span style="font-family: Courier New,Courier,monospace">locales</span> folder is created containing separate sub-folders for each locale. The sub-folders contain a copy of the selected files. Use that copy to create a localized version of the file.</p></li>
-</ol>
-<p class="figure">Figure: Locale folders</p>
-<p align="center"><img alt="Locale folders" src="../../images/localize_widget.png" style="display: block; text-align: center; margin-left: auto; margin-right: auto" /></p>
+</ul>
+<p>You can localize a Web application to adapt to various languages and cultural environments by creating different Web application versions for different languages. For more information see <a href="../../../../org.tizen.studio/html/web_tools/web_localization_w.htm">Localizing Web Applications</a>.</p>
<h3 id="preferences" name="preferences">Declaring Name-value Pairs in the Preferences Tab</h3>
<p>You can declare name-value pairs which can be set and retrieved using the Widget Interface API (in <a href="../../../../org.tizen.web.apireference/html/w3c_api/w3c_api_m.html#widget">mobile</a> or <a href="../../../../org.tizen.web.apireference/html/w3c_api/w3c_api_w.html#widget">wearable</a> applications) in the <strong>Preferences</strong> tab of the Web application configuration editor. These name-value pairs, or preferences, are used by the Web application during execution.</p>
- <p>To add preferences, click <strong>Add</strong> and enter values in the <strong>Name</strong> and <strong>Value</strong> columns. You can set a preference as read-only by setting the <strong>Read-only</strong> column value as <span style="font-family: Courier New,Courier,monospace">true</span>.</p>
- <p>After setting the preference information with the Web application configuration editor, you can see the added code in the <strong>Source</strong> tab.</p>
- <p>The following example shows the setting in the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file code:</p>
+ <p>To add preferences, click <strong>+</strong>. A new row appears in the table. Enter values in the <strong>Name</strong> and <strong>Value</strong> columns. You can set a preference as read-only by setting the <strong>Read-only</strong> column value as <strong>true</strong>.</p>
+ <p>After saving the preference information with the Web application configuration editor, you can see the added code in the <strong>Source</strong> tab:</p>
<pre class="prettyprint">
<preference name="key" value="value" readonly="false"/>
</pre>
</caption>
<tbody>
<tr>
- <th>Property</th>
+ <th colspan="2">Property</th>
<th>Description</th>
</tr>
<tr>
- <td colspan="2"><strong>application</strong></td>
- </tr>
- <tr>
- <td>ID</td>
+ <td rowspan="4"><strong>Application</strong></td>
+ <td><strong>ID</strong></td>
<td>Tizen application ID, which is randomly created from the Tizen package ID and project name.
<p>This attribute is mandatory.</p></td>
</tr>
- <tr>
- <td>Package</td>
- <td>10-character alphanumeric value used to identify a Tizen application package and automatically assigned by the Tizen Studio.
- <p>This attribute is mandatory.</p></td>
- </tr>
<tr>
- <td>Required version</td>
+ <td><strong>Required Version</strong></td>
<td>Indicates the minimum API version that the Web application supports.
<p>This attribute is mandatory and must be a float value, such as 1.0 or 2.0.</p></td>
</tr>
- <tr>
- <td colspan="2"><strong>content</strong></td>
+ <tr>
+ <td><strong>Launch Mode</strong></td>
+ <td>Indicates whether the application is launched as a main (single) or sub application, or whether a caller application defines the launch mode when the application is launched by an application control request.
+ <p>This attribute is optional. The default value is <strong>single</strong>.</p></td>
+ </tr>
+ <tr>
+ <td><strong>Ambient Support</strong></td>
+ <td>Indicates whether the Web application supports the ambient mode.
+ <p>This attribute is optional and used <strong>in wearable applications only</strong>. The default value is <strong>disable</strong>.</p></td>
</tr>
<tr>
- <td>src</td>
+ <td><strong>Content</strong></td>
+ <td><strong>Src</strong></td>
<td>In Widget Packaging and XML Configuration, the Web application start page is a document within the Web application package. The Tizen WRT allows the start page to be hosted on an external server.
- <p>The <span style="font-family: Courier New,Courier,monospace"><tizen:content /></span> element is used to point to the relevant document.</p> </td>
- </tr>
- <tr>
- <td colspan="2"><strong>setting</strong></td>
+ <p>If the start page is on an external server, this attribute points to it.</p></td>
</tr>
<tr>
- <td>screen-orientation</td>
- <td>Used to set the application screen orientation to landscape or portrait mode, or auto-rotation.
- <p>This attribute is optional. The default mode is <strong>portrait</strong>.</p> </td>
+ <td rowspan="6"><strong>Setting</strong></td>
+ <td><strong>Screen Orientation</strong></td>
+ <td>Sets the application screen orientation to landscape or portrait mode, or auto-rotation.
+ <p>This attribute is optional. The default value is <strong>portrait</strong>.</p> </td>
</tr>
<tr>
- <td>context-menu</td>
- <td>Used to set the Web application support for context menus.
+ <td><strong>Context Menu</strong></td>
+ <td>Sets the Web application support for context menus.
<p>This attribute is optional. The default value is <strong>enable</strong>.</p> </td>
</tr>
<tr>
- <td>background-support</td>
- <td>Used to define whether the execution of the Web application continues when the application is sent to the background.
+ <td><strong>Background Support</strong></td>
+ <td>Defines whether the execution of the Web application continues when the application is sent to the background.
<p>This attribute is optional. The default value is <strong>disable</strong>.</p> </td>
</tr>
<tr>
- <td>encryption</td>
- <td>Used to set the encryption of application resources (<span style="font-family: Courier New,Courier,monospace">JS/CSS/HTML</span> files).
+ <td><strong>Encryption</strong></td>
+ <td>Sets the encryption of application resources (JS, CSS, and HTML files).
<p>This attribute is optional. The default mode is <strong>disable</strong>.</p> </td>
</tr>
<tr>
- <td>install-location</td>
- <td>Used to set the installation location, for example, the SD card.
+ <td><strong>Install Location</strong></td>
+ <td>Sets the installation location, for example, the SD card.
<p>This attribute is optional. The default mode is <strong>auto</strong>.</p> </td>
</tr>
<tr>
- <td>hwkey-event</td>
- <td>Used to set the support for the hardware key.
+ <td><strong>HW Key Event</strong></td>
+ <td>Sets the support for the hardware key.
<p>This attribute is optional. The default mode is <strong>enable</strong>.</p> </td>
</tr>
<tr>
- <td><strong>app-control</strong></td>
- <td>Describes the <a href="../../../../org.tizen.guides/html/web/app_management/app_controls_w.htm">application control functionalities</a> provided by the application. The <strong>operation</strong>, <strong>uri</strong>, and <strong>mime</strong> fields describe the functionalities that other applications can request and the <strong>src</strong> field describes the application page that handles the request. <p>The following example shows the setting in the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file code:</p> <pre class="prettyprint">
+ <td colspan="2"><strong>Application Control</strong></td>
+ <td>Describes the <a href="../../../../org.tizen.guides/html/web/app_management/app_controls_w.htm">application control functionalities</a> provided by the application. To define an application control used to access the functionality of your application, click <strong>+</strong> in the <strong>Application Control</strong> panel and define the details.
+ <p>The <strong>operation</strong>, <strong>uri</strong>, and <strong>mime</strong> fields describe the functionalities that other applications can request and the <strong>src</strong> field describes the application page that handles the request.</p> <p>The following example shows the setting in the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file code:</p> <pre class="prettyprint">
<tizen:app-control>
<tizen:src name="edit.html"/>
<tizen:operation name="http://tizen.org/appcontrol/operation/edit"/>
<tizen:uri name="file"/>
<tizen:mime name="image/jpeg"/>
</tizen:app-control></pre> </td>
- </tr>
+ </tr>
<tr>
- <td colspan="2"><strong>account</strong></td>
- </tr>
+ <td rowspan="6"><strong>Account</strong></td>
+ <td></td>
+ <td>To register an account provider, click <strong>+</strong> in the <strong>Account</strong> section and define the account provider information.</td>
+ </tr>
<tr>
- <td>Display name</td>
- <td>Used to define the display name of the account provider.
+ <td><strong>Display name</strong></td>
+ <td>Used to define the localized display name of the account provider.
+ <p>To add a localized name, click <strong>Add</strong> in the <strong>Display name</strong> panel, select the language, define the display name for that language, and click <strong>OK</strong>.</p>
<p>This attribute is mandatory.</p></td>
</tr>
<tr>
- <td>Multiple account</td>
+ <td><strong>Multiple account</strong></td>
<td>Indicates whether multiple accounts are supported.
<p>This attribute is mandatory.</p></td>
</tr>
<tr>
- <td>Icon</td>
+ <td><strong>Icon</strong></td>
<td>Used to define the path of the icon representing the account provider. The icon image is used by account settings and must be placed in a shared directory. The size is 72 x 72.
<p>This attribute is mandatory.</p></td>
</tr>
<tr>
- <td>Small icon</td>
+ <td><strong>Small icon</strong></td>
<td>Used to define the path of the small icon representing the account provider. The icon image is used by account settings and must be placed in a shared directory. The size is 45 x 45.
<p>This attribute is mandatory.</p></td>
</tr>
<tr>
- <td>Capabilities</td>
+ <td><strong>Capabilities</strong></td>
<td>The capabilities of the account provider defined in the IRI format:
<p><span style="font-family: Courier New,Courier,monospace">http://<vendor information>/accounts/capability/<name></span></p>
<p>The following predefined capabilities can be used:</p>
<li><span style="font-family: Courier New,Courier,monospace">http://tizen.org/account/capability/calendar</span>
<p>Used when the account is related to calendar.</p></li>
</ul>
+ <p>To add a capability, click an empty row in the <strong>Capabilities</strong> panel table and select a capability you need.</p>
<p>This attribute is optional.</p></td>
</tr>
<tr>
- <td colspan="2"><strong>metadata</strong></td>
- </tr>
+ <td colspan="2"><strong>Background Category</strong></td>
+ <td>Defines the background category type (since Tizen 2.4). <p>To add background category types to allow running on the background, click <strong>+</strong> in the <strong>Background Category</strong> section, select the category type, and click <strong>OK</strong>.</p></td>
+ </tr>
<tr>
- <td>key</td>
- <td>Used to define metadata that can be accessed (read-only) through the Tizen Application API:
+ <td colspan="2"><strong>Meta Data</strong></td>
+ <td>Defines key-value pairs that can be accessed (read-only) through the Application API (in <a href="../../../../org.tizen.web.apireference/html/device_api/mobile/tizen/application.html">mobile</a> and <a href="../../../../org.tizen.web.apireference/html/device_api/wearable/tizen/application.html">wearable</a> applications).
+ <p>To add a key-value pair, click <strong>+</strong> in the <strong>Meta Data</strong> section, define a key (unique string) and value (string), and click <strong>OK</strong>. This attribute is optional.</p>
+ <p>The following example shows the setting in the <span style="font-family: Courier New,Courier,monospace">config.xml</span> file code:</p>
<pre class="prettyprint">
<tizen:metadata key="key1"/>
<tizen:metadata key="key2" value="value"/>
</pre>
- <p>This attribute is optional. The value must be a unique string.</p></td>
+ </td>
</tr>
<tr>
- <td>value</td>
- <td>Used to define metadata that can be accessed (read-only) through the Tizen Application API.
-<p>This attribute is optional. The value must be a string.</p></td>
+ <td colspan="2"><strong>Category</strong></td>
+ <td>Defines the categories to which a service application belongs.
+ <p>To add a category, click <strong>+</strong> in the <strong>Category</strong> section, select the category, and click <strong>OK</strong>. This attribute is optional and used <strong>in wearable applications only</strong>.</p>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2"><strong>Service</strong></td>
+ <td>Defines service application-specific settings.
+ <p>To define the setting values, click <strong>+</strong> in the <strong>Service</strong> section, and define the values. For more information on the values, see <a href="../../../../org.tizen.studio/html/web_tools/config_editor_w.htm#ww_service">Tizen Service</a>.</p>
+ </td>
+ </tr>
+ <tr>
+ <td colspan="2"><strong>Web Widget</strong></td>
+ <td>Defines widget application-specific settings.
+ <p>To edit the setting values, select the row in the <strong>Web Widget</strong> section table, click the <strong>Edit</strong> icon (shaped like a pen), and define the values. For more information on the values, see <a href="../../../../org.tizen.studio/html/web_tools/config_editor_w.htm#ww_webwidget">Tizen Web Widget</a>.</p>
+ </td>
</tr>
</tbody>
</table>
<th class="note">Note</th>
</tr>
<tr>
- <td class="note">The <span style="font-family: Courier New,Courier,monospace">config.xml</span> must conform not only to the XML file format but also to the W3C specification requirements. Editing the configuration file in XML format is intended for advanced users only.</td>
+ <td class="note">The <span style="font-family: Courier New,Courier,monospace">config.xml</span> must conform not only to the XML file format but also to the W3C specification requirements. If you edit application information manually in the <span style="font-family: Courier New, Courier, monospace">config.xml</span> file source code, you can introduce errors preventing the application from running normally.</td>
</tr>
</tbody>
</table>
<p>When you are developing a more complex application, you can take advantage of the <a href="../../../../org.tizen.studio/html/web_tools/cover_web_w.htm">Web tools included in the Tizen Studio</a> to ease the tasks of creating functionality and designing the application UI.</p>
-<p><strong>Updating 2.3.1 Wearable Packages</strong></p>
-
-<p>To develop wearable applications in the latest Tizen SDK, you must install the 2.3.1 wearable packages separately:</p>
-
-<ol>
-<li>Launch the Update Manager by going to <strong>Start > All Programs > Tizen SDK-<version> > Update Manager-<version></strong>.</li>
-<li>In the <strong>All Packages</strong> tab, download all packages for <strong>2.3.1 Wearable</strong>.
-<p align="center"><img alt="Download packages" src="../../images/first_app_download_wn.png" /></p></li>
-</ol>
-
<h2 id="create">Creating a Project</h2>
<p>The following example shows you how to create and configure a basic wearable Web application project in the Tizen Studio. An application project contains all the files that make up an application.</p>
<li><p>Launch the Tizen Studio.</p></li>
<li>
-<p>Make sure the <strong>Tizen Web</strong> perspective is selected in the top right corner of the Tizen Studio window. </p>
+<p>Make sure the <strong>Web</strong> perspective is selected in the top right corner of the Tizen Studio window. </p>
<p align="center"><img alt="Checking the perspective" src="../../images/change_perspective_w.png" /></p>
-<p>If not, select it. If the perspective is not visible, in the Tizen Studio menu, select <strong>Window > Open Perspective > Other > Tizen Web</strong>, and click <strong>OK</strong>.</p>
+<p>If not, select it. If the perspective is not visible, in the Tizen Studio menu, select <strong>Window > Perspective > Open Perspective > Other > Web</strong>, and click <strong>OK</strong>.</p>
</li>
<li>
-<p>In the Tizen Studio menu, select <strong>File > New > Tizen Web Project</strong>.</p>
+<p>In the Tizen Studio menu, select <strong>File > New > Tizen Project</strong>.</p>
<p align="center"><img alt="Creating a new Tizen Web project" src="../../images/create_project_1_w.png" /></p>
<p>The Project Wizard opens.</p>
</li>
<p>In the Project Wizard, define the project details.</p>
<p>The Project Wizard is used to create the basic application skeleton with the required folder structure and mandatory files. You can easily create different applications by selecting an applicable template or sample for the Project Wizard to use.</p>
<ol type="a">
-<li><p>Select the <strong>Template</strong> tab and the <strong>WEARABLE-[version] > Basic</strong> template. The version depends on the SDK version you have installed and with which you are developing the application.</p></li>
-<li><p>Change the project name, if you want.</p></li>
-<li><p>Leave all other fields in the Project Wizard to their default values, and click <strong>Finish</strong>.</p></li>
+<li><p>Select the <strong>Template</strong> project type and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the project type" src="../../images/create_project_wizard_type.png" /></p>
+</li>
+<li><p>Select the profile (<strong>Wearable</strong>) and version from a drop-down list and click <strong>Next</strong>.</p>
+<p>The version depends on the platform version you have installed and with which you are developing the application.</p>
+<p align="center"><img alt="Selecting the profile and version" src="../../images/create_project_wizard_version_wearable.png" /></p>
+</li>
+<li><p>Select the <strong>Web Application</strong> application type and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the application type" src="../../images/create_project_wizard_app_web_wearable.png" /></p>
+</li>
+<li><p>Select the <strong>Basic UI</strong> template and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the template" src="../../images/create_project_wizard_template_ww.png" /></p>
+</li>
+<li><p>Define the project properties and click <strong>Finish</strong>.</p>
+<p>You can fill the project name (3-50 characters) and the unique package ID. You can also select the location and working sets by clicking <strong>More properties</strong>.</p>
+<p align="center"><img alt="Defining properties" src="../../images/create_project_wizard_properties_ww.png" /></p>
+
+<p>The Project Wizard sets up the project, creates the application files using the default content from the template, and closes. For more information about the Project Wizard and the available templates, see <a href="../../../../org.tizen.studio/html/web_tools/project_wizard_w.htm">Creating Tizen Projects with Tizen Project Wizard</a>.</p></li>
</ol>
-<p align="center"><img alt="Defining the project details" src="../../images/create_project_2_ww.png" /></p>
-<p>The Project Wizard sets up the project, creates the application files using the default content from the template, and closes. For more information about the Project Wizard and the available templates, see <a href="../../../../org.tizen.studio/html/web_tools/project_wizard_w.htm">Creating Tizen Projects with Tizen Project Wizard</a>.</p>
</li>
</ol>
<p align="center"><img alt="Configuring the application" src="../../images/basic_app_config_w.png" /></p>
<ul>
<li><p><strong>Overview</strong>: Define general information, such as the name and icon of the application.</p></li>
-<li><p><strong>Widget</strong>: Define author and license information and UI preferences.</p></li>
<li><p><strong>Features</strong>: Define required software and hardware features. This information is used for application filtering in the Tizen market place.</p></li>
<li><p><strong>Privileges</strong>: Define the security-sensitive APIs or API groups accessed and used by the application.</p></li>
<li><p><strong>Policy</strong>: Request network resource permissions to access external network resources.</p></li>
<th class="note">Note</th>
</tr>
<tr>
- <td class="note">The <span style="font-family: Courier New,Courier,monospace">config.xml</span> file must conform to both the XML file format and the W3C specification requirements. Editing the file in the source code view is intended for advanced users only.</td>
+ <td class="note">The <span style="font-family: Courier New,Courier,monospace">config.xml</span> file must conform to both the XML file format and the W3C specification requirements. Editing the file in the <strong>Source</strong> tab is intended for advanced users only.</td>
</tr>
</tbody>
</table>
</ul>
</li>
-<li><p>To save any changes, in the Tizen Studio menu, select <strong>File > Save</strong>.</p></li>
+<li><p>To save any changes, in the Tizen Studio menu, select <strong>File > Save All</strong>.</p></li>
</ol>
<ol>
<li>Select the project in the <strong>Project Explorer</strong> view.</li>
<li>In the Tizen Studio menu, select <strong>Project > Build Automatically</strong>.
-<p align="center"><img alt="Using the automatic build" src="../../images/build_automatic_w.png" /></p>
+<p align="center"><img alt="Using the automatic build" src="../../images/build_automatic_ww.png" /></p>
<p>A check mark appears next to the menu option.</p></li>
</ol>
<li>In the <strong>Connection Explorer</strong> view, launch the Emulator Manager by clicking the related icon.
<p align="center"><img src="../../images/emulator_icon.png" alt="Emulator manager icon" /></p>
</li>
-
-<li>In the Emulator Manager, open the <strong>Create New Emulator</strong> drop-down list and select <strong>wearable</strong>.
-<p align="center"><img src="../../images/emulator_new_wearable.png" alt="Emulator manager" /></p>
+<li>In the Emulator Manager, click <strong>Create</strong>.
+<p align="center"><img src="../../images/emulator_instance_create.png" alt="Creating an emulator instance" /></p>
</li>
-
-<li>Modify the emulator options, and click <strong>Confirm</strong>.
+<li>Select the applicable platform (in this case, <strong>wearable-2.3.2-circle (basic)</strong>), and click <strong>Next</strong>.
+<p align="center"><img src="../../images/emulator_instance_platform_wearable.png" alt="Selecting the platform" /></p>
+</li>
+<li>Select the device definition along with the platform version (in this case, <strong>Wearable Circle</strong>), and click <strong>Next</strong>.
+<p align="center"><img src="../../images/emulator_instance_version_wearable.png" alt="Selecting the platform version" /></p>
+</li>
+<li>Define the emulator properties, and click <strong>Finish</strong>.
<p>You can leave the options to their default values.</p>
-<p align="center"><img src="../../images/emulator_settings_wearable.png" alt="Emulator options" /></p>
+<p align="center"><img src="../../images/emulator_instance_properties_wearable.png" alt="Defining the properties" /></p>
</li>
+<li>To launch the emulator instance, select the emulator from the list and click <strong>Launch</strong>.
+<p align="center"><img src="../../images/emulator_instance_launch_wearable.png" alt="Launching the emulator" /></p>
-<li>To launch the emulator instance, select the emulator from the list and click the play icon.
-<p align="center"><img src="../../images/emulator_launch_wearable.png" alt="Launch the emulator" /></p>
-
-<p>The emulator is launched in its own window.</p>
-<p>You can also see the new emulator instance in the <strong>Connection Explorer</strong> view. To view the emulator folder structure, click the arrow next to the emulator instance.</p>
+<p>The emulator is launched in its own window. You can also see the new emulator instance in the <strong>Connection Explorer</strong> view. To view the emulator folder structure, click the arrow next to the emulator instance.</p>
<p align="center"><img src="../../images/emulator_window_wearable.png" alt="Emulator" /></p>
</li>
</ol>
</li>
<li>Generate a security profile.
- <p>Before you run the application, you must sign your application package by <a href="https://developer.tizen.org/community/tip-tech/issuing-tizen-certificate-certificate-extension-ver-1.2#emulator" target="_blank">generating an author certificate and registering it</a> in the Tizen Studio.</p>
+ <p>Before you run the application, you must <a href="../../../../org.tizen.studio/html/common_tools/certificate_registration.htm">sign your application package with a certificate profile</a> in the Tizen Studio.</p>
</li>
<li>Run the application:
<ol type="a">
<li>In the <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Tizen Web Application</strong>.
-<p align="center"><img src="../../images/app_run_ww.png" alt="Run the application" /></p>
+<p align="center"><img src="../../images/app_run_ww.png" alt="Running the application" /></p>
<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and do one of the following:</p>
<ul><li>Press the <strong>Ctrl+F11</strong> key.</li>
-<li>Click the play icon (<img src="../../images/emulator_play.png" alt="Play icon" />) in the toolbar.</li></ul>
+<li>Click the run icon in the toolbar.</li></ul>
+
+<p>If you have created multiple emulator instances, select the instance you want from the combo box in the toolbar before selecting to run the application. If you select an offline emulator, it is automatically launched when you select to run the application.</p>
+
+<p align="center"><img src="../../images/app_run_multiple_emulators.png" alt="Selecting the emulator to use" /></p>
</li>
<li>Confirm that the application launches on the emulator.
</li>
</ol>
-<p>For more information on using the emulator features, see <a href="../../../../org.tizen.studio/html/common_tools/emulator_control_panel.htm">
Emulator Control Keys and Menu</a> and <a href="../../../../org.tizen.studio/html/common_tools/emulator_features.htm">Using Extended Emulator Features</a>.</p>
+<p>For more information on using the emulator features, see <a href="../../../../org.tizen.studio/html/common_tools/emulator_control_panel.htm">
Using Emulator Control Keys, Menu, and Panel</a> and <a href="../../../../org.tizen.studio/html/common_tools/emulator_features.htm">Using Extended Emulator Features</a>.</p>
<h3 id="target">Running on a Target Device</h3>
<li>In the <strong>Connection Explorer</strong> view, launch the Remote Device Manager by clicking the related icon.
<p align="center"><img src="../../images/remote_conn_mgr_ww.png" alt="Launch the Remote Device Manager" /></p>
</li>
-<li>In the <strong>Remote Device Manager</strong> window, click <strong>New</strong>.
+<li>In the <strong>Remote Device Manager</strong> window, click <strong>+</strong>.
<p align="center"><img src="../../images/remote_conn_new_ww.png" alt="Add new device" /></p>
</li>
<li>In the <strong>Add Device</strong> window, enter the device and network details (use the IP address you noted before), and click <strong>Add</strong>.
</ol>
</li>
<li>Generate an author certificate.
-<p>Before you run the application, you must sign your application package by <a href="https://developer.tizen.org/community/tip-tech/issuing-tizen-certificate-certificate-extension-ver-1.2#CommercialDevices" target="_blank">generating an author certificate and registering it</a> in the Tizen Studio.</p>
+<p>Before you run the application, you must <a href="../../../../org.tizen.studio/html/common_tools/certificate_registration.htm">sign your application package with a certificate profile</a> in the Tizen Studio.</p>
</li>
<li>Run the application:
<ol type="a">
<li>In the <strong>Connection Explorer</strong> view, select the device.</li>
<li>In <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Tizen Web Application</strong>.
-<p align="center"><img src="../../images/app_run_ww.png" alt="Run the application on a target device" /></p>
+<p align="center"><img src="../../images/app_run_ww.png" alt="Running the application on a target device" /></p>
<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and do one of the following:</p>
<ul><li>Press the <strong>Ctrl+F11</strong> key.</li>
-<li>Click the play icon (<img src="../../images/emulator_play.png" alt="Play icon" />) in the toolbar.</li></ul>
+<li>Click the run icon in the toolbar.</li></ul>
+
+<p>If you have both a connected device and existing emulator instances, select the device from the combo box in the toolbar before selecting to run the application.</p>
+
+<p align="center"><img src="../../images/app_run_multiple_emulators.png" alt="Selecting the device to use" /></p>
</li>
<li>Confirm that the application launches in the target device.</li>
<td class="note">The application is launched using the default debug run configuration. To create and use another configuration:
<ol>
<li>In the <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Run Configurations</strong>.</li>
- <li>In the <strong>Run Configurations</strong> window, click the <strong>New Launch Configuration</strong> icon (<img alt="New Launch Configuration" src="../../images/run_new_config_wn.png" />), define the configuration details, and launch the application by clicking <strong>Run</strong>.
- <p align="center"><img alt="Run Configurations" src="../../images/run_configurations_w.png" /></p></li>
+ <li>In the <strong>Run Configurations</strong> window, click the <strong>New Launch Configuration</strong> icon (<img alt="New Launch Configuration icon" src="../../images/run_new_config_wn.png" />), define the configuration details, and launch the application by clicking <strong>Run</strong>.
+ <p align="center"><img alt="Run Configurations window" src="../../images/run_configurations_w.png" /></p></li>
</ol></td>
</tr>
</tbody>
<h4 id="css" name="css">CSS</h4>
-<p>CSS (Cascading Style Sheets) specifies the layout and the styling of the Web application.</p>
+<p>CSS (Cascading Style Sheets) specifies the layout and styling of the Web application.</p>
<p>There are various ways to connect CSS with HTML:</p>
<ul>
-<li><span style="font-family: Courier New,Courier,monospace">style</span> attribute in a HTML element</li>
+<li><span style="font-family: Courier New,Courier,monospace">style</span> attribute in an HTML element</li>
<li><span style="font-family: Courier New,Courier,monospace"><link></span> element in the <span style="font-family: Courier New,Courier,monospace"><head></span> element</li>
<li><span style="font-family: Courier New,Courier,monospace">@import</span> attribute in the CSS area</li>
<li><span style="font-family: Courier New,Courier,monospace"><style></span> element in the <span style="font-family: Courier New,Courier,monospace"><head></span> element</li>
<ol>
<li>Install TAU templates.
-<p>The Tizen 2.4 SDK comes with the Update Manager tool, which you can use to install the TAU packages required for TAU application development.</p>
+<p>The Tizen Studio comes with the Package Manager tool, which you can use to install the TAU packages required for TAU application development.</p>
<p>The TAU packages enable you to create the Web application using a TAU template.</p>
-<p align="center"><img src="../../images/simple_ui_update_mgr_ww.png" alt="Update manager installation" /></p>
+<p align="center"><img src="../../images/simple_ui_update_mgr_ww.png" alt="TAU package installation" /></p>
</li>
<li>Start the application development with the TAU library.
<p>You can get the TAU library using a TAU template or a sample application as a basis for your application. The easiest way to start your first TAU application is to create a new project with a TAU template.</p>
<p>To create a project with a TAU template:</p>
<ol type="a">
-<li>Go to <strong>File > New > Tizen Web Project</strong>.</li>
-<li>Go to <strong>Template > WEARABLE-2.3.1 > TAU Basic</strong>.
-<p align="center"><img src="../../images/simple_ui_tau_create_ww.png" alt="Create a new project" /></p>
+<li>Go to <strong>File > New > Tizen Project</strong>.</li>
+<li>Select <strong>Template > Wearable v2.3.2 > Web Application > TAU Basic</strong>.
+<p align="center"><img src="../../images/simple_ui_tau_create_ww.png" alt="Creating a new project" /></p>
</li>
-<li>Enter the project name.</li>
-<li>Click <strong>Finish</strong>.</li>
+<li>Change the project name and properties and click <strong>Finish</strong>.
+<p align="center"><img src="../../images/simple_ui_tau_properties_ww.png" alt="Changing properties" /></p></li>
<li>In the <strong>Project Explorer</strong> view, view the project.
<p>The TAU library is located in the <span style="font-family: Courier New,Courier,monospace">lib</span> folder.</p>
<p align="center"><img src="../../images/simple_ui_tau_dir_ww.png" alt="TAU library directory" /></p>
</body>
</pre></li>
<li>
-<p>To layout a page, add a content area with the <span style="font-family: Courier New,Courier,monospace">ui-content</span> class and a header with the <span style="font-family: Courier New,Courier,monospace">ui-header</span> class:</p>
+<p>To layout the page, add a content area with the <span style="font-family: Courier New,Courier,monospace">ui-content</span> class and a header with the <span style="font-family: Courier New,Courier,monospace">ui-header</span> class:</p>
<pre class="prettyprint">
<div class="ui-page" id="main">
<header class="ui-header">
<p>When you are developing a more complex application, you can take advantage of the <a href="../../../../org.tizen.studio/html/web_tools/cover_web_w.htm">Web tools included in the Tizen Studio</a> to ease the tasks of creating functionality and designing the application UI.</p>
-<p><strong>Updating 2.3.1 Wearable Packages</strong></p>
-
-<p>To develop wearable applications in the latest Tizen SDK, you must install the 2.3.1 wearable packages separately:</p>
-
-<ol>
-<li>Launch the Update Manager by going to <strong>Start > All Programs > Tizen SDK-<version> > Update Manager-<version></strong>.</li>
-<li>In the <strong>All Packages</strong> tab, download all packages for <strong>2.3.1 Wearable</strong>.
-<p align="center"><img alt="Download packages" src="../../images/first_app_download_wn.png" /></p></li>
-</ol>
-
<h2 id="create">Creating a Project</h2>
<p>The following example shows you how to create and configure a basic wearable Web watch application project in the Tizen Studio. An application project contains all the files that make up an application.</p>
<li><p>Launch the Tizen Studio.</p></li>
<li>
-<p>Make sure the <strong>Tizen Web</strong> perspective is selected in the top right corner of the Tizen Studio window. </p>
+<p>Make sure the <strong>Web</strong> perspective is selected in the top right corner of the Tizen Studio window. </p>
<p align="center"><img alt="Checking the perspective" src="../../images/change_perspective_w.png" /></p>
-<p>If not, select it. If the perspective is not visible, in the Tizen Studio menu, select <strong>Window > Open Perspective > Other > Tizen Web</strong>, and click <strong>OK</strong>.</p>
+<p>If not, select it. If the perspective is not visible, in the Tizen Studio menu, select <strong>Window > Perspective > Open Perspective > Other > Web</strong>, and click <strong>OK</strong>.</p>
</li>
<li>
-<p>In the Tizen Studio menu, select <strong>File > New > Tizen Web Project</strong>.</p>
+<p>In the Tizen Studio menu, select <strong>File > New > Tizen Project</strong>.</p>
<p align="center"><img alt="Creating a new Tizen Web project" src="../../images/create_project_1_w.png" /></p>
<p>The Project Wizard opens.</p>
</li>
<p>In the Project Wizard, define the project details.</p>
<p>The Project Wizard is used to create the basic application skeleton with the required folder structure and mandatory files. You can easily create different applications by selecting an applicable template or sample for the Project Wizard to use.</p>
<ol type="a">
-<li><p>Select the <strong>Online Sample</strong> tab and the <strong>Watch > Basic Watch</strong> sample.</p></li>
-<li><p>Change the project name, if you want.</p></li>
-<li><p>Leave all other fields in the Project Wizard to their default values, and click <strong>Finish</strong>.</p></li>
+<li><p>Select the <strong>Sample</strong> project type and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the project type" src="../../images/create_project_wizard_type_sample.png" /></p>
+</li>
+<li><p>Select the profile (<strong>Wearable</strong>) and version from a drop-down list and click <strong>Next</strong>.</p>
+<p>The version depends on the platform version you have installed and with which you are developing the application.</p>
+<p align="center"><img alt="Selecting the profile and version" src="../../images/create_project_wizard_version_wearable.png" /></p>
+</li>
+<li><p>Select the <strong>Web Application</strong> application type and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the application type" src="../../images/create_project_wizard_app_web_wearable.png" /></p>
+</li>
+<li><p>Select the <strong>Watch > Basic Watch</strong> sample and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the sample" src="../../images/create_project_wizard_sample.png" /></p>
+</li>
+<li><p>Define the project properties and click <strong>Finish</strong>.</p>
+<p>You can fill the project name (3-50 characters) and the unique package ID. You can also select the location and working sets by clicking <strong>More properties</strong>.</p>
+<p align="center"><img alt="Defining properties" src="../../images/create_project_wizard_properties_ww_watch.png" /></p>
+
+<p>The Project Wizard sets up the project, creates the application files using the default content from the template, and closes. For more information about the Project Wizard and the available templates, see <a href="../../../../org.tizen.studio/html/web_tools/project_wizard_w.htm">Creating Tizen Projects with Tizen Project Wizard</a>.</p></li>
</ol>
-<p align="center"><img alt="Defining the project details" src="../../images/create_project_2_ww_watch.png" /></p>
-<p>The Project Wizard sets up the project, creates the application files using the default content from the template, and closes. For more information about the Project Wizard and the available templates, see <a href="../../../../org.tizen.studio/html/web_tools/project_wizard_w.htm">Creating Tizen Projects with Tizen Project Wizard</a>.</p>
</li>
</ol>
<p align="center"><img alt="Configuring the application" src="../../images/basic_app_config_ww_watch.png" /></p>
<ul>
<li><p><strong>Overview</strong>: Define general information, such as the name and icon of the application.</p></li>
-<li><p><strong>Widget</strong>: Define author and license information and UI preferences.</p></li>
<li><p><strong>Features</strong>: Define required software and hardware features. This information is used for application filtering in the Tizen market place.</p></li>
<li><p><strong>Privileges</strong>: Define the security-sensitive APIs or API groups accessed and used by the application.</p></li>
<li><p><strong>Policy</strong>: Request network resource permissions to access external network resources.</p></li>
<th class="note">Note</th>
</tr>
<tr>
- <td class="note">The <span style="font-family: Courier New,Courier,monospace">config.xml</span> file must conform to both the XML file format and the W3C specification requirements. Editing the file in the source code view is intended for advanced users only.</td>
+ <td class="note">The <span style="font-family: Courier New,Courier,monospace">config.xml</span> file must conform to both the XML file format and the W3C specification requirements. Editing the file in the <strong>Source</strong> tab is intended for advanced users only.</td>
</tr>
</tbody>
</table>
</ul>
</li>
-<li><p>To save any changes, in the Tizen Studio menu, select <strong>File > Save</strong>.</p></li>
+<li><p>To save any changes, in the Tizen Studio menu, select <strong>File > Save All</strong>.</p></li>
</ol>
<ol>
<li>Select the project in the <strong>Project Explorer</strong> view.</li>
<li>In the Tizen Studio menu, select <strong>Project > Build Automatically</strong>.
-<p align="center"><img alt="Using the automatic build" src="../../images/build_automatic_w.png" /></p>
+<p align="center"><img alt="Using the automatic build" src="../../images/build_automatic_ww_watch.png" /></p>
<p>A check mark appears next to the menu option.</p></li>
</ol>
<li>In the <strong>Connection Explorer</strong> view, launch the Emulator Manager by clicking the related icon.
<p align="center"><img src="../../images/emulator_icon.png" alt="Emulator manager icon" /></p>
</li>
-
-<li>In the Emulator Manager, open the <strong>Create New Emulator</strong> drop-down list and select <strong>wearable</strong>.
-<p align="center"><img src="../../images/emulator_new_wearable.png" alt="Emulator manager" /></p>
+<li>In the Emulator Manager, click <strong>Create</strong>.
+<p align="center"><img src="../../images/emulator_instance_create.png" alt="Creating an emulator instance" /></p>
</li>
-
-<li>Modify the emulator options, and click <strong>Confirm</strong>.
+<li>Select the applicable platform (in this case, <strong>wearable-2.3.2-circle (basic)</strong>), and click <strong>Next</strong>.
+<p align="center"><img src="../../images/emulator_instance_platform_wearable.png" alt="Selecting the platform" /></p>
+</li>
+<li>Select the device definition along with the platform version (in this case, <strong>Wearable Circle</strong>), and click <strong>Next</strong>.
+<p align="center"><img src="../../images/emulator_instance_version_wearable.png" alt="Selecting the platform version" /></p>
+</li>
+<li>Define the emulator properties, and click <strong>Finish</strong>.
<p>You can leave the options to their default values.</p>
-<p align="center"><img src="../../images/emulator_settings_wearable.png" alt="Emulator options" /></p>
+<p align="center"><img src="../../images/emulator_instance_properties_wearable.png" alt="Defining the properties" /></p>
</li>
+<li>To launch the emulator instance, select the emulator from the list and click <strong>Launch</strong>.
+<p align="center"><img src="../../images/emulator_instance_launch_wearable.png" alt="Launching the emulator" /></p>
-<li>To launch the emulator instance, select the emulator from the list and click the play icon.
-<p align="center"><img src="../../images/emulator_launch_wearable.png" alt="Launch the emulator" /></p>
-
-<p>The emulator is launched in its own window.</p>
-<p>You can also see the new emulator instance in the <strong>Connection Explorer</strong> view. To view the emulator folder structure, click the arrow next to the emulator instance.</p>
+<p>The emulator is launched in its own window. You can also see the new emulator instance in the <strong>Connection Explorer</strong> view. To view the emulator folder structure, click the arrow next to the emulator instance.</p>
<p align="center"><img src="../../images/emulator_window_wearable.png" alt="Emulator" /></p>
</li>
</ol>
</li>
<li>Generate a security profile.
- <p>Before you run the application, you must sign your application package by <a href="https://developer.tizen.org/community/tip-tech/issuing-tizen-certificate-certificate-extension-ver-1.2#emulator" target="_blank">generating an author certificate and registering it</a> in the Tizen Studio.</p>
+ <p>Before you run the application, you must <a href="../../../../org.tizen.studio/html/common_tools/certificate_registration.htm">sign your application package with a certificate profile</a> in the Tizen Studio.</p>
</li>
<li>Run the application:
<ol type="a">
<li>In the <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Tizen Web Application</strong>.
-<p align="center"><img src="../../images/app_run_ww_watch.png" alt="Run the application" /></p>
+<p align="center"><img src="../../images/app_run_ww_watch.png" alt="Running the application" /></p>
<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and do one of the following:</p>
<ul><li>Press the <strong>Ctrl+F11</strong> key.</li>
-<li>Click the play icon (<img src="../../images/emulator_play.png" alt="Play icon" />) in the toolbar.</li></ul>
+<li>Click the run icon in the toolbar.</li></ul>
+
+<p>If you have created multiple emulator instances, select the instance you want from the combo box in the toolbar before selecting to run the application. If you select an offline emulator, it is automatically launched when you select to run the application.</p>
+<p align="center"><img src="../../images/app_run_multiple_emulators.png" alt="Selecting the emulator to use" /></p>
<p>In the <strong>Console</strong> view, you can see that the application is successfully installed. However, it does not run on the emulator screen until you change the watch face in the emulator <strong>Settings</strong> menu.</p>
<p align="center"><img alt="Successful installation" src="../../images/watch_run_install_watch_ww.png" /></p>
</li>
</ol>
</li></ol>
-<p>For more information on using the emulator features, see <a href="../../../../org.tizen.studio/html/common_tools/emulator_control_panel.htm">
Emulator Control Keys and Menu</a> and <a href="../../../../org.tizen.studio/html/common_tools/emulator_features.htm">Using Extended Emulator Features</a>.</p>
+<p>For more information on using the emulator features, see <a href="../../../../org.tizen.studio/html/common_tools/emulator_control_panel.htm">
Using Emulator Control Keys, Menu, and Panel</a> and <a href="../../../../org.tizen.studio/html/common_tools/emulator_features.htm">Using Extended Emulator Features</a>.</p>
<h3 id="target">Running on a Target Device</h3>
</ol>
</li>
<li>Generate an author certificate.
-<p>Before you run the application, you must sign your application package by <a href="https://developer.tizen.org/community/tip-tech/issuing-tizen-certificate-certificate-extension-ver-1.2#CommercialDevices" target="_blank">generating an author certificate and registering it</a> in the Tizen Studio.</p>
+<p>Before you run the application, you must <a href="../../../../org.tizen.studio/html/common_tools/certificate_registration.htm">sign your application package with a certificate profile</a> in the Tizen Studio.</p>
</li>
<li>Run the application:
<ol type="a">
<li>In the <strong>Connection Explorer</strong> view, select the device.</li>
<li>In <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Tizen Web Application</strong>.
-<p align="center"><img src="../../images/app_run_ww_watch.png" alt="Run the application" /></p>
+<p align="center"><img src="../../images/app_run_ww_watch.png" alt="Running the application" /></p>
<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and do one of the following:</p>
<ul><li>Press the <strong>Ctrl+F11</strong> key.</li>
-<li>Click the play icon (<img src="../../images/emulator_play.png" alt="Play icon" />) in the toolbar.</li></ul>
+<li>Click the run icon in the toolbar.</li></ul>
+
+<p>If you have both a connected device and existing emulator instances, select the device from the combo box in the toolbar before selecting to run the application.</p>
+
+<p align="center"><img src="../../images/app_run_multiple_emulators.png" alt="Selecting the device to use" /></p>
</li>
<li>Confirm that the application launches in the target device.
<td class="note">The application is launched using the default debug run configuration. To create and use another configuration:
<ol>
<li>In the <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Run Configurations</strong>.</li>
- <li>In the <strong>Run Configurations</strong> window, click the <strong>New Launch Configuration</strong> icon (<img alt="New Launch Configuration" src="../../images/run_new_config_wn.png" />), define the configuration details, and launch the application by clicking <strong>Run</strong>.
- <p align="center"><img alt="Run Configurations" src="../../images/run_configurations_watch_ww.png" /></p></li>
+ <li>In the <strong>Run Configurations</strong> window, click the <strong>New Launch Configuration</strong> icon (<img alt="New Launch Configuration icon" src="../../images/run_new_config_wn.png" />), define the configuration details, and launch the application by clicking <strong>Run</strong>.
+ <p align="center"><img alt="Run Configurations window" src="../../images/run_configurations_ww_watch.png" /></p></li>
</ol></td>
</tr>
</tbody>
<h3 id="ambient">Using the Ambient Mode</h3>
<p>In a low-powered wearable device, an ambient mode is available. In this mode, the watch application shows a limited UI and receives only the ambient tick event every minute to reduce power consumption.</p>
-<p>The details of the limited UI drawn in the ambient mode depend on the device. Usually, when designing the ambient mode UI, draw a black and white UI only, and use less than 15% of the pixels on the screen. If you do not want to draw your own ambient mode UI, set the <span style="font-family: Courier New,Courier,monospace">ambient-support</span> attribute to <span style="font-family: Courier New,Courier,monospace">disable</span> in the watch application manifest file to allow the platform to show a default ambient mode UI.</p>
+<p>The details of the limited UI drawn in the ambient mode depend on the device. In addition, due to the ambient mode being a low power mode, there are limits to the colors that can be shown on the screen. Usually, when designing the ambient mode UI, draw a black and white UI only, and use less than 15% of the pixels on the screen. If you do not want to draw your own ambient mode UI, set the <span style="font-family: Courier New,Courier,monospace">ambient_support</span> attribute to <span style="font-family: Courier New,Courier,monospace">disable</span> in the <span style="font-family: Courier New,Courier,monospace">config.xml</span> watch application configuration file to allow the platform to show a default ambient mode UI.</p>
<table class="note">
<p>When you are developing a more complex application, you can take advantage of the <a href="../../../../org.tizen.studio/html/web_tools/cover_web_w.htm">Web tools included in the Tizen Studio</a> to ease the tasks of creating functionality and designing the application UI.</p>
-<p><strong>Updating 2.3.2 Wearable Packages</strong></p>
-
-<p>To develop wearable applications in the latest Tizen SDK, you must install the 2.3.2 wearable packages separately:</p>
-
-<ol>
-<li>Launch the Package Manager by going to <strong>Start > All Programs > Tizen Studio > Package Manager</strong>.</li>
-<li>In the <strong>All Packages</strong> tab, download all packages for <strong>2.3.2 Wearable</strong>.
-<p align="center"><img alt="Download packages" src="../../images/first_app_download_ww_widget.png" /></p></li>
-</ol>
-
<h2 id="create">Creating a Project</h2>
<p>The following example shows you how to create and configure a basic wearable Web widget application project in the Tizen Studio. An application project contains all the files that make up an application.</p>
<li>
<p>Make sure the <strong>Web</strong> perspective is selected in the top right corner of the Tizen Studio window. </p>
-<p align="center"><img alt="Checking the perspective" src="../../images/change_perspective_w_widget.png" /></p>
-<p>If not, select it. If the perspective is not visible, in the Tizen Studio menu, select <strong>Window > Perspective > Open Perspective > Open Perspective > Other > Web</strong>, and click <strong>OK</strong>.</p>
+<p align="center"><img alt="Checking the perspective" src="../../images/change_perspective_w.png" /></p>
+<p>If not, select it. If the perspective is not visible, in the Tizen Studio menu, select <strong>Window > Perspective > Open Perspective > Other > Web</strong>, and click <strong>OK</strong>.</p>
</li>
<li>
-<p>In the Tizen Studio menu, select <strong>File > New > Other > Tizen > Tizen Project from Template</strong>.</p>
-<p>Alternatively, you can also click the new icon at the top left corner of the Tizen Studio.</p>
+<p>In the Tizen Studio menu, select <strong>File > New > Tizen Project</strong>.</p>
+<p align="center"><img alt="Creating a new Tizen Web project" src="../../images/create_project_1_w.png" /></p>
<p>The Project Wizard opens.</p>
</li>
-
<li>
<p>In the Project Wizard, define the project details.</p>
<p>The Project Wizard is used to create the basic application skeleton with the required folder structure and mandatory files. You can easily create different applications by selecting an applicable template or sample for the Project Wizard to use.</p>
<ol type="a">
-<li><p>Select the <strong>Template</strong> project type.</p>
-<p align="center"><img alt="Selecting the project type" src="../../images/create_project_1_widget.png" /></p>
-</li>
-<li><p>Select the <strong>Wearable</strong> profile. The version depends on the SDK version you have installed and with which you are developing the application.</p>
-<p align="center"><img alt="Selecting the profile" src="../../images/create_project_2_widget.png" /></p></li>
-<li><p>Select the <strong>Web Application</strong> application type.</p>
-<p align="center"><img alt="Selecting the application type" src="../../images/create_project_3_widget.png" /></p></li>
-<li><p>Select the <strong>Widget</strong> template.</p>
-<p align="center"><img alt="Selecting the template" src="../../images/create_project_4_widget.png" /></p></li>
-<li><p>Set the project name as <strong>Widget</strong>.</p>
-<p align="center"><img alt="Setting the project name" src="../../images/create_project_5_widget.png" /></p></li>
-<li><p>Leave all other fields in the Project Wizard to their default values, and click <strong>Finish</strong>.</p></li>
+<li><p>Select the <strong>Template</strong> project type and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the project type" src="../../images/create_project_wizard_type.png" /></p>
+</li>
+<li><p>Select the profile (<strong>Wearable</strong>) and version from a drop-down list and click <strong>Next</strong>.</p>
+<p>The version depends on the platform version you have installed and with which you are developing the application.</p>
+<p align="center"><img alt="Selecting the profile and version" src="../../images/create_project_wizard_version_wearable.png" /></p>
+</li>
+<li><p>Select the <strong>Web Application</strong> application type and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the application type" src="../../images/create_project_wizard_app_web_wearable.png" /></p>
+</li>
+<li><p>Select the <strong>Widget</strong> template and click <strong>Next</strong>.</p>
+<p align="center"><img alt="Selecting the template" src="../../images/create_project_wizard_template_ww_widget.png" /></p>
+</li>
+<li><p>Define the project properties and click <strong>Finish</strong>.</p>
+<p>You can fill the project name (3-50 characters) and the unique package ID. You can also select the location and working sets by clicking <strong>More properties</strong>.</p>
+<p align="center"><img alt="Defining properties" src="../../images/create_project_wizard_properties_ww_widget.png" /></p>
+
+<p>The Project Wizard sets up the project, creates the application files using the default content from the template, and closes. For more information about the Project Wizard and the available templates, see <a href="../../../../org.tizen.studio/html/web_tools/project_wizard_w.htm">Creating Tizen Projects with Tizen Project Wizard</a>.</p></li>
</ol>
-<p>The Project Wizard sets up the project, creates the application files using the default content from the template, and closes. For more information about the Project Wizard and the available templates, see <a href="../../../../org.tizen.studio/html/web_tools/project_wizard_w.htm">Creating Tizen Projects with Tizen Project Wizard</a>.</p>
</li>
</ol>
<th class="note">Note</th>
</tr>
<tr>
- <td class="note">The <span style="font-family: Courier New,Courier,monospace">config.xml</span> file must conform to both the XML file format and the W3C specification requirements. Editing the file in the source code view is intended for advanced users only.</td>
+ <td class="note">The <span style="font-family: Courier New,Courier,monospace">config.xml</span> file must conform to both the XML file format and the W3C specification requirements. Editing the file in the <strong>Source</strong> tab is intended for advanced users only.</td>
</tr>
</tbody>
</table>
</ul>
</li>
-<li><p>To save any changes, in the Tizen Studio menu, select <strong>File > Save</strong>.</p></li>
+<li><p>To save any changes, in the Tizen Studio menu, select <strong>File > Save All</strong>.</p></li>
</ol>
<h2 id="build">Building Your Application</h2>
<p>After you have created the application project, you can implement the required features. In this example, only the default features from the project template are used, and no code changes are required.</p>
-<p>When your application code is ready, you must build the application. The building process performs a validation check and compiles your files.</p>
+<p>When your application code is ready, you must build the application. The building process performs a validation check and compiles your JavaScript and CSS files.</p>
<p>You can build the application in the following ways:</p>
<p>The manual build means that you determine yourself when the application is built.</p>
<p>To manually build the application, right-click the project in the <strong>Project Explorer</strong> view and select <strong>Build Project</strong>.</p>
+<p class="figure">Figure: Manually building the application</p>
+<p align="center"><img alt="Manually building the application" src="../../images/build_manual_widget_ww.png" /></p>
+
<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and do one of the following:</p>
<ul><li>In the Tizen Studio menu, select <strong>Project > Build Project</strong>.</li>
<li>Press the <strong>F10</strong> key.</li></ul>
<ol>
<li>Create and launch an emulator instance in the <a href="../../../../org.tizen.studio/html/common_tools/emulator_manager.htm">Emulator Manager</a>:
<ol type="a">
-<li>In the Tizen Studio menu, select <strong>Tools > Emulator Manager</strong>.
+<li>In the <strong>Connection Explorer</strong> view, launch the Emulator Manager by clicking the related icon.
+<p align="center"><img src="../../images/emulator_icon.png" alt="Emulator manager icon" /></p>
</li>
-
-<li>In the Emulator Manager, if no emulator instances exist, an empty list is shown.
-<p align="center"><img src="../../images/emulator_empty.png" alt="Empty emulator list" /></p>
-<p>To create an emulator instance:</p>
-<ol type="a">
-<li>Click <strong>Create</strong>, select the <strong>wearable</strong> platform, and click <strong>Next</strong>.
-<p align="center"><img src="../../images/emulator_platform.png" alt="Emulator platform" /></p>
+<li>In the Emulator Manager, click <strong>Create</strong>.
+<p align="center"><img src="../../images/emulator_instance_create.png" alt="Creating an emulator instance" /></p>
</li>
-<li>Select the <strong>Wearable Circle</strong> template, and click <strong>Next</strong>.
-<p align="center"><img src="../../images/emulator_template.png" alt="Emulator template" /></p>
+<li>Select the applicable platform (in this case, <strong>wearable-2.3.2-circle (basic)</strong>), and click <strong>Next</strong>.
+<p align="center"><img src="../../images/emulator_instance_platform_wearable.png" alt="Selecting the platform" /></p>
</li>
-<li>Modify the emulator options, and click <strong>Finish</strong>.
-<p>You can leave all options to their default values.</p>
-<p align="center"><img src="../../images/emulator_settings_w.png" alt="Emulator options" /></p>
+<li>Select the device definition along with the platform version (in this case, <strong>Wearable Circle</strong>), and click <strong>Next</strong>.
+<p align="center"><img src="../../images/emulator_instance_version_wearable.png" alt="Selecting the platform version" /></p>
</li>
-</ol>
+<li>Define the emulator properties, and click <strong>Finish</strong>.
+<p>You can leave the options to their default values.</p>
+<p align="center"><img src="../../images/emulator_instance_properties_wearable.png" alt="Defining the properties" /></p>
</li>
-
<li>To launch the emulator instance, select the emulator from the list and click <strong>Launch</strong>.
-<p align="center"><img src="../../images/emulator_launch_w.png" alt="Launch the emulator" /></p>
+<p align="center"><img src="../../images/emulator_instance_launch_wearable.png" alt="Launching the emulator" /></p>
-<p>The emulator is launched in its own window.</p>
-<p>You can also see the new emulator instance in the <strong>Connection Explorer</strong> view. To view the emulator folder structure, click the arrow next to the emulator instance.</p>
-<p align="center"><img src="../../images/emulator_window_w_widget.png" alt="Emulator" /></p>
+<p>The emulator is launched in its own window. You can also see the new emulator instance in the <strong>Connection Explorer</strong> view. To view the emulator folder structure, click the arrow next to the emulator instance.</p>
+<p align="center"><img src="../../images/emulator_window_wearable.png" alt="Emulator" /></p>
</li>
</ol>
</li>
<li>Generate a security profile.
- <p>Before you run the application, you must sign your application package by <a href="https://developer.tizen.org/community/tip-tech/issuing-tizen-certificate-certificate-extension-ver-1.2#emulator" target="_blank">generating an author certificate and registering it</a> in the Tizen Studio.</p>
+ <p>Before you run the application, you must <a href="../../../../org.tizen.studio/html/common_tools/certificate_registration.htm">sign your application package with a certificate profile</a> in the Tizen Studio.</p>
</li>
<li>Run the application:
<ol type="a">
<li>In the <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Tizen Web Application</strong>.
-<p align="center"><img src="../../images/app_run_ww_widget.png" alt="Run the application" /></p>
+<p align="center"><img src="../../images/app_run_ww_widget.png" alt="Running the application" /></p>
<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and do one of the following:</p>
<ul><li>Press the <strong>Ctrl+F11</strong> key.</li>
-<li>Click the play icon (<img src="../../images/emulator_play_widget.png" alt="Play icon" />) in the toolbar.</li></ul>
+<li>Click the run icon in the toolbar.</li></ul>
+<p>If you have created multiple emulator instances, select the instance you want from the combo box in the toolbar before selecting to run the application. If you select an offline emulator, it is automatically launched when you select to run the application.</p>
+
+<p align="center"><img src="../../images/app_run_multiple_emulators.png" alt="Selecting the emulator to use" /></p>
</li>
<li>Confirm that the application launches on the emulator.
</ol>
</li></ol>
-<p>For more information on using the emulator features, see <a href="../../../../org.tizen.studio/html/common_tools/emulator_control_panel.htm">
Emulator Control Keys and Menu</a> and <a href="../../../../org.tizen.studio/html/common_tools/emulator_features.htm">Using Extended Emulator Features</a>.</p>
+<p>For more information on using the emulator features, see <a href="../../../../org.tizen.studio/html/common_tools/emulator_control_panel.htm">
Using Emulator Control Keys, Menu, and Panel</a> and <a href="../../../../org.tizen.studio/html/common_tools/emulator_features.htm">Using Extended Emulator Features</a>.</p>
<h3 id="target">Running on a Target Device</h3>
<p>To run the application on a target device:</p>
</pre>
<p>Use the IP address you noted before.</p>
-<p>Instead of the terminal, you can also use the <a href="../wearable/first_app_ww.htm#remote_device">Tizen Studio Remote Device Manager</a> for the connection.</p>
+<p>Instead of the terminal, you can also use the <a href="../wearable/first_app_ww.htm#remote_device">Remote Device Manager</a> for the connection.</p>
</li>
<li>
<p align="center"><img src="../../images/remote_allow_gear_ww.png" alt="Allow Gear to access data" /></p>
</li>
-<li>In the Tizen Studio menu bar, confirm that the device is connected.
-<p align="center"><img src="../../images/remote_connected_ww_widget.png" alt="Device is connected" /></p>
-<p>For more information, see <a href="../../../../org.tizen.studio/html/common_tools/connection_explorer_view.htm">Managing and Connecting Devices for Testing</a>.</p>
+<li>In the <strong>Connection Explorer</strong> view, confirm that the device is connected (shown in the device list).
+<p align="center"><img src="../../images/remote_connected_ww.png" alt="Device is connected" /></p>
</li>
</ol>
</li>
<li>Generate an author certificate.
-<p>Before you run the application, you must sign your application package by <a href="https://developer.tizen.org/community/tip-tech/issuing-tizen-certificate-certificate-extension-ver-1.2#CommercialDevices" target="_blank">generating an author certificate and registering it</a> in the Tizen Studio.</p>
+<p>Before you run the application, you must <a href="../../../../org.tizen.studio/html/common_tools/certificate_registration.htm">sign your application package with a certificate profile</a> in the Tizen Studio.</p>
</li>
<li>In the <strong>Connection Explorer</strong> view, select the device.</li>
<li>In <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Tizen Web Application</strong>.
-<p align="center"><img src="../../images/app_run_ww_widget.png" alt="Run the application on a target device" /></p>
+<p align="center"><img src="../../images/app_run_ww_widget.png" alt="Running the application" /></p>
<p>Alternatively, you can also select the project in the <strong>Project Explorer</strong> view and do one of the following:</p>
<ul><li>Press the <strong>Ctrl+F11</strong> key.</li>
-<li>Click the play icon (<img src="../../images/emulator_play.png" alt="Play icon" />) in the toolbar.</li></ul>
+<li>Click the run icon in the toolbar.</li></ul>
+
+<p>If you have both a connected device and existing emulator instances, select the device from the combo box in the toolbar before selecting to run the application.</p>
+
+<p align="center"><img src="../../images/app_run_multiple_emulators.png" alt="Selecting the device to use" /></p>
</li>
<li>Confirm that the application launches in the target device.
<td class="note">The application is launched using the default debug run configuration. To create and use another configuration:
<ol>
<li>In the <strong>Project Explorer</strong> view, right-click the project and select <strong>Run As > Run Configurations</strong>.</li>
- <li>In the <strong>Run Configurations</strong> window, click the <strong>New Launch Configuration</strong> icon (<img alt="New Launch Configuration" src="../../images/run_new_config_w_widget.png" />), define the configuration details, and launch the application by clicking <strong>Run</strong>.
- <p align="center"><img alt="Run Configurations" src="../../images/run_configurations_w_widget.png" /></p></li>
+ <li>In the <strong>Run Configurations</strong> window, click the <strong>New Launch Configuration</strong> icon (<img alt="New Launch Configuration icon" src="../../images/run_new_config_wn.png" />), define the configuration details, and launch the application by clicking <strong>Run</strong>.
+ <p align="center"><img alt="Run Configurations window" src="../../images/run_configurations_w_widget.png" /></p></li>
</ol></td>
</tr>
</tbody>
<topic href="html/native/feature/ui_builder_overview_mn.htm" label="Overview of Tizen UI Development"></topic>
<topic href="html/native/feature/ui_builder_app_design_mn.htm" label="Designing Your Native Application"></topic>
<topic href="html/native/details/details_n.htm" label="Understanding Tizen Programming">
+ <topic href="html/native/details/tizen_apis_n.htm" label="Tizen APIs"></topic>
+ <topic href="html/native/details/sec_privileges_n.htm" label="Security and API Privileges"></topic>
<topic href="html/native/details/app_filtering_n.htm" label="Application Filtering"></topic>
- <topic href="html/native/details/error_handling_n.htm" label="Error Handling"></topic>
<topic href="html/native/details/event_handling_n.htm" label="Event Handling"></topic>
+ <topic href="html/native/details/error_handling_n.htm" label="Error Handling"></topic>
<topic href="html/native/details/io_overview_n.htm" label="File System Directory Hierarchy"></topic>
- <topic href="html/native/details/sec_privileges_n.htm" label="Security and API Privileges"></topic>
- <topic href="html/native/details/tizen_apis_n.htm" label="Tizen APIs"></topic>
<topic href="html/native/details/deprecation_policy_n.htm" label="API Versioning and Deprecation Policy of the Tizen Platform"></topic>
<topic href="html/native/details/sign_certificate_n.htm" label="Application Signing and Certificates"></topic>
</topic>
<topic href="html/web/details/sec_privileges_w.htm" label="Security and API Privileges"></topic>
<topic href="html/web/details/app_filtering_w.htm" label="Application Filtering"></topic>
<topic href="html/web/details/web_runtime_w.htm" label="Web Runtime"></topic>
- <topic href="html/web/details/event_handling_w.htm" label="Event Handling"></topic>
+ <topic href="html/web/details/event_handling_w.htm" label="Event Handling"></topic>
+ <topic href="html/web/details/deprecation_policy_w.htm" label="API Versioning and Deprecation Policy of the Tizen Platform"></topic>
<topic href="html/web/details/sign_certificate_w.htm" label="Application Signing and Certificates"></topic>
</topic>
</topic>
</div>
<p>The APIs listed in this category are all part of the W3C specifications. Some of the APIs are stable while others are draft specifications. The draft APIs are subject to change as the W3C specification evolves.</p>
<p>The W3C APIs are categorized based on the functionality to make it easier to locate specific APIs.
- To learn the Tizen features provided by the W3C/HTML5 and some supplementary APIs, see <a href="../../../org.tizen.guides/html/web/w3c/guides_w3c_w.htm">Guide to W3C/HTML5 and Some Supplementary Features</a> and <a href="../../../org.tizen.tutorials/html/web/w3c/tutorials_w3c_w.htm">W3C/HTML5 and Some Supplementaries Tutorials</a>.</p>
+ To learn the Tizen features provided by the W3C/HTML5 and some supplementary APIs, see <a href="../../../org.tizen.guides/html/web/w3c/guides_w3c_w.htm">Guide to W3C/HTML5 and Some Supplementary Features</a> and <a href="../../../org.tizen.training/html/web/w3c/tutorials_w3c_w.htm">W3C/HTML5 and Some Supplementaries Tutorials</a>.</p>
<div><h4 id="dom">DOM, Forms and Styles</h4>
<table width="90%">
<thead>
</div>
<p>The APIs listed in this category are all part of the W3C specifications. Some of the APIs are stable while others are draft specifications. The draft APIs are subject to change as the W3C specification evolves.</p>
<p>The W3C APIs are categorized based on the functionality to make it easier to locate specific APIs.
- To learn the Tizen features provided by the W3C/HTML5 and some supplementary APIs, see <a href="../../../org.tizen.guides/html/web/w3c/guides_w3c_w.htm">Guide to W3C/HTML5 and Some Supplementary Features</a> and <a href="../../../org.tizen.tutorials/html/web/w3c/tutorials_w3c_w.htm">W3C/HTML5 and Some Supplementaries Tutorials</a>.</p>
+ To learn the Tizen features provided by the W3C/HTML5 and some supplementary APIs, see <a href="../../../org.tizen.guides/html/web/w3c/guides_w3c_w.htm">Guide to W3C/HTML5 and Some Supplementary Features</a> and <a href="../../../org.tizen.training/html/web/w3c/tutorials_w3c_w.htm">W3C/HTML5 and Some Supplementaries Tutorials</a>.</p>
<div><h4 id="dom">DOM, Forms and Styles</h4>
<table width="90%">
<thead>
<p class="toc-title">Related Info</p>
<ul class="toc">
<li><a href="../../org.tizen.guides/html/web/guides_w.htm">Tizen Web Tutorials</a></li>
- <li><a href="../../org.tizen.tutorials/html/web/tutorials_w.htm">Tizen Web Guides</a></li>
+ <li><a href="../../org.tizen.training/html/web/tutorials_w.htm">Tizen Web Guides</a></li>
</ul>
</div>
projects / sdk / online-doc.git / commitdiff
