diff --git a/en/application-dev/reference/apis/Readme-EN.md b/en/application-dev/reference/apis/Readme-EN.md
index e1f64b915980aa23b9c1154f435a500a34922938..2848929b4d30fbc206344134e3e8047d030815d5 100644
--- a/en/application-dev/reference/apis/Readme-EN.md
+++ b/en/application-dev/reference/apis/Readme-EN.md
@@ -206,6 +206,7 @@
- [@ohos.arkui.dragController (DragController)](js-apis-arkui-dragController.md)
- [@ohos.arkui.drawableDescriptor (DrawableDescriptor)](js-apis-arkui-drawableDescriptor.md)
- [@ohos.arkui.inspector (Layout Callback)](js-apis-arkui-inspector.md)
+ - [@ohos.arkui.performanceMonitor (Performance Monitor)](js-apis-arkui-performancemonitor.md)
- [@ohos.arkui.UIContext (UIContext)](js-apis-arkui-UIContext.md)
- [@ohos.curves (Interpolation Calculation)](js-apis-curve.md)
- [@ohos.font (Custom Font Registration)](js-apis-font.md)
diff --git a/en/application-dev/reference/apis/js-apis-arkui-performancemonitor.md b/en/application-dev/reference/apis/js-apis-arkui-performancemonitor.md
new file mode 100644
index 0000000000000000000000000000000000000000..b0722ac2aaf43f8a958ce53f0dbe2b02c41fc4c7
--- /dev/null
+++ b/en/application-dev/reference/apis/js-apis-arkui-performancemonitor.md
@@ -0,0 +1,71 @@
+# @ohos.arkui.performanceMonitor (Performance Monitor)
+
+The **performanceMonitor** module provides APIs for performance monitoring indicators: response delay, completion delay, and frame loss rate.
+
+> **NOTE**
+>
+> The APIs of this module are supported since API version 10. Updates will be marked with a superscript to indicate their earliest API version.
+>
+> The APIs provided by this module are system APIs.
+
+
+## Modules to Import
+
+```ts
+import performanceMonitor from '@ohos.arkui.performanceMonitor';
+```
+
+
+## ActionType
+
+Enumerates types of actions that trigger user scenes.
+
+**System capability**: SystemCapability.ArkUI.ArkUI.Full
+
+| Name| Value| Description|
+| -- | -- | -- |
+| LAST_DOWN | 0 | Pressing against the screen. |
+| LAST_UP | 1 | Lifting a finger off the screen.|
+| FIRST_MOVE | 2 | First swiping on the screen.|
+
+
+## performanceMonitor.begin
+
+begin(scene: string, startInputType: ActionType, note?: string): void
+
+Starts a user scene.
+
+
+**System capability**: SystemCapability.ArkUI.ArkUI.Full
+
+**Parameters**
+
+| Name| Type| Mandatory| Description|
+| -- | -- | -- | -- |
+| scene | string | Yes| User scene ID.|
+| startInputType | [ActionType](#actiontype)| Yes| Type of action that triggers the user scene.|
+| note | string| No| Important information about the user scene.|
+
+**Example**
+ ```ts
+performanceMonitor.begin("LAUNCHER_APP_LAUNCH_FROM_ICON", performanceMonitor.ActionType.LAST_UP, "APP_START_BEGIN");
+ ```
+
+
+## performanceMonitor.end
+
+end(scene: string): void
+
+Ends a user scene.
+
+**System capability**: SystemCapability.ArkUI.ArkUI.Full
+
+**Parameters**
+| Name| Type| Mandatory| Description|
+| -- | -- | -- | -- |
+| scene | string | Yes| User scene ID, which corresponds to that in **begin**.|
+
+**Example**
+ ```ts
+performanceMonitor.end("LAUNCHER_APP_LAUNCH_FROM_ICON");
+ ```
diff --git a/en/application-dev/reference/apis/js-apis-settings.md b/en/application-dev/reference/apis/js-apis-settings.md
index 2acac025ffeffe32677f5af17b1e1cabfeb6655b..4fa35b6878ef99f3509af1444e38e89c2ab6f4fd 100644
--- a/en/application-dev/reference/apis/js-apis-settings.md
+++ b/en/application-dev/reference/apis/js-apis-settings.md
@@ -3,7 +3,7 @@
The **settings** module provides APIs for setting data items.
> **NOTE**
->
+>
> The initial APIs of this module are supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
## Modules to Import
@@ -24,8 +24,8 @@ Provides data items for setting the time and date formats.
| ------------------- | ------ | ---- | ---- | ------------------------------------------------------------ |
| DATE_FORMAT | string | Yes | Yes | Date format. The value can be **mm/dd/yyyy**, **dd/mm/yyyy**, or **yyyy/mm/dd**, where **mm** indicates the month, **dd** indicates the day, and **yyyy** indicates the year.|
| TIME_FORMAT | string | Yes | Yes | Time format. **12**: 12-hour format. **24**: 24-hour format.|
-| AUTO_GAIN_TIME | string | Yes | Yes | Whether the date, time, and time zone are automatically obtained from the Network Identity and Time Zone (NITZ). The value **true** means that the date, time, and time zone are automatically obtained from NITZ; and **false** means the opposite. |
-| AUTO_GAIN_TIME_ZONE | string | Yes | Yes | Whether the time zone is automatically obtained from NITZ. The value **true** means that the time zone is automatically obtained from NITZ; and **false** means the opposite. |
+| AUTO_GAIN_TIME | string | Yes | Yes | Whether the date, time, and time zone are automatically obtained from the Network Identity and Time Zone (NITZ). The value **true** means that the date, time, and time zone are automatically obtained from NITZ; and **false** means the opposite.|
+| AUTO_GAIN_TIME_ZONE | string | Yes | Yes | Whether the time zone is automatically obtained from NITZ. The value **true** means that the time zone is automatically obtained from NITZ; and **false** means the opposite.|
## display
@@ -39,7 +39,7 @@ Provides data items for setting the display effects.
| ----------------------------- | ------ | ---- | ---- | ------------------------------------------------------------ |
| FONT_SCALE | string | Yes | Yes | Scale factor of the font. The value is a floating point number. |
| SCREEN_BRIGHTNESS_STATUS | string | Yes | Yes | Screen brightness. The value ranges from 0 to 255. |
-| AUTO_SCREEN_BRIGHTNESS | string | Yes | Yes | Whether automatic screen brightness adjustment is enabled. **AUTO_SCREEN_BRIGHTNESS_MODE**: Automatic screen brightness adjustment is enabled. **MANUAL_SCREEN_BRIGHTNESS_MODE**: Automatic screen brightness adjustment is disabled. |
+| AUTO_SCREEN_BRIGHTNESS | string | Yes | Yes | Whether automatic screen brightness adjustment is enabled. **AUTO_SCREEN_BRIGHTNESS_MODE**: Automatic screen brightness adjustment is enabled.
**MANUAL_SCREEN_BRIGHTNESS_MODE**: Automatic screen brightness adjustment is disabled.|
| AUTO_SCREEN_BRIGHTNESS_MODE | number | Yes | Yes | Value of **AUTO_SCREEN_BRIGHTNESS** when automatic screen brightness adjustment is enabled. |
| MANUAL_SCREEN_BRIGHTNESS_MODE | number | Yes | Yes | Value of **AUTO_SCREEN_BRIGHTNESS** when automatic screen brightness adjustment is disabled. |
| SCREEN_OFF_TIMEOUT | string | Yes | Yes | Waiting time for the device to enter the sleep state when not in use (unit: ms). |
@@ -47,7 +47,7 @@ Provides data items for setting the display effects.
| ANIMATOR_DURATION_SCALE | string | Yes | Yes | Scale factor for the animation duration. This affects the start delay and duration of all such animations. If the value is **0**, the animation ends immediately. The default value is **1**.|
| TRANSITION_ANIMATION_SCALE | string | Yes | Yes | Scale factor for transition animations. The value **0** indicates that the transition animations are disabled. |
| WINDOW_ANIMATION_SCALE | string | Yes | Yes | Scale factor for normal window animations. The value **0** indicates that window animations are disabled. |
-| DISPLAY_INVERSION_STATUS | string | Yes | Yes | Whether display color inversion is enabled. **1**: Display color inversion is enabled. **0**: Display color inversion is disabled.|
+| DISPLAY_INVERSION_STATUS | string | Yes | Yes | Whether display color inversion is enabled. **1**: Display color inversion is enabled.
**0**: Display color inversion is disabled.|
## general
@@ -186,57 +186,57 @@ Provides data items for setting wireless network information.
| WIFI_WATCHDOG_STATUS | string | Yes | Yes | Whether Wi-Fi watchdog is available. **true**: Wi-Fi watchdog is available. **false**: Wi-Fi watchdog is unavailable.|
-## settings.setValue
+## settings.setValue10+
-setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: object, callback: AsyncCallback\): void
+setValue(context: Context, name: string, value: string, callback: AsyncCallback\): void
-Sets the value for a data item. This API uses an asynchronous callback to return the result.
+Sets the value for a data item. This API uses an asynchronous callback to return the result.
-**System API**: This is a system API.
+**Model restriction**: This API can be used only in the stage model.
**System capability**: SystemCapability.Applications.settings.Core
+**Required permissions**: ohos.permission.MANAGE_SECURE_SETTINGS
+
**Parameters**
-| Name | Type | Mandatory| Description |
-| ----------------- | ------------------------------------------------- | ---- | ------------------------------------------------------------ |
-| dataAbilityHelper | [DataAbilityHelper](js-apis-inner-ability-dataAbilityHelper.md) | Yes | **DataAbilityHelper** class. |
-| name | string | Yes | Name of the target data item. Data items can be classified as follows: - Existing data items in the database - Custom data items|
-| value | object | Yes | Value of the data item. The value range varies by service. |
-| callback | AsyncCallback\ | Yes | Callback used to return the result. Returns **true** if the operation is successful; returns **false** otherwise. |
+| Name | Type | Mandatory| Description |
+| -------- | ----------------------- | ---- | ------------------------------------------------------------ |
+| context | Context | Yes | Application context. For details about the application context of the stage model, see [Context](js-apis-inner-application-context.md).|
+| name | string | Yes | Name of the target data item. Data items can be classified as follows: - Existing data items in the database - Custom data items|
+| value | string | Yes | Value of the data item. The value range varies by service. |
+| callback | AsyncCallback\ | Yes | Callback used to return the result. Returns **true** if the operation is successful; returns **false** otherwise. |
**Example**
```js
-import featureAbility from '@ohos.ability.featureAbility';
+import settings from '@ohos.settings';
// Update the value of SCREEN_BRIGHTNESS_STATUS. (As this data item exists in the database, the setValue API will update its value.)
-let uri = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS);
-let helper = featureAbility.acquireDataAbilityHelper(uri);
-// @ts-ignore
-// The value of the data item is a string.
-settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100', (status) => {
- console.log('Callback return whether value is set.');
+settings.setValue(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS, '100', (status) => {
+ console.log('Callback return whether value is set.');
});
```
-## settings.setValue
+## settings.setValue10+
-setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: object): Promise\
+setValue(context: Context, name: string, value: string): Promise\
Sets the value for a data item. This API uses a promise to return the result.
-**System API**: This is a system API.
+**Model restriction**: This API can be used only in the stage model.
**System capability**: SystemCapability.Applications.settings.Core
+**Required permissions**: ohos.permission.MANAGE_SECURE_SETTINGS
+
**Parameters**
-| Name | Type | Mandatory| Description |
-| ----------------- | ------------------------------------------------- | ---- | ------------------------------------------------------------ |
-| dataAbilityHelper | [DataAbilityHelper](js-apis-inner-ability-dataAbilityHelper.md) | Yes | **DataAbilityHelper** class. |
-| name | string | Yes | Name of the target data item. Data items can be classified as follows: - Existing data items in the database - Custom data items|
-| value | object | Yes | Value of the data item. The value range varies by service. |
+| Name | Type | Mandatory| Description |
+| ------- | ------- | ---- | ------------------------------------------------------------ |
+| context | Context | Yes | Application context. For details about the application context of the stage model, see [Context](js-apis-inner-application-context.md).|
+| name | string | Yes | Name of the target data item. Data items can be classified as follows: - Existing data items in the database - Custom data items|
+| value | string | Yes | Value of the data item. The value range varies by service. |
**Return value**
@@ -247,18 +247,149 @@ Sets the value for a data item. This API uses a promise to return the result.
**Example**
```js
-import featureAbility from '@ohos.ability.featureAbility';
+import settings from '@ohos.settings';
// Update the value of SCREEN_BRIGHTNESS_STATUS. (As this data item exists in the database, the setValue API will update its value.)
-let uri = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS);
-let helper = featureAbility.acquireDataAbilityHelper(uri);
-// @ts-ignore
-// The value of the data item is a string.
-settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100').then((status) => {
- console.log('Callback return whether value is set.');
+settings.setValue(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS, '100').then((status) => {
+ console.log('Callback return whether value is set.');
+});
+```
+
+## setting.getValue10+
+
+getValue(context: Context, name: string, callback: AsyncCallback\): void
+
+Obtains the value of a data item in the database. This API uses an asynchronous callback to return the result.
+
+**Model restriction**: This API can be used only in the stage model.
+
+**System capability**: SystemCapability.Applications.settings.Core
+
+**Parameters**
+
+| Name | Type | Mandatory| Description |
+| -------- | ---------------------- | ---- | ------------------------------------------------------------ |
+| context | Context | Yes | Application context. For details about the application context of the stage model, see [Context](js-apis-inner-application-context.md).|
+| name | string | Yes | Name of the target data item. Data items can be classified as follows: - Existing data items in the database - Custom data items|
+| callback | AsyncCallback\ | Yes | Callback used to return the value of the data item. |
+
+**Example**
+
+```js
+import settings from '@ohos.settings';
+
+settings.getValue(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS, (err, value) => {
+ if (err) {
+ console.error(`Failed to get the setting. ${err.message} `);
+ return;
+ }
+ console.log(`callback:value -> ${JSON.stringify(value)}`)
});
```
+## setting.getValue10+
+
+getValue(context: Context, name: string): Promise\
+
+Obtains the value of a data item in the database. This API uses a promise to return the result.
+
+**Model restriction**: This API can be used only in the stage model.
+
+**System capability**: SystemCapability.Applications.settings.Core
+
+**Parameters**
+
+| Name | Type | Mandatory| Description |
+| ------- | ------- | ---- | ------------------------------------------------------------ |
+| context | Context | Yes | Application context. For details about the application context of the stage model, see [Context](js-apis-inner-application-context.md).|
+| name | string | Yes | Name of the target data item. Data items can be classified as follows: - Existing data items in the database - Custom data items|
+
+**Return value**
+
+| Type | Description |
+| ---------------- | ----------------------------------- |
+| Promise\ | Promise used to return the value of the data item.|
+
+**Example**
+
+```js
+import settings from '@ohos.settings';
+
+settings.getValue(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS).then((value) => {
+ console.log(`promise:value -> ${JSON.stringify(value)}`)
+});
+```
+
+## settings.getValueSync10+
+
+getValueSync(context: Context, name: string, defValue: string): string;
+
+Obtains the value of a data item. Unlike **getValue**, this API returns the result synchronously.
+
+**Model restriction**: This API can be used only in the stage model.
+
+**System capability**: SystemCapability.Applications.settings.Core
+
+**Parameters**
+
+| Name | Type | Mandatory| Description |
+| -------- | ------- | ---- | ------------------------------------------------------------ |
+| context | Context | Yes | Application context. For details about the application context of the stage model, see [Context](js-apis-inner-application-context.md).|
+| name | string | Yes | Name of the target data item. Data items can be classified as follows: - Existing data items in the database - Custom data items|
+| defValue | string | Yes | Default value, which is returned when the value of a data item is not found in the database. Set this parameter as needed.|
+
+**Return value**
+
+| Type | Description |
+| ------ | ---------------- |
+| string | Value of the data item.|
+
+**Example**
+
+```js
+import settings from '@ohos.settings';
+
+// Obtain the value of SCREEN_BRIGHTNESS_STATUS (this data item already exists in the database).
+let value = settings.getValueSync(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS, '10');
+```
+
+## settings.setValueSync10+
+
+setValueSync(context: Context, name: string, value: string): boolean
+
+Sets the value for a data item. Unlike **setValue**, this API returns the result synchronously.
+
+If the specified data item exists in the database, the **setValueSync** method updates the value of the data item. If the data item does not exist in the database, the **setValueSync** method inserts the data item into the database.
+
+**Model restriction**: This API can be used only in the stage model.
+
+**System capability**: SystemCapability.Applications.settings.Core
+
+**Required permissions**: ohos.permission.MANAGE_SECURE_SETTINGS
+
+**Parameters**
+
+| Name | Type | Mandatory| Description |
+| ------- | ------- | ---- | ------------------------------------------------------------ |
+| context | Context | Yes | Application context. For details about the application context of the stage model, see [Context](js-apis-inner-application-context.md).|
+| name | string | Yes | Name of the target data item. Data items can be classified as follows: - Existing data items in the database - Custom data items|
+| value | string | Yes | Value of the data item. The value range varies by service. |
+
+**Return value**
+
+| Type | Description |
+| ------- | ------------------------------------------------------------ |
+| boolean | Result indicating whether the value is set successfully. Returns **true** if the value is set successfully; returns **false** otherwise.|
+
+**Example**
+
+```js
+import settings from '@ohos.settings';
+
+// Update the value of SCREEN_BRIGHTNESS_STATUS. (As this data item exists in the database, the setValueSync API will update the value of the data item.)
+let ret = settings.setValueSync(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS, '100');
+```
+
## settings.enableAirplaneMode
enableAirplaneMode(enable: boolean, callback: AsyncCallback\): void
@@ -390,7 +521,7 @@ Obtains the URI of a data item.
```js
// Obtain the URI of a data item.
-let urivar = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS);
+let uriVar = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS);
```
## setting.getURI(deprecated)
@@ -401,7 +532,7 @@ Obtains the URI of a data item. This API uses an asynchronous callback to return
> **NOTE**
>
-> This API is supported since API version 7 and deprecated since API version 9.
+> This API is supported since API version 7 and deprecated since API version 9. No substitute API is provided.
**System capability**: SystemCapability.Applications.settings.Core
@@ -428,7 +559,7 @@ Obtains the URI of a data item. This API uses a promise to return the result.
> **NOTE**
>
-> This API is supported since API version 7 and deprecated since API version 9.
+> This API is supported since API version 7 and deprecated since API version 9. No substitute API is provided.
**System capability**: SystemCapability.Applications.settings.Core
@@ -452,6 +583,91 @@ settings.getURI(settings.display.SCREEN_BRIGHTNESS_STATUS).then((uri) => {
})
```
+## settings.setValue(deprecated)
+
+setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: object, callback: AsyncCallback\): void
+
+Sets the value for a data item. This API uses an asynchronous callback to return the result.
+
+> **NOTE**
+>
+> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [setValue()](#settingssetvalue10) instead.
+
+**System API**: This is a system API.
+
+**Model restriction**: This API can be used only in the FA model.
+
+**System capability**: SystemCapability.Applications.settings.Core
+
+**Parameters**
+
+| Name | Type | Mandatory| Description |
+| ----------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
+| dataAbilityHelper | [DataAbilityHelper](js-apis-inner-ability-dataAbilityHelper.md) | Yes | **DataAbilityHelper** class. |
+| name | string | Yes | Name of the target data item. Data items can be classified as follows: - Existing data items in the database - Custom data items|
+| value | object | Yes | Value of the data item. The value range varies by service. |
+| callback | AsyncCallback\ | Yes | Callback used to return the result. Returns **true** if the operation is successful; returns **false** otherwise. |
+
+**Example**
+
+```js
+import featureAbility from '@ohos.ability.featureAbility';
+
+// Update the value of SCREEN_BRIGHTNESS_STATUS. (As this data item exists in the database, the setValue API will update its value.)
+let uri = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS);
+let helper = featureAbility.acquireDataAbilityHelper(uri);
+//@ts-ignore
+// The value of the data item is a string.
+settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100', (status) => {
+ console.log('Callback return whether value is set.');
+});
+```
+
+## settings.setValue(deprecated)
+
+setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: object): Promise\
+
+Sets the value for a data item. This API uses a promise to return the result.
+
+> **NOTE**
+>
+> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [setValue()](#settingssetvalue10-1) instead.
+
+**System API**: This is a system API.
+
+**Model restriction**: This API can be used only in the FA model.
+
+**System capability**: SystemCapability.Applications.settings.Core
+
+**Parameters**
+
+| Name | Type | Mandatory| Description |
+| ----------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
+| dataAbilityHelper | [DataAbilityHelper](js-apis-inner-ability-dataAbilityHelper.md) | Yes | **DataAbilityHelper** class. |
+| name | string | Yes | Name of the target data item. Data items can be classified as follows: - Existing data items in the database - Custom data items|
+| value | object | Yes | Value of the data item. The value range varies by service. |
+
+**Return value**
+
+| Type | Description |
+| ----------------- | -------------------------------------------------- |
+| Promise\ | Promise used to return the result. Returns **true** if the operation is successful; returns **false** otherwise.|
+
+**Example**
+
+```js
+import featureAbility from '@ohos.ability.featureAbility';
+
+// Update the value of SCREEN_BRIGHTNESS_STATUS. (As this data item exists in the database, the setValue API will update its value.)
+let uri = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS);
+let helper = featureAbility.acquireDataAbilityHelper(uri);
+//@ts-ignore
+// The value of the data item is a string.
+settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100').then((status) => {
+ console.log('Callback return whether value is set.');
+});
+```
+
## setting.getValue(deprecated)
getValue(dataAbilityHelper: DataAbilityHelper, name: string, callback: AsyncCallback\