[Application] Updating getBatteryUsageInfo() and getAppsUsageInfo() methods

 + New native feature key http://tizen.org/feature/app_history is
   being introduced into Tizen 4.0, this requires to add it into the
   'Related Feature' section.
 + Currently, mentioned methods are available only on mobile profile,
   now we can expand it to wearable profile.

PS3: Reviewed

Change-Id: I0ddce465b1ad0d2df227d94a8530979e499d3c77
Signed-off-by: Szymon Jastrzebski <s.jastrzebsk@partner.samsung.com>

diff --git a/org.tizen.guides/html/web/app_management/app_controls_w.htm b/org.tizen.guides/html/web/app_management/app_controls_w.htm
index 27afb80..e425ab3 100644 (file)
--- a/org.tizen.guides/html/web/app_management/app_controls_w.htm
+++ b/org.tizen.guides/html/web/app_management/app_controls_w.htm
@@ -300,10 +300,10 @@ window.addEventListener('appcontrol', function onAppControl() {
         <li>Retrieve information about running applications with the <code>getAppContext()</code> and <code>getAppsContext()</code> methods of the <code>ApplicationManager</code> interface.
         <p>These methods can be used to access the <code>ApplicationContext</code> interface (in <a href="../../../../org.tizen.web.apireference/html/device_api/mobile/tizen/application.html#ApplicationContext">mobile</a>, <a href="../../../../org.tizen.web.apireference/html/device_api/wearable/tizen/application.html#ApplicationContext">wearable</a>, and <a href="../../../../org.tizen.web.apireference/html/device_api/tv/tizen/application.html#ApplicationContext">TV</a> applications) to retrieve the application ID and context ID of the running application.</p>
         <p>The application ID can be used to retrieve application information, or to launch an application. The context ID is a unique identifier given by the platform to a running application.</p></li>
-        <li>Retrieve information about battery usage per application with the <code>getBatteryUsageInfo()</code> method of the <code>ApplicationManager</code> interface <strong>in mobile applications only</strong>.
-        <p>You can retrieve battery usage information starting from a specific number of days ago, or since the battery was last fully charged. You can also select the number of applications included in the returned <a href="../../../../org.tizen.web.apireference/html/device_api/mobile/tizen/application.html#ApplicationBatteryUsage">ApplicationBatteryUsage</a> data array.</p></li>
-        <li>Retrieve information about usage statistics per application with the <code>getAppsUsageInfo()</code> method of the <code>ApplicationManager</code> interface <strong>in mobile applications only</strong>.
-        <p>The statistics include the most frequently or recently used applications. You can retrieve application usage information from a specific time period, or starting from a specific number of days ago. You can also select the number of applications included in the returned <a href="../../../../org.tizen.web.apireference/html/device_api/mobile/tizen/application.html#ApplicationUsage">ApplicationUsage</a> data array.</p></li>
+        <li>Retrieve information about battery usage per application with the <code>getBatteryUsageInfo()</code> method of the <code>ApplicationManager</code> interface <strong>in mobile and wearable applications only</strong>.
+        <p>You can retrieve battery usage information starting from a specific number of days ago, or since the battery was last fully charged. You can also select the number of applications included in the returned <code>ApplicationBatteryUsage</code> data array (in <a href="../../../../org.tizen.web.apireference/html/device_api/mobile/tizen/application.html#ApplicationBatteryUsage">mobile</a> and <a href="../../../../org.tizen.web.apireference/html/device_api/wearable/tizen/application.html#ApplicationBatteryUsage">wearable</a> applications).</p></li>
+        <li>Retrieve information about usage statistics per application with the <code>getAppsUsageInfo()</code> method of the <code>ApplicationManager</code> interface <strong>in mobile and wearable applications only</strong>.
+        <p>The statistics include the most frequently or recently used applications. You can retrieve application usage information from a specific time period, or starting from a specific number of days ago. You can also select the number of applications included in the returned <code>ApplicationUsage</code> data array (in <a href="../../../../org.tizen.web.apireference/html/device_api/mobile/tizen/application.html#ApplicationUsage">mobile</a> and <a href="../../../../org.tizen.web.apireference/html/device_api/wearable/tizen/application.html#ApplicationUsage">wearable</a> applications).</p></li>
     </ul>
 
 <p>Learning how to retrieve information about installed and running applications allows you to manage all the device applications from your application: </p>

diff --git a/org.tizen.training/html/web/details/app_filtering_w.htm b/org.tizen.training/html/web/details/app_filtering_w.htm
index 363db97..dab53e1 100644 (file)
--- a/org.tizen.training/html/web/details/app_filtering_w.htm
+++ b/org.tizen.training/html/web/details/app_filtering_w.htm
@@ -244,6 +244,11 @@
         <td>4.0</td>
     </tr>
 <tr>
+<td><code>http://tizen.org/feature/app_history</code></td>
+     <td>Specify this key, if the application requires the application history feature.</td>
+        <td>4.0</td>
+    </tr>
+<tr>
 <td><code>http://tizen.org/feature/battery</code></td>
      <td>Specify this key, if the application requires information on the device battery.</td>
         <td>2.3*</td>
@@ -549,6 +554,11 @@
         <td>4.0</td>
     </tr>
 <tr>
+<td><code>http://tizen.org/feature/app_history</code></td>
+     <td>Specify this key, if the application requires the application history feature.</td>
+        <td>4.0</td>
+    </tr>
+<tr>
 <td><code>http://tizen.org/feature/battery</code></td>
      <td>Specify this key, if the application requires information on the device battery.</td>
         <td>2.3*</td>

diff --git a/org.tizen.web.apireference/html/device_api/mobile/tizen/application.html b/org.tizen.web.apireference/html/device_api/mobile/tizen/application.html
index 7dc77d4..6ad4ac2 100755 (executable)
--- a/org.tizen.web.apireference/html/device_api/mobile/tizen/application.html
+++ b/org.tizen.web.apireference/html/device_api/mobile/tizen/application.html
@@ -1294,7 +1294,7 @@ InvalidValuesError - if any of the input parameters contains an invalid value.
  http://tizen.org/privilege/apphistory.read
             </p>
 <p><span class="remark"> Remark : </span>
- This method is available only on mobile devices. An attempt to call this method on other profile will result in throwing <em>NotSupportedError</em> exception.
+ This method is available only on mobile and wearable devices. An attempt to call this method on other profile will result in throwing <em>NotSupportedError</em> exception.
             </p>
 <div class="parameters">
 <p><span class="param">Parameters:</span></p>
@@ -1403,7 +1403,7 @@ InvalidValuesError - if any of the input parameters contains an invalid value.
  http://tizen.org/privilege/apphistory.read
             </p>
 <p><span class="remark"> Remark : </span>
- This method is available only on mobile devices.
+ This method is available only on mobile and wearable devices.
 An attempt to call this method on other profile will result in throwing <em>NotSupportedError</em> exception.
             </p>
 <div class="parameters">
@@ -3373,6 +3373,14 @@ Must be at least 1 byte in length and not exceed the maximum name length of 127
                     <div class="def-api-feature">
 <p><div class="description">
             <p>
+To guarantee the running of the application on a device which supports Application History feature, declare the following feature requirement in the config file:
+            </p>
+           </div></p>
+<li class="feature">http://tizen.org/feature/app_history</li>
+</div>
+<div class="def-api-feature">
+<p><div class="description">
+            <p>
 To guarantee the running of the application on a device which has battery, declare the following feature requirement in the config file:
             </p>
            </div></p>

diff --git a/org.tizen.web.apireference/html/device_api/wearable/tizen/application.html b/org.tizen.web.apireference/html/device_api/wearable/tizen/application.html
index fb957c6..aef47e9 100755 (executable)
--- a/org.tizen.web.apireference/html/device_api/wearable/tizen/application.html
+++ b/org.tizen.web.apireference/html/device_api/wearable/tizen/application.html
@@ -1287,7 +1287,7 @@ InvalidValuesError - if any of the input parameters contains an invalid value.
  http://tizen.org/privilege/apphistory.read
             </p>
 <p><span class="remark"> Remark : </span>
- This method is available only on mobile devices. An attempt to call this method on other profile will result in throwing <em>NotSupportedError</em> exception.
+ This method is available only on mobile and wearable devices. An attempt to call this method on other profile will result in throwing <em>NotSupportedError</em> exception.
             </p>
 <div class="parameters">
 <p><span class="param">Parameters:</span></p>
@@ -1396,7 +1396,7 @@ InvalidValuesError - if any of the input parameters contains an invalid value.
  http://tizen.org/privilege/apphistory.read
             </p>
 <p><span class="remark"> Remark : </span>
- This method is available only on mobile devices.
+ This method is available only on mobile and wearable devices.
 An attempt to call this method on other profile will result in throwing <em>NotSupportedError</em> exception.
             </p>
 <div class="parameters">
@@ -3366,6 +3366,14 @@ Must be at least 1 byte in length and not exceed the maximum name length of 127
                     <div class="def-api-feature">
 <p><div class="description">
             <p>
+To guarantee the running of the application on a device which supports Application History feature, declare the following feature requirement in the config file:
+            </p>
+           </div></p>
+<li class="feature">http://tizen.org/feature/app_history</li>
+</div>
+<div class="def-api-feature">
+<p><div class="description">
+            <p>
 To guarantee the running of the application on a device which has battery, declare the following feature requirement in the config file:
             </p>
            </div></p>