</tr>
<tr>
<td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><a href="#name"><name></a></code></td>
- </tr>
- <tr>
- <td style="border:none;"> </td>
- <td style="border:none;"> </td>
- <td colspan="2" style="border:none;"><code><a href="#span"><span></a></code></td>
- </tr>
- <tr>
- <td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><a href="#description"><description></a></code></td>
+ <td colspan="3" style="border:none;"><code><a href="#access"><access></a></code></td>
</tr>
<tr>
<td style="border:none;"> </td>
<td style="border:none;"> </td>
- <td colspan="2" style="border:none;"><code><a href="#span"><span></a></code></td>
- </tr>
- <tr>
- <td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><a href="#author"><author></a></code></td>
+ <td colspan="2" style="border:none;"><code><tizen:icon></code></td>
</tr>
<tr>
<td style="border:none;"> </td>
<td style="border:none;"> </td>
- <td colspan="2" style="border:none;"><code><a href="#span"><span></a></code></td>
- </tr>
- <tr>
- <td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><a href="#content_element"><content></a></code></td>
+ <td colspan="2" style="border:none;"><code><tizen:display-name></code></td>
</tr>
<tr>
<td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><feature></code> (in <a href="#mw_feature">mobile</a> or <a href="#ww_feature">wearable</a>)</td>
- </tr>
- <tr>
<td style="border:none;"> </td>
+ <td colspan="2" style="border:none;"><code><tizen:capability></code></td>
+ </tr>
+ <tr>
<td style="border:none;"> </td>
- <td colspan="2" style="border:none;"><code><a href="#param"><param></a></code></td>
+ <td colspan="3" style="border:none;"><code><a href="#mw_account"><tizen:account></a></code> (in mobile only)</td>
</tr>
- <tr>
+ <tr>
<td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><a href="#icon"><icon></a></code></td>
+ <td colspan="3" style="border:none;"><code><tizen:allow-navigation></code> (in <a href="#mw_navigation">mobile</a> or <a href="#ww_allownavigation">wearable</a>)</td>
</tr>
- <tr>
+ <tr>
<td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><a href="#license"><license></a></code></td>
+ <td colspan="3" style="border:none;"><code><tizen:app-control></code> (in <a href="#mw_appcontrol">mobile</a> or <a href="#appcontrol">wearable</a>)</td>
</tr>
<tr>
<td style="border:none;"> </td>
<td style="border:none;"> </td>
- <td colspan="2" style="border:none;"><code><a href="#span"><span></a></code></td>
- </tr>
- <tr>
- <td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><a href="#preference"><preference></a></code></td>
+ <td colspan="2" style="border:none;"><code><tizen:src></code></td>
</tr>
<tr>
<td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><a href="#access"><access></a></code></td>
- </tr>
- <tr>
<td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><a href="#mw_account"><tizen:account></a></code> (in mobile only)</td>
+ <td colspan="2" style="border:none;"><code><tizen:operation></code></td>
</tr>
<tr>
<td style="border:none;"> </td>
<td style="border:none;"> </td>
- <td colspan="2" style="border:none;"><code><tizen:icon></code></td>
+ <td colspan="2" style="border:none;"><code><tizen:uri></code></td>
</tr>
<tr>
<td style="border:none;"> </td>
<td style="border:none;"> </td>
- <td colspan="2" style="border:none;"><code><tizen:display-name></code></td>
+ <td colspan="2" style="border:none;"><code><tizen:mime></code></td>
</tr>
+
<tr>
<td style="border:none;"> </td>
- <td style="border:none;"> </td>
- <td colspan="2" style="border:none;"><code><tizen:capability></code></td>
+ <td colspan="3" style="border:none;"><code><tizen:application></code> (in <a href="#mw_application">mobile</a> or <a href="#ww_application">wearable</a>)</td>
</tr>
+ <tr>
+ <td style="border:none;"> </td>
+ <td colspan="3" style="border:none;"><code><a href="#ww_webwidget"><tizen:app-widget></a></code> (in wearable only)</td>
+ </tr>
+ <tr>
+ <td style="border:none;"> </td>
+ <td style="border:none;"> </td>
+ <td colspan="2" style="border:none;"><code><a href="#ww_widget-label"><tizen:widget-label></a></code></td>
+ </tr>
+ <tr>
+ <td style="border:none;"> </td>
+ <td style="border:none;"> </td>
+ <td colspan="2" style="border:none;"><code><a href="#ww_widget-content"><tizen:widget-content></a></code></td>
+ </tr>
+ <tr>
+ <td style="border:none;"> </td>
+ <td style="border:none;"> </td>
+ <td style="border:none;"> </td>
+ <td style="border:none;"><code><a href="#ww_widget-size"><tizen:widget-size></a></code></td>
+ </tr>
+ <tr>
+ <td style="border:none;"> </td>
+ <td style="border:none;"> </td>
+ <td colspan="2" style="border:none;"><code><a href="#ww_widget-metadata"><tizen:widget-metadata></a></code></td>
+ </tr>
<tr>
<td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><tizen:app-control></code> (in <a href="#mw_appcontrol">mobile</a> or <a href="#appcontrol">wearable</a>)</td>
+ <td colspan="3" style="border:none;"><code><a href="#author"><author></a></code></td>
</tr>
- <tr>
+ <tr>
<td style="border:none;"> </td>
<td style="border:none;"> </td>
- <td colspan="2" style="border:none;"><code><tizen:src></code></td>
+ <td colspan="2" style="border:none;"><code><a href="#span"><span></a></code></td>
+ </tr>
+ <tr>
+ <td style="border:none;"> </td>
+ <td colspan="3" style="border:none;"><code><tizen:background-category></code> (in <a href="#mw_bg_category">mobile</a> or <a href="#ww_bg_category">wearable</a>)</td>
</tr>
- <tr>
- <td style="border:none;"> </td>
+ <tr>
+ <td style="border:none;"> </td>
+ <td colspan="3" style="border:none;"><code><a href="#ww_category"><tizen:category></a></code> (in wearable only)</td>
+ </tr>
+ <tr>
<td style="border:none;"> </td>
- <td colspan="2" style="border:none;"><code><tizen:operation></code></td>
+ <td colspan="3" style="border:none;"><code><a href="#content_element"><content></a></code></td>
</tr>
- <tr>
- <td style="border:none;"> </td>
+ <tr>
<td style="border:none;"> </td>
- <td colspan="2" style="border:none;"><code><tizen:uri></code></td>
+ <td colspan="3" style="border:none;"><code><tizen:content></code> (in <a href="#mw_webapp">mobile</a> or <a href="#ww_tizencontent">wearable</a>)</td>
</tr>
- <tr>
+ <tr>
<td style="border:none;"> </td>
- <td style="border:none;"> </td>
- <td colspan="2" style="border:none;"><code><tizen:mime></code></td>
+ <td colspan="3" style="border:none;"><code><tizen:content-security-policy></code> (in <a href="#mw_sec">mobile</a> or <a href="#ww_contentsecpolicy">wearable</a>)</td>
</tr>
<tr>
<td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><tizen:application></code> (in <a href="#mw_application">mobile</a> or <a href="#ww_application">wearable</a>)</td>
+ <td colspan="3" style="border:none;"><code><tizen:content-security-policy-report-only></code> (in <a href="#mw_secreport">mobile</a> or <a href="#ww_contentsecpolicyreport">wearable</a>)</td>
</tr>
-
<tr>
<td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><tizen:content></code> (in <a href="#mw_webapp">mobile</a> or <a href="#ww_tizencontent">wearable</a>)</td>
+ <td colspan="3" style="border:none;"><code><a href="#description"><description></a></code></td>
</tr>
<tr>
<td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><tizen:privilege></code> (in <a href="#mw_privilege">mobile</a> or <a href="#ww_privilege">wearable</a>)</td>
- </tr>
- <tr>
<td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><tizen:setting></code> (in <a href="#mw_setting">mobile</a> or <a href="#ww_setting">wearable</a>)</td>
- </tr>
- <tr>
- <td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><tizen:background-category></code> (in <a href="#mw_bg_category">mobile</a> or <a href="#ww_bg_category">wearable</a>)</td>
+ <td colspan="2" style="border:none;"><code><a href="#span"><span></a></code></td>
</tr>
+
<tr>
<td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><tizen:content-security-policy></code> (in <a href="#mw_sec">mobile</a> or <a href="#ww_contentsecpolicy">wearable</a>)</td>
+ <td colspan="3" style="border:none;"><code><feature></code> (in <a href="#mw_feature">mobile</a> or <a href="#ww_feature">wearable</a>)</td>
</tr>
<tr>
<td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><tizen:content-security-policy-report-only></code> (in <a href="#mw_secreport">mobile</a> or <a href="#ww_contentsecpolicyreport">wearable</a>)</td>
- </tr>
- <tr>
<td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><tizen:allow-navigation></code> (in <a href="#mw_navigation">mobile</a> or <a href="#ww_allownavigation">wearable</a>)</td>
+ <td colspan="2" style="border:none;"><code><a href="#param"><param></a></code></td>
</tr>
<tr>
<td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><tizen:metadata></code> (in <a href="#mw_metadata">mobile</a> or <a href="#ww_metadata">wearable</a>)</td>
+ <td colspan="3" style="border:none;"><code><a href="#icon"><icon></a></code></td>
</tr>
<tr>
<td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><tizen:profile></code> (in <a href="#mw_profile">mobile</a> or <a href="#ww_profile">wearable</a>)</td>
- </tr>
- <tr>
- <td style="border:none;"> </td>
<td colspan="3" style="border:none;"><code><a href="#ww_ime"><tizen:ime></a></code> (in wearable only)</td>
</tr>
<tr>
<td style="border:none;"><code><a href="#ww_language"><tizen:language></a></code></td>
</tr>
<tr>
+ <td style="border:none;"> </td>
+ <td colspan="3" style="border:none;"><code><a href="#license"><license></a></code></td>
+ </tr>
+ <tr>
+ <td style="border:none;"> </td>
+ <td style="border:none;"> </td>
+ <td colspan="2" style="border:none;"><code><a href="#span"><span></a></code></td>
+ </tr>
+ <tr>
+ <td style="border:none;"> </td>
+ <td colspan="3" style="border:none;"><code><tizen:metadata></code> (in <a href="#mw_metadata">mobile</a> or <a href="#ww_metadata">wearable</a>)</td>
+ </tr>
+ <tr>
+ <td style="border:none;"> </td>
+ <td colspan="3" style="border:none;"><code><a href="#name"><name></a></code></td>
+ </tr>
+ <tr>
+ <td style="border:none;"> </td>
+ <td style="border:none;"> </td>
+ <td colspan="2" style="border:none;"><code><a href="#span"><span></a></code></td>
+ </tr>
+ <tr>
+ <td style="border:none;"> </td>
+ <td colspan="3" style="border:none;"><code><a href="#preference"><preference></a></code></td>
+ </tr>
+ <tr>
+ <td style="border:none;"> </td>
+ <td colspan="3" style="border:none;"><code><tizen:privilege></code> (in <a href="#mw_privilege">mobile</a> or <a href="#ww_privilege">wearable</a>)</td>
+ </tr>
+ <tr>
<td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><a href="#ww_category"><tizen:category></a></code> (in wearable only)</td>
+ <td colspan="3" style="border:none;"><code><tizen:profile></code> (in <a href="#mw_profile">mobile</a> or <a href="#ww_profile">wearable</a>)</td>
</tr>
-
<tr>
<td style="border:none;"> </td>
<td colspan="3" style="border:none;"><code><a href="#ww_service"><tizen:service></a></code> (in wearable only)</td>
<td style="border:none;"> </td>
<td colspan="2" style="border:none;"><code><a href="#ww_service-category"><tizen:category></a></code></td>
</tr>
-
- <tr>
- <td style="border:none;"> </td>
- <td colspan="3" style="border:none;"><code><a href="#ww_webwidget"><tizen:app-widget></a></code> (in wearable only)</td>
- </tr>
- <tr>
- <td style="border:none;"> </td>
- <td style="border:none;"> </td>
- <td colspan="2" style="border:none;"><code><a href="#ww_widget-label"><tizen:widget-label></a></code></td>
- </tr>
- <tr>
- <td style="border:none;"> </td>
- <td style="border:none;"> </td>
- <td colspan="2" style="border:none;"><code><a href="#ww_widget-content"><tizen:widget-content></a></code></td>
- </tr>
- <tr>
- <td style="border:none;"> </td>
- <td style="border:none;"> </td>
- <td style="border:none;"> </td>
- <td style="border:none;"><code><a href="#ww_widget-size"><tizen:widget-size></a></code></td>
- </tr>
- <tr>
- <td style="border:none;"> </td>
- <td style="border:none;"> </td>
- <td colspan="2" style="border:none;"><code><a href="#ww_widget-metadata"><tizen:widget-metadata></a></code></td>
- </tr>
+ <tr>
+ <td style="border:none;"> </td>
+ <td colspan="3" style="border:none;"><code><tizen:setting></code> (in <a href="#mw_setting">mobile</a> or <a href="#ww_setting">wearable</a>)</td>
+ </tr>
</tbody>
</table>
</tr>
<tr>
<td>Represents the root element of a configuration document. <p><strong>Expected children:</strong></p>
-<p><code><name></code>, <code><description></code>, <code><author></code>, <code><license></code>, <code><icon></code>, <code><content></code>, <code><feature></code>, <code><preference></code>, <code><access></code>, <code><tizen:account></code>, <code><tizen:app-control></code>, <code><tizen:application></code>, <code><tizen:content></code>, <code><tizen:privilege></code>, <code><tizen:setting></code>, and <code><tizen:profile></code></p> <p><strong>Attributes:</strong></p>
+<p><code><access></code>, <code><tizen:account></code>, <code><tizen:app-control></code>, <code><tizen:application></code>, <code><author></code>, <code><content></code>, <code><tizen:content></code>, <code><description></code>, <code><feature></code>, <code><icon></code>, <code><license></code>, <code><name></code>, <code><preference></code>, <code><tizen:privilege></code>, <code><tizen:profile></code>, and <code><tizen:setting></code></p>
+<p><strong>Attributes:</strong></p>
<ul><li><code>xml:lang</code></li>
<li><code>dir</code></li>
<li><code>id</code></li>
</tr>
</tbody></table>
-<table id="name">
-<tbody>
-<tr>
- <th><name> element</th>
-</tr>
- <tr>
- <td>Represents the Web application name used for example, in the application menu. <p><strong>Expected children:</strong></p>
- <p><code><span></code> and <code><text node></code></p> <p><strong>Attributes:</strong></p>
- <ul><li><code>xml:lang</code></li>
- <li><code>dir</code></li>
- <li><code>short</code></li></ul>
- </td>
- </tr>
- </tbody></table>
-
-<table id="description">
+ <table id="access">
<tbody>
<tr>
- <th><description> element</th>
+ <th><access> element</th>
</tr>
<tr>
- <td>Represents text describing the purpose of the Web application. <p><strong>Expected children:</strong></p>
- <p><code><span></code> and <code><text node></code></p> <p><strong>Attributes:</strong></p>
- <ul><li><code>xml:lang</code></li>
- <li><code>dir</code></li></ul>
+ <td>Used to control network access from within a Web application and to request access to certain network resources from the user agent. <p><strong>Attributes:</strong></p>
+ <ul><li><code>origin</code></li>
+ <li><code>subdomains</code></li></ul>
</td>
</tr>
</tbody></table>
-<table id="author">
+ <table id="author">
<tbody>
<tr>
<th><author> element</th>
</tr>
</tbody></table>
-<table id="content_element">
+ <table id="content_element">
<tbody>
<tr>
<th><content> element</th>
</tr>
</tbody></table>
-<table id="icon">
+ <table id="description">
+<tbody>
+<tr>
+ <th><description> element</th>
+</tr>
+ <tr>
+ <td>Represents text describing the purpose of the Web application. <p><strong>Expected children:</strong></p>
+ <p><code><span></code> and <code><text node></code></p> <p><strong>Attributes:</strong></p>
+ <ul><li><code>xml:lang</code></li>
+ <li><code>dir</code></li></ul>
+ </td>
+ </tr>
+ </tbody></table>
+
+ <table id="icon">
<tbody>
<tr>
<th><icon> element</th>
</tr>
</tbody></table>
-<table id="preference">
+<table id="name">
<tbody>
<tr>
- <th><preference> element</th>
+ <th><name> element</th>
</tr>
<tr>
- <td>Used to declare preferences as key-value pairs for the Web application for use at runtime. <p><strong>Attributes:</strong></p>
- <ul>
- <li><code>name</code><p>The maximum length can be limited to 80 bytes. In that case, leftover bytes are ignored.</p></li>
- <li><code>value</code><p>The maximum length can be limited to 8192 bytes. In that case, leftover bytes are ignored.</p></li>
- <li><code>readonly</code></li>
- </ul>
+ <td>Represents the Web application name used for example, in the application menu. <p><strong>Expected children:</strong></p>
+ <p><code><span></code> and <code><text node></code></p> <p><strong>Attributes:</strong></p>
+ <ul><li><code>xml:lang</code></li>
+ <li><code>dir</code></li>
+ <li><code>short</code></li></ul>
</td>
</tr>
</tbody></table>
-<table id="access">
+
+<table id="param">
<tbody>
<tr>
- <th><access> element</th>
+ <th><param> element</th>
</tr>
<tr>
- <td>Used to control network access from within a Web application and to request access to certain network resources from the user agent. <p><strong>Attributes:</strong></p>
- <ul><li><code>origin</code></li>
- <li><code>subdomains</code></li></ul>
- </td>
+ <td>Used to declare parameters to be used with a feature in <a href="#mw_feature">mobile</a> and <a href="#ww_feature">wearable</a> applications.
+ <p><strong>Attributes:</strong></p>
+ <ul><li><code>xml:lang</code></li>
+ <li><code>dir</code></li>
+ <li><code>name</code></li>
+ <li><code>value</code></li></ul>
+ </td>
</tr>
</tbody></table>
-<table id="span">
+<table id="preference">
<tbody>
<tr>
- <th><span> element</th>
+ <th><preference> element</th>
</tr>
<tr>
- <td>Represents the generic container used mainly for internationalization. <p><strong>Expected children:</strong></p>
- <p><code><span></code> and <code><text node></code></p> <p><strong>Attributes:</strong></p>
- <ul><li><code>xml:lang</code></li>
- <li><code>dir</code></li></ul>
+ <td>Used to declare preferences as key-value pairs for the Web application for use at runtime. <p><strong>Attributes:</strong></p>
+ <ul>
+ <li><code>name</code><p>The maximum length can be limited to 80 bytes. In that case, leftover bytes are ignored.</p></li>
+ <li><code>value</code><p>The maximum length can be limited to 8192 bytes. In that case, leftover bytes are ignored.</p></li>
+ <li><code>readonly</code></li>
+ </ul>
</td>
</tr>
</tbody></table>
-<table id="param">
+<table id="span">
<tbody>
<tr>
- <th><param> element</th>
+ <th><span> element</th>
</tr>
<tr>
- <td>Used to declare parameters to be used with a feature in <a href="#mw_feature">mobile</a> and <a href="#ww_feature">wearable</a> applications.
- <p><strong>Attributes:</strong></p>
- <ul><li><code>xml:lang</code></li>
- <li><code>dir</code></li>
- <li><code>name</code></li>
- <li><code>value</code></li></ul>
+ <td>Represents the generic container used mainly for internationalization. <p><strong>Expected children:</strong></p>
+ <p><code><span></code> and <code><text node></code></p> <p><strong>Attributes:</strong></p>
+ <ul><li><code>xml:lang</code></li>
+ <li><code>dir</code></li></ul>
</td>
</tr>
</tbody></table>
+
<h2 id="mw_extend" name="mw_extend">Extending Configuration Elements in Mobile Applications</h2>
<p>The following sections show additional configuration elements used in the <code>config.xml</code> file of the Web application, but not included in the <a href="http://www.w3.org/TR/widgets/" target="_blank">Widget Packaging and XML Configuration guidelines</a>. For a quick view of the entire element hierarchy, see <a href="#hierarchy">Configuration Element Hierarchy</a>.</p>
</tr>
</tbody></table>
+ <h3 id="mw_navigation" name="mw_navigation">Tizen Navigation Policy</h3>
+<table>
+<tbody>
+<tr>
+ <th><tizen:allow-navigation /> element</th>
+</tr>
+ <tr>
+ <td>Used to define a list of URL domains that are allowed to be navigated in using the Web application.
+ <p><strong>Occurrences:</strong> </p>
+ <ul>
+ <li>0 or more
+ <p>If more than 1, the first occurrence is applied.</p></li>
+ </ul>
+<p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:allow-navigation>tizen.org *.tizen.org<tizen:allow-navigation/></pre>
+ </td>
+ </tr>
+ </tbody></table>
+
<h3 id="mw_appcontrol" name="mw_appcontrol">Tizen Application Control</h3>
<table>
<tbody>
</tr>
</tbody></table>
- <h3 id="mw_webapp" name="mw_webapp">Tizen-hosted Web Application</h3>
-<table>
-<tbody>
-<tr>
- <th><tizen:content /> element</th>
-</tr>
- <tr>
- <td>Used to point to a document which is hosted on an external server and acts as the Web application start page. The Tizen WRT allows the start page to be hosted on an external server.
- <p>If the start page is contained in the widget package, it is defined with the <a href="#content_element"><code><content></code> W3C element</a>. If both <code><content></code> and <code><tizen:content /></code> elements are defined, the <code><tizen:content /></code> element is used.</p>
- <p><strong>Occurrences:</strong> </p>
- <ul>
- <li>0 or more
- <p>If more than 1 <code><tizen:content /></code> element is specified, the first instance of the element is used.</p></li>
- </ul>
- <p><strong>Attributes:</strong> </p>
- <ul>
- <li><code>src</code><p>Mandatory; URI of the external start page</p></li>
- </ul>
-
- <p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:content src="https://www.tizen.org/" /></pre>
- </td>
- </tr>
- </tbody></table>
-
- <h3 id="mw_privilege" name="mw_privilege">Tizen Privilege</h3>
-<table>
-<tbody>
-<tr>
- <th><tizen:privilege /> element</th>
-</tr>
- <tr>
- <td>Used to get the required API access privileges for the Web application.
- <p><strong>Occurrences:</strong> </p>
- <ul>
- <li>0 or more (if duplicates, the first occurrence is considered and all others ignored)</li>
- </ul>
- <p><strong>Attributes:</strong> </p>
- <ul>
- <li><code>name</code><p> Mandatory; URI of the Device API privilege</p></li>
- </ul><p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:privilege name="http://tizen.org/privilege/application.launch" /></pre>
- </td>
- </tr>
- </tbody></table>
-
- <h3 id="mw_setting" name="mw_setting">Tizen Settings</h3>
-<table>
-<tbody>
-<tr>
- <th><tizen:setting /> element</th>
-</tr>
- <tr>
- <td>Used to define additional application settings.
- <p><strong>Occurrences:</strong> </p>
- <ul>
- <li>0 or more</li>
- </ul>
- <p><strong>Attributes:</strong> </p>
- <ul>
- <li><code>background-support</code>
- <p>Optional; application execution continues when it is moved to the background (available values: <code>enable</code> (execution continues on the background), <code>disable</code> (default; application is suspended))</p>
-<div class="note">
- <strong>Note</strong>
- Since Tizen 2.4, the system manages background processes more tightly. Even if the <code>background-support</code> attribute is set to <code>enable</code>, the Web application process can be suspended on the background. To guarantee that the application runs on the background, <a href="#mw_bg_category">add at least one background category</a> for the application with the <code><tizen:background-category></code> element. Only the background categories declared in the system can be used.
-</div>
- </li>
- <li><code>context-menu</code> <p>Optional; context menu is displayed when the user clicks, for example, an image, text, or link (available values: <code>enable</code> (default), <code>disable</code>)</p></li>
- <li><code>encryption</code> <p>Optional; Web application resources (HTML, JavaScript, and CSS files) are stored encrypted (available values: <code>enable</code>, <code>disable</code> (default))</p></li>
- <li><code>screen-orientation</code><p>Optional; viewport orientation lock (available values: <code>portrait</code> (default), <code>landscape</code>), auto-rotation</p>If the system auto rotation setting is on, the Web application viewport orientation is changed accordingly by default.</li>
- <li><code>install-location</code> <p>Optional; application installation location (available values: <code>auto</code> (default), <code>internal-only</code>, <code>prefer-external</code>)</p>
- <ul>
- <li><code>auto</code>: the system defines the installation location</li>
- <li><code>internal-only</code>: the application is installed in the device's internal storage</li>
- <li><code>prefer-external</code>: the application is installed in the external storage (if available)</li>
- </ul>
- </li>
- <li><code>hwkey-event</code> <p>Optional; a hardware key event is sent to the Web application when the user presses the hardware key (available values: <code>enable</code> (default), <code> disable</code>)</p><p>If this option is enabled, the <code>tizenhwkey</code> custom event is sent to the Web application. The <code>tizenhwkey</code> event object has a <code>keyName</code> attribute (available values: <code>menu</code> and <code>back</code>).</p></li>
-
-
- </ul><p><strong>Example:</strong> </p><pre class="prettyprint"><!--Web application execution is not suspended-->
-<!--when the application is sent to the background-->
-<tizen:setting background-support="enable" />
-
-<!--Context menu is not displayed-->
-<tizen:setting context-menu="disable" />
-
-<!--Web applications resources are stored encrypted by the WRT-->
-<tizen:setting encryption="enable" />
-
-<!--Viewport orientation is locked to "landscape"-->
-<tizen:setting screen-orientation="landscape" />
-
-<!--Installation location is set to "internal-only"-->
-<tizen:setting install-location="internal-only" />
-
-<!--Hardware key event is sent to the Web application when the hardware key is pressed-->
-<tizen:setting hwkey-event="enable" /></pre>
- </td>
- </tr>
- </tbody></table>
-
- <h3 id="mw_bg_category" name="mw_bg_category">Tizen Background Category</h3>
+ <h3 id="mw_bg_category" name="mw_bg_category">Tizen Background Category</h3>
<table>
<tbody>
<tr>
</tr>
</tbody></table>
- <h3 id="mw_feature" name="mw_feature">Tizen Feature</h3>
+ <h3 id="mw_webapp" name="mw_webapp">Tizen-hosted Web Application</h3>
<table>
<tbody>
<tr>
- <th><feature /> element</th>
+ <th><tizen:content /> element</th>
</tr>
<tr>
- <td>Used to define hardware and software components for a Tizen application. This attribute is only used in the Tizen Store for filtering purposes. It is ignored by the Web Runtime installation procedure.
-
-<div class="note">
- <strong>Note</strong>
- Even though the <code><feature /></code> element is defined in the Widget Packaging and XML Configuration guidelines, in Tizen, an extended version is used.
-</div>
-
+ <td>Used to point to a document which is hosted on an external server and acts as the Web application start page. The Tizen WRT allows the start page to be hosted on an external server.
+ <p>If the start page is contained in the widget package, it is defined with the <a href="#content_element"><code><content></code> W3C element</a>. If both <code><content></code> and <code><tizen:content /></code> elements are defined, the <code><tizen:content /></code> element is used.</p>
<p><strong>Occurrences:</strong> </p>
<ul>
- <li>0 or more</li>
+ <li>0 or more
+ <p>If more than 1 <code><tizen:content /></code> element is specified, the first instance of the element is used.</p></li>
</ul>
<p><strong>Attributes:</strong> </p>
<ul>
- <li><code>name</code> <p>Mandatory; <a href="../../../org.tizen.training/html/web/process/setting_properties_w.htm#feature">feature key</a> URI</p></li>
- </ul><p><strong>Example:</strong> </p><pre class="prettyprint"><feature name="http://tizen.org/feature/network.bluetooth" /></pre>
+ <li><code>src</code><p>Mandatory; URI of the external start page</p></li>
+ </ul>
+
+ <p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:content src="https://www.tizen.org/" /></pre>
</td>
</tr>
</tbody></table>
- <h3 id="mw_sec" name="mw_sec">Tizen Content Security Policy</h3>
+ <h3 id="mw_sec" name="mw_sec">Tizen Content Security Policy</h3>
<table>
<tbody>
<tr>
</tr>
</tbody></table>
- <h3 id="mw_navigation" name="mw_navigation">Tizen Navigation Policy</h3>
+ <h3 id="mw_feature" name="mw_feature">Tizen Feature</h3>
<table>
<tbody>
<tr>
- <th><tizen:allow-navigation /> element</th>
+ <th><feature /> element</th>
</tr>
<tr>
- <td>Used to define a list of URL domains that are allowed to be navigated in using the Web application.
+ <td>Used to define hardware and software components for a Tizen application. This attribute is only used in the Tizen Store for filtering purposes. It is ignored by the Web Runtime installation procedure.
+
+<div class="note">
+ <strong>Note</strong>
+ Even though the <code><feature /></code> element is defined in the Widget Packaging and XML Configuration guidelines, in Tizen, an extended version is used.
+</div>
+
<p><strong>Occurrences:</strong> </p>
<ul>
- <li>0 or more
- <p>If more than 1, the first occurrence is applied.</p></li>
+ <li>0 or more</li>
</ul>
-<p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:allow-navigation>tizen.org *.tizen.org<tizen:allow-navigation/></pre>
+ <p><strong>Attributes:</strong> </p>
+ <ul>
+ <li><code>name</code> <p>Mandatory; <a href="../../../org.tizen.training/html/web/process/setting_properties_w.htm#feature">feature key</a> URI</p></li>
+ </ul><p><strong>Example:</strong> </p><pre class="prettyprint"><feature name="http://tizen.org/feature/network.bluetooth" /></pre>
</td>
</tr>
</tbody></table>
- <h3 id="mw_metadata" name="mw_metadata">Tizen Metadata</h3>
+ <h3 id="mw_metadata" name="mw_metadata">Tizen Metadata</h3>
<table>
<tbody>
<tr>
</tr>
</tbody></table>
-<h3 id="mw_profile" name="mw_profile">Tizen Profile</h3>
+ <h3 id="mw_privilege" name="mw_privilege">Tizen Privilege</h3>
+<table>
+<tbody>
+<tr>
+ <th><tizen:privilege /> element</th>
+</tr>
+ <tr>
+ <td>Used to get the required API access privileges for the Web application.
+ <p><strong>Occurrences:</strong> </p>
+ <ul>
+ <li>0 or more (if duplicates, the first occurrence is considered and all others ignored)</li>
+ </ul>
+ <p><strong>Attributes:</strong> </p>
+ <ul>
+ <li><code>name</code><p> Mandatory; URI of the Device API privilege</p></li>
+ </ul><p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:privilege name="http://tizen.org/privilege/application.launch" /></pre>
+ </td>
+ </tr>
+ </tbody></table>
+
+ <h3 id="mw_profile" name="mw_profile">Tizen Profile</h3>
<table>
<tbody>
<tr>
</td>
</tr>
</tbody></table>
-
-<h2 id="ww_extend" name="ww_extend">Extending Configuration Elements in Wearable Applications</h2>
- <p>The following sections show additional configuration elements used in the <code>config.xml</code> file of the Web application, but not included in the <a href="http://www.w3.org/TR/widgets/" target="_blank">Widget Packaging and XML Configuration guidelines</a>. For a quick view of the entire element hierarchy, see <a href="#hierarchy">Configuration Element Hierarchy</a>.</p>
-
-<div class="note">
- <strong>Note</strong>
- The extension elements are denoted as though the <code>xmlns:tizen="http://tizen.org/ns/widgets"</code> namespace declaration was in effect.
- <p>The maximum length of the attribute and the element (except <code>tizen:metadata</code>, W3C preference element) can be limited to 2048 bytes. In that case, leftover bytes are ignored.</p>
-</div>
-
- <h3 id="ww_application" name="ww_application">Tizen Application</h3>
+
+ <h3 id="mw_setting" name="mw_setting">Tizen Settings</h3>
<table>
<tbody>
<tr>
- <th><tizen:application /> element</th>
+ <th><tizen:setting /> element</th>
</tr>
<tr>
- <td> Used to uniquely identify a Tizen wearable application.
- <p><strong>Occurrences:</strong> </p>
- <ul>
- <li>1</li>
- </ul>
- <p><strong>Attributes:</strong> </p>
- <ul>
- <li><code>id</code> <p>Mandatory; Tizen application ID, which is a combination of the Tizen wearable package ID and project name. The application ID is unique in the device.</p><p>The project name is a set of characters (0~9, a~z, A~Z) randomly generated by the Tizen Studio. The minimum value is 1 byte and maximum value is 52 bytes.</p></li>
- <li><code>package</code> <p>Mandatory; Tizen wearable package ID generated by the Tizen Studio, comprises of 10 characters (0~9, a~z, A~Z). The package ID is unique in the Samsung Apps.</p></li>
- <li><code>required_version</code> <p>Mandatory; Tizen API version required for running the Web application</p></li>
- <li><code>launch_mode</code> <p>Optional; sets which launch mode is supported (available values: <code>single</code> (default), <code>group</code>, <code>caller</code>)</p>
- <ul><li><code>single</code>: launched as a main application</li>
- <li><code>group</code>: launched as a sub application</li>
- <li><code>caller</code>: caller application defines the launch mode with the <code>app_control_set_launch_mode()</code> method</li></ul>
- <p><strong>Since: 2.4</strong></p>
+ <td>Used to define additional application settings.
+ <p><strong>Occurrences:</strong> </p>
+ <ul>
+ <li>0 or more</li>
+ </ul>
+ <p><strong>Attributes:</strong> </p>
+ <ul>
+ <li><code>screen-orientation</code><p>Optional; viewport orientation lock (available values: <code>portrait</code> (default), <code>landscape</code>), auto-rotation</p>If the system auto rotation setting is on, the Web application viewport orientation is changed accordingly by default.</li>
+ <li><code>context-menu</code> <p>Optional; context menu is displayed when the user clicks, for example, an image, text, or link (available values: <code>enable</code> (default), <code>disable</code>)</p></li>
+ <li><code>background-support</code>
+ <p>Optional; application execution continues when it is moved to the background (available values: <code>enable</code> (execution continues on the background), <code>disable</code> (default; application is suspended))</p>
<div class="note">
<strong>Note</strong>
- The <code>launch_mode</code> attribute is supported from Tizen 2.4 onwards. If the <code>required_version</code> in the application's <code>config.xml</code> file is set to a version older than Tizen 2.4, and the <code>launch_mode</code> attribute is used, the application installation fails.
+ Since Tizen 2.4, the system manages background processes more tightly. Even if the <code>background-support</code> attribute is set to <code>enable</code>, the Web application process can be suspended on the background. To guarantee that the application runs on the background, <a href="#mw_bg_category">add at least one background category</a> for the application with the <code><tizen:background-category></code> element. Only the background categories declared in the system can be used.
</div>
- </li>
- <li><code>ambient_support</code> <p>Optional; sets whether the Web application supports the ambient mode (available values: <code>enable</code>, <code>disable</code> (default))</p><p>If this option is enabled, the application can be shown in the ambient mode.</p><strong>Since: 2.3.1</strong>
-
-<div class="note">
- <strong>Note</strong>
- The <code>ambient_support</code> option is only used for watch applications, and ignored in all non-watch applications.
- <p>The <code>ambient_support</code> attribute is supported from Tizen 2.3.1 onwards. If the <code>required_version</code> in the application's <code>config.xml</code> file is set to a version older than Tizen 2.3.1, and the <code>ambient_support</code> attribute is used, the application installation fails.</p>
-</div>
-</li>
- </ul><p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:application id="1234abcDEF.projectname"
- package="1234abcDEF"
- required_version="2.4"
- ambient_support="enable" /></pre>
+ </li>
+ <li><code>encryption</code> <p>Optional; Web application resources (HTML, JavaScript, and CSS files) are stored encrypted (available values: <code>enable</code>, <code>disable</code> (default))</p></li>
+ <li><code>install-location</code> <p>Optional; application installation location (available values: <code>auto</code> (default), <code>internal-only</code>, <code>prefer-external</code>)</p>
+ <ul>
+ <li><code>auto</code>: the system defines the installation location</li>
+ <li><code>internal-only</code>: the application is installed in the device's internal storage</li>
+ <li><code>prefer-external</code>: the application is installed in the external storage (if available)</li>
+ </ul>
+ </li>
+ <li><code>hwkey-event</code> <p>Optional; a hardware key event is sent to the Web application when the user presses the hardware key (available values: <code>enable</code> (default), <code> disable</code>)</p><p>If this option is enabled, the <code>tizenhwkey</code> custom event is sent to the Web application. The <code>tizenhwkey</code> event object has a <code>keyName</code> attribute (available values: <code>menu</code> and <code>back</code>).</p></li>
+
+
+ </ul><p><strong>Example:</strong> </p><pre class="prettyprint">
+<!--Viewport orientation is locked to "landscape"-->
+<tizen:setting screen-orientation="landscape" />
+
+<!--Context menu is not displayed-->
+<tizen:setting context-menu="disable" />
+
+<!--Web application execution is not suspended-->
+<!--when the application is sent to the background-->
+<tizen:setting background-support="enable" />
+
+<!--Web applications resources are stored encrypted by the WRT-->
+<tizen:setting encryption="enable" />
+
+<!--Installation location is set to "internal-only"-->
+<tizen:setting install-location="internal-only" />
+
+<!--Hardware key event is sent to the Web application when the hardware key is pressed-->
+<tizen:setting hwkey-event="enable" /></pre>
</td>
</tr>
</tbody></table>
-
- <h3 id="ww_privilege" name="ww_privilege">Tizen Privilege</h3>
-<table>
+
+<h2 id="ww_extend" name="ww_extend">Extending Configuration Elements in Wearable Applications</h2>
+ <p>The following sections show additional configuration elements used in the <code>config.xml</code> file of the Web application, but not included in the <a href="http://www.w3.org/TR/widgets/" target="_blank">Widget Packaging and XML Configuration guidelines</a>. For a quick view of the entire element hierarchy, see <a href="#hierarchy">Configuration Element Hierarchy</a>.</p>
+
+<div class="note">
+ <strong>Note</strong>
+ The extension elements are denoted as though the <code>xmlns:tizen="http://tizen.org/ns/widgets"</code> namespace declaration was in effect.
+ <p>The maximum length of the attribute and the element (except <code>tizen:metadata</code>, W3C preference element) can be limited to 2048 bytes. In that case, leftover bytes are ignored.</p>
+</div>
+
+ <h3 id="ww_allownavigation" name="ww_allownavigation">Tizen Navigation Policy</h3>
+ <table>
<tbody>
<tr>
- <th><tizen:privilege /> element</th>
+ <th><tizen:allow-navigation /> element</th>
</tr>
<tr>
- <td>Used to get the required API access privileges for the Web application.
+ <td>Used to define a list of URL domains that are allowed to be navigated in using the Web application.
<p><strong>Occurrences:</strong> </p>
<ul>
- <li>0 or more</li>
+ <li>0 or more
+ <p>If more than 1, the first occurrence is applied.</p></li>
</ul>
- <p><strong>Attributes:</strong> </p>
- <ul>
- <li><code>name</code><p> Mandatory; URI of the Device API privilege</p></li>
- </ul><p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:privilege name="http://tizen.org/privilege/application.launch" /></pre>
+<p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:allow-navigation>tizen.org *.tizen.org<tizen:allow-navigation/></pre>
</td>
</tr>
</tbody></table>
</tr>
</tbody></table>
- <h3 id="ww_setting" name="ww_setting">Tizen Settings</h3>
+ <h3 id="ww_webwidget" name="ww_webwidget">Tizen Web Widget</h3>
<table>
<tbody>
<tr>
- <th><tizen:setting /> element</th>
+ <th><tizen:app-widget /> element</th>
</tr>
<tr>
- <td>Used to define additional application settings.
+ <td>Used to define the basic information about a Web widget.
+ <p><strong>Occurrences:</strong> </p>
+ <ul>
+ <li>0 or more</li>
+ </ul>
+ <p><strong>Expected children:</strong> </p>
+ <ul>
+ <li><a href="#ww_widget-label"><tizen:widget-label /></a></li>
+ <li><a href="#ww_widget-content"><tizen:widget-content /></a></li>
+ <li><a href="#ww_widget-metadata"><tizen:widget-metadata /></a></li>
+ </ul>
+ <p><strong>Attributes:</strong> </p>
+ <ul>
+ <li><code>id</code> <p>Mandatory; unique ID of the Web widget in the <code><TIZEN_APPLICATION_ID>.<STRING></code> format, where <code><STRING></code> comprises 1 or more characters (0~9, a~z, A~Z)</p></li>
+ <li><code>primary</code> <p>Mandatory; defines a primary Web widget among the Web widgets in a Web application (available values: <code>true</code>, <code>false</code>)</p></li>
+ <li><code>max-instance</code> <p>Optional; limits the number of widget instances concurrently executable for a Web application. When omitted or its value is 0, unlimited number of widget instances are supported. The expected value is <code>integer</code>.</p></li>
+ </ul>
+ <p><strong>Example:</strong> </p>
+<pre class="prettyprint">
+<tizen:app-widget id="EHtuCWfzcr.Widget.Widget" primary="true" max-instance="0">
+ <tizen:widget-label>Hello Web Widget!</tizen:widget-label>
+ <tizen:widget-content src="index.html">
+ <tizen:widget-size preview="preview.png">2x2</tizen:widget-size>
+ </tizen:widget-content>
+ <tizen:widget-metadata key="index" value="2"/>
+</tizen:app-widget>
+</pre>
+ </td>
+ </tr>
+ </tbody></table>
+
+<table id="ww_widget-label">
+<tbody>
+<tr>
+ <th><tizen:widget-label /> element</th>
+</tr>
+ <tr>
+ <td>Used to define the name of Web widget.
<p><strong>Occurrences:</strong> </p>
<ul>
- <li>0 or more</li>
+ <li>1 or more</li>
</ul>
<p><strong>Attributes:</strong> </p>
<ul>
-
- <li><code>background-support</code>
- <p>Optional; application execution continues when it is moved to the background (available values: <code>enable</code> (execution continues on the background), <code>disable</code> (default; application is suspended))</p>
+ <li><code>xml:lang</code> <p>Optional; specifies the language of the box label (for available values, see <a href="http://www.iana.org/assignments/language-subtag-registry" target="_blank">the IANA Language Subtag</a>)</p></li>
+ </ul>
+ </td>
+ </tr>
+ </tbody></table>
+
+<table id="ww_widget-content">
+<tbody>
+<tr>
+ <th><tizen:widget-content /> element</th>
+</tr>
+ <tr>
+ <td>Used to define the starting page of the Web widget.
+ <p><strong>Occurrences:</strong> </p>
+ <ul>
+ <li>1</li>
+ </ul>
+ <p><strong>Expected children:</strong> </p>
+ <ul>
+ <li><a href="#ww_widget-size"><tizen:widget-size /></a></li>
+ </ul>
+ <p><strong>Attributes:</strong> </p>
+ <ul>
+ <li><code>src</code> <p>Mandatory; local file path, relative to the source Web application directory of the widget starting page</p></li>
+ </ul>
+ </td>
+ </tr>
+ </tbody></table>
+
+<table id="ww_widget-size">
+<tbody>
+<tr>
+ <th><tizen:widget-size /> element</th>
+</tr>
+ <tr>
+ <td>Used to define the size of the Web widget.
+ <p><strong>Occurrences:</strong> </p>
+ <ul>
+ <li>1</li>
+ </ul>
+ <p><strong>Attributes:</strong> </p>
+ <ul>
+ <li><code>preview</code> <p>Mandatory; image file path, relative to the source Web application directory of the box content displayed in the widget viewer</p></li>
+ </ul>
+ </td>
+ </tr>
+ </tbody></table>
+
+<table id="ww_widget-metadata">
+<tbody>
+<tr>
+ <th><tizen:widget-metadata /> element</th>
+</tr>
+ <tr>
+ <td>Used to define a (key, value) pair that can be read by a Web widget through the WidgetService API. Its main use is to allow you to define a constant to be read by a Web widget.
+ <p><strong>Occurrences:</strong> </p>
+ <ul>
+ <li>1 or more</li>
+ </ul>
+ <p><strong>Attributes:</strong> </p>
+ <ul>
+ <li><code>key</code> <p>Mandatory; string.</p></li>
+ <li><code>value</code> <p>Mandatory; string.</p></li>
+ </ul>
+ </td>
+ </tr>
+ </tbody></table>
+
+ <h3 id="ww_application" name="ww_application">Tizen Application</h3>
+<table>
+<tbody>
+<tr>
+ <th><tizen:application /> element</th>
+</tr>
+ <tr>
+ <td> Used to uniquely identify a Tizen wearable application.
+ <p><strong>Occurrences:</strong> </p>
+ <ul>
+ <li>1</li>
+ </ul>
+ <p><strong>Attributes:</strong> </p>
+ <ul>
+ <li><code>id</code> <p>Mandatory; Tizen application ID, which is a combination of the Tizen wearable package ID and project name. The application ID is unique in the device.</p><p>The project name is a set of characters (0~9, a~z, A~Z) randomly generated by the Tizen Studio. The minimum value is 1 byte and maximum value is 52 bytes.</p></li>
+ <li><code>package</code> <p>Mandatory; Tizen wearable package ID generated by the Tizen Studio, comprises of 10 characters (0~9, a~z, A~Z). The package ID is unique in the Samsung Apps.</p></li>
+ <li><code>required_version</code> <p>Mandatory; Tizen API version required for running the Web application</p></li>
+
+ <li><code>ambient_support</code> <p>Optional; sets whether the Web application supports the ambient mode (available values: <code>enable</code>, <code>disable</code> (default))</p><p>If this option is enabled, the application can be shown in the ambient mode.</p><strong>Since: 2.3.1</strong>
+
<div class="note">
<strong>Note</strong>
- Since Tizen 2.4, the system manages background processes more tightly. Even if the <code>background-support</code> attribute is set to <code>enable</code>, the Web application process can be suspended on the background. To guarantee that the application runs on the background, <a href="#ww_bg_category">add at least one background category</a> for the application with the <code><tizen:background-category></code> element. Only the background categories declared in the system can be used.
+ The <code>ambient_support</code> option is only used for watch applications, and ignored in all non-watch applications.
+ <p>The <code>ambient_support</code> attribute is supported from Tizen 2.3.1 onwards. If the <code>required_version</code> in the application's <code>config.xml</code> file is set to a version older than Tizen 2.3.1, and the <code>ambient_support</code> attribute is used, the application installation fails.</p>
</div>
- </li>
- <li><code>context-menu</code> <p>Optional; sets whether the context menu is shown (available values: <code>enable</code> (default), <code>disable</code>)</p><p>If this option is enabled, the context menu is visible to the user.</p></li>
- <li><code>encryption</code> <p>Optional; sets whether Web Application resources are encrypted (available values: <code>enable</code>, <code>disable</code> (default))</p><p>If this option is enabled, the application resources(HTML, JS and CSS files) are encrypted.</p></li>
- <li><code>screen-orientation</code> <p>Optional; sets whether it locks the orientation of the Web Application (available values: <code>portrait</code> (default), <code>landscape</code>, <code>auto-rotation</code>)</p>
- <ul><li><code>portrait</code> or <code>landscape</code>: orientation is locked to portrait or landscape respectively</li>
- <li><code>auto-rotation</code>: follows the device orientation setting</li></ul>
- </li>
- <li><code>install-location</code> <p>Optional; application installation location (available values: <code>auto</code> (default), <code>internal-only</code>, <code>prefer-external</code>)</p>
- <ul>
- <li><code>auto</code>: the system defines the installation location</li>
- <li><code>internal-only</code>: the application is installed in the device's internal storage</li>
- <li><code>prefer-external</code>: the application is installed in the external storage (if available)</li>
- </ul>
- </li>
-
- <li><code>hwkey-event</code> <p>Optional; a hardware key event is sent to the Web application when the user presses the hardware key (available values: <code>enable</code> (default), <code>disable</code>)</p><p>If this option is enabled, the <code>tizenhwkey</code> custom event is sent to the Web application. The <code>tizenhwkey</code> event object has a <code>keyName</code> attribute (available value: <code>back</code>).</p></li>
-
- </ul><p><strong>Example:</strong> </p><pre class="prettyprint">
-<tizen:setting background-support="enable" />
-<tizen:setting context-menu="disable" />
-<tizen:setting encryption="enable" />
-<tizen:setting screen-orientation="landscape" />
-<tizen:setting install-location="internal-only" />
-<tizen:setting hwkey-event="enable" />
-</pre>
+</li>
+<li><code>launch_mode</code> <p>Optional; sets which launch mode is supported (available values: <code>single</code> (default), <code>group</code>, <code>caller</code>)</p>
+ <ul><li><code>single</code>: launched as a main application</li>
+ <li><code>group</code>: launched as a sub application</li>
+ <li><code>caller</code>: caller application defines the launch mode with the <code>app_control_set_launch_mode()</code> method</li></ul>
+ <p><strong>Since: 2.4</strong></p>
+<div class="note">
+ <strong>Note</strong>
+ The <code>launch_mode</code> attribute is supported from Tizen 2.4 onwards. If the <code>required_version</code> in the application's <code>config.xml</code> file is set to a version older than Tizen 2.4, and the <code>launch_mode</code> attribute is used, the application installation fails.
+</div>
+ </li>
+ </ul><p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:application id="1234abcDEF.projectname"
+ package="1234abcDEF"
+ required_version="2.4"
+ ambient_support="enable" /></pre>
</td>
</tr>
</tbody></table>
- <h3 id="ww_bg_category" name="ww_bg_category">Tizen Background Category</h3>
+ <h3 id="ww_bg_category" name="ww_bg_category">Tizen Background Category</h3>
<table>
<tbody>
<tr>
</td>
</tr>
</tbody></table>
-
- <h3 id="ww_tizencontent" name="ww_tizencontent">Tizen Content</h3>
+
+ <h3 id="ww_category" name="ww_category">Tizen Category</h3>
+<table>
+<tbody>
+<tr>
+ <th><tizen:category /> element</th>
+</tr>
+ <tr>
+ <td>Used to define the categories to which the service application belongs.
+ <p><strong>Occurrences:</strong> </p>
+ <ul>
+ <li>0 or more</li>
+ </ul>
+ <p><strong>Attributes:</strong> </p>
+ <ul>
+ <li><code>name</code> <p>Mandatory; string</p></li>
+ </ul><p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:category name="http://tizen.org/category/wearable_clock" /></pre>
+ </td>
+ </tr>
+ </tbody></table>
+
+ <h3 id="ww_tizencontent" name="ww_tizencontent">Tizen Content</h3>
<table>
<tbody>
<tr>
</tizen:content-security-policy-report-only></pre>
</td>
</tr>
- </tbody></table>
-
- <h3 id="ww_allownavigation" name="ww_allownavigation">Tizen Navigation Policy</h3>
- <table>
-<tbody>
-<tr>
- <th><tizen:allow-navigation /> element</th>
-</tr>
- <tr>
- <td>Used to define a list of URL domains that are allowed to be navigated in using the Web application.
- <p><strong>Occurrences:</strong> </p>
- <ul>
- <li>0 or more
- <p>If more than 1, the first occurrence is applied.</p></li>
- </ul>
-<p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:allow-navigation>tizen.org *.tizen.org<tizen:allow-navigation/></pre>
- </td>
- </tr>
</tbody></table>
- <h3 id="ww_metadata" name="ww_metadata">Tizen Metadata</h3>
- <table>
+ <h3 id="ww_feature" name="ww_feature">Tizen Feature</h3>
+<table>
<tbody>
<tr>
- <th><tizen:metadata /> element</th>
+ <th><feature /> element</th>
</tr>
<tr>
- <td>Used to define metadata information shared with other Web applications. The defined metadata can be accessed (read-only) through the Tizen <a href="../../../org.tizen.web.apireference/html/device_api/wearable/tizen/application.html">Application</a> API.
- <p><strong>Occurrences:</strong> </p>
- <ul>
- <li>0 or more</li>
- </ul>
- <p><strong>Attributes:</strong> </p>
- <ul>
- <li><code>key</code>
- <p>Mandatory; unique key string.</p>
- <p>The maximum length can be limited to 80 bytes. In that case, leftover bytes are ignored.</p>
- </li>
- <li><code>value</code>
- <p>Optional; string.</p>
- <p>The maximum length can be limited to 8192 bytes. In that case, leftover bytes are ignored.</p>
- </li>
- </ul><p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:metadata key="key1"/>
-<tizen:metadata key="key2" value="value/></pre>
+ <td>Used to define the hardware and software components for a Tizen wearable Web application. This attribute is only used in the Samsung Apps for filtering purposes. It is ignored by the Web Runtime installation procedure.
+
+<div class="note">
+ <strong>Note</strong>
+ Even though the <code><feature /></code> element is defined in the Widget Packaging and XML Configuration guidelines, in Tizen, an extended version is used.
+</div>
+
+ <p><strong>Occurrences:</strong> </p>
+ <ul>
+ <li>0 or more</li>
+ </ul>
+ <p><strong>Attributes:</strong> </p>
+ <ul>
+ <li><code>name</code> <p>Mandatory; <a href="../../../org.tizen.training/html/web/process/setting_properties_w.htm#feature">feature key</a> URI</p></li>
+ </ul><p><strong>Example:</strong> </p><pre class="prettyprint"><feature name="http://tizen.org/feature/network.bluetooth" /></pre>
</td>
</tr>
</tbody></table>
- <h3 id="ww_ime" name="ww_ime">Tizen IME</h3>
+ <h3 id="ww_ime" name="ww_ime">Tizen IME</h3>
<table>
<tbody>
<tr>
<tizen:languages>
<tizen:language>en-us</tizen:language>
<tizen:language>de-de</tizen:language>
- </tizen:languages>
-</tizen:ime>
-
-<tizen:category name="http://tizen.org/category/ime"/></pre>
- </td>
- </tr>
- </tbody></table>
-
-<table id="ww_language">
-<tbody>
-<tr>
- <th><tizen:language /> element</th>
-</tr>
- <tr>
- <td>Used to define the supported input language of the current IME type application.
- <p><strong>Occurrences:</strong> </p>
- <ul>
- <li>1 or more</li>
- </ul>
- <p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:languages>
- <tizen:language>en-us</tizen:language>
- <tizen:language>de-de</tizen:language>
-</tizen:languages></pre>
- </td>
- </tr>
- </tbody></table>
-
- <h3 id="ww_category" name="ww_category">Tizen Category</h3>
-<table>
-<tbody>
-<tr>
- <th><tizen:category /> element</th>
-</tr>
- <tr>
- <td>Used to define the categories to which the service application belongs.
- <p><strong>Occurrences:</strong> </p>
- <ul>
- <li>0 or more</li>
- </ul>
- <p><strong>Attributes:</strong> </p>
- <ul>
- <li><code>name</code> <p>Mandatory; string</p></li>
- </ul><p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:category name="http://tizen.org/category/wearable_clock" /></pre>
- </td>
- </tr>
- </tbody></table>
-
- <h3 id="ww_service" name="ww_service">Tizen Service</h3>
-<table>
-<tbody>
-<tr>
- <th><tizen:service /> element</th>
-</tr>
- <tr>
- <td>Used to define Web Service Application.
-
- <p><strong>Occurrences:</strong> </p>
- <ul>
- <li>0 or more</li>
- </ul>
- <p><strong>Expected children:</strong> </p>
- <ul>
- <li><a href="#ww_service-name"><tizen:name /></a></li>
- <li><a href="#ww_service-icon"><tizen:icon /></a></li>
- <li><a href="#ww_service-content"><tizen:content /></a></li>
- <li><a href="#ww_service-description"><tizen:description /></a></li>
- <li><a href="#ww_service-metadata"><tizen:metadata /></a></li>
- <li><a href="#ww_service-category"><tizen:category /></a></li>
- </ul>
- <p><strong>Attributes:</strong> </p>
- <ul>
- <li><code>id</code> <p>Mandatory; Tizen service ID, which is a combination of the Tizen wearable package ID and service name.</p><p>The service ID is a set of characters (0~9, a~z, A~Z) and unique in the device. The minimum value is 1 byte and maximum value is 52 bytes.</p></li>
- </ul>
- <ul>
- <li><code>auto-restart</code> <p>Optional; sets whether the service application is relaunched automatically when it is terminated (available values: <code>true</code>, <code>false</code> (default))</p></li>
- </ul>
- <ul>
- <li><code>on-boot</code> <p>Optional; sets whether the service application is launched automatically on device booting time (available values: <code>true</code>, <code>false</code> (default))</p></li>
- </ul>
- <p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:service id="webService.application" auto-restart="true" on-boot="false">
- <tizen:name>WebService</tizen:name>
- <tizen:icon src="service-icon.png"/>
- <tizen:content src="service/service.js"/>
- <tizen:description>Web Service Application</tizen:description>
- <tizen:metadata key="key1" value="value1"/>
- <tizen:category name="http://tizen.org/category/service"/>
-<tizen:service></pre>
- </td>
- </tr>
- </tbody></table>
-
-<table id="ww_service-name">
-<tbody>
-<tr>
- <th><tizen:name /> element</th>
-</tr>
- <tr>
- <td>Used to define the name of Web Service Application.
- <p><strong>Occurrences:</strong> </p>
- <ul>
- <li>1 or more</li>
- </ul>
- <p><strong>Attributes:</strong> </p>
- <ul>
- <li><code>xml:lang</code> <p>Optional; specifies the language of the service name (for available values, see <a href="http://www.iana.org/assignments/language-subtag-registry" target="_blank">the IANA Language Subtag</a>)</p></li>
- </ul>
+ </tizen:languages>
+</tizen:ime>
+
+<tizen:category name="http://tizen.org/category/ime"/></pre>
</td>
</tr>
</tbody></table>
-<table id="ww_service-icon">
+<table id="ww_language">
<tbody>
<tr>
- <th><tizen:icon /> element</th>
+ <th><tizen:language /> element</th>
</tr>
<tr>
- <td>Used to define the icon of Web Service Application.
+ <td>Used to define the supported input language of the current IME type application.
<p><strong>Occurrences:</strong> </p>
<ul>
- <li>0 or 1</li>
+ <li>1 or more</li>
</ul>
- <p><strong>Attributes:</strong> </p>
- <ul>
- <li><code>src</code> <p>Mandatory; file path of the Web Service Application icon. The path is relative to the source Web application directory.</p></li>
- </ul>
+ <p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:languages>
+ <tizen:language>en-us</tizen:language>
+ <tizen:language>de-de</tizen:language>
+</tizen:languages></pre>
</td>
</tr>
</tbody></table>
-<table id="ww_service-content">
+ <h3 id="ww_metadata" name="ww_metadata">Tizen Metadata</h3>
+ <table>
<tbody>
<tr>
- <th><tizen:content /> element</th>
+ <th><tizen:metadata /> element</th>
</tr>
<tr>
- <td>Used to define the start page of the Web Service Application.
+ <td>Used to define metadata information shared with other Web applications. The defined metadata can be accessed (read-only) through the Tizen <a href="../../../org.tizen.web.apireference/html/device_api/wearable/tizen/application.html">Application</a> API.
<p><strong>Occurrences:</strong> </p>
<ul>
- <li>1</li>
+ <li>0 or more</li>
</ul>
<p><strong>Attributes:</strong> </p>
<ul>
- <li><code>src</code> <p>Mandatory; start JavaScript file path of the Web Service Application. The path is relative to the source Web application directory.</p></li>
- </ul>
+ <li><code>key</code>
+ <p>Mandatory; unique key string.</p>
+ <p>The maximum length can be limited to 80 bytes. In that case, leftover bytes are ignored.</p>
+ </li>
+ <li><code>value</code>
+ <p>Optional; string.</p>
+ <p>The maximum length can be limited to 8192 bytes. In that case, leftover bytes are ignored.</p>
+ </li>
+ </ul><p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:metadata key="key1"/>
+<tizen:metadata key="key2" value="value/></pre>
</td>
</tr>
</tbody></table>
-<table id="ww_service-description">
+ <h3 id="ww_privilege" name="ww_privilege">Tizen Privilege</h3>
+<table>
<tbody>
<tr>
- <th><tizen:description /> element</th>
+ <th><tizen:privilege /> element</th>
</tr>
<tr>
- <td>Used to define the description of the Web Service Application.
+ <td>Used to get the required API access privileges for the Web application.
<p><strong>Occurrences:</strong> </p>
<ul>
- <li>0 or 1</li>
+ <li>0 or more</li>
</ul>
+ <p><strong>Attributes:</strong> </p>
+ <ul>
+ <li><code>name</code><p> Mandatory; URI of the Device API privilege</p></li>
+ </ul><p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:privilege name="http://tizen.org/privilege/application.launch" /></pre>
</td>
</tr>
</tbody></table>
-<table id="ww_service-metadata">
+ <h3 id="ww_profile" name="ww_profile">Tizen Profile</h3>
+<table>
<tbody>
<tr>
- <th><tizen:metadata /> element</th>
+ <th><tizen:profile /> element</th>
</tr>
<tr>
- <td>Used to define metadata information shared with other Web Applications. The defined metadata can be accessed (read-only) through the Tizen Application API.
+ <td>Used to define the application profile.
<p><strong>Occurrences:</strong> </p>
<ul>
- <li>0 or more</li>
+ <li>1</li>
</ul>
<p><strong>Attributes:</strong> </p>
<ul>
- <li><code>key</code> <p>Mandatory; unique key string</p></li>
- <li><code>value</code> <p>Optional; string</p></li>
- </ul>
+ <li><code>name</code> <p>Mandatory; string</p></li>
+ </ul><p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:profile name="wearable" /></pre>
</td>
</tr>
</tbody></table>
-<table id="ww_service-category">
+ <h3 id="ww_setting" name="ww_setting">Tizen Settings</h3>
+<table>
<tbody>
<tr>
- <th><tizen:category /> element</th>
+ <th><tizen:setting /> element</th>
</tr>
<tr>
- <td>Used to define the categories that the service application belongs to.
+ <td>Used to define additional application settings.
<p><strong>Occurrences:</strong> </p>
<ul>
<li>0 or more</li>
</ul>
<p><strong>Attributes:</strong> </p>
<ul>
- <li><code>name</code> <p>Mandatory; string</p></li>
- </ul>
+
+ <li><code>background-support</code>
+ <p>Optional; application execution continues when it is moved to the background (available values: <code>enable</code> (execution continues on the background), <code>disable</code> (default; application is suspended))</p>
+<div class="note">
+ <strong>Note</strong>
+ Since Tizen 2.4, the system manages background processes more tightly. Even if the <code>background-support</code> attribute is set to <code>enable</code>, the Web application process can be suspended on the background. To guarantee that the application runs on the background, <a href="#ww_bg_category">add at least one background category</a> for the application with the <code><tizen:background-category></code> element. Only the background categories declared in the system can be used.
+</div>
+ </li>
+ <li><code>context-menu</code> <p>Optional; sets whether the context menu is shown (available values: <code>enable</code> (default), <code>disable</code>)</p><p>If this option is enabled, the context menu is visible to the user.</p></li>
+ <li><code>encryption</code> <p>Optional; sets whether Web Application resources are encrypted (available values: <code>enable</code>, <code>disable</code> (default))</p><p>If this option is enabled, the application resources(HTML, JS and CSS files) are encrypted.</p></li>
+ <li><code>screen-orientation</code> <p>Optional; sets whether it locks the orientation of the Web Application (available values: <code>portrait</code> (default), <code>landscape</code>, <code>auto-rotation</code>)</p>
+ <ul><li><code>portrait</code> or <code>landscape</code>: orientation is locked to portrait or landscape respectively</li>
+ <li><code>auto-rotation</code>: follows the device orientation setting</li></ul>
+ </li>
+ <li><code>install-location</code> <p>Optional; application installation location (available values: <code>auto</code> (default), <code>internal-only</code>, <code>prefer-external</code>)</p>
+ <ul>
+ <li><code>auto</code>: the system defines the installation location</li>
+ <li><code>internal-only</code>: the application is installed in the device's internal storage</li>
+ <li><code>prefer-external</code>: the application is installed in the external storage (if available)</li>
+ </ul>
+ </li>
+
+ <li><code>hwkey-event</code> <p>Optional; a hardware key event is sent to the Web application when the user presses the hardware key (available values: <code>enable</code> (default), <code>disable</code>)</p><p>If this option is enabled, the <code>tizenhwkey</code> custom event is sent to the Web application. The <code>tizenhwkey</code> event object has a <code>keyName</code> attribute (available value: <code>back</code>).</p></li>
+
+ </ul><p><strong>Example:</strong> </p><pre class="prettyprint">
+<tizen:setting background-support="enable" />
+<tizen:setting context-menu="disable" />
+<tizen:setting encryption="enable" />
+<tizen:setting screen-orientation="landscape" />
+<tizen:setting install-location="internal-only" />
+<tizen:setting hwkey-event="enable" />
+</pre>
</td>
</tr>
</tbody></table>
- <h3 id="ww_profile" name="ww_profile">Tizen Profile</h3>
+ <h3 id="ww_service" name="ww_service">Tizen Service</h3>
<table>
<tbody>
<tr>
- <th><tizen:profile /> element</th>
+ <th><tizen:service /> element</th>
</tr>
<tr>
- <td>Used to define the application profile.
+ <td>Used to define Web Service Application.
+
<p><strong>Occurrences:</strong> </p>
<ul>
- <li>1</li>
+ <li>0 or more</li>
</ul>
+ <p><strong>Expected children:</strong> </p>
+ <ul>
+ <li><a href="#ww_service-content"><tizen:content /></a></li>
+ <li><a href="#ww_service-name"><tizen:name /></a></li>
+ <li><a href="#ww_service-icon"><tizen:icon /></a></li>
+ <li><a href="#ww_service-description"><tizen:description /></a></li>
+ <li><a href="#ww_service-metadata"><tizen:metadata /></a></li>
+ <li><a href="#ww_service-category"><tizen:category /></a></li>
+ </ul>
<p><strong>Attributes:</strong> </p>
<ul>
- <li><code>name</code> <p>Mandatory; string</p></li>
- </ul><p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:profile name="wearable" /></pre>
+ <li><code>id</code> <p>Mandatory; Tizen service ID, which is a combination of the Tizen wearable package ID and service name.</p><p>The service ID is a set of characters (0~9, a~z, A~Z) and unique in the device. The minimum value is 1 byte and maximum value is 52 bytes.</p></li>
+ <li><code>on-boot</code> <p>Optional; sets whether the service application is launched automatically on device booting time (available values: <code>true</code>, <code>false</code> (default))</p></li>
+ <li><code>auto-restart</code> <p>Optional; sets whether the service application is relaunched automatically when it is terminated (available values: <code>true</code>, <code>false</code> (default))</p></li>
+
+ </ul>
+ <p><strong>Example:</strong> </p><pre class="prettyprint"><tizen:service id="webService.application" auto-restart="true" on-boot="false">
+ <tizen:content src="service/service.js"/>
+ <tizen:name>WebService</tizen:name>
+ <tizen:icon src="service-icon.png"/>
+ <tizen:description>Web Service Application</tizen:description>
+ <tizen:metadata key="key1" value="value1"/>
+ <tizen:category name="http://tizen.org/category/service"/>
+<tizen:service></pre>
</td>
</tr>
</tbody></table>
-
- <h3 id="ww_feature" name="ww_feature">Tizen Feature</h3>
-<table>
+
+ <table id="ww_service-content">
<tbody>
<tr>
- <th><feature /> element</th>
+ <th><tizen:content /> element</th>
</tr>
<tr>
- <td>Used to define the hardware and software components for a Tizen wearable Web application. This attribute is only used in the Samsung Apps for filtering purposes. It is ignored by the Web Runtime installation procedure.
-
-<div class="note">
- <strong>Note</strong>
- Even though the <code><feature /></code> element is defined in the Widget Packaging and XML Configuration guidelines, in Tizen, an extended version is used.
-</div>
-
- <p><strong>Occurrences:</strong> </p>
- <ul>
- <li>0 or more</li>
- </ul>
- <p><strong>Attributes:</strong> </p>
- <ul>
- <li><code>name</code> <p>Mandatory; <a href="../../../org.tizen.training/html/web/process/setting_properties_w.htm#feature">feature key</a> URI</p></li>
- </ul><p><strong>Example:</strong> </p><pre class="prettyprint"><feature name="http://tizen.org/feature/network.bluetooth" /></pre>
+ <td>Used to define the start page of the Web Service Application.
+ <p><strong>Occurrences:</strong> </p>
+ <ul>
+ <li>1</li>
+ </ul>
+ <p><strong>Attributes:</strong> </p>
+ <ul>
+ <li><code>src</code> <p>Mandatory; start JavaScript file path of the Web Service Application. The path is relative to the source Web application directory.</p></li>
+ </ul>
</td>
</tr>
</tbody></table>
- <h3 id="ww_webwidget" name="ww_webwidget">Tizen Web Widget</h3>
-<table>
+<table id="ww_service-name">
<tbody>
<tr>
- <th><tizen:app-widget /> element</th>
+ <th><tizen:name /> element</th>
</tr>
<tr>
- <td>Used to define the basic information about a Web widget.
- <p><strong>Occurrences:</strong> </p>
- <ul>
- <li>0 or more</li>
- </ul>
- <p><strong>Expected children:</strong> </p>
+ <td>Used to define the name of Web Service Application.
+ <p><strong>Occurrences:</strong> </p>
+ <ul>
+ <li>1 or more</li>
+ </ul>
+ <p><strong>Attributes:</strong> </p>
<ul>
- <li><a href="#ww_widget-label"><tizen:widget-label /></a></li>
- <li><a href="#ww_widget-content"><tizen:widget-content /></a></li>
- <li><a href="#ww_widget-metadata"><tizen:widget-metadata /></a></li>
- </ul>
- <p><strong>Attributes:</strong> </p>
- <ul>
- <li><code>id</code> <p>Mandatory; unique ID of the Web widget in the <code><TIZEN_APPLICATION_ID>.<STRING></code> format, where <code><STRING></code> comprises 1 or more characters (0~9, a~z, A~Z)</p></li>
- <li><code>primary</code> <p>Mandatory; defines a primary Web widget among the Web widgets in a Web application (available values: <code>true</code>, <code>false</code>)</p></li>
- <li><code>max-instance</code> <p>Optional; limits the number of widget instances concurrently executable for a Web application. When omitted or its value is 0, unlimited number of widget instances are supported. The expected value is <code>integer</code>.</p></li>
+ <li><code>xml:lang</code> <p>Optional; specifies the language of the service name (for available values, see <a href="http://www.iana.org/assignments/language-subtag-registry" target="_blank">the IANA Language Subtag</a>)</p></li>
</ul>
- <p><strong>Example:</strong> </p>
-<pre class="prettyprint">
-<tizen:app-widget id="EHtuCWfzcr.Widget.Widget" primary="true" max-instance="0">
- <tizen:widget-label>Hello Web Widget!</tizen:widget-label>
- <tizen:widget-content src="index.html">
- <tizen:widget-size preview="preview.png">2x2</tizen:widget-size>
- </tizen:widget-content>
- <tizen:widget-metadata key="index" value="2"/>
-</tizen:app-widget>
-</pre>
</td>
</tr>
</tbody></table>
-
-<table id="ww_widget-label">
+
+<table id="ww_service-icon">
<tbody>
<tr>
- <th><tizen:widget-label /> element</th>
+ <th><tizen:icon /> element</th>
</tr>
<tr>
- <td>Used to define the name of Web widget.
+ <td>Used to define the icon of Web Service Application.
<p><strong>Occurrences:</strong> </p>
<ul>
- <li>1 or more</li>
+ <li>0 or 1</li>
</ul>
<p><strong>Attributes:</strong> </p>
<ul>
- <li><code>xml:lang</code> <p>Optional; specifies the language of the box label (for available values, see <a href="http://www.iana.org/assignments/language-subtag-registry" target="_blank">the IANA Language Subtag</a>)</p></li>
+ <li><code>src</code> <p>Mandatory; file path of the Web Service Application icon. The path is relative to the source Web application directory.</p></li>
</ul>
</td>
</tr>
</tbody></table>
-
-<table id="ww_widget-content">
+
+<table id="ww_service-description">
<tbody>
<tr>
- <th><tizen:widget-content /> element</th>
+ <th><tizen:description /> element</th>
</tr>
<tr>
- <td>Used to define the starting page of the Web widget.
+ <td>Used to define the description of the Web Service Application.
<p><strong>Occurrences:</strong> </p>
<ul>
- <li>1</li>
+ <li>0 or 1</li>
</ul>
- <p><strong>Expected children:</strong> </p>
- <ul>
- <li><a href="#ww_widget-size"><tizen:widget-size /></a></li>
- </ul>
- <p><strong>Attributes:</strong> </p>
- <ul>
- <li><code>src</code> <p>Mandatory; local file path, relative to the source Web application directory of the widget starting page</p></li>
- </ul>
</td>
</tr>
</tbody></table>
-<table id="ww_widget-size">
+<table id="ww_service-metadata">
<tbody>
<tr>
- <th><tizen:widget-size /> element</th>
+ <th><tizen:metadata /> element</th>
</tr>
<tr>
- <td>Used to define the size of the Web widget.
+ <td>Used to define metadata information shared with other Web Applications. The defined metadata can be accessed (read-only) through the Tizen Application API.
<p><strong>Occurrences:</strong> </p>
<ul>
- <li>1</li>
+ <li>0 or more</li>
</ul>
<p><strong>Attributes:</strong> </p>
<ul>
- <li><code>preview</code> <p>Mandatory; image file path, relative to the source Web application directory of the box content displayed in the widget viewer</p></li>
+ <li><code>key</code> <p>Mandatory; unique key string</p></li>
+ <li><code>value</code> <p>Optional; string</p></li>
</ul>
</td>
</tr>
</tbody></table>
-
-<table id="ww_widget-metadata">
+
+<table id="ww_service-category">
<tbody>
<tr>
- <th><tizen:widget-metadata /> element</th>
+ <th><tizen:category /> element</th>
</tr>
<tr>
- <td>Used to define a (key, value) pair that can be read by a Web widget through the WidgetService API. Its main use is to allow you to define a constant to be read by a Web widget.
+ <td>Used to define the categories that the service application belongs to.
<p><strong>Occurrences:</strong> </p>
<ul>
- <li>1 or more</li>
+ <li>0 or more</li>
</ul>
<p><strong>Attributes:</strong> </p>
<ul>
- <li><code>key</code> <p>Mandatory. The expected value is <code>String</code>.</p></li>
- <li><code>value</code> <p>Mandatory. The expected value is <code>String</code>.</p></li>
+ <li><code>name</code> <p>Mandatory; string</p></li>
</ul>
</td>
</tr>
</tbody></table>
+
+
<script type="text/javascript" src="../scripts/jquery.zclip.min.js"></script>
<script type="text/javascript" src="../scripts/showhide.js"></script>