!16893 1、want的parameters参数中，新增一个获取拉起方Bundle Name的描述。 2、区分“应用选择框”和“应用分享框”。...

!16893 1、want的parameters参数中，新增一个获取拉起方Bundle Name的描述。 2、区分“应用选择框”和“应用分享框”。 3、应用开发路径与文件管理中的开发路径名称保持一致。 4、补充UIAbilityA拉起UIAbilityB，从UIAbilityB中识别拉起方的PID、Bundle Name等信息。
Merge pull request !16893 from zyjhandsome/master

zh-cn/application-dev/application-models/ability-startup-with-implicit-want.md

@@ -52,11 +52,11 @@ function implicitStartAbility() {
   let context = getContext(this) as common.UIAbilityContext;
   let wantInfo = {
     // uncomment line below if wish to implicitly query only in the specific bundle.
-    // bundleName: "com.example.myapplication",
-    "action": "ohos.want.action.viewData",
+    // bundleName: 'com.example.myapplication',
+    'action': 'ohos.want.action.viewData',
     // entities can be omitted.
-    "entities": ["entity.system.browsable"],
-    "uri": "https://www.test.com:8080/query/student"
+    'entities': ['entity.system.browsable'],
+    'uri': 'https://www.test.com:8080/query/student'
   }
   context.startAbility(wantInfo).then(() => {
     // ...
@@ -73,5 +73,5 @@ function implicitStartAbility() {
 3. 待匹配Ability的skills配置中内uris拼接为`https://www.test.com:8080/query*` （其中*表示通配符），包含调用方传入的want参数的uri，uri匹配成功。
 4. 调用方传入的want参数的type不为空，待匹配Ability的skills配置中的type不为空且包含调用方传入的want参数的type，type匹配成功。
 
-当有多个匹配应用时，会被应用选择器展示给用户进行选择。 示意效果如下图所示。  
+当存在多个匹配的应用时，系统将弹出应用选择框供用户选择。示意效果如下图所示。  
 ![](figures/ability-startup-with-implicit-want1.png)

zh-cn/application-dev/application-models/application-context-stage.md

@@ -43,7 +43,7 @@
   - 获取[AbilityStageContext](../reference/apis/js-apis-inner-application-abilityStageContext.md)。Module级别的Context，和基类Context相比，额外提供HapModuleInfo、Configuration等信息。
     
      ```ts
-     import AbilityStage from "@ohos.app.ability.AbilityStage";
+     import AbilityStage from '@ohos.app.ability.AbilityStage';
      export default class MyAbilityStage extends AbilityStage {
        onCreate() {
          let abilityStageContext = this.context;
@@ -80,17 +80,17 @@
 
 从Context中获取的应用开发路径如下表所示。
 
-  **表1** 应用开发路径说明
+**表1** 应用开发路径说明
 
 | 属性名称 | 参数类型 | 可读 | 可写 | 说明 |
 | -------- | -------- | -------- | -------- | -------- |
-| cacheDir | string | 是 | 否 | 应用在内部存储上的缓存路径。<br/>对应于"设置&nbsp;&gt;&nbsp;应用管理"，找到对应应用的"存储"中的缓存内容。 |
-| tempDir | string | 是 | 否 | 应用的临时文件路径。<br/>在应用卸载后，系统会删除存储在此目录中的文件。 |
-| filesDir | string | 是 | 否 | 应用在内部存储上的文件路径。<br/>本目录下存放的文件可能会被应用迁移或者备份的时候同步到其他目录中。 |
-| databaseDir | string | 是 | 否 | 获取本地数据库存储路径。 |
-| bundleCodeDir | string | 是 | 否 | 应用在内部存储上的安装路径。 |
-| distributedFilesDir | string | 是 | 否 | 应用的分布式文件路径。 |
-| preferencesDir | string | 是 | 是 | 指示应用程序首选项目录。 |
+| bundleCodeDir       | string   | 是   | 否   | 安装文件路径。应用在内部存储上的安装路径。                   |
+| cacheDir | string | 是 | 否 | 应用缓存文件路径。应用在内部存储上的缓存路径。<br/>对应于“设置&nbsp;&gt;&nbsp;应用管理”，找到对应应用的“存储”中的缓存内容。 |
+| filesDir            | string   | 是   | 否   | 应用通用文件路径。应用在内部存储上的文件路径。<br/>本目录下存放的文件可能会被应用迁移或者备份的时候同步到其他目录中。 |
+| preferencesDir      | string   | 是   | 是   | 应用首选项文件路径。指示应用程序首选项目录。                 |
+| tempDir             | string   | 是   | 否   | 应用临时文件路径。<br/>在应用卸载后，系统会删除存储在此目录中的文件。 |
+| databaseDir         | string   | 是   | 否   | 数据库路径。获取本地数据库存储路径。                         |
+| distributedFilesDir | string | 是 | 否 | 应用分布式文件路径。 |
 
 获取路径的能力是基类Context中提供的能力，因此在ApplicationContext、AbilityStageContext、UIAbilityContext和ExtensionContext中均可以获取，在各类Context中获取到的路径会有一些差别，具体差别如下图所示。
 
@@ -198,7 +198,7 @@ export default class EntryAbility extends UIAbility {
   
   export default class EntryAbility extends UIAbility {
     onCreate(want, launchParam) {
-      let bundleName2 = "com.example.application";
+      let bundleName2 = 'com.example.application';
       let context2 = this.context.createBundleContext(bundleName2);
       let label2 = context2.applicationInfo.label;
       // ...
@@ -208,19 +208,20 @@ export default class EntryAbility extends UIAbility {
 
 - 调用createModuleContext(bundleName:string, moduleName:string)方法，获取指定应用指定Module的上下文信息。获取到指定应用指定Module的Context之后，即可获取到相应应用Module的资源信息。
   > **说明：**
+  >
   > 当获取的是其他应用的指定Module的Context时：
-  > 
-  > - 申请`ohos.permission.GET_BUNDLE_INFO_PRIVILEGED`权限，配置方式请参见[访问控制授权申请](../security/accesstoken-guidelines.md#配置文件权限声明)。
-  > 
+  >
+  > - 申请`ohos.permission.GET_BUNDLE_INFO_PRIVILEGED`权限，配置方式请参见[配置文件权限声明](../security/accesstoken-guidelines.md#配置文件权限声明)。
+  >
   > - 接口为系统接口，三方应用不支持调用。
-
+  
   ```ts
   import UIAbility from '@ohos.app.ability.UIAbility';
   
   export default class EntryAbility extends UIAbility {
     onCreate(want, launchParam) {
-      let bundleName2 = "com.example.application";
-      let moduleName2 = "module1";
+      let bundleName2 = 'com.example.application';
+      let moduleName2 = 'module1';
       let context2 = this.context.createModuleContext(bundleName2, moduleName2);
       // ...
     }
@@ -234,7 +235,7 @@ export default class EntryAbility extends UIAbility {
   
   export default class EntryAbility extends UIAbility {
     onCreate(want, launchParam) {
-      let moduleName2 = "module1";
+      let moduleName2 = 'module1';
       let context2 = this.context.createModuleContext(moduleName2);
       // ...
     }
@@ -306,7 +307,7 @@ export default class EntryAbility extends UIAbility {
     // 获取应用上下文
     let applicationContext = this.context.getApplicationContext();
     // 注册应用内生命周期回调
-    this.lifecycleId = applicationContext.on("abilityLifecycle", abilityLifecycleCallback);
+    this.lifecycleId = applicationContext.on('abilityLifecycle', abilityLifecycleCallback);
     console.log(TAG, `register callback number: ${this.lifecycleId}`);
   }
 
@@ -316,7 +317,7 @@ export default class EntryAbility extends UIAbility {
     // 获取应用上下文
     let applicationContext = this.context.getApplicationContext();
     // 取消应用内生命周期回调
-    applicationContext.off("abilityLifecycle", this.lifecycleId);
+    applicationContext.off('abilityLifecycle', this.lifecycleId);
   }
 }
 ```

zh-cn/application-dev/application-models/data-share-via-want.md

@@ -2,20 +2,20 @@
 
 在应用使用场景中，用户经常需要将应用内的数据（如文字、图片等）分享至其他应用以供进一步处理。以分享PDF文件为例，本文将介绍如何使用Want来实现应用间的数据分享。
 
-数据分享需要使用两个UIAbility组件（分享方和被分享方）以及一个系统组件（应用选择框）。当分享方使用`startAbility()`方法发起数据分享时，系统会隐式匹配所有支持接收分享数据类型的应用，并将其展示给用户以供选择。用户选择应用后，系统将启动该应用来完成数据分享操作。
+数据分享需要使用两个UIAbility组件（分享方和被分享方）以及一个系统组件（应用分享框）。当分享方使用`startAbility()`方法发起数据分享时，系统会隐式匹配所有支持接收分享数据类型的应用，并将其展示给用户以供选择。用户选择应用后，系统将启动该应用来完成数据分享操作。
 
 在本文中，我们将使用按钮的形式触发分享操作，但实际开发中并不限于此。本文主要介绍如何配置Want以实现数据分享的功能。
 
 本文中涉及的两个Action为：
 
-- `ohos.want.action.select`：用于启动应用选择框。
+- `ohos.want.action.select`：用于启动应用分享框。
 - `ohos.want.action.sendData`：用于发送单个数据记录。此Action用于将数据传递给分享方应用。
 
 ## 分享方
 
-为了实现数据分享功能，分享方需要先拉起应用选择框并将要分享的数据传递给被分享方应用。因此，在分享方的代码中需要嵌套使用两层Want。在第一层中，使用隐式Want和`ohos.want.action.select`的action来启动应用选择框。在第二层Want中，声明要传递给被分享方应用的数据。
+为了实现数据分享功能，分享方需要先拉起应用分享框并将要分享的数据传递给被分享方应用。因此，在分享方的代码中需要嵌套使用两层Want。在第一层中，使用隐式Want和`ohos.want.action.select`的action来启动应用分享框。在第二层Want中，声明要传递给被分享方应用的数据。
 
-具体来说，可以将要分享的数据放在自定义字段`parameters`中，然后将包含`ohos.want.action.sendData`的action和`parameters`字段的Want作为第二层Want传递给应用选择框。被分享方应用可以通过获取参数`parameters`来获取分享的数据。
+具体来说，可以将要分享的数据放在自定义字段`parameters`中，然后将包含`ohos.want.action.sendData`的action和`parameters`字段的Want作为第二层Want传递给应用分享框。被分享方应用可以通过获取参数`parameters`来获取分享的数据。
 
 ```ts
 import common from '@ohos.app.ability.common';
@@ -34,15 +34,15 @@ function implicitStartAbility() {
     // which is intended to add info to application selector.
     parameters: {
       // The MIME type of pdf
-      "ability.picker.type": fileType,
-      "ability.picker.fileNames": [fileName],
-      "ability.picker.fileSizes": [fileSize],
+      'ability.picker.type': fileType,
+      'ability.picker.fileNames': [fileName],
+      'ability.picker.fileSizes': [fileSize],
       // This a nested want which will be directly send to the user selected application.
-      "ability.want.params.INTENT": {
-        "action": "ohos.want.action.sendData",
-        "type": "application/pdf",
-        "parameters": {
-          "keyFd": { "type": "FD", "value": fileFd }
+      'ability.want.params.INTENT': {
+        'action': 'ohos.want.action.sendData',
+        'type': 'application/pdf',
+        'parameters': {
+          'keyFd': { 'type': 'FD', 'value': fileFd }
         }
       }
     }

zh-cn/application-dev/reference/apis/js-apis-app-ability-want.md

@@ -26,7 +26,7 @@ import Want from '@ohos.app.ability.Want';
 | entities | Array\<string> | 否 | 表示目标Ability额外的类别信息（如：浏览器、视频播放器）。在隐式Want中是对action字段的补充。在隐式Want中，您可以定义该字段，来过滤匹配Ability类型。 |
 | uri | string | 否 | 表示携带的数据，一般配合type使用，指明待处理的数据类型。如果在Want中指定了uri，则Want将匹配指定的Uri信息，包括`scheme`、`schemeSpecificPart`、`authority`和`path`信息。 |
 | type | string | 否 | 表示MIME type类型描述，打开文件的类型，主要用于文管打开文件。比如：'text/xml' 、 'image/*'等，MIME定义请参见https://www.iana.org/assignments/media-types/media-types.xhtml?utm_source=ld246.com。 |
-| parameters   | {[key: string]: any} | 否   | 表示WantParams描述，由开发者自行决定传入的键值对。默认会携带以下key值：<br />- ohos.aafwk.callerPid：表示拉起方的pid。<br />- ohos.aafwk.param.callerToken：表示拉起方的token。<br />- ohos.aafwk.param.callerUid：表示[BundleInfo](js-apis-bundleManager-bundleInfo.md#bundleinfo-1)中的uid，应用包里应用程序的uid。<br />- component.startup.newRules：表示是否启用新的管控规则。<br />- moduleName：表示拉起方的模块名，该字段的值即使定义成其他字符串，在传递到另一端时会被修改为正确的值。<br />- ohos.dlp.params.sandbox：表示dlp文件才会有。           |
+| parameters   | {[key: string]: any} | 否   | 表示WantParams描述，由开发者自行决定传入的键值对。默认会携带以下key值：<br />- ohos.aafwk.callerPid：表示拉起方的pid。<br />- ohos.aafwk.param.callerBundleName：表示拉起方的Bundle Name。<br />- ohos.aafwk.param.callerToken：表示拉起方的token。<br />- ohos.aafwk.param.callerUid：表示[BundleInfo](js-apis-bundleManager-bundleInfo.md#bundleinfo-1)中的uid，应用包里应用程序的uid。<br />- component.startup.newRules：表示是否启用新的管控规则。<br />- moduleName：表示拉起方的模块名，该字段的值即使定义成其他字符串，在传递到另一端时会被修改为正确的值。<br />- ohos.dlp.params.sandbox：表示dlp文件才会有。 |
 | [flags](js-apis-ability-wantConstant.md#wantconstantflags) | number | 否 | 表示处理Want的方式。默认传数字。<br />例如通过wantConstant.Flags.FLAG_ABILITY_CONTINUATION表示是否以设备间迁移方式启动Ability。 |
 
 **示例：**
@@ -34,6 +34,7 @@ import Want from '@ohos.app.ability.Want';
 - 基础用法：在UIAbility对象中调用，示例中的context的获取方式请参见[获取UIAbility的上下文信息](../../application-models/uiability-usage.md#获取uiability的上下文信息)。
 
   ```ts
+  let context = ...; // UIAbilityContext
   let want = {
     'deviceId': '', // deviceId为空表示本设备
     'bundleName': 'com.example.myapplication',
@@ -41,16 +42,17 @@ import Want from '@ohos.app.ability.Want';
     'moduleName': 'entry' // moduleName非必选
   };
   
-  this.context.startAbility(want, (err) => {
+  context.startAbility(want, (err) => {
     // 显式拉起Ability，通过bundleName、abilityName和moduleName可以唯一确定一个Ability
-    console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
+    console.error(`Failed to startAbility. Code: ${err.code}, message: ${err.message}`);
   });
   ```
 
-- 通过自定字段传递数据，以下为当前支持类型（在UIAbility对象中调用，示例中的context的获取方式请参见[获取UIAbility的上下文信息](../../application-models/uiability-usage.md#获取uiability的上下文信息)）。
+- 目前支持的数据类型有：字符串、数字、布尔、对象、数组和文件描述符等。
 
     * 字符串（String）
         ```ts
+        let context = ...; // UIAbilityContext
         let want = {
           bundleName: 'com.example.myapplication',
           abilityName: 'FuncAbility',
@@ -59,12 +61,13 @@ import Want from '@ohos.app.ability.Want';
           },
         };
         
-        this.context.startAbility(want, (err) => {
-          console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
+        context.startAbility(want, (err) => {
+          console.error(`Failed to startAbility. Code: ${err.code}, message: ${err.message}`);
         });
         ```
     * 数字（Number）
         ```ts
+        let context = ...; // UIAbilityContext
         let want = {
           bundleName: 'com.example.myapplication',
           abilityName: 'FuncAbility',
@@ -74,12 +77,13 @@ import Want from '@ohos.app.ability.Want';
           },
         };
         
-        this.context.startAbility(want, (err) => {
-          console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
+        context.startAbility(want, (err) => {
+          console.error(`Failed to startAbility. Code: ${err.code}, message: ${err.message}`);
         });
         ```
     * 布尔（Boolean）
         ```ts
+        let context = ...; // UIAbilityContext
         let want = {
           bundleName: 'com.example.myapplication',
           abilityName: 'FuncAbility',
@@ -88,12 +92,13 @@ import Want from '@ohos.app.ability.Want';
           },
         };
         
-        this.context.startAbility(want, (err) => {
-          console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
+        context.startAbility(want, (err) => {
+          console.error(`Failed to startAbility. Code: ${err.code}, message: ${err.message}`);
         });
         ```
     * 对象（Object）
         ```ts
+        let context = ...; // UIAbilityContext
         let want = {
           bundleName: 'com.example.myapplication',
           abilityName: 'FuncAbility',
@@ -107,12 +112,13 @@ import Want from '@ohos.app.ability.Want';
           },
         };
         
-        this.context.startAbility(want, (err) => {
-          console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
+        context.startAbility(want, (err) => {
+          console.error(`Failed to startAbility. Code: ${err.code}, message: ${err.message}`);
         });
         ```
     * 数组（Array）
         ```ts
+        let context = ...; // UIAbilityContext
         let want = {
           bundleName: 'com.example.myapplication',
           abilityName: 'FuncAbility',
@@ -124,19 +130,21 @@ import Want from '@ohos.app.ability.Want';
           },
         };
         
-        this.context.startAbility(want, (err) => {
-          console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
+        context.startAbility(want, (err) => {
+          console.error(`Failed to startAbility. Code: ${err.code}, message: ${err.message}`);
         });
         ```
     * 文件描述符（FD）
         ```ts
         import fs from '@ohos.file.fs';
         
+        let context = ...; // UIAbilityContext
+        
         let fd;
         try {
-            fd = fs.openSync('/data/storage/el2/base/haps/pic.png').fd;
-        } catch(e) {
-            console.error('openSync fail: ${JSON.stringify(e)}');
+          fd = fs.openSync('/data/storage/el2/base/haps/pic.png').fd;
+        } catch(err) {
+          console.error(`Failed to openSync. Code: ${err.code}, message: ${err.message}`);
         }
         let want = {
           'deviceId': '', // deviceId为空表示本设备
@@ -148,8 +156,7 @@ import Want from '@ohos.app.ability.Want';
           }
         };
         
-        this.context.startAbility(want, (err) => {
-          console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
+        context.startAbility(want, (err) => {
+          console.error(`Failed to startAbility. Code: ${err.code}, message: ${err.message}`);
         });
         ```
-