Setting Project Properties

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 IDE Project Explorer view and select Properties. After setting or changing a property, click Apply.

The settings that you can define in the application project properties include:

• API usage check
• API privilege check

You can define the application manifest settings in the tizen-manifest.xml file.

Note
Only modify the manifest file by using the manifest editor in the Tizen IDE. If you create or edit the tizen-manifest.xml file using any other text editor, your application may not work as expected.

After you have finished setting the project properties, you are ready to design the UI and implement the application code.

Checking API Usage

You can check the source code in your project for any violation of API usage. To enable the API check:

1. In the Properties window, select C/C++ Build > Tizen Settings > API and Privilege Checker.

2. Select the required API problems in the API Check panel.

To perform API usage checks automatically, select the required option in the Launching panel:

• During the build process, select the Run API and privilege checks with build option.
• During code editing, select the Run API and privilege checks while editing option.

You can also perform the API usage checks manually after building the application by selecting Project > Check API and Privilege Violations. The results are displayed in the Problems view.

Note
If the application has conflicting API versions, the build fails and the results are displayed in the Problems view.

Checking API Privileges

You can check the source code in your project for any violation of privileges. To enable the privilege check:

1. In the Properties window, select C/C++ Build > Tizen Settings > API and Privilege Checker.

2. Select the required privilege problems in the Privilege Check panel.

To perform privilege checks automatically, select the required option in the Launching panel:

• During the build process, select the Run API and privilege checks with build option.
• During code editing, select the Run API and privilege checks while editing option.

You can also perform privilege checks manually after building the application by selecting Project > Check API and Privilege Violations. The results are displayed in the Problems view.

Setting the Application Manifest

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 tizen-manifest.xml file present in the project folder of the application.

Figure: Setting the application manifest

You can edit application properties using the tabs of the manifest editor.

Defining and Editing General Information in the Overview Tab

You can set and edit general and project-related information about the application, such as application package, version, author, description, in the Overview tab of the manifest editor. Additionally, you can specify the application icon.

You can perform the following tasks using the Overview tab:

• Set the package name of the application.

  The package name represents the package identifier of the application

• Set the application version (x.y.z).

  The application version format has the following constraints: 0 ≤ {x, y} ≤ 255, 0 ≤ z ≤ 65535. You can change the application version in the Version field.

• Set the application label.

  The application label represents the label of the application.

• Set the API version.

  The API version format is "x.y.z".

• Add application icon.

  You can add a launcher icon to your application by defining it in the Icon panel. The following table describes the available icons.

  Table: Mobile Application icons

  Icon	Mandatory	Format	Size		Description
  			HD	WVGA
  MainMenu	Yes	32-bit PNG with alpha	118 x 118 pixels	82 x 82 pixels	Image displayed in the main menu.

  Table: Wearable Application icons

  Icon	Mandatory	Format	Size	Description
  MainMenu	Yes	32-bit PNG with alpha	152 x 152 pixels	Image displayed in the main menu.

• Set the application author.

  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.

• Set the application description.

  The application description represents the human-readable descriptions of the Tizen native application package.

Declaring Required Software or Hardware Features in the Features Tab

You can declare required software or hardware features. This declaration can be used for application filtering in the Tizen Store.

To enable filtering for your native application:

1. In the Features tab of the manifest editor, click Add and set the mandatory features for the application package.

   The manifest file (tizen-manifest.xml) is updated automatically.

2. Upload and publish the application package on the Tizen Store.
3. If a Tizen-powered device requests applications, the store displays a list containing only applications compatible with the user's device.

For more information on the available requirements for an application package, see Feature Filtering for Native Applications. If you want to check which features are necessary for using a specific API, see the related feature in the native API Reference.

Specifying Privileges in the Privilege Tab

You can use features and services provided by privileged APIs, which handle platform and user-sensitive data. Assign specific privileges to your application in the Privilege tab of the manifest editor, according to the application functionality that you want to develop.

Setting the Supported Locales in the Localization Tab

You can set the supported locales for selected node elements of the tizen-manifest.xml file. You can provide localization support for the label and description of the tizen-manifest.xml file in the Localization tab of the manifest editor.

Defining Advanced Features in the Advanced Tab

You can define advanced features of the application, such as metadata and data and application control functionalities, account, and miscellaneous options, in the Advanced tab of the manifest editor.

You can perform the following tasks using the Advanced tab:

• Add metadata.

  You can add user-defined key-value pairs to the application to be used for filtering in the package manager.

• Set miscellaneous options.

  You can set as true or false various application options:

  • Set multiple

    This attribute indicates whether the application can be launched as multiple.

  • Set taskmanage

    This attribute indicates whether the application is shown in the task manager.

  • Set nodisplay for UI application

    This attribute indicates whether the application is shown in the app-tray. For service applications, nodisplay is always true.

  • Set auto-restart

    This attribute indicates whether the application is relaunched automatically when it is terminated abnormally.

  • Set on-boot

    This attribute indicates whether the application is launched automatically on device booting time or application installation time.

  Note
  The auto-restart and on-boot attributes are not supported in Tizen wearable devices.

• Define application control.

  You can export the application control functionality of your application. To define an application control used to access the functionality of your application, click Add in the Application Control section of the Advanced tab of the manifest editor.

  Each application control can have multiple operation, mime type, and uri attributes.

• Add an account (in mobile applications only).

  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.

  To register an account provider, define the account provider information by clicking Add in the Account section of the Advanced tab of the manifest editor, as described in the following table.

  Table: Account provider properties

  Account property	Data type	Property type
  Multiple accounts support	bool	Indicates whether multiple accounts are supported. This is a mandatory property.
  Provider ID	String	ID of the account provider.
  Display label	String	Display name of the account provider. This is a mandatory property.
  Icon	String	File path of the account provider icon. The icon size is: 72 x 72 for Xhigh (HD) 48 x 48 for High (WVGA) Since the icon is used in Settings > Accounts, place the icon in a shared directory. This is a mandatory property.
  Small icon	String	File path of the account provider icon. The icon size is: 45 x 45 for Xhigh (HD) 30 x 30 for High (WVGA) Since the small icon is used in other applications, place the icon in a shared directory. This is a mandatory property.
  Labels	String	Localization support for the display name.
  Capabilities	String	Capability of the account provider. Capabilities are defined in the http://<VENDOR_INFORMATION>/accounts/capability/<NAME> IRI format. The following predefined capabilities can be used in Tizen: http://tizen.org/account/capability/calendar Used when the account is related to a calendar. http://tizen.org/account/capability/contact Used when the account is related to contacts. http://tizen.org/account/capability/document Used when the account is related to a document. http://tizen.org/account/capability/email Used when the account is related to email. http://tizen.org/account/capability/game Used when the account is related to a game. http://tizen.org/account/capability/message Used when the account is related to a message. http://tizen.org/account/capability/music Used when the account is related to music. http://tizen.org/account/capability/photo Used when the account is related to a photo. http://tizen.org/account/capability/video Used when the account is related to a video. This is an optional property.

• Export DataControl functionality.

  You can export data functionalities of your Tizen native application.

  To define a data control used to export application data, click Add and define the data control details.

Editing the tizen-manifest.xml File in the tizen-manifest.xml Tab

The tizen-manifest.xml tab of the manifest editor shows the code of the tizen-manifest.xml file. You can edit the basic syntax of the XML document and also see how changes made on the other tabs are reflected in the raw XML source content.

Note
If you edit application information manually in the tizen-manifest.xml file source code, you can introduce errors preventing the application from running normally.