Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
提交 02438b08 编写于 作者: zyjhandsome's avatar zyjhandsome
浏览文件
操作

优化Want API的示例代码内容。 

Signed-off-by: zyjhandsome's avatarzyjhandsome <zyjhandsome@126.com>
上级 efc01321
隐藏空白更改
内联 并排
Showing with 81 addition and 63 deletion
zh-cn/application-dev/reference/apis/js-apis-app-ability-want.md
浏览文件 @ 02438b08
# @ohos.app.ability.Want (Want) # @ohos.app.ability.Want (Want)
Want是对象间信息传递的载体, 可以用于应用组件间的信息传递。 Want的使用场景之一是作为startAbility的参数, 其包含了指定的启动目标, 以及启动时需携带的相关数据, 如bundleName和abilityName字段分别指明目标Ability所在应用的包名以及对应包内的Ability名称。当UIAbilityA需要启动UIAbilityB并传入一些数据时, 可使用Want作为载体将这些数据传递给UIAbilityB。 Want是对象间信息传递的载体，可以用于应用组件间的信息传递。Want的使用场景之一是作为startAbility的参数，其包含了指定的启动目标，以及启动时需携带的相关数据，例如bundleName和abilityName字段分别指明目标Ability所在应用的包名以及对应包内的Ability名称。当UIAbilityA需要启动UIAbilityB并传入一些数据时，可使用Want作为载体将这些数据传递给UIAbilityB。
> **说明：** > **说明：**
> >
...@@ -31,107 +31,125 @@ import Want from '@ohos.app.ability.Want'; ...@@ -31,107 +31,125 @@ import Want from '@ohos.app.ability.Want';
**示例：** **示例：**
- 基础用法（在UIAbility对象中调用，其中示例中的context为UIAbility的上下文对象）。 - 基础用法：在UIAbility对象中调用，示例中的context的获取方式请参见[获取UIAbility的上下文信息](../../application-models/uiability-usage.md#获取uiability的上下文信息)。
```ts ```ts
let want = { let want = {
'deviceId': '', // deviceId为空表示本设备 'deviceId': '', // deviceId为空表示本设备
'bundleName': 'com.example.myapplication', 'bundleName': 'com.example.myapplication',
'abilityName': 'FuncAbility', 'abilityName': 'FuncAbility',
'moduleName': 'entry' // moduleName非必选 'moduleName': 'entry' // moduleName非必选
}; };
this.context.startAbility(want, (error) => {
// 显式拉起Ability，通过bundleName、abilityName和moduleName可以唯一确定一个Ability this.context.startAbility(want, (err) => {
console.log('error.code = ' + error.code); // 显式拉起Ability，通过bundleName、abilityName和moduleName可以唯一确定一个Ability
}); console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
});
``` ```
- 通过自定字段传递数据, 以下为当前支持类型（在UIAbility对象中调用，其中示例中的context为UIAbility的上下文对象）。 - 通过自定字段传递数据，以下为当前支持类型（在UIAbility对象中调用，示例中的context的获取方式请参见[获取UIAbility的上下文信息](../../application-models/uiability-usage.md#获取uiability的上下文信息)）。
* 字符串（String） * 字符串（String）
```ts ```ts
let want = { let want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility', abilityName: 'FuncAbility',
parameters: { parameters: {
keyForString: 'str', keyForString: 'str',
}, },
}; };
this.context.startAbility(want, (err) => {
console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
});
``` ```
* 数字（Number） * 数字（Number）
```ts ```ts
let want = { let want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility', abilityName: 'FuncAbility',
parameters: { parameters: {
keyForInt: 100, keyForInt: 100,
keyForDouble: 99.99, keyForDouble: 99.99,
}, },
}; };
this.context.startAbility(want, (err) => {
console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
});
``` ```
* 布尔（Boolean） * 布尔（Boolean）
```ts ```ts
let want = { let want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility', abilityName: 'FuncAbility',
parameters: { parameters: {
keyForBool: true, keyForBool: true,
}, },
}; };
this.context.startAbility(want, (err) => {
console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
});
``` ```
* 对象（Object） * 对象（Object）
```ts ```ts
let want = { let want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility', abilityName: 'FuncAbility',
parameters: { parameters: {
keyForObject: { keyForObject: {
keyForObjectString: 'str', keyForObjectString: 'str',
keyForObjectInt: -200, keyForObjectInt: -200,
keyForObjectDouble: 35.5, keyForObjectDouble: 35.5,
keyForObjectBool: false, keyForObjectBool: false,
},
}, },
},
}; };
this.context.startAbility(want, (err) => {
console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
});
``` ```
* 数组（Array） * 数组（Array）
```ts ```ts
let want = { let want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility', abilityName: 'FuncAbility',
parameters: { parameters: {
keyForArrayString: ['str1', 'str2', 'str3'], keyForArrayString: ['str1', 'str2', 'str3'],
keyForArrayInt: [100, 200, 300, 400], keyForArrayInt: [100, 200, 300, 400],
keyForArrayDouble: [0.1, 0.2], keyForArrayDouble: [0.1, 0.2],
keyForArrayObject: [{obj1: 'aaa'}, {obj2: 100}], keyForArrayObject: [{ obj1: 'aaa' }, { obj2: 100 }],
}, },
}; };
this.context.startAbility(want, (err) => {
console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
});
``` ```
* 文件描述符（FD） * 文件描述符（FD）
```ts ```ts
import fileio from '@ohos.fileio'; import fileio from '@ohos.fileio';
let fd; let fd;
try { try {
fd = fileio.openSync('/data/storage/el2/base/haps/pic.png'); fd = fileio.openSync('/data/storage/el2/base/haps/pic.png');
} catch(e) { } catch (e) {
console.log('openSync fail:' + JSON.stringify(e)); console.log('openSync fail:' + JSON.stringify(e));
} }
let want = { let want = {
'deviceId': '', // deviceId为空表示本设备 'deviceId': '', // deviceId为空表示本设备
'bundleName': 'com.example.myapplication', 'bundleName': 'com.example.myapplication',
'abilityName': 'FuncAbility', 'abilityName': 'FuncAbility',
'moduleName': 'entry', // moduleName非必选 'moduleName': 'entry', // moduleName非必选
'parameters': { 'parameters': {
'keyFd':{'type':'FD', 'value':fd} // {'type':'FD', 'value':fd}是固定用法，用于表示该数据是FD 'keyFd': { 'type': 'FD', 'value': fd } // {'type':'FD', 'value':fd}是固定用法，用于表示该数据是FD
} }
}; };
this.context.startAbility(want, (error) => {
// 显式拉起Ability，通过bundleName、abilityName和moduleName可以唯一确定一个Ability this.context.startAbility(want, (err) => {
console.log('error.code = ' + error.code) console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
}); });
``` ```
- 更多详细说明和示例请参见： [应用模型](../../application-models/Readme-CN.md)的信息传递载体Want
<!--no_check-->
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或