!17664 翻译完成：17487+17415+17295+16711 ability-deprecated文件夹更新

Merge pull request !17664 from wusongqing/TR17487

en/application-dev/ability-deprecated/ability-delegator.md

@@ -63,7 +63,7 @@ For details about how to use DevEco Studio to start the test framework, see [Ope
 **Example**
 
 ```javascript
-import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
+import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'
 
 function onAbilityCreateCallback(data) {
     console.info("onAbilityCreateCallback");
@@ -87,11 +87,11 @@ abilityDelegator.addAbilityMonitor(monitor).then(() => {
 **Modules to Import**
 
 ```javascript
-import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
+import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'
 ```
 
 ```javascript
-var abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
+var abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator()
 ```
 
 ### Starting an Ability and Listening for the Ability State

en/application-dev/ability-deprecated/fa-dataability.md

@@ -154,7 +154,7 @@ The basic dependency packages include:
    import featureAbility from '@ohos.ability.featureAbility'
    import ohos_data_ability from '@ohos.data.dataAbility'
    import ohos_data_rdb from '@ohos.data.rdb'
-
+   
    var urivar = "dataability:///com.ix.DataAbility"
    var DAHelper = featureAbility.acquireDataAbilityHelper(
     urivar

en/application-dev/ability-deprecated/fa-formability.md

@@ -25,7 +25,7 @@ Carry out the following operations to develop the widget provider based on the [
 1. Implement lifecycle callbacks by using the **LifecycleForm** APIs.
 2. Create a **FormBindingData** instance.
 3. Update a widget by using the **FormProvider** APIs.
-4. Develop the widget UI pages.
+4. Develop the widget UI page.
 
 ## Available APIs
 
@@ -231,7 +231,7 @@ You should override **onDestroy** to implement widget data deletion.
        }
 ```
 
-For details about how to implement persistent data storage, see [Lightweight Data Store Development](../database/database-preference-guidelines.md).
+For details about how to implement persistent data storage, see [Data Persistence by User Preferences](../database/data-persistence-by-preferences.md).
 
 The **Want** object passed in by the widget host to the widget provider contains a flag that specifies whether the requested widget is normal or temporary.
 
@@ -402,3 +402,5 @@ The code snippet is as follows:
      }
    }
    ```
+
+ <!--no_check--> 
\ No newline at end of file

en/application-dev/ability-deprecated/fa-pageability.md

@@ -47,7 +47,7 @@ You can specify the launch type by setting **launchType** in the **config.json**
 
 | Launch Type    | Description    |Description            |
 | ----------- | -------  |---------------- |
-| standard    | Multi-instance  | A new instance is started each time an ability starts.|
+| standard | Multi-instance  | A new instance is started each time an ability starts.|
 | singleton   | Singleton  | The ability has only one instance in the system. If an instance already exists when an ability is started, that instance is reused.|
 
 By default, **singleton** is used.

en/application-dev/ability-deprecated/stage-ability-continuation.md

@@ -6,7 +6,7 @@ Ability continuation is to continue the current mission of an application, inclu
 
 ## Available APIs
 
-The following table lists the APIs used for ability continuation. For details about the APIs, see [Ability](../reference/apis/js-apis-application-ability.md).
+The following table lists the APIs used for ability continuation. For details about the APIs, see [UIAbility](../reference/apis/js-apis-app-ability-uiAbility.md).
 
 **Table 1** Ability continuation APIs
 
@@ -48,96 +48,88 @@ The code snippets provided below are all from [Sample](https://gitee.com/openhar
      }
      ```
      
-
-
-
    - Configure the application startup type.
-
-     If **launchType** is set to **standard** in the **module.json5** file, the application is of the multi-instance launch type. During ability continuation, regardless of whether the application is already open, the target starts the application and restores the UI page. If **launchType** is set to **singleton**, the application is of the singleton launch type. If the application is already open, the target clears the existing page stack and restores the UI page. For more information, see "Launch Type" in [Ability Development](./stage-ability.md).
+   
+        If **launchType** is set to **multiton** in the **module.json5** file, the application is of the multi-instance launch type. During ability continuation, regardless of whether the application is already open, the target starts the application and restores the UI page. If **launchType** is set to **singleton**, the application is of the singleton launch type. If the application is already open, the target clears the existing page stack and restores the UI page. For more information, see "Launch Type" in [Ability Development](./stage-ability.md).
+        
+        Configure a multi-instance application as follows:
+        
+        ```javascript
+        {
+          "module": {
+            "abilities": [
+              {
+                "launchType": "multiton"
+              }
+            ]
+          }
+        }
+        ```
+        
+        Configure a singleton application as follows or retain the default settings of **launchType**:
+        
+        ```javascript
+        {
+          "module": {
+            "abilities": [
+              {
+                "launchType": "singleton"
+              }
+            ]
+          }
+        }
+        ```
+        
+   - Apply for the distributed permissions.
      
-     Configure a multi-instance application as follows:
+        Declare the **DISTRIBUTED_DATASYNC** permission in the **module.json5** file for the application.
      
-     ```javascript
-     {
-       "module": {
-         "abilities": [
-           {
-             "launchType": "standard"
-           }
-         ]
-       }
-     }
-     ```
+        ```javascript
+        "requestPermissions": [
+               {
+                   "name": "ohos.permission.DISTRIBUTED_DATASYNC"
+               },
+        ```
      
-     Configure a singleton application as follows or retain the default settings of **launchType**:
+        This permission must be granted by the user in a dialog box when the application is started for the first time. To enable the application to display a dialog box to ask for the permission, add the following code to **onWindowStageCreate** of the **Ability** class:
      
-     ```javascript
-     {
-       "module": {
-         "abilities": [
-           {
-             "launchType": "singleton"
+        ```javascript
+           requestPermissions = async () => {
+               let permissions: Array<string> = [
+                   "ohos.permission.DISTRIBUTED_DATASYNC"
+               ];
+               let needGrantPermission = false
+               let accessManger = accessControl.createAtManager()
+               Logger.info("app permission get bundle info")
+               let bundleInfo = await bundle.getApplicationInfo(BUNDLE_NAME, 0, 100)
+               Logger.info(`app permission query permission ${bundleInfo.accessTokenId.toString()}`)
+               for (const permission of permissions) {
+                   Logger.info(`app permission query grant status ${permission}`)
+                   try {
+                       let grantStatus = await accessManger.verifyAccessToken(bundleInfo.accessTokenId, permission)
+                       if (grantStatus === PERMISSION_REJECT) {
+                           needGrantPermission = true
+                           break;
+                       }
+                   } catch (err) {
+                       Logger.error(`app permission query grant status error ${permission} ${JSON.stringify(err)}`)
+                       needGrantPermission = true
+                       break;
+                   }
+               }
+               if (needGrantPermission) {
+                   Logger.info("app permission needGrantPermission")
+                   try {
+                       await accessManger.requestPermissionsFromUser(this.context, permissions)
+                   } catch (err) {
+                       Logger.error(`app permission ${JSON.stringify(err)}`)
+                   }
+               } else {
+                   Logger.info("app permission already granted")
+               }
            }
-         ]
-       }
-     }
-     ```
-     
-     
-     
-   - Apply for the distributed permissions.
-
-     Declare the **DISTRIBUTED_DATASYNC** permission in the **module.json5** file for the application.
-
-     ```javascript
-     "requestPermissions": [
-            {
-                "name": "ohos.permission.DISTRIBUTED_DATASYNC"
-            },
-     ```
-
-     
-
-     This permission must be granted by the user in a dialog box when the application is started for the first time. To enable the application to display a dialog box to ask for the permission, add the following code to **onWindowStageCreate** of the **Ability** class:
-
-     ```javascript
-        requestPermissions = async () => {
-            let permissions: Array<string> = [
-                "ohos.permission.DISTRIBUTED_DATASYNC"
-            ];
-            let needGrantPermission = false
-            let accessManger = accessControl.createAtManager()
-            Logger.info("app permission get bundle info")
-            let bundleInfo = await bundle.getApplicationInfo(BUNDLE_NAME, 0, 100)
-            Logger.info(`app permission query permission ${bundleInfo.accessTokenId.toString()}`)
-            for (const permission of permissions) {
-                Logger.info(`app permission query grant status ${permission}`)
-                try {
-                    let grantStatus = await accessManger.verifyAccessToken(bundleInfo.accessTokenId, permission)
-                    if (grantStatus === PERMISSION_REJECT) {
-                        needGrantPermission = true
-                        break;
-                    }
-                } catch (err) {
-                    Logger.error(`app permission query grant status error ${permission} ${JSON.stringify(err)}`)
-                    needGrantPermission = true
-                    break;
-                }
-            }
-            if (needGrantPermission) {
-                Logger.info("app permission needGrantPermission")
-                try {
-                    await accessManger.requestPermissionsFromUser(this.context, permissions)
-                } catch (err) {
-                    Logger.error(`app permission ${JSON.stringify(err)}`)
-                }
-            } else {
-                Logger.info("app permission already granted")
-            }
-        }
-     ```
-
-
+        ```
+   
 
 
 2. Implement the **onContinue()** API.
@@ -155,7 +147,7 @@ The code snippets provided below are all from [Sample](https://gitee.com/openhar
 
    You can obtain the target device ID (identified by the key **targetDevice**) and the version number (identified by the key **version**) of the application installed on the target device from the **wantParam** parameter of this API. The version number can be used for compatibility check. If the current application version is incompatible with that on the target device, **OnContinueResult.MISMATCH** can be returned to reject the continuation request.
 
-   Example
+   Example:
 
    ```javascript
         onContinue(wantParam : {[key: string]: any}) {
@@ -168,8 +160,6 @@ The code snippets provided below are all from [Sample](https://gitee.com/openhar
         }
    ```
 
-   
-
 3. Implement the continuation logic in the **onCreate()** or **onNewWant()** API.
 
    The **onCreate()** API is called by the target. When the ability is started on the target device, this API is called to instruct the application to synchronize the memory data and UI component state, and triggers page restoration after the synchronization is complete. If the continuation logic is not implemented, the ability will be started in common startup mode and the page cannot be restored.
@@ -178,11 +168,9 @@ The code snippets provided below are all from [Sample](https://gitee.com/openhar
    
    After data restore is complete, call **restoreWindowStage** to trigger page restoration.
    
-   
-
    You can also use **want.parameters.version** in the **want** parameter to obtain the application version number of the initiator.
-   
-   Example
+
+   Example:
    
    ```javascript
     import UIAbility from '@ohos.app.ability.UIAbility';
@@ -190,7 +178,7 @@ The code snippets provided below are all from [Sample](https://gitee.com/openhar
     
     export default class EntryAbility extends UIAbility {
         storage : LocalStorag;
-
+   
         onCreate(want, launchParam) {
             Logger.info(`EntryAbility onCreate ${AbilityConstant.LaunchReason.CONTINUATION}`)
             if (launchParam.launchReason == AbilityConstant.LaunchReason.CONTINUATION) {
@@ -211,7 +199,7 @@ For a singleton ability, use **onNewWant()** to achieve the same implementation.
 
 Use distributed objects.
 
-Distributed objects allow cross-device data synchronization like local variables. For two devices that form a Super Device, when data in the distributed data object of an application is added, deleted, or modified on a device, the data for the same application is also updated on the other device. Both devices can listen for the data changes and online and offline states of the other. For details, see [Distributed Data Object Development](../database/database-distributedobject-guidelines.md).
+Distributed objects allow cross-device data synchronization like local variables. For two devices that form a Super Device, when data in the distributed data object of an application is added, deleted, or modified on a device, the data for the same application is also updated on the other device. Both devices can listen for the data changes and online and offline states of the other. For details, see [Sharing Distributed Data Objects](../database/data-sync-of-distributed-data-object.md).
 
 In the ability continuation scenario, the distributed data object is used to synchronize the memory data from the local device to the target device.
 
@@ -249,8 +237,6 @@ In the ability continuation scenario, the distributed data object is used to syn
         });
   ```
 
-  
-
 - The target device obtains the session ID from **onCreate()**, creates a distributed object, and associates the distributed object with the session ID. In this way, the distributed object can be synchronized. Before calling **restoreWindowStage**, ensure that all distributed objects required for continuation have been associated.
 
   ```javascript
@@ -283,8 +269,6 @@ In the ability continuation scenario, the distributed data object is used to syn
   }
   ```
   
-   
-  
 ### More Information
 
 1. Timeout
@@ -294,15 +278,13 @@ In the ability continuation scenario, the distributed data object is used to syn
 
 2. By default, the system supports page stack information migration, which means that the page stack of the initiator will be automatically migrated to the target device. No adaptation is required.
 
-
-
 ### Restrictions
 
 1.   The continuation must be performed between the same ability, which means the same bundle name, module name, and ability name. For details, see [Application Package Structure Configuration File](../quick-start/module-configuration-file.md).
 2.    Currently, the application can only implement the continuation capability. The continuation action must be initiated by the system.
 
-
-
 ### Best Practice
 
 For better user experience, you are advised to use the **wantParam** parameter to transmit data smaller than 100 KB and use distributed objects to transmit data larger than 100 KB.
+
+ <!--no_check--> 
\ No newline at end of file

en/application-dev/ability-deprecated/stage-ability.md

@@ -12,8 +12,8 @@ An ability can be launched in the **standard**, **singleton**, or **specified**
 
 | Launch Type    | Description    |Action            |
 | ----------- | -------  |---------------- |
-| standard    | Standard mode  | A new instance is started each time an ability starts.|
-| singleton   | Singleton mode  | The ability has only one instance in the system. If an instance already exists when an ability is started, that instance is reused.|
+| multiton    | Multi-instance mode| A new instance is started each time an ability starts.|
+| singleton   | Singleton mode  | Default type. The ability has only one instance in the system. If an instance already exists when an ability is started, that instance is reused.|
 | specified   | Instance-specific| The internal service of an ability determines whether to create multiple instances during running.|
 
 By default, the singleton mode is used. The following is an example of the **module.json5** file:
@@ -39,7 +39,7 @@ The table below describes the APIs provided by the **AbilityStage** class, which
 |onAcceptWant(want: Want): string|Called when a specified ability is started.|
 |onConfigurationUpdated(config: Configuration): void|Called when the global configuration is updated.|
 
-The table below describes the APIs provided by the **Ability** class. For details about the APIs, see [Ability](../reference/apis/js-apis-application-ability.md).
+The table below describes the APIs provided by the **Ability** class. For details about the APIs, see [UIAbility](../reference/apis/js-apis-app-ability-uiAbility.md).
 
 **Table 2** Ability APIs
 
@@ -190,7 +190,7 @@ export default class EntryAbility extends UIAbility {
 ```
 ## Starting an Ability
 ### Available APIs
-The **Ability** class has the **context** attribute, which belongs to the **AbilityContext** class. The **AbilityContext** class has the **abilityInfo**, **currentHapModuleInfo**, and other attributes as well as the APIs used for starting abilities. For details, see [AbilityContext](../reference/apis/js-apis-ability-context.md).
+The **Ability** class has the **context** attribute, which belongs to the **AbilityContext** class. The **AbilityContext** class has the **abilityInfo**, **currentHapModuleInfo**, and other attributes as well as the APIs used for starting abilities. For details, see [AbilityContext](../reference/apis/js-apis-inner-application-uiAbilityContext.md).
 
 **Table 3** AbilityContext APIs
 |API|Description|
@@ -207,7 +207,7 @@ The **Ability** class has the **context** attribute, which belongs to the **Abil
 An application can obtain the context of an **Ability** instance through **this.context** and then use the **startAbility** API in the **AbilityContext** class to start the ability. The ability can be started by specifying **Want**, **StartOptions**, and **accountId**, and the operation result can be returned using a callback or **Promise** instance. The sample code is as follows:
 ```ts
 let context = this.context
-var want = {
+let want = {
     "deviceId": "",
     "bundleName": "com.example.MyApplication",
     "abilityName": "EntryAbility"
@@ -224,7 +224,7 @@ context.startAbility(want).then(() => {
 In the cross-device scenario, you must specify the ID of the remote device. The sample code is as follows:
 ```ts
 let context = this.context
-var want = {
+let want = {
     "deviceId": getRemoteDeviceId(),
     "bundleName": "com.example.MyApplication",
     "abilityName": "EntryAbility"
@@ -239,9 +239,9 @@ Obtain the ID of a specified device from **DeviceManager**. The sample code is a
 ```ts
 import deviceManager from '@ohos.distributedHardware.deviceManager';
 function getRemoteDeviceId() {
-    if (typeof dmClass === 'object' && dmClass != null) {
-        var list = dmClass.getTrustedDeviceListSync();
-        if (typeof (list) == 'undefined' || typeof (list.length) == 'undefined') {
+    if (typeof dmClass === 'object' && dmClass !== null) {
+        let list = dmClass.getTrustedDeviceListSync();
+        if (typeof (list) === 'undefined' || typeof (list.length) === 'undefined') {
             console.log("EntryAbility onButtonClick getRemoteDeviceId err: list is null");
             return;
         }

en/application-dev/ability-deprecated/stage-formextension.md

@@ -135,7 +135,7 @@ To create a widget in the stage model, you need to implement lifecycle callbacks
   | Name   | Description                                                        | Data Type  | Default Value Allowed          |
   | ----------- | ------------------------------------------------------------ | ---------- | -------------------- |
   | name        | Name of the Extension ability. This field must be specified.                | String    | No                  |
-  | srcEntrance | Path of the Extension ability lifecycle code. This field must be specified.| String    | No                  |
+  | srcEntry    | Path of the Extension ability lifecycle code. This field must be specified.| String    | No                  |
   | description | Description of the Extension ability. The value can be a string or a resource index to descriptions in multiple languages.| String    | Yes (initial value: left empty)|
   | icon        | Index of the Extension ability icon file.                  | String    | Yes (initial value: left empty)|
   | label       | Descriptive information about the Extension ability presented externally. The value can be a string or a resource index to the description.| String    | Yes (initial value: left empty)|
@@ -150,7 +150,7 @@ To create a widget in the stage model, you need to implement lifecycle callbacks
      ```json
   "extensionAbilities": [{
       "name": "FormAbility",
-      "srcEntrance": "./ets/FormAbility/FormAbility.ts",
+      "srcEntry": "./ets/FormAbility/FormAbility.ts",
       "label": "$string:form_FormAbility_label",
       "description": "$string:form_FormAbility_desc",
       "type": "form",
@@ -242,7 +242,7 @@ You should override **onDestroy** to implement widget data deletion.
        }
 ```
 
-For details about how to implement persistent data storage, see [Lightweight Data Store Development](../database/database-preference-guidelines.md).
+For details about how to implement persistent data storage, see [Application Data Persistence Overview](../database/app-data-persistence-overview.md).
 
 The **Want** object passed in by the widget host to the widget provider contains a flag that specifies whether the requested widget is normal or temporary.
 
@@ -366,7 +366,7 @@ You can set router and message events for components on a widget. The router eve
 1. Set the **onclick** field in the HML file to **routerEvent** or **messageEvent**, depending on the **actions** settings in the JSON file.
 2. Set the router event.
    - **action**: **"router"**, which indicates a router event.
-   - **abilityName**: target ability name, for example, **EntryAbility**, which is the default UIAbility name in DevEco Studio for the stage model.
+   - **abilityName**: target ability name, for example, **EntryAbility**, which is the default main ability name in DevEco Studio for the stage model.
    - **params**: custom parameters of the target ability. Set them as required. The value can be obtained from **parameters** in **want** used for starting the target ability. For example, in the lifecycle function **onCreate** of the EntryAbility in the stage model, you can obtain **want** and its **parameters** field.
 3. Set the message event.
    - **action**: **"message"**, which indicates a message event.
@@ -413,3 +413,5 @@ The code snippet is as follows:
      }
    }
    ```
+
+ <!--no_check--> 
\ No newline at end of file

en/application-dev/ability-deprecated/stage-serviceextension.md

@@ -33,8 +33,8 @@ OpenHarmony does not support creation of a Service Extension ability for third-p
         "icon": "$media:icon",
         "description": "service",
         "type": "service",
-        "visible": true,
-        "srcEntrance": "./ets/ServiceExtAbility/ServiceExtAbility.ts"
+        "exported": true,
+        "srcEntry": "./ets/ServiceExtAbility/ServiceExtAbility.ts"
     }]
    ```