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:

• Checking API privileges
• Setting build properties
• Setting the JSON property

You can set the Web application configuration in the config.xml file.

After you have finished setting the project properties, you are ready to design the UI.

Checking API Privileges

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

1. In the Properties window, select Tizen SDK > Web > Privilege.

2. If you want to exclude JavaScript files in specified folders, you can do so in the Excluded Folder Settings panel.

   This configuration helps to avoid unnecessary analysis for library files like jQuery.

To perform privilege checks automatically, select the required option in the Mode Settings panel. To check during the build process, select the Run privilege checks with build option.

You can also perform the checks manually in the IDE by selecting Check Privilege from the context menu. The results are displayed in the Problems view.

Setting Build Properties

You can set build properties for your project. To select the build properties:

1. In the Properties window, select Tizen SDK > Package > Web.
2. Check Optimize web resources, and add any files for excluding optimization in the Optimization panel.

Setting the JSON Property

You can set a JSON property for your project. To select the JSON property:

1. In the Properties window, select Tizen SDK > Web > JSON Properties.
2. Check Enable JSON validation in project.

Setting the Web Application Configuration

Every application has a config.xml configuration file. The Tizen IDE provides a Web application configuration editor for configuring the application.

To edit the config.xml file, open it by double-clicking the file in the Project Explorer view.

You can edit Web application properties using the tabs of the Web application configuration editor.

Defining and Editing General Information in the Overview Tab

You can define and edit general information of the Web application in the Overview tab of the Web application configuration editor.

The following table lists the Web application properties you can edit in the Overview tab.

Defining Web Application License Information and UI Preferences in the Widget Tab

You can define license information and UI preferences of the Web application in the Widget tab of the Web application configuration editor.

The following table lists the Web application properties you can edit in the Widget tab.

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 mobile Web application:

1. In the Feature tab of the Web application configuration editor, click Add.
2. Select a feature from the list.
3. Click Save.

After setting the feature information with the Web application configuration editor, you can see the added code in the Source tab.

The following example shows the setting in the config.xml file code:

<tizen:feature name="http://tizen.org/feature/network.nfc"/>

For more information on the available requirements for an application package, see Feature Filtering for Web Applications.

Specifying Privileges in the Privilege Tab

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 Privilege 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.

To add a privilege:

1. In the Privilege tab of the Web application configuration editor, click Add.
2. In the Add privilege window, select an option:
   • Internal: Select a privilege from the predefined list of APIs. You can select multiple privileges by holding the CTRL key.
   • Privilege name: Manually enter the URL containing a privilege definition.
   • File: Click Browse and select a privilege file (with the .xml or .widlprocxml extension).
3. Click Finish.

After setting the privilege information with the Web application configuration editor, you can see the added code in the Source tab.

The following example shows the setting in the config.xml file code:

<tizen:privilege name="http://tizen.org/privilege/application.launch"/>

Defining External Access Policies in the Policy Tab

According to the W3C Access Requests Policy (WARP), you cannot access external network resources by default. If you require access to an external network resource, you must request network resource permissions for the Web application using the Policy tab of the Web application configuration editor.

The following table lists the policy properties you can edit in the Policy tab.

<tizen:content-security-policy>
   script-src 'self'
</tizen:content-security-policy>

<tizen:content-security-policy-report-only>
   script-src 'self'; 
   report-uri="http://example.com/report.cgi"
</tizen:content-security-policy-report-only>

<tizen:allow-navigation>
   tizen.org *.tizen.org
<tizen:allow-navigation/>

<access origin="http://www.tizen.org" subdomains="true"/>

After setting the policy information with the Web application configuration editor, you can see the added code in the Source tab.

Setting the Supported Locales in the Localization Tab

You can provide localization support for name, description, and license elements of the config.xml file in the Localization tab of the Web application configuration editor.

To add localization:

1. In the Name panel, click Add.

   Select a language and enter your name.

   The following example shows the setting in the config.xml file:

   <name xml:lang="en-gb">Lee</name>
   

2. In the Description panel, click Add.

   Select a language and enter the description of the Web application.

   The following example shows the setting in the config.xml file:

   <description xml:lang="en-gb">Widget</description>
   

3. In the License panel, click Add.

   Select a language and manually enter the license and license URI.

   The following example shows the setting in the config.xml file code:

   <license xml:lang="en-gb" href=" http://www.apache.org/licenses/LICENSE-2.0.html">
      Apache License, Version 2.0
   </license>
   

After setting the localization information with the Web application configuration editor, you can see the added code in the Source tab.

You can localize a Web application to adapt to various languages and cultural environments by creating different Web application versions for different languages.

To localize a Web application:

1. Launch the Localization Wizard by doing one of the following:
   • In the Project Explorer view, right-click the Web application and select Localization > Localization Wizard.
   • In the Tizen IDE menu, go to Project > Localization > Localization Wizard.
2. In the Localization Wizard view, select the files to localize from the list of files and click Next.

   The files that are already localized are grayed out.

3. In the Available locales list, select the locales and add them to the Selected locales list. Click Next.

   The locales that are already supported are grayed out.

4. Associate the selected files with the specified locales by selecting the check boxes under the desired locale column.

   The check boxes for files that are already localized for a particular locale are grayed out.

5. Click Finish.

   In the Project Explorer view, a new locales 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.

Figure: Locale folders

Declaring Name-value Pairs in the Preferences Tab

You can declare name-value pairs which can be set and retrieved using the Widget Interface API (in mobile or wearable applications) in the Preferences tab of the Web application configuration editor. These name-value pairs, or preferences, are used by the Web application during execution.

To add preferences, click Add and enter values in the Name and Value columns. You can set a preference as read-only by setting the Read-only column value as true.

After setting the preference information with the Web application configuration editor, you can see the added code in the Source tab.

The following example shows the setting in the config.xml file code:

<preference name="key" value="value" readonly="false"/>    

Configuring the Tizen Schema Extension in the Tizen Tab

The Tizen tab of the Web application configuration editor shows the Tizen schema extension. Some of the attributes specified on this tab are mandatory and must be defined, whereas others are optional.

The following table describes the schema extension properties that you can edit.

<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>

<tizen:metadata key="key1"/>
<tizen:metadata key="key2" value="value"/>

Editing the config.xml File in the Source Tab

The Source tab of the Web application configuration editor shows the code of the config.xml file. You can edit an XML document and immediately see how changes made on the other tabs are reflected in the raw XML source content.