Tizen Manifest Editor

A Tizen .Net application project consists of exactly 1 manifest file, called tizen-manifest.xml, which is used to describe the application information. The manifest file is composed of XML elements, which include the root <manifest> element and its child elements representing application information, such as <version>, and <privileges>. The child elements are organized into a specific hierarchy. The elements can have attributes associated with them, providing more information about the element.

Editing the Manifest File

There are 2 different ways to edit the tizen-manifest.xml file:

  • Use the text editor to modify the XML structure directly:

    1. Right-click the tizen-manifest.xml file in the Solution Explorer.
    2. Select Open with > XML (Text) Editor.

    Figure: Text Editor

  • Use the manifest editor to modify the manifest in a form editor:

    Double-click the tizen-manifest.xml file in the Solution Explorer.

    Figure: Manifest editor

Note The tizen-manifest.xml file must conform to both the standard XML file format and the Tizen .Net application specification requirements. Editing the manifest file XML structure with the text editor is intended for advanced users only. If the file does not conform to the standard and requirements, errors can occur during installation.

Manifest Element Hierarchy

The Tizen .Net application manifest file consists of XML elements organized in a hierarchy. The following tree structure shows the relationship between the elements of the tizen-manifest.xml file.

<manifest>
  <author>
  <description>
  <profile>
  <ui-application>
    <label>
    <icon>
    <app-control>
    <metadata>
    <datacontrol>
    <background-category>
  <shortcut-list>
    <shortcut>
      <icon>
      <label>
  <account>
    <account-provider>
      <icon>
      <label>
      <capability>
  <privileges>
    <privilege>
  <feature>

Manifest Elements

The following sections summarize the elements used in the tizen-manifest.xml file of the .Net application.

<manifest> Element

This element contains the manifest information of the Tizen .Net application. The <manifest> element is an easily readable description of the Tizen package and serves as a container for the other elements of the configuration document.

For more information on the relationship between the elements, see the element hierarchy.

Occurrences:

  • 1

Expected children (in the following order):

Child element Occurrences
<author> 1 (optional)
<description> 1 or more (optional)
<profile> 1 or more (optional)
<ui-application> 1 (optional)
<shortcut-list> 1 (optional)
<account> 1 (optional)
<privileges> 1 (optional)
<feature> 1 or more (optional)

Figure: Editing the <manifest> element in the manifest editor

Attributes:

  • api-version

    API version number for the application (available value: number in the "x.y.z" format, where z is optional, for example, 3.0)

  • install-location

    Installation location for the application (available value: "auto")

    Note This attribute is read-only. Do not attempt to modify it.
  • package

    Package of the application (available value: "org.tizen.applicationName")

  • type

    Package type of the application (available value: "tpk")

    Note This attribute is read-only. Do not attempt to modify it.
  • version

    Version number of the application (available value: number in the "x.y.z" format, where 0 <= x <= 255, 0 <= y <= 255, and 0 <= z <= 65535)

For example:

<manifest xmlns="http://tizen.org/ns/packages" api-version="3.0" package="org.tizen.uiapp" version="1.0.0">
   <author>.....</author>
   <description>.....</description>
   <profile name="mobile"/>
   <ui-application>.....</ui-application>
   <shortcut-list>.....</shortcut-list>
   <account>.....</account>
   <privileges>.....</privileges>
   <feature>.....</feature>
</manifest>

<author> Element

This element represents the creator of the Tizen package.

For more information on the relationship between the elements, see the element hierarchy.

Occurrences:

  • 1 (optional)

Attributes:

  • email

    Email of the package creator (available value: any valid email ID string value)

  • href

    Web site of the package creator, such as a homepage or a profile on a social network (available value: any valid Web site string value)

Expected value:

  • Package creator name in string

For example:

<author email="email@email.com" href="http://test.com">author</author>

<description> Element

This element contains an easily readable description of the Tizen package.

For more information on the relationship between the elements, see the element hierarchy.

Occurrences:

  • 1 or more (optional)

Attributes:

  • xml:lang

    Language and country code (available value: "<2-letter lowercase language code (ISO 639-1)>-<2-letter lowercase country code (ISO 3166-1 alpha-2)>")

Expected value:

  • Description value in string

For example:

<description xml:lang="en-us">This is a sample</description>

<profile> Element

In Tizen .Net application, the <profile> element set to common. This element has no child elements.

Occurrences:

Attributes:

  • name

    Profile name (available values: common)

For example:

<profile name="common"/>

<ui-application> Element

This element contains the manifest information of a Tizen .Net UI application with a graphical user interface (GUI).

For more information on the relationship between the elements, see the element hierarchy.

Occurrences:

  • 1 or more (optional)

Expected children (in the following order):

Child element Occurrences
<label> 1 or more (optional)
<icon> 1 or more (optional)
<app-control> 1 or more (optional)
<metadata> 1 or more (optional)
<datacontrol> 1 or more (optional)
<background-category> 1 or more (optional)

Attributes:

  • appid

    Application unique ID (string)

    This can be used for launching or terminating the application explicitly.

  • exec

    Application executable file path (string)

  • hw-acceleration

    Indicates the application hardware acceleration status (available values: not defined (depends on the system setting), on (use hardware acceleration), off (do not use hardware acceleration))

    By default, this value is not defined.

  • launch_mode

    Application launch mode (available values: single (launched as a main application), group (launched as a sub application), caller (caller application))

    By default, this value is set to single.

  • multiple

    Indicates whether the application can be launched as a multiple (available values: truefalse)

    Note This attribute is read-only. Do not attempt to modify it.
  • nodisplay

    Indicates whether the application is shown in the app-tray (available values: truefalse)

  • taskmanage

    Indicates whether the application is shown in the task manager (available values: truefalse)

  • type

    Tizen application type (available values: dotnet)

    Note This attribute is read-only. Do not attempt to modify it.

For example:

<ui-application appid="org.tizen.uiapp" exec="uiapp" hw-acceleration="on" launch_mode="single" 
                multiple="false" nodisplay="false" taskmanage="true" type="dotnet">
   <label>uiapplication</label>
   <label xml:lang="en-gb">testlang</label>
   <icon>uiapp.png</icon>
   <app-control>
      <operation name="http://tizen.org/appcontrol/operation/dial"/>
      <mime name="application/vnd.ms-excel"/>
   </app-control>
   <metadata key="testkey" value="testvalue"/>
   <datacontrol access="ReadOnly" 
                providerid="http://uiapp.com/datacontrol/provider/uiapp" type="Sql"/>
</ui-application>

<shortcut-list> Element

This element contains the shortcut template list used for adding a shortcut to the home screen.

For more information on the relationship between the elements, see the element hierarchy.

Occurrences:

  • 1 (optional)

Expected children:

Child element Occurrences
<shortcut> 1 or more

For example:

<shortcut-list>
   <shortcut>.....</shortcut>
</shortcut-list>

<shortcut> Element

This element contains the information that indicates the shortcut for the application on the home screen.

Occurrences:

  • 1 (optional)

Expected children:

Child element Occurrences
<icon> 1 or more
<label> 1 or more

Attributes:

  • appid

    Application unique ID (string)

    This can be used for launching or terminating the application explicitly.

  • extra_data

    Data for user content (string)

    Shortcut element property in the manifest file

  • extra_key

    Key for user content (string)

    Shortcut element property in the manifest file

For example:

<shortcut appid="org.example.shortcut" extra_data="data" extra_key="key">
   <icon>shortcut.png</icon>
   <label>shortcut</label>
   <label xml:lang="en-us">short</label>
</shortcut>

<account> Element

This element contains a set of user accounts and account provider-related information in the Tizen application.

For more information on the relationship between the elements, see the element hierarchy.

Occurrences:

  • 1 (optional)

Expected children:

Child element Occurrences
<account-provider> 1 or more

For example:

<account>
   <account-provider>.....</account-provider>
</account>

<account-provider> Element

This element contains a specific service provider or user account protocol-related information.

Expected children:

Child element Occurrences
<icon> 1 or more
<label> 1 or more
<capability> 1 or more (optional)

Attributes:

  • appid

    Application unique ID (string)

    This can be used for launching or terminating the application explicitly.

  • multiple-accounts-support

    Indicates whether multiple accounts are supported (available values: truefalse)

  • providerid

    ID of the account provider (string)

For example:

<account-provider appid="org.tizen.uiapp" multiple-accounts-support="false" providerid="org.tizen.uiapp">
   <icon>.....</icon>
   <label>.....</label>
   <capability>.....</capability>
</account-provider>

<icon> Element

This element contains the account provider icon image. Since the icons are used in the device under settings, the account icons are placed in a shared directory.

Attributes:

  • section

    Usage information of the icon image (available values: account (image size: 72 x 72 for density xhigh and 48 x 48 for density high), account-small (image size: 45 x 45 for density xhigh and 30 x 30 for density high))

Expected value:

  • Icon file name

For example:

<icon section="account">uiapp.png</icon>
<icon section="account-small">uiapp.png</icon>

<capability> Element

This element contains the account provider capability. The capabilities are defined as http://<VENDOR_INFORMATION>/account/capability/<NAME>.

Expected value:

  • IRI string

For example:

<capability>http://tizen.org/account/capability/calendar</capability>

<privileges> Element

This element contains a set of required privileges for the Tizen application.

Applications that use sensitive APIs must declare the required privileges in the tizen-manifest.xml file.

Click Add to open the Add Privilege dialog.

Figure: Editing the <privileges> element in the manifest editor

For more information on the relationship between the elements, see the element hierarchy.

Occurrences:

  • 1 (optional)

Expected children:

Child element Occurrences
<privilege> 1 or more (optional)

For example:

<privileges>
   <privilege>.....</privilege>
</privileges>

<privilege> Element

This element contains the required privileges for the Tizen application.

Occurrences:

  • 1 or more (optional)

Expected value:

Name (mandatory, the URI of the Device API privilege)

For example:

  • http://tizen.org/privilege/application.admin
  • http://tizen.org/privilege/appmanager.launch
  • http://tizen.org/privilege/account.read

For example:

<privilege>http://tizen.org/privilege/application.admin</privilege>
<privilege>http://tizen.org/privilege/appmanager.launch</privilege>
<privilege>http://tizen.org/privilege/account.read</privilege>

<feature> Element

This element contains a list of required features for feature-based filtering in the Tizen Store.

The element is used to define the hardware and software components for the Tizen application. In order to use or access an API that is specialized for each vendor or platform, the feature must be declared. This element has no child elements.

Figure: Editing the <feature> element in the manifest editor

For more information on the relationship between the elements, see the element hierarchy.

Occurrences:

  • 1 or more (optional)

Attributes:

  • name (mandatory, a feature key URI)

    Item name used in feature-based filtering in the Tizen Store, for example, "http://tizen.org/feature/camera""http://tizen.org/feature/fmradio"

Expected value:

  • true

For example:

<feature name="http://tizen.org/feature/camera">true</privilege>
<feature name="http://tizen.org/feature/fmradio">true</privilege>