<li><span style="font-family: Courier New,Courier,monospace">taskmanage</span>
<p>Indicates whether the application is shown in the task manager (available values: <span style="font-family: Courier New,Courier,monospace">true</span>, <span style="font-family: Courier New,Courier,monospace">false</span>)</p></li>
<li><span style="font-family: Courier New,Courier,monospace">hw-acceleration</span>
- <p>Indicates the application hardware acceleration status (available values: <span style="font-family: Courier New,Courier,monospace">default</span> (depends on the system setting), <span style="font-family: Courier New,Courier,monospace">on</span> (use hardware acceleration))</p>
+ <p>Indicates the application hardware acceleration status (available values: not defined (depends on the system setting), <span style="font-family: Courier New,Courier,monospace">on</span> (use hardware acceleration), <span style="font-family: Courier New,Courier,monospace">off</span> (do not use hardware acceleration))</p>
<p>By default, this value is set to <span style="font-family: Courier New,Courier,monospace">default</span>.</p></li>
<li><span style="font-family: Courier New,Courier,monospace">type</span>
<p>Tizen application type (available values: <span style="font-family: Courier New,Courier,monospace">capp</span>, <span style="font-family: Courier New,Courier,monospace">c++app</span>, <span style="font-family: Courier New,Courier,monospace">webapp</span>)</p></li>
<p><strong>For example:</strong></p>
<pre class="prettyprint"><ui-application appid="org.tizen.uiapp" exec="uiapp" launch_mode="single"
multiple="false" nodisplay="false" taskmanage="true"
- hw-acceleration="default" type="capp">
+ hw-acceleration="on" type="capp">
<label>uiapplication</label>
<label xml:lang="en-gb">testlang</label>
<icon>uiapp.png</icon>
<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>
</ul>
</li>
<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>
</ul>
</li>
</ul>
<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>
</ul>
<tbody>
<tr>
<th>API module</th>
- <th>Description</th>
- <th>API submodule</th>
+ <th>API submodule</th>
<th>Functionality</th>
+ <th>Description</th>
</tr>
<tr>
<td rowspan="4"><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__ACCOUNT__FRAMEWORK.html">Account</a></td>
- <td rowspan="4">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.
+ <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="4">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__OAUTH2__MODULE.html">OAuth 2.0</a>
<td>Helps applications in scheduling their data sync operations.</td>
</tr>
<tr>
- <td><a href="../../../../org.tizen.native.mobile.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>
+
<td><a href="../../../../org.tizen.native.mobile.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>
<tr>
<td rowspan="12"><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__APPLICATION__FRAMEWORK.html">Application Framework</a></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.
+ <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/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>
<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="21"><a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__MEDIA__FRAMEWORK.html">Multimedia</a></td>
- <td rowspan="21">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="20"><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="20">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__MEDIA__CONTROLLER__MODULE.html">Media Controller</a><p><strong>(since 2.4)</strong></p></td>
<td>Provides functions for communication between the media controller server and the media controller client.</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__MEDIA__TOOL__MODULE.html">Media Tool</a></td>
<td>Handles audio and video packet buffers. These buffers are utilized by the other Multimedia submodule APIs.</td>
<tr>
<td rowspan="7"><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="7">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>
<tbody>
<tr>
<th>API module</th>
- <th>Description</th>
<th>API submodule</th>
<th>Functionality</th>
+ <th>Description</th>
</tr>
+ <tr>
+ <td><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__ACCOUNT__FRAMEWORK.html">Account</a></td>
+ <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>
+ <td>The Account API module features include managing various account information, such as secure authorization.
+ </td>
+ </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="15"><a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__MEDIA__FRAMEWORK.html">Multimedia</a></td>
- <td rowspan="15">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>
+ <td rowspan="14"><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="14">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__MEDIA__CODEC__MODULE.html">Media Codec</a></td>
<td>Provides interfaces for encoding and decoding audio and video data, such as AAC audio or MPEG-4 AVC video.</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__MEDIA__TOOL__MODULE.html">Media Tool</a></td>
<tr>
<td rowspan="6"><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="6">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>
<td>Retrieves and displays privilege information. This can be used to show a user the privileges that an application contains when they are downloading it onto their device. This is so that they are aware of the resources which the application may access. </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>
+ <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>
<td>Obtains runtime information of a wearable device. For example, this submodule API can obtain information about the device's GPS.</td>
<tr>
<td rowspan="1"><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="1">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></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 rowspan="6"><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="6">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>
<td><a href="../../../../org.tizen.native.wearable.apireference/group__EFL__Group.html">EFL</a></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>
+ </tr>
</tbody>
</table>
<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/efl_overview_n.htm">EFL Overview</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>
<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>
</script>
</body>
-</html>
\ No newline at end of file
+</html>
</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>
</caption>
<colgroup>
<col width="10%"/>
-<col width="10%"/>
<col width="5%"/>
<col width="20%"/>
<col width="10%"/>
<col width="10%"/>
-<col width="25%"/>
+<col width="35%"/>
</colgroup>
<tbody>
<tr>
-<th rowspan="2">Profile</th>
-<th rowspan="2">Icon</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>HD</th>
- <th>WVGA</th>
+<th>Xhigh (HD)</th>
+ <th>High (WVGA)</th>
</tr>
<tr>
<td>Mobile</td>
-<td>MainMenu</td>
<td>Yes</td>
<td>32-bit PNG with alpha</td>
<td>117 x 117 pixels</td>
</tr>
<tr>
<td>Wearable</td>
-<td>MainMenu</td>
<td>Yes</td>
<td>32-bit PNG with alpha</td>
<td colspan="2">152 x 152 pixels</td>
<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>
<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>
</ul>
<script type="text/javascript" src="../../scripts/jquery.zclip.min.js"></script>
<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>
</tr>
</tbody>
</table>
-
+
<p>The following table lists the features provided by the <a href="../../../../org.tizen.web.apireference/html/device_api/wearable/index.html">Wearable Web Device API Reference</a>.</p>
<table border="1">
<caption>
<th>Documentation</th>
</tr>
<tr>
- <td>Tizen</td>
- <td>This API contains classes and interfaces that provide a set of basic definitions and interfaces that are used in the Tizen Device API.
- <p>You can use filters and sorting modes for query methods, generic success and error event handlers, a generic error interface, and a simple coordinate interface for defining location information.</p></td>
+ <td>Base</td>
+ <td>These APIs contain classes and interfaces that provide a set of basic definitions and interfaces that are used in the Tizen Device API.
+ <p>You can manage common files and zip archive files, and use filters and sorting modes for query methods, generic success and error event handlers, a generic error interface, and a simple coordinate interface for defining location information.</p></td>
<td>
<ul>
<li>Guides:
<p><a href="../../../../org.tizen.guides/html/web/data/data_cover_w.htm">Data Storage and Management</a></p>
- <p><a href="../../../../org.tizen.guides/html/web/error/error_w.htm">Error Handling</a></p></li>
- <li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/wearable/index.html#Tizen">Tizen</a></li>
+ <p><a href="../../../../org.tizen.guides/html/web/error/error_w.htm">Error Handling</a></p></li>
+ <li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/wearable/index.html#Base">Base</a></li>
</ul></td>
- </tr>
+ </tr>
<tr>
- <td>Application</td>
+ <td>Application Framework</td>
<td>These APIs contain classes and interfaces that enable you to manage alarm, application, and package features.
<p>You can schedule an application to be run at a specific time, retrieve information about the applications installed or running on the device, and enable package management.</p></td>
<td>
<ul>
- <li>Guides:
+ <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></li>
- <li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/wearable/index.html#Application">Application</a></li>
- </ul></td>
- </tr>
- <tr>
- <td>Communication</td>
- <td>These APIs contain classes and interfaces that enable you to manage Bluetooth, NFC (Near Field Communication), push, and secure element features.
- <p>You can transfer data over a Bluetooth connection, share contacts, photos, and videos using NFC, receive push notifications from a push server, and access secure elements, such as SIM card and secure SD card, in a device.</p></td>
- <td>
- <ul>
- <li>Guides:
- <p><a href="../../../../org.tizen.guides/html/web/connectivity/connectivity_cover_w.htm">Connectivity and Wireless</a></p>
- <p><a href="../../../../org.tizen.guides/html/web/messaging/messaging_cover_w.htm">Messaging</a></p></li>
- <li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/wearable/index.html#Communication">Communication</a></li>
+ <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>
+ <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>
<td>Content</td>
- <td>These APIs contain classes and interfaces that enable you to manage content and download features.
+ <td>These APIs contain classes and interfaces that enable you to manage content and download features.
<p>You can search and manage multimedia content locally, download files from the Internet, and monitor the download progress and status.</p></td>
<td>
<ul>
- <li>Guides:
+ <li>Guides:
<p><a href="../../../../org.tizen.guides/html/web/connectivity/connectivity_cover_w.htm">Connectivity and Wireless</a></p>
- <p><a href="../../../../org.tizen.guides/html/web/data/data_cover_w.htm">Data Storage and Management</a></p>
- <p><a href="../../../../org.tizen.guides/html/web/media/media_cover_w.htm">Media and Camera</a></p></li>
+ <p><a href="../../../../org.tizen.guides/html/web/data/data_cover_w.htm">Data Storage and Management</a></p></li>
<li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/wearable/index.html#Contents">Content</a></li>
</ul></td>
</tr>
<tr>
- <td>Input/Output</td>
- <td>These APIs contain classes and interfaces that enable you to manage file system and message port features.
- <p>You can access specific parts of the device file system, archive files, and send and receive messages through message ports.</p></td>
+ <td>Messaging</td>
+ <td>These APIs contain classes and interfaces that enable you to manage push messaging.
+ <p>You can receive push notifications from a push server.</p></td>
<td>
<ul>
- <li>Guides:
- <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/data/data_cover_w.htm">Data Storage and Management</a></p></li>
- <li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/wearable/index.html#I/O">Input/Output</a></li>
+ <li>Guides: <a href="../../../../org.tizen.guides/html/web/messaging/messaging_cover_w.htm">Messaging</a></li>
+ <li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/wearable/index.html#Messaging">Messaging</a></li>
</ul></td>
</tr>
<tr>
<td>Multimedia</td>
<td>These APIs contain classes and interfaces that enable you to manage multimedia-related features.
- <p>You can change and monitor playback volume level, and react to dedicated multimedia key presses.</p></td>
+ <p>You can change and monitor playback volume level, and listen to the FM radio.</p></td>
<td>
<ul>
- <li>Guides: <a href="../../../../org.tizen.guides/html/web/media/media_cover_w.htm">Media and Camera</a></li>
+ <li>Guides: <a href="../../../../org.tizen.guides/html/web/media/media_cover_w.htm">Media and Camera</a></li>
<li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/wearable/index.html#Multimedia">Multimedia</a></li>
</ul></td>
</tr>
+ <tr>
+ <td>Network</td>
+ <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>
+ <li>Guides: <a href="../../../../org.tizen.guides/html/web/connectivity/connectivity_cover_w.htm">Connectivity and Wireless</a></li>
+ <li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/wearable/index.html#Network">Network</a></li>
+ </ul></td>
+ </tr>
<tr>
<td>System</td>
<td>These APIs contain classes and interfaces that enable you to manage power, system information and setting, and time features.
<ul>
<li>Guides:
<p><a href="../../../../org.tizen.guides/html/web/device/device_cover_w.htm">Device Settings and Systems</a></p>
- <p><a href="../../../../org.tizen.guides/html/web/sensors/sensors_cover_w.htm">Sensors</a></p></li>
+ <p><a href="../../../../org.tizen.guides/html/web/media/media_cover_w.htm">Media and Camera</a></p>
+ <p><a href="../../../../org.tizen.guides/html/web/sensors/sensors_cover_w.htm">Sensors</a></p></li>
<li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/wearable/index.html#System">System</a></li>
</ul></td>
</tr>
<tr>
- <td>User Interface</td>
- <td>These APIs contain classes and interfaces that enable you to manage badge and notification features.
- <p>You can manage and monitor badge numbers, and create and manage notifications about application events.</p></td>
- <td>
- <ul>
- <li>Guides:
- <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>
- <li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/wearable/index.html#User Interface">User Interface</a></li>
- </ul></td>
- </tr>
- <tr>
<td>Web UI Framework</td>
<td>These APIs contain classes and interfaces that enable you to manage the Tizen Advanced UI (TAU) features.
<p>You can create and manage various kinds of UI components.</p></td>
<td>
<ul>
<li>Guides: <a href="../../../../org.tizen.guides/html/web/ui/tau/tau_w.htm">Tizen Advanced UI</a></li>
- <li>API Reference: <a href="../../../../org.tizen.web.apireference/html/ui_fw_api/ui_fw_api_cover.html">Web UI Framework</a></li>
+ <li>API Reference: <a href="../../../../org.tizen.web.apireference/html/ui_fw_api/ui_fw_api_cover.html">Advanced UI Framework</a></li>
</ul></td>
- </tr>
+ </tr>
</tbody>
</table>
<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>
</script>
<!--end-->
</body>
-</html>
\ No newline at end of file
+</html>
<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"/></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"/></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>
<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. 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 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">
<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>
<topic href="html/native/feature/app_connectivity_n.htm" label="Creating Applications with Connectivity and Network">
<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>
</topic>
projects / sdk / online-doc.git / commitdiff
