提交 cb554042 编写于 作者: zyjhandsome's avatar zyjhandsome

整体优化UIAbilityContext的示例代码。归一化异常场景的打印方式。

Signed-off-by: zyjhandsome's avatarzyjhandsome <zyjhandsome@126.com>
上级 d4ba056b
...@@ -18,7 +18,8 @@ UIAbilityContext是[UIAbility](js-apis-app-ability-uiAbility.md)的上下文环 ...@@ -18,7 +18,8 @@ UIAbilityContext是[UIAbility](js-apis-app-ability-uiAbility.md)的上下文环
| config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 否 | 与UIAbility相关的配置信息,如语言、颜色模式等。 | | config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 否 | 与UIAbility相关的配置信息,如语言、颜色模式等。 |
> **关于示例代码的说明:** > **关于示例代码的说明:**
> - 本文档中的示例,通过this.context获取UIAbilityContext,this代表的是继承自UIAbility的UIAbility实例,若需要在页面中使用UIAbilityContext的能力,请参照[获取UIAbility的上下文信息](../../application-models/uiability-usage.md#获取uiability的上下文信息) >
> 在本文档的示例中,通过`this.context`来获取`UIAbilityContext`,其中`this`代表继承自`UIAbility`的`UIAbility`实例。如需要在页面中使用`UIAbilityContext`提供的能力,请参见[获取UIAbility的上下文信息](../../application-models/uiability-usage.md#获取uiability的上下文信息)。
## UIAbilityContext.startAbility ## UIAbilityContext.startAbility
...@@ -61,27 +62,25 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void; ...@@ -61,27 +62,25 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
**示例:** **示例:**
```ts ```ts
let want = { let want = {
bundleName: 'com.example.myapp', bundleName: 'com.example.myapplication',
abilityName: 'MyAbility' abilityName: 'EntryAbility'
}; };
try { try {
this.context.startAbility(want, (error) => { this.context.startAbility(want, (err) => {
if (error.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('startAbility failed, error.code: ' + JSON.stringify(error.code) + console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); return;
return; }
} // 执行正常业务
// 执行正常业务 console.info('startAbility succeed');
console.log('startAbility succeed'); });
}); } catch (err) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`startAbility failed failed, code is ${err.code}, message is ${err.message}`);
console.log('startAbility failed, error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
## UIAbilityContext.startAbility ## UIAbilityContext.startAbility
...@@ -126,31 +125,29 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void& ...@@ -126,31 +125,29 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void&
**示例:** **示例:**
```ts ```ts
let want = { let want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let options = { let options = {
windowMode: 0 windowMode: 0
}; };
try { try {
this.context.startAbility(want, options, (error) => { this.context.startAbility(want, options, (err) => {
if (error.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('startAbility failed, error.code: ' + JSON.stringify(error.code) + console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); return;
return; }
} // 执行正常业务
// 执行正常业务 console.info('startAbility succeed');
console.log('startAbility succeed'); });
}); } catch (err) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`startAbility failed failed, code is ${err.code}, message is ${err.message}`);
console.log('startAbility failed, error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
## UIAbilityContext.startAbility ## UIAbilityContext.startAbility
...@@ -200,30 +197,28 @@ startAbility(want: Want, options?: StartOptions): Promise&lt;void&gt;; ...@@ -200,30 +197,28 @@ startAbility(want: Want, options?: StartOptions): Promise&lt;void&gt;;
**示例:** **示例:**
```ts ```ts
let want = { let want = {
bundleName: 'com.example.myapp', bundleName: 'com.example.myapplication',
abilityName: 'MyAbility' abilityName: 'EntryAbility'
}; };
let options = { let options = {
windowMode: 0, windowMode: 0,
}; };
try { try {
this.context.startAbility(want, options) this.context.startAbility(want, options)
.then(() => { .then(() => {
// 执行正常业务 // 执行正常业务
console.log('startAbility succeed'); console.info('startAbility succeed');
}) })
.catch((error) => { .catch((err) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('startAbility failed, error.code: ' + JSON.stringify(error.code) + console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); });
}); } catch (err) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
console.log('startAbility failed, error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
## UIAbilityContext.startAbilityForResult ## UIAbilityContext.startAbilityForResult
...@@ -270,28 +265,26 @@ startAbilityForResult(want: Want, callback: AsyncCallback&lt;AbilityResult&gt;): ...@@ -270,28 +265,26 @@ startAbilityForResult(want: Want, callback: AsyncCallback&lt;AbilityResult&gt;):
**示例:** **示例:**
```ts ```ts
let want = { let want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
try { try {
this.context.startAbilityForResult(want, (error, result) => { this.context.startAbilityForResult(want, (err, result) => {
if (error.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('startAbilityForResult failed, error.code: ' + JSON.stringify(error.code) + console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); return;
return; }
} // 执行正常业务
// 执行正常业务 console.info('startAbilityForResult succeed');
console.log('startAbilityForResult succeed, result.resultCode = ' + result.resultCode) });
}); } catch (err) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`);
console.log('startAbilityForResult failed, error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
## UIAbilityContext.startAbilityForResult ## UIAbilityContext.startAbilityForResult
...@@ -300,8 +293,8 @@ startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback ...@@ -300,8 +293,8 @@ startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback
启动一个Ability。Ability被启动后,有如下情况(callback形式): 启动一个Ability。Ability被启动后,有如下情况(callback形式):
- 正常情况下可通过调用[terminateSelfWithResult](#uiabilitycontextterminateselfwithresult)接口使之终止并且返回结果给调用方。 - 正常情况下可通过调用[terminateSelfWithResult](#uiabilitycontextterminateselfwithresult)接口使之终止并且返回结果给调用方。
- 异常情况下比如杀死Ability会返回异常信息给调用方, 异常信息中resultCode为-1。 - 异常情况下比如杀死Ability会返回异常信息给调用方异常信息中resultCode为-1。
- 如果被启动的Ability模式是单实例模式, 不同应用多次调用该接口启动这个Ability,当这个Ability调用[terminateSelfWithResult](#uiabilitycontextterminateselfwithresult)接口使之终止时,只将正常结果返回给最后一个调用方, 其它调用方返回异常信息, 异常信息中resultCode为-1。 - 如果被启动的Ability模式是单实例模式, 不同应用多次调用该接口启动这个Ability,当这个Ability调用[terminateSelfWithResult](#uiabilitycontextterminateselfwithresult)接口使之终止时,只将正常结果返回给最后一个调用方其它调用方返回异常信息, 异常信息中resultCode为-1。
使用规则: 使用规则:
- 调用方应用位于后台时,使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 - 调用方应用位于后台时,使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限
...@@ -339,31 +332,29 @@ startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback ...@@ -339,31 +332,29 @@ startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback
**示例:** **示例:**
```ts ```ts
let want = { let want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let options = { let options = {
windowMode: 0, windowMode: 0,
}; };
try { try {
this.context.startAbilityForResult(want, options, (error, result) => { this.context.startAbilityForResult(want, options, (err, result) => {
if (error.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('startAbilityForResult failed, error.code: ' + JSON.stringify(error.code) + console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); return;
return; }
} // 执行正常业务
// 执行正常业务 console.info('startAbilityForResult succeed');
console.log('startAbilityForResult succeed, result.resultCode = ' + result.resultCode); });
}); } catch (paramError) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`);
console.log('startAbilityForResult failed, error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
...@@ -419,28 +410,26 @@ startAbilityForResult(want: Want, options?: StartOptions): Promise&lt;AbilityRes ...@@ -419,28 +410,26 @@ startAbilityForResult(want: Want, options?: StartOptions): Promise&lt;AbilityRes
```ts ```ts
let want = { let want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let options = { let options = {
windowMode: 0, windowMode: 0,
}; };
try { try {
this.context.startAbilityForResult(want, options) this.context.startAbilityForResult(want, options)
.then((result) => { .then((result) => {
// 执行正常业务 // 执行正常业务
console.log('startAbilityForResult succeed, result.resultCode = ' + result.resultCode); console.info('startAbilityForResult succeed');
}) })
.catch((error) => { .catch((err) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('startAbilityForResult failed, error.code: ' + JSON.stringify(error.code) + console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message));
}); });
} catch (paramError) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.log('startAbilityForResult failed, error.code: ' + JSON.stringify(paramError.code) + console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(paramError.message));
} }
``` ```
...@@ -490,30 +479,27 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC ...@@ -490,30 +479,27 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC
**示例:** **示例:**
```ts ```ts
let want = { let want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let accountId = 100; let accountId = 100;
try { try {
this.context.startAbilityForResultWithAccount(want, accountId, (error, result) => { this.context.startAbilityForResultWithAccount(want, accountId, (err, result) => {
if (error.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('startAbilityForResultWithAccount failed, error.code: ' + JSON.stringify(error.code) + console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); return;
return; }
} // 执行正常业务
// 执行正常业务 console.info('startAbilityForResultWithAccount succeed');
console.log('startAbilityForResultWithAccount succeed, result.resultCode = ' + });
result.resultCode + ' result.want = ' + JSON.stringify(result.want)); } catch (err) {
}); // 处理入参错误异常
} catch (paramError) { console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`);
// 处理入参错误异常 }
console.log('startAbilityForResultWithAccount failed, error.code: ' + JSON.stringify(paramError.code) +
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
...@@ -564,32 +550,30 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp ...@@ -564,32 +550,30 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp
**示例:** **示例:**
```ts ```ts
let want = { let want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let accountId = 100; let accountId = 100;
let options = { let options = {
windowMode: 0 windowMode: 0
}; };
try { try {
this.context.startAbilityForResultWithAccount(want, accountId, options, (error) => { this.context.startAbilityForResultWithAccount(want, accountId, options, (err) => {
if (error.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('startAbilityForResultWithAccount failed, error.code: ' + JSON.stringify(error.code) + console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); return;
return; }
} // 执行正常业务
// 执行正常业务 console.info('startAbilityForResultWithAccount succeed');
console.log('startAbilityForResultWithAccount succeed'); });
}); } catch (err) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`);
console.log('startAbilityForResultWithAccount failed, error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
...@@ -645,33 +629,30 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO ...@@ -645,33 +629,30 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO
**示例:** **示例:**
```ts ```ts
let want = { let want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let accountId = 100; let accountId = 100;
let options = { let options = {
windowMode: 0 windowMode: 0
}; };
try { try {
this.context.startAbilityForResultWithAccount(want, accountId, options) this.context.startAbilityForResultWithAccount(want, accountId, options)
.then((result) => { .then((result) => {
// 执行正常业务 // 执行正常业务
console.log('startAbilityForResultWithAccount succeed, result.resultCode = ' + console.info('startAbilityForResultWithAccount succeed');
result.resultCode); })
}) .catch((err) => {
.catch((error) => { // 处理业务逻辑错误
// 处理业务逻辑错误 console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`);
console.log('startAbilityForResultWithAccount failed, error.code: ' + JSON.stringify(error.code) + });
' error.message: ' + JSON.stringify(error.message)); } catch (err) {
}); // 处理入参错误异常
} catch (paramError) { console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`);
// 处理入参错误异常 }
console.log('startAbilityForResultWithAccount failed, error.code: ' + JSON.stringify(paramError.code) +
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
## UIAbilityContext.startServiceExtensionAbility ## UIAbilityContext.startServiceExtensionAbility
...@@ -706,28 +687,26 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void; ...@@ -706,28 +687,26 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
**示例:** **示例:**
```ts ```ts
let want = { let want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility' abilityName: 'ServiceExtensionAbility'
}; };
try { try {
this.context.startServiceExtensionAbility(want, (error) => { this.context.startServiceExtensionAbility(want)
if (error.code) { .then(() => {
// 处理业务逻辑错误
console.log('startServiceExtensionAbility failed, error.code: ' + JSON.stringify(error.code) +
' error.message: ' + JSON.stringify(error.message));
return;
}
// 执行正常业务 // 执行正常业务
console.log('startServiceExtensionAbility succeed'); console.info('startServiceExtensionAbility succeed');
})
.catch((err) => {
// 处理业务逻辑错误
console.error(`startServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
}); });
} catch (paramError) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.log('startServiceExtensionAbility failed, error.code: ' + JSON.stringify(paramError.code) + console.error(`startServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(paramError.message)); }
}
``` ```
## UIAbilityContext.startServiceExtensionAbility ## UIAbilityContext.startServiceExtensionAbility
...@@ -762,28 +741,26 @@ startServiceExtensionAbility(want: Want): Promise\<void>; ...@@ -762,28 +741,26 @@ startServiceExtensionAbility(want: Want): Promise\<void>;
**示例:** **示例:**
```ts ```ts
let want = { let want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility' abilityName: 'ServiceExtensionAbility'
}; };
try { try {
this.context.startServiceExtensionAbility(want) this.context.startServiceExtensionAbility(want)
.then(() => { .then(() => {
// 执行正常业务 // 执行正常业务
console.log('startServiceExtensionAbility succeed'); console.info('startServiceExtensionAbility succeed');
}) })
.catch((error) => { .catch((err) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('startServiceExtensionAbility failed, error.code: ' + JSON.stringify(error.code) + console.error(`startServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); });
}); } catch (paramError) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`startServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
console.log('startServiceExtensionAbility failed, error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
## UIAbilityContext.startServiceExtensionAbilityWithAccount ## UIAbilityContext.startServiceExtensionAbilityWithAccount
...@@ -822,29 +799,27 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -822,29 +799,27 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
**示例:** **示例:**
```ts ```ts
let want = { let want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility' abilityName: 'ServiceExtensionAbility'
}; };
let accountId = 100; let accountId = 100;
try { try {
this.context.startServiceExtensionAbilityWithAccount(want, accountId, (error) => { this.context.startServiceExtensionAbilityWithAccount(want, accountId, (err) => {
if (error.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('startServiceExtensionAbilityWithAccount failed, error.code: ' + JSON.stringify(error.code) + console.error(`startServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); return;
return; }
} // 执行正常业务
// 执行正常业务 console.info('startServiceExtensionAbilityWithAccount succeed');
console.log('startServiceExtensionAbilityWithAccount succeed'); });
}); } catch (err) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`startServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
console.log('startServiceExtensionAbilityWithAccount failed, error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
## UIAbilityContext.startServiceExtensionAbilityWithAccount ## UIAbilityContext.startServiceExtensionAbilityWithAccount
...@@ -882,29 +857,27 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ ...@@ -882,29 +857,27 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\
**示例:** **示例:**
```ts ```ts
let want = { let want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility' abilityName: 'ServiceExtensionAbility'
}; };
let accountId = 100; let accountId = 100;
try { try {
this.context.startServiceExtensionAbilityWithAccount(want, accountId) this.context.startServiceExtensionAbilityWithAccount(want, accountId)
.then(() => { .then(() => {
// 执行正常业务 // 执行正常业务
console.log('startServiceExtensionAbilityWithAccount succeed'); console.info('startServiceExtensionAbilityWithAccount succeed');
}) })
.catch((error) => { .catch((err) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('startServiceExtensionAbilityWithAccount failed, error.code: ' + JSON.stringify(error.code) + console.error(`startServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); });
}); } catch (err) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`startServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
console.log('startServiceExtensionAbilityWithAccount failed, error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
## UIAbilityContext.stopServiceExtensionAbility ## UIAbilityContext.stopServiceExtensionAbility
...@@ -938,28 +911,26 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void; ...@@ -938,28 +911,26 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
**示例:** **示例:**
```ts ```ts
let want = { let want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility' abilityName: 'ServiceExtensionAbility'
}; };
try { try {
this.context.stopServiceExtensionAbility(want, (error) => { this.context.stopServiceExtensionAbility(want, (err) => {
if (error.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('stopServiceExtensionAbility failed, error.code: ' + JSON.stringify(error.code) + console.error(`stopServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); return;
return; }
} // 执行正常业务
// 执行正常业务 console.info('stopServiceExtensionAbility succeed');
console.log('stopServiceExtensionAbility succeed'); });
}); } catch (err) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`stopServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
console.log('stopServiceExtensionAbility failed, error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
## UIAbilityContext.stopServiceExtensionAbility ## UIAbilityContext.stopServiceExtensionAbility
...@@ -993,28 +964,26 @@ stopServiceExtensionAbility(want: Want): Promise\<void>; ...@@ -993,28 +964,26 @@ stopServiceExtensionAbility(want: Want): Promise\<void>;
**示例:** **示例:**
```ts ```ts
let want = { let want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility' abilityName: 'ServiceExtensionAbility'
}; };
try { try {
this.context.stopServiceExtensionAbility(want) this.context.stopServiceExtensionAbility(want)
.then(() => { .then(() => {
// 执行正常业务 // 执行正常业务
console.log('stopServiceExtensionAbility succeed'); console.info('stopServiceExtensionAbility succeed');
}) })
.catch((error) => { .catch((err) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('stopServiceExtensionAbility failed, error.code: ' + JSON.stringify(error.code) + console.error(`stopServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); });
}); } catch (err) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`stopServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
console.log('stopServiceExtensionAbility failed, error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
## UIAbilityContext.stopServiceExtensionAbilityWithAccount ## UIAbilityContext.stopServiceExtensionAbilityWithAccount
...@@ -1052,29 +1021,27 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -1052,29 +1021,27 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
**示例:** **示例:**
```ts ```ts
let want = { let want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility' abilityName: 'ServiceExtensionAbility'
}; };
let accountId = 100; let accountId = 100;
try { try {
this.context.stopServiceExtensionAbilityWithAccount(want, accountId, (error) => { this.context.stopServiceExtensionAbilityWithAccount(want, accountId, (err) => {
if (error.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('stopServiceExtensionAbilityWithAccount failed, error.code: ' + JSON.stringify(error.code) + console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); return;
return; }
} // 执行正常业务
// 执行正常业务 console.info('stopServiceExtensionAbilityWithAccount succeed');
console.log('stopServiceExtensionAbilityWithAccount succeed'); });
}); } catch (err) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
console.log('stopServiceExtensionAbilityWithAccount failed, error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
## UIAbilityContext.stopServiceExtensionAbilityWithAccount ## UIAbilityContext.stopServiceExtensionAbilityWithAccount
...@@ -1111,29 +1078,27 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< ...@@ -1111,29 +1078,27 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\<
**示例:** **示例:**
```ts ```ts
let want = { let want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility' abilityName: 'ServiceExtensionAbility'
}; };
let accountId = 100; let accountId = 100;
try { try {
this.context.stopServiceExtensionAbilityWithAccount(want, accountId) this.context.stopServiceExtensionAbilityWithAccount(want, accountId)
.then(() => { .then(() => {
// 执行正常业务 // 执行正常业务
console.log('stopServiceExtensionAbilityWithAccount succeed'); console.info('stopServiceExtensionAbilityWithAccount succeed');
}) })
.catch((error) => { .catch((err) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('stopServiceExtensionAbilityWithAccount failed, error.code: ' + JSON.stringify(error.code) + console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); });
}); } catch (err) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
console.log('stopServiceExtensionAbilityWithAccount failed, error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
## UIAbilityContext.terminateSelf ## UIAbilityContext.terminateSelf
...@@ -1165,20 +1130,18 @@ terminateSelf(callback: AsyncCallback&lt;void&gt;): void; ...@@ -1165,20 +1130,18 @@ terminateSelf(callback: AsyncCallback&lt;void&gt;): void;
```ts ```ts
try { try {
this.context.terminateSelf((error) => { this.context.terminateSelf((err) => {
if (error.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('terminateSelf failed, error.code: ' + JSON.stringify(error.code) + console.error(`terminateSelf failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message));
return; return;
} }
// 执行正常业务 // 执行正常业务
console.log('terminateSelf succeed'); console.info('terminateSelf succeed');
}); });
} catch (error) { } catch (err) {
// 捕获同步的参数错误 // 捕获同步的参数错误
console.log('terminateSelf failed, error.code: ' + JSON.stringify(error.code) + console.error(`terminateSelf failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message));
} }
``` ```
...@@ -1215,17 +1178,15 @@ terminateSelf(): Promise&lt;void&gt;; ...@@ -1215,17 +1178,15 @@ terminateSelf(): Promise&lt;void&gt;;
this.context.terminateSelf() this.context.terminateSelf()
.then(() => { .then(() => {
// 执行正常业务 // 执行正常业务
console.log('terminateSelf succeed'); console.info('terminateSelf succeed');
}) })
.catch((error) => { .catch((err) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('terminateSelf failed, error.code: ' + JSON.stringify(error.code) + console.error(`terminateSelf failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message));
}); });
} catch (error) { } catch (error) {
// 捕获同步的参数错误 // 捕获同步的参数错误
console.log('terminateSelf failed, error.code: ' + JSON.stringify(error.code) + console.error(`terminateSelf failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message));
} }
``` ```
...@@ -1259,33 +1220,31 @@ terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback&lt;voi ...@@ -1259,33 +1220,31 @@ terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback&lt;voi
**示例:** **示例:**
```ts ```ts
let want = { let want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let resultCode = 100; let resultCode = 100;
// 返回给接口调用方AbilityResult信息 // 返回给接口调用方AbilityResult信息
let abilityResult = { let abilityResult = {
want, want,
resultCode resultCode
}; };
try { try {
this.context.terminateSelfWithResult(abilityResult, (error) => { this.context.terminateSelfWithResult(abilityResult, (err) => {
if (error.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('terminateSelfWithResult failed, error.code: ' + JSON.stringify(error.code) + console.error(`terminateSelfWithResult failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); return;
return; }
} // 执行正常业务
// 执行正常业务 console.info('terminateSelfWithResult succeed');
console.log('terminateSelfWithResult succeed'); });
}); } catch (err) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`terminateSelfWithResult failed, code is ${err.code}, message is ${err.message}`);
console.log('terminateSelfWithResult failed, error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
...@@ -1323,33 +1282,31 @@ terminateSelfWithResult(parameter: AbilityResult): Promise&lt;void&gt;; ...@@ -1323,33 +1282,31 @@ terminateSelfWithResult(parameter: AbilityResult): Promise&lt;void&gt;;
**示例:** **示例:**
```ts ```ts
let want = { let want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let resultCode = 100; let resultCode = 100;
// 返回给接口调用方AbilityResult信息 // 返回给接口调用方AbilityResult信息
let abilityResult = { let abilityResult = {
want, want,
resultCode resultCode
}; };
try { try {
this.context.terminateSelfWithResult(abilityResult) this.context.terminateSelfWithResult(abilityResult)
.then(() => { .then(() => {
// 执行正常业务 // 执行正常业务
console.log('terminateSelfWithResult succeed'); console.info('terminateSelfWithResult succeed');
}) })
.catch((error) => { .catch((err) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('terminateSelfWithResult failed, error.code: ' + JSON.stringify(error.code) + console.error(`terminateSelfWithResult failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); });
}); } catch (err) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`terminateSelfWithResult failed, code is ${err.code}, message is ${err.message}`);
console.log('terminateSelfWithResult failed, error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
## UIAbilityContext.connectServiceExtensionAbility ## UIAbilityContext.connectServiceExtensionAbility
...@@ -1385,31 +1342,30 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number; ...@@ -1385,31 +1342,30 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number;
**示例:** **示例:**
```ts ```ts
let want = { let want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility' abilityName: 'ServiceExtensionAbility'
}; };
let options = { let options = {
onConnect(elementName, remote) { onConnect(elementName, remote) {
console.log('----------- onConnect -----------') console.info('onConnect...')
}, },
onDisconnect(elementName) { onDisconnect(elementName) {
console.log('----------- onDisconnect -----------') console.info('onDisconnect...')
}, },
onFailed(code) { onFailed(code) {
console.log('----------- onFailed -----------') console.info('onFailed...')
}
};
let connection = null;
try {
connection = this.context.connectServiceExtensionAbility(want, options);
} catch (paramError) {
// 处理入参错误异常
console.log('error.code: ' + JSON.stringify(paramError.code) +
' error.message: ' + JSON.stringify(paramError.message));
} }
};
let connection = null;
try {
connection = this.context.connectServiceExtensionAbility(want, options);
} catch (err) {
// 处理入参错误异常
console.error(`connectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
}
``` ```
...@@ -1451,32 +1407,31 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options ...@@ -1451,32 +1407,31 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options
**示例:** **示例:**
```ts ```ts
let want = { let want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility' abilityName: 'ServiceExtensionAbility'
}; };
let accountId = 100; let accountId = 100;
let options = { let options = {
onConnect(elementName, remote) { onConnect(elementName, remote) {
console.log('----------- onConnect -----------') console.info('onConnect...')
}, },
onDisconnect(elementName) { onDisconnect(elementName) {
console.log('----------- onDisconnect -----------') console.info('onDisconnect...')
}, },
onFailed(code) { onFailed(code) {
console.log('----------- onFailed -----------') console.info('onFailed...')
}
};
let connection = null;
try {
connection = this.context.connectServiceExtensionAbilityWithAccount(want, accountId, options);
} catch (paramError) {
// 处理入参错误异常
console.log('error.code: ' + JSON.stringify(paramError.code) +
' error.message: ' + JSON.stringify(paramError.message));
} }
};
let connection = null;
try {
connection = this.context.connectServiceExtensionAbilityWithAccount(want, accountId, options);
} catch (err) {
// 处理入参错误异常
console.error(`connectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
}
``` ```
## UIAbilityContext.disconnectServiceExtensionAbility ## UIAbilityContext.disconnectServiceExtensionAbility
...@@ -1511,25 +1466,23 @@ disconnectServiceExtensionAbility(connection: number): Promise\<void>; ...@@ -1511,25 +1466,23 @@ disconnectServiceExtensionAbility(connection: number): Promise\<void>;
**示例:** **示例:**
```ts ```ts
// connection为connectServiceExtensionAbility中的返回值 // connection为connectServiceExtensionAbility中的返回值
let connection = 1; let connection = 1;
try { try {
this.context.disconnectServiceExtensionAbility(connection) this.context.disconnectServiceExtensionAbility(connection, (err) => {
.then(() => { if (err.code) {
// 执行正常业务 // 处理业务逻辑错误
console.log('disconnectServiceExtensionAbility succeed'); console.error(`disconnectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
}) return;
.catch((error) => { }
// 处理业务逻辑错误 // 执行正常业务
console.log('disconnectServiceExtensionAbility failed, error.code: ' + JSON.stringify(error.code) + console.info('disconnectServiceExtensionAbility succeed');
' error.message: ' + JSON.stringify(error.message)); });
}); } catch (err) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`disconnectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
console.log('error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
## UIAbilityContext.disconnectServiceExtensionAbility ## UIAbilityContext.disconnectServiceExtensionAbility
...@@ -1559,25 +1512,23 @@ disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback\<vo ...@@ -1559,25 +1512,23 @@ disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback\<vo
**示例:** **示例:**
```ts ```ts
// connection为connectServiceExtensionAbility中的返回值 // connection为connectServiceExtensionAbility中的返回值
let connection = 1; let connection = 1;
try { try {
this.context.disconnectServiceExtensionAbility(connection, (error) => { this.context.disconnectServiceExtensionAbility(connection, (err) => {
if (error.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('disconnectServiceExtensionAbility failed, error.code: ' + JSON.stringify(error.code) + console.error(`disconnectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); return;
return; }
} // 执行正常业务
// 执行正常业务 console.info('disconnectServiceExtensionAbility succeed');
console.log('disconnectServiceExtensionAbility succeed'); });
}); } catch (err) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`disconnectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
console.log('error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
## UIAbilityContext.startAbilityByCall ## UIAbilityContext.startAbilityByCall
...@@ -1628,66 +1579,62 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;; ...@@ -1628,66 +1579,62 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;;
后台启动: 后台启动:
```ts ```ts
let caller; let caller;
// 后台启动Ability,不配置parameters // 后台启动Ability,不配置parameters
let wantBackground = { let wantBackground = {
bundleName: 'com.example.myservice', bundleName: 'com.example.myapplication',
moduleName: 'entry', moduleName: 'entry',
abilityName: 'EntryAbility', abilityName: 'EntryAbility',
deviceId: '' deviceId: ''
}; };
try { try {
this.context.startAbilityByCall(wantBackground) this.context.startAbilityByCall(wantBackground)
.then((obj) => { .then((obj) => {
// 执行正常业务 // 执行正常业务
caller = obj; caller = obj;
console.log('startAbilityByCall succeed'); console.info('startAbilityByCall succeed');
}).catch((error) => { }).catch((err) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('startAbilityByCall failed, error.code: ' + JSON.stringify(error.code) + console.error(`startAbilityByCall failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); });
}); } catch (err) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`startAbilityByCall failed, code is ${err.code}, message is ${err.message}`);
console.log('error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
前台启动: 前台启动:
```ts ```ts
let caller; let caller;
// 前台启动Ability,将parameters中的'ohos.aafwk.param.callAbilityToForeground'配置为true // 前台启动Ability,将parameters中的'ohos.aafwk.param.callAbilityToForeground'配置为true
let wantForeground = { let wantForeground = {
bundleName: 'com.example.myservice', bundleName: 'com.example.myapplication',
moduleName: 'entry', moduleName: 'entry',
abilityName: 'EntryAbility', abilityName: 'EntryAbility',
deviceId: '', deviceId: '',
parameters: { parameters: {
'ohos.aafwk.param.callAbilityToForeground': true 'ohos.aafwk.param.callAbilityToForeground': true
}
};
try {
this.context.startAbilityByCall(wantForeground)
.then((obj) => {
// 执行正常业务
caller = obj;
console.log('startAbilityByCall succeed');
}).catch((error) => {
// 处理业务逻辑错误
console.log('startAbilityByCall failed, error.code: ' + JSON.stringify(error.code) +
' error.message: ' + JSON.stringify(error.message));
});
} catch (paramError) {
// 处理入参错误异常
console.log('error.code: ' + JSON.stringify(paramError.code) +
' error.message: ' + JSON.stringify(paramError.message));
} }
};
try {
this.context.startAbilityByCall(wantForeground)
.then((obj) => {
// 执行正常业务
caller = obj;
console.info('startAbilityByCall succeed');
}).catch((error) => {
// 处理业务逻辑错误
console.error(`startAbilityByCall failed, code is ${err.code}, message is ${err.message}`);
});
} catch (paramError) {
// 处理入参错误异常
console.error(`startAbilityByCall failed, code is ${err.code}, message is ${err.message}`);
}
``` ```
## UIAbilityContext.startAbilityWithAccount ## UIAbilityContext.startAbilityWithAccount
...@@ -1736,29 +1683,27 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< ...@@ -1736,29 +1683,27 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\<
**示例:** **示例:**
```ts ```ts
let want = { let want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let accountId = 100; let accountId = 100;
try { try {
this.context.startAbilityWithAccount(want, accountId, (error) => { this.context.startAbilityWithAccount(want, accountId, (err) => {
if (error.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('startAbilityWithAccount failed, error.code: ' + JSON.stringify(error.code) + console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); return;
return; }
} // 执行正常业务
// 执行正常业务 console.info('startAbilityWithAccount succeed');
console.log('startAbilityWithAccount succeed'); });
}); } catch (err) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
console.log('error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
...@@ -1809,32 +1754,30 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca ...@@ -1809,32 +1754,30 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca
**示例:** **示例:**
```ts ```ts
let want = { let want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let accountId = 100; let accountId = 100;
let options = { let options = {
windowMode: 0 windowMode: 0
}; };
try { try {
this.context.startAbilityWithAccount(want, accountId, options, (error) => { this.context.startAbilityWithAccount(want, accountId, options, (err) => {
if (error.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('startAbilityWithAccount failed, error.code: ' + JSON.stringify(error.code) + console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); return;
return; }
} // 执行正常业务
// 执行正常业务 console.info('startAbilityWithAccount succeed');
console.log('startAbilityWithAccount succeed'); });
}); } catch (err) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
console.log('startAbilityWithAccount failed, error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
...@@ -1884,39 +1827,37 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): ...@@ -1884,39 +1827,37 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions):
**示例:** **示例:**
```ts ```ts
let want = { let want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let accountId = 100; let accountId = 100;
let options = { let options = {
windowMode: 0 windowMode: 0
}; };
try { try {
this.context.startAbilityWithAccount(want, accountId, options) this.context.startAbilityWithAccount(want, accountId, options)
.then(() => { .then(() => {
// 执行正常业务 // 执行正常业务
console.log('startAbilityWithAccount succeed'); console.info('startAbilityWithAccount succeed');
}) })
.catch((error) => { .catch((err) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('startAbilityWithAccount failed, error.code: ' + JSON.stringify(error.code) + console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); });
}); } catch (err) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
console.log('startAbilityWithAccount failed, error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
## UIAbilityContext.setMissionLabel ## UIAbilityContext.setMissionLabel
setMissionLabel(label: string, callback:AsyncCallback&lt;void&gt;): void; setMissionLabel(label: string, callback:AsyncCallback&lt;void&gt;): void;
设置ability在任务中显示的名称(callback形式)。 设置UIAbility在任务中显示的名称(callback形式)。
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core **系统能力**:SystemCapability.Ability.AbilityRuntime.Core
...@@ -1931,7 +1872,7 @@ setMissionLabel(label: string, callback:AsyncCallback&lt;void&gt;): void; ...@@ -1931,7 +1872,7 @@ setMissionLabel(label: string, callback:AsyncCallback&lt;void&gt;): void;
```ts ```ts
this.context.setMissionLabel('test', (result) => { this.context.setMissionLabel('test', (result) => {
console.log('setMissionLabel:' + JSON.stringify(result)); console.info(`setMissionLabel: ${JSON.stringify(result)}`);
}); });
``` ```
...@@ -1939,7 +1880,7 @@ setMissionLabel(label: string, callback:AsyncCallback&lt;void&gt;): void; ...@@ -1939,7 +1880,7 @@ setMissionLabel(label: string, callback:AsyncCallback&lt;void&gt;): void;
setMissionLabel(label: string): Promise&lt;void&gt;; setMissionLabel(label: string): Promise&lt;void&gt;;
设置ability在任务中显示的名称(promise形式)。 设置UIAbility在任务中显示的名称(promise形式)。
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core **系统能力**:SystemCapability.Ability.AbilityRuntime.Core
...@@ -1966,9 +1907,9 @@ setMissionLabel(label: string): Promise&lt;void&gt;; ...@@ -1966,9 +1907,9 @@ setMissionLabel(label: string): Promise&lt;void&gt;;
```ts ```ts
this.context.setMissionLabel('test').then(() => { this.context.setMissionLabel('test').then(() => {
console.log('success'); console.info('success');
}).catch((error) => { }).catch((err) => {
console.log('failed:' + JSON.stringify(error)); console.error(`setMissionLabel failed, code is ${err.code}, message is ${err.message}`);
}); });
``` ```
## UIAbilityContext.setMissionIcon ## UIAbilityContext.setMissionIcon
...@@ -1999,6 +1940,7 @@ setMissionIcon(icon: image.PixelMap, callback:AsyncCallback\<void>): void; ...@@ -1999,6 +1940,7 @@ setMissionIcon(icon: image.PixelMap, callback:AsyncCallback\<void>): void;
```ts ```ts
import image from '@ohos.multimedia.image'; import image from '@ohos.multimedia.image';
let imagePixelMap; let imagePixelMap;
let color = new ArrayBuffer(0); let color = new ArrayBuffer(0);
let initializationOptions = { let initializationOptions = {
...@@ -2012,10 +1954,10 @@ setMissionIcon(icon: image.PixelMap, callback:AsyncCallback\<void>): void; ...@@ -2012,10 +1954,10 @@ setMissionIcon(icon: image.PixelMap, callback:AsyncCallback\<void>): void;
imagePixelMap = data; imagePixelMap = data;
}) })
.catch((err) => { .catch((err) => {
console.log('--------- createPixelMap fail, err: ---------', err); console.error(`createPixelMap failed, code is ${err.code}, message is ${err.message}`);
}); });
this.context.setMissionIcon(imagePixelMap, (err) => { this.context.setMissionIcon(imagePixelMap, (err) => {
console.log('---------- setMissionIcon fail, err: -----------', err); console.error(`setMissionLabel failed, code is ${err.code}, message is ${err.message}`);
}) })
``` ```
...@@ -2065,21 +2007,21 @@ setMissionIcon(icon: image.PixelMap): Promise\<void>; ...@@ -2065,21 +2007,21 @@ setMissionIcon(icon: image.PixelMap): Promise\<void>;
imagePixelMap = data; imagePixelMap = data;
}) })
.catch((err) => { .catch((err) => {
console.log('--------- createPixelMap fail, err: ---------', err); console.error(`createPixelMap failed, code is ${err.code}, message is ${err.message}`);
}); });
this.context.setMissionIcon(imagePixelMap) this.context.setMissionIcon(imagePixelMap)
.then(() => { .then(() => {
console.log('-------------- setMissionIcon success -------------'); console.info('setMissionIcon succeed');
}) })
.catch((err) => { .catch((err) => {
console.log('-------------- setMissionIcon fail, err: -------------', err); console.error(`setMissionLabel failed, code is ${err.code}, message is ${err.message}`);
}); });
``` ```
## UIAbilityContext.restoreWindowStage ## UIAbilityContext.restoreWindowStage
restoreWindowStage(localStorage: LocalStorage) : void; restoreWindowStage(localStorage: LocalStorage) : void;
恢复ability中的window stage数据。 恢复UIAbility中的WindowStage数据。
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core **系统能力**:SystemCapability.Ability.AbilityRuntime.Core
...@@ -2107,7 +2049,7 @@ restoreWindowStage(localStorage: LocalStorage) : void; ...@@ -2107,7 +2049,7 @@ restoreWindowStage(localStorage: LocalStorage) : void;
isTerminating(): boolean; isTerminating(): boolean;
查询ability是否在terminating状态。 查询UIAbility是否在terminating状态。
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core **系统能力**:SystemCapability.Ability.AbilityRuntime.Core
...@@ -2128,7 +2070,7 @@ isTerminating(): boolean; ...@@ -2128,7 +2070,7 @@ isTerminating(): boolean;
```ts ```ts
let isTerminating = this.context.isTerminating(); let isTerminating = this.context.isTerminating();
console.log('ability state :' + isTerminating); console.info(`ability state is ${isTerminating}`);
``` ```
## UIAbilityContext.requestDialogService ## UIAbilityContext.requestDialogService
...@@ -2154,30 +2096,28 @@ requestDialogService(want: Want, result: AsyncCallback&lt;dialogRequest.RequestR ...@@ -2154,30 +2096,28 @@ requestDialogService(want: Want, result: AsyncCallback&lt;dialogRequest.RequestR
**示例:** **示例:**
```ts ```ts
import dialogRequest from '@ohos.app.ability.dialogRequest'; import dialogRequest from '@ohos.app.ability.dialogRequest';
let want = { let want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'AuthAccountServiceExtension' abilityName: 'AuthAccountServiceExtension'
}; };
try { try {
this.context.requestDialogService(want, (error, result) => { this.context.requestDialogService(want, (err, result) => {
if (error && error.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('requestDialogService failed, error.code: ' + JSON.stringify(error.code) + console.error(`requestDialogService failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(error.message)); return;
return; }
} // 执行正常业务
// 执行正常业务 console.info('requestDialogService succeed, result = ' + JSON.stringify(result));
console.log('requestDialogService succeed, result = ' + JSON.stringify(result)); });
}); } catch (err) {
} catch (paramError) { // 处理入参错误异常
// 处理入参错误异常 console.error(`requestDialogService failed, code is ${err.code}, message is ${err.message}`);
console.log('requestDialogService failed, error.code: ' + JSON.stringify(paramError.code) + }
' error.message: ' + JSON.stringify(paramError.message));
}
``` ```
## UIAbilityContext.requestDialogService ## UIAbilityContext.requestDialogService
...@@ -2212,23 +2152,22 @@ requestDialogService(want: Want): Promise&lt;dialogRequest.RequestResult&gt;; ...@@ -2212,23 +2152,22 @@ requestDialogService(want: Want): Promise&lt;dialogRequest.RequestResult&gt;;
import dialogRequest from '@ohos.app.ability.dialogRequest'; import dialogRequest from '@ohos.app.ability.dialogRequest';
let want = { let want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'AuthAccountServiceExtension' abilityName: 'AuthAccountServiceExtension'
}; };
try { try {
this.context.requestDialogService(want) this.context.requestDialogService(want)
.then((result) => { .then((result) => {
// 执行正常业务 // 执行正常业务
console.log('requestDialogService succeed, result = ' + JSON.stringify(result)); console.info('requestDialogService succeed, result = ' + JSON.stringify(result));
}) })
.catch((error) => { .catch((err) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('requestDialogService failed, error= ' + JSON.stringify(error)); console.error(`requestDialogService failed, code is ${err.code}, message is ${err.message}`);
}); });
} catch (paramError) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.log('requestDialogService failed, error.code: ' + JSON.stringify(paramError.code) + console.error(`requestDialogService failed, code is ${err.code}, message is ${err.message}`);
' error.message: ' + JSON.stringify(paramError.message));
} }
``` ```
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册