From: Mijin Cho Date: Thu, 24 Aug 2017 06:11:55 +0000 (+0000) Subject: Merge "Improve native guide topics" into tizen X-Git-Tag: GitHub/PR#40/tizen-studio~59 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=72217a1c77ae5336bfaa0a5b0cc1406820d60996;p=sdk%2Fonline-doc.git Merge "Improve native guide topics" into tizen --- 72217a1c77ae5336bfaa0a5b0cc1406820d60996 diff --cc org.tizen.guides/html/native/app_management/app_icons_n.htm index 235f8b2,c870954..eeca4b4 --- a/org.tizen.guides/html/native/app_management/app_icons_n.htm +++ b/org.tizen.guides/html/native/app_management/app_icons_n.htm @@@ -265,4 -265,4 +265,4 @@@ var s = document.getElementsByTagName(' -- ++ diff --cc org.tizen.guides/html/native/app_management/applications_n.htm index 1cc01ac,3a5dd07..83e476a --- a/org.tizen.guides/html/native/app_management/applications_n.htm +++ b/org.tizen.guides/html/native/app_management/applications_n.htm @@@ -69,10 -70,10 +70,10 @@@

When the application loses the focus status, the app_pause_cb() callback is invoked. The application can go into the pause state, which means that your application is not terminated but continues to run in the background, when:

A new application is launched from the request of your application.
A new application is launched by the request of your application.
The user requests to go to the home screen.
A system event (such as an incoming phone call) occurs and causes a resident application with a higher priority to become active and temporarily hide your application.
An alarm is triggered for another application, which becomes the top-most window and hides your application.
An alarm is triggered for another application, which becomes the topmost window and hides your application.

Since Tizen 2.4, an application in the background goes into a suspended state. In the suspended state, the application process is executed with limited CPU resources. In other words, the platform does not allow the running of the background applications, except for some exceptional applications (such as Media and Download) that necessarily work in the background. In this case, the application can designate their background category as an allowed category to avoid going into the suspended state.

@@@ -125,4 -126,4 +126,4 @@@ var s = document.getElementsByTagName(' -- ++ diff --cc org.tizen.guides/html/native/app_management/widget_app_n.htm index ac4134d,1cc6d9b..162d5cc --- a/org.tizen.guides/html/native/app_management/widget_app_n.htm +++ b/org.tizen.guides/html/native/app_management/widget_app_n.htm @@@ -550,13 -550,11 +550,11 @@@ widget_instance_update(widget_context_

You can set and get data in the data directory using the Preference API functions (in mobile and wearable applications). You can use the functions to store and retrieve key-value data in the data directory.
You can share the data directory content with Sqlite, by creating an Sqlite database file in the data directory.
-
The Sqlite database has an advantage to a direct use of a file in error handling, such as journaling. Consequently, if the application must handle complex data rather than primitive values, use Sqlite to store and retrieve the data.

You can share the data directory content with SQLite, by creating an SQLite database file in the data directory.

The SQLite database has an advantage to the direct use of a file in error handling, such as journaling. Consequently, if the application must handle complex data rather than primitive values, use SQLite to store and retrieve the data.

If an application requires complex control over a widget, such as Music Player, it must implement a service application in the middle and use the Data Control API (in mobile and wearable applications).

For example, a music-player-service service application is needed to control the audio device, process audio files, and handle play and stop signals. The music-player-ui and music-player-widget applications display the UI controls, title, album arts, and other content retrieved from the music-player-service service application. The service application can export its data using the Data Control to provide data to the other applications (widget and UI) simultaneously.

- -

The following figure illustrates typical data control flows between the set of UI, service, and widget applications.

For example, a music-player-service service application is needed to control the audio device, process audio files, and handle play and stop signals. The music-player-ui and music-player-widget applications display the UI controls, title, album art, and other content retrieved from the music-player-service service application. The service application can export its data using the Data Control to provide data to the other applications (widget and UI) simultaneously. The following figure illustrates the typical data control flows between the set of UI, service, and widget applications.

Figure: Sharing through data control

Sharing through data control

diff --cc org.tizen.guides/html/native/internationalization/i18n_n.htm index dfd1ae7,6952d03..42c7258 --- a/org.tizen.guides/html/native/internationalization/i18n_n.htm +++ b/org.tizen.guides/html/native/internationalization/i18n_n.htm @@@ -100,43 -100,41 +100,41 @@@

Calendar Dates with Ucalendar

The Ucalendar API (in mobile and wearable applications) is used for converting between a Udate object and a set of integer fields, such as I18N_UCALENDAR_YEAR, I18N_UCALENDAR_MONTH, I18N_UCALENDAR_DAY, and I18N_UCALENDAR_HOUR. A Udate object represents a specific instant in time with one millisecond precision.

The types of Ucalendar interpret a Udate according to the rules of a specific calendar system, such as the gregorian or traditional system.

The types of Ucalendar interpret a Udate according to the rules of a specific calendar system, such as the Gregorian or traditional system.

A Ucalendar object can produce all the time field values needed to implement the date-time formatting for a particular language and calendar style (for example, Japanese-Gregorian, Japanese-Traditional).

When computing a Udate from the time fields, 2 special circumstances can arise. The information can be insufficient to compute the Udate (you have only the year and the month, but not the day of the month), or the information can be inconsistent (such as "Tuesday, July 15, 1996" even though July 15, 1996 is actually a Monday).

Insufficient information
The calendar uses the default information to specify the missing fields. This can vary by calendar: for the Gregorian calendar, the default for a field is the same as that of the start of the epoch, such as I18N_UCALENDAR_YEAR = 1970, I18N_UCALENDAR_MONTH = JANUARY, I18N_UCALENDAR_DATE = 1.
Inconsistent information
If the fields conflict, the calendar prefers the most recently set fields. For example, when determining the day, the calendar looks for one of the following field combinations listed in the following table. The most recent combination, as determined by the most recently set single field, is used.

Table: Combinations of the calendar fields to determine the day

Table: Available calendar field combinations

- + - - + + + - - - -

Combinations of the calendar fields

Date information to be determined Field combination

Combinations of the calendar fields
Date information to be determined	Field combination
`I18N_UCALENDAR_MONTH + I18N_UCALENDAR_DAY_OF_MONTH` - `I18N_UCALENDAR_MONTH + I18N_UCALENDAR_WEEK_OF_MONTH + I18N_UCALENDAR_DAY_OF_WEEK` - `I18N_UCALENDAR_MONTH + I18N_UCALENDAR_DAY_OF_WEEK_IN_MONTH + I18N_UCALENDAR_DAY_OF_WEEK` - `I18N_UCALENDAR_DAY_OF_YEAR` - `I18N_UCALENDAR_DAY_OF_WEEK + I18N_UCALENDAR_WEEK_OF_YEAR`

I18N_UCALENDAR_MONTH + I18N_UCALENDAR_DAY_OF_MONTH -

I18N_UCALENDAR_MONTH + I18N_UCALENDAR_WEEK_OF_MONTH + I18N_UCALENDAR_DAY_OF_WEEK

I18N_UCALENDAR_MONTH + I18N_UCALENDAR_DAY_OF_WEEK_IN_MONTH + I18N_UCALENDAR_DAY_OF_WEEK

I18N_UCALENDAR_DAY_OF_YEAR

I18N_UCALENDAR_DAY_OF_WEEK + I18N_UCALENDAR_WEEK_OF_YEAR

- -

For the time of day:

Table: Combinations of calendar fields to determine the time of the day

- - - - - - - - - -

Combinations of the calendar fields
`I18N_UCALENDAR_HOUR_OF_DAY` - `I18N_UCALENDAR_AM_PM + I18N_UCALENDAR_HOUR`

+ Day + I18N_UCALENDAR_MONTH + I18N_UCALENDAR_DAY_OF_MONTH + + + I18N_UCALENDAR_MONTH + I18N_UCALENDAR_WEEK_OF_MONTH + I18N_UCALENDAR_DAY_OF_WEEK + + + I18N_UCALENDAR_MONTH + I18N_UCALENDAR_DAY_OF_WEEK_IN_MONTH + I18N_UCALENDAR_DAY_OF_WEEK + + + I18N_UCALENDAR_DAY_OF_YEAR + + + I18N_UCALENDAR_DAY_OF_WEEK + I18N_UCALENDAR_WEEK_OF_YEAR + + + Time of day + I18N_UCALENDAR_HOUR_OF_DAY + + + I18N_UCALENDAR_AM_PM + I18N_UCALENDAR_HOUR + + +

Note