,
controller: WebController
} | - | JavaScript object to be injected into the window. Methods of this object can be invoked in the window. The parameters in this attribute cannot be updated.
**object** indicates the object to be registered. Methods can be declared, but not attributes. The parameters and return value can only be of the string, number, or Boolean type.
**name** indicates the name of the object to be registered, which is the same as that invoked in the window. After registration, the window can use this name to access the JavaScript object at the application side.
**methodList** indicates the methods of the JavaScript object to be registered at the application side.
**controller** indicates the controller.|
+| javaScriptAccess | boolean | true | Whether JavaScript scripts can be executed. By default, JavaScript scripts can be executed. |
+| mixedMode | [MixedMode](#mixedmode) | MixedMode.None | Whether to enable loading of HTTP and HTTPS hybrid content can be loaded. By default, this feature is disabled.|
+| onlineImageAccess | boolean | true | Whether to enable access to online images through HTTP and HTTPS. By default, this feature is enabled.|
+| zoomAccess | boolean | true | Whether to enable zoom gestures. By default, zoom gestures are enabled. |
+| overviewModeAccess | boolean | true | Whether to use the overview mode to load web pages. By default, this mode is used. |
+| databaseAccess | boolean | false | Whether to enable database access. By default, this feature is disabled. |
+| cacheMode | [CacheMode](#cachemode) | CacheMode.Default | Cache mode. |
+| textZoomAtio | number | 100 | Text zoom ratio of the page. The default value is **100**, which indicates 100%. |
+| userAgent | string | - | User agent. |
+
+> **NOTE**
>
> Only the following universal attributes are supported: [width](ts-universal-attributes-size.md#Attributes), [height](ts-universal-attributes-size.md#Attributes), [padding](ts-universal-attributes-size.md#Attributes), [margin](ts-universal-attributes-size.md#Attributes), and [border](ts-universal-attributes-border.md#Attributes).
-- MixedMode
-
- | Name | Description |
- | ---------- | ---------------------------------------- |
- | All | HTTP and HTTPS hybrid content can be loaded. This means that all insecure content can be loaded. |
- | Compatible | HTTP and HTTPS hybrid content can be loaded in compatibility mode. This means that some insecure content may be loaded. |
- | None | HTTP and HTTPS hybrid content cannot be loaded. |
## Events
-Universal events are not supported.
+The universal events are not supported.
-| Name | Description |
-| ---------------------------------------- | ---------------------------------------- |
-| onAlert(callback: (event?: { url: string; message: string; result: [JsResult](#jsresult) }) => boolean) | Triggered when **alert()** is invoked to display an alert dialog box on the web page.
If the callback returns **false**, the default dialog box is displayed. If the callback returns **true**, a system application can invoke the system dialog box capability (allows only the confirm operation) and invoke the **JsResult** API to notify the **\** component of the user's operation.
**url**: URL of the web page where the dialog box is displayed.
**message**: information displayed in the dialog box.
**JsResult**: notifies the **\** component of the user's operation.
|
-| onBeforeUnload(callback: (event?: { url: string; message: string; result: [JsResult](#jsresult) }) => boolean) | Triggered when the current page is about to exit after the user refreshes or closes the page.
If the callback returns **false**, the default dialog box is displayed. If the callback returns **true**, a system application can invoke the system dialog box capability (allows the confirm and cancel operations) and invoke the **JsResult** API to notify the **\** component of the user's operation.
**url**: URL of the web page where the dialog box is displayed.
**message**: information displayed in the dialog box.
**JsResult**: notifies the **\** component of the user's operation.
|
-| onConfirm(callback: (event?: { url: string; message: string; result: [JsResult](#jsresult) }) => boolean) | Triggered when **confirm()** is invoked to display a confirmation dialog box on the web page.
If the callback returns **false**, the default dialog box is displayed. If the callback returns **true**, a system application can invoke the system dialog box capability (allows the confirm and cancel operations) and invoke the **JsResult** API to notify the **\** component of the user's operation.
**url**: URL of the web page where the dialog box is displayed.
**message**: information displayed in the dialog box.
**JsResult**: notifies the **\** component of the user's operation.
|
+| Name | Description |
+| ------------------------------------------------------------ | ------------------------------------------------------------ |
+| onAlert(callback: (event?: { url: string; message: string; result: [JsResult](#jsresult) }) => boolean) | Triggered when **alert()** is invoked to display an alert dialog box on the web page.
If the callback returns **false**, the default dialog box is displayed. If the callback returns **true**, a system application can use the system dialog box (allows only the confirm operation) and invoke the **JsResult** API to notify the **\** component of the user's operation.
**url**: URL of the web page where the dialog box is displayed.
**message**: information displayed in the dialog box.
**JsResult**: the user's operation.
|
+| onBeforeUnload(callback: (event?: { url: string; message: string; result: [JsResult](#jsresult) }) => boolean) | Triggered when the current page is about to exit after the user refreshes or closes the page.
If the callback returns **false**, the default dialog box is displayed. If the callback returns **true**, a system application can use the system dialog box (allows the confirm and cancel operations) and invoke the **JsResult** API to notify the **\** component of the user's operation.
**url**: URL of the web page where the dialog box is displayed.
**message**: information displayed in the dialog box.
**JsResult**: the user's operation.
|
+| onConfirm(callback: (event?: { url: string; message: string; result: [JsResult](#jsresult) }) => boolean) | Triggered when **confirm()** is invoked by the web page.
If the callback returns **false**, the default dialog box is displayed. If the callback returns **true**, a system application can use the system dialog box (allows the confirm and cancel operations) and invoke the **JsResult** API to notify the **\** component of the user's operation.
**url**: URL of the web page where the dialog box is displayed.
**message**: information displayed in the dialog box.
**JsResult**: the user's operation.
|
| onConsole(callback: (event?: { message: [ConsoleMessage](#consolemessage) }) => boolean) | Triggered when the host application is notified of a JavaScript console message.
**message**: console message.
|
| onDownloadStart(callback: (event?: { url: string, userAgent: string, contentDisposition: string, mimetype: string, contentLength: number }) => void) | Triggered when a download task starts on the web page.
**url**: URL for the download task.
**userAgent**: name of the user agent (UA) for the download task.
**contentDisposition**: Content-Disposition response header returned by the server, which may be empty.
**mimetype**: content media type (MIME) returned by the server.
**contentLength**: length of the file returned by the server.
|
| onErrorReceive(callback: (event?: { request: [WebResourceRequest](#webresourceerror), error: [WebResourceError](#webresourceerror) }) => void) | Triggered when an error occurs during web page loading.
For better results, simplify the implementation logic in the callback.
**request**: encapsulation of a web page request.
**error**: encapsulation of a web page resource loading error.
|
| onHttpErrorReceive(callback: (event?: { request: [WebResourceRequest](#webresourceerror), response: [WebResourceResponse](#webresourceresponse) }) => void) | Triggered when an HTTP error (the response code is greater than or equal to 400) occurs during web page resource loading.
**request**: encapsulation of a web page request.
**response**: encapsulation of a web page response.
|
-| onPageBegin(callback: (event?: { url: string }) => void) | Triggered when the web page starts to be loaded. This API is triggered only for the main frame content, and not for the iframe or frameset content.
**url**: URL of the page.
|
-| onPageEnd(callback: (event?: { url: string }) => void) | Triggered when the web page loading is complete. This API is triggered only for the main frame content.
**url**: URL of the page.
|
+| onPageBegin(callback: (event?: { url: string }) => void) | Triggered when the web page starts to be loaded. This API is triggered only for the main frame content, and not for the iframe or frameset content.
**url**: URL of the page.
|
+| onPageEnd(callback: (event?: { url: string }) => void) | Triggered when the web page loading is complete. This API is triggered only for the main frame content.
**url**: URL of the page.
|
| onProgressChange(callback: (event?: { newProgress: number }) => void) | Triggered when the web page loading progress changes.
**newProgress**: new loading progress. The value is an integer ranging from 0 to 100.
|
| onTitleReceive(callback: (event?: { title: string }) => void) | Triggered when the document title of the web page is changed.
**title**: document title.
|
+| onRefreshAccessedHistory(callback: (event?: { url: string, isRefreshed: boolean }) => void) | Triggered when loading of the web page is complete. This callback function is used by an application to update the historical link it accessed.
**url**: URL to be accessed.
**isRefreshed**: whether the page is reloaded. The value **true** means that the page is reloaded, and **false** means that the page is newly loaded.
|
+| onRenderExited(callback: (event?: { renderExitReason: [RenderExitReason](#renderexitreason) }) => void) | Triggered when the rendering process exits abnormally.
**renderExitReason**: cause for the abnormal exit of the rendering process.
|
+| onShowFileSelector(callback: (event?: { result: [FileSelectorResult](#fileselectorresult), fileSelector: [FileSelectorParam](#fileselectorparam) }) => void) | Triggered to process an HTML form whose input type is **file**, in response to the tapping of the **Select File** button.
**result**: file selection result to be sent to the web component.
**fileSelector**: information about the file selector.
|
+| onUrlLoadIntercept(callback: (event?: { data:string \| [WebResourceRequest](#webresourcerequest) }) => boolean) | Triggered before the **\** component loads the URL to determine whether to block the access. The callback returns **true** if the access is blocked, and **false** otherwise.
**data**: URL information.
|
### ConsoleMessage
- APIs
- | Name | Description |
- | ------------------------------- | ---------------------------------------- |
- | getLineNumber(): number | Obtains the number of rows in the **ConsoleMessage**. |
- | getMessage(): string | Obtains the log information of the **ConsoleMessage**. |
- | getMessageLevel(): MessageLevel | Obtains the log information level of the **ConsoleMessage**. |
- | getSourceId(): string | Obtains the path and name of the web page source file. |
+ | Name | Description |
+ | ------------------------------- | ---------------------- |
+ | getLineNumber(): number | Obtains the number of rows in the **ConsoleMessage**. |
+ | getMessage(): string | Obtains the log information of the **ConsoleMessage**.|
+ | getMessageLevel(): MessageLevel | Obtains the log information level of the **ConsoleMessage**.|
+ | getSourceId(): string | Obtains the path and name of the web page source file. |
- MessageLevel enums
- | Name | Description |
- | ----- | :----------------- |
- | Debug | Debug level. |
- | Error | Error level. |
- | Info | Information level. |
- | Log | Log level. |
- | Warn | Warning level. |
+ | Name | Description |
+ | ----- | :---- |
+ | Debug | Debug level.|
+ | Error | Error level.|
+ | Info | Information level.|
+ | Log | Log level.|
+ | Warn | Warning level. |
### JsResult
-Represents the result returned to the **\** component to indicate the operation performed in the dialog box.
+Provides the result returned to the **\** component to indicate the user operation performed in the dialog box.
- APIs
- | Name | Description |
- | --------------------- | ---------------------------------------- |
- | handleCancel(): void | Notifies the **\** component that the user touches the Cancel button in the dialog box.
|
- | handleConfirm(): void | Notifies the **\** component that the user touches the Confirm button in the dialog box.
|
+ | Name | Description |
+ | --------------------- | ----------------------- |
+ | handleCancel(): void | The user's cancel operation in the dialog box.
|
+ | handleConfirm(): void | The user's confirm operation in the dialog box.
|
### WebResourceError
- APIs
- | Name | Description |
- | ---------------------- | ---------------------------------------- |
+ | Name | Description |
+ | ---------------------- | ------------ |
| getErrorCode(): number | Obtains the error code for resource loading. |
- | getErrorInfo(): string | Obtains error information about resource loading. |
+ | getErrorInfo(): string | Obtains error information about resource loading.|
### WebResourceRequest
- APIs
- | Name | Description |
- | ---------------------------------------- | ---------------------------------------- |
- | getRequestHeader(): Array\<[Header](#header)\> | Obtains the information about the resource request header. |
- | getRequestUrl(): string | Obtains the URL of the resource request. |
- | isMainFrame(): boolean | Checks whether the resource request is in the main frame. |
- | isRedirect(): boolean | Checks whether the resource request is redirected by the server. |
- | isRequestGesture(): boolean | Checks whether the resource request is associated with a gesture (for example, a tap). |
+ | Name | Description |
+ | ---------------------------------------- | -------------------- |
+ | getRequestHeader(): Array\<[Header](#header)\> | Obtains the information about the resource request header. |
+ | getRequestUrl(): string | Obtains the URL of the resource request. |
+ | isMainFrame(): boolean | Checks whether the resource request is in the main frame. |
+ | isRedirect(): boolean | Checks whether the resource request is redirected by the server. |
+ | isRequestGesture(): boolean | Checks whether the resource request is associated with a gesture (for example, a tap).|
### Header
-Describes the request/response header object returned by the **\** component.
+Describes the request/response header returned by the **\** component.
- Parameters
- | Name | Type | Description |
- | ----------- | ------ | ------------------------------------- |
- | headerKey | string | Key of the request/response header. |
- | headerValue | string | Value of the request/response header. |
+ | Name | Type | Description |
+ | ----------- | ------ | ------------- |
+ | headerKey | string | Key of the request/response header. |
+ | headerValue | string | Value of the request/response header.|
### WebResourceResponse
- APIs
- | Name | Description |
- | ---------------------------------------- | ---------------------------------------- |
- | getReasonMessage(): string | Obtains the status code description of the resource response. |
- | getResponseCode(): number | Obtains the status code of the resource response. |
- | getResponseData(): string | Obtains the data in the resource response. |
- | getResponseEncoding(): string | Obtains the encoding of the resource response. |
- | getResponseHeader(): Array\<[Header](#header)\> | Obtains the resource response header. |
- | getResponseMimeType(): string | Obtains the media (MIME) type of the resource response. |
+ | Name | Description |
+ | ---------------------------------------- | ------------------ |
+ | getReasonMessage(): string | Obtains the status code description of the resource response. |
+ | getResponseCode(): number | Obtains the status code of the resource response. |
+ | getResponseData(): string | Obtains the data in the resource response. |
+ | getResponseEncoding(): string | Obtains the encoding of the resource response. |
+ | getResponseHeader(): Array\<[Header](#header)\> | Obtains the resource response header. |
+ | getResponseMimeType(): string | Obtains the media (MIME) type of the resource response.|
+
+### RenderExitReason
+
+Explains why the rendering process exits.
+
+| Name | Description |
+| -------------------------- | ----------------- |
+| ProcessAbnormalTermination | The rendering process exits abnormally. |
+| ProcessWasKilled | The rendering process receives a SIGKILL message or is manually terminated.|
+| ProcessCrashed | The rendering process crashes due to a segmentation error or other errors. |
+| ProcessOom | The program memory is running low. |
+| ProcessExitUnknown | Other reason. |
+
+### MixedMode
+
+| Name | Description |
+| ---------- | ---------------------------------- |
+| All | HTTP and HTTPS hybrid content can be loaded. This means that all insecure content can be loaded.|
+| Compatible | HTTP and HTTPS hybrid content can be loaded in compatibility mode. This means that some insecure content may be loaded. |
+| None | HTTP and HTTPS hybrid content cannot be loaded. |
+
+### CacheMode
+| Name | Description |
+| ------- | ------------------------------------ |
+| Default | The cache that has not expired is used to load the resources. If the resources do not exist in the cache, they will be obtained from the Internet.|
+| None | The cache is used to load the resources. If the resources do not exist in the cache, they will be obtained from the Internet. |
+| Online | The cache is not used to load the resources. All resources are obtained from the Internet. |
+| Only | The cache alone is used to load the resources. |
+
+### FileSelectorResult
+Notifies the **\** component of the file selection result.
+
+- APIs
+
+ | Name | Description |
+ | ---------------------------------------------- | ------------------------------------------------------------ |
+ | handleFileList(fileList: Array\): void | Instructs the **\** component to select a file.
**fileList**: list of files to operate. |
+
+### FileSelectorParam
+- APIs
+
+ | Name | Description |
+ | -------------------------------- | ------------ |
+ | getTitle(): string | Obtains the title of the file selector. |
+ | getMode(): FileSelectorMode | Obtains the mode of the file selector. |
+ | getAcceptType(): Array\ | Obtains the file filtering type. |
+ | isCapture(): boolean | Checks whether multimedia capabilities are invoked.|
+
+### FileSelectorMode
+| Name | Description |
+| -------------------- | ---------- |
+| FileOpenMode | Open and upload a file. |
+| FileOpenMultipleMode | Open and upload multiple files. |
+| FileOpenFolderMode | Open and upload a folder.|
+| FileSaveMode | Save a file. |
## WebController
@@ -179,15 +237,15 @@ Indicates whether a specific number of steps forward or backward can be performe
- Parameters
- | Name | Type | Mandatory | Default Value | Description |
- | ---- | ------ | --------- | ------------- | ---------------------------------------- |
- | step | number | Yes | - | Number of the steps to take. A positive number means to going forward, and a negative number means to going backward. |
+ | Name | Type | Mandatory | Default Value | Description |
+ | ---- | ------ | ---- | ---- | --------------------- |
+ | step | number | Yes | - | Number of the steps to take. A positive number means to going forward, and a negative number means to going backward.|
- Return value
- | Type | Description |
- | ------- | ---------------------------------------- |
- | boolean | Whether to go forward or backward from the current page. |
+ | Type | Description |
+ | ------- | --------- |
+ | boolean | Whether to go forward or backward from the current page.|
### backward
@@ -203,9 +261,9 @@ Deletes a specific application JavaScript object that is registered with the win
- Parameters
- | Name | Type | Mandatory | Default Value | Description |
- | ---- | ------ | --------- | ------------- | ---------------------------------------- |
- | name | string | Yes | - | Name of the registered JavaScript object, which can be used to invoke the corresponding object on the application side from the web side. |
+ | Name | Type | Mandatory | Default Value | Description |
+ | ---- | ------ | ---- | ---- | ---------------------------------------- |
+ | name | string | Yes | - | Name of the registered JavaScript object, which can be used to invoke the corresponding object on the application side from the web side.|
### forward
@@ -221,16 +279,15 @@ Obtains the element type of the area being clicked.
- HitTestType enums
- | Name | Description |
- | ------------- | ---------------------------------------- |
- | EditText | Editable area. |
- | Email | Email address. |
- | HttpAnchor | Hyperlink where **src** is **http**. |
- | HttpAnchorImg | Image with a hyperlink, where **src** is **http**. |
- | Img | HTML::img tag. |
- | Map | Geographical address. |
- | PhoneNumber | Phone number. |
- | Unknown | Unknown content. |
+ | Name | Description |
+ | ------------- | ------------------------ |
+ | EditText | Editable area. |
+ | Email | Email address. |
+ | HttpAnchor | Hyperlink where **src** is **http**. |
+ | HttpAnchorImg | Image with a hyperlink, where **src** is **http**.|
+ | Img | HTML::img tag. |
+ | Map | Geographical address. |
+ | Unknown | Unknown content. |
### loadData
@@ -244,13 +301,13 @@ If **baseUrl** is set to an HTTP or HTTPS URL, the encoded string will be proces
- options
- | Name | Type | Mandatory | Default Value | Description |
- | ---------- | ------ | --------- | ------------- | ---------------------------------------- |
- | data | string | Yes | - | Character string obtained after being Base64 or URL encoded. |
- | mimeType | string | Yes | - | Media type (MIME). |
- | encoding | string | Yes | - | Encoding type, which can be Base64 or URL. |
- | baseUrl | string | No | - | URL (HTTP/HTTPS/data compliant), which is assigned by the **\** component to **window.origin**. |
- | historyUrl | string | No | - | Historical record URL. If this parameter is not empty, it can be managed in historical records to implement page going backward and forward. This parameter is invalid when **baseUrl** is left empty. |
+ | Name | Type | Mandatory | Default Value | Description |
+ | ---------- | ------ | ---- | ---- | ---------------------------------------- |
+ | data | string | Yes | - | Character string obtained after being Base64 or URL encoded. |
+ | mimeType | string | Yes | - | Media type (MIME). |
+ | encoding | string | Yes | - | Encoding type, which can be Base64 or URL. |
+ | baseUrl | string | No | - | URL (HTTP/HTTPS/data compliant), which is assigned by the **\** component to **window.origin**.|
+ | historyUrl | string | No | - | Historical record URL. If this parameter is not empty, it can be managed in historical records to implement page going backward and forward. This parameter is invalid when **baseUrl** is left empty.|
### loadUrl
@@ -260,14 +317,14 @@ Loads a URL using the specified HTTP header.
The object injected through **loadUrl** is valid only in the current document. It will be invalid on a new page navigated to through **loadUrl**.
-Objects injected through **registerJavaScriptProxy** are still valid on a new page navigated to through **loadUrl**.
+The object injected through **registerJavaScriptProxy** is still valid on a new page navigated to through **loadUrl**.
- options
- | Name | Type | Mandatory | Default Value | Description |
- | ------- | -------------------------- | --------- | ------------- | ---------------------------------------- |
- | url | string | Yes | - | URL to load. |
- | headers | Array\<[Header](#header)\> | No | [] | Additional HTTP request header of the URL. |
+ | Name | Type | Mandatory | Default Value | Description |
+ | ------- | ------------------------------ | ---- | ---- | -------------- |
+ | url | string | Yes | - | URL to load. |
+ | headers | Array\<[Header](#header)\> | No | [] | Additional HTTP request header of the URL.|
### onActive
@@ -295,24 +352,24 @@ Injects a JavaScript object into the window and invokes the methods of the objec
- options
- | Name | Type | Mandatory | Default Value | Description |
- | ---------- | --------------- | --------- | ------------- | ---------------------------------------- |
- | object | object | Yes | - | Application-side JavaScript object to be registered. Methods can be declared, but not attributes. The parameters and return value can only be of the string, number, or Boolean type. |
- | name | string | Yes | - | Name of the object to be registered, which is the same as that invoked in the window. After registration, the window can use this name to access the JavaScript object at the application side. |
- | methodList | Array\ | Yes | - | Methods of the JavaScript object to be registered at the application side. |
+ | Name | Type | Mandatory | Default Value | Description |
+ | ---------- | --------------- | ---- | ---- | ---------------------------------------- |
+ | object | object | Yes | - | Application-side JavaScript object to be registered. Methods can be declared, but not attributes. The parameters and return value can only be of the string, number, or Boolean type.|
+ | name | string | Yes | - | Name of the object to be registered, which is the same as that invoked in the window. After registration, the window can use this name to access the JavaScript object at the application side.|
+ | methodList | Array\ | Yes | - | Methods of the JavaScript object to be registered at the application side. |
### runJavaScript
runJavaScript(options: { script: string, callback?: (result: string) => void }): void
-Asynchronously executes a JavaScript script. This API uses a callback to return the script execution result.**runJavaScript** can be invoked only after **loadUrl** is executed. For example, it can be executed in **onPageEnd**.
+Asynchronously executes a JavaScript script. This API uses a callback to return the script execution result. **runJavaScript** can be invoked only after **loadUrl** is executed. For example, it can be executed in **onPageEnd**.
- options
- | Name | Type | Mandatory | Default Value | Description |
- | -------- | ------------------------ | --------- | ------------- | ---------------------------------------- |
- | script | string | Yes | - | JavaScript script. |
- | callback | (result: string) => void | No | - | Callback used to return the result. Returns **null** if the JavaScript script fails to be executed or no value is returned. |
+ | Name | Type | Mandatory | Default Value | Description |
+ | -------- | ------------------------ | ---- | ---- | ---------------------------------------- |
+ | script | string | Yes | - | JavaScript script. |
+ | callback | (result: string) => void | No | - | Callback used to return the result. Returns **null** if the JavaScript script fails to be executed or no value is returned.|
### stop
@@ -320,9 +377,50 @@ stop(): void
Stops page loading.
+### clearHistory
+
+clearHistory(): void
+
+Clears the browsing history.
+
+### getCookieManager
+
+getCookieManager(): WebCookie
+
+Obtains the cookie management object of the **\** component.
+- Return value
+ | Type | Description |
+ | --------- | ---------------------------------------- |
+ | WebCookie | Cookie management object. For details, see [WebCookie](#webcookie).|
+## WebCookie
+Manages behavior of cookies in **\** components. All **\** components in an application share a **WebCookie**. You can use the **getCookieManager** API in **controller** to obtain the **WebCookie** for subsequent cookie management.
+### setCookie
+setCookie(url: string, value: string): boolean
+
+Sets the cookie. This API is synchronous.
+
+- Parameters
+
+ | Name | Type | Mandatory | Default Value | Description |
+ | ----- | ------ | ---- | ---- | ----------------- |
+ | url | string | Yes | - | URL of the cookie to set.|
+ | value | string | Yes | - | Value of the cookie to set. |
+- Return value
+ | Type | Description |
+ | ------- | ------------- |
+ | boolean | Returns **true** if the operation is successful; returns **false** otherwise.|
+
+### saveCookieSync
+saveCookieSync(): boolean
+
+Saves this cookie in the memory to the disk. This API is synchronous.
+- Return value
+ | Type | Description |
+ | ------- | -------------------- |
+ | boolean | Returns the operation result.|
## Example
-```
+```ts
// webComponent.ets
@Entry
@Component
@@ -344,7 +442,7 @@ struct WebComponent {
}
}
```
-```
+```html
diff --git a/en/application-dev/reference/arkui-ts/ts-basic-components-xcomponent.md b/en/application-dev/reference/arkui-ts/ts-basic-components-xcomponent.md
index f8e557dac894954cdef0c4fa0f9b5a6c336cedc2..3a90aab90084be24746bba23aa9b224b15b2b99f 100644
--- a/en/application-dev/reference/arkui-ts/ts-basic-components-xcomponent.md
+++ b/en/application-dev/reference/arkui-ts/ts-basic-components-xcomponent.md
@@ -1,6 +1,6 @@
# XComponent
- >  **NOTE**
+ > **NOTE**
> This component is supported since API version 8. Updates will be marked with a superscript to indicate their earliest API version.
The **\** can accept and display the EGL/OpenGLES and media data input.
@@ -19,20 +19,20 @@
- Name
- | Name | Type | Mandatory| Description |
- | ----------- | --------------------------------------------- | ---- | ------------------------------------------------------------ |
- | id | string | Yes | Unique ID of the component. The value can contain a maximum of 128 characters. |
- | type | string | Yes | Type of the component. The options are as follows:
-**surface**: The content of this component is displayed individually, without being combined with that of other components.
-**component**: The content of this component is displayed after having been combined with that of other components.
This API is defined but not implemented in OpenHarmony 3.1 Release. It will be available for use in OpenHarmony 3.1 MR.|
- | libraryname | string | No | Name of the dynamic library generated after compilation at the application native layer. |
+ | Name | Type | Mandatory | Description |
+ | ----------- | --------------------------------------- | --------- | ------------------------------------------------------------ |
+ | id | string | Yes | Unique ID of the component. The value can contain a maximum of 128 characters. |
+ | type | string | Yes | Type of the component. The options are as follows:
- **surface**: The content of this component is displayed individually, without being combined with that of other components.
- **component**: The content of this component is displayed after having been combined with that of other components. |
+ | libraryname | string | No | Name of the dynamic library generated after compilation at the application native layer. |
| controller | [XComponentController](#XComponentController) | No | Controller bound to the component, which can be used to invoke methods of the component. |
## Events
-| Name | Description |
+| Name | Description |
| ------------------------------- | ------------------------ |
-| onLoad(context?: object) => void | Triggered when the plug-in is loaded.|
-| onDestroy() => void | Triggered when the plug-in is destroyed.|
+| onLoad(context?: object) => void | Triggered when the plug-in is loaded. |
+| onDestroy() => void | Triggered when the plug-in is destroyed. |
## XComponentController
@@ -52,9 +52,9 @@ Obtains the ID of the surface held by the **\**. The ID can be used
- Return value
- | Type | Description |
+ | Type | Description |
| ------ | --------------------------- |
- | string | ID of the surface held by the **\**.|
+ | string | ID of the surface held by the **\**. |
### setXComponentSurfaceSize
@@ -64,10 +64,10 @@ Sets the width and height of the surface held by the **\**.
- Parameters
- | Name | Type| Mandatory| Default Value| Description |
+ | Name | Type | Mandatory | Default Value | Description |
| ------------- | -------- | ---- | ------ | ----------------------------- |
- | surfaceWidth | number | Yes | - | Width of the surface held by the **\**.|
- | surfaceHeight | number | Yes | - | Height of the surface held by the **\**.|
+ | surfaceWidth | number | Yes | - | Width of the surface held by the **\**. |
+ | surfaceHeight | number | Yes | - | Height of the surface held by the **\**. |
### getXComponentContext
@@ -85,7 +85,8 @@ Obtains the context of an **\** object.
Provide a surface-type **\** to support capabilities such as camera preview.
-```
+```ts
+// xxx.ets
import camera from '@ohos.multimedia.camera';
@Entry
@Component
diff --git a/en/application-dev/reference/arkui-ts/ts-canvasrenderingcontext2d.md b/en/application-dev/reference/arkui-ts/ts-canvasrenderingcontext2d.md
index d6c76db8635c77b616b0fe09484abe45349d86a6..7b91e7865dd58ad62ceedf02afc37944f54cf89e 100644
--- a/en/application-dev/reference/arkui-ts/ts-canvasrenderingcontext2d.md
+++ b/en/application-dev/reference/arkui-ts/ts-canvasrenderingcontext2d.md
@@ -1,11 +1,11 @@
# CanvasRenderingContext2D
->  **NOTE**
+> **NOTE**
> This component is supported since API version 8. Updates will be marked with a superscript to indicate their earliest API version.
-Use **RenderingContext** to draw rectangles, text, images, and other objects on a canvas.
+The **\** component is used to draw rectangles, text, images, and other objects on a canvas.
## APIs
@@ -15,7 +15,7 @@ CanvasRenderingContext2D(setting: RenderingContextSetting)
- Parameters
| Name | Type | Mandatory | Default Value | Description |
| ------- | ---------------------------------------- | --------- | ------------- | ----------------------------- |
- | setting | [RenderingContextSettings](#renderingcontextsettings) | Yes | - | See RenderingContextSettings. |
+ | setting | [RenderingContextSettings](#renderingcontextsettings) | Yes | - | See [RenderingContextSettings](#renderingcontextsettings). |
### RenderingContextSettings
@@ -34,15 +34,15 @@ Configures the settings of a **CanvasRenderingContext2D** object, including whet
| Name | Type | Default Value | Description |
| ---------------------------------------- | ---------------------------------------- | ------------------------------- | ---------------------------------------- |
-| [fillStyle](#fillstyle) | <color> \| [CanvasGradient](ts-components-canvas-canvasgradient.md) \| [CanvasPattern](#canvaspattern) | - | Style used to fill an area.
- When the type is **<color>**, this attribute indicates the fill color.
- When the type is **CanvasGradient**, this attribute indicates a gradient object, which is created using the [createLinearGradient](#createlineargradient) method.
- When the type is **CanvasPattern**, this attribute indicates a pattern, which is created using the [createPattern](#createpattern) method. |
+| [fillStyle](#fillstyle) | <color> \| [CanvasGradient](ts-components-canvas-canvasgradient.md) \| [CanvasPattern](#canvaspattern) | - | Style used to fill an area.
- When the type is **<color>**, this attribute indicates the fill color.
- When the type is **CanvasGradient**, this attribute indicates a gradient object, which is created using the [createLinearGradient](#createlineargradient) method.
- When the type is **CanvasPattern**, this attribute indicates a pattern, which is created using the [createPattern](#createpattern) method. |
| [lineWidth](#linewidth) | number | - | Line width. |
-| [strokeStyle](#strokestyle) | <color> \| [CanvasGradient](ts-components-canvas-canvasgradient.md) \| [CanvasPattern](#canvaspattern) | - | Stroke style.
- When the type is **<color>**, this attribute indicates the stroke color.
- When the type is **CanvasGradient**, this attribute indicates a gradient object, which is created using the [createLinearGradient](#createlineargradient) method.
- When the type is **CanvasPattern**, this attribute indicates a pattern, which is created using the [createPattern](#createpattern) method. |
-| [lineCap](#linecap) | string | 'butt' | Style of the line endpoints. The options are as follows:
- **'butt'**: The endpoints of the line are squared off.
- **'round'**: The endpoints of the line are rounded.
- **'square'**: The endpoints of the line are squared off by adding a box with an equal width and half the height of the line's thickness. |
-| [lineJoin](#linejoin) | string | 'miter' | Style of the shape used to join line segments. The options are as follows:
- **'round'**: The shape used to join line segments is a rounded corner with the radius equal to the line width.
- **'bevel'**: The shape used to join line segments is a beveled corner. The rectangular corner of each line is independent.
- **'miter'**: The shape used to join line segments is a mitered corner. The corner is formed by extending the outside edges of the lines until they meet. You can adjust the effect of this attribute using **miterLimit**. |
+| [strokeStyle](#strokestyle) | <color> \| [CanvasGradient](ts-components-canvas-canvasgradient.md) \| [CanvasPattern](#canvaspattern) | - | Stroke style.
- When the type is **<color>**, this attribute indicates the stroke color.
- When the type is **CanvasGradient**, this attribute indicates a gradient object, which is created using the [createLinearGradient](#createlineargradient) method.
- When the type is **CanvasPattern**, this attribute indicates a pattern, which is created using the [createPattern](#createpattern) method. |
+| [lineCap](#linecap) | string | 'butt' | Style of the line endpoints. The options are as follows:
- **'butt'**: The endpoints of the line are squared off.
- **'round'**: The endpoints of the line are rounded.
- **'square'**: The endpoints of the line are squared off by adding a box with an equal width and half the height of the line's thickness. |
+| [lineJoin](#linejoin) | string | 'miter' | Style of the shape used to join line segments. The options are as follows:
- **'round'**: The shape used to join line segments is a rounded corner with the radius equal to the line width.
- **'bevel'**: The shape used to join line segments is a beveled corner. The rectangular corner of each line is independent.
- **'miter'**: The shape used to join line segments is a mitered corner. The corner is formed by extending the outside edges of the lines until they meet. You can adjust the effect of this attribute using **miterLimit**. |
| [miterLimit](#miterlimit) | number | 10 | Maximum miter length. The miter length is the distance between the inner corner and the outer corner where two lines meet. |
-| [font](#font) | string | 'normal normal 14px sans-serif' | Font style.
Syntax: ctx.font='font-size font-family'
- (Optional) **font-size**: font size and row height. The unit can only be px.
- (Optional) **font-family**: font family.
Syntax: ctx.font='font-style font-weight font-size font-family'
- (Optional) **font-style**: font style. Available values are **'normal'** and **'italic'**.
- (Optional) **font-weight**: font weight. Available values are as follows: **'normal'**, **'bold'**, **'bolder'**, **'lighter'**, **100**, **200**, **300**, **400**, **500**, **600**, **700**, **800**, **900**
- (Optional) **font-size**: font size and row height. The unit can only be px.
- (Optional) **font-family**: font family. Available values are **'sans-serif'**, **'serif'**, and **'monospace'**. |
-| [textAlign](#textalign) | string | 'left' | Text alignment mode. Available values are as follows:
- **'left'**: The text is left-aligned.
- **'right'**: The text is right-aligned.
- **'center'**: The text is center-aligned.
- **'start'**: The text is aligned with the start bound.
- **'end'**: The text is aligned with the end bound.
>  **NOTE**
> In the **ltr** layout mode, the value **'start'** equals **'left'**. In the **rtl** layout mode, the value **'start'** equals **'right'**. |
-| [textBaseline](#textbaseline) | string | 'alphabetic' | Horizontal alignment mode of text. Available values are as follows:
- **'alphabetic'**: The text baseline is the normal alphabetic baseline.
- **'top'**: The text baseline is on the top of the text bounding box.
- **'hanging'**: The text baseline is a hanging baseline over the text.
- **'middle'**: The text baseline is in the middle of the text bounding box.
- **'ideographic'**: The text baseline is the ideographic baseline. If a character exceeds the alphabetic baseline, the ideographic baseline is located at the bottom of the excess character.
- **'bottom'**: The text baseline is at the bottom of the text bounding box. Its difference from the ideographic baseline is that the ideographic baseline does not consider letters in the next line. |
+| [font](#font) | string | 'normal normal 14px sans-serif' | Font style.
Syntax: ctx.font='font-size font-family'
- (Optional) **font-size**: font size and row height. The unit can only be px.
- (Optional) **font-family**: font family.
Syntax: ctx.font='font-style font-weight font-size font-family'
- (Optional) **font-style**: font style. Available values are **'normal'** and **'italic'**.
- (Optional) **font-weight**: font weight. Available values are as follows: **'normal'**, **'bold'**, **'bolder'**, **'lighter'**, **100**, **200**, **300**, **400**, **500**, **600**, **700**, **800**, **900**
- (Optional) **font-size**: font size and row height. The unit can only be px.
- (Optional) **font-family**: font family. Available values are **'sans-serif'**, **'serif'**, and **'monospace'**. |
+| [textAlign](#textalign) | string | 'left' | Text alignment mode. Available values are as follows:
- **'left'**: The text is left-aligned.
- **'right'**: The text is right-aligned.
- **'center'**: The text is center-aligned.
- **'start'**: The text is aligned with the start bound.
- **'end'**: The text is aligned with the end bound.
**NOTE**
In the **ltr** layout mode, the value **'start'** equals **'left'**. In the **rtl** layout mode, the value **'start'** equals **'right'**. |
+| [textBaseline](#textbaseline) | string | 'alphabetic' | Horizontal alignment mode of text. Available values are as follows:
- **'alphabetic'**: The text baseline is the normal alphabetic baseline.
- **'top'**: The text baseline is on the top of the text bounding box.
- **'hanging'**: The text baseline is a hanging baseline over the text.
- **'middle'**: The text baseline is in the middle of the text bounding box.
- **'ideographic'**: The text baseline is the ideographic baseline. If a character exceeds the alphabetic baseline, the ideographic baseline is located at the bottom of the excess character.
- **'bottom'**: The text baseline is at the bottom of the text bounding box. Its difference from the ideographic baseline is that the ideographic baseline does not consider letters in the next line. |
| [globalAlpha](#globalalpha) | number | - | Opacity. **0.0**: completely transparent; **1.0**: completely opaque. |
| [lineDashOffset](#linedashoffset) | number | 0.0 | Offset of the dashed line. The precision is float. |
| [globalCompositeOperation](#globalcompositeoperation) | string | 'source-over' | Composition operation type. Available values are as follows: **'source-over'**, **'source-atop'**, **'source-in'**, **'source-out'**, **'destination-over'**, **'destination-atop'**, **'destination-in'**, **'destination-out'**, **'lighter'**, **'copy'**, and **'xor'**. |
@@ -53,14 +53,14 @@ Configures the settings of a **CanvasRenderingContext2D** object, including whet
| [imageSmoothingEnabled](#imagesmoothingenabled) | boolean | true | Whether to adjust the image smoothness during image drawing. The value **true** means to enable this feature, and **false** means the opposite. |
| imageSmoothingQuality | string | 'low' | Image smoothness. The value can be **'low'**, **'medium'**, or **'high'**. |
->  **NOTE**
+> **NOTE**
> The value of the **<color>** type can be in 'rgb(255, 255, 255)', 'rgba(255, 255, 255, 1.0)', or '\#FFFFFF' format.
### fillStyle
-
-```
+```ts
+// xxx.ets
@Entry
@Component
struct FillStyleExample {
@@ -89,8 +89,8 @@ struct FillStyleExample {
### lineWidth
-
-```
+```ts
+// xxx.ets
@Entry
@Component
struct LineWidthExample {
@@ -119,8 +119,8 @@ struct LineWidthExample {
### strokeStyle
-
-```
+```ts
+// xxx.ets
@Entry
@Component
struct StrokeStyleExample {
@@ -151,8 +151,8 @@ struct StrokeStyleExample {
### lineCap
-
-```
+```ts
+// xxx.ets
@Entry
@Component
struct LineCapExample {
@@ -185,8 +185,8 @@ struct LineCapExample {
### lineJoin
-
-```
+```ts
+// xxx.ets
@Entry
@Component
struct LineJoinExample {
@@ -220,8 +220,8 @@ struct LineJoinExample {
### miterLimit
-
-```
+```ts
+// xxx.ets
@Entry
@Component
struct MiterLimit {
@@ -255,8 +255,8 @@ struct MiterLimit {
### font
-
-```
+```ts
+// xxx.ets
@Entry
@Component
struct Font {
@@ -285,8 +285,8 @@ struct Font {
### textAlign
-
-```
+```ts
+// xxx.ets
@Entry
@Component
struct CanvasExample {
@@ -330,8 +330,8 @@ struct CanvasExample {
### textBaseline
-
-```
+```ts
+// xxx.ets
@Entry
@Component
struct TextBaseline {
@@ -375,8 +375,8 @@ struct TextBaseline {
### globalAlpha
-
-```
+```ts
+// xxx.ets
@Entry
@Component
struct GlobalAlpha {
@@ -408,8 +408,8 @@ struct GlobalAlpha {
### lineDashOffset
-
-```
+```ts
+// xxx.ets
@Entry
@Component
struct LineDashOffset {
@@ -453,8 +453,8 @@ struct LineDashOffset {
| copy | Displays the new drawing and neglects the existing drawing. |
| xor | Combines the new drawing and existing drawing using the XOR operation. |
-
-```
+```ts
+// xxx.ets
@Entry
@Component
struct GlobalCompositeOperation {
@@ -491,8 +491,8 @@ struct GlobalCompositeOperation {
### shadowBlur
-
-```
+```ts
+// xxx.ets
@Entry
@Component
struct ShadowBlur {
@@ -523,8 +523,8 @@ struct ShadowBlur {
### shadowColor
-
-```
+```ts
+// xxx.ets
@Entry
@Component
struct ShadowColor {
@@ -555,8 +555,8 @@ struct ShadowColor {
### shadowOffsetX
-
-```
+```ts
+// xxx.ets
@Entry
@Component
struct ShadowOffsetX {
@@ -588,8 +588,8 @@ struct ShadowOffsetX {
### shadowOffsetY
-
-```
+```ts
+// xxx.ets
@Entry
@Component
struct ShadowOffsetY {
@@ -620,8 +620,8 @@ struct ShadowOffsetY {
### imageSmoothingEnabled
-
-```
+```ts
+// xxx.ets
@Entry
@Component
struct ImageSmoothingEnabled {
@@ -668,7 +668,8 @@ Fills a rectangle on the canvas.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct FillRect {
@@ -710,7 +711,8 @@ Draws an outlined rectangle on the canvas.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct StrokeRect {
@@ -751,7 +753,8 @@ Clears the content in a rectangle on the canvas.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct ClearRect {
@@ -793,7 +796,8 @@ Draws filled text on the canvas.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct FillText {
@@ -834,7 +838,8 @@ Draws a text stroke on the canvas.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct StrokeText {
@@ -883,7 +888,8 @@ Returns a **TextMetrics** object used to obtain the width of specified text.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct MeasureText {
@@ -923,7 +929,8 @@ Strokes a path.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct Stroke {
@@ -960,7 +967,8 @@ Creates a drawing path.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct BeginPath {
@@ -1005,7 +1013,8 @@ Moves a drawing path to a target position on the canvas.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct MoveTo {
@@ -1048,7 +1057,8 @@ Connects the current point to a target position using a straight line.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct LineTo {
@@ -1085,7 +1095,8 @@ Draws a closed path.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct ClosePath {
@@ -1130,7 +1141,8 @@ Creates a pattern for image filling based on a specified source image and repeti
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct CreatePattern {
@@ -1177,7 +1189,8 @@ Draws a cubic bezier curve on the canvas.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct BezierCurveTo {
@@ -1222,7 +1235,8 @@ Draws a quadratic curve on the canvas.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct QuadraticCurveTo {
@@ -1313,7 +1327,8 @@ Draws an arc based on the radius and points on the arc.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct ArcTo {
@@ -1362,7 +1377,8 @@ Draws an ellipse in the specified rectangular region.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct CanvasExample {
@@ -1406,7 +1422,8 @@ Creates a rectangle.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct CanvasExample {
@@ -1441,7 +1458,8 @@ Fills the area inside a closed path.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct Fill {
@@ -1476,7 +1494,8 @@ Sets the current path to a clipping path.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct Clip {
@@ -1519,7 +1538,8 @@ Rotates a canvas clockwise around its coordinate axes.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct Rotate {
@@ -1560,7 +1580,8 @@ Scales a canvas based on scale factors.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct Scale {
@@ -1594,7 +1615,7 @@ transform(scaleX: number, skewX: number, skewY: number, scaleY: number, translat
Defines a transformation matrix. To transform a graph, you only need to set parameters of the matrix. The coordinates of the graph are multiplied by the matrix values to obtain new coordinates of the transformed graph. You can use the matrix to implement multiple transform effects.
->  **NOTE**
+> **NOTE**
> The following formulas calculate coordinates of the transformed graph. **x** and **y** represent coordinates before transformation, and **x'** and **y'** represent coordinates after transformation.
>
> - x' = scaleX \* x + skewY \* y + translateX
@@ -1613,7 +1634,8 @@ Defines a transformation matrix. To transform a graph, you only need to set para
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct Transform {
@@ -1664,7 +1686,8 @@ Resets the existing transformation matrix and creates a new transformation matri
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct SetTransform {
@@ -1708,7 +1731,8 @@ Moves the origin of the coordinate system.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct Translate {
@@ -1738,18 +1762,18 @@ Moves the origin of the coordinate system.
### drawImage
-drawImage(image: ImageBitmap, dx: number, dy: number): void
+drawImage(image: ImageBitmap | PixelMap, dx: number, dy: number): void
-drawImage(image: ImageBitmap, dx: number, dy: number, dWidth: number, dHeight: number): void
+drawImage(image: ImageBitmap | PixelMap, dx: number, dy: number, dWidth: number, dHeight: number): void
-drawImage(image: ImageBitmap, sx: number, sy: number, sWidth: number, sHeight: number, dx: number, dy: number, dWidth: number, dHeight: number):void
+drawImage(image: ImageBitmap | PixelMap, sx: number, sy: number, sWidth: number, sHeight: number, dx: number, dy: number, dWidth: number, dHeight: number):void
Draws an image.
- Parameters
| Name | Type | Mandatory | Default Value | Description |
| ------- | ---------------------------------------- | --------- | ------------- | ---------------------------------------- |
- | image | [ImageBitmap](ts-components-canvas-imagebitmap.md) | Yes | null | Image resource. For details, see ImageBitmap |
+ | image | [ImageBitmap](ts-components-canvas-imagebitmap.md) or [PixelMap](../apis/js-apis-image.md#pixelmap7) | Yes | null | Image resource. For details, see ImageBitmap or PixelMap. |
| sx | number | No | 0 | X-coordinate of the upper left corner of the rectangle used to crop the source image. |
| sy | number | No | 0 | Y-coordinate of the upper left corner of the rectangle used to crop the source image. |
| sWidth | number | No | 0 | Target width to crop the source image. |
@@ -1762,7 +1786,8 @@ Draws an image.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct ImageExample {
@@ -1812,12 +1837,24 @@ Creates an **ImageData** object. For details, see [ImageData](ts-components-canv
| --------- | ------ | --------- | ------------- | ---------------------------------------- |
| imagedata | Object | Yes | null | **ImageData** object with the same width and height copied from the original **ImageData** object. |
+### getPixelMap
+
+getPixelMap(sx: number, sy: number, sw: number, sh: number): PixelMap
+
+Obtains the **[PixelMap](../apis/js-apis-image.md#pixelmap7)** object created with the pixels within the specified area on the canvas.
+- Parameters
+ | Name | Type | Mandatory | Default Value | Description |
+ | ---- | ------ | ---- | ---- | --------------- |
+ | sx | number | Yes | 0 | X-coordinate of the upper left corner of the output area.|
+ | sy | number | Yes | 0 | Y-coordinate of the upper left corner of the output area.|
+ | sw | number | Yes | 0 | Width of the output area. |
+ | sh | number | Yes | 0 | Height of the output area. |
### getImageData
getImageData(sx: number, sy: number, sw: number, sh: number): Object
- Creates an [ImageData](ts-components-canvas-imagebitmap.md) object with pixels in the specified area on the canvas.
+Creates an **[ImageData](ts-components-canvas-imagebitmap.md)** object with pixels in the specified area on the canvas.
- Parameters
| Name | Type | Mandatory | Default Value | Description |
| ---- | ------ | --------- | ------------- | ---------------------------------------- |
@@ -1831,7 +1868,7 @@ getImageData(sx: number, sy: number, sw: number, sh: number): Object
putImageData(imageData: Object, dx: number, dy: number, dirtyX?: number, dirtyY?: number, dirtyWidth?: number, dirtyHeight?: number): void
-Puts the [ImageData](ts-components-canvas-imagebitmap.md) onto a rectangular area on the canvas.
+Puts the **[ImageData](ts-components-canvas-imagebitmap.md)** onto a rectangular area on the canvas.
- Parameters
| Name | Type | Mandatory | Default Value | Description |
@@ -1846,7 +1883,8 @@ Puts the [ImageData](ts-components-canvas-imagebitmap.md) onto a rectangular are
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct PutImageData {
@@ -1887,7 +1925,8 @@ Restores the saved drawing context.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct CanvasExample {
@@ -1919,7 +1958,8 @@ Saves the current drawing context.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct CanvasExample {
@@ -1959,7 +1999,8 @@ Creates a linear gradient.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct CreateLinearGradient {
@@ -2008,7 +2049,8 @@ Creates a linear gradient.
- Example
- ```
+ ```ts
+ // xxx.ets
@Entry
@Component
struct CreateRadialGradient {
diff --git a/en/application-dev/reference/arkui-ts/ts-universal-attributes-image-effect.md b/en/application-dev/reference/arkui-ts/ts-universal-attributes-image-effect.md
index e7b2846ba9c5d98806745dcfc25a8c3234ce43bc..5efa02368bf4eb70bca06a7e6a71473853692571 100644
--- a/en/application-dev/reference/arkui-ts/ts-universal-attributes-image-effect.md
+++ b/en/application-dev/reference/arkui-ts/ts-universal-attributes-image-effect.md
@@ -1,7 +1,7 @@
# Image Effect Configuration
->  **NOTE**
+> **NOTE**
> This attribute is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
@@ -25,7 +25,7 @@ None
| invert | number | 0 | Inverts the input image. The input parameter is an image inversion ratio. The value **1** indicates complete inversion. The value **0** indicates that the image does not change. The unit is percentage. |
| colorBlend 8+ | Color | - | Adds the color blend effect to the current component. The input parameter is the blended color. |
| sepia | number | 0 | Converts the image color to sepia. The input parameter is an image inversion ratio. The value **1** indicates the image is completely sepia. The value **0** indicates that the image does not change. The unit is percentage. |
-| hueRotate | Angle | 0deg | Adds the hue rotation effect to the current component. The input parameter is a rotation angle. If the input value is **0deg**, the image does not change (because the default rotation angle is **0deg**). The input parameter does not have the maximum value. If the value exceeds **360deg**, the image is rotated one ore more circles. |
+| hueRotate | number \| string | '0deg' |Adds the hue rotation effect to the current component. The input parameter is a rotation angle. If the input value is **0deg**, the image does not change (because the default rotation angle is **0deg**). The input parameter does not have the maximum value. If the value exceeds **360deg**, the image is rotated for one more circle. In other words, the value **370deg** has the same effect as **10deg**.|
## Example
diff --git a/en/device-dev/quick-start/Readme-EN.md b/en/device-dev/quick-start/Readme-EN.md
index 2afa83a8d1a6e0ea5e79f97018044f86e1be3a1f..4078afd7efd1c4c7a25760fcd7fa1f4c3437402e 100644
--- a/en/device-dev/quick-start/Readme-EN.md
+++ b/en/device-dev/quick-start/Readme-EN.md
@@ -28,7 +28,7 @@
- Running a Hello World Program
- Hi3861 Development Board
- [Setting Up the Hi3861 Development Board Environment](quickstart-lite-steps-hi3861-setting.md)
- - [Writing a Hello World Program](quickstart-lite-steps-hi3861-application-framework.md)
+ - [Writing a Hello World Program](quickstart-lite-steps-hi3861-helloworld.md)
- [Building](quickstart-lite-steps-hi3861-building.md)
- [Burning](quickstart-lite-steps-hi3861-burn.md)
- [Networking](quickstart-lite-steps-hi3861-netconfig.md)
@@ -36,7 +36,7 @@
- [Running](quickstart-lite-steps-hi3861-running.md)
- Hi3516 Development Board
- [Setting Up the Hi3516 Development Board Environment](quickstart-lite-steps-hi3516-setting.md)
- - [Writing a Hello World Program](quickstart-lite-steps-hi3516-application-framework.md)
+ - [Writing a Hello World Program](quickstart-lite-steps-hi3516-helloworld.md)
- [Building](quickstart-lite-steps-hi3516-building.md)
- [Burning](quickstart-lite-steps-hi3516-burn.md)
- [Running](quickstart-lite-steps-hi3516-running.md)
@@ -75,7 +75,7 @@
- [Setting Up Environments for Standard System](quickstart-standard-env-setup.md)
- Running a Hello World Program
- Hi3516 Development Board
- - [Writing a Hello World Program](quickstart-standard-running-hi3516-create.md)
+ - [Writing a Hello World Program](quickstart-std-3516-create.md)
- [Building](quickstart-standard-running-hi3516-build.md)
- [Burning](quickstart-standard-running-hi3516-burning.md)
- [Running](quickstart-standard-running-hi3516-running.md)
diff --git a/en/device-dev/quick-start/figures/en-us_image_0000001266887264.png b/en/device-dev/quick-start/figures/en-us_image_0000001266887264.png
new file mode 100644
index 0000000000000000000000000000000000000000..f931e2cfba06791a3891248c5d8e6a9f0e86bf0e
Binary files /dev/null and b/en/device-dev/quick-start/figures/en-us_image_0000001266887264.png differ
diff --git a/en/device-dev/quick-start/figures/en-us_image_0000001271354693.png b/en/device-dev/quick-start/figures/en-us_image_0000001271354693.png
index 02f74a108d5223682d57dc2e18aaefc3d31e6518..3e4d31eb90fc63376f511d0fb5320a69ee7af150 100644
Binary files a/en/device-dev/quick-start/figures/en-us_image_0000001271354693.png and b/en/device-dev/quick-start/figures/en-us_image_0000001271354693.png differ
diff --git a/en/device-dev/quick-start/figures/en-us_image_0000001307019009.png b/en/device-dev/quick-start/figures/en-us_image_0000001307019009.png
new file mode 100644
index 0000000000000000000000000000000000000000..cee1d83517ee1fced5373f51cefb12e91346e947
Binary files /dev/null and b/en/device-dev/quick-start/figures/en-us_image_0000001307019009.png differ
diff --git a/en/device-dev/quick-start/figures/en-us_image_0000001312778829.png b/en/device-dev/quick-start/figures/en-us_image_0000001312778829.png
new file mode 100644
index 0000000000000000000000000000000000000000..15791ccc963502062bd54537567db8876d9d7b63
Binary files /dev/null and b/en/device-dev/quick-start/figures/en-us_image_0000001312778829.png differ
diff --git a/en/device-dev/quick-start/figures/en-us_image_0000001312780249.png b/en/device-dev/quick-start/figures/en-us_image_0000001312780249.png
new file mode 100644
index 0000000000000000000000000000000000000000..33827bef0cfc3dd949fd165883b05b7ca47dafb7
Binary files /dev/null and b/en/device-dev/quick-start/figures/en-us_image_0000001312780249.png differ
diff --git a/en/device-dev/quick-start/figures/en-us_image_0000001312898911.png b/en/device-dev/quick-start/figures/en-us_image_0000001312898911.png
new file mode 100644
index 0000000000000000000000000000000000000000..b048f3fda0aa3d64edffdd26948ef732bad31b17
Binary files /dev/null and b/en/device-dev/quick-start/figures/en-us_image_0000001312898911.png differ
diff --git a/en/device-dev/quick-start/figures/en-us_image_0000001312912501.png b/en/device-dev/quick-start/figures/en-us_image_0000001312912501.png
new file mode 100644
index 0000000000000000000000000000000000000000..550b0aed6cef3be1fed799052e78442335f92562
Binary files /dev/null and b/en/device-dev/quick-start/figures/en-us_image_0000001312912501.png differ
diff --git a/en/device-dev/quick-start/figures/en-us_image_000000131299335.png b/en/device-dev/quick-start/figures/en-us_image_000000131299335.png
new file mode 100644
index 0000000000000000000000000000000000000000..8cc4a4837e321d0d13f8fa456194931874a4477a
Binary files /dev/null and b/en/device-dev/quick-start/figures/en-us_image_000000131299335.png differ
diff --git a/en/device-dev/quick-start/quickstart-docker-lite.md b/en/device-dev/quick-start/quickstart-docker-lite.md
deleted file mode 100644
index 666b1510ff7b2346251cea45601e990ff5100d3e..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-docker-lite.md
+++ /dev/null
@@ -1,13 +0,0 @@
-# Getting Started with Mini and Small Systems (Installation Package Mode)
-
-
-
-- **[Mini and Small System Overview](quickstart-lite-overview.md)**
-
-- **[Setting Up Environments for the Mini and Small Systems](quickstart-lite-env-setup.md)**
-
-- **[Running a Hello World Program](quickstart-lite-steps.md)**
-
-- **[FAQs](quickstart-lite-env-setup-faqs.md)**
-
-- **[Appendix](quickstart-lite-appendix.md)**
diff --git a/en/device-dev/quick-start/quickstart-ide-lite-appendix.md b/en/device-dev/quick-start/quickstart-ide-lite-appendix.md
deleted file mode 100644
index 0f1cbeb874d3e95c5e15881892b3c09bd1e9facc..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-ide-lite-appendix.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Appendix
-
-
-
-- **[Introduction to Development Boards](quickstart-ide-lite-board-introduction.md)**
diff --git a/en/device-dev/quick-start/quickstart-ide-lite-board-introduction.md b/en/device-dev/quick-start/quickstart-ide-lite-board-introduction.md
deleted file mode 100644
index 9ebaa5683f1a0102675883058586145478e04f1e..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-ide-lite-board-introduction.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Introduction to Development Boards
-
-
-
-- **[Introduction to the Hi3861 Development Board](quickstart-ide-lite-introduction-hi3861.md)**
-
-- **[Introduction to the Hi3516 Development Board](quickstart-ide-lite-introduction-hi3516.md)**
diff --git a/en/device-dev/quick-start/quickstart-ide-lite-create-project.md b/en/device-dev/quick-start/quickstart-ide-lite-create-project.md
index 37002b081cb5f699498cd8114ad89ee3a32ecece..48c917609e0edf4c194aa7e3d13c3c2d02c7ef19 100644
--- a/en/device-dev/quick-start/quickstart-ide-lite-create-project.md
+++ b/en/device-dev/quick-start/quickstart-ide-lite-create-project.md
@@ -1,4 +1,4 @@
-# Creating a Source Code Project
+# Importing a Source Code Project
After [setting up the Windows+Ubuntu hybrid development environment](../quick-start/quickstart-ide-lite-env-setup-win-ubuntu.md) and [obtaining source code](../quick-start/quickstart-ide-lite-sourcecode-acquire.md), perform the following steps to create a source code project in Windows:
@@ -15,7 +15,7 @@ After [setting up the Windows+Ubuntu hybrid development environment](../quick-st
-3. If you select to open the OpenHarmony source code, a message will be displayed indicating that the project is not a DevEco Device Tool project. Click **Import** to continue.
+3. If this is the first time you import a project, a message will be displayed indicating that the project is not a DevEco Device Tool project. Click **Import** to continue.
diff --git a/en/device-dev/quick-start/quickstart-ide-lite-env-setup-win-ubuntu.md b/en/device-dev/quick-start/quickstart-ide-lite-env-setup-win-ubuntu.md
index f274a5f0ee452334be8fa93eac3844c62c79e73c..1a9929dbdb0820f71c9ab5b0bc02808896319b44 100644
--- a/en/device-dev/quick-start/quickstart-ide-lite-env-setup-win-ubuntu.md
+++ b/en/device-dev/quick-start/quickstart-ide-lite-env-setup-win-ubuntu.md
@@ -11,15 +11,18 @@ In the Windows+Ubuntu hybrid development environment, you can enjoy the benefits
- Windows: Windows 10 (64-bit)
-- Ubuntu: Ubuntu 20.04 or later; recommended memory: 16 GB or higher.
+- Ubuntu: Ubuntu 20.04 or later; recommended memory: 16 GB or higher
-- User name: cannot contain Chinese characters
+- User name (Ubuntu): cannot contain Chinese characters
- DevEco Device Tool: 3.0 Release
## Setting Up the Ubuntu Development Environment
+>  **NOTE**
+> If the Ubuntu system has not been set up yet, set it up on a virtual machine running Windows. Then, configure the Ubuntu basic environment.
+
1. Make sure the Ubuntu shell environment is **bash**.
1. Run the following command and check whether the command output is **bash**. If the command output is not **bash**, go to step 2.
@@ -55,14 +58,15 @@ In the Windows+Ubuntu hybrid development environment, you can enjoy the benefits
4. Run the following command to install DevEco Device Tool, where **devicetool-linux-tool-3.0.0.401.sh** indicates the installation file name.
- >  **NOTE**
- > During the installation, the setup wizard automatically checks whether Python 3.8 or 3.9 is installed. If Python 3.8 or 3.9 is not installed, the setup wizard displays the "Do you want to continue?" message; enter **Y** to allow the setup wizard to automatically install Python.
-
-
```
sudo ./devicetool-linux-tool-3.0.0.401.sh
```
-
+ >  **NOTE**
+ > During the installation, the setup wizard automatically checks whether Python 3.8 or 3.9 is installed. If Python 3.8 or 3.9 is not installed, the setup wizard displays the "Do you want to continue?" message; enter **Y** to allow the setup wizard to automatically install Python.
+ >
+ > During the installation, the page for agreeing to the user agreement and privacy statement is displayed. Read and agree to the user agreement and privacy statement.
+ >
+ > If this page is not displayed and the installation exits, run the apt-get install whiptail command, then the installation command.
Wait until the "Deveco Device Tool successfully installed." message is displayed.
@@ -76,7 +80,7 @@ To remotely access the Ubuntu environment through Windows and enjoy the benefits
2. Decompress the DevEco Device Tool package, double-click the installer, and then click **Next**.
-3. Set the installation path of DevEco Device Tool and click **Next**. You are advised to install DevEco Device Tool in a non-system drive.
+3. Set the installation path of DevEco Device Tool to a path that does not contain any Chinese characters, and then click **Next**. You are advised to install DevEco Device Tool in a non-system drive.
>  **NOTE**
> If you have installed DevEco Device Tool 3.0 Beta2 or earlier, the earlier version will be uninstalled before you install a new version. If the following error message is displayed during the uninstallation, click **Ignore** to continue the installation. This error does not affect the installation of the new version.
@@ -101,11 +105,14 @@ To remotely access the Ubuntu environment through Windows and enjoy the benefits
-5. In the dialog box shown below, click **Next** to download and install the tools..
+5. In the dialog box shown below, click **Next**.
-6. Wait for the DevEco Device Tool setup wizard to automatically install DevEco Device Tool. After the installation is complete, click **Finish** to close the setup wizard.
+6. Read the user agreement and privacy statement carefully, select I accept the licenses, and click **Next**.
+
+ 
+7. Wait for the DevEco Device Tool setup wizard to automatically install DevEco Device Tool. After the installation is complete, click **Finish** to close the setup wizard.
@@ -174,29 +181,9 @@ To remotely access the Ubuntu environment through Windows and enjoy the benefits
5. In the displayed dialog box, select **Linux**, select **Continue**, and enter the password for logging in to the remote computer.
+ >  **NOTE**
+ > To eliminate the need for frequently entering the password for logging in to the remote computer, set an SSH public key.
After the connection is successful, the plug-in is automatically installed in the .vscode-server folder on the remote computer. After the installation is complete, reload Visual Studio Code in Windows as prompted. Then you can develop, compile, and burn source code in DevEco Device Tool on Windows.
-
-
-### Registering the Public Key for Accessing the Ubuntu Environment
-
-After the preceding operations are complete, you can remotely connect to the Ubuntu environment through Windows for development. However, you need to frequently enter the remote connection password. To eliminate this need, you can use the SSH public key.
-
-1. Open the Git bash CLI and run the following command to generate an SSH public key. During command execution, perform operations as prompted. Set **username** and **ip** to the user name and IP address you use for connecting to the Ubuntu system.
-
- ```
- ssh-keygen -t rsa
- ssh-copy-id -i ~/.ssh/id_rsa.pub username@ip
- ```
-
- 
-
-2. In Visual Studio Code, click the remote connection setting button and open the **config** file.
-
- 
-
-3. In the **config** file, add the SSK key file information, as shown below. Then save the file.
-
- 
diff --git a/en/device-dev/quick-start/quickstart-ide-lite-env-setup.md b/en/device-dev/quick-start/quickstart-ide-lite-env-setup.md
deleted file mode 100644
index e7461bde3df8da9ca14f7c3cbac5c36d1a37b6c5..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-ide-lite-env-setup.md
+++ /dev/null
@@ -1,8 +0,0 @@
-# Environment Preparation
-
-
-
-- **[Setting Up the Windows+Ubuntu Hybrid Development Environment](quickstart-ide-lite-env-setup-win-ubuntu.md)**
-
-- **[Obtaining Source Code](quickstart-ide-lite-sourcecode-acquire.md)**
-
diff --git a/en/device-dev/quick-start/quickstart-ide-lite-introduction-hi3861.md b/en/device-dev/quick-start/quickstart-ide-lite-introduction-hi3861.md
index b32ea6e794af6c80dcd9059d70cbe8816906f1a7..7c7152e314a778176e2f51aaddaf3b87ac7eed44 100644
--- a/en/device-dev/quick-start/quickstart-ide-lite-introduction-hi3861.md
+++ b/en/device-dev/quick-start/quickstart-ide-lite-introduction-hi3861.md
@@ -7,7 +7,7 @@ Hi3861 is a 2 x 5 cm development board. It is a 2.4 GHz WLAN SoC chip that highl
**Figure 1** Hi3861 development board
- 
+
The Hi3861 development board can also be connected to the Hi3861 mother board to expand its peripheral capabilities. The following figure shows the Hi3861 mother board.
diff --git a/en/device-dev/quick-start/quickstart-ide-lite-overview.md b/en/device-dev/quick-start/quickstart-ide-lite-overview.md
index f23028f755bd48bb7c7f6ce8f1c05370551565ab..2b3ee5c0f0257ec2c4a3d29c41a922a62114923a 100644
--- a/en/device-dev/quick-start/quickstart-ide-lite-overview.md
+++ b/en/device-dev/quick-start/quickstart-ide-lite-overview.md
@@ -10,7 +10,7 @@ To accommodate different developer habits, OpenHarmony provides two modes for ge
- IDE mode: DevEco Device Tool is used for one-stop development, covering dependency installation, building, burning, and running.
- Installation package mode: Dependency download and installation as well as building operations are performed using commands. Burning and running are performed in DevEco Device Tool.
- OpenHarmony also provides the [Docker environment](../get-code/gettools-acquire.md), which can significantly simplify the environment configuration before compilation. You can build your source code in the Docker environment if you are more accustomed to using the installation package mode.
+ OpenHarmony also provides the [Docker environment](https://gitee.com/openharmony/docs/blob/master/en/device-dev/get-code/gettools-acquire.md), which can significantly simplify the environment configuration before compilation. You can build your source code in the Docker environment if you are more accustomed to using the installation package mode.
This document exemplifies how to use the IDE mode. For details about the installation package mode, see [Getting Started with Mini and Small Systems (Installation Package Mode)](../quick-start/quickstart-lite-overview.md).
diff --git a/en/device-dev/quick-start/quickstart-ide-lite-sourcecode-acquire.md b/en/device-dev/quick-start/quickstart-ide-lite-sourcecode-acquire.md
index f3fa19d7af0f3a2bec21a1dcf1116d5b005c4982..585abbbd7a71e674fe1b9f545b459d59db7d172b 100644
--- a/en/device-dev/quick-start/quickstart-ide-lite-sourcecode-acquire.md
+++ b/en/device-dev/quick-start/quickstart-ide-lite-sourcecode-acquire.md
@@ -10,7 +10,7 @@ In the Ubuntu environment, perform the following steps to obtain the OpenHarmony
2. Register an SSH public key for access to Gitee.
-3. Install the git client and git-lfs.
+3. Install the git client and git-lfs if they are unavailable.
Update the software source:
@@ -18,14 +18,14 @@ In the Ubuntu environment, perform the following steps to obtain the OpenHarmony
sudo apt-get update
```
- Run the following command to install the tools:
-
+ Run the following command to install the tools:
+
```
sudo apt-get install git git-lfs
```
4. Configure user information.
-
+
```
git config --global user.name "yourname"
git config --global user.email "your-email-address"
@@ -33,7 +33,7 @@ In the Ubuntu environment, perform the following steps to obtain the OpenHarmony
```
5. Run the following commands to install the **repo** tool:
-
+
```
curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 -o /usr/local/bin/repo # If you do not have the access permission to this directory, download the tool to any other accessible directory and configure the directory to the environment variable.
chmod a+x /usr/local/bin/repo
@@ -58,7 +58,7 @@ In the Ubuntu environment, perform the following steps to obtain the OpenHarmony
Method 2: Use the **repo** tool to download the source code over HTTPS.
-
+
```
repo init -u https://gitee.com/openharmony/manifest.git -b master --no-repo-verify
repo sync -c
@@ -70,10 +70,10 @@ In the Ubuntu environment, perform the following steps to obtain the OpenHarmony
For details about how to obtain the source code of an OpenHarmony release, see the [Release-Notes](../../release-notes/Readme.md).
-## Running prebuilts
+### Running prebuilts
+
+Go to the root directory of the source code and run the following script to install the compiler and binary tool:
- Go to the root directory of the source code and run the following script to install the compiler and binary tool:
-
```
bash build/prebuilts_download.sh
```
diff --git a/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3516-burn.md b/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3516-burn.md
index 36a19432f9e567609a7c7a3b92d006d71a91ef2b..3368ed019c26a482af6ae90de4602c23a59a9a45 100644
--- a/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3516-burn.md
+++ b/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3516-burn.md
@@ -1,70 +1,68 @@
# Burning
+Burning is the process of downloading compiled program files to a development board to provide a basis for subsequent debugging. With the one-click burning function of DevEco Device Tool, you can burn images on development boards quickly and efficiently.
+
+
Hi3516D V300 supports burning through the USB port, network port, and serial port. This document describes how to burn source code through the USB port. The operations are performed in Windows.
1. Connect the computer and the target development board through the serial port and USB port. For details, see [Introduction to the Hi3516D V300 Development Board](https://gitee.com/openharmony/docs/blob/master/en/device-dev/quick-start/quickstart-lite-introduction-hi3516.md).
+ >  **NOTE**
+ > If you are using the remote access mode (Windows + Ubuntu on the local VM), disable the USB control of the VM as follows to ensure that the development board is connected to the USB port of the host:
+ >
+ > - VMware: Configure the device to connect to the host under **Preferences** > **USB** and remove the USB controller from the VM settings.
+ >
+ > - VirtualBox: Deselect **Enable USB Controller** in the USB device options under Ubuntu settings.
-2. In DevEco Device Tool, choose **REMOTE DEVELOPMENT** > **Local PC** to check the connection status between the remote computer (Ubuntu development environment) and the local computer (Windows development environment).
+2. If your computer does not have the USB port driver or USB-to-serial driver, install it by following the instructions in [Installing the USB Port Driver on the Hi3516D V300 or Hi3518E V300 Development Board](Installing the USB Port Driver on the Hi3516D V300 or Hi3518E V300 Development Board) or [Installing the Serial Port Driver on the Hi3516D V300 or Hi3518E V300 Development Board](https://device.harmonyos.com/en/docs/documentation/guide/hi3516_hi3518-drivers-0000001050743695), depending on the missing driver.
+3. In DevEco Device Tool, choose **REMOTE DEVELOPMENT** > **Local PC** to check the connection status between the remote computer (Ubuntu build environment) and the local computer (Windows build environment).
- If  is displayed on the right of **Local PC**, the remote computer is connected to the local computer. In this case, no further action is required.
- If  is displayed, click the connect icon.
- >  **NOTE**
- > This operation is required only in remote access mode (in the Windows+Ubuntu hybrid development environment). If the local access mode (Windows or Ubuntu development environment) is used, skip this step.
+ >  **NOTE**
+ > This operation is required only in remote access mode (in the Windows+Ubuntu hybrid build environment). If the local access mode (Windows or Ubuntu build environment) is used, skip this step.
-3. Check the serial port number in **QUICK ACCESS** > **DevEco Home** > **Device** in DevEco Device Tool.
+4. Check the serial port number in **QUICK ACCESS** > **DevEco Home** > **Device** in DevEco Device Tool.
- >  **NOTE**
- > If the serial port number is not displayed correctly, follow the steps described in [Installing the Serial Port Driver on the Hi3516 or Hi3518 Series Development Boards](https://device.harmonyos.com/en/docs/documentation/guide/hi3516_hi3518-drivers-0000001050743695).
-
-4. Choose **QUICK ACCESS** > **DevEco Home** > **Projects**, and then click **Settings**.
+5. Choose **QUICK ACCESS** > **DevEco Home** > **Projects**, and then click **Settings**.
-5. On the **hi3516dv300** tab page, set the burning options.
-
+6. On the **hi3516dv300** tab page, set the burning options.
- **upload_partitions**: Select the file to be burnt. By default, the **fastboot**, **kernel**, **rootfs**, and **userfs** files are burnt at the same time.
- **upload_port**: Select the serial port number obtained.
- **upload_protocol**: Select the burning protocol **hiburn-usb**.
-6. Check the preset information of the files to be burnt and modify them when necessary. The files to be burnt include **fastboot**, **kernel**, **rootfs**, and **userfs**.
-
- 1. On the **hi3516dv300_fastboot** tab, select the items to be modified in **New Option**, such as **partition_bin**, **partition_addr**, and **partition_length**.
-
- 
-
- 2. In **Partition Options**, modify the items selected in the preceding step.
-
- >  **NOTE**
- > Set the start address and length of the partition based on the size of the files to be burnt. Make sure the size of the partition is greater than that of the files to be burnt and the partition addresses of the files to be burnt do not overlap.
+7. In **Partitions**, check the preset burning settings of the files to be burnt.
- 
+ 
- 3. Follow the same procedure to modify the information about the **kernel**, **rootfs**, and **userfs** files.
+ To modify the burning settings for a specific file, click  next to the file.
+ >  **NOTE**
+ > Set the start address and length of the partition based on the size of the files to be burnt. Make sure the size of the partition is greater than that of the files to be burnt and the partition addresses of the files to be burnt do not overlap.
-7. When you finish modifying, click **Save** on the top.
+ 
-8. Go to **hi3516dv300** > **Upload** to start burning.
+8. When you finish modifying, click **Save** on the top.
- >  **NOTE**
- > If this is the first time you burn source code to the Hi3516D V300 or Hi3518E V300 board, the message "not find the Devices" may be displayed. In this case, follow the steps in [Installing the USB Port Driver on the Hi3516D V300 or Hi3518E V300 Development Board](https://device.harmonyos.com/en/docs/documentation/guide/usb_driver-0000001058690393) and start burning again.
+9. Go to **hi3516dv300** > **Upload** to transfer the files to be burnt from Ubuntu to Windows. When the "Operation paused, Please press Enter key to continue" message is displayed, which indicates that the transfer is complete, press **Enter** to start burning.
- 
+ 
-9. When the following information is displayed in the Terminal window, press and hold the reset button, remove and insert the USB cable, and release the reset button to start burning.
+10. When the following information is displayed in the **TERMINAL** window, press and hold the reset button within 15 seconds, remove and insert the USB cable, and release the reset button to start burning.
- 
+ 
- If the following message is displayed, it indicates that the burning is successful.
+ If the following message is displayed, it indicates that the burning is successful.
- 
+ 
-10. When the burning is successful, perform the operations in Running an Image to start the system.
+11. When the burning is successful, perform the operations in Running to start the system.
diff --git a/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3516-application-framework.md b/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3516-helloworld.md
similarity index 100%
rename from en/device-dev/quick-start/quickstart-ide-lite-steps-hi3516-application-framework.md
rename to en/device-dev/quick-start/quickstart-ide-lite-steps-hi3516-helloworld.md
diff --git a/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3516-running.md b/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3516-running.md
index a12915d4e335fc2f520812f8ea988a126128ed4d..1aeccedcc5bdef184f7b27cb2f95940cd6699e18 100644
--- a/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3516-running.md
+++ b/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3516-running.md
@@ -30,13 +30,13 @@ After burning is completed, you need to configure the bootloader to run the Open
After the system is started, perform the following steps to run the Hello World program:
1. Go to the **bin** directory on the startup page.
-
+
```
cd bin
```
2. Run the following command to run the **helloworld** program:
-
+
```
./helloworld
```
@@ -48,4 +48,4 @@ After the system is started, perform the following steps to run the Hello World
## Next
-Congratulations! You have finished all steps! Proceed to [develop a sample camera with a screen](https://gitee.com/openharmony/docs/blob/master/en/device-dev/guide/device-camera.md) to better familiarize yourself with OpenHarmony development.
+Congratulations! You have finished all steps! Proceed to [develop a sample camera with a screen](../guide/device-camera-control-overview.md) to better familiarize yourself with OpenHarmony development.
diff --git a/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3516.md b/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3516.md
deleted file mode 100644
index 30a1760dc180b69e062eb15d51e825422c246b46..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3516.md
+++ /dev/null
@@ -1,11 +0,0 @@
-# Hi3516 Development Board
-
-
-
-- **[Writing a Hello World Program](quickstart-ide-lite-steps-hi3516-application-framework.md)**
-
-- **[Building](quickstart-ide-lite-steps-hi3516-building.md)**
-
-- **[Burning](quickstart-ide-lite-steps-hi3516-burn.md)**
-
-- **[Running](quickstart-ide-lite-steps-hi3516-running.md)**
diff --git a/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3861-burn.md b/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3861-burn.md
index 72a07f63239b0a79da9958a8b1dc77fe964e51ab..aa19ccf3d77feb92aa41c127887d9a66ecadacc6 100644
--- a/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3861-burn.md
+++ b/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3861-burn.md
@@ -1,12 +1,15 @@
# Burning
+Burning is the process of downloading compiled program files to a development board to provide a basis for subsequent debugging. With the one-click burning function of DevEco Device Tool, you can burn images on development boards quickly and efficiently.
Hi3861 V100 supports burning through the serial port. To burn source code through the serial port in Windows, perform the following steps:
1. Connect the computer and the target development board through the serial port and USB port. For details, see [Introduction to the Hi3861 V100 Development Board](https://gitee.com/openharmony/docs/blob/master/en/device-dev/quick-start/quickstart-lite-introduction-hi3861.md).
-2. In DevEco Device Tool, choose **REMOTE DEVELOPMENT** > **Local PC** to check the connection status between the remote computer (Ubuntu development environment) and the local computer (Windows development environment).
+2. If your computer does not have the USB-to-serial driver, install it by following the instructions in [Installing the Serial Port Driver on Hi3861 V100](https://device.harmonyos.com/en/docs/documentation/guide/hi3861-drivers-0000001058153433).
+
+3. In DevEco Device Tool, choose **REMOTE DEVELOPMENT** > **Local PC** to check the connection status between the remote computer (Ubuntu development environment) and the local computer (Windows development environment).
- If  is displayed on the right of **Local PC**, the remote computer is connected to the local computer. In this case, no further action is required.
- If  is displayed, click the connect icon.
@@ -16,18 +19,17 @@ Hi3861 V100 supports burning through the serial port. To burn source code throug
>  **NOTE**
> This operation is required only in remote access mode (in the Windows+Ubuntu hybrid development environment). If the local access mode (Windows or Ubuntu development environment) is used, skip this step.
-3. Check the serial port number in **QUICK ACCESS** > **DevEco Home** > **Device** in DevEco Device Tool.
+4. Check the serial port number in **QUICK ACCESS** > **DevEco Home** > **Device** in DevEco Device Tool.
- >  **NOTE**
- > If the serial port number is not displayed correctly, follow the steps described in [Installing the Serial Port Driver on Hi3861 V100](https://device.harmonyos.com/en/docs/documentation/guide/hi3861-drivers-0000001058153433).
+
-4. Choose **QUICK ACCESS** > **DevEco Home** > **Projects**, and then click **Settings**.
+5. Choose **QUICK ACCESS** > **DevEco Home** > **Projects**, and then click **Settings**.
-5. On the **hi3861** tab page, set the burning options.
+6. On the **hi3861** tab page, set the burning options.
- **upload_port**: Select the serial port number obtained.
- **upload_protocol**: Select the burning protocol **hiburn-serial**.
@@ -35,22 +37,24 @@ Hi3861 V100 supports burning through the serial port. To burn source code throug
-6. Check the preset information of the files to be burnt and modify them when necessary.
+7. In **Partitions**, check the preset burning settings of the files to be burnt.
+
+ 
- On the **hi3861_app** tab page, select **partition_bin** from **New Option**, and set the path of the file to be burnt.
+ To modify the burning settings for a specific file, click  next to the file.
- 
+ 
-7. When you finish modifying, click **Save** on the top.
+8. When you finish modifying, click **Save** on the top.
-8. Click **Open** to open the project file. Then, choose **PROJECT TASKS** > **hi3861** > **Upload** to start burning.
+9. Click **Open** to open the project file. Then, choose **PROJECT TASKS** > **hi3861** > **Upload** to start burning.
-9. When the following information is displayed, press the RST button on the development board to restart it.
+10. When the following information is displayed, press the RST button on the development board within 15 seconds to restart it.
-10. Wait until the burning is complete. When the following message is displayed, the burning is successful.
+ When the following message is displayed, the burning is successful.
- 
\ No newline at end of file
+ 
\ No newline at end of file
diff --git a/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3861-application-framework.md b/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3861-helloworld.md
similarity index 100%
rename from en/device-dev/quick-start/quickstart-ide-lite-steps-hi3861-application-framework.md
rename to en/device-dev/quick-start/quickstart-ide-lite-steps-hi3861-helloworld.md
diff --git a/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3861.md b/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3861.md
deleted file mode 100644
index 76066f541d0deb0be63aa4906d7edcfe6cf4f769..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-ide-lite-steps-hi3861.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# Hi3861 Development Board
-
-
-
-- **[Writing a Hello World Program](quickstart-ide-lite-steps-hi3861-application-framework.md)**
-
-- **[Building](quickstart-ide-lite-steps-hi3861-building.md)**
-
-- **[Burning](quickstart-ide-lite-steps-hi3861-burn.md)**
-
-- **[Networking](quickstart-ide-lite-steps-hi3861-netconfig.md)**
-
-- **[Debugging and Verification](quickstart-ide-lite-steps-hi3861-debug.md)**
-
-- **[Running](quickstart-ide-lite-steps-hi3861-running.md)**
diff --git a/en/device-dev/quick-start/quickstart-ide-lite-steps.md b/en/device-dev/quick-start/quickstart-ide-lite-steps.md
deleted file mode 100644
index 65831aac645d6edc634eb405a6c1e15cfc55543c..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-ide-lite-steps.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Running a Hello World Program
-
-
-
-- **[Hi3861 Development Board](quickstart-ide-lite-steps-hi3861.md)**
-
-- **[Hi3516 Development Board](quickstart-ide-lite-steps-hi3516.md)**
diff --git a/en/device-dev/quick-start/quickstart-ide-lite.md b/en/device-dev/quick-start/quickstart-ide-lite.md
deleted file mode 100644
index 46a6f375f13c4f6d751e9c5cab62e7671bddb63f..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-ide-lite.md
+++ /dev/null
@@ -1,13 +0,0 @@
-# Getting Started with Mini and Small Systems (IDE Mode)
-
-
-
-- **[Mini and Small System Overview](quickstart-ide-lite-overview.md)**
-
-- **[Environment Preparation](quickstart-ide-lite-env-setup.md)**
-
-- **[Creating a Source Code Project](quickstart-ide-lite-create-project.md)**
-
-- **[Running a Hello World Program](quickstart-ide-lite-steps.md)**
-
-- **[Appendix](quickstart-ide-lite-appendix.md)**
diff --git a/en/device-dev/quick-start/quickstart-ide-standard-appendix.md b/en/device-dev/quick-start/quickstart-ide-standard-appendix.md
deleted file mode 100644
index 6df76026c9e35f243e192e909e2bfefd441c8a74..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-ide-standard-appendix.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Appendix
-
-
-
-- **[Introduction to Development Boards](quickstart-ide-standard-board-introduction.md)**
diff --git a/en/device-dev/quick-start/quickstart-ide-standard-board-introduction.md b/en/device-dev/quick-start/quickstart-ide-standard-board-introduction.md
deleted file mode 100644
index a0ed1297124e19198467f2e0479f276a8622e052..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-ide-standard-board-introduction.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Introduction to Development Boards
-
-
-
-- **[Introduction to the Hi3516 Development Board](quickstart-ide-standard-board-introduction-hi3516.md)**
-
-- **[Introduction to the RK3568 Development Board](quickstart-ide-standard-board-introduction-rk3568.md)**
diff --git a/en/device-dev/quick-start/quickstart-ide-standard-create-project.md b/en/device-dev/quick-start/quickstart-ide-standard-create-project.md
index 3ac2873105b2f43ad674ea99d4b698a5f5940451..b9e8bb5ad690c6bdf8ffca8711e786d19fc433cf 100644
--- a/en/device-dev/quick-start/quickstart-ide-standard-create-project.md
+++ b/en/device-dev/quick-start/quickstart-ide-standard-create-project.md
@@ -1,4 +1,4 @@
-# Creating a Source Code Project
+# Importing a Source Code Project
After [setting up the Windows+Ubuntu hybrid development environment](../quick-start/quickstart-ide-standard-env-setup-win-ubuntu.md) and [obtaining source code](../quick-start/quickstart-ide-standard-sourcecode-acquire.md), perform the following steps to create a source code project in Windows:
diff --git a/en/device-dev/quick-start/quickstart-ide-standard-env-setup.md b/en/device-dev/quick-start/quickstart-ide-standard-env-setup.md
deleted file mode 100644
index 8faf2853a5d319958d0ebb4eeb6ebf1268cb0be0..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-ide-standard-env-setup.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Environment Preparation
-
-
-
-- **[Setting Up the Windows+Ubuntu Hybrid Development Environment](quickstart-ide-standard-env-setup-win-ubuntu.md)**
-
-- **[Obtaining Source Code](quickstart-ide-standard-sourcecode-acquire.md)**
diff --git a/en/device-dev/quick-start/quickstart-ide-standard-running-hi3516.md b/en/device-dev/quick-start/quickstart-ide-standard-running-hi3516.md
deleted file mode 100644
index 32080c7b30f6aae5e5c41f49f132408b2f949905..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-ide-standard-running-hi3516.md
+++ /dev/null
@@ -1,11 +0,0 @@
-# Hi3516 Development Board
-
-
-
-- **[Writing a Hello World Program](quickstart-ide-standard-running-hi3516-create.md)**
-
-- **[Building](quickstart-ide-standard-running-hi3516-build.md)**
-
-- **[Burning](quickstart-ide-standard-running-hi3516-burning.md)**
-
-- **[Running](quickstart-ide-standard-running-hi3516-running.md)**
diff --git a/en/device-dev/quick-start/quickstart-ide-standard-running-rk3568.md b/en/device-dev/quick-start/quickstart-ide-standard-running-rk3568.md
deleted file mode 100644
index 8ffc858557242c87460d2476a3aa26f2649d9304..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-ide-standard-running-rk3568.md
+++ /dev/null
@@ -1,11 +0,0 @@
-# RK3568 Development Board
-
-
-
-- **[Writing a Hello World Program](quickstart-ide-standard-running-rk3568-create.md)**
-
-- **[Building](quickstart-ide-standard-running-rk3568-build.md)**
-
-- **[Burning](quickstart-ide-standard-running-rk3568-burning.md)**
-
-- **[Running](quickstart-ide-standard-running-rk3568-running.md)**
diff --git a/en/device-dev/quick-start/quickstart-ide-standard-running.md b/en/device-dev/quick-start/quickstart-ide-standard-running.md
deleted file mode 100644
index 2a3ff8023f3508de5314490099c7be73b44ba098..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-ide-standard-running.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Running a Hello World Program
-
-
-
-- **[Hi3516 Development Board](quickstart-ide-standard-running-hi3516.md)**
-
-- **[RK3568 Development Board](quickstart-ide-standard-running-rk3568.md)**
diff --git a/en/device-dev/quick-start/quickstart-lite-appendix.md b/en/device-dev/quick-start/quickstart-lite-appendix.md
deleted file mode 100644
index e63539f9355627c8da77419114f565b28fb908a1..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-lite-appendix.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Appendix
-
-
-
-- **[Introduction to Development Boards](quickstart-lite-board-introduction.md)**
-
-- **[Reference](quickstart-lite-reference.md)**
diff --git a/en/device-dev/quick-start/quickstart-lite-board-introduction.md b/en/device-dev/quick-start/quickstart-lite-board-introduction.md
deleted file mode 100644
index 30c06d28ebcb235c3677f625173e769ec8411c0b..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-lite-board-introduction.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Introduction to Development Boards
-
-
-
-- **[Introduction to the Hi3861 Development Board](quickstart-lite-introduction-hi3861.md)**
-
-- **[Introduction to the Hi3516 Development Board](quickstart-lite-introduction-hi3516.md)**
diff --git a/en/device-dev/quick-start/quickstart-lite-env-setup-faqs.md b/en/device-dev/quick-start/quickstart-lite-env-setup-faqs.md
deleted file mode 100644
index ff4411ade6d31c0a3e283c532a25235a41c51561..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-lite-env-setup-faqs.md
+++ /dev/null
@@ -1,9 +0,0 @@
-# FAQs
-
-
-
-- **[Fixing hb Installation Issues](quickstart-lite-faq-hb.md)**
-
-- **[Fixing Compilation Issues](quickstart-lite-faq-compose.md)**
-
-- **[Fixing Burning Issues](quickstart-lite-faq-burning.md)**
diff --git a/en/device-dev/quick-start/quickstart-lite-steps-hi3516-burn.md b/en/device-dev/quick-start/quickstart-lite-steps-hi3516-burn.md
index cd0b1434eb03b1f237c69eb3dc1b4a5a66382dbb..9e453a954d7a3ee8a1e8ec5676c39e8ef30d0ca1 100644
--- a/en/device-dev/quick-start/quickstart-lite-steps-hi3516-burn.md
+++ b/en/device-dev/quick-start/quickstart-lite-steps-hi3516-burn.md
@@ -1,7 +1,7 @@
# Burning
-Hi3516D V300 supports burning through the USB port, network port, and serial port. This document describes how to burn source code through the USB port. The operations are performed in Windows.
+Burning is the process of downloading compiled program files to a development board to provide a basis for subsequent debugging. With the one-click burning function of DevEco Device Tool, you can burn images on development boards quickly and efficiently.
### Importing Source Code
diff --git a/en/device-dev/quick-start/quickstart-lite-steps-hi3516-application-framework.md b/en/device-dev/quick-start/quickstart-lite-steps-hi3516-helloworld.md
similarity index 100%
rename from en/device-dev/quick-start/quickstart-lite-steps-hi3516-application-framework.md
rename to en/device-dev/quick-start/quickstart-lite-steps-hi3516-helloworld.md
diff --git a/en/device-dev/quick-start/quickstart-lite-steps-hi3516.md b/en/device-dev/quick-start/quickstart-lite-steps-hi3516.md
deleted file mode 100644
index 0f6d8e0c88d63e24187add3cc4478b673179c174..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-lite-steps-hi3516.md
+++ /dev/null
@@ -1,13 +0,0 @@
-# Hi3516 Development Board
-
-
-
-- **[Setting Up the Hi3516 Development Board Environment](quickstart-lite-steps-hi3516-setting.md)**
-
-- **[Writing a Hello World Program](quickstart-lite-steps-hi3516-application-framework.md)**
-
-- **[Building](quickstart-lite-steps-hi3516-building.md)**
-
-- **[Burning](quickstart-lite-steps-hi3516-burn.md)**
-
-- **[Running](quickstart-lite-steps-hi3516-running.md)**
diff --git a/en/device-dev/quick-start/quickstart-lite-steps-hi3861-application-framework.md b/en/device-dev/quick-start/quickstart-lite-steps-hi3861-helloworld.md
similarity index 100%
rename from en/device-dev/quick-start/quickstart-lite-steps-hi3861-application-framework.md
rename to en/device-dev/quick-start/quickstart-lite-steps-hi3861-helloworld.md
diff --git a/en/device-dev/quick-start/quickstart-lite-steps-hi3861.md b/en/device-dev/quick-start/quickstart-lite-steps-hi3861.md
deleted file mode 100644
index 0f637821f518c0edcced32f369eb09eb594990c7..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-lite-steps-hi3861.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# Hi3861 Development Board
-
-
-
-- **[Setting Up the Hi3861 Development Board Environment](quickstart-lite-steps-hi3861-setting.md)**
-
-- **[Writing a Hello World Program](quickstart-lite-steps-hi3861-application-framework.md)**
-
-- **[Building](quickstart-lite-steps-hi3861-building.md)**
-
-- **[Burning](quickstart-lite-steps-hi3861-burn.md)**
-
-- **[Networking](quickstart-lite-steps-hi3861-netconfig.md)**
-
-- **[Debugging and Verification](quickstart-lite-steps-hi3861-debug.md)**
-
-- **[Running](quickstart-lite-steps-hi3861-running.md)**
-
diff --git a/en/device-dev/quick-start/quickstart-lite-steps.md b/en/device-dev/quick-start/quickstart-lite-steps.md
deleted file mode 100644
index 06ff9266b6e141eba935c90c690fc0405f4dae28..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-lite-steps.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Running a Hello World Program
-
-
-
-- **[Hi3861 Development Board](quickstart-lite-steps-hi3861.md)**
-
-- **[Hi3516 Development Board](quickstart-lite-steps-hi3516.md)**
diff --git a/en/device-dev/quick-start/quickstart-standard-appendix.md b/en/device-dev/quick-start/quickstart-standard-appendix.md
deleted file mode 100644
index 12642666b4a8b2a5000900fe078ad57805e8bc07..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-standard-appendix.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Appendix
-
-
-
-- **[Introduction to Development Boards](quickstart-standard-board-introduction.md)**
-
-- **[Reference](quickstart-standard-reference.md)**
diff --git a/en/device-dev/quick-start/quickstart-standard-board-introduction.md b/en/device-dev/quick-start/quickstart-standard-board-introduction.md
deleted file mode 100644
index c339e4d8b9ad0f5df373b6a9a0d12099f1df9dcf..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-standard-board-introduction.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Introduction to Development Boards
-
-
-
-- **[Introduction to the Hi3516 Development Board](quickstart-standard-board-introduction-hi3516.md)**
-
-- **[Introduction to the RK3568 Development Board](quickstart-standard-board-introduction-rk3568.md)**
diff --git a/en/device-dev/quick-start/quickstart-standard-docker.md b/en/device-dev/quick-start/quickstart-standard-docker.md
deleted file mode 100644
index 9c3eee01247037c1b019d260d7e09068045f0013..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-standard-docker.md
+++ /dev/null
@@ -1,13 +0,0 @@
-# Getting Started with Standard System (Using the Installation Package)
-
-
-
-- **[Standard System Overview](quickstart-standard-overview.md)**
-
-- **[Setting Up Environments for Standard System](quickstart-standard-env-setup.md)**
-
-- **[Running a Hello World Project](quickstart-standard-running.md)**
-
-- **[FAQs](quickstart-standard-faqs.md)**
-
-- **[Appendix](quickstart-standard-appendix.md)**
diff --git a/en/device-dev/quick-start/quickstart-standard-faqs.md b/en/device-dev/quick-start/quickstart-standard-faqs.md
deleted file mode 100644
index e4c33d7f1f467dbf995cfab823281b0791a45c64..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-standard-faqs.md
+++ /dev/null
@@ -1,10 +0,0 @@
-# FAQs
-
-
-
-- **[Fixing hb Installation Issues](quickstart-standard-faq-hb.md)**
-
-- **[Fixing Compilation Issues](quickstart-standard-faq-compose.md)**
-
-- **[Fixing Burning Issues](quickstart-standard-faq-burning.md)**
-
diff --git a/en/device-dev/quick-start/quickstart-standard-ide.md b/en/device-dev/quick-start/quickstart-standard-ide.md
deleted file mode 100644
index 034c53890ad98ed1bbad80cfadc6a8a971d5f397..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-standard-ide.md
+++ /dev/null
@@ -1,13 +0,0 @@
-# Getting Started with Standard System (IDE Mode)
-
-
-
-- **[Standard System Overview](quickstart-ide-standard-overview.md)**
-
-- **[Environment Preparation](quickstart-ide-standard-env-setup.md)**
-
-- **[Creating a Source Code Project](quickstart-ide-standard-create-project.md)**
-
-- **[Running a Hello World Program](quickstart-ide-standard-running.md)**
-
-- **[Appendix](quickstart-ide-standard-appendix.md)**
diff --git a/en/device-dev/quick-start/quickstart-standard-running-hi3516.md b/en/device-dev/quick-start/quickstart-standard-running-hi3516.md
deleted file mode 100644
index e85603a4bcf66366ee435fe6ffc744c2f4385691..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-standard-running-hi3516.md
+++ /dev/null
@@ -1,11 +0,0 @@
-# Hi3516 Development Board
-
-
-
-- **[Writing a Hello World Program](quickstart-standard-running-hi3516-create.md)**
-
-- **[Building](quickstart-standard-running-hi3516-build.md)**
-
-- **[Burning](quickstart-standard-running-hi3516-burning.md)**
-
-- **[Running](quickstart-standard-running-hi3516-running.md)**
diff --git a/en/device-dev/quick-start/quickstart-standard-running-rk3568.md b/en/device-dev/quick-start/quickstart-standard-running-rk3568.md
deleted file mode 100644
index c13877b26bb7cd3b50ec6e9970d3238db6c59bc1..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-standard-running-rk3568.md
+++ /dev/null
@@ -1,11 +0,0 @@
-# RK3568 Development Board
-
-
-
-- **[Writing a Hello World Program](quickstart-standard-running-rk3568-create.md)**
-
-- **[Building](quickstart-standard-running-rk3568-build.md)**
-
-- **[Burning](quickstart-standard-running-rk3568-burning.md)**
-
-- **[Running](quickstart-standard-running-rk3568-running.md)**
diff --git a/en/device-dev/quick-start/quickstart-standard-running.md b/en/device-dev/quick-start/quickstart-standard-running.md
deleted file mode 100644
index 7bde76093cd3c045e32170c48de635388bcd7e0d..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart-standard-running.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Running a Hello World Program
-
-
-
-- **[Hi3516 Development Board](quickstart-standard-running-hi3516.md)**
-
-- **[RK3568 Development Board](quickstart-standard-running-rk3568.md)**
diff --git a/en/device-dev/quick-start/quickstart-standard-running-hi3516-create.md b/en/device-dev/quick-start/quickstart-std-3516-create.md
similarity index 100%
rename from en/device-dev/quick-start/quickstart-standard-running-hi3516-create.md
rename to en/device-dev/quick-start/quickstart-std-3516-create.md
diff --git a/en/device-dev/quick-start/quickstart.md b/en/device-dev/quick-start/quickstart.md
deleted file mode 100644
index 13fe6384e1491db3a347b4ef5784e37a75fd37a9..0000000000000000000000000000000000000000
--- a/en/device-dev/quick-start/quickstart.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Getting Started
-
-
-
-- **[Getting Started with Mini and Small Systems](quickstart-lite.md)**
-
-- **[Getting Started with Standard System](quickstart-standard.md)**
diff --git a/en/device-dev/website.md b/en/device-dev/website.md
index f25a0df2ed4ddc61221c2f6bd2880f466c3a8f51..2f47be6bc81699ec1075c34ad3dbd34d935cf16b 100644
--- a/en/device-dev/website.md
+++ b/en/device-dev/website.md
@@ -11,13 +11,13 @@
- [Obtaining Source Code](quick-start/quickstart-ide-lite-sourcecode-acquire.md)
- - [Creating a Source Code Project](quick-start/quickstart-ide-lite-create-project.md)
+ - [Importing a Source Code Project](quick-start/quickstart-ide-lite-create-project.md)
- Running a Hello World Program
- Hi3861 Development Board
- - [Writing a Hello World Program](quick-start/quickstart-ide-lite-steps-hi3861-application-framework.md)
+ - [Writing a Hello World Program](quick-start/quickstart-ide-lite-steps-hi3861-helloworld.md)
- [Building](quick-start/quickstart-ide-lite-steps-hi3861-building.md)
@@ -31,7 +31,7 @@
- Hi3516 Development Board
- - [Writing a Hello World Program](quick-start/quickstart-ide-lite-steps-hi3516-application-framework.md)
+ - [Writing a Hello World Program](quick-start/quickstart-ide-lite-steps-hi3516-helloworld.md)
- [Building](quick-start/quickstart-ide-lite-steps-hi3516-building.md)
@@ -57,7 +57,7 @@
- [Setting Up the Hi3861 Development Board Environment](quick-start/quickstart-lite-steps-hi3861-setting.md)
- - [Writing a Hello World Program](quick-start/quickstart-lite-steps-hi3861-application-framework.md)
+ - [Writing a Hello World Program](quick-start/quickstart-lite-steps-hi3861-helloworld.md)
- [Building](quick-start/quickstart-lite-steps-hi3861-building.md)
@@ -73,7 +73,7 @@
- [Setting Up the Hi3516 Development Board Environment](quick-start/quickstart-lite-steps-hi3516-setting.md)
- - [Writing a Hello World Program](quick-start/quickstart-lite-steps-hi3516-application-framework.md)
+ - [Writing a Hello World Program](quick-start/quickstart-lite-steps-hi3516-helloworld.md)
- [Building](quick-start/quickstart-lite-steps-hi3516-building.md)
@@ -109,7 +109,7 @@
- [Obtaining Source Code](quick-start/quickstart-ide-standard-sourcecode-acquire.md)
- - [Creating a Source Code Project](quick-start/quickstart-ide-standard-create-project.md)
+ - [Importing a Source Code Project](quick-start/quickstart-ide-standard-create-project.md)
- Running a Hello World Program
@@ -723,28 +723,24 @@
- Peripheral Driver Usage
+ - [Audio](driver/driver-peripherals-audio-des.md)
+ - [Camera](driver/driver-peripherals-camera-des.md)
+ - [Face_auth](driver/driver-peripherals-face_auth-des.md)
- [LCD](driver/driver-peripherals-lcd-des.md)
-
- - [Touchscreen](driver/driver-peripherals-touch-des.md)
-
+ - [Light](driver/driver-peripherals-light-des.md)
+ - [Pin_auth](driver/driver-peripherals-pinauth-des.md)
- [Sensor](driver/driver-peripherals-sensor-des.md)
-
- - [WLAN](driver/driver-peripherals-external-des.md)
-
- - [Audio](driver/driver-peripherals-audio-des.md)
-
+ - [Touchscreen](driver/driver-peripherals-touch-des.md)
- [USB](driver/driver-peripherals-usb-des.md)
-
- - [Camera](driver/driver-peripherals-camera-des.md)
-
+ - [User_auth](driver/driver-peripherals-user-auth-des.md)
- [Vibrator](driver/driver-peripherals-vibrator-des.md)
-
- - [Light](driver/driver-peripherals-light-des.md)
+ - [WLAN](driver/driver-peripherals-external-des.md)
- Compilation and Building
- [Building Mini and Small Systems](subsystems/subsys-build-mini-lite.md)
- [Building the Standard System](subsystems/subsys-build-standard-large.md)
- [Build System Coding Specifications and Best Practices](subsystems/subsys-build-gn-coding-style-and-best-practice.md)
- [Building the Kconfig Visual Configuration](subsystems/subsys-build-gn-kconfig-visual-config-guide.md)
+ - [HAP Build Guide](subsystems/subsys-build-gn-hap-compilation-guide.md)
- [Distributed Remote Startup](subsystems/subsys-remote-start.md)
- Graphics
- [Graphics Overview](subsystems/subsys-graphics-overview.md)
diff --git a/zh-cn/application-dev/database/database-relational-guidelines.md b/zh-cn/application-dev/database/database-relational-guidelines.md
index 06e1beed512c8b17812fbe9f730b5bd907c16258..75f6e12271df0d9d618cd60d85ff2b6a67db65f7 100644
--- a/zh-cn/application-dev/database/database-relational-guidelines.md
+++ b/zh-cn/application-dev/database/database-relational-guidelines.md
@@ -205,7 +205,7 @@
const CREATE_TABLE_TEST = "CREATE TABLE IF NOT EXISTS test (" + "id INTEGER PRIMARY KEY AUTOINCREMENT, " + "name TEXT NOT NULL, " + "age INTEGER, " + "salary REAL, " + "blobType BLOB)";
const STORE_CONFIG = {name: "rdbstore.db",}
data_rdb.getRdbStore(STORE_CONFIG, 1, function (err, rdbStore) {
- rdbStore.executeSql(SQL_CREATE_TABLE)
+ rdbStore.executeSql(CREATE_TABLE_TEST)
console.info('create table done.')
})
```
diff --git a/zh-cn/application-dev/reference/apis/js-apis-Context.md b/zh-cn/application-dev/reference/apis/js-apis-Context.md
index 0a5358b99329ffdec0c2449cfbf6e820370378b1..e764ac7212fc290697d93f189e4a2db53124d91e 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-Context.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-Context.md
@@ -1,5 +1,7 @@
# Context模块
+Context模块提供了ability或application的上下文的能力，包括允许访问特定于应用程序的资源、请求和验证权限等并且只能通过ability获得。
+
> **说明：**
>
> 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
diff --git a/zh-cn/application-dev/reference/apis/js-apis-DataUriUtils.md b/zh-cn/application-dev/reference/apis/js-apis-DataUriUtils.md
index 571e280078eb892a9f1738531da67c31d18eb583..97cf4b213839a3217c7050504e3cd145080bfc1f 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-DataUriUtils.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-DataUriUtils.md
@@ -1,5 +1,7 @@
# DataUriUtils模块
+DataUriUtils模块提供用于处理使用DataAbilityHelper方案的对象的实用程序类的能力，包括获取，添加，更新给定uri的路径组件末尾的ID。
+
> **说明：**
>
> 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
diff --git a/zh-cn/application-dev/reference/apis/js-apis-ability-context.md b/zh-cn/application-dev/reference/apis/js-apis-ability-context.md
index 97e78697ff471697934da03a7be8db1fd8cd13f1..4d83cbafe31bb8a95ba92d5f0c93414072b40af6 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-ability-context.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-ability-context.md
@@ -1,12 +1,14 @@
# AbilityContext
+AbilityContext是Ability的上下文环境，继承自Context。
+
+AbilityContext模块提供允许访问特定于ability的资源的能力，包括对Ability的启动、停止的设置、获取caller通信接口、拉起弹窗请求用户授权等。
+
> **说明：**
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
-Ability的上下文环境，继承自Context。
-
## 导入模块
```js
@@ -276,7 +278,7 @@ terminateSelf(): Promise<void>;
**示例：**
```js
- this.context.terminateSelf(want).then((data) => {
+ this.context.terminateSelf().then((data) => {
console.log('success:' + JSON.stringify(data));
}).catch((error) => {
console.log('failed:' + JSON.stringify(error));
diff --git a/zh-cn/application-dev/reference/apis/js-apis-ability-errorCode.md b/zh-cn/application-dev/reference/apis/js-apis-ability-errorCode.md
index f8854749719f8f3baa7b1a8f663a6b83c39199e6..3ac842d69c02d585203b5cdf21a87579db63527f 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-ability-errorCode.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-ability-errorCode.md
@@ -1,5 +1,9 @@
# ErrorCode
+ErrorCode是定义启动功能时使用的错误代码。
+
+本模块提供使用的错误代码的能力，包括没有错误，无效的参数等。
+
> **说明：**
>
> 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
diff --git a/zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md b/zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md
index 2cc1e5e69dd0832f634dec1b350ec79d7994be94..7d398275e4ac9d3b41f1bf7fc7eb78b82573eba6 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md
@@ -1,5 +1,7 @@
# wantConstant
+wantConstant模块提供want中action和entity的权限列表的能力，包括系统公共事件宏，系统公共事件名称等。
+
> **说明：**
>
> 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
diff --git a/zh-cn/application-dev/reference/apis/js-apis-abilityDelegatorRegistry.md b/zh-cn/application-dev/reference/apis/js-apis-abilityDelegatorRegistry.md
index de2754e56a051b8178fe3afe056ff7f45822249e..99ab605979e57a0e95ed1b1f00b5e9040ee5a9c6 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-abilityDelegatorRegistry.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-abilityDelegatorRegistry.md
@@ -1,5 +1,7 @@
# AbilityDelegatorRegistry
+AbilityDelegatorRegistry模块提供用于存储已注册的AbilityDelegator和AbilityDelegatorArgs对象的全局寄存器的能力，包括获取应用程序的AbilityDelegator对象、获取单元测试参数AbilityDelegatorArgs对象。
+
> **说明：**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
diff --git a/zh-cn/application-dev/reference/apis/js-apis-abilityManager.md b/zh-cn/application-dev/reference/apis/js-apis-abilityManager.md
new file mode 100644
index 0000000000000000000000000000000000000000..a28fee592d8970dd6db9168a5c368e91b25cef00
--- /dev/null
+++ b/zh-cn/application-dev/reference/apis/js-apis-abilityManager.md
@@ -0,0 +1,267 @@
+# AbilityManager
+
+AbilityManager模块提供对Ability相关信息和状态信息进行获取、新增、修改等能力。
+
+> **说明：**
+>
+> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+> 本模块接口均为系统接口，三方应用不支持调用。
+
+# 导入模块
+
+```js
+import AbilityManager from '@ohos.application.abilityManager'
+```
+
+## AbilityState
+
+Ability的状态信息。
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
+
+| 名称 | 值 | 说明 |
+| -------- | -------- | -------- |
+| INITIAL | 0 | 表示ability为initial状态。|
+| FOREGROUND | 9 | 表示ability为foreground状态。 |
+| BACKGROUND | 10 | 表示ability为background状态。 |
+| FOREGROUNDING | 11 | 表示ability为foregrounding状态。 |
+| BACKGROUNDING | 12 | 表示ability为backgrounding状态。 |
+
+
+## updateConfiguration
+
+updateConfiguration(config: Configuration, callback: AsyncCallback\): void
+
+通过修改配置来更新配置（callback形式）。
+
+**需要权限**: ohos.permission.UPDATE_CONFIGURATION
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
+
+**参数**：
+
+| 名称 | 类型 | 必填 | 描述 |
+| --------- | ---------------------------------------- | ---- | -------------- |
+| config | Configuration | 是 | 新的配置项。 |
+| callback | AsyncCallback\ | 是 | 被指定的回调方法。 |
+
+**示例**：
+
+```js
+import abilitymanager from '@ohos.application.abilityManager';
+
+var config = {
+ language: 'chinese'
+}
+
+abilitymanager.updateConfiguration(config, () => {
+ console.log('------------ updateConfiguration -----------');
+})
+```
+
+## updateConfiguration
+
+updateConfiguration(config: Configuration): Promise\
+
+通过修改配置来更新配置（Promise形式）。
+
+**需要权限**: ohos.permission.UPDATE_CONFIGURATION
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
+
+**参数**：
+
+| 名称 | 类型 | 必填 | 描述 |
+| --------- | ---------------------------------------- | ---- | -------------- |
+| config | Configuration | 是 | 新的配置项。 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| ---------------------------------------- | ------- |
+| Promise\ | 返回执行结果。 |
+
+**示例**：
+
+```js
+import abilitymanager from '@ohos.application.abilityManager';
+
+var config = {
+ language: 'chinese'
+}
+
+abilitymanager.updateConfiguration(config).then(() => {
+ console.log('updateConfiguration success');
+}).catch((err) => {
+ console.log('updateConfiguration fail');
+})
+```
+
+## getAbilityRunningInfos
+
+getAbilityRunningInfos(callback: AsyncCallback\>): void
+
+获取Ability运行相关信息（callback形式）。
+
+**需要权限**: ohos.permission.GET_RUNNING_INFO
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
+
+**参数**：
+
+| 名称 | 类型 | 必填 | 描述 |
+| --------- | ---------------------------------------- | ---- | -------------- |
+| callback | AsyncCallback\> | 是 | 被指定的回调方法。 |
+
+**示例**：
+
+```js
+import abilitymanager from '@ohos.application.abilityManager';
+
+abilitymanager.getAbilityRunningInfos((err,data) => {
+ console.log("getAbilityRunningInfos err: " + err + " data: " + JSON.stringify(data));
+});
+```
+
+## getAbilityRunningInfos
+
+getAbilityRunningInfos(): Promise\>
+
+获取Ability运行相关信息（Promise形式）。
+
+**需要权限**: ohos.permission.GET_RUNNING_INFO
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
+
+**返回值：**
+
+| 类型 | 说明 |
+| ---------------------------------------- | ------- |
+| Promise\> | 返回执行结果。 |
+
+**示例**：
+
+```js
+import abilitymanager from '@ohos.application.abilityManager';
+
+abilitymanager.getAbilityRunningInfos().then((data) => {
+ console.log("getAbilityRunningInfos data: " + JSON.stringify(data))
+}).catch((err) => {
+ console.log("getAbilityRunningInfos err: " + err)
+});
+```
+
+## getExtensionRunningInfos9+
+
+getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\>): void
+
+获取关于运行扩展能力的信息（callback形式）。
+
+**需要权限**: ohos.permission.GET_RUNNING_INFO
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
+
+**参数**：
+
+| 名称 | 类型 | 必填 | 描述 |
+| --------- | ---------------------------------------- | ---- | -------------- |
+| upperLimit | number | 是 | 获取消息数量的最大限制。 |
+| callback | AsyncCallback\> | 是 | 被指定的回调方法。 |
+
+**示例**：
+
+```js
+import abilitymanager from '@ohos.application.abilityManager';
+
+var upperLimit = 0;
+
+abilitymanager.getExtensionRunningInfos(upperLimit, (err,data) => {
+ console.log("getExtensionRunningInfos err: " + err + " data: " + JSON.stringify(data));
+});
+```
+
+## getExtensionRunningInfos9+
+
+getExtensionRunningInfos(upperLimit: number): Promise\>
+
+获取关于运行扩展能力的信息（Promise形式）。
+
+**需要权限**: ohos.permission.GET_RUNNING_INFO
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
+
+**参数**：
+
+| 名称 | 类型 | 必填 | 描述 |
+| --------- | ---------------------------------------- | ---- | -------------- |
+| upperLimit | number | 是 | 获取消息数量的最大限制。 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| ---------------------------------------- | ------- |
+| Promise\> | 返回执行结果。 |
+
+**示例**：
+
+```js
+import abilitymanager from '@ohos.application.abilityManager';
+
+var upperLimit = 0;
+
+abilitymanager.getExtensionRunningInfos(upperLimit).then((data) => {
+ console.log("getAbilityRunningInfos data: " + JSON.stringify(data));
+}).catch((err) => {
+ console.log("getAbilityRunningInfos err: " + err);
+})
+```
+
+## getTopAbility9+
+
+getTopAbility(callback: AsyncCallback\): void;
+
+新增获取窗口焦点的ability接口（callback形式）。
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
+
+**参数**：
+
+| 名称 | 类型 | 必填 | 描述 |
+| --------- | ---------------------------------------- | ---- | -------------- |
+| callback | AsyncCallback\ | 是 | 被指定的回调方法。 |
+
+**示例**：
+
+```js
+import abilitymanager from '@ohos.application.abilityManager';
+
+abilitymanager.getTopAbility((err,data) => {
+ console.log("getTopAbility err: " + err + " data: " + JSON.stringify(data));
+});
+```
+
+## getTopAbility9+
+
+getTopAbility(): Promise\;
+
+新增获取窗口焦点的ability接口（Promise形式）。
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
+
+**返回值：**
+
+| 类型 | 说明 |
+| ---------------------------------------- | ------- |
+| Promise\| 返回执行结果。 |
+
+**示例**：
+
+```js
+import abilitymanager from '@ohos.application.abilityManager';
+
+abilitymanager.getTopAbility().then((data) => {
+ console.log("getTopAbility data: " + JSON.stringify(data));
+}).catch((err) => {
+ console.log("getTopAbility err: " + err);
+})
+```
\ No newline at end of file
diff --git a/zh-cn/application-dev/reference/apis/js-apis-abilityrunninginfo.md b/zh-cn/application-dev/reference/apis/js-apis-abilityrunninginfo.md
index 6a23b73fb24365889ecb9d4bf227ede99526c553..d3e9d1618b990e56f30178fc3721f861982a9869 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-abilityrunninginfo.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-abilityrunninginfo.md
@@ -1,11 +1,11 @@
# AbilityRunningInfo
+AbilityRunningInfo模块提供对Ability运行的相关信息和状态进行设置和查询的能力。
+
> **说明：**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-Ability运行相关信息。
-
## 导入模块
```js
@@ -27,6 +27,8 @@ abilitymanager.getAbilityRunningInfos((err,data) => {
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
+**系统API**：该接口为系统接口，三方应用不支持调用。
+
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| ability | ElementName | 是 | 否 | Ability匹配信息 |
@@ -43,6 +45,8 @@ Ability的状态信息。
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
+**系统API**：该接口为系统接口，三方应用不支持调用。
+
| 名称 | 值 | 说明 |
| -------- | -------- | -------- |
| INITIAL | 0 | 表示ability为initial状态。|
diff --git a/zh-cn/application-dev/reference/apis/js-apis-abilitystagecontext.md b/zh-cn/application-dev/reference/apis/js-apis-abilitystagecontext.md
index 708756b5861ec4d6daa6581f04ce1e228a46e7c2..17a9f3117084a44bc32b9845ef50f6206c62d98f 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-abilitystagecontext.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-abilitystagecontext.md
@@ -1,12 +1,14 @@
# AbilityStageContext
+AbilityStageContext是AbilityStage的上下文环境，继承自[Context](js-apis-application-context.md)。
+
+AbilityStageContext提供允许访问特定于abilityStage的资源的能力，包括获取AbilityStage对应的ModuleInfo对象、环境变化对象。
+
> **说明：**
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
-AbilityStage的上下文环境，继承自[Context](js-apis-application-context.md)。
-
## 导入模块
```js
diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-StartOptions.md b/zh-cn/application-dev/reference/apis/js-apis-application-StartOptions.md
index 89171758b1340be5a69a7925730919b2a16f5e15..5f5a79c9b1f60167f2cb0fcc8465550d3438eba9 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-application-StartOptions.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-application-StartOptions.md
@@ -1,15 +1,12 @@
# StartOptions
-- [导入模块](#导入模块)
-- [属性](#属性)
+StartOptions模块对系统的基本通信组件进行查询和设置的能力。
> **说明：**
>
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
-StartOptions是系统的基本通信组件。
-
## 导入模块
```
@@ -18,7 +15,7 @@ import StartOptions from '@ohos.application.StartOptions';
## 属性
-**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.AbilityCore
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 可读 | 可写 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | -------- | -------- |
diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-Want.md b/zh-cn/application-dev/reference/apis/js-apis-application-Want.md
index 3de25db1790054f60ca1c124f8f285febd75bdcd..a85af4fa07eadc2d309fb18b7eb23cc528f632ae 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-application-Want.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-application-Want.md
@@ -1,11 +1,11 @@
# Want
+Want模块提供系统的基本通信组件的能力。
+
> **说明：**
>
> 本模块首批接口从API version 8 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-Want是系统的基本通信组件。
-
## 导入模块
```
@@ -27,4 +27,4 @@ import Want from '@ohos.application.Want';
| action | 只读 | string | 否 | 表示action选项描述。 |
| parameters | 只读 | {[key: string]: any} | 否 | 表示WantParams描述。 |
| entities | 只读 | Array\ | 否 | 表示entities相关描述。 |
-| moduleName9+ | 只读 | string | 否 | 表示待启动的Ability所属的模块（module）。同一应用的不同hap的组件可能重名，仅通过BundleName和AbilityName无法区分时，可以通过设置moduleName加以区分，以匹配到指定的Ability。 | |
+
diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-ability.md b/zh-cn/application-dev/reference/apis/js-apis-application-ability.md
index e8677abf2c299a794c7831f424432188440bc71c..5934a0a89c69563422b36bd93e190dccdfe3e032 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-application-ability.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-application-ability.md
@@ -1,12 +1,17 @@
# Ability
+Ability模块提供对Ability生命周期、上下文环境等调用管理的能力，包括Ability创建、销毁、转储客户端信息等。
+
+该模块提供以下Ability相关的常用功能：
+
+- [Caller](#caller)：通用组件Caller通信客户端调用接口, 用来向通用组件服务端发送约定数据。
+- [Callee](#callee)：通用组件服务端注册和解除客户端caller通知送信的callback接口。
+
> **说明：**
>
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
-Ability模块，提供对Ability生命周期、上下文环境等调用管理。
-
## 导入模块
```
diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-abilityConstant.md b/zh-cn/application-dev/reference/apis/js-apis-application-abilityConstant.md
index e3c9b905b36a6b897528d8d8bd692574735180da..312d3b9386dad297d43ac202f4135b5966a463f4 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-application-abilityConstant.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-application-abilityConstant.md
@@ -1,15 +1,14 @@
# AbilityConstant
-- [导入模块](#导入模块)
-- [属性](#属性)
+AbilityConstant是启动参数的接口。
+
+AbilityConstant提供启动参数的接口的能力，包括设置初次开始原因的类型、上次退出原因的类型、继续结果的类型。
> **说明：**
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
-启动参数的接口.
-
## 导入模块
```js
diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegator.md b/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegator.md
index cfe0dda023a4ccf26487ceaff629e0d786cffbef..c71b0bd271bf4ebd1a59bf8fb2dfc5c2a1baa418 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegator.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegator.md
@@ -1,5 +1,7 @@
# AbilityDelegator
+AbilityDelegator提供添加用于监视指定能力的生命周期状态更改的AbilityMonitor对象的能力，包括对AbilityMonitor实例的添加、删除、等待ability到达OnCreate生命周期、设置等待时间等、获取指定ability的生命周期状态、获取当前应用顶部ability、启动指定ability等。
+
> **说明：**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegatorArgs.md b/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegatorArgs.md
index 20fa3573275219a41e082218fba5776b1b26050b..27983fe5f46c6ec66121cc432c63df7a909aefaa 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegatorArgs.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegatorArgs.md
@@ -1,5 +1,7 @@
# AbilityDelegatorArgs
+AbilityDelegatorArgs模块提供在应用程序启动期间，用于存储已注册的AbilityDelegator和AbilityDelegatorArgs对象的全局寄存器的能力。
+
> **说明：**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-abilityLifecycleCallback.md b/zh-cn/application-dev/reference/apis/js-apis-application-abilityLifecycleCallback.md
index 98136d532e27e747e69082be183d88210a3c7417..f220273cbfb22a312c7253d21c6df0b3044cbabc 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-application-abilityLifecycleCallback.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-application-abilityLifecycleCallback.md
@@ -1,13 +1,13 @@
# AbilityLifecycleCallback
+AbilityLifecycleCallback模块提供应用上下文ApplicationContext的生命周期监听方法的回调类的能力，包括onAbilityCreate、onAbilityWindowStageCreate、onAbilityWindowStageDestroy等方法。
+
> **说明：**
>
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
-应用上下文ApplicationContext的生命周期监听方法的回调类，里面提供了onAbilityCreate、onAbilityWindowStageCreate、onAbilityWindowStageDestroy等方法。
-
## 导入模块
```js
diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-abilityMonitor.md b/zh-cn/application-dev/reference/apis/js-apis-application-abilityMonitor.md
index ca264b1398adce48d13f30a620b6caac0d17ecac..4e811b1b27213c17fbbf857e0b03939248f85dab 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-application-abilityMonitor.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-application-abilityMonitor.md
@@ -1,5 +1,7 @@
# AbilityMonitor
+AbilityMonitor模块提供匹配满足指定条件的受监视能力对象的方法的能力，最近匹配的能力对象将保存在AbilityMonitor对象中。
+
> **说明：**
>
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-abilitystage.md b/zh-cn/application-dev/reference/apis/js-apis-application-abilitystage.md
index 1a8740cdecb1225cb117cdb7bca9bfc840e32101..ec0580c1d1038522e25dfe9b87ab1aa19656bf6a 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-application-abilitystage.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-application-abilitystage.md
@@ -1,12 +1,14 @@
# AbilityStage
+AbilityStage是HAP包的运行时类。
+
+AbilityStage模块提供在HAP加载的时候，通知开发者，可以在此进行该HAP的初始化（如资源预加载，线程创建等）能力。
+
> **说明：**
>
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
-AbilityStage是HAP包的运行时类。在HAP加载的时候，通知开发者，开发者可以在此进行该HAP的初始化（如资源预加载，线程创建等）。
-
## 导入模块
```js
diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-applicationContext.md b/zh-cn/application-dev/reference/apis/js-apis-application-applicationContext.md
index 3014b5d5a53e6c076babdee284c10ae859d693c1..b47dbf1b74d39b30fa5b0874a394e856c257be51 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-application-applicationContext.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-application-applicationContext.md
@@ -1,12 +1,12 @@
# ApplicationContext
+ApplicationContext模块提供开发者应用级别的的上下文的能力，包括提供注册及取消注册应用内组件生命周期的监听接口。
+
> **说明：**
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
-提供开发者应用级别的的上下文，提供注册及取消注册应用内组件生命周期的监听接口。
-
## 导入模块
```
@@ -45,10 +45,49 @@ registerAbilityLifecycleCallback(callback: AbilityLifecycleCallback): **number**
**示例：**
```js
- let applicationContext = this.context.getApplicationContext();
- console.log("stage applicationContext: " + JSON.stringify(applicationContext));
- let lifecycleid = applicationContext.registerAbilityLifecycleCallback(AbilityLifecycleCallback);
- console.log("registerAbilityLifecycleCallback number: " + JSON.stringify(lifecycleid));
+import AbilityStage from "@ohos.application.AbilityStage";
+
+var lifecycleid;
+
+export default class MyAbilityStage extends AbilityStage {
+ onCreate() {
+ console.log("MyAbilityStage onCreate")
+ let AbilityLifecycleCallback = {
+ onAbilityCreate(ability){
+ console.log("AbilityLifecycleCallback onAbilityCreate ability:" + JSON.stringify(ability));
+ },
+ onAbilityWindowStageCreate(ability){
+ console.log("AbilityLifecycleCallback onAbilityWindowStageCreate ability:" + JSON.stringify(ability));
+ },
+ onAbilityWindowStageDestroy(ability){
+ console.log("AbilityLifecycleCallback onAbilityWindowStageDestroy ability:" + JSON.stringify(ability));
+ },
+ onAbilityDestroy(ability){
+ console.log("AbilityLifecycleCallback onAbilityDestroy ability:" + JSON.stringify(ability));
+ },
+ onAbilityForeground(ability){
+ console.log("AbilityLifecycleCallback onAbilityForeground ability:" + JSON.stringify(ability));
+ },
+ onAbilityBackground(ability){
+ console.log("AbilityLifecycleCallback onAbilityBackground ability:" + JSON.stringify(ability));
+ },
+ onAbilityContinue(ability){
+ console.log("AbilityLifecycleCallback onAbilityContinue ability:" + JSON.stringify(ability));
+ }
+ }
+ // 1.通过context属性获取applicationContext
+ let applicationContext = this.context.getApplicationContext();
+ // 2.通过applicationContext注册监听应用内生命周期
+ lifecycleid = applicationContext.registerAbilityLifecycleCallback(AbilityLifecycleCallback);
+ console.log("registerAbilityLifecycleCallback number: " + JSON.stringify(lifecycleid));
+ }
+ onDestroy() {
+ let applicationContext = this.context.getApplicationContext();
+ applicationContext.unregisterAbilityLifecycleCallback(lifecycleid, (error, data) => {
+ console.log("unregisterAbilityLifecycleCallback success, err: " + JSON.stringify(error));
+ });
+ }
+}
```
## ApplicationContext.unregisterAbilityLifecycleCallback
@@ -70,6 +109,7 @@ unregisterAbilityLifecycleCallback(callbackId: **number**, callback: AsyncCallb
```js
let applicationContext = this.context.getApplicationContext();
+ let lifecycleid=1
console.log("stage applicationContext: " + JSON.stringify(applicationContext));
applicationContext.unregisterAbilityLifecycleCallback(lifecycleid, (error, data) => {
console.log("unregisterAbilityLifecycleCallback success, err: " + JSON.stringify(error));
diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-context.md b/zh-cn/application-dev/reference/apis/js-apis-application-context.md
index 237747baf451da340d5179a65817170ef1fb7fad..127a5e04cb4ee11e88a1809e4ee296696e959df7 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-application-context.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-application-context.md
@@ -1,5 +1,7 @@
# Context
+Context模块提供开发者运行代码的上下文环境的能力，包括查询和设置应用信息、ResourceManager等信息。
+
> **说明：**
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-missionInfo.md b/zh-cn/application-dev/reference/apis/js-apis-application-missionInfo.md
deleted file mode 100644
index 450fad8785f22d73fdf715ed068897981a7c6bc1..0000000000000000000000000000000000000000
--- a/zh-cn/application-dev/reference/apis/js-apis-application-missionInfo.md
+++ /dev/null
@@ -1,28 +0,0 @@
-# MissionInfo
-
-> **说明：**
->
-> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-
-## 导入模块
-
-```js
-import MissionInfo from '@ohos.application.missionInfo'
-```
-
-## MissionInfo
-
-表示Ability对应任务信息的枚举。
-
-**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
-
-| 名称 | 参数类型 | 可读 | 可写 | 说明 |
-| -------- | -------- | -------- | -------- | -------- |
-| missionId | number | 是 | 是 | 表示任务ID。|
-| runningState | number | 是 | 是 | 表示运行状态。 |
-| lockedState | boolean | 是 | 是 | 表示锁定状态。 |
-| timestamp | string | 是 | 是 | 表示任务的最近创建或更新时间。 |
-| want | [Want](js-apis-application-Want.md) | 是 | 是 | 表示任务的Want信息。 |
-| label | string | 是 | 是 | 表示任务的标签。 |
-| iconPath | string | 是 | 是 | 表示任务的图标路径。 |
-| continuable | boolean | 是 | 是 | 表示任务是否可以继续。 |
diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-shellCmdResult.md b/zh-cn/application-dev/reference/apis/js-apis-application-shellCmdResult.md
index e3be6cf96986a83d26037c260310de701003cecc..18be172e57a68bca06c4d363b22704f4eb32fd39 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-application-shellCmdResult.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-application-shellCmdResult.md
@@ -1,5 +1,7 @@
# ShellCmdResult
+ShellCmdResult模块提供Shell命令执行结果的能力。
+
> **说明：**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-staticSubscriberExtensionAbility.md b/zh-cn/application-dev/reference/apis/js-apis-application-staticSubscriberExtensionAbility.md
index b2c2656a49c8dc902c0b03ccf90e264156516ded..ed6dfecf14feb85a9521dbca86171b44a837aea0 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-application-staticSubscriberExtensionAbility.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-application-staticSubscriberExtensionAbility.md
@@ -1,5 +1,7 @@
# StaticSubscriberExtensionAbility
+StaticSubscriberExtensionAbility模块提供静态订阅者扩展能力的类别的能力。
+
> **说明：**
>
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
@@ -16,7 +18,9 @@ onReceiveEvent(event: CommonEventData): void;
静态订阅者通用事件回调。
-**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**系统API**：该接口为系统接口，三方应用不支持调用。
**参数：**
diff --git a/zh-cn/application-dev/reference/apis/js-apis-appmanager.md b/zh-cn/application-dev/reference/apis/js-apis-appmanager.md
index e8e8dbb1a9c25e98f2e3d01b691a220c217de1f7..73327837e74c160d4627aab87b3edfb0339e9a81 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-appmanager.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-appmanager.md
@@ -1,21 +1,19 @@
# appManager
+appManager模块提供服务功能的能力，包括查询当前是否处于稳定性测试场景、查询是否为ram受限设备、获取应用程序的内存大小、获取有关运行进程的信息等。
+
> **说明：**
>
> 本模块首批接口从API version 7 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-
App管理。
-
## 导入模块
-
```js
import app from '@ohos.application.appManager';
```
-
## appManager.isRunningInStabilityTest8+
static isRunningInStabilityTest(callback: AsyncCallback<boolean>): void
@@ -165,6 +163,8 @@ getProcessRunningInfos(): Promise>;
获取有关运行进程的信息。
+**需要权限**：ohos.permission.GET_RUNNING_INFO
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**返回值：**
@@ -189,6 +189,8 @@ getProcessRunningInfos(callback: AsyncCallback>): voi
获取有关运行进程的信息。
+**需要权限**：ohos.permission.GET_RUNNING_INFO
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：**
@@ -212,7 +214,7 @@ getProcessRunningInfos(callback: AsyncCallback>): voi
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ |
-| pid8+ | 只读 | number | 否 | 进程ID。 |
-| uid8+ | 只读 | number | 否 | 用户ID。 |
-| processName8+ | 只读 | string | 否 | 进程的名称。 |
-| bundleNames8+ | 只读 | Array\ | 否 | 进程中运行的bundleName数组。 |
+| pid9+ | 只读 | number | 否 | 进程ID。 |
+| uid9+ | 只读 | number | 否 | 用户ID。 |
+| processName9+ | 只读 | string | 否 | 进程的名称。 |
+| bundleNames9+ | 只读 | Array\ | 否 | 进程中运行的bundleName数组。 |
diff --git a/zh-cn/application-dev/reference/apis/js-apis-configuration.md b/zh-cn/application-dev/reference/apis/js-apis-configuration.md
index 3ddc76ed7549b75e7e9712e403d01fec98618c9a..1889e753e1a868c5730c9f29e500b812fb11f64a 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-configuration.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-configuration.md
@@ -1,11 +1,11 @@
# Configuration
+Configuration模块提供环境变化信息的能力。
+
> **说明：**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-环境变化信息。
-
## 导入模块
```js
diff --git a/zh-cn/application-dev/reference/apis/js-apis-configurationconstant.md b/zh-cn/application-dev/reference/apis/js-apis-configurationconstant.md
index f5c6a9e41bfb7e6fd9b80753ecbda3fedb9ce0cb..32a553012a3193e32b1b26671472eda8b4d13a65 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-configurationconstant.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-configurationconstant.md
@@ -1,13 +1,11 @@
# ConfigurationConstant
+ConfigurationConstant模块提供配置信息枚举值定义的能力。
+
> **说明：**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-
-配置信息枚举值定义。
-
-
## 导入模块
@@ -15,7 +13,6 @@
import ConfigurationConstant from '@ohos.application.ConfigurationConstant';
```
-
## ConfigurationConstant.ColorMode
使用时通过ConfigurationConstant.ColorMode获取。
diff --git a/zh-cn/application-dev/reference/apis/js-apis-eventhub.md b/zh-cn/application-dev/reference/apis/js-apis-eventhub.md
index 4d96c6a111d5811ee60818412642015de29f7a07..276f5a7ec4dd740376a1b628df7ee48227f86760 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-eventhub.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-eventhub.md
@@ -1,12 +1,12 @@
# EventHub
+EventHub模块提供了事件中心，提供订阅、取消订阅、触发事件的能力。
+
> **说明：**
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
-事件中心，提供订阅、取消订阅、触发事件能力。
-
## 导入模块
```js
diff --git a/zh-cn/application-dev/reference/apis/js-apis-extension-context.md b/zh-cn/application-dev/reference/apis/js-apis-extension-context.md
index f016380d4a9e39ef069dcf3aa61d7616fdf9469b..3ee6646e61799bbc4276cfdf00c90831c3f73d2e 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-extension-context.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-extension-context.md
@@ -1,5 +1,9 @@
# ExtensionContext
+ExtensionContext是Extension的上下文环境，继承自Context。
+
+ExtensionContext模块提供扩展的上下文的能力，包括允许访问特定于扩展的资源。
+
> **说明：**
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
@@ -8,11 +12,8 @@
## 导入模块
```js
-import DataShareExtensionAbility from '@ohos.application.DataShareExtensionAbility';
+import FormExtension from '@ohos.application.FormExtension';
```
-## 使用说明
-
-Extension的上下文环境，继承自Context。
## 属性
diff --git a/zh-cn/application-dev/reference/apis/js-apis-extensionrunninginfo.md b/zh-cn/application-dev/reference/apis/js-apis-extensionrunninginfo.md
index f802192e4195340abb2c193cebef12d279754797..015ddd475088159a64a05e87170c56f8995877e3 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-extensionrunninginfo.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-extensionrunninginfo.md
@@ -1,10 +1,11 @@
# ExtensionRunningInfo
+ExtensionRunningInfo模块提供对Extension运行的相关信息和类型进行设置和查询的能力。
+
> **说明：**
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-Extension运行相关信息。
## 导入模块
@@ -37,24 +38,4 @@ abilitymanager.getExtensionRunningInfos(upperLimit, (err,data) => {
| processName | string | 是 | 否 | 进程名称。 |
| startTime | number | 是 | 否 | Extension启动时间。 |
| clientPackage | Array<String> | 是 | 否 | 表示当期进程下的所有包名。 |
-| type | [bundle.ExtensionAbilityType](#bundleextensionabilitytype) | 是 | 否 | Extension类型。 |
-
-
-## bundle.ExtensionAbilityType
-
-Extension类型。
-
-**系统能力**：以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
-
- | 名称 | 值 | 说明 |
-| -------- | -------- | -------- |
-| FORM | 0 | 表示带有form类型的扩展信息。< |
-| WORK_SCHEDULER | 1 | 表示带有work scheduler类型的扩展信息。< |
-| INPUT_METHOD | 2 | 表示用输入法类型的扩展信息。< |
-| SERVICE | 3 | 表示带有service类型的扩展信息。< |
-| ACCESSIBILITY | 4 | 表示具有可访问性类型的扩展信息。< |
-| DATA_SHARE | 5 | 表示带有datashare类型的扩展信息。< |
-| FILE_SHARE | 6 | 表示带有fileshare类型的扩展信息。< |
-| STATIC_SUBSCRIBER | 7 | 表示带有静态订阅者类型的扩展信息。< |
-| WALLPAPER | 8 | 表示带有wallpaper类型的扩展信息。< |
-| UNSPECIFIED | 9 | 表示未指定类型信息。< |
+| type | [bundle.ExtensionAbilityType](js-apis-Bundle.md#extensionabilitytype9) | 是 | 否 | Extension类型。 |
\ No newline at end of file
diff --git a/zh-cn/application-dev/reference/apis/js-apis-featureAbility.md b/zh-cn/application-dev/reference/apis/js-apis-featureAbility.md
index ef49388ff4dee302116be8f94bf54651a9d01b3f..749d2431d1748d499513d8b0b69bf49ec9af93f6 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-featureAbility.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-featureAbility.md
@@ -1,5 +1,7 @@
# FeatureAbility模块(JS端SDK接口)
+FeatureAbility模块提供带有UI设计与用户交互的能力，包括启动新的ability、获取dataAbilityHelper、设置此Page Ability、获取当前Ability对应的窗口，连接服务等。
+
> **说明：**
>
> 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
@@ -654,8 +656,10 @@ var connId = featureAbility.connectAbility(
},
);
-featureAbility.disconnectAbility(connId).then((error,data) => {
- console.log('featureAbilityTest result errCode : ' + error.code + " data: " + data);
+featureAbility.disconnectAbility(connId).then((data) => {
+ console.log('data : ' + data);
+}).catch((error)=>{
+ console.log('featureAbilityTest result errCode : ' + error.code);
});
```
@@ -914,7 +918,7 @@ featureAbility.AbilityStartSetting.BOUNDS_KEY
## StartAbilityParameter
-**系统能力**：以下各项对应的系统能力均为SystemCapability.AbilityRuntime.FAModel
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.FAModel
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ------------------- | ---- | -------------------- | ---- | -------------------------------------- |
diff --git a/zh-cn/application-dev/reference/apis/js-apis-formInfo.md b/zh-cn/application-dev/reference/apis/js-apis-formInfo.md
index 4279a5352bb1010c9e68e7124d93c4e33db04580..e8d857b2e2df72995164f0b47593c03e5c2c9700 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-formInfo.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-formInfo.md
@@ -1,11 +1,11 @@
# FormInfo
+FormInfo模块提供对卡片的相关卡片信息和状态进行设置和查询的能力。
+
> **说明：**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-卡片信息。
-
## 导入模块
```
@@ -20,98 +20,98 @@ import formInfo from '@ohos.application.formInfo';
卡片信息
-**系统能力：**
+**系统能力**：SystemCapability.Ability.Form
SystemCapability.Ability.Form
| 名称 | 读写属性 | 类型 | 描述 |
| ----------- | -------- | -------------------- | ------------------------------------------------------------ |
-| bundleName | 只读 | string | 表示卡片所属包的包名 |
-| moduleName | 只读 | string | 表示卡片所属模块的模块名 |
-| abilityName | 只读 | string | 表示卡片所属的Ability名称 |
-| name | 只读 | string | 表示卡片名称 |
-| description | 只读 | string | 表示卡片描述 |
-| type | 只读 | [FormType](#formtype) | 表示卡片类型，当前支持JS卡片 |
-| jsComponentName | 只读 | string | 表示js卡片的组件名 |
-| colorMode | 只读 | [ColorMode](#colormode) | 表示卡片颜色模式 |
-| isDefault | 只读 | boolean | 表示是否是默认卡片 |
-| updateEnabled | 只读 | boolean | 表示卡片是否使能更新 |
-| formVisibleNotify | 只读 | string | 表示卡片是否使能可见通知 |
-| relatedBundleName | 只读 | string | 表示卡片所属的相关联包名 |
-| scheduledUpdateTime | 只读 | string | 表示卡片更新时间 |
-| formConfigAbility | 只读 | string | 表示卡片配置ability |
-| updateDuration | 只读 | string | 表示卡片更新周期 |
+| bundleName | 只读 | string | 表示卡片所属包的包名。 |
+| moduleName | 只读 | string | 表示卡片所属模块的模块名。 |
+| abilityName | 只读 | string | 表示卡片所属的Ability名称。 |
+| name | 只读 | string | 表示卡片名称。 |
+| description | 只读 | string | 表示卡片描述。 |
+| type | 只读 | [FormType](#formtype) | 表示卡片类型，当前支持JS卡片。 |
+| jsComponentName | 只读 | string | 表示js卡片的组件名。 |
+| colorMode | 只读 | [ColorMode](#colormode) | 表示卡片颜色模式。 |
+| isDefault | 只读 | boolean | 表示是否是默认卡片。 |
+| updateEnabled | 只读 | boolean | 表示卡片是否使能更新。 |
+| formVisibleNotify | 只读 | string | 表示卡片是否使能可见通知。 |
+| relatedBundleName | 只读 | string | 表示卡片所属的相关联包名。 |
+| scheduledUpdateTime | 只读 | string | 表示卡片更新时间。 |
+| formConfigAbility | 只读 | string | 表示卡片配置ability。 |
+| updateDuration | 只读 | string | 表示卡片更新周期。 |
| defaultDimension | 只读 | number | 表示卡片规格 |
-| supportDimensions | 只读 | Array<number> | 表示卡片支持的规格 |
-| customizeData | 只读 | {[key: string]: [value: string]} | 表示卡片用户数据 |
+| supportDimensions | 只读 | Array<number> | 表示卡片支持的规格。 |
+| customizeData | 只读 | {[key: string]: [value: string]} | 表示卡片用户数据。 |
## FormType
枚举，支持的卡片类型。
-**系统能力：**
+**系统能力**：SystemCapability.Ability.Form
SystemCapability.Ability.Form
| 名称 | 值 | 说明 |
| ----------- | ---- | ------------ |
-| JS | 1 | 卡片类型为JS |
+| JS | 1 | 卡片类型为JS。 |
## ColorMode
枚举，卡片支持的颜色模式。
-**系统能力：**
+**系统能力**：SystemCapability.Ability.Form
SystemCapability.Ability.Form
| 名称 | 值 | 说明 |
| ----------- | ---- | ------------ |
-| MODE_AUTO | -1 | 自动模式 |
-| MODE_DARK | 0 | 暗色 |
-| MODE_LIGHT | 1 | 亮色 |
+| MODE_AUTO | -1 | 自动模式。 |
+| MODE_DARK | 0 | 暗色。 |
+| MODE_LIGHT | 1 | 亮色。 |
## FormStateInfo
卡片状态信息。
-**系统能力：**
+**系统能力**：SystemCapability.Ability.Form
SystemCapability.Ability.Form
| 名称 | 读写属性 | 类型 | 描述 |
| ----------- | -------- | -------------------- | ------------------------------------------------------------ |
-| formState | 只读 | [FormState](#formstate) | 表示卡片状态 |
-| want | 只读 | Want | Want文本内容 |
+| formState | 只读 | [FormState](#formstate) | 表示卡片状态。 |
+| want | 只读 | Want | Want文本内容。 |
## FormState
枚举，卡片状态。
-**系统能力：**
+**系统能力**：SystemCapability.Ability.Form
SystemCapability.Ability.Form
| 名称 | 值 | 说明 |
| ----------- | ---- | ------------ |
-| UNKNOWN | -1 | 未知状态 |
-| DEFAULT | 0 | 默认状态 |
-| READY | 1 | 就绪状态 |
+| UNKNOWN | -1 | 未知状态。 |
+| DEFAULT | 0 | 默认状态。 |
+| READY | 1 | 就绪状态。 |
## FormParam
枚举，卡片参数。
-**系统能力：**
+**系统能力**：SystemCapability.Ability.Form
SystemCapability.Ability.Form
| 名称 | 值 | 说明 |
| ----------- | ---- | ------------ |
-| IDENTITY_KEY | "ohos.extra.param.key.form_identity" | 卡片标识 |
-| DIMENSION_KEY | "ohos.extra.param.key.form_dimension" | 卡片规格样式 |
-| NAME_KEY | "ohos.extra.param.key.form_name" | 卡片名称 |
-| MODULE_NAME_KEY | "ohos.extra.param.key.module_name" | 卡片所属模块名称 |
-| WIDTH_KEY | "ohos.extra.param.key.form_width" | 卡片宽度 |
-| HEIGHT_KEY | "ohos.extra.param.key.form_height" | 卡片高度 |
-| TEMPORARY_KEY | "ohos.extra.param.key.form_temporary" | 临时卡片 |
\ No newline at end of file
+| IDENTITY_KEY | "ohos.extra.param.key.form_identity" | 卡片标识。
**系统API**: 此接口为系统接口，三方应用不支持调用。 |
+| DIMENSION_KEY | "ohos.extra.param.key.form_dimension" | 卡片规格样式。 |
+| NAME_KEY | "ohos.extra.param.key.form_name" | 卡片名称。 |
+| MODULE_NAME_KEY | "ohos.extra.param.key.module_name" | 卡片所属模块名称。 |
+| WIDTH_KEY | "ohos.extra.param.key.form_width" | 卡片宽度。 |
+| HEIGHT_KEY | "ohos.extra.param.key.form_height" | 卡片高度。 |
+| TEMPORARY_KEY | "ohos.extra.param.key.form_temporary" | 临时卡片。 |
\ No newline at end of file
diff --git a/zh-cn/application-dev/reference/apis/js-apis-formbindingdata.md b/zh-cn/application-dev/reference/apis/js-apis-formbindingdata.md
index 95a6f2ff0661b5923688423c19012e8b4583e7fd..1d4badb7a5d77b04e3ad598f88757973ce34570d 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-formbindingdata.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-formbindingdata.md
@@ -1,5 +1,7 @@
# 卡片数据绑定类
+卡片数据绑定模块提供卡片数据绑定的能力。包括FormBindingData对象的创建、相关信息的描述。
+
> **说明：**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
diff --git a/zh-cn/application-dev/reference/apis/js-apis-formerror.md b/zh-cn/application-dev/reference/apis/js-apis-formerror.md
index cecf53ce067782513385c8796d0b000a7583954b..cc9e3ac84012182c628fa36a2f78358a883caf95 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-formerror.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-formerror.md
@@ -1,11 +1,11 @@
# FormError
+FormError模块提供获取卡片错误码的能力。
+
> **说明：**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-卡片错误码。
-
## 导入模块
```
diff --git a/zh-cn/application-dev/reference/apis/js-apis-formextension.md b/zh-cn/application-dev/reference/apis/js-apis-formextension.md
index 605bd97e8c4412f5b1b717daa71b3f5ad102a998..6ebe0ec6f64b981208c6c6be9bdc196c7d0f0324 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-formextension.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-formextension.md
@@ -1,12 +1,12 @@
# FormExtension
+FormExtension模块提供了FormExtension卡片扩展相关接口。
+
> **说明：**
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
-提供FormExtension卡片扩展相关接口。
-
## 导入模块
```
@@ -242,11 +242,11 @@ onAcquireFormState?(want: Want): formInfo.FormState;
**示例：**
```js
- import fromInfo from '@ohos.application.fromInfo'
+ import formInfo from '@ohos.application.formInfo'
class MyFormExtension extends FormExtension {
onAcquireFormState(want) {
console.log('FormExtension onAcquireFormState, want:' + want);
- return fromInfo.FormState.UNKNOWN;
+ return formInfo.FormState.UNKNOWN;
}
}
```
\ No newline at end of file
diff --git a/zh-cn/application-dev/reference/apis/js-apis-formextensioncontext.md b/zh-cn/application-dev/reference/apis/js-apis-formextensioncontext.md
index 1db36f4ca72447df43954b9c0989e671738fc4c2..fe4eb89ce3fae06af85c16a82ef2270b2fc3a88f 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-formextensioncontext.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-formextensioncontext.md
@@ -1,12 +1,14 @@
# FormExtensionContext
+FormExtensionContext模块是FormExtension的上下文环境，继承自ExtensionContext。
+
+FormExtensionContext模块提供FormExtension具有的接口和能力。
+
> **说明：**
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
-FormExtension的上下文环境，提供FormExtension具有的能力和接口，继承自ExtensionContext。
-
## 导入模块
```js
diff --git a/zh-cn/application-dev/reference/apis/js-apis-formhost.md b/zh-cn/application-dev/reference/apis/js-apis-formhost.md
index 38e45005acd3fe80a89e2f88ae79fd7a40df8cf9..8ba53b77d3e2975edf6d6f63a00e0df38b3ae26f 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-formhost.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-formhost.md
@@ -1,11 +1,11 @@
# FormHost
+FormHost模块提供了卡片使用方相关接口的能力，包括删除、释放、请求更新卡片，发送通知到指定卡片，获取卡片信息、状态等。
+
> **说明：**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-卡片使用方相关接口。
-
## 导入模块
```
@@ -24,9 +24,11 @@ deleteForm(formId: string, callback: AsyncCallback<void>): void;
删除指定的卡片。调用此方法后，应用程序将无法使用该卡片，卡片管理器服务不再保留有关该卡片的信息。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
+
+**系统能力**：SystemCapability.Ability.Form
-SystemCapability.Ability.Form
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -52,9 +54,11 @@ deleteForm(formId: string): Promise<void>;
删除指定的卡片。调用此方法后，应用程序将无法使用该卡片，卡片管理器服务不再保留有关该卡片的信息。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
-SystemCapability.Ability.Form
+**系统能力**：SystemCapability.Ability.Form
+
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -85,9 +89,11 @@ releaseForm(formId: string, callback: AsyncCallback<void>): void;
释放指定的卡片。调用此方法后，应用程序将无法使用该卡片，但卡片管理器服务仍然保留有关该卡片的缓存信息和存储信息。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
+
+**系统能力**：SystemCapability.Ability.Form
-SystemCapability.Ability.Form
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -113,9 +119,11 @@ releaseForm(formId: string, isReleaseCache: boolean, callback: AsyncCallback<
释放指定的卡片。调用此方法后，应用程序将无法使用该卡片，卡片管理器服务保留有关该卡片的存储信息，可以选择是否保留缓存信息。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
-SystemCapability.Ability.Form
+**系统能力**：SystemCapability.Ability.Form
+
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -142,9 +150,11 @@ releaseForm(formId: string, isReleaseCache?: boolean): Promise<void>;
释放指定的卡片。调用此方法后，应用程序将无法使用该卡片，卡片管理器服务保留有关该卡片的存储信息，可以选择是否保留缓存信息。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
+
+**系统能力**：SystemCapability.Ability.Form
-SystemCapability.Ability.Form
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -176,9 +186,11 @@ requestForm(formId: string, callback: AsyncCallback<void>): void;
请求卡片更新。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
-SystemCapability.Ability.Form
+**系统能力**：SystemCapability.Ability.Form
+
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -204,9 +216,11 @@ requestForm(formId: string): Promise<void>;
请求卡片更新。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
+
+**系统能力**：SystemCapability.Ability.Form
-SystemCapability.Ability.Form
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -237,9 +251,11 @@ castTempForm(formId: string, callback: AsyncCallback<void>): void;
将指定的临时卡片转换为普通卡片。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
-SystemCapability.Ability.Form
+**系统能力**：SystemCapability.Ability.Form
+
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -265,9 +281,11 @@ castTempForm(formId: string): Promise<void>;
将指定的临时卡片转换为普通卡片。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
+
+**系统能力**：SystemCapability.Ability.Form
-SystemCapability.Ability.Form
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -298,9 +316,11 @@ notifyVisibleForms(formIds: Array<string>, callback: AsyncCallback<void
向卡片框架发送通知以使指定的卡片可见。该方法调用成功后，会调用onVisibilityChange通知卡片提供方。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
+
+**系统能力**：SystemCapability.Ability.Form
-SystemCapability.Ability.Form
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -326,9 +346,11 @@ notifyVisibleForms(formIds: Array<string>): Promise<void>;
向卡片框架发送通知以使指定的卡片可见。该方法调用成功后，会调用onVisibilityChange通知卡片提供方。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
-SystemCapability.Ability.Form
+**系统能力**：SystemCapability.Ability.Form
+
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -359,9 +381,11 @@ notifyInvisibleForms(formIds: Array<string>, callback: AsyncCallback<vo
向卡片框架发送通知以使指定的卡片不可见。该方法调用成功后，会调用onVisibilityChange通知卡片提供方。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
+
+**系统能力**：SystemCapability.Ability.Form
-SystemCapability.Ability.Form
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -387,9 +411,11 @@ notifyInvisibleForms(formIds: Array<string>): Promise<void>;
向卡片框架发送通知以使指定的卡片不可见。该方法调用成功后，会调用onVisibilityChange通知卡片提供方。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
-SystemCapability.Ability.Form
+**系统能力**：SystemCapability.Ability.Form
+
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -420,9 +446,11 @@ enableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void&
向卡片框架发送通知以使指定的卡片可以更新。该方法调用成功后，卡片刷新状态设置为使能，卡片可以接收来自卡片提供方的更新。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
+
+**系统能力**：SystemCapability.Ability.Form
-SystemCapability.Ability.Form
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -448,9 +476,11 @@ enableFormsUpdate(formIds: Array<string>): Promise<void>;
向卡片框架发送通知以使指定的卡片可以更新。该方法调用成功后，卡片刷新状态设置为使能，卡片可以接收来自卡片提供方的更新。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
-SystemCapability.Ability.Form
+**系统能力**：SystemCapability.Ability.Form
+
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -481,9 +511,11 @@ disableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void
向卡片框架发送通知以使指定的卡片不可以更新。该方法调用成功后，卡片刷新状态设置为去使能，卡片不可以接收来自卡片提供方的更新。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
+
+**系统能力**：SystemCapability.Ability.Form
-SystemCapability.Ability.Form
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -509,9 +541,11 @@ disableFormsUpdate(formIds: Array<string>): Promise<void>;
向卡片框架发送通知以使指定的卡片不可以更新。该方法调用成功后，卡片刷新状态设置为去使能，卡片不可以接收来自卡片提供方的更新。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
-SystemCapability.Ability.Form
+**系统能力**：SystemCapability.Ability.Form
+
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -542,9 +576,9 @@ isSystemReady(callback: AsyncCallback<void>): void;
检查系统是否准备好。
-**系统能力：**
+**系统能力**：SystemCapability.Ability.Form
-SystemCapability.Ability.Form
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -569,9 +603,9 @@ isSystemReady(): Promise<void>;
检查系统是否准备好。
-**系统能力：**
+**系统能力**：SystemCapability.Ability.Form
-SystemCapability.Ability.Form
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**返回值：**
@@ -596,9 +630,11 @@ getAllFormsInfo(callback: AsyncCallback<Array<formInfo.FormInfo>>):
获取设备上所有应用提供的卡片信息。
-**系统能力：**
+**需要权限**：ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
+
+**系统能力**：SystemCapability.Ability.Form
-SystemCapability.Ability.Form
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -625,9 +661,11 @@ getAllFormsInfo(): Promise<Array<formInfo.FormInfo>>;
获取设备上所有应用提供的卡片信息。
-**系统能力：**
+**需要权限**：ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
+
+**系统能力**：SystemCapability.Ability.Form
-SystemCapability.Ability.Form
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**返回值：**
@@ -652,9 +690,11 @@ getFormsInfo(bundleName: string, callback: AsyncCallback<Array<formInfo.Fo
获取设备上指定应用程序提供的卡片信息。
-**系统能力：**
+**需要权限**：ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
-SystemCapability.Ability.Form
+**系统能力**：SystemCapability.Ability.Form
+
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -682,9 +722,11 @@ getFormsInfo(bundleName: string, moduleName: string, callback: AsyncCallback<
获取设备上指定应用程序提供的卡片信息。
-**系统能力：**
+**需要权限**：ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
+
+**系统能力**：SystemCapability.Ability.Form
-SystemCapability.Ability.Form
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -713,9 +755,11 @@ getFormsInfo(bundleName: string, moduleName?: string): Promise<Array<formI
获取设备上指定应用程序提供的卡片信息。
-**系统能力：**
+**需要权限**：ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
-SystemCapability.Ability.Form
+**系统能力**：SystemCapability.Ability.Form
+
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -746,9 +790,11 @@ deleteInvalidForms(formIds: Array<string>, callback: AsyncCallback<numb
根据列表删除应用程序的无效卡片。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
+
+**系统能力**：SystemCapability.Ability.Form
-SystemCapability.Ability.Form
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -776,9 +822,11 @@ deleteInvalidForms(formIds: Array<string>): Promise<number>;
根据列表删除应用程序的无效卡片。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
-SystemCapability.Ability.Form
+**系统能力**：SystemCapability.Ability.Form
+
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -809,9 +857,11 @@ acquireFormState(want: Want, callback: AsyncCallback<formInfo.FormStateInfo&g
获取卡片状态
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM和ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
+
+**系统能力**：SystemCapability.Ability.Form
-SystemCapability.Ability.Form
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -843,6 +893,12 @@ acquireFormState(want: Want): Promise<formInfo.FormStateInfo>;
获取卡片状态。
+**需要权限**：ohos.permission.REQUIRE_FORM
+
+**系统能力**：SystemCapability.Ability.Form
+
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -855,10 +911,6 @@ acquireFormState(want: Want): Promise<formInfo.FormStateInfo>;
| :------------ | :---------------------------------- |
| Promise<[FormStateInfo](js-apis-formInfo.md#formstateinfo)> | Promise实例，用于返回卡片状态 |
-**系统能力：**
-
-SystemCapability.Ability.Form
-
**示例：**
```js
@@ -880,9 +932,9 @@ on(type: "formUninstall", callback: Callback<string>): void;
订阅卡片卸载事件。
-**系统能力：**
+**系统能力**：SystemCapability.Ability.Form
-SystemCapability.Ability.Form
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -906,9 +958,9 @@ off(type: "formUninstall", callback?: Callback<string>): void;
取消订阅卡片卸载事件。
-**系统能力：**
+**系统能力**：SystemCapability.Ability.Form
-SystemCapability.Ability.Form
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -932,9 +984,11 @@ notifyFormsVisible(formIds: Array<string>, isVisible: boolean, callback: A
通知卡片是否可见。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
-SystemCapability.Ability.Form
+**系统能力**：SystemCapability.Ability.Form
+
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -961,9 +1015,11 @@ notifyFormsVisible(formIds: Array<string>, isVisible: boolean): Promise<
通知卡片是否可见。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
+
+**系统能力**：SystemCapability.Ability.Form
-SystemCapability.Ability.Form
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -995,9 +1051,11 @@ notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean, c
通知卡片是否启用更新状态。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
-SystemCapability.Ability.Form
+**系统能力**：SystemCapability.Ability.Form
+
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
@@ -1024,9 +1082,11 @@ notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean):
通知卡片是否启用更新状态。
-**系统能力：**
+**需要权限**：ohos.permission.REQUIRE_FORM
+
+**系统能力**：SystemCapability.Ability.Form
-SystemCapability.Ability.Form
+**系统API**: 此接口为系统接口，三方应用不支持调用。
**参数：**
diff --git a/zh-cn/application-dev/reference/apis/js-apis-formprovider.md b/zh-cn/application-dev/reference/apis/js-apis-formprovider.md
index 20a1e119becb1f27fee81aa3fbde57758e9fb417..473efe7ecf741f616a7967512b844083ea56a019 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-formprovider.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-formprovider.md
@@ -1,11 +1,11 @@
# FormProvider
+FormProvider模块提供了卡片提供方相关接口的能力，包括更新卡片，设置卡片更新时间，获取卡片信息，请求发布卡片等。
+
> **说明：**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-卡片提供方相关接口。
-
## 导入模块
```
diff --git a/zh-cn/application-dev/reference/apis/js-apis-missionManager.md b/zh-cn/application-dev/reference/apis/js-apis-missionManager.md
index b665f7c777b55b9d96fdda2449d55454270dc297..06738b4d53b109bbff1da33447a20ae6c71d24fd 100755
--- a/zh-cn/application-dev/reference/apis/js-apis-missionManager.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-missionManager.md
@@ -1,12 +1,11 @@
# missionManager
+missionManager模块提供系统任务管理能力，包括对系统任务执行锁定、解锁、清理、切换到前台等操作。
> **说明：**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-missionManager模块提供系统任务管理能力，开发者可以对系统任务执行锁定、解锁、清理、切换到前台等操作。
-
## 导入模块
```
@@ -23,8 +22,12 @@ registerMissionListener(listener: MissionListener): number;
注册系统任务状态监听。
+**需要权限**：ohos.permission.MANAGE_MISSIONS
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -59,8 +62,12 @@ unregisterMissionListener(listenerId: number, callback: AsyncCallback<void>
取消任务状态监听。
+**需要权限**：ohos.permission.MANAGE_MISSIONS
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -93,8 +100,12 @@ unregisterMissionListener(listenerId: number): Promise<void>;
取消任务状态监听，以promise方式返回执行结果。
+**需要权限**：ohos.permission.MANAGE_MISSIONS
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -132,8 +143,12 @@ getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback<M
获取任务信息，以异步回调的方式返回任务信息。
+**需要权限**：ohos.permission.MANAGE_MISSIONS
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -166,8 +181,12 @@ getMissionInfo(deviceId: string, missionId: number): Promise<MissionInfo>;
获取任务信息，以promise方式返回任务信息。
+**需要权限**：ohos.permission.MANAGE_MISSIONS
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -198,8 +217,12 @@ getMissionInfos(deviceId: string, numMax: number, callback: AsyncCallback<Arr
获取所有任务信息，以回调函数的方式返回任务信息数组。
+**需要权限**：ohos.permission.MANAGE_MISSIONS
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -227,8 +250,12 @@ getMissionInfos(deviceId: string, numMax: number): Promise<Array<MissionIn
获取所有任务信息，以promise的方式返回任务信息数组。
+**需要权限**：ohos.permission.MANAGE_MISSIONS
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -259,8 +286,12 @@ getMissionSnapShot(deviceId: string, missionId: number, callback: AsyncCallback&
获取任务快照，以回调函数的方式返回快照内容。
+**需要权限**：ohos.permission.MANAGE_MISSIONS
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -294,8 +325,12 @@ getMissionSnapShot(deviceId: string, missionId: number): Promise<MissionSnaps
获取任务快照，以promise的方式返回快照内容。
+**需要权限**：ohos.permission.MANAGE_MISSIONS
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -334,8 +369,12 @@ lockMission(missionId: number, callback: AsyncCallback<void>): void;
锁定指定任务id的任务，以回调函数的方式返回。
+**需要权限**：ohos.permission.MANAGE_MISSIONS
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -367,8 +406,12 @@ lockMission(missionId: number): Promise<void>;
锁定指定任务id的任务，以promise方式返回。
+**需要权限**：ohos.permission.MANAGE_MISSIONS
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -405,8 +448,12 @@ unlockMission(missionId: number, callback: AsyncCallback<void>): void;
解锁指定任务id的任务，以回调函数的方式返回。
+**需要权限**：ohos.permission.MANAGE_MISSIONS
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -438,8 +485,12 @@ unlockMission(missionId: number): Promise<void>;
解锁指定任务id的任务，以promise的方式返回。
+**需要权限**：ohos.permission.MANAGE_MISSIONS
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -480,8 +531,12 @@ clearMission(missionId: number, callback: AsyncCallback<void>): void;
清理指定任务id的任务，无论该任务是否被锁定，以回调函数的方式返回。
+**需要权限**：ohos.permission.MANAGE_MISSIONS
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -513,8 +568,12 @@ clearMission(missionId: number): Promise<void>;
清理指定任务id的任务，无论该任务是否被锁定，以promise的方式返回。
+**需要权限**：ohos.permission.MANAGE_MISSIONS
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -552,8 +611,12 @@ clearAllMissions(callback: AsyncCallback<void>): void;
清理所有未锁定的任务，以回调函数的方式返回。
+**需要权限**：ohos.permission.MANAGE_MISSIONS
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**示例：**
```js
@@ -571,8 +634,12 @@ clearAllMissions(): Promise<void>;
清理所有未锁定的任务，以promise的方式返回。
+**需要权限**：ohos.permission.MANAGE_MISSIONS
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**返回值：**
| 类型 | 说明 |
@@ -595,8 +662,12 @@ moveMissionToFront(missionId: number, callback: AsyncCallback<void>): void
把指定任务id的任务切到前台，以回调函数的方式返回。
+**需要权限**：ohos.permission.MANAGE_MISSIONS
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -628,8 +699,12 @@ moveMissionToFront(missionId: number, options: StartOptions, callback: AsyncCall
把指定任务id的任务切到前台，同时指定任务切换到前台时的启动参数，例如窗口模式、设备ID等，以回调函数的方式返回。
+**需要权限**：ohos.permission.MANAGE_MISSIONS
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -662,8 +737,12 @@ moveMissionToFront(missionId: number, options?: StartOptions): Promise<void&g
把指定任务id的任务切到前台，同时指定任务切换到前台时的启动参数，例如窗口模式、设备ID等，以promise的方式返回。
+**需要权限**：ohos.permission.MANAGE_MISSIONS
+
**系统能力**：SystemCapability.Ability.AbilityRuntime.Mission
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -699,7 +778,9 @@ moveMissionToFront(missionId: number, options?: StartOptions): Promise<void&g
表示Ability对应任务信息的枚举。
-**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Mission
+
+**系统API**: 此接口为系统接口，三方应用不支持调用。
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
diff --git a/zh-cn/application-dev/reference/apis/js-apis-particleAbility.md b/zh-cn/application-dev/reference/apis/js-apis-particleAbility.md
index 5d9e82cd85d048774dfc3936326f83a587ccb38b..bfea0a61c68f384b4317ff43d4a7e60b81c3ea6d 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-particleAbility.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-particleAbility.md
@@ -1,5 +1,7 @@
# particleAbility模块
+particleAbility模块提供了Service类型Ability的能力，包括启动、停止指定的particleAbility，获取dataAbilityHelper，连接、断开当前Ability与指定ServiceAbility等。
+
> **说明：**
>
> 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
diff --git a/zh-cn/application-dev/reference/apis/js-apis-permissionrequestresult.md b/zh-cn/application-dev/reference/apis/js-apis-permissionrequestresult.md
index 502dd07c5a400bf21f5bfb8ed571bb800d1708e5..47ab7b437fe78dcd281968c1a4232e09448221d6 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-permissionrequestresult.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-permissionrequestresult.md
@@ -1,12 +1,12 @@
# PermissionRequestResult
+PermissionRequestResult模块提供了权限请求结果的能力。
+
> **说明：**
>
-> 本模块首批接口从API 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
-权限请求结果。
-
## 导入模块
```js
diff --git a/zh-cn/application-dev/reference/apis/js-apis-processrunninginfo.md b/zh-cn/application-dev/reference/apis/js-apis-processrunninginfo.md
index 875f6a46e79b839e190fd5bbd3af64401b79c99c..52d89a799d5dfec2d4291cc35e50545cfc9274ef 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-processrunninginfo.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-processrunninginfo.md
@@ -1,11 +1,11 @@
# ProcessRunningInfo
+ProcessRunningInfo模块提供对进程运行信息进行设置和查询的能力。
+
> **说明：**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-进程运行信息。
-
## 导入模块
```js
diff --git a/zh-cn/application-dev/reference/apis/js-apis-service-extension-ability.md b/zh-cn/application-dev/reference/apis/js-apis-service-extension-ability.md
index 8a7764105438e28fd577567542c857dc4b5ff1ca..ea3d2a2db301f5c1e951539ff08bbcbf51890c03 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-service-extension-ability.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-service-extension-ability.md
@@ -1,12 +1,12 @@
# ServiceExtensionAbility
+ServiceExtensionAbility模块提供ServiceExtension服务扩展相关接口的能力。
+
> **说明：**
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
-提供ServiceExtension服务扩展相关接口。
-
## 导入模块
```
@@ -21,6 +21,8 @@ import ServiceExtension from '@ohos.application.ServiceExtensionAbility';
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| context | [ServiceExtensionContext](js-apis-service-extension-context.md) | 是 | 否 | ServiceExtension的上下文环境，继承自ExtensionContext。 |
@@ -34,6 +36,8 @@ Extension生命周期回调，在创建时回调，执行初始化业务逻辑
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -59,6 +63,8 @@ Extension生命周期回调，在销毁时回调，执行资源清理等操作
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**示例：**
```js
@@ -78,6 +84,8 @@ Extension生命周期回调，如果是startAbility拉起的服务，会在onCre
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -104,6 +112,8 @@ Extension生命周期回调，如果是connectAbility拉起的服务，会在onC
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -144,6 +154,34 @@ Extension的生命周期，断开服务连接时回调。
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | want |[Want](js-apis-application-Want.md)| 是 | 当前Extension相关的Want类型信息，包括ability名称、bundle名称等。 |
+
+**示例：**
+
+ ```js
+ class ServiceExt extends ServiceExtension {
+ onDisconnect(want) {
+ console.log('onDisconnect, want:' + want.abilityName);
+ }
+ }
+ ```
+
+## ServiceExtensionAbility.onReconnect
+
+onReconnect(want: Want): void;
+
+当新客户端在所有以前的客户端连接之后尝试连接到服务扩展时调用
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -159,3 +197,51 @@ Extension的生命周期，断开服务连接时回调。
}
}
```
+
+## ServiceExtensionAbility.onReconnect
+
+onConfigurationUpdated(config: Configuration): void;
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | config | [Configuration](js-apis-configuration.md) | 是 | 表示需要更新的配置信息。 |
+
+**示例：**
+
+ ```js
+ class myAbility extends Ability {
+ onConfigurationUpdated(config) {
+ console.log('onConfigurationUpdated, config:' + JSON.stringify(config));
+ }
+ }
+ ```
+
+## ServiceExtensionAbility.dump
+
+dump(params: Array\): Array\;
+
+转储客户端信息时调用。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**参数：**
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------- | -------- | -------- |
+ | params | Array\ | 是 | 表示命令形式的参数。|
+
+**示例：**
+
+ ```js
+ class myAbility extends Ability {
+ dump(params) {
+ console.log('dump, params:' + JSON.stringify(params));
+ return ["params"]
+ }
+ }
+ ```
+
diff --git a/zh-cn/application-dev/reference/apis/js-apis-service-extension-context.md b/zh-cn/application-dev/reference/apis/js-apis-service-extension-context.md
index cbcaa18cdaa9ef1dcb6df2d0c96414a984fc570c..9fb036aae8215ce1177a817dd813b11a6d80157e 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-service-extension-context.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-service-extension-context.md
@@ -1,12 +1,14 @@
# ServiceExtensionContext
+ServiceExtensionContext模块是ServiceExtension的上下文环境，继承自ExtensionContext。
+
+ServiceExtensionContext模块提供ServiceExtension具有的能力和接口，包括启动、停止、绑定、解绑Ability。
+
> **说明：**
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
-ServiceExtension的上下文环境，提供ServiceExtension具有的能力和接口，继承自ExtensionContext。
-
## 导入模块
```
@@ -21,6 +23,8 @@ startAbility(want: Want, callback: AsyncCallback<void>): void;
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -54,6 +58,8 @@ startAbility(want: Want): Promise<void>;
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -96,6 +102,8 @@ terminateSelf(callback: AsyncCallback<void>): void;
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -126,6 +134,8 @@ terminateSelf(): Promise<void>;
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**返回值：**
| 类型 | 说明 |
@@ -157,6 +167,8 @@ connectAbility(want: Want, options: ConnectOptions): number;
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -194,6 +206,8 @@ disconnectAbility(connection: number, callback:AsyncCallback<void>): void;
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -227,6 +241,8 @@ disconnectAbility(connection: number): Promise<void>;
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
diff --git a/zh-cn/application-dev/reference/apis/js-apis-testRunner.md b/zh-cn/application-dev/reference/apis/js-apis-testRunner.md
index c64f36dd94e573cba35ca107b096c70e9e61f7f1..16af31809b99bb5c82fda82a5e44267ec07fd553 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-testRunner.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-testRunner.md
@@ -1,5 +1,9 @@
# TestRunner
+TestRunner模块提供了框架测试的能力。包括准备单元测试环境、运行测试用例。
+
+如果您想实现自己的单元测试框架，您必须继承这个类并覆盖它的所有方法。
+
> **说明：**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
@@ -23,10 +27,11 @@ onPrepare(): void
**示例：**
```js
-export default class UserTestRunner extends TestRunner {
+export default class UserTestRunner implements TestRunner {
onPrepare() {
console.log("Trigger onPrepare")
}
+onRun(){}
};
```
@@ -43,9 +48,10 @@ onRun(): void
**示例：**
```js
-export default class UserTestRunner extends TestRunner {
- onRun() {
- console.log("Trigger onRun")
+export default class UserTestRunner implements TestRunner {
+ onPrepare() {
+ console.log("Trigger onRun")
}
+onRun(){}
};
```
diff --git a/zh-cn/application-dev/reference/apis/js-apis-uripermissionmanager.md b/zh-cn/application-dev/reference/apis/js-apis-uripermissionmanager.md
index a0da3c65eae02e562987f1a32ad28d33763ddbe7..c1691d1baee58caadd4794e1c88e5de6b82b3c03 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-uripermissionmanager.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-uripermissionmanager.md
@@ -1,13 +1,12 @@
# uriPermissionManager
+uriPermissionManager模块提供了Uri权限管理的能力。
+
> **说明：**
>
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-Uri权限管理。
-
-
## 导入模块
@@ -77,7 +76,7 @@ SystemCapability.Ability.AbilityRuntime.Core
import WantConstant from '@ohos.ability.wantConstant';
let accessTokenId =1
let uri = "fileshare:///com.samples.filesharetest.FileShare/person/10"
- UriPermissionManager.verifyUriPermission(uri, wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION, accessTokenId)
+ UriPermissionManager.verifyUriPermission(uri, WantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION, accessTokenId)
.then((data) => {
console.log('Verification succeeded.' + data)
}).catch((error) => {
diff --git a/zh-cn/application-dev/reference/apis/js-apis-wantAgent.md b/zh-cn/application-dev/reference/apis/js-apis-wantAgent.md
index 2f2bf6dfedcee2b7307cefd15ff50ae143983d8d..46a353349ba17c04abf596df95b49563ccb74eed 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-wantAgent.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-wantAgent.md
@@ -1,5 +1,7 @@
# WantAgent模块
+WantAgent模块提供了触发、取消、比较WantAgent实例和获取bundle名称的能力，包括创建WantAgent实例、获取实例的用户ID、获取want信息等。
+
> **说明：**
>
> 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
@@ -418,6 +420,8 @@ getWant(agent: WantAgent, callback: AsyncCallback\): void
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
@@ -490,6 +494,8 @@ getWant(agent: WantAgent): Promise\
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
+**系统API**: 此接口为系统接口，三方应用不支持调用。
+
**参数：**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |