From c8aaafd9320077af14acfcccad3d673c1dfdb5b4 Mon Sep 17 00:00:00 2001 From: Gloria Date: Wed, 16 Aug 2023 16:18:34 +0800 Subject: [PATCH] Update docs against 22128+21788 Signed-off-by: wusongqing --- .../task-management/background-task-overview.md | 11 ++++++++--- .../task-management/efficiency-resource-request.md | 4 +++- 2 files changed, 11 insertions(+), 4 deletions(-) diff --git a/en/application-dev/task-management/background-task-overview.md b/en/application-dev/task-management/background-task-overview.md index d786f6d796..8001a341b1 100644 --- a/en/application-dev/task-management/background-task-overview.md +++ b/en/application-dev/task-management/background-task-overview.md @@ -13,6 +13,10 @@ When you return to the home screen, lock the screen, or switch to another applic To ensure the normal use of features such as music playback and calendar reminders in the background, the system provides constrained background tasks to extend the running time of applications in the background. +## Resource Usage Constraints + +The system provides resource quotas for running processes, including the memory usage and CPU usage in a continuous period of time, as well as disk write I/O volume in 24 hours. When the quota is reached, the system generates a warning-level log if the process is running in the foreground, and terminates the process if it is running in the background. + ## Background Task Types For standard-system devices, OpenHarmony provides the following types of constrained background tasks: transient tasks, continuous tasks, deferred tasks, agent-powered reminders, and efficiency resources. @@ -29,12 +33,13 @@ You can select a proper background task type to ensure that your application can For system applications that provide basic capabilities, the system provides an API for [requesting energy resources](efficiency-resource-request.md). After an application calls the API, the system exempts the application from management. - **Figure 1** Selecting a type of background task +**Figure 1** Selecting a type of background task + ![bgtask_choice](figures/bgtask_choice.png) > **NOTE** > -> 1. The system supports only constrained background tasks. If an application does not use a constrained background task or selects an inappropriate type of background task after switching to the background, its process will be suspended or terminated. +> - The system supports only constrained background tasks. If an application does not use a constrained background task or selects an inappropriate type of background task after switching to the background, its process will be suspended or terminated. > -> 2. For an application that requests a constrained background task, only the priority of reclaiming the application process is increased. If system resources are severely insufficient, the application process may still be terminated. +> - For an application that requests a constrained background task, only the priority of reclaiming the application process is increased. If system resources are severely insufficient, the application process may still be terminated. diff --git a/en/application-dev/task-management/efficiency-resource-request.md b/en/application-dev/task-management/efficiency-resource-request.md index 16fb4579ff..cd6d215496 100644 --- a/en/application-dev/task-management/efficiency-resource-request.md +++ b/en/application-dev/task-management/efficiency-resource-request.md @@ -40,6 +40,7 @@ The table below lists the main APIs used for efficient resources. For details ab | reason | string | Yes| Reason for requesting the resource.| **Table 3** Efficiency resource types + | Name| Value| Description| | -------- | -------- | -------- | | CPU | 1 | CPU resource. Such type of resource prevents an application from being suspended.| @@ -49,7 +50,8 @@ The table below lists the main APIs used for efficient resources. For details ab | BLUETOOTH | 16 | Bluetooth resource. Such type of resource ensures that an application in the suspended state can be woken up by Bluetooth-related events.| | GPS | 32 | GPS resource. Such type of resource ensures that an application in the suspended state can be woken up by GPS-related events.| | AUDIO | 64 | Audio resource. Such type of resource prevents an application from being suspended when the application has an audio being played.| - +| RUNNING_LOCK10+ | 128 | RUNNING_LOCK resource. Such type of resources prevents locks running in the background from being temporarily released when the application is suspended.| +| SENSOR10+ | 256 | Sensor resource. Such type of resources prevents sensor callbacks from being intercepted.| ## How to Develop -- GitLab