!13709 后台任务文档修改

Merge pull request !13709 from 张鑫/master

zh-cn/application-dev/reference/apis/js-apis-resourceschedule-backgroundTaskManager.md

@@ -66,8 +66,8 @@ requestSuspendDelay(reason: string, callback: Callback<void>): DelaySuspen
     let delayInfo = backgroundTaskManager.requestSuspendDelay(myReason, () => {
         console.info("Request suspension delay will time out.");
     })
-    var id = delayInfo.requestId;
-    var time = delayInfo.actualDelayTime;
+    let id = delayInfo.requestId;
+    let time = delayInfo.actualDelayTime;
     console.info("The requestId is: " + id);
     console.info("The actualDelayTime is: " + time);
   } catch (error) {
@@ -281,6 +281,7 @@ export default class EntryAbility extends UIAbility {
             wantAgentFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
         };
 
+        try {
             wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
                 try {
                     backgroundTaskManager.startBackgroundRunning(this.context,
@@ -289,6 +290,9 @@ export default class EntryAbility extends UIAbility {
                     console.error(`Operation startBackgroundRunning failed. code is ${error.code} message is ${error.message}`);
                 }
             });
+        } catch (error) {
+            console.error(`Operation getWantAgent failed. code is ${error.code} message is ${error.message}`);
+        }
     }
 };
 ```
@@ -352,6 +356,7 @@ export default class EntryAbility extends UIAbility {
             wantAgentFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
         };
 
+        try {
             wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
                 try {
                     backgroundTaskManager.startBackgroundRunning(this.context,
@@ -364,6 +369,9 @@ export default class EntryAbility extends UIAbility {
                     console.error(`Operation startBackgroundRunning failed. code is ${error.code} message is ${error.message}`);
                 }
             });
+        } catch (error) {
+            console.error(`Operation getWantAgent failed. code is ${error.code} message is ${error.message}`);
+        }
     }
 };
 ```

zh-cn/application-dev/task-management/background-task-overview.md

@@ -100,13 +100,13 @@ OpenHarmony提供了九种后台模式，供需要在后台做长时任务的业
   - 携带参数信息支持number、string、bool三种类型。
 
 ## 申请能效资源
-能效资源可以分为四种：CPU资源，WORK_SCHEDULER资源，软件资源(COMMON_EVENT，TIMER)，硬件资源(GPS,BLUETOOTH,AUDIO)。
+供系统应用使用的能效资源可以分为两类：软件资源(WORK_SCHEDULER, COMMON_EVENT, TIMER)，硬件资源(CPU, GPS, BLUETOOTH, AUDIO)。
 
-应用或进程申请能效资源后能够获得相应特权：
+应用申请不同的能效资源后可以执行相应的操作：
   * 申请CPU资源后可以不被挂起，直到任务完成。
-  * 申请WORK_SCHEDULER资源后不受延迟任务执行频率约束，且任务执行时间增加
-  * 申请COMMON_EVENT资源后，应用在后台处于挂起状态时，仍然能够接收到系统公共事件，申请TIMER资源后，应用能够使用定时器执行精确定时任务、
-  * 申请硬件资源后，应用在后台被挂起后，依然能够被相关服务唤醒，执行相应的任务。
+  * 申请WORK_SCHEDULER资源后不受延迟任务执行频率约束，且任务执行时间增加。
+  * 申请COMMON_EVENT资源后，应用在后台处于挂起状态时，仍然能够接收到系统公共事件，申请TIMER资源后，应用能够使用定时器执行精确定时任务。
+  * 申请资源（GPS, BLUETOOTH, AUDIO）后，应用在后台被挂起后，依然能够被管理相关硬件的服务唤醒，执行相应的任务。
 
 
 **表1** 能效资源种类
@@ -125,4 +125,4 @@ OpenHarmony提供了九种后台模式，供需要在后台做长时任务的业
 - 能效资源申请或者释放可以由进程或者应用发起，由应用发起的资源释放会释放属于它的同类型的所有资源，包括进程申请的资源。例如应用申请了CPU资源,进程申请了CPU和WORK_SCHEDULER资源，当应用释放CPU资源的时候，会将进程的CPU资源一同释放，同时不同类型的WORK_SCHEDULER资源不受影响。由进程发起的资源释放对应用申请的资源没有影响，例如当应用和进程同时申请了CPU，进程发起了CPU资源释放，应用的CPU资源不会被释放。
 - 同时申请同一类持久资源和非持久资源，持久资源会覆盖非持久资源，在超时时不会释放资源。例如应用首先申请了10s的CPU资源，然后在第5s的时候申请了持久的CPU资源，那么资源会变成持久的，非持久的CPU资源记录会被持久化的CPU资源记录覆盖，到了第10s的时候资源不会被释放，如果在第8s的时候提前释放了资源，那么会将CPU资源释放，无法单独释放其中非持久的或者持久的CPU资源。
 - WORK_SCHEDULER资源只能由应用申请和释放，不能由进程申请和释放。
-- 需要使用能效资源的应用，需要向应用中心提出申请，获取相应的特权。
+- 需要使用能效资源的应用必须是系统应用，同时需要向应用中心提出申请，配置相应的特权。

zh-cn/application-dev/task-management/continuous-task-dev-guide.md

@@ -89,6 +89,7 @@ struct Index {
     };
 
     // 通过wantAgent模块的getWantAgent方法获取WantAgent对象
+    try {
         wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
             try {
                 backgroundTaskManager.startBackgroundRunning(this.context,
@@ -101,6 +102,9 @@ struct Index {
                 console.error(`Operation startBackgroundRunning failed. code is ${error.code} message is ${error.message}`);
             }
         });
+    } catch (error) {
+        console.error(`Operation getWantAgent failed. code is ${error.code} message is ${error.message}`);
+    }
   }
 
   stopContinuousTask() {
@@ -176,6 +180,7 @@ function startContinuousTask() {
     };
 
     // 通过wantAgent模块的getWantAgent方法获取WantAgent对象
+    try {
         wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
             try {
                 backgroundTaskManager.startBackgroundRunning(mContext,
@@ -188,6 +193,9 @@ function startContinuousTask() {
                 console.error(`Operation startBackgroundRunning failed. code is ${error.code} message is ${error.message}`);
             }
         });
+    } catch (error) {
+        console.error(`Operation getWantAgent failed. code is ${error.code} message is ${error.message}`);
+    }
 }
 
 function stopContinuousTask() {
@@ -335,6 +343,7 @@ function startContinuousTask() {
     };
 
     // 通过wantAgent模块的getWantAgent方法获取WantAgent对象
+    try {
         wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
             try {
                 backgroundTaskManager.startBackgroundRunning(featureAbility.getContext(),
@@ -347,6 +356,9 @@ function startContinuousTask() {
                 console.error(`Operation startBackgroundRunning failed. code is ${error.code} message is ${error.message}`);
             }
         });
+    } catch (error) {
+        console.error(`Operation getWantAgent failed. code is ${error.code} message is ${error.message}`);
+    }
 }
 
 function stopContinuousTask() {
@@ -396,7 +408,7 @@ class MyStub extends rpc.RemoteObject {
 }
 
 export default {
-    onStart(want) {
+    onStart() {
         console.info('ServiceAbility onStart');
         mMyStub = new MyStub("ServiceAbility-test");
         // 在执行后台长时任前，调用申请接口。
@@ -416,7 +428,7 @@ export default {
     onDisconnect() {
         console.info('ServiceAbility onDisconnect');
     },
-    onCommand(want, restart, startId) {
+    onCommand(want, startId) {
         console.info('ServiceAbility onCommand');
     }
 };

zh-cn/application-dev/task-management/efficiency-resources-apply-dev-guide.md

@@ -23,7 +23,7 @@
 2、当资源使用完毕，需要及时释放。支持释放部分资源或全部资源。
 
 ```js
-import backgroundTaskManager from '@ohos.backgroundTaskManager';
+import backgroundTaskManager from '@ohos.resourceschedule.backgroundTaskManager';
 
 // 申请能效资源
 let request = {
@@ -35,8 +35,14 @@ let request = {
     isPersist: true,
     isProcess: true,
 };
-let res = backgroundTaskManager.applyEfficiencyResources(request);
-console.info("the result of request is: " + res);
+
+let res;
+try {
+    res = backgroundTaskManager.applyEfficiencyResources(request);
+    console.info("the result of request is: " + res);
+} catch (error) {
+    console.error(`Operation applyEfficiencyResources failed. code is ${error.code} message is ${error.message}`);
+}
 
 // 释放部分资源
 request = {
@@ -44,10 +50,20 @@ request = {
     isApply: false,
     timeOut: 0,
     reason: "reset",
+    isPersist: true,
+    isProcess: true,
 };
-res = backgroundTaskManager.applyEfficiencyResources(request);
-console.info("the result of request is: " + res);
+try {
+    res = backgroundTaskManager.applyEfficiencyResources(request);
+    console.info("the result of request is: " + res);
+} catch (error) {
+    console.error(`Operation applyEfficiencyResources failed. code is ${error.code} message is ${error.message}`);
+}
 
 // 释放全部资源
-backgroundTaskManager.resetAllEfficiencyResources();
+try {
+    backgroundTaskManager.resetAllEfficiencyResources();
+} catch (error) {
+    console.error(`Operation resetAllEfficiencyResources failed. code is ${error.code} message is ${error.message}`);
+}
 ```