You need to sign in or sign up before continuing.
提交 cbc11c13 编写于 作者: L liuliu

ability api

Signed-off-by: Nliuliu <liuliu40@huawei.com>
Change-Id: I17606ce668ee9b396808194a937f10916448c458
上级 d62be8c3
...@@ -35,6 +35,8 @@ getId(uri: string): number ...@@ -35,6 +35,8 @@ getId(uri: string): number
**示例:** **示例:**
```ts ```ts
import dataUriUtils from '@ohos.ability.dataUriUtils';
let id = dataUriUtils.getId('com.example.dataUriUtils/1221'); let id = dataUriUtils.getId('com.example.dataUriUtils/1221');
``` ```
...@@ -64,6 +66,8 @@ attachId(uri: string, id: number): string ...@@ -64,6 +66,8 @@ attachId(uri: string, id: number): string
**示例:** **示例:**
```ts ```ts
import dataUriUtils from '@ohos.ability.dataUriUtils';
let id = 1122; let id = 1122;
let uri = dataUriUtils.attachId( let uri = dataUriUtils.attachId(
'com.example.dataUriUtils', 'com.example.dataUriUtils',
...@@ -96,6 +100,8 @@ deleteId(uri: string): string ...@@ -96,6 +100,8 @@ deleteId(uri: string): string
**示例:** **示例:**
```ts ```ts
import dataUriUtils from '@ohos.ability.dataUriUtils';
let uri = dataUriUtils.deleteId('com.example.dataUriUtils/1221'); let uri = dataUriUtils.deleteId('com.example.dataUriUtils/1221');
``` ```
...@@ -125,6 +131,8 @@ updateId(uri: string, id: number): string ...@@ -125,6 +131,8 @@ updateId(uri: string, id: number): string
**示例:** **示例:**
```ts ```ts
import dataUriUtils from '@ohos.ability.dataUriUtils';
let id = 1122; let id = 1122;
let uri = dataUriUtils.updateId( let uri = dataUriUtils.updateId(
'com.example.dataUriUtils/1221', 'com.example.dataUriUtils/1221',
......
...@@ -587,15 +587,7 @@ connectAbility(request: Want, options:ConnectOptions): number ...@@ -587,15 +587,7 @@ connectAbility(request: Want, options:ConnectOptions): number
```ts ```ts
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
function onConnectCallback(element, remote){
console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
}
function onDisconnectCallback(element){
console.log('ConnectAbility onDisconnect element.deviceId : ${element.deviceId}')
}
function onFailedCallback(code){
console.error('featureAbilityTest ConnectAbility onFailed errCode : ${code}')
}
let connectId = featureAbility.connectAbility( let connectId = featureAbility.connectAbility(
{ {
deviceId: '', deviceId: '',
...@@ -603,9 +595,15 @@ let connectId = featureAbility.connectAbility( ...@@ -603,9 +595,15 @@ let connectId = featureAbility.connectAbility(
abilityName: 'com.ix.ServiceAbility.ServiceAbilityA', abilityName: 'com.ix.ServiceAbility.ServiceAbilityA',
}, },
{ {
onConnect: onConnectCallback, onConnect: (element, remote) => {
onDisconnect: onDisconnectCallback, console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
onFailed: onFailedCallback, },
onDisconnect: (element) => {
console.log('ConnectAbility onDisconnect element.deviceId : ${element.deviceId}')
},
onFailed: (code) => {
console.error('featureAbilityTest ConnectAbility onFailed errCode : ${code}')
},
}, },
); );
``` ```
...@@ -630,24 +628,22 @@ disconnectAbility(connection: number, callback:AsyncCallback\<void>): void ...@@ -630,24 +628,22 @@ disconnectAbility(connection: number, callback:AsyncCallback\<void>): void
```ts ```ts
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
function onConnectCallback(element, remote){
console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
}
function onDisconnectCallback(element){
console.log('ConnectAbility onDisconnect element.deviceId : ${element.deviceId}');
}
function onFailedCallback(code){
console.error('featureAbilityTest ConnectAbility onFailed errCode : ${code}');
}
let connectId = featureAbility.connectAbility( let connectId = featureAbility.connectAbility(
{ {
bundleName: 'com.ix.ServiceAbility', bundleName: 'com.ix.ServiceAbility',
abilityName: 'com.ix.ServiceAbility.ServiceAbilityA', abilityName: 'com.ix.ServiceAbility.ServiceAbilityA',
}, },
{ {
onConnect: onConnectCallback, onConnect: (element, remote) => {
onDisconnect: onDisconnectCallback, console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
onFailed: onFailedCallback, },
onDisconnect: (element) => {
console.log('ConnectAbility onDisconnect element.deviceId : ${element.deviceId}');
},
onFailed: (code) => {
console.error('featureAbilityTest ConnectAbility onFailed errCode : ${code}');
},
}, },
); );
...@@ -685,30 +681,29 @@ disconnectAbility(connection: number): Promise\<void> ...@@ -685,30 +681,29 @@ disconnectAbility(connection: number): Promise\<void>
```ts ```ts
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
function onConnectCallback(element, remote){ import { BusinessError } from '@ohos.base';
console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
}
function onDisconnectCallback(element){
console.log('ConnectAbility onDisconnect element.deviceId : ${element.deviceId}');
}
function onFailedCallback(code){
console.error('featureAbilityTest ConnectAbility onFailed errCode : ${code}');
}
let connectId = featureAbility.connectAbility( let connectId = featureAbility.connectAbility(
{ {
bundleName: 'com.ix.ServiceAbility', bundleName: 'com.ix.ServiceAbility',
abilityName: 'com.ix.ServiceAbility.ServiceAbilityA', abilityName: 'com.ix.ServiceAbility.ServiceAbilityA',
}, },
{ {
onConnect: onConnectCallback, onConnect: (element, remote) => {
onDisconnect: onDisconnectCallback, console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
onFailed: onFailedCallback, },
onDisconnect: (element) => {
console.log('ConnectAbility onDisconnect element.deviceId : ${element.deviceId}');
},
onFailed: (code) => {
console.error('featureAbilityTest ConnectAbility onFailed errCode : ${code}');
},
}, },
); );
featureAbility.disconnectAbility(connectId).then((data) => { featureAbility.disconnectAbility(connectId).then((data) => {
console.log('data: ${data)}') console.log('data: ${data)}')
}).catch((error)=>{ }).catch((error: BusinessError)=>{
console.error('featureAbilityTest result errCode : ${error.code}'); console.error('featureAbilityTest result errCode : ${error.code}');
}); });
``` ```
...@@ -731,7 +726,11 @@ getWindow(callback: AsyncCallback\<window.Window>): void ...@@ -731,7 +726,11 @@ getWindow(callback: AsyncCallback\<window.Window>): void
**示例:** **示例:**
```ts ```ts
featureAbility.getWindow((error, data) => { import featureAbility from '@ohos.ability.featureAbility';
import { BusinessError } from '@ohos.base';
import window from '@ohos.window';
featureAbility.getWindow((error: BusinessError, data: window.Window) => {
if (error && error.code !== 0) { if (error && error.code !== 0) {
console.error('getWindow fail, error: ${JSON.stringify(error)}'); console.error('getWindow fail, error: ${JSON.stringify(error)}');
} else { } else {
...@@ -757,6 +756,8 @@ getWindow(): Promise\<window.Window>; ...@@ -757,6 +756,8 @@ getWindow(): Promise\<window.Window>;
**示例:** **示例:**
```ts ```ts
import featureAbility from '@ohos.ability.featureAbility';
featureAbility.getWindow().then((data) => { featureAbility.getWindow().then((data) => {
console.info('getWindow data: ${typeof(data)}'); console.info('getWindow data: ${typeof(data)}');
}); });
......
...@@ -233,8 +233,9 @@ startBackgroundRunning(id: number, request: NotificationRequest, callback: Async ...@@ -233,8 +233,9 @@ startBackgroundRunning(id: number, request: NotificationRequest, callback: Async
import notification from '@ohos.notification'; import notification from '@ohos.notification';
import particleAbility from '@ohos.ability.particleAbility'; import particleAbility from '@ohos.ability.particleAbility';
import wantAgent from '@ohos.app.ability.wantAgent'; import wantAgent from '@ohos.app.ability.wantAgent';
import { BusinessError } from '@ohos.base';
function callback(error, data) { function callback(error: BusinessError, data: void) {
if (error && error.code !== 0) { if (error && error.code !== 0) {
console.error('Operation failed error: ${JSON.stringify(error)}'); console.error('Operation failed error: ${JSON.stringify(error)}');
} else { } else {
...@@ -242,7 +243,7 @@ function callback(error, data) { ...@@ -242,7 +243,7 @@ function callback(error, data) {
} }
} }
let wantAgentInfo = { let wantAgentInfo: wantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
...@@ -255,20 +256,19 @@ let wantAgentInfo = { ...@@ -255,20 +256,19 @@ let wantAgentInfo = {
}; };
wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => { wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
let basicContent = {
title: 'title',
text: 'text'
};
let notificationContent = {
contentType: notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
normal: basicContent
};
let request = {
content: notificationContent,
wantAgent: wantAgentObj
};
let id = 1; let id = 1;
particleAbility.startBackgroundRunning(id, request, callback); particleAbility.startBackgroundRunning(id, {
content:
{
contentType: notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
normal:
{
title: 'title',
text: 'text'
}
},
wantAgent: wantAgentObj
}, callback);
}); });
``` ```
...@@ -302,8 +302,9 @@ startBackgroundRunning(id: number, request: NotificationRequest): Promise&lt;voi ...@@ -302,8 +302,9 @@ startBackgroundRunning(id: number, request: NotificationRequest): Promise&lt;voi
import notification from '@ohos.notification'; import notification from '@ohos.notification';
import particleAbility from '@ohos.ability.particleAbility'; import particleAbility from '@ohos.ability.particleAbility';
import wantAgent from '@ohos.app.ability.wantAgent'; import wantAgent from '@ohos.app.ability.wantAgent';
import { BusinessError } from '@ohos.base';
let wantAgentInfo = { let wantAgentInfo: wantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
...@@ -316,22 +317,21 @@ let wantAgentInfo = { ...@@ -316,22 +317,21 @@ let wantAgentInfo = {
}; };
wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => { wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
let basicContent = {
title: 'title',
text: 'text'
};
let notificationContent = {
contentType: notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
normal: basicContent
};
let request = {
content: notificationContent,
wantAgent: wantAgentObj
};
let id = 1; let id = 1;
particleAbility.startBackgroundRunning(id, request).then(() => { particleAbility.startBackgroundRunning(id, {
content:
{
contentType: notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
normal:
{
title: 'title',
text: 'text'
}
},
wantAgent: wantAgentObj
}).then(() => {
console.info('Operation succeeded'); console.info('Operation succeeded');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error('Operation failed cause: ${JSON.stringify(err)}'); console.error('Operation failed cause: ${JSON.stringify(err)}');
}); });
}); });
...@@ -356,8 +356,9 @@ cancelBackgroundRunning(callback: AsyncCallback&lt;void&gt;): void; ...@@ -356,8 +356,9 @@ cancelBackgroundRunning(callback: AsyncCallback&lt;void&gt;): void;
```ts ```ts
import particleAbility from '@ohos.ability.particleAbility'; import particleAbility from '@ohos.ability.particleAbility';
import { BusinessError } from '@ohos.base';
function callback(error, data) { function callback(error: BusinessError, data: void) {
if (error && error.code !== 0) { if (error && error.code !== 0) {
console.error('Operation failed error: ${JSON.stringify(error)}'); console.error('Operation failed error: ${JSON.stringify(error)}');
} else { } else {
...@@ -390,7 +391,7 @@ import particleAbility from '@ohos.ability.particleAbility'; ...@@ -390,7 +391,7 @@ import particleAbility from '@ohos.ability.particleAbility';
particleAbility.cancelBackgroundRunning().then(() => { particleAbility.cancelBackgroundRunning().then(() => {
console.info('Operation succeeded'); console.info('Operation succeeded');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error('Operation failed cause: ${JSON.stringify(err)}'); console.error('Operation failed cause: ${JSON.stringify(err)}');
}); });
...@@ -424,33 +425,27 @@ connectAbility(request: Want, options:ConnectOptions): number ...@@ -424,33 +425,27 @@ connectAbility(request: Want, options:ConnectOptions): number
import particleAbility from '@ohos.ability.particleAbility'; import particleAbility from '@ohos.ability.particleAbility';
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
function onConnectCallback(element, remote) {
console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
}
function onDisconnectCallback(element) {
console.log('ConnectAbility onDisconnect element.deviceId: ${element.deviceId}');
}
function onFailedCallback(code) {
console.error('particleAbilityTest ConnectAbility onFailed errCode: ${code}');
}
let connId = particleAbility.connectAbility( let connId = particleAbility.connectAbility(
{ {
bundleName: 'com.ix.ServiceAbility', bundleName: 'com.ix.ServiceAbility',
abilityName: 'ServiceAbilityA', abilityName: 'ServiceAbilityA',
}, },
{ {
onConnect: onConnectCallback, onConnect: (element, remote) => {
onDisconnect: onDisconnectCallback, console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
onFailed: onFailedCallback, },
onDisconnect: (element) => {
console.log('ConnectAbility onDisconnect element.deviceId: ${element.deviceId}');
},
onFailed: (code) => {
console.error('particleAbilityTest ConnectAbility onFailed errCode: ${code}');
},
}, },
); );
particleAbility.disconnectAbility(connId).then((data) => { particleAbility.disconnectAbility(connId).then((data) => {
console.log('data: ${data}'); console.log('data: ${data}');
}).catch((error) => { }).catch((error: BusinessError) => {
console.error('particleAbilityTest result errCode: ${error.code}'); console.error('particleAbilityTest result errCode: ${error.code}');
}); });
``` ```
...@@ -475,27 +470,21 @@ disconnectAbility(connection: number, callback:AsyncCallback\<void>): void; ...@@ -475,27 +470,21 @@ disconnectAbility(connection: number, callback:AsyncCallback\<void>): void;
import particleAbility from '@ohos.ability.particleAbility'; import particleAbility from '@ohos.ability.particleAbility';
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
function onConnectCallback(element, remote) {
console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
}
function onDisconnectCallback(element) {
console.log('ConnectAbility onDisconnect element.deviceId: ${element.deviceId}');
}
function onFailedCallback(code) {
console.error('particleAbilityTest ConnectAbility onFailed errCode: ${code}');
}
let connId = particleAbility.connectAbility( let connId = particleAbility.connectAbility(
{ {
bundleName: 'com.ix.ServiceAbility', bundleName: 'com.ix.ServiceAbility',
abilityName: 'ServiceAbilityA', abilityName: 'ServiceAbilityA',
}, },
{ {
onConnect: onConnectCallback, onConnect: (element, remote) => {
onDisconnect: onDisconnectCallback, console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
onFailed: onFailedCallback, },
onDisconnect: (element) => {
console.log('ConnectAbility onDisconnect element.deviceId: ${element.deviceId}');
},
onFailed: (code) => {
console.error('particleAbilityTest ConnectAbility onFailed errCode: ${code}');
},
}, },
); );
...@@ -524,18 +513,7 @@ disconnectAbility(connection: number): Promise\<void>; ...@@ -524,18 +513,7 @@ disconnectAbility(connection: number): Promise\<void>;
```ts ```ts
import particleAbility from '@ohos.ability.particleAbility'; import particleAbility from '@ohos.ability.particleAbility';
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
import { BusinessError } from '@ohos.base';
function onConnectCallback(element, remote) {
console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
}
function onDisconnectCallback(element) {
console.log('ConnectAbility onDisconnect element.deviceId: ${element.deviceId}');
}
function onFailedCallback(code) {
console.error('particleAbilityTest ConnectAbility onFailed errCode: ${code}');
}
let connId = particleAbility.connectAbility( let connId = particleAbility.connectAbility(
{ {
...@@ -543,18 +521,23 @@ let connId = particleAbility.connectAbility( ...@@ -543,18 +521,23 @@ let connId = particleAbility.connectAbility(
abilityName: 'ServiceAbilityA', abilityName: 'ServiceAbilityA',
}, },
{ {
onConnect: onConnectCallback, onConnect: (element, remote) => {
onDisconnect: onDisconnectCallback, console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
onFailed: onFailedCallback, },
onDisconnect: (element) => {
console.log('ConnectAbility onDisconnect element.deviceId: ${element.deviceId}');
},
onFailed: (code) => {
console.error('particleAbilityTest ConnectAbility onFailed errCode: ${code}');
},
}, },
); );
particleAbility.disconnectAbility(connId).then((data) => { particleAbility.disconnectAbility(connId).then((data) => {
console.log(' data: ${data}'); console.log(' data: ${data}');
}).catch((error) => { }).catch((error: BusinessError) => {
console.error('particleAbilityTest result errCode : ${error.code}'); console.error('particleAbilityTest result errCode : ${error.code}');
}); });
``` ```
## ErrorCode ## ErrorCode
......
...@@ -31,9 +31,10 @@ onConfigurationUpdate(newConfig: Configuration): void; ...@@ -31,9 +31,10 @@ onConfigurationUpdate(newConfig: Configuration): void;
```ts ```ts
// Ability是顶层基类,不支持开发者直接继承。故以派生类UIAbility举例说明。 // Ability是顶层基类,不支持开发者直接继承。故以派生类UIAbility举例说明。
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import { Configuration } from '@ohos.app.ability.Configuration';
class MyUIAbility extends UIAbility { class MyUIAbility extends UIAbility {
onConfigurationUpdate(config) { onConfigurationUpdate(config: Configuration) {
console.log('onConfigurationUpdate, config: ${JSON.stringify(config)}'); console.log('onConfigurationUpdate, config: ${JSON.stringify(config)}');
} }
} }
...@@ -58,9 +59,10 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void; ...@@ -58,9 +59,10 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
```ts ```ts
// Ability是顶层基类,不支持开发者直接继承。故以派生类UIAbility举例说明。 // Ability是顶层基类,不支持开发者直接继承。故以派生类UIAbility举例说明。
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyUIAbility extends UIAbility { class MyUIAbility extends UIAbility {
onMemoryLevel(level) { onMemoryLevel(level: AbilityConstant.MemoryLevel) {
console.log('onMemoryLevel, level: ${JSON.stringify(level)}'); console.log('onMemoryLevel, level: ${JSON.stringify(level)}');
} }
} }
......
...@@ -45,9 +45,11 @@ Ability初次启动原因,该类型为枚举,可配合[Ability](js-apis-app- ...@@ -45,9 +45,11 @@ Ability初次启动原因,该类型为枚举,可配合[Ability](js-apis-app-
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import Want from '@ohos.app.ability.Want';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
if (launchParam.launchReason === AbilityConstant.LaunchReason.START_ABILITY) { if (launchParam.launchReason === AbilityConstant.LaunchReason.START_ABILITY) {
console.log('The ability has been started by the way of startAbility.'); console.log('The ability has been started by the way of startAbility.');
} }
...@@ -77,9 +79,11 @@ Ability上次退出原因,该类型为枚举,可配合[Ability](js-apis-app- ...@@ -77,9 +79,11 @@ Ability上次退出原因,该类型为枚举,可配合[Ability](js-apis-app-
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import Want from '@ohos.app.ability.Want';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
if (launchParam.lastExitReason === AbilityConstant.LastExitReason.ABILITY_NOT_RESPONDING) { if (launchParam.lastExitReason === AbilityConstant.LastExitReason.ABILITY_NOT_RESPONDING) {
console.log('The ability has exit last because the ability was not responding.'); console.log('The ability has exit last because the ability was not responding.');
} }
...@@ -103,9 +107,10 @@ Ability迁移结果,该类型为枚举,可配合[Ability](js-apis-app-abilit ...@@ -103,9 +107,10 @@ Ability迁移结果,该类型为枚举,可配合[Ability](js-apis-app-abilit
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onContinue(wantParam) { onContinue(wantParam: Record<string, Object>) {
return AbilityConstant.OnContinueResult.AGREE; return AbilityConstant.OnContinueResult.AGREE;
} }
} }
...@@ -130,18 +135,22 @@ class MyAbility extends UIAbility { ...@@ -130,18 +135,22 @@ class MyAbility extends UIAbility {
**示例:** **示例:**
```ts ```ts
let want = { import StartOptions from '@ohos.app.ability.StartOptions';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let option = { let option: StartOptions = {
windowMode: AbilityConstant.WindowMode.WINDOW_MODE_FULLSCREEN windowMode: AbilityConstant.WindowMode.WINDOW_MODE_FULLSCREEN
}; };
// 确保从上下文获取到context // 确保从上下文获取到context
this.context.startAbility(want, option).then(()=>{ this.context.startAbility(want, option).then(()=>{
console.log('Succeed to start ability.'); console.log('Succeed to start ability.');
}).catch((error)=>{ }).catch((error: BusinessError)=>{
console.error('Failed to start ability with error: ${JSON.stringify(error)}'); console.error('Failed to start ability with error: ${JSON.stringify(error)}');
}); });
``` ```
...@@ -162,9 +171,10 @@ this.context.startAbility(want, option).then(()=>{ ...@@ -162,9 +171,10 @@ this.context.startAbility(want, option).then(()=>{
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onMemoryLevel(level) { onMemoryLevel(level: AbilityConstant.MemoryLevel) {
if (level === AbilityConstant.MemoryLevel.MEMORY_LEVEL_CRITICAL) { if (level === AbilityConstant.MemoryLevel.MEMORY_LEVEL_CRITICAL) {
console.log('The memory of device is critical, please release some memory.'); console.log('The memory of device is critical, please release some memory.');
} }
...@@ -191,9 +201,10 @@ class MyAbility extends UIAbility { ...@@ -191,9 +201,10 @@ class MyAbility extends UIAbility {
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onSaveState(reason, wantParam) { onSaveState(reason: AbilityConstant.StateType, wantParam: Record<string, Object>) {
return AbilityConstant.OnSaveResult.ALL_AGREE; return AbilityConstant.OnSaveResult.ALL_AGREE;
} }
} }
...@@ -214,9 +225,10 @@ class MyAbility extends UIAbility { ...@@ -214,9 +225,10 @@ class MyAbility extends UIAbility {
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onSaveState(reason, wantParam) { onSaveState(reason: AbilityConstant.StateType, wantParam: Record<string, Object>) {
if (reason === AbilityConstant.StateType.CONTINUATION) { if (reason === AbilityConstant.StateType.CONTINUATION) {
console.log('Save the ability data when the ability continuation.'); console.log('Save the ability data when the ability continuation.');
} }
...@@ -240,8 +252,9 @@ ContinueState说明枚举值。用于表示当前应用任务流转的状态。 ...@@ -240,8 +252,9 @@ ContinueState说明枚举值。用于表示当前应用任务流转的状态。
```ts ```ts
import AbilityConstant from '@ohos.app.ability.AbilityConstant'; import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import { BusinessError } from '@ohos.base';
this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE, (result) => { this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE, (result: BusinessError) => {
console.info(`setMissionContinueState: ${JSON.stringify(result)}`); console.info(`setMissionContinueState: ${JSON.stringify(result)}`);
}); });
``` ```
\ No newline at end of file
...@@ -45,10 +45,11 @@ getAbilityDelegator(): AbilityDelegator ...@@ -45,10 +45,11 @@ getAbilityDelegator(): AbilityDelegator
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import Want from '@ohos.app.ability.Want';
let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
let want = { let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
......
...@@ -29,7 +29,9 @@ onAbilityCreate(ability: UIAbility): void; ...@@ -29,7 +29,9 @@ onAbilityCreate(ability: UIAbility): void;
**示例:** **示例:**
```ts ```ts
let abilityLifecycleCallback = { import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onAbilityCreate(ability){ onAbilityCreate(ability){
console.log('AbilityLifecycleCallback onAbilityCreate.'); console.log('AbilityLifecycleCallback onAbilityCreate.');
} }
...@@ -53,7 +55,9 @@ onWindowStageCreate(ability: UIAbility, windowStage: window.WindowStage): void; ...@@ -53,7 +55,9 @@ onWindowStageCreate(ability: UIAbility, windowStage: window.WindowStage): void;
**示例:** **示例:**
```ts ```ts
let abilityLifecycleCallback = { import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onWindowStageCreate(ability, windowStage){ onWindowStageCreate(ability, windowStage){
console.log('AbilityLifecycleCallback onWindowStageCreate.'); console.log('AbilityLifecycleCallback onWindowStageCreate.');
} }
...@@ -77,7 +81,9 @@ onWindowStageActive(ability: UIAbility, windowStage: window.WindowStage): void; ...@@ -77,7 +81,9 @@ onWindowStageActive(ability: UIAbility, windowStage: window.WindowStage): void;
**示例:** **示例:**
```ts ```ts
let abilityLifecycleCallback = { import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onWindowStageActive(ability, windowStage){ onWindowStageActive(ability, windowStage){
console.log('AbilityLifecycleCallback onWindowStageActive.'); console.log('AbilityLifecycleCallback onWindowStageActive.');
} }
...@@ -101,7 +107,9 @@ onWindowStageInactive(ability: UIAbility, windowStage: window.WindowStage): void ...@@ -101,7 +107,9 @@ onWindowStageInactive(ability: UIAbility, windowStage: window.WindowStage): void
**示例:** **示例:**
```ts ```ts
let abilityLifecycleCallback = { import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onWindowStageInactive(ability, windowStage){ onWindowStageInactive(ability, windowStage){
console.log('AbilityLifecycleCallback onWindowStageInactive.'); console.log('AbilityLifecycleCallback onWindowStageInactive.');
} }
...@@ -125,7 +133,9 @@ onWindowStageDestroy(ability: UIAbility, windowStage: window.WindowStage): void; ...@@ -125,7 +133,9 @@ onWindowStageDestroy(ability: UIAbility, windowStage: window.WindowStage): void;
**示例:** **示例:**
```ts ```ts
let abilityLifecycleCallback = { import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onWindowStageDestroy(ability, windowStage){ onWindowStageDestroy(ability, windowStage){
console.log('AbilityLifecycleCallback onWindowStageDestroy.'); console.log('AbilityLifecycleCallback onWindowStageDestroy.');
} }
...@@ -148,7 +158,9 @@ onAbilityDestroy(ability: UIAbility): void; ...@@ -148,7 +158,9 @@ onAbilityDestroy(ability: UIAbility): void;
**示例:** **示例:**
```ts ```ts
let abilityLifecycleCallback = { import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onAbilityDestroy(ability){ onAbilityDestroy(ability){
console.log('AbilityLifecycleCallback onAbilityDestroy.'); console.log('AbilityLifecycleCallback onAbilityDestroy.');
} }
...@@ -171,7 +183,9 @@ onAbilityForeground(ability: UIAbility): void; ...@@ -171,7 +183,9 @@ onAbilityForeground(ability: UIAbility): void;
**示例:** **示例:**
```ts ```ts
let abilityLifecycleCallback = { import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onAbilityForeground(ability){ onAbilityForeground(ability){
console.log('AbilityLifecycleCallback onAbilityForeground.'); console.log('AbilityLifecycleCallback onAbilityForeground.');
} }
...@@ -194,7 +208,9 @@ onAbilityBackground(ability: UIAbility): void; ...@@ -194,7 +208,9 @@ onAbilityBackground(ability: UIAbility): void;
**示例:** **示例:**
```ts ```ts
let abilityLifecycleCallback = { import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onAbilityBackground(ability){ onAbilityBackground(ability){
console.log('AbilityLifecycleCallback onAbilityBackground.'); console.log('AbilityLifecycleCallback onAbilityBackground.');
} }
...@@ -217,7 +233,9 @@ onAbilityContinue(ability: UIAbility): void; ...@@ -217,7 +233,9 @@ onAbilityContinue(ability: UIAbility): void;
**示例:** **示例:**
```ts ```ts
let abilityLifecycleCallback = { import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onAbilityContinue(ability){ onAbilityContinue(ability){
console.log('AbilityLifecycleCallback onAbilityContinue.'); console.log('AbilityLifecycleCallback onAbilityContinue.');
} }
...@@ -227,15 +245,40 @@ let abilityLifecycleCallback = { ...@@ -227,15 +245,40 @@ let abilityLifecycleCallback = {
## AbilityLifecycleCallback使用 ## AbilityLifecycleCallback使用
**示例:** **示例:**
GlobalContext.ts
```ts
// 构造单例对象
export class GlobalContext {
private constructor() {}
private static instance: GlobalContext;
private _objects = new Map<string, Object>();
public static getContext(): GlobalContext {
if (!GlobalContext.instance) {
GlobalContext.instance = new GlobalContext();
}
return GlobalContext.instance;
}
getObject(value: string): Object | undefined {
return this._objects.get(value);
}
setObject(key: string, objectClass: Object): void {
this._objects.set(key, objectClass);
}
}
```
MyFirstAbility.ts MyFirstAbility.ts
```ts ```ts
import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback'; import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
import AbilityStage from '@ohos.app.ability.AbilityStage'; import AbilityStage from '@ohos.app.ability.AbilityStage';
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import { GlobalContext } from '../GlobalContext'
// 声明ability生命周期回调,需配置所有回调后才可以在applicationContext注册 // 声明ability生命周期回调,需配置所有回调后才可以在applicationContext注册
let abilityLifecycleCallback = { let abilityLifecycleCallback: AbilityLifecycleCallback = {
onAbilityCreate(ability){ onAbilityCreate(ability){
console.log('AbilityLifecycleCallback onAbilityCreate.'); console.log('AbilityLifecycleCallback onAbilityCreate.');
}, },
...@@ -272,7 +315,8 @@ export default class MyFirstAbility extends UIAbility { ...@@ -272,7 +315,8 @@ export default class MyFirstAbility extends UIAbility {
let applicationContext = this.context.getApplicationContext(); let applicationContext = this.context.getApplicationContext();
// 2.通过applicationContext注册监听应用内生命周期 // 2.通过applicationContext注册监听应用内生命周期
try { try {
globalThis.lifecycleId = applicationContext.on('abilityLifecycle', abilityLifecycleCallback); let lifecycleId = applicationContext.on('abilityLifecycle', abilityLifecycleCallback);
GlobalContext.getContext().setObject("lifecycleId", lifecycleId);
console.log('registerAbilityLifecycleCallback lifecycleId: ${globalThis.lifecycleId}'); console.log('registerAbilityLifecycleCallback lifecycleId: ${globalThis.lifecycleId}');
} catch (paramError) { } catch (paramError) {
console.error('error: ${paramError.code}, ${paramError.message}'); console.error('error: ${paramError.code}, ${paramError.message}');
...@@ -284,12 +328,14 @@ export default class MyFirstAbility extends UIAbility { ...@@ -284,12 +328,14 @@ export default class MyFirstAbility extends UIAbility {
MySecondAbility.ts MySecondAbility.ts
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import { GlobalContext } from '../GlobalContext'
export default class MySecondAbility extends UIAbility { export default class MySecondAbility extends UIAbility {
onDestroy() { onDestroy() {
let applicationContext = this.context.getApplicationContext(); let applicationContext = this.context.getApplicationContext();
let lifecycleId: number = GlobalContext.getContext().getObject("lifecycleId");
// 3.通过applicationContext注销监听应用内生命周期 // 3.通过applicationContext注销监听应用内生命周期
applicationContext.off('abilityLifecycle', globalThis.lifecycleId, (error) => { applicationContext.off('abilityLifecycle', lifecycleId, (error) => {
if (error && error.code !== 0) { if (error && error.code !== 0) {
console.error('unregisterAbilityLifecycleCallback fail, error: ${JSON.stringify(error)}'); console.error('unregisterAbilityLifecycleCallback fail, error: ${JSON.stringify(error)}');
} else { } else {
......
...@@ -59,9 +59,10 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void ...@@ -59,9 +59,10 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void
```ts ```ts
import abilityManager from '@ohos.app.ability.abilityManager'; import abilityManager from '@ohos.app.ability.abilityManager';
import { Configuration } from '@ohos.app.ability.Configuration';
import ConfigurationConstant from '@ohos.app.ability.ConfigurationConstant'; import ConfigurationConstant from '@ohos.app.ability.ConfigurationConstant';
const config = { const config: Configuration = {
language: 'Zh-Hans', // 简体中文 language: 'Zh-Hans', // 简体中文
colorMode: ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT, // 浅色模式 colorMode: ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT, // 浅色模式
direction: ConfigurationConstant.Direction.DIRECTION_VERTICAL, // 垂直方向 direction: ConfigurationConstant.Direction.DIRECTION_VERTICAL, // 垂直方向
...@@ -117,9 +118,11 @@ updateConfiguration(config: Configuration): Promise\<void> ...@@ -117,9 +118,11 @@ updateConfiguration(config: Configuration): Promise\<void>
```ts ```ts
import abilityManager from '@ohos.app.ability.abilityManager'; import abilityManager from '@ohos.app.ability.abilityManager';
import { Configuration } from '@ohos.app.ability.Configuration';
import ConfigurationConstant from '@ohos.app.ability.ConfigurationConstant'; import ConfigurationConstant from '@ohos.app.ability.ConfigurationConstant';
import { BusinessError } from '@ohos.base';
const config = { const config: Configuration = {
language: 'Zh-Hans', // 简体中文 language: 'Zh-Hans', // 简体中文
colorMode: ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT, // 浅色模式 colorMode: ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT, // 浅色模式
direction: ConfigurationConstant.Direction.DIRECTION_VERTICAL, // 垂直方向 direction: ConfigurationConstant.Direction.DIRECTION_VERTICAL, // 垂直方向
...@@ -131,7 +134,7 @@ const config = { ...@@ -131,7 +134,7 @@ const config = {
try { try {
abilityManager.updateConfiguration(config).then(() => { abilityManager.updateConfiguration(config).then(() => {
console.log('updateConfiguration success.'); console.log('updateConfiguration success.');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error('updateConfiguration fail, err: ${JSON.stringify(err)}'); console.error('updateConfiguration fail, err: ${JSON.stringify(err)}');
}); });
} catch (paramError) { } catch (paramError) {
...@@ -209,11 +212,12 @@ getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>> ...@@ -209,11 +212,12 @@ getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>>
```ts ```ts
import abilityManager from '@ohos.app.ability.abilityManager'; import abilityManager from '@ohos.app.ability.abilityManager';
import { BusinessError } from '@ohos.base';
try { try {
abilityManager.getAbilityRunningInfos().then((data) => { abilityManager.getAbilityRunningInfos().then((data) => {
console.log('getAbilityRunningInfos success, data: ${JSON.stringify(data)}'); console.log('getAbilityRunningInfos success, data: ${JSON.stringify(data)}');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error('getAbilityRunningInfos fail, err: ${JSON.stringify(err)}'); console.error('getAbilityRunningInfos fail, err: ${JSON.stringify(err)}');
}); });
} catch (paramError) { } catch (paramError) {
...@@ -300,13 +304,14 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn ...@@ -300,13 +304,14 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn
```ts ```ts
import abilityManager from '@ohos.app.ability.abilityManager'; import abilityManager from '@ohos.app.ability.abilityManager';
import { BusinessError } from '@ohos.base';
let upperLimit = 10; let upperLimit = 10;
try { try {
abilityManager.getExtensionRunningInfos(upperLimit).then((data) => { abilityManager.getExtensionRunningInfos(upperLimit).then((data) => {
console.log('getExtensionRunningInfos success, data: ${JSON.stringify(data)}'); console.log('getExtensionRunningInfos success, data: ${JSON.stringify(data)}');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error('getExtensionRunningInfos fail, err: ${JSON.stringify(err)}'); console.error('getExtensionRunningInfos fail, err: ${JSON.stringify(err)}');
}); });
} catch (paramError) { } catch (paramError) {
...@@ -376,10 +381,11 @@ getTopAbility(): Promise\<ElementName>; ...@@ -376,10 +381,11 @@ getTopAbility(): Promise\<ElementName>;
```ts ```ts
import abilityManager from '@ohos.app.ability.abilityManager'; import abilityManager from '@ohos.app.ability.abilityManager';
import { BusinessError } from '@ohos.base';
abilityManager.getTopAbility().then((data) => { abilityManager.getTopAbility().then((data) => {
console.log('getTopAbility success, data: ${JSON.stringify(data)}'); console.log('getTopAbility success, data: ${JSON.stringify(data)}');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error('getTopAbility fail, err: ${JSON.stringify(err)}'); console.error('getTopAbility fail, err: ${JSON.stringify(err)}');
}); });
``` ```
...@@ -413,6 +419,8 @@ acquireShareData(missionId: number, callback: AsyncCallback<{[key: string]: Obje ...@@ -413,6 +419,8 @@ acquireShareData(missionId: number, callback: AsyncCallback<{[key: string]: Obje
```ts ```ts
import abilityManager from '@ohos.app.ability.abilityManager'; import abilityManager from '@ohos.app.ability.abilityManager';
import { BusinessError } from '@ohos.base';
try { try {
abilityManager.acquireShareData(1, (err, wantParam) => { abilityManager.acquireShareData(1, (err, wantParam) => {
if (err) { if (err) {
...@@ -422,7 +430,9 @@ try { ...@@ -422,7 +430,9 @@ try {
} }
}); });
} catch (paramError) { } catch (paramError) {
console.error(`error.code: ${JSON.stringify(paramError.code)}, error.message: ${JSON.stringify(paramError.message)}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error.code: ${JSON.stringify(code)}, error.message: ${JSON.stringify(message)}`);
} }
``` ```
...@@ -461,13 +471,17 @@ acquireShareData(missionId: number): Promise<{[key: string]: Object}>; ...@@ -461,13 +471,17 @@ acquireShareData(missionId: number): Promise<{[key: string]: Object}>;
```ts ```ts
import abilityManager from '@ohos.app.ability.abilityManager'; import abilityManager from '@ohos.app.ability.abilityManager';
import { BusinessError } from '@ohos.base';
try { try {
abilityManager.acquireShareData(1).then((wantParam) => { abilityManager.acquireShareData(1).then((wantParam) => {
console.log(`acquireShareData success, data: ${JSON.stringify(wantParam)}`); console.log(`acquireShareData success, data: ${JSON.stringify(wantParam)}`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`acquireShareData fail, err: ${JSON.stringify(err)}`); console.error(`acquireShareData fail, err: ${JSON.stringify(err)}`);
}); });
} catch (paramError) { } catch (paramError) {
console.error(`error.code: ${JSON.stringify(paramError.code)}, error.message: ${JSON.stringify(paramError.message)}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error.code: ${JSON.stringify(code)}, error.message: ${JSON.stringify(message)}`);
} }
``` ```
\ No newline at end of file
...@@ -60,9 +60,10 @@ onAcceptWant(want: Want): string; ...@@ -60,9 +60,10 @@ onAcceptWant(want: Want): string;
```ts ```ts
import AbilityStage from '@ohos.app.ability.AbilityStage'; import AbilityStage from '@ohos.app.ability.AbilityStage';
import Want from '@ohos.app.ability.Want';
class MyAbilityStage extends AbilityStage { class MyAbilityStage extends AbilityStage {
onAcceptWant(want) { onAcceptWant(want: Want) {
console.log('MyAbilityStage.onAcceptWant called'); console.log('MyAbilityStage.onAcceptWant called');
return 'com.example.test'; return 'com.example.test';
} }
...@@ -88,9 +89,10 @@ onConfigurationUpdate(newConfig: Configuration): void; ...@@ -88,9 +89,10 @@ onConfigurationUpdate(newConfig: Configuration): void;
```ts ```ts
import AbilityStage from '@ohos.app.ability.AbilityStage'; import AbilityStage from '@ohos.app.ability.AbilityStage';
import { Configuration } from '@ohos.app.ability.Configuration';
class MyAbilityStage extends AbilityStage { class MyAbilityStage extends AbilityStage {
onConfigurationUpdate(config) { onConfigurationUpdate(config: Configuration) {
console.log('onConfigurationUpdate, language: ${config.language}'); console.log('onConfigurationUpdate, language: ${config.language}');
} }
} }
...@@ -114,9 +116,10 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void; ...@@ -114,9 +116,10 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
```ts ```ts
import AbilityStage from '@ohos.app.ability.AbilityStage'; import AbilityStage from '@ohos.app.ability.AbilityStage';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyAbilityStage extends AbilityStage { class MyAbilityStage extends AbilityStage {
onMemoryLevel(level) { onMemoryLevel(level: AbilityConstant.MemoryLevel) {
console.log('onMemoryLevel, level: ${JSON.stringify(level)}'); console.log('onMemoryLevel, level: ${JSON.stringify(level)}');
} }
} }
......
...@@ -75,10 +75,11 @@ static isRunningInStabilityTest(): Promise&lt;boolean&gt; ...@@ -75,10 +75,11 @@ static isRunningInStabilityTest(): Promise&lt;boolean&gt;
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
appManager.isRunningInStabilityTest().then((flag) => { appManager.isRunningInStabilityTest().then((flag) => {
console.log(`The result of isRunningInStabilityTest is: ${JSON.stringify(flag)}`); console.log(`The result of isRunningInStabilityTest is: ${JSON.stringify(flag)}`);
}).catch((error) => { }).catch((error: BusinessError) => {
console.error(`error: ${JSON.stringify(error)}`); console.error(`error: ${JSON.stringify(error)}`);
}); });
``` ```
...@@ -110,10 +111,11 @@ isRamConstrainedDevice(): Promise\<boolean>; ...@@ -110,10 +111,11 @@ isRamConstrainedDevice(): Promise\<boolean>;
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
appManager.isRamConstrainedDevice().then((data) => { appManager.isRamConstrainedDevice().then((data) => {
console.log(`The result of isRamConstrainedDevice is: ${JSON.stringify(data)}`); console.log(`The result of isRamConstrainedDevice is: ${JSON.stringify(data)}`);
}).catch((error) => { }).catch((error: BusinessError) => {
console.error(`error: ${JSON.stringify(error)}`); console.error(`error: ${JSON.stringify(error)}`);
}); });
``` ```
...@@ -180,10 +182,11 @@ getAppMemorySize(): Promise\<number>; ...@@ -180,10 +182,11 @@ getAppMemorySize(): Promise\<number>;
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError} from '@ohos.base'
appManager.getAppMemorySize().then((data) => { appManager.getAppMemorySize().then((data) => {
console.log(`The size of app memory is: ${JSON.stringify(data)}`); console.log(`The size of app memory is: ${JSON.stringify(data)}`);
}).catch((error) => { }).catch((error: BusinessError) => {
console.error(`error: ${JSON.stringify(error)}`); console.error(`error: ${JSON.stringify(error)}`);
}); });
``` ```
...@@ -252,10 +255,11 @@ getRunningProcessInformation(): Promise\<Array\<ProcessInformation>>; ...@@ -252,10 +255,11 @@ getRunningProcessInformation(): Promise\<Array\<ProcessInformation>>;
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
appManager.getRunningProcessInformation().then((data) => { appManager.getRunningProcessInformation().then((data) => {
console.log(`The running process information is: ${JSON.stringify(data)}`); console.log(`The running process information is: ${JSON.stringify(data)}`);
}).catch((error) => { }).catch((error: BusinessError) => {
console.error(`error: ${JSON.stringify(error)}`); console.error(`error: ${JSON.stringify(error)}`);
}); });
``` ```
...@@ -335,12 +339,13 @@ isSharedBundleRunning(bundleName: string, versionCode: number): Promise\<boolean ...@@ -335,12 +339,13 @@ isSharedBundleRunning(bundleName: string, versionCode: number): Promise\<boolean
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
const bundleName = "this is a bundleName"; const bundleName = "this is a bundleName";
const versionCode = 1; const versionCode = 1;
appManager.isSharedBundleRunning(bundleName, versionCode).then((data) => { appManager.isSharedBundleRunning(bundleName, versionCode).then((data) => {
console.log(`The shared bundle running is: ${JSON.stringify(data)}`); console.log(`The shared bundle running is: ${JSON.stringify(data)}`);
}).catch((error) => { }).catch((error: BusinessError) => {
console.error(`error: ${JSON.stringify(error)}`); console.error(`error: ${JSON.stringify(error)}`);
}); });
``` ```
...@@ -426,8 +431,9 @@ on(type: 'applicationState', observer: ApplicationStateObserver): number; ...@@ -426,8 +431,9 @@ on(type: 'applicationState', observer: ApplicationStateObserver): number;
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let applicationStateObserver = { let applicationStateObserver: appManager.ApplicationStateObserver = {
onForegroundApplicationChanged(appStateData) { onForegroundApplicationChanged(appStateData) {
console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`); console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`);
}, },
...@@ -448,7 +454,9 @@ try { ...@@ -448,7 +454,9 @@ try {
const observerId = appManager.on('applicationState', applicationStateObserver); const observerId = appManager.on('applicationState', applicationStateObserver);
console.log(`[appManager] observerCode: ${observerId}`); console.log(`[appManager] observerCode: ${observerId}`);
} catch (paramError) { } catch (paramError) {
console.error(`[appManager] error: ${paramError.code}, ${paramError.message} `); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`[appManager] error: ${code}, ${message} `);
} }
``` ```
...@@ -490,8 +498,9 @@ on(type: 'applicationState', observer: ApplicationStateObserver, bundleNameList: ...@@ -490,8 +498,9 @@ on(type: 'applicationState', observer: ApplicationStateObserver, bundleNameList:
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let applicationStateObserver = { let applicationStateObserver: appManager.ApplicationStateObserver = {
onForegroundApplicationChanged(appStateData) { onForegroundApplicationChanged(appStateData) {
console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`); console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`);
}, },
...@@ -513,7 +522,9 @@ try { ...@@ -513,7 +522,9 @@ try {
const observerId = appManager.on('applicationState', applicationStateObserver, bundleNameList); const observerId = appManager.on('applicationState', applicationStateObserver, bundleNameList);
console.log(`[appManager] observerCode: ${observerId}`); console.log(`[appManager] observerCode: ${observerId}`);
} catch (paramError) { } catch (paramError) {
console.error(`[appManager] error: ${paramError.code}, ${paramError.message} `); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`[appManager] error: ${code}, ${message} `);
} }
``` ```
...@@ -549,11 +560,12 @@ off(type: 'applicationState', observerId: number, callback: AsyncCallback\<void ...@@ -549,11 +560,12 @@ off(type: 'applicationState', observerId: number, callback: AsyncCallback\<void
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let observerId = 0; let observerId = 0;
// 1.注册应用状态监听器 // 1.注册应用状态监听器
let applicationStateObserver = { let applicationStateObserver: appManager.ApplicationStateObserver = {
onForegroundApplicationChanged(appStateData) { onForegroundApplicationChanged(appStateData) {
console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`); console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`);
}, },
...@@ -575,11 +587,13 @@ try { ...@@ -575,11 +587,13 @@ try {
observerId = appManager.on('applicationState', applicationStateObserver, bundleNameList); observerId = appManager.on('applicationState', applicationStateObserver, bundleNameList);
console.log(`[appManager] observerCode: ${observerId}`); console.log(`[appManager] observerCode: ${observerId}`);
} catch (paramError) { } catch (paramError) {
console.error(`[appManager] error: ${paramError.code}, ${paramError.message} `); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`[appManager] error: ${code}, ${message} `);
} }
// 2.注销应用状态监听器 // 2.注销应用状态监听器
function unregisterApplicationStateObserverCallback(err) { function unregisterApplicationStateObserverCallback(err: BusinessError) {
if (err) { if (err) {
console.error(`unregisterApplicationStateObserverCallback fail, err: ${JSON.stringify(err)}`); console.error(`unregisterApplicationStateObserverCallback fail, err: ${JSON.stringify(err)}`);
} else { } else {
...@@ -589,7 +603,9 @@ function unregisterApplicationStateObserverCallback(err) { ...@@ -589,7 +603,9 @@ function unregisterApplicationStateObserverCallback(err) {
try { try {
appManager.off('applicationState', observerId, unregisterApplicationStateObserverCallback); appManager.off('applicationState', observerId, unregisterApplicationStateObserverCallback);
} catch (paramError) { } catch (paramError) {
console.error(`error: ${paramError.code}, ${paramError.message}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`[appManager] error: ${code}, ${message} `);
} }
``` ```
...@@ -630,11 +646,12 @@ off(type: 'applicationState', observerId: number): Promise\<void>; ...@@ -630,11 +646,12 @@ off(type: 'applicationState', observerId: number): Promise\<void>;
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let observerId = 0; let observerId = 0;
// 1.注册应用状态监听器 // 1.注册应用状态监听器
let applicationStateObserver = { let applicationStateObserver: appManager.ApplicationStateObserver = {
onForegroundApplicationChanged(appStateData) { onForegroundApplicationChanged(appStateData) {
console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`); console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`);
}, },
...@@ -654,20 +671,23 @@ let applicationStateObserver = { ...@@ -654,20 +671,23 @@ let applicationStateObserver = {
let bundleNameList = ['bundleName1', 'bundleName2']; let bundleNameList = ['bundleName1', 'bundleName2'];
try { try {
observerId = appManager.on('applicationState', applicationStateObserver, bundleNameList); observerId = appManager.on('applicationState', applicationStateObserver, bundleNameList);
console.log(`[appManager] observerCode: ${observerId}`);
} catch (paramError) { } catch (paramError) {
console.error(`[appManager] error: ${paramError.code}, ${paramError.message} `); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`[appManager] error: ${code}, ${message} `);
} }
// 2.注销应用状态监听器 // 2.注销应用状态监听器
try { try {
appManager.off('applicationState', observerId).then((data) => { appManager.off('applicationState', observerId).then((data) => {
console.log(`unregisterApplicationStateObserver success, data: ${JSON.stringify(data)}`); console.log(`unregisterApplicationStateObserver success, data: ${JSON.stringify(data)}`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`unregisterApplicationStateObserver fail, err: ${JSON.stringify(err)}`); console.error(`unregisterApplicationStateObserver fail, err: ${JSON.stringify(err)}`);
}); });
} catch (paramError) { } catch (paramError) {
console.error(`error: ${paramError.code}, ${paramError.message}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`[appManager] error: ${code}, ${message} `);
} }
``` ```
...@@ -701,8 +721,9 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void; ...@@ -701,8 +721,9 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void;
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
function getForegroundApplicationsCallback(err, data) { function getForegroundApplicationsCallback(err: BusinessError, data: Array<appManager.AppStateData>) {
if (err) { if (err) {
console.error(`getForegroundApplicationsCallback fail, err: ${JSON.stringify(err)}`); console.error(`getForegroundApplicationsCallback fail, err: ${JSON.stringify(err)}`);
} else { } else {
...@@ -712,7 +733,9 @@ function getForegroundApplicationsCallback(err, data) { ...@@ -712,7 +733,9 @@ function getForegroundApplicationsCallback(err, data) {
try { try {
appManager.getForegroundApplications(getForegroundApplicationsCallback); appManager.getForegroundApplications(getForegroundApplicationsCallback);
} catch (paramError) { } catch (paramError) {
console.error(`error: ${paramError.code}, ${paramError.message}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`[appManager] error: ${code}, ${message} `);
} }
``` ```
...@@ -746,10 +769,11 @@ getForegroundApplications(): Promise\<Array\<AppStateData>>; ...@@ -746,10 +769,11 @@ getForegroundApplications(): Promise\<Array\<AppStateData>>;
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
appManager.getForegroundApplications().then((data) => { appManager.getForegroundApplications().then((data) => {
console.log(`getForegroundApplications success, data: ${JSON.stringify(data)}`); console.log(`getForegroundApplications success, data: ${JSON.stringify(data)}`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`getForegroundApplications fail, err: ${JSON.stringify(err)}`); console.error(`getForegroundApplications fail, err: ${JSON.stringify(err)}`);
}); });
``` ```
...@@ -789,17 +813,20 @@ killProcessWithAccount(bundleName: string, accountId: number): Promise\<void\> ...@@ -789,17 +813,20 @@ killProcessWithAccount(bundleName: string, accountId: number): Promise\<void\>
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName'; let bundleName = 'bundleName';
let accountId = 0; let accountId = 0;
try { try {
appManager.killProcessWithAccount(bundleName, accountId).then(() => { appManager.killProcessWithAccount(bundleName, accountId).then(() => {
console.log('killProcessWithAccount success'); console.log('killProcessWithAccount success');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`killProcessWithAccount fail, err: ${JSON.stringify(err)}`); console.error(`killProcessWithAccount fail, err: ${JSON.stringify(err)}`);
}); });
} catch (paramError) { } catch (paramError) {
console.error(`error: ${paramError.code}, ${paramError.message}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`[appManager] error: ${code}, ${message} `);
} }
``` ```
...@@ -840,10 +867,11 @@ killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCal ...@@ -840,10 +867,11 @@ killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCal
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName'; let bundleName = 'bundleName';
let accountId = 0; let accountId = 0;
function killProcessWithAccountCallback(err, data) { function killProcessWithAccountCallback(err: BusinessError) {
if (err) { if (err) {
console.error(`killProcessWithAccountCallback fail, err: ${JSON.stringify(err)}`); console.error(`killProcessWithAccountCallback fail, err: ${JSON.stringify(err)}`);
} else { } else {
...@@ -884,9 +912,10 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>); ...@@ -884,9 +912,10 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>);
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName'; let bundleName = 'bundleName';
function killProcessesByBundleNameCallback(err, data) { function killProcessesByBundleNameCallback(err: BusinessError) {
if (err) { if (err) {
console.error(`killProcessesByBundleNameCallback fail, err: ${JSON.stringify(err)}`); console.error(`killProcessesByBundleNameCallback fail, err: ${JSON.stringify(err)}`);
} else { } else {
...@@ -896,7 +925,9 @@ function killProcessesByBundleNameCallback(err, data) { ...@@ -896,7 +925,9 @@ function killProcessesByBundleNameCallback(err, data) {
try { try {
appManager.killProcessesByBundleName(bundleName, killProcessesByBundleNameCallback); appManager.killProcessesByBundleName(bundleName, killProcessesByBundleNameCallback);
} catch (paramError) { } catch (paramError) {
console.error(`error: ${paramError.code}, ${paramError.message}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`[appManager] error: ${code}, ${message} `);
} }
``` ```
...@@ -936,16 +967,19 @@ killProcessesByBundleName(bundleName: string): Promise\<void>; ...@@ -936,16 +967,19 @@ killProcessesByBundleName(bundleName: string): Promise\<void>;
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName'; let bundleName = 'bundleName';
try { try {
appManager.killProcessesByBundleName(bundleName).then((data) => { appManager.killProcessesByBundleName(bundleName).then((data) => {
console.log('killProcessesByBundleName success.'); console.log('killProcessesByBundleName success.');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`killProcessesByBundleName fail, err: ${JSON.stringify(err)}`); console.error(`killProcessesByBundleName fail, err: ${JSON.stringify(err)}`);
}); });
} catch (paramError) { } catch (paramError) {
console.error(`error: ${paramError.code}, ${paramError.message}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`[appManager] error: ${code}, ${message} `);
} }
``` ```
...@@ -980,9 +1014,10 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>); ...@@ -980,9 +1014,10 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>);
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName'; let bundleName = 'bundleName';
function clearUpApplicationDataCallback(err, data) { function clearUpApplicationDataCallback(err: BusinessError) {
if (err) { if (err) {
console.error(`clearUpApplicationDataCallback fail, err: ${JSON.stringify(err)}`); console.error(`clearUpApplicationDataCallback fail, err: ${JSON.stringify(err)}`);
} else { } else {
...@@ -992,7 +1027,9 @@ function clearUpApplicationDataCallback(err, data) { ...@@ -992,7 +1027,9 @@ function clearUpApplicationDataCallback(err, data) {
try { try {
appManager.clearUpApplicationData(bundleName, clearUpApplicationDataCallback); appManager.clearUpApplicationData(bundleName, clearUpApplicationDataCallback);
} catch (paramError) { } catch (paramError) {
console.error(`error: ${paramError.code}, ${paramError.message}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`[appManager] error: ${code}, ${message} `);
} }
``` ```
...@@ -1032,16 +1069,19 @@ clearUpApplicationData(bundleName: string): Promise\<void>; ...@@ -1032,16 +1069,19 @@ clearUpApplicationData(bundleName: string): Promise\<void>;
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName'; let bundleName = 'bundleName';
try { try {
appManager.clearUpApplicationData(bundleName).then((data) => { appManager.clearUpApplicationData(bundleName).then((data) => {
console.log('clearUpApplicationData success.'); console.log('clearUpApplicationData success.');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`clearUpApplicationData fail, err: ${JSON.stringify(err)}`); console.error(`clearUpApplicationData fail, err: ${JSON.stringify(err)}`);
}); });
} catch (paramError) { } catch (paramError) {
console.error(`error: ${paramError.code}, ${paramError.message}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`[appManager] error: ${code}, ${message} `);
} }
``` ```
...@@ -1074,9 +1114,10 @@ getProcessMemoryByPid(pid: number, callback: AsyncCallback\<number>): void; ...@@ -1074,9 +1114,10 @@ getProcessMemoryByPid(pid: number, callback: AsyncCallback\<number>): void;
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let pid = 0; let pid = 0;
function getProcessMemoryByPidCallback(err, data) { function getProcessMemoryByPidCallback(err: BusinessError, data: number) {
if (err) { if (err) {
console.error(`getProcessMemoryByPidCallback fail, err: ${JSON.stringify(err)}`); console.error(`getProcessMemoryByPidCallback fail, err: ${JSON.stringify(err)}`);
} else { } else {
...@@ -1086,7 +1127,9 @@ function getProcessMemoryByPidCallback(err, data) { ...@@ -1086,7 +1127,9 @@ function getProcessMemoryByPidCallback(err, data) {
try { try {
appManager.getProcessMemoryByPid(pid, getProcessMemoryByPidCallback); appManager.getProcessMemoryByPid(pid, getProcessMemoryByPidCallback);
} catch (paramError) { } catch (paramError) {
console.error(`error: ${paramError.code}, ${paramError.message}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`[appManager] error: ${code}, ${message} `);
} }
``` ```
...@@ -1124,16 +1167,19 @@ getProcessMemoryByPid(pid: number): Promise\<number>; ...@@ -1124,16 +1167,19 @@ getProcessMemoryByPid(pid: number): Promise\<number>;
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let pid = 0; let pid = 0;
try { try {
appManager.getProcessMemoryByPid(pid).then((data) => { appManager.getProcessMemoryByPid(pid).then((data) => {
console.log('getProcessMemoryByPid success.'); console.log('getProcessMemoryByPid success.');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`getProcessMemoryByPid fail, err: ${JSON.stringify(err)}`); console.error(`getProcessMemoryByPid fail, err: ${JSON.stringify(err)}`);
}); });
} catch (paramError) { } catch (paramError) {
console.error(`error: ${paramError.code}, ${paramError.message}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`[appManager] error: ${code}, ${message} `);
} }
``` ```
...@@ -1166,9 +1212,10 @@ getRunningProcessInfoByBundleName(bundleName: string, callback: AsyncCallback\<A ...@@ -1166,9 +1212,10 @@ getRunningProcessInfoByBundleName(bundleName: string, callback: AsyncCallback\<A
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = "bundleName"; let bundleName = "bundleName";
function getRunningProcessInfoByBundleNameCallback(err, data) { function getRunningProcessInfoByBundleNameCallback(err: BusinessError, data: appManager.Array<ProcessInformation>) {
if (err) { if (err) {
console.error(`getRunningProcessInfoByBundleNameCallback fail, err: ${JSON.stringify(err)}`); console.error(`getRunningProcessInfoByBundleNameCallback fail, err: ${JSON.stringify(err)}`);
} else { } else {
...@@ -1178,7 +1225,9 @@ function getRunningProcessInfoByBundleNameCallback(err, data) { ...@@ -1178,7 +1225,9 @@ function getRunningProcessInfoByBundleNameCallback(err, data) {
try { try {
appManager.getRunningProcessInfoByBundleName(bundleName, getRunningProcessInfoByBundleNameCallback); appManager.getRunningProcessInfoByBundleName(bundleName, getRunningProcessInfoByBundleNameCallback);
} catch (paramError) { } catch (paramError) {
console.error(`error: ${paramError.code}, ${paramError.message}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`[appManager] error: ${code}, ${message} `);
} }
``` ```
...@@ -1216,16 +1265,19 @@ getRunningProcessInfoByBundleName(bundleName: string): Promise\<Array\<ProcessIn ...@@ -1216,16 +1265,19 @@ getRunningProcessInfoByBundleName(bundleName: string): Promise\<Array\<ProcessIn
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = "bundleName"; let bundleName = "bundleName";
try { try {
appManager.getRunningProcessInfoByBundleName(bundleName).then((data) => { appManager.getRunningProcessInfoByBundleName(bundleName).then((data) => {
console.log('getRunningProcessInfoByBundleName success.'); console.log('getRunningProcessInfoByBundleName success.');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`getRunningProcessInfoByBundleName fail, err: ${JSON.stringify(err)}`); console.error(`getRunningProcessInfoByBundleName fail, err: ${JSON.stringify(err)}`);
}); });
} catch (paramError) { } catch (paramError) {
console.error(`error: ${paramError.code}, ${paramError.message}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`[appManager] error: ${code}, ${message} `);
} }
``` ```
...@@ -1259,10 +1311,11 @@ getRunningProcessInfoByBundleName(bundleName: string, userId: number, callback: ...@@ -1259,10 +1311,11 @@ getRunningProcessInfoByBundleName(bundleName: string, userId: number, callback:
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = "bundleName"; let bundleName = "bundleName";
let userId = 0; let userId = 0;
function getRunningProcessInfoByBundleNameCallback(err, data) { function getRunningProcessInfoByBundleNameCallback(err: BusinessError, data: Array<appManager.ProcessInformation>) {
if (err) { if (err) {
console.error(`getRunningProcessInfoByBundleNameCallback fail, err: ${JSON.stringify(err)}`); console.error(`getRunningProcessInfoByBundleNameCallback fail, err: ${JSON.stringify(err)}`);
} else { } else {
...@@ -1272,7 +1325,9 @@ function getRunningProcessInfoByBundleNameCallback(err, data) { ...@@ -1272,7 +1325,9 @@ function getRunningProcessInfoByBundleNameCallback(err, data) {
try { try {
appManager.getRunningProcessInfoByBundleName(bundleName, userId, getRunningProcessInfoByBundleNameCallback); appManager.getRunningProcessInfoByBundleName(bundleName, userId, getRunningProcessInfoByBundleNameCallback);
} catch (paramError) { } catch (paramError) {
console.error(`error: ${paramError.code}, ${paramError.message}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`[appManager] error: ${code}, ${message} `);
} }
``` ```
...@@ -1311,17 +1366,20 @@ getRunningProcessInfoByBundleName(bundleName: string, userId: number): Promise\< ...@@ -1311,17 +1366,20 @@ getRunningProcessInfoByBundleName(bundleName: string, userId: number): Promise\<
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = "bundleName"; let bundleName = "bundleName";
let userId = 0; let userId = 0;
try { try {
appManager.getRunningProcessInfoByBundleName(bundleName, userId).then((data) => { appManager.getRunningProcessInfoByBundleName(bundleName, userId).then((data) => {
console.log('getRunningProcessInfoByBundleName success.'); console.log('getRunningProcessInfoByBundleName success.');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`getRunningProcessInfoByBundleName fail, err: ${JSON.stringify(err)}`); console.error(`getRunningProcessInfoByBundleName fail, err: ${JSON.stringify(err)}`);
}); });
} catch (paramError) { } catch (paramError) {
console.error(`error: ${paramError.code}, ${paramError.message}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`[appManager] error: ${code}, ${message} `);
} }
``` ```
......
...@@ -101,7 +101,7 @@ API10时将启动由[setRestartWant](#apprecoverysetrestartwant)指定的Ability ...@@ -101,7 +101,7 @@ API10时将启动由[setRestartWant](#apprecoverysetrestartwant)指定的Ability
import appRecovery from '@ohos.app.ability.appRecovery'; import appRecovery from '@ohos.app.ability.appRecovery';
import errorManager from '@ohos.app.ability.errorManager'; import errorManager from '@ohos.app.ability.errorManager';
let observer = { let observer: errorManager.ErrorObserver = {
onUnhandledException(errorMsg) { onUnhandledException(errorMsg) {
console.log('onUnhandledException, errorMsg: ', errorMsg); console.log('onUnhandledException, errorMsg: ', errorMsg);
appRecovery.restartApp(); appRecovery.restartApp();
...@@ -135,7 +135,7 @@ saveAppState(): boolean; ...@@ -135,7 +135,7 @@ saveAppState(): boolean;
import appRecovery from '@ohos.app.ability.appRecovery'; import appRecovery from '@ohos.app.ability.appRecovery';
import errorManager from '@ohos.app.ability.errorManager'; import errorManager from '@ohos.app.ability.errorManager';
let observer = { let observer: errorManager.ErrorObserver = {
onUnhandledException(errorMsg) { onUnhandledException(errorMsg) {
console.log('onUnhandledException, errorMsg: ', errorMsg); console.log('onUnhandledException, errorMsg: ', errorMsg);
appRecovery.saveAppState(); appRecovery.saveAppState();
...@@ -175,7 +175,7 @@ saveAppState(context?: UIAbilityContext): boolean; ...@@ -175,7 +175,7 @@ saveAppState(context?: UIAbilityContext): boolean;
import appRecovery from '@ohos.app.ability.appRecovery'; import appRecovery from '@ohos.app.ability.appRecovery';
import errorManager from '@ohos.app.ability.errorManager'; import errorManager from '@ohos.app.ability.errorManager';
let observer = { let observer: errorManager.ErrorObserver = {
onUnhandledException(errorMsg) { onUnhandledException(errorMsg) {
console.log('onUnhandledException, errorMsg: ', errorMsg); console.log('onUnhandledException, errorMsg: ', errorMsg);
appRecovery.saveAppState(this.context); appRecovery.saveAppState(this.context);
...@@ -207,12 +207,14 @@ setRestartWant(want: Want): void; ...@@ -207,12 +207,14 @@ setRestartWant(want: Want): void;
```ts ```ts
import appRecovery from '@ohos.app.ability.appRecovery'; import appRecovery from '@ohos.app.ability.appRecovery';
import Want from '@ohos.app.ability.Want';
Button("启动到恢复Ability") Button("启动到恢复Ability")
.fontSize(40) .fontSize(40)
.fontWeight(FontWeight.Bold) .fontWeight(FontWeight.Bold)
.onClick(()=> { .onClick(()=> {
// set restart want // set restart want
let want = { let want: Want = {
bundleName: "ohos.samples.recovery", bundleName: "ohos.samples.recovery",
abilityName: "RecoveryAbility" abilityName: "RecoveryAbility"
}; };
......
...@@ -25,26 +25,56 @@ onApplicationForeground(): void; ...@@ -25,26 +25,56 @@ onApplicationForeground(): void;
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import ApplicationStateChangeCallback from '@ohos.app.ability.ApplicationStateChangeCallback';
// 构造单例对象
export class GlobalContext {
private constructor() {}
private static instance: GlobalContext;
private _objects = new Map<string, Object>();
public static getContext(): GlobalContext {
if (!GlobalContext.instance) {
GlobalContext.instance = new GlobalContext();
}
return GlobalContext.instance;
}
getObject(value: string): Object | undefined {
return this._objects.get(value);
}
globalThis.applicationStateChangeCallback = { setObject(key: string, objectClass: Object): void {
this._objects.set(key, objectClass);
}
}
let applicationStateChangeCallback: ApplicationStateChangeCallback = {
onApplicationForeground() { onApplicationForeground() {
console.info('applicationStateChangeCallback onApplicationForeground'); console.info('applicationStateChangeCallback onApplicationForeground');
} }
} }
GlobalContext.getContext().setObject("applicationStateChangeCallback", applicationStateChangeCallback);
export default class MyAbility extends UIAbility { export default class MyAbility extends UIAbility {
onCreate() { onCreate() {
console.log('MyAbility onCreate'); console.log('MyAbility onCreate');
globalThis.applicationContext = this.context.getApplicationContext(); GlobalContext.getContext().setObject("applicationContext", this.context.getApplicationContext());
// 1.获取applicationContext // 1.获取applicationContext
let applicationContext = globalThis.applicationContext; let applicationContext = GlobalContext.getContext().getObject("applicationContext");
// 2.通过applicationContext注册应用前后台状态监听 // 2.通过applicationContext注册应用前后台状态监听
applicationContext.on('applicationStateChange', globalThis.ApplicationStateChangeCallback); if (applicationContext != undefined) {
applicationContext.on('applicationStateChange',
GlobalContext.getContext().getObject("applicationStateChangeCallback"));
}
} }
onDestroy() { onDestroy() {
let applicationContext = globalThis.applicationContext; let applicationContext = GlobalContext.getContext().getObject("applicationContext");
// 1.通过applicationContext解除注册应用前后台状态监听 // 1.通过applicationContext解除注册应用前后台状态监听
applicationContext.off('applicationStateChange', globalThis.ApplicationStateChangeCallback); if (applicationContext != undefined) {
applicationContext.off('applicationStateChange',
GlobalContext.getContext().getObject("applicationStateChangeCallback"));
}
} }
} }
``` ```
...@@ -61,27 +91,56 @@ onApplicationBackground(): void; ...@@ -61,27 +91,56 @@ onApplicationBackground(): void;
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import ApplicationStateChangeCallback from '@ohos.app.ability.ApplicationStateChangeCallback';
export class GlobalContext {
private constructor() {}
private static instance: GlobalContext;
private _objects = new Map<string, Object>();
public static getContext(): GlobalContext {
if (!GlobalContext.instance) {
GlobalContext.instance = new GlobalContext();
}
return GlobalContext.instance;
}
getObject(value: string): Object | undefined {
return this._objects.get(value);
}
setObject(key: string, objectClass: Object): void {
this._objects.set(key, objectClass);
}
}
globalThis.applicationStateChangeCallback = { let applicationStateChangeCallback: ApplicationStateChangeCallback = {
onApplicationBackground() { onApplicationBackground() {
console.info('applicationStateChangeCallback onApplicationBackground'); console.info('applicationStateChangeCallback onApplicationBackground');
} }
} }
GlobalContext.getContext().setObject("applicationStateChangeCallback", applicationStateChangeCallback);
export default class MyAbility extends UIAbility { export default class MyAbility extends UIAbility {
onCreate() { onCreate() {
console.log('MyAbility onCreate'); console.log('MyAbility onCreate');
globalThis.applicationContext = this.context.getApplicationContext(); GlobalContext.getContext().setObject("applicationContext", this.context.getApplicationContext());
// 1.获取applicationContext // 1.获取applicationContext
let applicationContext = globalThis.applicationContext; let applicationContext = GlobalContext.getContext().getObject("applicationContext");
// 2.通过applicationContext注册应用前后台状态监听 // 2.通过applicationContext注册应用前后台状态监听
applicationContext.on('applicationStateChange', globalThis.ApplicationStateChangeCallback); if (applicationContext != undefined) {
applicationContext.on('applicationStateChange',
GlobalContext.getContext().getObject("applicationStateChangeCallback"));
}
console.log('Resgiter applicationStateChangeCallback'); console.log('Resgiter applicationStateChangeCallback');
} }
onDestroy() { onDestroy() {
let applicationContext = globalThis.applicationContext; let applicationContext = GlobalContext.getContext().getObject("applicationContext");
// 1.通过applicationContext解除注册应用前后台状态监听 // 1.通过applicationContext解除注册应用前后台状态监听
applicationContext.off('applicationStateChange', globalThis.ApplicationStateChangeCallback); if (applicationContext != undefined) {
applicationContext.off('applicationStateChange',
GlobalContext.getContext().getObject("applicationStateChangeCallback"));
}
} }
} }
``` ```
\ No newline at end of file
...@@ -31,10 +31,13 @@ import Configuration from '@ohos.app.ability.Configuration'; ...@@ -31,10 +31,13 @@ import Configuration from '@ohos.app.ability.Configuration';
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import EnvironmentCallback from '@ohos.app.ability.EnvironmentCallback';
import Want from '@ohos.app.ability.Want';
export default class EntryAbility extends UIAbility { export default class EntryAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
let envCallback = { let envCallback: EnvironmentCallback = {
onConfigurationUpdated(config) { onConfigurationUpdated(config) {
console.info(`envCallback onConfigurationUpdated success: ${JSON.stringify(config)}`); console.info(`envCallback onConfigurationUpdated success: ${JSON.stringify(config)}`);
let language = config.language; let language = config.language;
......
...@@ -35,6 +35,8 @@ getId(uri: string): number ...@@ -35,6 +35,8 @@ getId(uri: string): number
**示例:** **示例:**
```ts ```ts
import dataUriUtils from '@ohos.app.ability.dataUriUtils';
try { try {
let id = dataUriUtils.getId('com.example.dataUriUtils/1221'); let id = dataUriUtils.getId('com.example.dataUriUtils/1221');
console.info('get id: ${id}'); console.info('get id: ${id}');
...@@ -69,6 +71,8 @@ attachId(uri: string, id: number): string ...@@ -69,6 +71,8 @@ attachId(uri: string, id: number): string
**示例:** **示例:**
```ts ```ts
import dataUriUtils from '@ohos.app.ability.dataUriUtils';
let id = 1122; let id = 1122;
try { try {
let uri = dataUriUtils.attachId( let uri = dataUriUtils.attachId(
...@@ -107,6 +111,8 @@ deleteId(uri: string): string ...@@ -107,6 +111,8 @@ deleteId(uri: string): string
**示例:** **示例:**
```ts ```ts
import dataUriUtils from '@ohos.app.ability.dataUriUtils';
try { try {
let uri = dataUriUtils.deleteId('com.example.dataUriUtils/1221'); let uri = dataUriUtils.deleteId('com.example.dataUriUtils/1221');
console.info('delete id with the uri is: ${uri}'); console.info('delete id with the uri is: ${uri}');
...@@ -142,6 +148,7 @@ updateId(uri: string, id: number): string ...@@ -142,6 +148,7 @@ updateId(uri: string, id: number): string
**示例:** **示例:**
```ts ```ts
import dataUriUtils from '@ohos.app.ability.dataUriUtils';
try { try {
let id = 1122; let id = 1122;
......
...@@ -38,17 +38,18 @@ getRequestInfo(want: Want): RequestInfo ...@@ -38,17 +38,18 @@ getRequestInfo(want: Want): RequestInfo
```ts ```ts
import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility'; import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
import dialogRequest from '@ohos.app.ability.dialogRequest'; import dialogRequest from '@ohos.app.ability.dialogRequest';
const REQUEST_VALUE = 1; const REQUEST_VALUE = 1;
class StubTest extends rpc.RemoteObject { class StubTest extends rpc.RemoteObject {
constructor(des) { constructor(des: string) {
super(des); super(des);
} }
onRemoteRequest(code, data, reply, option) { onRemoteRequest(code: number, data: rpc.MessageParcel, reply: rpc.MessageParcel, option: rpc.MessageOption) {
if (code === REQUEST_VALUE) { if (code === REQUEST_VALUE) {
let optFir = data.readInt(); let optFir = data.readInt();
let optSec = data.readInt(); let optSec = data.readInt();
...@@ -57,10 +58,6 @@ getRequestInfo(want: Want): RequestInfo ...@@ -57,10 +58,6 @@ getRequestInfo(want: Want): RequestInfo
return true; return true;
} }
queryLocallInterface(descriptor) {
return null;
}
getInterfaceDescriptor() { getInterfaceDescriptor() {
return ""; return "";
} }
...@@ -73,32 +70,32 @@ getRequestInfo(want: Want): RequestInfo ...@@ -73,32 +70,32 @@ getRequestInfo(want: Want): RequestInfo
return REQUEST_VALUE; return REQUEST_VALUE;
} }
attachLocalInterface(localInterface, descriptor) { attachLocalInterface(localInterface: rpc.IRemoteBroker, descriptor: string) {
} }
} }
let TAG = "getRequestInfoTest"; let TAG = "getRequestInfoTest";
export default class ServiceExtAbility extends ServiceExtensionAbility { export default class ServiceExtAbility extends ServiceExtensionAbility {
onCreate(want) { onCreate(want: Want) {
console.info(TAG, `onCreate, want: ${want.abilityName}`); console.info(TAG, `onCreate, want: ${want.abilityName}`);
} }
onRequest(want, startId) { onRequest(want: Want, startId: number) {
console.info(TAG, `onRequest, want: ${want.abilityName}`); console.info(TAG, `onRequest, want: ${want.abilityName}`);
try { try {
var requestInfo = dialogRequest.getRequestInfo(want); let requestInfo = dialogRequest.getRequestInfo(want);
} catch (err) { } catch (err) {
console.error('getRequestInfo err= ${JSON.stringify(err)}'); console.error('getRequestInfo err= ${JSON.stringify(err)}');
} }
} }
onConnect(want) { onConnect(want: Want) {
console.info(TAG, `onConnect, want: ${want.abilityName}`); console.info(TAG, `onConnect, want: ${want.abilityName}`);
return new StubTest("test"); return new StubTest("test");
} }
onDisconnect(want) { onDisconnect(want: Want) {
console.info(TAG, `onDisconnect, want: ${want.abilityName}`); console.info(TAG, `onDisconnect, want: ${want.abilityName}`);
} }
...@@ -132,6 +129,7 @@ getRequestCallback(want: Want): RequestCallback ...@@ -132,6 +129,7 @@ getRequestCallback(want: Want): RequestCallback
```ts ```ts
import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility'; import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
import dialogRequest from '@ohos.app.ability.dialogRequest'; import dialogRequest from '@ohos.app.ability.dialogRequest';
...@@ -140,11 +138,11 @@ getRequestCallback(want: Want): RequestCallback ...@@ -140,11 +138,11 @@ getRequestCallback(want: Want): RequestCallback
const REQUEST_VALUE = 1; const REQUEST_VALUE = 1;
class StubTest extends rpc.RemoteObject { class StubTest extends rpc.RemoteObject {
constructor(des) { constructor(des: string) {
super(des); super(des);
} }
onRemoteRequest(code, data, reply, option) { onRemoteRequest(code: number, data: rpc.MessageParcel, reply: rpc.MessageParcel, option: rpc.MessageOption) {
if (code === REQUEST_VALUE) { if (code === REQUEST_VALUE) {
let optFir = data.readInt(); let optFir = data.readInt();
let optSec = data.readInt(); let optSec = data.readInt();
...@@ -153,10 +151,6 @@ getRequestCallback(want: Want): RequestCallback ...@@ -153,10 +151,6 @@ getRequestCallback(want: Want): RequestCallback
return true; return true;
} }
queryLocallInterface(descriptor) {
return null;
}
getInterfaceDescriptor() { getInterfaceDescriptor() {
return ""; return "";
} }
...@@ -169,30 +163,30 @@ getRequestCallback(want: Want): RequestCallback ...@@ -169,30 +163,30 @@ getRequestCallback(want: Want): RequestCallback
return REQUEST_VALUE; return REQUEST_VALUE;
} }
attachLocalInterface(localInterface, descriptor) { attachLocalInterface(localInterface: rpc.IRemoteBroker, descriptor: string) {
} }
} }
export default class ServiceExtAbility extends ServiceExtensionAbility { export default class ServiceExtAbility extends ServiceExtensionAbility {
onCreate(want) { onCreate(want: Want) {
console.info(TAG, `onCreate, want: ${want.abilityName}`); console.info(TAG, `onCreate, want: ${want.abilityName}`);
} }
onRequest(want, startId) { onRequest(want: Want, startId: number) {
console.info(TAG, `onRequest, want: ${want.abilityName}`); console.info(TAG, `onRequest, want: ${want.abilityName}`);
try { try {
var requestCallback = dialogRequest.getRequestCallback(want); let requestCallback = dialogRequest.getRequestCallback(want);
} catch(err) { } catch(err) {
console.error('getRequestInfo err= ${JSON.stringify(err)}'); console.error('getRequestInfo err= ${JSON.stringify(err)}');
} }
} }
onConnect(want) { onConnect(want: Want) {
console.info(TAG, `onConnect, want: ${want.abilityName}`); console.info(TAG, `onConnect, want: ${want.abilityName}`);
return new StubTest("test"); return new StubTest("test");
} }
onDisconnect(want) { onDisconnect(want: Want) {
console.info(TAG, `onDisconnect, want: ${want.abilityName}`); console.info(TAG, `onDisconnect, want: ${want.abilityName}`);
} }
...@@ -211,6 +205,8 @@ getRequestCallback(want: Want): RequestCallback ...@@ -211,6 +205,8 @@ getRequestCallback(want: Want): RequestCallback
```ts ```ts
import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility'; import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
import dialogRequest from '@ohos.app.ability.dialogRequest'; import dialogRequest from '@ohos.app.ability.dialogRequest';
import window from '@ohos.window'; import window from '@ohos.window';
...@@ -220,11 +216,11 @@ getRequestCallback(want: Want): RequestCallback ...@@ -220,11 +216,11 @@ getRequestCallback(want: Want): RequestCallback
const REQUEST_VALUE = 1; const REQUEST_VALUE = 1;
class StubTest extends rpc.RemoteObject { class StubTest extends rpc.RemoteObject {
constructor(des) { constructor(des: string) {
super(des); super(des);
} }
onRemoteRequest(code, data, reply, option) { onRemoteRequest(code: number, data: rpc.MessageParcel, reply: rpc.MessageParcel, option: rpc.MessageOption) {
if (code === REQUEST_VALUE) { if (code === REQUEST_VALUE) {
let optFir = data.readInt(); let optFir = data.readInt();
let optSec = data.readInt(); let optSec = data.readInt();
...@@ -233,10 +229,6 @@ getRequestCallback(want: Want): RequestCallback ...@@ -233,10 +229,6 @@ getRequestCallback(want: Want): RequestCallback
return true; return true;
} }
queryLocallInterface(descriptor) {
return null;
}
getInterfaceDescriptor() { getInterfaceDescriptor() {
return ""; return "";
} }
...@@ -249,41 +241,48 @@ getRequestCallback(want: Want): RequestCallback ...@@ -249,41 +241,48 @@ getRequestCallback(want: Want): RequestCallback
return REQUEST_VALUE; return REQUEST_VALUE;
} }
attachLocalInterface(localInterface, descriptor) { attachLocalInterface(localInterface: rpc.IRemoteBroker, descriptor: string) {
} }
} }
export default class ServiceExtAbility extends ServiceExtensionAbility { export default class ServiceExtAbility extends ServiceExtensionAbility {
onCreate(want) { onCreate(want: Want) {
console.info(TAG, `onCreate, want: ${want.abilityName}`); console.info(TAG, `onCreate, want: ${want.abilityName}`);
} }
onRequest(want, startId) { onRequest(want: Want, startId: number) {
console.info(TAG, `onRequest, want: ${want.abilityName}`); console.info(TAG, `onRequest, want: ${want.abilityName}`);
let windowClass: window.Window | undefined = undefined;
let config: window.Configuration = {name: "dialogWindow", windowType: window.WindowType.TYPE_DIALOG, ctx: this.context};
try { try {
var requestInfo = dialogRequest.getRequestInfo(want); let requestInfo = dialogRequest.getRequestInfo(want);
let windowClass = null; window.createWindow(config, (err, data) => {
windowClass.bindDialogTarget(requestInfo, () => { if (err.code) {
console.error('Failed to create the window. Cause: ' + JSON.stringify(err));
return;
}
windowClass = data;
windowClass.bindDialogTarget(requestInfo, () => {
console.info('Dialog Window Need Destroy.'); console.info('Dialog Window Need Destroy.');
}, (err) => { }, (err: BusinessError) => {
if (err.code) { if (err.code) {
console.error('Failed to bind dialog target. Cause: ${JSON.stringify(err)}'); console.error('Failed to bind dialog target. Cause: ${JSON.stringify(err)}');
return; return;
} }
console.info('Succeeded in binding dialog target.'); console.info('Succeeded in binding dialog target.');
});
}); });
} catch(err) { } catch(err) {
console.error('getRequestInfo err= ${JSON.stringify(err)}'); console.error('getRequestInfo err= ${JSON.stringify(err)}');
} }
} }
onConnect(want) { onConnect(want: Want) {
console.info(TAG, `onConnect, want: ${want.abilityName}`); console.info(TAG, `onConnect, want: ${want.abilityName}`);
return new StubTest("test"); return new StubTest("test");
} }
onDisconnect(want) { onDisconnect(want: Want) {
console.info(TAG, `onDisconnect, want: ${want.abilityName}`); console.info(TAG, `onDisconnect, want: ${want.abilityName}`);
} }
...@@ -345,6 +344,7 @@ setRequestResult(result: RequestResult): void; ...@@ -345,6 +344,7 @@ setRequestResult(result: RequestResult): void;
```ts ```ts
import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility'; import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
import dialogRequest from '@ohos.app.ability.dialogRequest'; import dialogRequest from '@ohos.app.ability.dialogRequest';
...@@ -353,11 +353,11 @@ setRequestResult(result: RequestResult): void; ...@@ -353,11 +353,11 @@ setRequestResult(result: RequestResult): void;
const REQUEST_VALUE = 1; const REQUEST_VALUE = 1;
class StubTest extends rpc.RemoteObject { class StubTest extends rpc.RemoteObject {
constructor(des) { constructor(des: string) {
super(des); super(des);
} }
onRemoteRequest(code, data, reply, option) { onRemoteRequest(code: number, data: rpc.MessageParcel, reply: rpc.MessageParcel, option: rpc.MessageOption) {
if (code === REQUEST_VALUE) { if (code === REQUEST_VALUE) {
let optFir = data.readInt(); let optFir = data.readInt();
let optSec = data.readInt(); let optSec = data.readInt();
...@@ -366,10 +366,6 @@ setRequestResult(result: RequestResult): void; ...@@ -366,10 +366,6 @@ setRequestResult(result: RequestResult): void;
return true; return true;
} }
queryLocallInterface(descriptor) {
return null;
}
getInterfaceDescriptor() { getInterfaceDescriptor() {
return ""; return "";
} }
...@@ -382,20 +378,20 @@ setRequestResult(result: RequestResult): void; ...@@ -382,20 +378,20 @@ setRequestResult(result: RequestResult): void;
return REQUEST_VALUE; return REQUEST_VALUE;
} }
attachLocalInterface(localInterface, descriptor) { attachLocalInterface(localInterface: rpc.IRemoteBroker, descriptor: string) {
} }
} }
export default class ServiceExtAbility extends ServiceExtensionAbility { export default class ServiceExtAbility extends ServiceExtensionAbility {
onCreate(want) { onCreate(want: Want) {
console.info(TAG, `onCreate, want: ${want.abilityName}`); console.info(TAG, `onCreate, want: ${want.abilityName}`);
} }
onRequest(want, startId) { onRequest(want: Want, startId: number) {
console.info(TAG, `onRequest, want: ${want.abilityName}`); console.info(TAG, `onRequest, want: ${want.abilityName}`);
try { try {
var requestCallback = dialogRequest.getRequestCallback(want); let requestCallback = dialogRequest.getRequestCallback(want);
let myResult = { let myResult: dialogRequest.RequestResult = {
result : dialogRequest.ResultCode.RESULT_CANCEL, result : dialogRequest.ResultCode.RESULT_CANCEL,
}; };
requestCallback.setRequestResult(myResult); requestCallback.setRequestResult(myResult);
...@@ -404,12 +400,12 @@ setRequestResult(result: RequestResult): void; ...@@ -404,12 +400,12 @@ setRequestResult(result: RequestResult): void;
} }
} }
onConnect(want) { onConnect(want: Want) {
console.info(TAG, `onConnect, want: ${want.abilityName}`); console.info(TAG, `onConnect, want: ${want.abilityName}`);
return new StubTest("test"); return new StubTest("test");
} }
onDisconnect(want) { onDisconnect(want: Want) {
console.info(TAG, `onDisconnect, want: ${want.abilityName}`); console.info(TAG, `onDisconnect, want: ${want.abilityName}`);
} }
......
...@@ -46,15 +46,15 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void; ...@@ -46,15 +46,15 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
**示例:** **示例:**
```ts ```ts
import UIAbility from '@ohos.app.ability.Ability'; import UIAbility from '@ohos.app.ability.UIAbility';
import EnvironmentCallback from '@ohos.app.ability.EnvironmentCallback';
let callbackId; let callbackId: number;
export default class MyAbility extends UIAbility { export default class MyAbility extends UIAbility {
onCreate() { onCreate() {
console.log('MyAbility onCreate'); console.log('MyAbility onCreate');
globalThis.applicationContext = this.context.getApplicationContext(); let environmentCallback: EnvironmentCallback = {
let environmentCallback = {
onConfigurationUpdated(config){ onConfigurationUpdated(config){
console.log('onConfigurationUpdated config: ${JSON.stringify(config)}'); console.log('onConfigurationUpdated config: ${JSON.stringify(config)}');
}, },
...@@ -64,14 +64,14 @@ export default class MyAbility extends UIAbility { ...@@ -64,14 +64,14 @@ export default class MyAbility extends UIAbility {
} }
}; };
// 1.获取applicationContext // 1.获取applicationContext
let applicationContext = globalThis.applicationContext; let applicationContext = this.context.getApplicationContext();
// 2.通过applicationContext注册监听应用内生命周期 // 2.通过applicationContext注册监听应用内生命周期
callbackId = applicationContext.registerEnvironmentCallback(environmentCallback); callbackId = applicationContext.on('environmentEvent', environmentCallback);
console.log('registerEnvironmentCallback number: ${JSON.stringify(callbackId)}'); console.log('registerEnvironmentCallback number: ${JSON.stringify(callbackId)}');
} }
onDestroy() { onDestroy() {
let applicationContext = globalThis.applicationContext; let applicationContext = this.context.getApplicationContext();
applicationContext.unregisterEnvironmentCallback(callbackId, (error, data) => { applicationContext.off('environment', callbackId, (error, data) => {
if (error && error.code !== 0) { if (error && error.code !== 0) {
console.error('unregisterEnvironmentCallback fail, error: ${JSON.stringify(error)}'); console.error('unregisterEnvironmentCallback fail, error: ${JSON.stringify(error)}');
} else { } else {
......
...@@ -43,7 +43,10 @@ on(type: 'error', observer: ErrorObserver): number; ...@@ -43,7 +43,10 @@ on(type: 'error', observer: ErrorObserver): number;
**示例:** **示例:**
```ts ```ts
let observer = { import errorManager from '@ohos.app.ability.errorManager';
import { BusinessError } from '@ohos.base';
let observer: errorManager.ErrorObserver = {
onUnhandledException(errorMsg) { onUnhandledException(errorMsg) {
console.log('onUnhandledException, errorMsg: ', errorMsg); console.log('onUnhandledException, errorMsg: ', errorMsg);
}, },
...@@ -59,7 +62,9 @@ let observerId = -1; ...@@ -59,7 +62,9 @@ let observerId = -1;
try { try {
observerId = errorManager.on('error', observer); observerId = errorManager.on('error', observer);
} catch (paramError) { } catch (paramError) {
console.error('error: ${paramError.code}, ${paramError.message}'); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message}`);
} }
``` ```
...@@ -90,9 +95,12 @@ off(type: 'error', observerId: number, callback: AsyncCallback\<void>): void; ...@@ -90,9 +95,12 @@ off(type: 'error', observerId: number, callback: AsyncCallback\<void>): void;
**示例:** **示例:**
```ts ```ts
import errorManager from '@ohos.app.ability.errorManager';
import { BusinessError } from '@ohos.base';
let observerId = 100; let observerId = 100;
function unregisterErrorObserverCallback(err) { function unregisterErrorObserverCallback(err: BusinessError) {
if (err) { if (err) {
console.error('------------ unregisterErrorObserverCallback ------------', err); console.error('------------ unregisterErrorObserverCallback ------------', err);
} }
...@@ -100,7 +108,9 @@ function unregisterErrorObserverCallback(err) { ...@@ -100,7 +108,9 @@ function unregisterErrorObserverCallback(err) {
try { try {
errorManager.off('error', observerId, unregisterErrorObserverCallback); errorManager.off('error', observerId, unregisterErrorObserverCallback);
} catch (paramError) { } catch (paramError) {
console.error('error: ${paramError.code}, ${paramError.message}'); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message}`);
} }
``` ```
...@@ -136,17 +146,22 @@ off(type: 'error', observerId: number): Promise\<void>; ...@@ -136,17 +146,22 @@ off(type: 'error', observerId: number): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import errorManager from '@ohos.app.ability.errorManager';
import { BusinessError } from '@ohos.base';
let observerId = 100; let observerId = 100;
try { try {
errorManager.off('error', observerId) errorManager.off('error', observerId)
.then((data) => { .then((data) => {
console.log('----------- unregisterErrorObserver success ----------', data); console.log('----------- unregisterErrorObserver success ----------', data);
}) })
.catch((err) => { .catch((err: BusinessError) => {
console.error('----------- unregisterErrorObserver fail ----------', err); console.error('----------- unregisterErrorObserver fail ----------', err);
}); });
} catch (paramError) { } catch (paramError) {
console.error('error: ${paramError.code}, ${paramError.message}'); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message}`);
} }
``` ```
...@@ -45,46 +45,57 @@ on(type:'mission', listener: MissionListener): number; ...@@ -45,46 +45,57 @@ on(type:'mission', listener: MissionListener): number;
```ts ```ts
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
let listener = { import common from '@ohos.app.ability.common';
onMissionCreated: function (mission) {console.log('--------onMissionCreated-------');}, import Want from '@ohos.app.ability.Want';
onMissionDestroyed: function (mission) {console.log('--------onMissionDestroyed-------');}, import { BusinessError } from '@ohos.base';
onMissionSnapshotChanged: function (mission) {console.log('--------onMissionSnapshotChanged-------');}, import window from '@ohos.window';
onMissionMovedToFront: function (mission) {console.log('--------onMissionMovedToFront-------');},
onMissionIconUpdated: function (mission, icon) {console.log('--------onMissionIconUpdated-------');}, let listener: missionManager.MissionListener = {
onMissionClosed: function (mission) {console.log('--------onMissionClosed-------');}, onMissionCreated: (mission) => {console.log('--------onMissionCreated-------');},
onMissionLabelUpdated: function (mission) {console.log('--------onMissionLabelUpdated-------');} onMissionDestroyed: (mission) => {console.log('--------onMissionDestroyed-------');},
onMissionSnapshotChanged: (mission) => {console.log('--------onMissionSnapshotChanged-------');},
onMissionMovedToFront: (mission) => {console.log('--------onMissionMovedToFront-------');},
onMissionIconUpdated: (mission, icon) => {console.log('--------onMissionIconUpdated-------');},
onMissionClosed: (mission) => {console.log('--------onMissionClosed-------');},
onMissionLabelUpdated: (mission) => {console.log('--------onMissionLabelUpdated-------');}
}; };
let listenerId = -1; let listenerId = -1;
let abilityWant: Want;
let context: common.UIAbilityContext;
export default class EntryAbility extends UIAbility { export default class EntryAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
console.log('[Demo] EntryAbility onCreate'); console.log('[Demo] EntryAbility onCreate');
globalThis.abilityWant = want; abilityWant = want;
globalThis.context = this.context; context = this.context;
} }
onDestroy() { onDestroy() {
try { try {
if (listenerId !== -1) { if (listenerId !== -1) {
missionManager.off('mission', listenerId).catch(function (err) { missionManager.off('mission', listenerId).catch((err: BusinessError) => {
console.log(err); console.log(err);
}); });
} }
} catch (paramError) { } catch (paramError) {
console.error('error: ${paramError.code}, ${paramError.message}'); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message} `);
} }
console.log('[Demo] EntryAbility onDestroy'); console.log('[Demo] EntryAbility onDestroy');
} }
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage: window.WindowStage) {
// Main window is created, set main page for this ability // Main window is created, set main page for this ability
console.log('[Demo] EntryAbility onWindowStageCreate'); console.log('[Demo] EntryAbility onWindowStageCreate');
try { try {
listenerId = missionManager.on('mission', listener); listenerId = missionManager.on('mission', listener);
} catch (paramError) { } catch (paramError) {
console.error('error: ${paramError.code}, ${paramError.message}'); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message} `);
} }
windowStage.loadContent('pages/index', (err, data) => { windowStage.loadContent('pages/index', (err, data) => {
...@@ -94,10 +105,6 @@ export default class EntryAbility extends UIAbility { ...@@ -94,10 +105,6 @@ export default class EntryAbility extends UIAbility {
} }
console.info('Succeeded in loading the content. Data: ${JSON.stringify(data)}'); console.info('Succeeded in loading the content. Data: ${JSON.stringify(data)}');
}); });
if (globalThis.flag) {
return;
}
} }
}; };
``` ```
...@@ -135,59 +142,66 @@ off(type: 'mission', listenerId: number, callback: AsyncCallback&lt;void&gt;): v ...@@ -135,59 +142,66 @@ off(type: 'mission', listenerId: number, callback: AsyncCallback&lt;void&gt;): v
```ts ```ts
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
let listener = { import common from '@ohos.app.ability.common';
onMissionCreated: function (mission) {console.log('--------onMissionCreated-------');}, import Want from '@ohos.app.ability.Want';
onMissionDestroyed: function (mission) {console.log('--------onMissionDestroyed-------');}, import { BusinessError } from '@ohos.base';
onMissionSnapshotChanged: function (mission) {console.log('--------onMissionSnapshotChanged-------');}, import window from '@ohos.window';
onMissionMovedToFront: function (mission) {console.log('--------onMissionMovedToFront-------');},
onMissionIconUpdated: function (mission, icon) {console.log('--------onMissionIconUpdated-------');}, let listener: missionManager.MissionListener = {
onMissionClosed: function (mission) {console.log('--------onMissionClosed-------');}, onMissionCreated: (mission) => {console.log('--------onMissionCreated-------');},
onMissionLabelUpdated: function (mission) {console.log('--------onMissionLabelUpdated-------');} onMissionDestroyed: (mission) => {console.log('--------onMissionDestroyed-------');},
onMissionSnapshotChanged: (mission) => {console.log('--------onMissionSnapshotChanged-------');},
onMissionMovedToFront: (mission) => {console.log('--------onMissionMovedToFront-------');},
onMissionIconUpdated: (mission, icon) => {console.log('--------onMissionIconUpdated-------');},
onMissionClosed: (mission) => {console.log('--------onMissionClosed-------');},
onMissionLabelUpdated: (mission) => {console.log('--------onMissionLabelUpdated-------');}
}; };
let listenerId = -1; let listenerId = -1;
let abilityWant: Want;
let context: common.UIAbilityContext;
export default class EntryAbility extends UIAbility { export default class EntryAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
console.log('[Demo] EntryAbility onCreate'); console.log('[Demo] EntryAbility onCreate');
globalThis.abilityWant = want; abilityWant = want;
globalThis.context = this.context; context = this.context;
} }
onDestroy() { onDestroy() {
try { try {
if (listenerId !== -1) { if (listenerId !== -1) {
missionManager.off('mission', listenerId, (err) => { missionManager.off('mission', listenerId, (err) => {
console.log(err); console.log('$(err.code)');
}); });
} }
} catch (paramError) { } catch (paramError) {
console.error('error: ${paramError.code}, ${paramError.message}'); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message} `);
} }
console.log('[Demo] EntryAbility onDestroy'); console.log('[Demo] EntryAbility onDestroy');
} }
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage: window.WindowStage) {
// Main window is created, set main page for this ability // Main window is created, set main page for this ability
console.log('[Demo] EntryAbility onWindowStageCreate'); console.log('[Demo] EntryAbility onWindowStageCreate');
try { try {
listenerId = missionManager.on('mission', listener); listenerId = missionManager.on('mission', listener);
} catch (paramError) { } catch (paramError) {
console.error('error: ${paramError.code}, ${paramError.message}'); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message} `);
} }
windowStage.loadContent('pages/index', (err, data) => { windowStage.loadContent('pages/index', (err: BusinessError, data) => {
if (err.code) { if (err.code) {
console.error('Failed to load the content. Cause: ${JSON.stringify(err)}'); console.error('Failed to load the content. Cause: ${JSON.stringify(err)}');
return; return;
} }
console.info('Succeeded in loading the content. Data: ${JSON.stringify(data)}'); console.info('Succeeded in loading the content. Data: ${JSON.stringify(data)}');
}); });
if (globalThis.flag) {
return;
}
} }
}; };
``` ```
...@@ -230,59 +244,66 @@ off(type: 'mission', listenerId: number): Promise&lt;void&gt;; ...@@ -230,59 +244,66 @@ off(type: 'mission', listenerId: number): Promise&lt;void&gt;;
```ts ```ts
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
let listener = { import common from '@ohos.app.ability.common';
onMissionCreated: function (mission) {console.log('--------onMissionCreated-------');}, import Want from '@ohos.app.ability.Want';
onMissionDestroyed: function (mission) {console.log('--------onMissionDestroyed-------');}, import { BusinessError } from '@ohos.base';
onMissionSnapshotChanged: function (mission) {console.log('--------onMissionSnapshotChanged-------');}, import window from '@ohos.window';
onMissionMovedToFront: function (mission) {console.log('--------onMissionMovedToFront-------');},
onMissionIconUpdated: function (mission, icon) {console.log('--------onMissionIconUpdated-------');}, let listener: missionManager.MissionListener = {
onMissionClosed: function (mission) {console.log('--------onMissionClosed-------');}, onMissionCreated: (mission) => {console.log('--------onMissionCreated-------');},
onMissionLabelUpdated: function (mission) {console.log('--------onMissionLabelUpdated-------');} onMissionDestroyed: (mission) => {console.log('--------onMissionDestroyed-------');},
onMissionSnapshotChanged: (mission) => {console.log('--------onMissionSnapshotChanged-------');},
onMissionMovedToFront: (mission) => {console.log('--------onMissionMovedToFront-------');},
onMissionIconUpdated: (mission, icon) => {console.log('--------onMissionIconUpdated-------');},
onMissionClosed: (mission) => {console.log('--------onMissionClosed-------');},
onMissionLabelUpdated: (mission) => {console.log('--------onMissionLabelUpdated-------');}
}; };
let listenerId = -1; let listenerId = -1;
let abilityWant: Want;
let context: common.UIAbilityContext;
export default class EntryAbility extends UIAbility { export default class EntryAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
console.log('[Demo] EntryAbility onCreate'); console.log('[Demo] EntryAbility onCreate');
globalThis.abilityWant = want; abilityWant = want;
globalThis.context = this.context; context = this.context;
} }
onDestroy() { onDestroy() {
try { try {
if (listenerId !== -1) { if (listenerId !== -1) {
missionManager.off('mission', listenerId).catch(function (err) { missionManager.off('mission', listenerId).catch((err: BusinessError) => {
console.log(err); console.log('$(err.code)');
}); });
} }
} catch (paramError) { } catch (paramError) {
console.error('error: ${paramError.code}, ${paramError.message}'); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message} `);
} }
console.log('[Demo] EntryAbility onDestroy'); console.log('[Demo] EntryAbility onDestroy');
} }
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage: window.WindowStage) {
// Main window is created, set main page for this ability // Main window is created, set main page for this ability
console.log('[Demo] EntryAbility onWindowStageCreate'); console.log('[Demo] EntryAbility onWindowStageCreate');
try { try {
listenerId = missionManager.on('mission', listener); listenerId = missionManager.on('mission', listener);
} catch (paramError) { } catch (paramError) {
console.error('error: ${paramError.code}, ${paramError.message}'); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message} `);
} }
windowStage.loadContent('pages/index', (err, data) => { windowStage.loadContent('pages/index', (err: BusinessError, data) => {
if (err.code) { if (err.code) {
console.error('Failed to load the content. Cause: ${JSON.stringify(err)}'); console.error('Failed to load the content. Cause: ${JSON.stringify(err)}');
return; return;
} }
console.info('Succeeded in loading the content. Data: ${JSON.stringify(data)}'); console.info('Succeeded in loading the content. Data: ${JSON.stringify(data)}');
}); });
if (globalThis.flag) {
return;
}
} }
}; };
``` ```
...@@ -312,6 +333,7 @@ getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback&lt;M ...@@ -312,6 +333,7 @@ getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback&lt;M
```ts ```ts
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
let testMissionId = 1; let testMissionId = 1;
...@@ -335,10 +357,12 @@ getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback&lt;M ...@@ -335,10 +357,12 @@ getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback&lt;M
} }
}); });
} catch (paramError) { } catch (paramError) {
console.error('error.code: ${paramError.code}, error.message: ${paramError.message}'); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message} `);
} }
}) })
.catch(function(err){console.log(err);}); .catch((err: BusinessError) => {console.log('$(err.code)');});
``` ```
## missionManager.getMissionInfo ## missionManager.getMissionInfo
...@@ -370,12 +394,13 @@ getMissionInfo(deviceId: string, missionId: number): Promise&lt;MissionInfo&gt;; ...@@ -370,12 +394,13 @@ getMissionInfo(deviceId: string, missionId: number): Promise&lt;MissionInfo&gt;;
```ts ```ts
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
let testMissionId = 1; let testMissionId = 1;
try { try {
missionManager.getMissionInfo('', testMissionId).then((data) => { missionManager.getMissionInfo('', testMissionId).then((data) => {
console.info('getMissionInfo successfully. Data: ${JSON.stringify(data)}'); console.info('getMissionInfo successfully. Data: ${JSON.stringify(data)}');
}).catch(error => { }).catch((error: BusinessError) => {
console.error('getMissionInfo failed. Cause: ${error.message}'); console.error('getMissionInfo failed. Cause: ${error.message}');
}); });
} catch (error) { } catch (error) {
...@@ -407,6 +432,7 @@ getMissionInfos(deviceId: string, numMax: number, callback: AsyncCallback&lt;Arr ...@@ -407,6 +432,7 @@ getMissionInfos(deviceId: string, numMax: number, callback: AsyncCallback&lt;Arr
```ts ```ts
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
try { try {
missionManager.getMissionInfos('', 10, (error, missions) => { missionManager.getMissionInfos('', 10, (error, missions) => {
...@@ -418,7 +444,9 @@ getMissionInfos(deviceId: string, numMax: number, callback: AsyncCallback&lt;Arr ...@@ -418,7 +444,9 @@ getMissionInfos(deviceId: string, numMax: number, callback: AsyncCallback&lt;Arr
} }
}); });
} catch (paramError) { } catch (paramError) {
console.error('error: ${paramError.code}, ${paramError.message}'); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message} `);
} }
``` ```
...@@ -452,11 +480,12 @@ getMissionInfos(deviceId: string, numMax: number): Promise&lt;Array&lt;MissionIn ...@@ -452,11 +480,12 @@ getMissionInfos(deviceId: string, numMax: number): Promise&lt;Array&lt;MissionIn
```ts ```ts
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
try { try {
missionManager.getMissionInfos('', 10).then((data) => { missionManager.getMissionInfos('', 10).then((data) => {
console.info('getMissionInfos successfully. Data: ${JSON.stringify(data)}'); console.info('getMissionInfos successfully. Data: ${JSON.stringify(data)}');
}).catch(error => { }).catch((error: BusinessError) => {
console.error('getMissionInfos failed. Cause: ${error.message}'); console.error('getMissionInfos failed. Cause: ${error.message}');
}); });
} catch (error) { } catch (error) {
...@@ -530,12 +559,13 @@ getMissionSnapShot(deviceId: string, missionId: number): Promise&lt;MissionSnaps ...@@ -530,12 +559,13 @@ getMissionSnapShot(deviceId: string, missionId: number): Promise&lt;MissionSnaps
**示例:** **示例:**
```ts ```ts
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
let testMissionId = 2; let testMissionId = 2;
try { try {
missionManager.getMissionSnapShot('', testMissionId).then((data) => { missionManager.getMissionSnapShot('', testMissionId).then((data) => {
console.info('getMissionSnapShot successfully. Data: ${JSON.stringify(data)}'); console.info('getMissionSnapShot successfully. Data: ${JSON.stringify(data)}');
}).catch(error => { }).catch((error: BusinessError) => {
console.error('getMissionSnapShot failed. Cause: ${error.message}'); console.error('getMissionSnapShot failed. Cause: ${error.message}');
}); });
} catch (error) { } catch (error) {
...@@ -610,12 +640,13 @@ getLowResolutionMissionSnapShot(deviceId: string, missionId: number): Promise\<M ...@@ -610,12 +640,13 @@ getLowResolutionMissionSnapShot(deviceId: string, missionId: number): Promise\<M
```ts ```ts
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
let testMissionId = 2; let testMissionId = 2;
try { try {
missionManager.getLowResolutionMissionSnapShot('', testMissionId).then((data) => { missionManager.getLowResolutionMissionSnapShot('', testMissionId).then((data) => {
console.info('getLowResolutionMissionSnapShot successfully. Data: ${JSON.stringify(data)}'); console.info('getLowResolutionMissionSnapShot successfully. Data: ${JSON.stringify(data)}');
}).catch(error => { }).catch((error: BusinessError) => {
console.error('getLowResolutionMissionSnapShot failed. Cause: ${error.message}'); console.error('getLowResolutionMissionSnapShot failed. Cause: ${error.message}');
}); });
} catch (error) { } catch (error) {
...@@ -705,12 +736,13 @@ lockMission(missionId: number): Promise&lt;void&gt;; ...@@ -705,12 +736,13 @@ lockMission(missionId: number): Promise&lt;void&gt;;
**示例:** **示例:**
```ts ```ts
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
let testMissionId = 2; let testMissionId = 2;
try { try {
missionManager.lockMission(testMissionId).then((data) => { missionManager.lockMission(testMissionId).then((data) => {
console.info('lockMission successfully. Data: ${JSON.stringify(data)}'); console.info('lockMission successfully. Data: ${JSON.stringify(data)}');
}).catch(error => { }).catch((error: BusinessError) => {
console.error('lockMission failed. Cause: ${error.message}'); console.error('lockMission failed. Cause: ${error.message}');
}); });
} catch (error) { } catch (error) {
...@@ -799,12 +831,13 @@ unlockMission(missionId: number): Promise&lt;void&gt;; ...@@ -799,12 +831,13 @@ unlockMission(missionId: number): Promise&lt;void&gt;;
```ts ```ts
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
let testMissionId = 2; let testMissionId = 2;
try { try {
missionManager.unlockMission(testMissionId).then((data) => { missionManager.unlockMission(testMissionId).then((data) => {
console.info('unlockMission successfully. Data: ${JSON.stringify(data)}'); console.info('unlockMission successfully. Data: ${JSON.stringify(data)}');
}).catch(error => { }).catch((error: BusinessError) => {
console.error('unlockMission failed. Cause: ${error.message}'); console.error('unlockMission failed. Cause: ${error.message}');
}); });
} catch (error) { } catch (error) {
...@@ -879,12 +912,13 @@ clearMission(missionId: number): Promise&lt;void&gt;; ...@@ -879,12 +912,13 @@ clearMission(missionId: number): Promise&lt;void&gt;;
```ts ```ts
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
let testMissionId = 2; let testMissionId = 2;
try { try {
missionManager.clearMission(testMissionId).then((data) => { missionManager.clearMission(testMissionId).then((data) => {
console.info('clearMission successfully. Data: ${JSON.stringify(data)}'); console.info('clearMission successfully. Data: ${JSON.stringify(data)}');
}).catch(error => { }).catch((error: BusinessError) => {
console.error('clearMission failed. Cause: ${error.message}'); console.error('clearMission failed. Cause: ${error.message}');
}); });
} catch (error) { } catch (error) {
...@@ -944,11 +978,12 @@ clearAllMissions(): Promise&lt;void&gt;; ...@@ -944,11 +978,12 @@ clearAllMissions(): Promise&lt;void&gt;;
```ts ```ts
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
try { try {
missionManager.clearAllMissions().then((data) => { missionManager.clearAllMissions().then((data) => {
console.info('clearAllMissions successfully. Data: ${JSON.stringify(data)}'); console.info('clearAllMissions successfully. Data: ${JSON.stringify(data)}');
}).catch(err => { }).catch((err: BusinessError) => {
console.error('clearAllMissions failed: ${err.message}'); console.error('clearAllMissions failed: ${err.message}');
}); });
} catch (err) { } catch (err) {
...@@ -1086,12 +1121,13 @@ moveMissionToFront(missionId: number, options?: StartOptions): Promise&lt;void&g ...@@ -1086,12 +1121,13 @@ moveMissionToFront(missionId: number, options?: StartOptions): Promise&lt;void&g
```ts ```ts
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
let testMissionId = 2; let testMissionId = 2;
try { try {
missionManager.moveMissionToFront(testMissionId).then((data) => { missionManager.moveMissionToFront(testMissionId).then((data) => {
console.info('moveMissionToFront successfully. Data: ${JSON.stringify(data)}'); console.info('moveMissionToFront successfully. Data: ${JSON.stringify(data)}');
}).catch(error => { }).catch((error: BusinessError) => {
console.error('moveMissionToFront failed. Cause: ${error.message}'); console.error('moveMissionToFront failed. Cause: ${error.message}');
}); });
} catch (error) { } catch (error) {
...@@ -1131,6 +1167,7 @@ moveMissionsToForeground(missionIds: Array&lt;number&gt;, callback: AsyncCallbac ...@@ -1131,6 +1167,7 @@ moveMissionsToForeground(missionIds: Array&lt;number&gt;, callback: AsyncCallbac
```ts ```ts
import abilityManager from '@ohos.app.ability.abilityManager'; import abilityManager from '@ohos.app.ability.abilityManager';
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
try { try {
missionManager.getMissionInfos("", 10, (error, missionInfos) => { missionManager.getMissionInfos("", 10, (error, missionInfos) => {
...@@ -1157,7 +1194,9 @@ try { ...@@ -1157,7 +1194,9 @@ try {
}); });
}); });
} catch (paramError) { } catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message} `);
} }
``` ```
...@@ -1195,6 +1234,7 @@ moveMissionsToForeground(missionIds: Array&lt;number&gt;, topMission: number, ca ...@@ -1195,6 +1234,7 @@ moveMissionsToForeground(missionIds: Array&lt;number&gt;, topMission: number, ca
```ts ```ts
import abilityManager from '@ohos.app.ability.abilityManager'; import abilityManager from '@ohos.app.ability.abilityManager';
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
try { try {
missionManager.getMissionInfos("", 10, (error, missionInfos) => { missionManager.getMissionInfos("", 10, (error, missionInfos) => {
...@@ -1221,7 +1261,9 @@ try { ...@@ -1221,7 +1261,9 @@ try {
}); });
}); });
} catch (paramError) { } catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message} `);
} }
``` ```
...@@ -1264,6 +1306,7 @@ moveMissionsToForeground(missionIds: Array&lt;number&gt;, topMission?: number): ...@@ -1264,6 +1306,7 @@ moveMissionsToForeground(missionIds: Array&lt;number&gt;, topMission?: number):
```ts ```ts
import abilityManager from '@ohos.app.ability.abilityManager'; import abilityManager from '@ohos.app.ability.abilityManager';
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
try { try {
missionManager.getMissionInfos("", 10, (error, missionInfos) => { missionManager.getMissionInfos("", 10, (error, missionInfos) => {
...@@ -1286,7 +1329,9 @@ try { ...@@ -1286,7 +1329,9 @@ try {
}); });
}); });
} catch (paramError) { } catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message} `);
} }
``` ```
...@@ -1323,6 +1368,7 @@ moveMissionsToBackground(missionIds: Array&lt;number&gt;, callback: AsyncCallbac ...@@ -1323,6 +1368,7 @@ moveMissionsToBackground(missionIds: Array&lt;number&gt;, callback: AsyncCallbac
```ts ```ts
import abilityManager from '@ohos.app.ability.abilityManager'; import abilityManager from '@ohos.app.ability.abilityManager';
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
try { try {
missionManager.getMissionInfos("", 10, (error, missionInfos) => { missionManager.getMissionInfos("", 10, (error, missionInfos) => {
...@@ -1346,7 +1392,9 @@ try { ...@@ -1346,7 +1392,9 @@ try {
}); });
}); });
} catch (paramError) { } catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message} `);
} }
``` ```
...@@ -1387,6 +1435,7 @@ moveMissionsToBackground(missionIds : Array&lt;number&gt;): Promise&lt;Array&lt; ...@@ -1387,6 +1435,7 @@ moveMissionsToBackground(missionIds : Array&lt;number&gt;): Promise&lt;Array&lt;
```ts ```ts
import abilityManager from '@ohos.app.ability.abilityManager'; import abilityManager from '@ohos.app.ability.abilityManager';
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
try { try {
missionManager.getMissionInfos("", 10, (error, missionInfos) => { missionManager.getMissionInfos("", 10, (error, missionInfos) => {
...@@ -1406,7 +1455,9 @@ try { ...@@ -1406,7 +1455,9 @@ try {
}); });
}); });
} catch (paramError) { } catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message} `);
} }
``` ```
\ No newline at end of file
...@@ -78,6 +78,8 @@ applyQuickFix(hapModuleQuickFixFiles: Array\<string>, callback: AsyncCallback\<v ...@@ -78,6 +78,8 @@ applyQuickFix(hapModuleQuickFixFiles: Array\<string>, callback: AsyncCallback\<v
**示例:** **示例:**
```ts ```ts
import quickFixManager from '@ohos.app.ability.quickFixManager';
try { try {
let hapModuleQuickFixFiles = ['/data/storage/el2/base/entry.hqf']; let hapModuleQuickFixFiles = ['/data/storage/el2/base/entry.hqf'];
quickFixManager.applyQuickFix(hapModuleQuickFixFiles, (error) => { quickFixManager.applyQuickFix(hapModuleQuickFixFiles, (error) => {
...@@ -130,11 +132,14 @@ applyQuickFix(hapModuleQuickFixFiles: Array\<string>): Promise\<void>; ...@@ -130,11 +132,14 @@ applyQuickFix(hapModuleQuickFixFiles: Array\<string>): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import quickFixManager from '@ohos.app.ability.quickFixManager';
import { BusinessError } from '@ohos.base';
let hapModuleQuickFixFiles = ['/data/storage/el2/base/entry.hqf']; let hapModuleQuickFixFiles = ['/data/storage/el2/base/entry.hqf'];
try { try {
quickFixManager.applyQuickFix(hapModuleQuickFixFiles).then(() => { quickFixManager.applyQuickFix(hapModuleQuickFixFiles).then(() => {
console.info('applyQuickFix success'); console.info('applyQuickFix success');
}).catch((error) => { }).catch((error: BusinessError) => {
console.error(`applyQuickFix err: ${error}`); console.error(`applyQuickFix err: ${error}`);
}); });
} catch (paramError) { } catch (paramError) {
...@@ -173,6 +178,8 @@ getApplicationQuickFixInfo(bundleName: string, callback: AsyncCallback\<Applicat ...@@ -173,6 +178,8 @@ getApplicationQuickFixInfo(bundleName: string, callback: AsyncCallback\<Applicat
**示例:** **示例:**
```ts ```ts
import quickFixManager from '@ohos.app.ability.quickFixManager';
try { try {
let bundleName = 'bundleName'; let bundleName = 'bundleName';
quickFixManager.getApplicationQuickFixInfo(bundleName, (error, data) => { quickFixManager.getApplicationQuickFixInfo(bundleName, (error, data) => {
...@@ -223,11 +230,14 @@ getApplicationQuickFixInfo(bundleName: string): Promise\<ApplicationQuickFixInfo ...@@ -223,11 +230,14 @@ getApplicationQuickFixInfo(bundleName: string): Promise\<ApplicationQuickFixInfo
**示例:** **示例:**
```ts ```ts
import quickFixManager from '@ohos.app.ability.quickFixManager';
import { BusinessError } from '@ohos.base';
try { try {
let bundleName = 'bundleName'; let bundleName = 'bundleName';
quickFixManager.getApplicationQuickFixInfo(bundleName).then((data) => { quickFixManager.getApplicationQuickFixInfo(bundleName).then((data) => {
console.info(`getApplicationQuickFixInfo success: ${data}`); console.info(`getApplicationQuickFixInfo success: ${data}`);
}).catch((error) => { }).catch((error: BusinessError) => {
console.error(`getApplicationQuickFixInfo err: ${error}`); console.error(`getApplicationQuickFixInfo err: ${error}`);
}); });
} catch (paramError) { } catch (paramError) {
...@@ -268,6 +278,8 @@ revokeQuickFix(bundleName: string, callback: AsyncCallback\<void>): void; ...@@ -268,6 +278,8 @@ revokeQuickFix(bundleName: string, callback: AsyncCallback\<void>): void;
**示例:** **示例:**
```ts ```ts
import quickFixManager from '@ohos.app.ability.quickFixManager';
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
quickFixManager.revokeQuickFix(bundleName, (err) => { quickFixManager.revokeQuickFix(bundleName, (err) => {
console.info("revokeQuickFix " + bundleName + " " + JSON.stringify(err)); console.info("revokeQuickFix " + bundleName + " " + JSON.stringify(err));
...@@ -312,10 +324,13 @@ revokeQuickFix(bundleName: string): Promise\<void>; ...@@ -312,10 +324,13 @@ revokeQuickFix(bundleName: string): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import quickFixManager from '@ohos.app.ability.quickFixManager';
import { BusinessError } from '@ohos.base';
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
quickFixManager.revokeQuickFix(bundleName).then(() => { quickFixManager.revokeQuickFix(bundleName).then(() => {
console.info("revokeQuickFix " + bundleName +" ok"); console.info("revokeQuickFix " + bundleName +" ok");
}).catch((err) => { }).catch((err: BusinessError) => {
console.info("revokeQuickFix " + bundleName +" failed, error code is ", JSON.stringify((err))); console.info("revokeQuickFix " + bundleName +" failed, error code is ", JSON.stringify((err)));
}); });
``` ```
\ No newline at end of file
...@@ -48,8 +48,11 @@ Extension生命周期回调,在创建时回调,执行初始化业务逻辑 ...@@ -48,8 +48,11 @@ Extension生命周期回调,在创建时回调,执行初始化业务逻辑
**示例:** **示例:**
```ts ```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
onCreate(want) { onCreate(want: Want) {
console.log('onCreate, want: ${want.abilityName}'); console.log('onCreate, want: ${want.abilityName}');
} }
} }
...@@ -69,6 +72,8 @@ Extension生命周期回调,在销毁时回调,执行资源清理等操作 ...@@ -69,6 +72,8 @@ Extension生命周期回调,在销毁时回调,执行资源清理等操作
**示例:** **示例:**
```ts ```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
onDestroy() { onDestroy() {
console.log('onDestroy'); console.log('onDestroy');
...@@ -97,8 +102,11 @@ Extension生命周期回调,如果是startAbility或者startServiceExtensionAb ...@@ -97,8 +102,11 @@ Extension生命周期回调,如果是startAbility或者startServiceExtensionAb
**示例:** **示例:**
```ts ```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
onRequest(want, startId) { onRequest(want: Want, startId: number) {
console.log('onRequest, want: ${want.abilityName}'); console.log('onRequest, want: ${want.abilityName}');
} }
} }
...@@ -131,15 +139,18 @@ Extension生命周期回调,如果是connectAbility拉起的服务,会在onC ...@@ -131,15 +139,18 @@ Extension生命周期回调,如果是connectAbility拉起的服务,会在onC
```ts ```ts
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
class StubTest extends rpc.RemoteObject{ class StubTest extends rpc.RemoteObject{
constructor(des) { constructor(des: string) {
super(des); super(des);
} }
onConnect(code, data, reply, option) { onConnect(code: number, data: rpc.MessageSequence, reply: rpc.MessageSequence, option: rpc.MessageOption) {
} }
} }
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
onConnect(want) { onConnect(want: Want) {
console.log('onConnect , want: ${want.abilityName}'); console.log('onConnect , want: ${want.abilityName}');
return new StubTest('test'); return new StubTest('test');
} }
...@@ -150,11 +161,14 @@ Extension生命周期回调,如果是connectAbility拉起的服务,会在onC ...@@ -150,11 +161,14 @@ Extension生命周期回调,如果是connectAbility拉起的服务,会在onC
```ts ```ts
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
class StubTest extends rpc.RemoteObject{ class StubTest extends rpc.RemoteObject{
constructor(des) { constructor(des: string) {
super(des); super(des);
} }
onConnect(code, data, reply, option) { onConnect(code: number, data: rpc.MessageSequence, reply: rpc.MessageSequence, option: rpc.MessageOption) {
} }
} }
async function getDescriptor() { async function getDescriptor() {
...@@ -162,7 +176,7 @@ async function getDescriptor() { ...@@ -162,7 +176,7 @@ async function getDescriptor() {
return "asyncTest" return "asyncTest"
} }
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
async onConnect(want) { async onConnect(want: Want) {
console.log(`onConnect , want: ${want.abilityName}`); console.log(`onConnect , want: ${want.abilityName}`);
let descriptor = await getDescriptor(); let descriptor = await getDescriptor();
return new StubTest(descriptor); return new StubTest(descriptor);
...@@ -189,8 +203,11 @@ Extension的生命周期回调,客户端执行断开连接服务时回调。 ...@@ -189,8 +203,11 @@ Extension的生命周期回调,客户端执行断开连接服务时回调。
**示例:** **示例:**
```ts ```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
onDisconnect(want) { onDisconnect(want: Want) {
console.log('onDisconnect, want: ${want.abilityName}'); console.log('onDisconnect, want: ${want.abilityName}');
} }
} }
...@@ -199,8 +216,11 @@ Extension的生命周期回调,客户端执行断开连接服务时回调。 ...@@ -199,8 +216,11 @@ Extension的生命周期回调,客户端执行断开连接服务时回调。
在执行完onDisconnect生命周期回调后,应用可能会退出,从而可能导致onDisconnect中的异步函数未能正确执行,比如异步写入数据库。可以使用异步生命周期,以确保异步onDisconnect完成后再继续后续的生命周期。 在执行完onDisconnect生命周期回调后,应用可能会退出,从而可能导致onDisconnect中的异步函数未能正确执行,比如异步写入数据库。可以使用异步生命周期,以确保异步onDisconnect完成后再继续后续的生命周期。
```ts ```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
async onDisconnect(want) { async onDisconnect(want: Want) {
console.log('onDisconnect, want: ${want.abilityName}'); console.log('onDisconnect, want: ${want.abilityName}');
// 调用异步函数... // 调用异步函数...
} }
...@@ -226,8 +246,11 @@ Extension的生命周期回调,当所有以前的客户端都断开连接之 ...@@ -226,8 +246,11 @@ Extension的生命周期回调,当所有以前的客户端都断开连接之
**示例:** **示例:**
```ts ```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
onReconnect(want) { onReconnect(want: Want) {
console.log('onReconnect, want: ${want.abilityName}'); console.log('onReconnect, want: ${want.abilityName}');
} }
} }
...@@ -252,8 +275,11 @@ onConfigurationUpdate(newConfig: Configuration): void; ...@@ -252,8 +275,11 @@ onConfigurationUpdate(newConfig: Configuration): void;
**示例:** **示例:**
```ts ```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import { Configuration } from '@ohos.app.ability.Configuration';
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
onConfigurationUpdate(config) { onConfigurationUpdate(config: Configuration) {
console.log('onConfigurationUpdate, config: ${JSON.stringify(config)}'); console.log('onConfigurationUpdate, config: ${JSON.stringify(config)}');
} }
} }
...@@ -278,8 +304,10 @@ onDump(params: Array\<string>): Array\<string>; ...@@ -278,8 +304,10 @@ onDump(params: Array\<string>): Array\<string>;
**示例:** **示例:**
```ts ```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
onDump(params) { onDump(params: Array<string>) {
console.log('dump, params: ${JSON.stringify(params)}'); console.log('dump, params: ${JSON.stringify(params)}');
return ['params']; return ['params'];
} }
......
...@@ -26,6 +26,8 @@ import StartOptions from '@ohos.app.ability.StartOptions'; ...@@ -26,6 +26,8 @@ import StartOptions from '@ohos.app.ability.StartOptions';
```ts ```ts
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
import StartOptions from '@ohos.app.ability.StartOptions';
import { BusinessError } from '@ohos.base';
try { try {
missionManager.getMissionInfos('', 10, (error, missions) => { missionManager.getMissionInfos('', 10, (error, missions) => {
...@@ -37,7 +39,7 @@ import StartOptions from '@ohos.app.ability.StartOptions'; ...@@ -37,7 +39,7 @@ import StartOptions from '@ohos.app.ability.StartOptions';
console.log(`missions = ${JSON.stringify(missions)}`); console.log(`missions = ${JSON.stringify(missions)}`);
let id = missions[0].missionId; let id = missions[0].missionId;
let startOptions = { let startOptions: StartOptions = {
windowMode : 101, windowMode : 101,
displayId: 0 displayId: 0
}; };
...@@ -46,6 +48,8 @@ import StartOptions from '@ohos.app.ability.StartOptions'; ...@@ -46,6 +48,8 @@ import StartOptions from '@ohos.app.ability.StartOptions';
}); });
}); });
} catch (paramError) { } catch (paramError) {
console.error(`error: ${paramError.code}, ${paramError.message}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message}`);
} }
``` ```
...@@ -45,8 +45,12 @@ UIAbility创建时回调,执行初始化业务逻辑操作。 ...@@ -45,8 +45,12 @@ UIAbility创建时回调,执行初始化业务逻辑操作。
**示例:** **示例:**
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import Want from '@ohos.app.ability.Want';
class MyUIAbility extends UIAbility { class MyUIAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
console.log('onCreate, want: ${want.abilityName}'); console.log('onCreate, want: ${want.abilityName}');
} }
} }
...@@ -70,8 +74,11 @@ onWindowStageCreate(windowStage: window.WindowStage): void ...@@ -70,8 +74,11 @@ onWindowStageCreate(windowStage: window.WindowStage): void
**示例:** **示例:**
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import window from '@ohos.window';
class MyUIAbility extends UIAbility { class MyUIAbility extends UIAbility {
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage: window.WindowStage) {
console.log('onWindowStageCreate'); console.log('onWindowStageCreate');
} }
} }
...@@ -89,6 +96,8 @@ onWindowStageDestroy(): void ...@@ -89,6 +96,8 @@ onWindowStageDestroy(): void
**示例:** **示例:**
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility';
class MyUIAbility extends UIAbility { class MyUIAbility extends UIAbility {
onWindowStageDestroy() { onWindowStageDestroy() {
console.log('onWindowStageDestroy'); console.log('onWindowStageDestroy');
...@@ -114,8 +123,11 @@ onWindowStageRestore(windowStage: window.WindowStage): void ...@@ -114,8 +123,11 @@ onWindowStageRestore(windowStage: window.WindowStage): void
**示例:** **示例:**
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import window from '@ohos.window';
class MyUIAbility extends UIAbility { class MyUIAbility extends UIAbility {
onWindowStageRestore(windowStage) { onWindowStageRestore(windowStage: window.WindowStage) {
console.log('onWindowStageRestore'); console.log('onWindowStageRestore');
} }
} }
...@@ -134,6 +146,8 @@ UIAbility生命周期回调,在销毁时回调,执行资源清理等操作 ...@@ -134,6 +146,8 @@ UIAbility生命周期回调,在销毁时回调,执行资源清理等操作
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility';
class MyUIAbility extends UIAbility { class MyUIAbility extends UIAbility {
onDestroy() { onDestroy() {
console.log('onDestroy'); console.log('onDestroy');
...@@ -144,6 +158,8 @@ UIAbility生命周期回调,在销毁时回调,执行资源清理等操作 ...@@ -144,6 +158,8 @@ UIAbility生命周期回调,在销毁时回调,执行资源清理等操作
在执行完onDestroy生命周期回调后,应用可能会退出,从而可能导致onDestroy中的异步函数未能正确执行,比如异步写入数据库。可以使用异步生命周期,以确保异步onDestroy完成后再继续后续的生命周期。 在执行完onDestroy生命周期回调后,应用可能会退出,从而可能导致onDestroy中的异步函数未能正确执行,比如异步写入数据库。可以使用异步生命周期,以确保异步onDestroy完成后再继续后续的生命周期。
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility';
class MyUIAbility extends UIAbility { class MyUIAbility extends UIAbility {
async onDestroy() { async onDestroy() {
console.log('onDestroy'); console.log('onDestroy');
...@@ -163,6 +179,8 @@ UIAbility生命周期回调,当应用从后台转到前台时触发。 ...@@ -163,6 +179,8 @@ UIAbility生命周期回调,当应用从后台转到前台时触发。
**示例:** **示例:**
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility';
class MyUIAbility extends UIAbility { class MyUIAbility extends UIAbility {
onForeground() { onForeground() {
console.log('onForeground'); console.log('onForeground');
...@@ -182,6 +200,8 @@ UIAbility生命周期回调,当应用从前台转到后台时触发。 ...@@ -182,6 +200,8 @@ UIAbility生命周期回调,当应用从前台转到后台时触发。
**示例:** **示例:**
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility';
class MyUIAbility extends UIAbility { class MyUIAbility extends UIAbility {
onBackground() { onBackground() {
console.log('onBackground'); console.log('onBackground');
...@@ -213,9 +233,11 @@ onContinue(wantParam: { [key: string]: Object }): AbilityConstant.OnContinueResu ...@@ -213,9 +233,11 @@ onContinue(wantParam: { [key: string]: Object }): AbilityConstant.OnContinueResu
**示例:** **示例:**
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant'; import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyUIAbility extends UIAbility { class MyUIAbility extends UIAbility {
onContinue(wantParams) { onContinue(wantParams: Record<string, Object>) {
console.log('onContinue'); console.log('onContinue');
wantParams['myData'] = 'my1234567'; wantParams['myData'] = 'my1234567';
return AbilityConstant.OnContinueResult.AGREE; return AbilityConstant.OnContinueResult.AGREE;
...@@ -242,8 +264,11 @@ onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void; ...@@ -242,8 +264,11 @@ onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void;
**示例:** **示例:**
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyUIAbility extends UIAbility { class MyUIAbility extends UIAbility {
onNewWant(want, launchParam) { onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam) {
console.log('onNewWant, want: ${want.abilityName}'); console.log('onNewWant, want: ${want.abilityName}');
console.log('onNewWant, launchParam: ${JSON.stringify(launchParam)}'); console.log('onNewWant, launchParam: ${JSON.stringify(launchParam)}');
} }
...@@ -267,8 +292,10 @@ onDump(params: Array\<string>): Array\<string>; ...@@ -267,8 +292,10 @@ onDump(params: Array\<string>): Array\<string>;
**示例:** **示例:**
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility';
class MyUIAbility extends UIAbility { class MyUIAbility extends UIAbility {
onDump(params) { onDump(params: Array<string>) {
console.log('dump, params: ${JSON.stringify(params)}'); console.log('dump, params: ${JSON.stringify(params)}');
return ['params']; return ['params'];
} }
...@@ -300,10 +327,11 @@ onSaveState(reason: AbilityConstant.StateType, wantParam : {[key: string]: Objec ...@@ -300,10 +327,11 @@ onSaveState(reason: AbilityConstant.StateType, wantParam : {[key: string]: Objec
**示例:** **示例:**
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant'; import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyUIAbility extends UIAbility { class MyUIAbility extends UIAbility {
onSaveState(reason, wantParam) { onSaveState(reason: AbilityConstant.StateType, wantParam: Record<string, Object>) {
console.log('onSaveState'); console.log('onSaveState');
wantParam['myData'] = 'my1234567'; wantParam['myData'] = 'my1234567';
return AbilityConstant.OnSaveResult.RECOVERY_AGREE; return AbilityConstant.OnSaveResult.RECOVERY_AGREE;
...@@ -328,9 +356,11 @@ onShare(wantParam:{ [key: string]: Object }): void; ...@@ -328,9 +356,11 @@ onShare(wantParam:{ [key: string]: Object }): void;
**示例:** **示例:**
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant'; import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyUIAbility extends UIAbility { class MyUIAbility extends UIAbility {
onShare(wantParams) { onShare(wantParams: Record<string, Object>) {
console.log('onShare'); console.log('onShare');
wantParams['ohos.extra.param.key.shareUrl'] = 'example.com'; wantParams['ohos.extra.param.key.shareUrl'] = 'example.com';
} }
...@@ -356,11 +386,15 @@ UIAbility生命周期回调,当系统预关闭开关打开后(配置系统 ...@@ -356,11 +386,15 @@ UIAbility生命周期回调,当系统预关闭开关打开后(配置系统
**示例:** **示例:**
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
export default class EntryAbility extends UIAbility { export default class EntryAbility extends UIAbility {
onPrepareToTerminate() { onPrepareToTerminate() {
// 开发者定义预关闭动作 // 开发者定义预关闭动作
// 例如拉起另一个ability,根据ability处理结果执行异步关闭 // 例如拉起另一个ability,根据ability处理结果执行异步关闭
let want = { let want: Want = {
bundleName: "com.example.myapplication", bundleName: "com.example.myapplication",
moduleName: "entry", moduleName: "entry",
abilityName: "SecondAbility" abilityName: "SecondAbility"
...@@ -372,7 +406,7 @@ UIAbility生命周期回调,当系统预关闭开关打开后(配置系统 ...@@ -372,7 +406,7 @@ UIAbility生命周期回调,当系统预关闭开关打开后(配置系统
if (result.resultCode === 0) { if (result.resultCode === 0) {
this.context.terminateSelf(); this.context.terminateSelf();
} }
}).catch((err)=>{ }).catch((err: BusinessError)=>{
// 异常处理 // 异常处理
console.log('startAbilityForResult failed, err:' + JSON.stringify(err)); console.log('startAbilityForResult failed, err:' + JSON.stringify(err));
this.context.terminateSelf(); this.context.terminateSelf();
...@@ -421,21 +455,27 @@ call(method: string, data: rpc.Parcelable): Promise&lt;void&gt;; ...@@ -421,21 +455,27 @@ call(method: string, data: rpc.Parcelable): Promise&lt;void&gt;;
**示例:** **示例:**
```ts ```ts
class MyMessageAble{ // 自定义的Parcelable数据结构 import UIAbility from '@ohos.app.ability.UIAbility';
name:'' import { Caller } from '@ohos.app.ability.UIAbility';
str:'' import { BusinessError } from '@ohos.base';
num: 1 import window from '@ohos.window';
constructor(name, str) { import rpc from '@ohos.rpc';
class MyMessageAble implements rpc.Parcelable { // 自定义的Parcelable数据结构
name: string
str: string
num: number = 1
constructor(name: string, str: string) {
this.name = name; this.name = name;
this.str = str; this.str = str;
} }
marshalling(messageSequence) { marshalling(messageSequence: rpc.MessageSequence) {
messageSequence.writeInt(this.num); messageSequence.writeInt(this.num);
messageSequence.writeString(this.str); messageSequence.writeString(this.str);
console.log('MyMessageAble marshalling num[${this.num}] str[${this.str}]'); console.log('MyMessageAble marshalling num[${this.num}] str[${this.str}]');
return true; return true;
} }
unmarshalling(messageSequence) { unmarshalling(messageSequence: rpc.MessageSequence) {
this.num = messageSequence.readInt(); this.num = messageSequence.readInt();
this.str = messageSequence.readString(); this.str = messageSequence.readString();
console.log('MyMessageAble unmarshalling num[${this.num}] str[${this.str}]'); console.log('MyMessageAble unmarshalling num[${this.num}] str[${this.str}]');
...@@ -443,9 +483,9 @@ call(method: string, data: rpc.Parcelable): Promise&lt;void&gt;; ...@@ -443,9 +483,9 @@ call(method: string, data: rpc.Parcelable): Promise&lt;void&gt;;
} }
}; };
let method = 'call_Function'; // 约定的通知消息字符串 let method = 'call_Function'; // 约定的通知消息字符串
let caller; let caller: Caller;
export default class MainUIAbility extends UIAbility { export default class MainUIAbility extends UIAbility {
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage: window.WindowStage) {
this.context.startAbilityByCall({ this.context.startAbilityByCall({
bundleName: 'com.example.myservice', bundleName: 'com.example.myservice',
abilityName: 'MainUIAbility', abilityName: 'MainUIAbility',
...@@ -457,10 +497,10 @@ call(method: string, data: rpc.Parcelable): Promise&lt;void&gt;; ...@@ -457,10 +497,10 @@ call(method: string, data: rpc.Parcelable): Promise&lt;void&gt;;
.then(() => { .then(() => {
console.log('Caller call() called'); console.log('Caller call() called');
}) })
.catch((callErr) => { .catch((callErr: BusinessError) => {
console.log('Caller.call catch error, error.code: ${callErr.code}, error.message: ${callErr.message}'); console.log('Caller.call catch error, error.code: ${callErr.code}, error.message: ${callErr.message}');
}); });
}).catch((err) => { }).catch((err: BusinessError) => {
console.log('Caller GetCaller error, error.code: ${err.code}, error.message: ${err.message}'); console.log('Caller GetCaller error, error.code: ${err.code}, error.message: ${err.message}');
}); });
} }
...@@ -502,21 +542,27 @@ callWithResult(method: string, data: rpc.Parcelable): Promise&lt;rpc.MessageSequ ...@@ -502,21 +542,27 @@ callWithResult(method: string, data: rpc.Parcelable): Promise&lt;rpc.MessageSequ
**示例:** **示例:**
```ts ```ts
class MyMessageAble{ import UIAbility from '@ohos.app.ability.UIAbility';
name:'' import { Caller } from '@ohos.app.ability.UIAbility';
str:'' import { BusinessError } from '@ohos.base';
num: 1 import window from '@ohos.window';
constructor(name, str) { import rpc from '@ohos.rpc';
class MyMessageAble implements rpc.Parcelable {
name: string
str: string
num: number = 1
constructor(name: string, str: string) {
this.name = name; this.name = name;
this.str = str; this.str = str;
} }
marshalling(messageSequence) { marshalling(messageSequence: rpc.MessageSequence) {
messageSequence.writeInt(this.num); messageSequence.writeInt(this.num);
messageSequence.writeString(this.str); messageSequence.writeString(this.str);
console.log('MyMessageAble marshalling num[${this.num}] str[${this.str}]'); console.log('MyMessageAble marshalling num[${this.num}] str[${this.str}]');
return true; return true;
} }
unmarshalling(messageSequence) { unmarshalling(messageSequence: rpc.MessageSequence) {
this.num = messageSequence.readInt(); this.num = messageSequence.readInt();
this.str = messageSequence.readString(); this.str = messageSequence.readString();
console.log('MyMessageAble unmarshalling num[${this.num] str[${this.str}]'); console.log('MyMessageAble unmarshalling num[${this.num] str[${this.str}]');
...@@ -524,9 +570,9 @@ callWithResult(method: string, data: rpc.Parcelable): Promise&lt;rpc.MessageSequ ...@@ -524,9 +570,9 @@ callWithResult(method: string, data: rpc.Parcelable): Promise&lt;rpc.MessageSequ
} }
}; };
let method = 'call_Function'; let method = 'call_Function';
let caller; let caller: Caller;
export default class MainUIAbility extends UIAbility { export default class MainUIAbility extends UIAbility {
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage: window.WindowStage) {
this.context.startAbilityByCall({ this.context.startAbilityByCall({
bundleName: 'com.example.myservice', bundleName: 'com.example.myservice',
abilityName: 'MainUIAbility', abilityName: 'MainUIAbility',
...@@ -540,10 +586,10 @@ callWithResult(method: string, data: rpc.Parcelable): Promise&lt;rpc.MessageSequ ...@@ -540,10 +586,10 @@ callWithResult(method: string, data: rpc.Parcelable): Promise&lt;rpc.MessageSequ
let retmsg = new MyMessageAble(0, ''); let retmsg = new MyMessageAble(0, '');
data.readParcelable(retmsg); data.readParcelable(retmsg);
}) })
.catch((callErr) => { .catch((callErr: BusinessError) => {
console.log('Caller.callWithResult catch error, error.code: ${callErr.code}, error.message: ${callErr.message}'); console.log('Caller.callWithResult catch error, error.code: ${callErr.code}, error.message: ${callErr.message}');
}); });
}).catch((err) => { }).catch((err: BusinessError) => {
console.log('Caller GetCaller error, error.code: ${err.code}, error.message: ${err.message}'); console.log('Caller GetCaller error, error.code: ${err.code}, error.message: ${err.message}');
}); });
} }
...@@ -571,9 +617,14 @@ release(): void; ...@@ -571,9 +617,14 @@ release(): void;
**示例:** **示例:**
```ts ```ts
let caller; import UIAbility from '@ohos.app.ability.UIAbility';
import { Caller } from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
import window from '@ohos.window';
let caller: Caller;
export default class MainUIAbility extends UIAbility { export default class MainUIAbility extends UIAbility {
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage: window.WindowStage) {
this.context.startAbilityByCall({ this.context.startAbilityByCall({
bundleName: 'com.example.myservice', bundleName: 'com.example.myservice',
abilityName: 'MainUIAbility', abilityName: 'MainUIAbility',
...@@ -585,7 +636,7 @@ release(): void; ...@@ -585,7 +636,7 @@ release(): void;
} catch (releaseErr) { } catch (releaseErr) {
console.log('Caller.release catch error, error.code: ${releaseErr.code}, error.message: ${releaseErr.message}'); console.log('Caller.release catch error, error.code: ${releaseErr.code}, error.message: ${releaseErr.message}');
} }
}).catch((err) => { }).catch((err: BusinessError) => {
console.log('Caller GetCaller error, error.code: ${err.code}, error.message: ${err.message}'); console.log('Caller GetCaller error, error.code: ${err.code}, error.message: ${err.message}');
}); });
} }
...@@ -617,9 +668,14 @@ release(): void; ...@@ -617,9 +668,14 @@ release(): void;
**示例:** **示例:**
```ts ```ts
let caller; import UIAbility from '@ohos.app.ability.UIAbility';
import { Caller } from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
import window from '@ohos.window';
let caller: Caller;
export default class MainUIAbility extends UIAbility { export default class MainUIAbility extends UIAbility {
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage: window.WindowStage) {
this.context.startAbilityByCall({ this.context.startAbilityByCall({
bundleName: 'com.example.myservice', bundleName: 'com.example.myservice',
abilityName: 'MainUIAbility', abilityName: 'MainUIAbility',
...@@ -633,7 +689,7 @@ release(): void; ...@@ -633,7 +689,7 @@ release(): void;
} catch (error) { } catch (error) {
console.log('Caller.onRelease catch error, error.code: $error.code}, error.message: ${error.message}'); console.log('Caller.onRelease catch error, error.code: $error.code}, error.message: ${error.message}');
} }
}).catch((err) => { }).catch((err: BusinessError) => {
console.log('Caller GetCaller error, error.code: ${err.code}, error.message: ${err.message}'); console.log('Caller GetCaller error, error.code: ${err.code}, error.message: ${err.message}');
}); });
} }
...@@ -666,9 +722,11 @@ onRemoteStateChange(callback: OnRemoteStateChangeCallback): void; ...@@ -666,9 +722,11 @@ onRemoteStateChange(callback: OnRemoteStateChangeCallback): void;
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import { Caller } from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
import window from '@ohos.window'; import window from '@ohos.window';
let caller; let caller: Caller;
let dstDeviceId: string; let dstDeviceId: string;
export default class MainAbility extends UIAbility { export default class MainAbility extends UIAbility {
onWindowStageCreate(windowStage: window.WindowStage) { onWindowStageCreate(windowStage: window.WindowStage) {
...@@ -685,7 +743,7 @@ onRemoteStateChange(callback: OnRemoteStateChangeCallback): void; ...@@ -685,7 +743,7 @@ onRemoteStateChange(callback: OnRemoteStateChangeCallback): void;
} catch (error) { } catch (error) {
console.log('Caller.onRemoteStateChange catch error, error.code: ${JSON.stringify(error.code)}, error.message: ${JSON.stringify(error.message)}'); console.log('Caller.onRemoteStateChange catch error, error.code: ${JSON.stringify(error.code)}, error.message: ${JSON.stringify(error.message)}');
} }
}).catch((err) => { }).catch((err: BusinessError) => {
console.log('Caller GetCaller error, error.code: ${JSON.stringify(err.code)}, error.message: ${JSON.stringify(err.message)}'); console.log('Caller GetCaller error, error.code: ${JSON.stringify(err.code)}, error.message: ${JSON.stringify(err.message)}');
}) })
} }
...@@ -719,9 +777,14 @@ on(type: 'release', callback: OnReleaseCallback): void; ...@@ -719,9 +777,14 @@ on(type: 'release', callback: OnReleaseCallback): void;
**示例:** **示例:**
```ts ```ts
let caller; import UIAbility from '@ohos.app.ability.UIAbility';
import { Caller } from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
import window from '@ohos.window';
let caller: Caller;
export default class MainUIAbility extends UIAbility { export default class MainUIAbility extends UIAbility {
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage: window.WindowStage) {
this.context.startAbilityByCall({ this.context.startAbilityByCall({
bundleName: 'com.example.myservice', bundleName: 'com.example.myservice',
abilityName: 'MainUIAbility', abilityName: 'MainUIAbility',
...@@ -735,7 +798,7 @@ on(type: 'release', callback: OnReleaseCallback): void; ...@@ -735,7 +798,7 @@ on(type: 'release', callback: OnReleaseCallback): void;
} catch (error) { } catch (error) {
console.log('Caller.on catch error, error.code: ${error.code}, error.message: ${error.message}'); console.log('Caller.on catch error, error.code: ${error.code}, error.message: ${error.message}');
} }
}).catch((err) => { }).catch((err: BusinessError) => {
console.log('Caller GetCaller error, error.code: ${err.code}, error.message: ${err.message}'); console.log('Caller GetCaller error, error.code: ${err.code}, error.message: ${err.message}');
}); });
} }
...@@ -766,9 +829,14 @@ off(type: 'release', callback: OnReleaseCallback): void; ...@@ -766,9 +829,14 @@ off(type: 'release', callback: OnReleaseCallback): void;
**示例:** **示例:**
```ts ```ts
let caller; import UIAbility, { OnReleaseCallback } from '@ohos.app.ability.UIAbility';
import { Caller } from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
import window from '@ohos.window';
let caller: Caller;
export default class MainUIAbility extends UIAbility { export default class MainUIAbility extends UIAbility {
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage: window.WindowStage) {
this.context.startAbilityByCall({ this.context.startAbilityByCall({
bundleName: 'com.example.myservice', bundleName: 'com.example.myservice',
abilityName: 'MainUIAbility', abilityName: 'MainUIAbility',
...@@ -776,7 +844,7 @@ off(type: 'release', callback: OnReleaseCallback): void; ...@@ -776,7 +844,7 @@ off(type: 'release', callback: OnReleaseCallback): void;
}).then((obj) => { }).then((obj) => {
caller = obj; caller = obj;
try { try {
let onReleaseCallBack = (str) => { let onReleaseCallBack: OnReleaseCallback = (str) => {
console.log(' Caller OnRelease CallBack is called ${str}'); console.log(' Caller OnRelease CallBack is called ${str}');
}; };
caller.on('release', onReleaseCallBack); caller.on('release', onReleaseCallBack);
...@@ -784,7 +852,7 @@ off(type: 'release', callback: OnReleaseCallback): void; ...@@ -784,7 +852,7 @@ off(type: 'release', callback: OnReleaseCallback): void;
} catch (error) { } catch (error) {
console.log('Caller.on or Caller.off catch error, error.code: ${error.code}, error.message: ${error.message}'); console.log('Caller.on or Caller.off catch error, error.code: ${error.code}, error.message: ${error.message}');
} }
}).catch((err) => { }).catch((err: BusinessError) => {
console.log('Caller GetCaller error, error.code: ${err.code}, error.message: ${err.message}'); console.log('Caller GetCaller error, error.code: ${err.code}, error.message: ${err.message}');
}); });
} }
...@@ -808,9 +876,14 @@ off(type: 'release'): void; ...@@ -808,9 +876,14 @@ off(type: 'release'): void;
**示例:** **示例:**
```ts ```ts
let caller; import UIAbility, { OnReleaseCallback } from '@ohos.app.ability.UIAbility';
import { Caller } from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
import window from '@ohos.window';
let caller: Caller;
export default class MainUIAbility extends UIAbility { export default class MainUIAbility extends UIAbility {
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage: window.WindowStage) {
this.context.startAbilityByCall({ this.context.startAbilityByCall({
bundleName: 'com.example.myservice', bundleName: 'com.example.myservice',
abilityName: 'MainUIAbility', abilityName: 'MainUIAbility',
...@@ -818,7 +891,7 @@ off(type: 'release'): void; ...@@ -818,7 +891,7 @@ off(type: 'release'): void;
}).then((obj) => { }).then((obj) => {
caller = obj; caller = obj;
try { try {
let onReleaseCallBack = (str) => { let onReleaseCallBack: OnReleaseCallback = (str) => {
console.log(' Caller OnRelease CallBack is called ${str}'); console.log(' Caller OnRelease CallBack is called ${str}');
}; };
caller.on('release', onReleaseCallBack); caller.on('release', onReleaseCallBack);
...@@ -826,7 +899,7 @@ off(type: 'release'): void; ...@@ -826,7 +899,7 @@ off(type: 'release'): void;
} catch (error) { } catch (error) {
console.error('Caller.on or Caller.off catch error, error.code: ${error.code}, error.message: ${error.message}'); console.error('Caller.on or Caller.off catch error, error.code: ${error.code}, error.message: ${error.message}');
} }
}).catch((err) => { }).catch((err: BusinessError) => {
console.error('Caller GetCaller error, error.code: ${err.code}, error.message: ${err.message}'); console.error('Caller GetCaller error, error.code: ${err.code}, error.message: ${err.message}');
}); });
} }
...@@ -864,21 +937,26 @@ on(method: string, callback: CalleeCallback): void; ...@@ -864,21 +937,26 @@ on(method: string, callback: CalleeCallback): void;
**示例:** **示例:**
```ts ```ts
class MyMessageAble{ import UIAbility, { CalleeCallback } from '@ohos.app.ability.UIAbility';
name:'' import AbilityConstant from '@ohos.app.ability.AbilityConstant';
str:'' import Want from '@ohos.app.ability.Want';
num: 1 import rpc from '@ohos.rpc';
constructor(name, str) {
class MyMessageAble implements rpc.Parcelable {
name: string
str: string
num: number = 1
constructor(name: string, str: string) {
this.name = name; this.name = name;
this.str = str; this.str = str;
} }
marshalling(messageSequence) { marshalling(messageSequence: rpc.MessageSequence) {
messageSequence.writeInt(this.num); messageSequence.writeInt(this.num);
messageSequence.writeString(this.str); messageSequence.writeString(this.str);
console.log('MyMessageAble marshalling num[${this.num}] str[${this.str}]'); console.log('MyMessageAble marshalling num[${this.num}] str[${this.str}]');
return true; return true;
} }
unmarshalling(messageSequence) { unmarshalling(messageSequence: rpc.MessageSequence) {
this.num = messageSequence.readInt(); this.num = messageSequence.readInt();
this.str = messageSequence.readString(); this.str = messageSequence.readString();
console.log('MyMessageAble unmarshalling num[${this.num}] str[${this.str}]'); console.log('MyMessageAble unmarshalling num[${this.num}] str[${this.str}]');
...@@ -886,14 +964,14 @@ on(method: string, callback: CalleeCallback): void; ...@@ -886,14 +964,14 @@ on(method: string, callback: CalleeCallback): void;
} }
}; };
let method = 'call_Function'; let method = 'call_Function';
function funcCallBack(pdata) { function funcCallBack(pdata: rpc.MessageSequence) {
console.log('Callee funcCallBack is called ${pdata}'); console.log('Callee funcCallBack is called ${pdata}');
let msg = new MyMessageAble('test', ''); let msg = new MyMessageAble('test', '');
pdata.readParcelable(msg); pdata.readParcelable(msg);
return new MyMessageAble('test1', 'Callee test'); return new MyMessageAble('test1', 'Callee test');
} }
export default class MainUIAbility extends UIAbility { export default class MainUIAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
console.log('Callee onCreate is called'); console.log('Callee onCreate is called');
try { try {
this.callee.on(method, funcCallBack); this.callee.on(method, funcCallBack);
...@@ -931,9 +1009,13 @@ off(method: string): void; ...@@ -931,9 +1009,13 @@ off(method: string): void;
**示例:** **示例:**
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import Want from '@ohos.app.ability.Want';
let method = 'call_Function'; let method = 'call_Function';
export default class MainUIAbility extends UIAbility { export default class MainUIAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
console.log('Callee onCreate is called'); console.log('Callee onCreate is called');
try { try {
this.callee.off(method); this.callee.off(method);
......
...@@ -35,12 +35,14 @@ import Want from '@ohos.app.ability.Want'; ...@@ -35,12 +35,14 @@ import Want from '@ohos.app.ability.Want';
```ts ```ts
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let want = { let want: Want = {
'deviceId': '', // deviceId为空表示本设备 deviceId: '', // deviceId为空表示本设备
'bundleName': 'com.example.myapplication', bundleName: 'com.example.myapplication',
'abilityName': 'FuncAbility', abilityName: 'FuncAbility',
'moduleName': 'entry' // moduleName非必选 moduleName: 'entry' // moduleName非必选
}; };
context.startAbility(want, (err) => { context.startAbility(want, (err) => {
...@@ -54,8 +56,10 @@ import Want from '@ohos.app.ability.Want'; ...@@ -54,8 +56,10 @@ import Want from '@ohos.app.ability.Want';
* 字符串(String) * 字符串(String)
```ts ```ts
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let want = { let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility', abilityName: 'FuncAbility',
parameters: { parameters: {
...@@ -70,8 +74,10 @@ import Want from '@ohos.app.ability.Want'; ...@@ -70,8 +74,10 @@ import Want from '@ohos.app.ability.Want';
* 数字(Number) * 数字(Number)
```ts ```ts
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let want = { let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility', abilityName: 'FuncAbility',
parameters: { parameters: {
...@@ -87,8 +93,10 @@ import Want from '@ohos.app.ability.Want'; ...@@ -87,8 +93,10 @@ import Want from '@ohos.app.ability.Want';
* 布尔(Boolean) * 布尔(Boolean)
```ts ```ts
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let want = { let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility', abilityName: 'FuncAbility',
parameters: { parameters: {
...@@ -103,8 +111,10 @@ import Want from '@ohos.app.ability.Want'; ...@@ -103,8 +111,10 @@ import Want from '@ohos.app.ability.Want';
* 对象(Object) * 对象(Object)
```ts ```ts
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let want = { let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility', abilityName: 'FuncAbility',
parameters: { parameters: {
...@@ -124,8 +134,10 @@ import Want from '@ohos.app.ability.Want'; ...@@ -124,8 +134,10 @@ import Want from '@ohos.app.ability.Want';
* 数组(Array) * 数组(Array)
```ts ```ts
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let want = { let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility', abilityName: 'FuncAbility',
parameters: { parameters: {
...@@ -142,23 +154,27 @@ import Want from '@ohos.app.ability.Want'; ...@@ -142,23 +154,27 @@ import Want from '@ohos.app.ability.Want';
``` ```
* 文件描述符(FD) * 文件描述符(FD)
```ts ```ts
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let fd; let fd: number = 0;
try { try {
fd = fs.openSync('/data/storage/el2/base/haps/pic.png').fd; fd = fs.openSync('/data/storage/el2/base/haps/pic.png').fd;
} catch(err) { } catch(err) {
console.error(`Failed to openSync. Code: ${err.code}, message: ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`Failed to openSync. Code: ${code}, message: ${message}`);
} }
let want = { let want: 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
} }
}; };
...@@ -172,8 +188,10 @@ import Want from '@ohos.app.ability.Want'; ...@@ -172,8 +188,10 @@ import Want from '@ohos.app.ability.Want';
```ts ```ts
// (1) UIAbility1启动一个ServiceExtension // (1) UIAbility1启动一个ServiceExtension
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let want = { let want: Want = {
bundleName: 'com.example.myapplication1', bundleName: 'com.example.myapplication1',
abilityName: 'ServiceExtensionAbility', abilityName: 'ServiceExtensionAbility',
}; };
...@@ -184,8 +202,11 @@ import Want from '@ohos.app.ability.Want'; ...@@ -184,8 +202,11 @@ import Want from '@ohos.app.ability.Want';
```ts ```ts
// (2) 该ServiceExtension去启动另一个UIAbility2,并在启动的时候携带参数ability.params.backToOtherMissionStack为true // (2) 该ServiceExtension去启动另一个UIAbility2,并在启动的时候携带参数ability.params.backToOtherMissionStack为true
let context ; // ServiceExtensionContext import common from '@ohos.app.ability.common';
let want = { import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.ServiceExtensionContext; // ServiceExtensionContext
let want: Want = {
bundleName: 'com.example.myapplication2', bundleName: 'com.example.myapplication2',
abilityName: 'MainAbility', abilityName: 'MainAbility',
parameters: { parameters: {
......
...@@ -39,10 +39,14 @@ getWantAgent(info: WantAgentInfo, callback: AsyncCallback\<WantAgent\>): void ...@@ -39,10 +39,14 @@ getWantAgent(info: WantAgentInfo, callback: AsyncCallback\<WantAgent\>): void
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -62,7 +66,7 @@ let wantAgentInfo = { ...@@ -62,7 +66,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -70,7 +74,7 @@ let wantAgentInfo = { ...@@ -70,7 +74,7 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
...@@ -118,9 +122,13 @@ getWantAgent(info: WantAgentInfo): Promise\<WantAgent\> ...@@ -118,9 +122,13 @@ getWantAgent(info: WantAgentInfo): Promise\<WantAgent\>
**示例:** **示例:**
```ts ```ts
let wantAgent; import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -140,7 +148,7 @@ let wantAgentInfo = { ...@@ -140,7 +148,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -150,7 +158,7 @@ let wantAgentInfo = { ...@@ -150,7 +158,7 @@ let wantAgentInfo = {
try { try {
WantAgent.getWantAgent(wantAgentInfo).then((data) => { WantAgent.getWantAgent(wantAgentInfo).then((data) => {
wantAgent = data; wantAgent = data;
}).catch((err) => { }).catch((err: BusinessError) => {
console.error('getWantAgent failed! ${err.code} ${err.message}'); console.error('getWantAgent failed! ${err.code} ${err.message}');
}); });
} catch (err) { } catch (err) {
...@@ -187,10 +195,14 @@ getBundleName(agent: WantAgent, callback: AsyncCallback\<string\>): void ...@@ -187,10 +195,14 @@ getBundleName(agent: WantAgent, callback: AsyncCallback\<string\>): void
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -210,7 +222,7 @@ let wantAgentInfo = { ...@@ -210,7 +222,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -218,14 +230,14 @@ let wantAgentInfo = { ...@@ -218,14 +230,14 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
console.error('getWantAgent failed ${JSON.stringify(wantAgent)}'); console.error('getWantAgent failed ${JSON.stringify(wantAgent)}');
} }
//getBundleName回调 //getBundleName回调
function getBundleNameCallback(err, data) { let getBundleNameCallback = (err: BusinessError, data: string) => {
if(err) { if(err) {
console.error('getBundleName failed! ${err.code} ${err.message}'); console.error('getBundleName failed! ${err.code} ${err.message}');
} else { } else {
...@@ -279,10 +291,14 @@ getBundleName(agent: WantAgent): Promise\<string\> ...@@ -279,10 +291,14 @@ getBundleName(agent: WantAgent): Promise\<string\>
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -302,7 +318,7 @@ let wantAgentInfo = { ...@@ -302,7 +318,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -310,7 +326,7 @@ let wantAgentInfo = { ...@@ -310,7 +326,7 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
...@@ -319,7 +335,7 @@ function getWantAgentCallback(err, data) { ...@@ -319,7 +335,7 @@ function getWantAgentCallback(err, data) {
try { try {
WantAgent.getBundleName(wantAgent).then((data)=>{ WantAgent.getBundleName(wantAgent).then((data)=>{
console.info('getBundleName ok! ${JSON.stringify(data)}'); console.info('getBundleName ok! ${JSON.stringify(data)}');
}).catch((err)=>{ }).catch((err: BusinessError)=>{
console.error('getBundleName failed! ${err.code} ${err.message}'); console.error('getBundleName failed! ${err.code} ${err.message}');
}); });
} catch(err){ } catch(err){
...@@ -362,11 +378,14 @@ getUid(agent: WantAgent, callback: AsyncCallback\<number\>): void ...@@ -362,11 +378,14 @@ getUid(agent: WantAgent, callback: AsyncCallback\<number\>): void
**示例:** **示例:**
```ts ```ts
import WantAgent from '@ohos.app.ability.wantAgent'; import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -386,7 +405,7 @@ let wantAgentInfo = { ...@@ -386,7 +405,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -394,14 +413,14 @@ let wantAgentInfo = { ...@@ -394,14 +413,14 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
console.info('getWantAgent failed ${JSON.stringify(err)}'); console.info('getWantAgent failed ${JSON.stringify(err)}');
} }
//getUid回调 //getUid回调
function getUidCallback(err, data) { let getUidCallback = (err: BusinessError, data: number) => {
if(err) { if(err) {
console.error('getUid failed! ${err.code} ${err.message}'); console.error('getUid failed! ${err.code} ${err.message}');
} else { } else {
...@@ -455,10 +474,14 @@ getUid(agent: WantAgent): Promise\<number\> ...@@ -455,10 +474,14 @@ getUid(agent: WantAgent): Promise\<number\>
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -478,7 +501,7 @@ let wantAgentInfo = { ...@@ -478,7 +501,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -486,7 +509,7 @@ let wantAgentInfo = { ...@@ -486,7 +509,7 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
...@@ -495,7 +518,7 @@ function getWantAgentCallback(err, data) { ...@@ -495,7 +518,7 @@ function getWantAgentCallback(err, data) {
try { try {
WantAgent.getUid(wantAgent).then((data)=>{ WantAgent.getUid(wantAgent).then((data)=>{
console.info('getUid ok! ${JSON.stringify(data)}'); console.info('getUid ok! ${JSON.stringify(data)}');
}).catch((err)=>{ }).catch((err: BusinessError)=>{
console.error('getUid failed! ${err.code} ${err.message}'); console.error('getUid failed! ${err.code} ${err.message}');
}); });
} catch(err){ } catch(err){
...@@ -540,10 +563,14 @@ getWant(agent: WantAgent, callback: AsyncCallback\<Want\>): void ...@@ -540,10 +563,14 @@ getWant(agent: WantAgent, callback: AsyncCallback\<Want\>): void
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -563,7 +590,7 @@ let wantAgentInfo = { ...@@ -563,7 +590,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -571,14 +598,14 @@ let wantAgentInfo = { ...@@ -571,14 +598,14 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
console.error('getWantAgent failed ${JSON.stringify(wantAgent)}'); console.error('getWantAgent failed ${JSON.stringify(wantAgent)}');
} }
//getWant回调 //getWant回调
function getWantCallback(err, data) { let getWantCallback = (err: BusinessError, data: Want) => {
if(err) { if(err) {
console.error('getWant failed! ${err.code} ${err.message}'); console.error('getWant failed! ${err.code} ${err.message}');
} else { } else {
...@@ -635,10 +662,14 @@ getWant(agent: WantAgent): Promise\<Want\> ...@@ -635,10 +662,14 @@ getWant(agent: WantAgent): Promise\<Want\>
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -658,7 +689,7 @@ let wantAgentInfo = { ...@@ -658,7 +689,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -666,7 +697,7 @@ let wantAgentInfo = { ...@@ -666,7 +697,7 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
...@@ -675,7 +706,7 @@ function getWantAgentCallback(err, data) { ...@@ -675,7 +706,7 @@ function getWantAgentCallback(err, data) {
try { try {
WantAgent.getUid(wantAgent).then((data)=>{ WantAgent.getUid(wantAgent).then((data)=>{
console.info('getUid ok! ${JSON.stringify(data)}'); console.info('getUid ok! ${JSON.stringify(data)}');
}).catch((err)=>{ }).catch((err: BusinessError)=>{
console.error('getUid failed! ${err.code} ${err.message}'); console.error('getUid failed! ${err.code} ${err.message}');
}); });
} catch(err){ } catch(err){
...@@ -718,10 +749,14 @@ cancel(agent: WantAgent, callback: AsyncCallback\<void\>): void ...@@ -718,10 +749,14 @@ cancel(agent: WantAgent, callback: AsyncCallback\<void\>): void
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -741,7 +776,7 @@ let wantAgentInfo = { ...@@ -741,7 +776,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -749,14 +784,14 @@ let wantAgentInfo = { ...@@ -749,14 +784,14 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
console.error('getWantAgent failed ${JSON.stringify(wantAgent)}'); console.error('getWantAgent failed ${JSON.stringify(wantAgent)}');
} }
//cancel回调 //cancel回调
function cancelCallback(err, data) { let cancelCallback = (err: BusinessError, data: void) => {
if(err) { if(err) {
console.error('cancel failed! ${err.code} ${err.message}'); console.error('cancel failed! ${err.code} ${err.message}');
} else { } else {
...@@ -810,10 +845,14 @@ cancel(agent: WantAgent): Promise\<void\> ...@@ -810,10 +845,14 @@ cancel(agent: WantAgent): Promise\<void\>
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -833,7 +872,7 @@ let wantAgentInfo = { ...@@ -833,7 +872,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -841,7 +880,7 @@ let wantAgentInfo = { ...@@ -841,7 +880,7 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
...@@ -850,7 +889,7 @@ function getWantAgentCallback(err, data) { ...@@ -850,7 +889,7 @@ function getWantAgentCallback(err, data) {
try { try {
WantAgent.cancel(wantAgent).then((data)=>{ WantAgent.cancel(wantAgent).then((data)=>{
console.info('cancel ok!'); console.info('cancel ok!');
}).catch((err)=>{ }).catch((err: BusinessError)=>{
console.error('cancel failed! ${err.code} ${err.message}'); console.error('cancel failed! ${err.code} ${err.message}');
}); });
} catch(err){ } catch(err){
...@@ -883,14 +922,18 @@ trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: AsyncCallback\<Co ...@@ -883,14 +922,18 @@ trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: AsyncCallback\<Co
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
// triggerInfo // triggerInfo
let triggerInfo = { let triggerInfo: WantAgent.TriggerInfo = {
code: 0 //自定义义结果码 code: 0 //自定义义结果码
}; };
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -910,7 +953,7 @@ let wantAgentInfo = { ...@@ -910,7 +953,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -918,14 +961,14 @@ let wantAgentInfo = { ...@@ -918,14 +961,14 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
console.error('getWantAgent failed ${JSON.stringify(wantAgent)}'); console.error('getWantAgent failed ${JSON.stringify(wantAgent)}');
} }
//trigger回调 //trigger回调
function triggerCallback(err, data) { let triggerCallback = (err: BusinessError, data: WantAgent.CompleteData) => {
if(err) { if(err) {
console.error('getUid failed! ${err.code} ${err.message}'); console.error('getUid failed! ${err.code} ${err.message}');
} else { } else {
...@@ -966,11 +1009,15 @@ equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback\<boolean\ ...@@ -966,11 +1009,15 @@ equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback\<boolean\
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent1; let wantAgent1: _WantAgent;
let wantAgent2; let wantAgent2: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -990,7 +1037,7 @@ let wantAgentInfo = { ...@@ -990,7 +1037,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -998,7 +1045,7 @@ let wantAgentInfo = { ...@@ -998,7 +1045,7 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent1 = data; wantAgent1 = data;
wantAgent2 = data; wantAgent2 = data;
...@@ -1006,7 +1053,7 @@ function getWantAgentCallback(err, data) { ...@@ -1006,7 +1053,7 @@ function getWantAgentCallback(err, data) {
console.error('getWantAgent failed ${JSON.stringify(wantAgent)}'); console.error('getWantAgent failed ${JSON.stringify(wantAgent)}');
} }
//equal回调 //equal回调
function equalCallback(err, data) { let equalCallback = (err: BusinessError, data: boolean) => {
if(err) { if(err) {
console.error('equal failed! ${err.code} ${err.message}'); console.error('equal failed! ${err.code} ${err.message}');
} else { } else {
...@@ -1052,11 +1099,15 @@ equal(agent: WantAgent, otherAgent: WantAgent): Promise\<boolean\> ...@@ -1052,11 +1099,15 @@ equal(agent: WantAgent, otherAgent: WantAgent): Promise\<boolean\>
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent1; let wantAgent1: _WantAgent;
let wantAgent2; let wantAgent2: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -1076,7 +1127,7 @@ let wantAgentInfo = { ...@@ -1076,7 +1127,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -1084,7 +1135,7 @@ let wantAgentInfo = { ...@@ -1084,7 +1135,7 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent1 = data; wantAgent1 = data;
wantAgent2 = data; wantAgent2 = data;
...@@ -1094,7 +1145,7 @@ function getWantAgentCallback(err, data) { ...@@ -1094,7 +1145,7 @@ function getWantAgentCallback(err, data) {
try { try {
WantAgent.equal(wantAgent1,wantAgent2).then((data)=>{ WantAgent.equal(wantAgent1,wantAgent2).then((data)=>{
console.info('equal ok! ${JSON.stringify(data)}'); console.info('equal ok! ${JSON.stringify(data)}');
}).catch((err)=>{ }).catch((err: BusinessError)=>{
console.error('equal failed! ${err.code} ${err.message}'); console.error('equal failed! ${err.code} ${err.message}');
}) })
} catch(err){ } catch(err){
...@@ -1136,10 +1187,14 @@ getOperationType(agent: WantAgent, callback: AsyncCallback\<number>): void; ...@@ -1136,10 +1187,14 @@ getOperationType(agent: WantAgent, callback: AsyncCallback\<number>): void;
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -1159,7 +1214,7 @@ let wantAgentInfo = { ...@@ -1159,7 +1214,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -1167,14 +1222,14 @@ let wantAgentInfo = { ...@@ -1167,14 +1222,14 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
console.error('getWantAgent failed ${JSON.stringify(wantAgent)}'); console.error('getWantAgent failed ${JSON.stringify(wantAgent)}');
} }
//getOperationTypeCallback回调 //getOperationTypeCallback回调
function getOperationTypeCallback(err, data) { let getOperationTypeCallback = (err: BusinessError, data: number) => {
if(err) { if(err) {
console.error('getOperationType failed! ${err.code} ${err.message}'); console.error('getOperationType failed! ${err.code} ${err.message}');
} else { } else {
...@@ -1227,10 +1282,14 @@ getOperationType(agent: WantAgent): Promise\<number>; ...@@ -1227,10 +1282,14 @@ getOperationType(agent: WantAgent): Promise\<number>;
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -1250,7 +1309,7 @@ let wantAgentInfo = { ...@@ -1250,7 +1309,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -1258,7 +1317,7 @@ let wantAgentInfo = { ...@@ -1258,7 +1317,7 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
...@@ -1267,7 +1326,7 @@ function getWantAgentCallback(err, data) { ...@@ -1267,7 +1326,7 @@ function getWantAgentCallback(err, data) {
try { try {
WantAgent.getOperationType(wantAgent).then((data)=>{ WantAgent.getOperationType(wantAgent).then((data)=>{
console.info('getOperationType ok! ${JSON.stringify(data)}'); console.info('getOperationType ok! ${JSON.stringify(data)}');
}).catch((err)=>{ }).catch((err: BusinessError) => {
console.error('getOperationType failed! ${err.code} ${err.message}'); console.error('getOperationType failed! ${err.code} ${err.message}');
}); });
} catch(err){ } catch(err){
......
...@@ -21,9 +21,10 @@ import StaticSubscriberExtensionContext from '@ohos.application.StaticSubscriber ...@@ -21,9 +21,10 @@ import StaticSubscriberExtensionContext from '@ohos.application.StaticSubscriber
```ts ```ts
import StaticSubscriberExtensionAbility from '@ohos.application.StaticSubscriberExtensionAbility' import StaticSubscriberExtensionAbility from '@ohos.application.StaticSubscriberExtensionAbility'
import StaticSubscriberExtensionContext from '@ohos.application.StaticSubscriberExtensionContext'
export default class MyStaticSubscriberExtensionAbility extends StaticSubscriberExtensionAbility { export default class MyStaticSubscriberExtensionAbility extends StaticSubscriberExtensionAbility {
context = this.context; context: StaticSubscriberExtensionContext = this.context;
}; };
``` ```
...@@ -73,13 +74,16 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void; ...@@ -73,13 +74,16 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: "com.example.myapp", bundleName: "com.example.myapp",
abilityName: "MyAbility" abilityName: "MyAbility"
}; };
try { try {
this.context.startAbility(want, (error) => { this.context.startAbility(want, (error: BusinessError) => {
if (error) { if (error) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('startAbility failed, error.code: ' + JSON.stringify(error.code) + console.log('startAbility failed, error.code: ' + JSON.stringify(error.code) +
...@@ -91,8 +95,10 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void; ...@@ -91,8 +95,10 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
}); });
} catch (paramError) { } catch (paramError) {
// 处理入参错误异常 // 处理入参错误异常
console.log('startAbility failed, error.code: ' + JSON.stringify(paramError.code) + let code = (paramError as BusinessError).code;
' error.message: ' + JSON.stringify(paramError.message)); let message = (paramError as BusinessError).message;
console.log('startAbility failed, error.code: ' + JSON.stringify(code) +
' error.message: ' + JSON.stringify(message));
} }
``` ```
...@@ -147,7 +153,10 @@ startAbility(want: Want): Promise&lt;void&gt;; ...@@ -147,7 +153,10 @@ startAbility(want: Want): Promise&lt;void&gt;;
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: "com.example.myapp", bundleName: "com.example.myapp",
abilityName: "MyAbility" abilityName: "MyAbility"
}; };
...@@ -158,14 +167,16 @@ startAbility(want: Want): Promise&lt;void&gt;; ...@@ -158,14 +167,16 @@ startAbility(want: Want): Promise&lt;void&gt;;
// 执行正常业务 // 执行正常业务
console.log('startAbility succeed'); console.log('startAbility succeed');
}) })
.catch((error) => { .catch((error: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('startAbility failed, error.code: ' + JSON.stringify(error.code) + console.log('startAbility failed, error.code: ' + JSON.stringify(error.code) +
' error.message: ' + JSON.stringify(error.message)); ' error.message: ' + JSON.stringify(error.message));
}); });
} catch (paramError) { } catch (paramError) {
// 处理入参错误异常 // 处理入参错误异常
console.log('startAbility failed, error.code: ' + JSON.stringify(paramError.code) + let code = (paramError as BusinessError).code;
' error.message: ' + JSON.stringify(paramError.message)); let message = (paramError as BusinessError).message;
console.log('startAbility failed, error.code: ' + JSON.stringify(code) +
' error.message: ' + JSON.stringify(message));
} }
``` ```
\ No newline at end of file
...@@ -43,9 +43,9 @@ getAbilityDelegator(): AbilityDelegator ...@@ -43,9 +43,9 @@ getAbilityDelegator(): AbilityDelegator
**示例:** **示例:**
```ts ```ts
let abilityDelegator; import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry';
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
``` ```
## AbilityDelegatorRegistry.getArguments ## AbilityDelegatorRegistry.getArguments
...@@ -65,6 +65,8 @@ getArguments(): AbilityDelegatorArgs ...@@ -65,6 +65,8 @@ getArguments(): AbilityDelegatorArgs
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry';
let args = AbilityDelegatorRegistry.getArguments(); let args = AbilityDelegatorRegistry.getArguments();
console.info('getArguments bundleName: ${args.bundleName}'); console.info('getArguments bundleName: ${args.bundleName}');
console.info('getArguments testCaseNames: ${args.testCaseNames}'); console.info('getArguments testCaseNames: ${args.testCaseNames}');
......
...@@ -49,7 +49,10 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void ...@@ -49,7 +49,10 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void
**示例** **示例**
```ts ```ts
let config = { import abilityManager from '@ohos.application.abilityManager';
import { Configuration } from '@ohos.application.Configuration';
let config: Configuration = {
language: 'chinese' language: 'chinese'
}; };
...@@ -83,13 +86,17 @@ updateConfiguration(config: Configuration): Promise\<void> ...@@ -83,13 +86,17 @@ updateConfiguration(config: Configuration): Promise\<void>
**示例** **示例**
```ts ```ts
let config = { import abilityManager from '@ohos.application.abilityManager';
import { Configuration } from '@ohos.application.Configuration';
import { BusinessError } from '@ohos.base';
let config: Configuration = {
language: 'chinese' language: 'chinese'
}; };
abilityManager.updateConfiguration(config).then(() => { abilityManager.updateConfiguration(config).then(() => {
console.log('updateConfiguration success'); console.log('updateConfiguration success');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error('updateConfiguration fail'); console.error('updateConfiguration fail');
}); });
``` ```
...@@ -113,6 +120,8 @@ getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): vo ...@@ -113,6 +120,8 @@ getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): vo
**示例** **示例**
```ts ```ts
import abilityManager from '@ohos.application.abilityManager';
abilityManager.getAbilityRunningInfos((err,data) => { abilityManager.getAbilityRunningInfos((err,data) => {
console.log('getAbilityRunningInfos err: ${err}, data: ${JSON.stringify(data)}'); console.log('getAbilityRunningInfos err: ${err}, data: ${JSON.stringify(data)}');
}); });
...@@ -137,9 +146,12 @@ getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>> ...@@ -137,9 +146,12 @@ getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>>
**示例** **示例**
```ts ```ts
import abilityManager from '@ohos.application.abilityManager';
import { BusinessError } from '@ohos.base';
abilityManager.getAbilityRunningInfos().then((data) => { abilityManager.getAbilityRunningInfos().then((data) => {
console.log('getAbilityRunningInfos data: ${JSON.stringify(data)}'); console.log('getAbilityRunningInfos data: ${JSON.stringify(data)}');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error('getAbilityRunningInfos err: ${JSON.stringify(err)}'); console.error('getAbilityRunningInfos err: ${JSON.stringify(err)}');
}); });
``` ```
\ No newline at end of file
...@@ -29,6 +29,8 @@ static isRunningInStabilityTest(callback: AsyncCallback&lt;boolean&gt;): void ...@@ -29,6 +29,8 @@ static isRunningInStabilityTest(callback: AsyncCallback&lt;boolean&gt;): void
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
appManager.isRunningInStabilityTest((error, flag) => { appManager.isRunningInStabilityTest((error, flag) => {
if (error && error.code !== 0) { if (error && error.code !== 0) {
console.error('isRunningInStabilityTest fail, error: ${JSON.stringify(error)}'); console.error('isRunningInStabilityTest fail, error: ${JSON.stringify(error)}');
...@@ -56,9 +58,12 @@ static isRunningInStabilityTest(): Promise&lt;boolean&gt; ...@@ -56,9 +58,12 @@ static isRunningInStabilityTest(): Promise&lt;boolean&gt;
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
appManager.isRunningInStabilityTest().then((flag) => { appManager.isRunningInStabilityTest().then((flag) => {
console.log('The result of isRunningInStabilityTest is: ${JSON.stringify(flag)}'); console.log('The result of isRunningInStabilityTest is: ${JSON.stringify(flag)}');
}).catch((error) => { }).catch((error: BusinessError) => {
console.error('error: ${JSON.stringify(error)}'); console.error('error: ${JSON.stringify(error)}');
}); });
``` ```
...@@ -81,9 +86,12 @@ isRamConstrainedDevice(): Promise\<boolean>; ...@@ -81,9 +86,12 @@ isRamConstrainedDevice(): Promise\<boolean>;
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
appManager.isRamConstrainedDevice().then((data) => { appManager.isRamConstrainedDevice().then((data) => {
console.log('The result of isRamConstrainedDevice is: ${JSON.stringify(data)}'); console.log('The result of isRamConstrainedDevice is: ${JSON.stringify(data)}');
}).catch((error) => { }).catch((error: BusinessError) => {
console.error('error: ${JSON.stringify(error)}'); console.error('error: ${JSON.stringify(error)}');
}); });
``` ```
...@@ -105,6 +113,8 @@ isRamConstrainedDevice(callback: AsyncCallback\<boolean>): void; ...@@ -105,6 +113,8 @@ isRamConstrainedDevice(callback: AsyncCallback\<boolean>): void;
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
appManager.isRamConstrainedDevice((error, data) => { appManager.isRamConstrainedDevice((error, data) => {
if (error && error.code !== 0) { if (error && error.code !== 0) {
console.error('isRamConstrainedDevice fail, error: ${JSON.stringify(error)}'); console.error('isRamConstrainedDevice fail, error: ${JSON.stringify(error)}');
...@@ -131,9 +141,12 @@ getAppMemorySize(): Promise\<number>; ...@@ -131,9 +141,12 @@ getAppMemorySize(): Promise\<number>;
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
appManager.getAppMemorySize().then((data) => { appManager.getAppMemorySize().then((data) => {
console.log('The size of app memory is: ${JSON.stringify(data)}'); console.log('The size of app memory is: ${JSON.stringify(data)}');
}).catch((error) => { }).catch((error: BusinessError) => {
console.error('error: ${JSON.stringify(error)}'); console.error('error: ${JSON.stringify(error)}');
}); });
``` ```
...@@ -155,6 +168,8 @@ getAppMemorySize(callback: AsyncCallback\<number>): void; ...@@ -155,6 +168,8 @@ getAppMemorySize(callback: AsyncCallback\<number>): void;
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
appManager.getAppMemorySize((error, data) => { appManager.getAppMemorySize((error, data) => {
if (error && error.code !== 0) { if (error && error.code !== 0) {
console.error('getAppMemorySize fail, error: ${JSON.stringify(error)}'); console.error('getAppMemorySize fail, error: ${JSON.stringify(error)}');
...@@ -184,9 +199,12 @@ getProcessRunningInfos(): Promise\<Array\<ProcessRunningInfo>>; ...@@ -184,9 +199,12 @@ getProcessRunningInfos(): Promise\<Array\<ProcessRunningInfo>>;
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
appManager.getProcessRunningInfos().then((data) => { appManager.getProcessRunningInfos().then((data) => {
console.log('The process running infos is: ${JSON.stringify(data)}'); console.log('The process running infos is: ${JSON.stringify(data)}');
}).catch((error) => { }).catch((error: BusinessError) => {
console.error('error: ${JSON.stringify(error)}'); console.error('error: ${JSON.stringify(error)}');
}); });
``` ```
...@@ -212,6 +230,8 @@ getProcessRunningInfos(callback: AsyncCallback\<Array\<ProcessRunningInfo>>): vo ...@@ -212,6 +230,8 @@ getProcessRunningInfos(callback: AsyncCallback\<Array\<ProcessRunningInfo>>): vo
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
appManager.getProcessRunningInfos((error, data) => { appManager.getProcessRunningInfos((error, data) => {
if (error && error.code !== 0) { if (error && error.code !== 0) {
console.error('getProcessRunningInfos fail, error: ${JSON.stringify(error)}'); console.error('getProcessRunningInfos fail, error: ${JSON.stringify(error)}');
...@@ -242,7 +262,9 @@ registerApplicationStateObserver(observer: ApplicationStateObserver): number; ...@@ -242,7 +262,9 @@ registerApplicationStateObserver(observer: ApplicationStateObserver): number;
**示例:** **示例:**
```ts ```ts
let applicationStateObserver = { import appManager from '@ohos.application.appManager';
const observerCode = appManager.registerApplicationStateObserver({
onForegroundApplicationChanged(appStateData) { onForegroundApplicationChanged(appStateData) {
console.log('------------ onForegroundApplicationChanged -----------', appStateData); console.log('------------ onForegroundApplicationChanged -----------', appStateData);
}, },
...@@ -258,8 +280,7 @@ registerApplicationStateObserver(observer: ApplicationStateObserver): number; ...@@ -258,8 +280,7 @@ registerApplicationStateObserver(observer: ApplicationStateObserver): number;
onProcessStateChanged(processData) { onProcessStateChanged(processData) {
console.log('------------ onProcessStateChanged -----------', processData); console.log('------------ onProcessStateChanged -----------', processData);
} }
}; });
const observerCode = appManager.registerApplicationStateObserver(applicationStateObserver);
console.log('-------- observerCode: ---------', observerCode); console.log('-------- observerCode: ---------', observerCode);
``` ```
...@@ -285,9 +306,12 @@ unregisterApplicationStateObserver(observerId: number, callback: AsyncCallback\ ...@@ -285,9 +306,12 @@ unregisterApplicationStateObserver(observerId: number, callback: AsyncCallback\
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let observerId = 100; let observerId = 100;
function unregisterApplicationStateObserverCallback(err) { function unregisterApplicationStateObserverCallback(err: BusinessError) {
if (err) { if (err) {
console.error('------------ unregisterApplicationStateObserverCallback ------------', err); console.error('------------ unregisterApplicationStateObserverCallback ------------', err);
} }
...@@ -322,13 +346,16 @@ unregisterApplicationStateObserver(observerId: number): Promise\<void>; ...@@ -322,13 +346,16 @@ unregisterApplicationStateObserver(observerId: number): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let observerId = 100; let observerId = 100;
appManager.unregisterApplicationStateObserver(observerId) appManager.unregisterApplicationStateObserver(observerId)
.then((data) => { .then((data) => {
console.log('----------- unregisterApplicationStateObserver success ----------', data); console.log('----------- unregisterApplicationStateObserver success ----------', data);
}) })
.catch((err) => { .catch((err: BusinessError) => {
console.error('----------- unregisterApplicationStateObserver fail ----------', err); console.error('----------- unregisterApplicationStateObserver fail ----------', err);
}); });
``` ```
...@@ -354,14 +381,15 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void; ...@@ -354,14 +381,15 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void;
**示例:** **示例:**
```ts ```ts
function getForegroundApplicationsCallback(err, data) { import appManager from '@ohos.application.appManager';
appManager.getForegroundApplications((err, data) => {
if (err) { if (err) {
console.error('--------- getForegroundApplicationsCallback fail ---------', err); console.error('--------- getForegroundApplicationsCallback fail ---------', err);
} else { } else {
console.log('--------- getForegroundApplicationsCallback success ---------', data); console.log('--------- getForegroundApplicationsCallback success ---------', data);
} }
} });
appManager.getForegroundApplications(getForegroundApplicationsCallback);
``` ```
## appManager.getForegroundApplications<sup>8+</sup> ## appManager.getForegroundApplications<sup>8+</sup>
...@@ -385,11 +413,14 @@ getForegroundApplications(): Promise\<Array\<AppStateData>>; ...@@ -385,11 +413,14 @@ getForegroundApplications(): Promise\<Array\<AppStateData>>;
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
appManager.getForegroundApplications() appManager.getForegroundApplications()
.then((data) => { .then((data) => {
console.log('--------- getForegroundApplications success -------', data); console.log('--------- getForegroundApplications success -------', data);
}) })
.catch((err) => { .catch((err: BusinessError) => {
console.error('--------- getForegroundApplications fail -------', err); console.error('--------- getForegroundApplications fail -------', err);
}); });
``` ```
...@@ -420,13 +451,16 @@ killProcessWithAccount(bundleName: string, accountId: number): Promise\<void\> ...@@ -420,13 +451,16 @@ killProcessWithAccount(bundleName: string, accountId: number): Promise\<void\>
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName'; let bundleName = 'bundleName';
let accountId = 0; let accountId = 0;
appManager.killProcessWithAccount(bundleName, accountId) appManager.killProcessWithAccount(bundleName, accountId)
.then((data) => { .then((data) => {
console.log('------------ killProcessWithAccount success ------------', data); console.log('------------ killProcessWithAccount success ------------', data);
}) })
.catch((err) => { .catch((err: BusinessError) => {
console.error('------------ killProcessWithAccount fail ------------', err); console.error('------------ killProcessWithAccount fail ------------', err);
}); });
``` ```
...@@ -459,9 +493,12 @@ killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCal ...@@ -459,9 +493,12 @@ killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCal
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName'; let bundleName = 'bundleName';
let accountId = 0; let accountId = 0;
function killProcessWithAccountCallback(err, data) { function killProcessWithAccountCallback(err: BusinessError, data: void) {
if (err) { if (err) {
console.error('------------- killProcessWithAccountCallback fail, err: --------------', err); console.error('------------- killProcessWithAccountCallback fail, err: --------------', err);
} else { } else {
...@@ -493,8 +530,11 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>); ...@@ -493,8 +530,11 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>);
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName'; let bundleName = 'bundleName';
function killProcessesByBundleNameCallback(err, data) { function killProcessesByBundleNameCallback(err: BusinessError, data: void) {
if (err) { if (err) {
console.error('------------- killProcessesByBundleNameCallback fail, err: --------------', err); console.error('------------- killProcessesByBundleNameCallback fail, err: --------------', err);
} else { } else {
...@@ -531,12 +571,15 @@ killProcessesByBundleName(bundleName: string): Promise\<void>; ...@@ -531,12 +571,15 @@ killProcessesByBundleName(bundleName: string): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'com.example.myapplication'; let bundleName = 'com.example.myapplication';
appManager.killProcessesByBundleName(bundleName) appManager.killProcessesByBundleName(bundleName)
.then((data) => { .then((data) => {
console.log('------------ killProcessesByBundleName success ------------', data); console.log('------------ killProcessesByBundleName success ------------', data);
}) })
.catch((err) => { .catch((err: BusinessError) => {
console.error('------------ killProcessesByBundleName fail ------------', err); console.error('------------ killProcessesByBundleName fail ------------', err);
}); });
``` ```
...@@ -563,8 +606,11 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>); ...@@ -563,8 +606,11 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>);
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName'; let bundleName = 'bundleName';
function clearUpApplicationDataCallback(err, data) { function clearUpApplicationDataCallback(err: BusinessError, data: void) {
if (err) { if (err) {
console.error('------------- clearUpApplicationDataCallback fail, err: --------------', err); console.error('------------- clearUpApplicationDataCallback fail, err: --------------', err);
} else { } else {
...@@ -601,12 +647,15 @@ clearUpApplicationData(bundleName: string): Promise\<void>; ...@@ -601,12 +647,15 @@ clearUpApplicationData(bundleName: string): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName'; let bundleName = 'bundleName';
appManager.clearUpApplicationData(bundleName) appManager.clearUpApplicationData(bundleName)
.then((data) => { .then((data) => {
console.log('------------ clearUpApplicationData success ------------', data); console.log('------------ clearUpApplicationData success ------------', data);
}) })
.catch((err) => { .catch((err: BusinessError) => {
console.error('------------ clearUpApplicationData fail ------------', err); console.error('------------ clearUpApplicationData fail ------------', err);
}); });
``` ```
\ No newline at end of file
...@@ -25,17 +25,20 @@ import Configuration from '@ohos.application.Configuration'; ...@@ -25,17 +25,20 @@ import Configuration from '@ohos.application.Configuration';
**示例:** **示例:**
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import EnvironmentCallback from '@ohos.app.ability.EnvironmentCallback';
import Want from '@ohos.app.ability.Want';
import Window from '@ohos.window'; import Window from '@ohos.window';
export default class EntryAbility extends UIAbility { export default class EntryAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
} }
onDestroy() { onDestroy() {
} }
onWindowStageCreate(windowStage: Window.WindowStage) { onWindowStageCreate(windowStage: Window.WindowStage) {
let envCallback = { let envCallback: EnvironmentCallback = {
onConfigurationUpdated(config) { onConfigurationUpdated(config) {
console.info(`envCallback onConfigurationUpdated success: ${JSON.stringify(config)}`); console.info(`envCallback onConfigurationUpdated success: ${JSON.stringify(config)}`);
let language = config.language; let language = config.language;
......
...@@ -43,17 +43,18 @@ registerMissionListener(listener: MissionListener): number; ...@@ -43,17 +43,18 @@ registerMissionListener(listener: MissionListener): number;
**示例:** **示例:**
```ts ```ts
let listener = { import missionManager from '@ohos.application.missionManager';
onMissionCreated: function (mission) {console.log('--------onMissionCreated-------');},
onMissionDestroyed: function (mission) {console.log('--------onMissionDestroyed-------');},
onMissionSnapshotChanged: function (mission) {console.log('--------onMissionSnapshotChanged-------');},
onMissionMovedToFront: function (mission) {console.log('--------onMissionMovedToFront-------');},
onMissionIconUpdated: function (mission, icon) {console.log('--------onMissionIconUpdated-------');},
onMissionClosed: function (mission) {console.log('--------onMissionClosed-------');},
onMissionLabelUpdated: function (mission) {console.log('--------onMissionLabelUpdated-------');}
};
console.log('registerMissionListener'); console.log('registerMissionListener');
let listenerid = missionManager.registerMissionListener(listener); let listenerid = missionManager.registerMissionListener({
onMissionCreated: (mission) => {console.log('--------onMissionCreated-------');},
onMissionDestroyed: (mission) => {console.log('--------onMissionDestroyed-------');},
onMissionSnapshotChanged: (mission) => {console.log('--------onMissionSnapshotChanged-------');},
onMissionMovedToFront: (mission) => {console.log('--------onMissionMovedToFront-------');},
onMissionIconUpdated: (mission, icon) => {console.log('--------onMissionIconUpdated-------');},
onMissionClosed: (mission) => {console.log('--------onMissionClosed-------');},
onMissionLabelUpdated: (mission) => {console.log('--------onMissionLabelUpdated-------');}
});
``` ```
...@@ -79,17 +80,18 @@ unregisterMissionListener(listenerId: number, callback: AsyncCallback&lt;void&gt ...@@ -79,17 +80,18 @@ unregisterMissionListener(listenerId: number, callback: AsyncCallback&lt;void&gt
**示例:** **示例:**
```ts ```ts
let listener = { import missionManager from '@ohos.application.missionManager';
onMissionCreated: function (mission) {console.log('--------onMissionCreated-------');},
onMissionDestroyed: function (mission) {console.log('--------onMissionDestroyed-------');},
onMissionSnapshotChanged: function (mission) {console.log('--------onMissionSnapshotChanged-------');},
onMissionMovedToFront: function (mission) {console.log('--------onMissionMovedToFront-------');},
onMissionIconUpdated: function (mission, icon) {console.log('--------onMissionIconUpdated-------');},
onMissionClosed: function (mission) {console.log('--------onMissionClosed-------');},
onMissionLabelUpdated: function (mission) {console.log('--------onMissionLabelUpdated-------');}
};
console.log('registerMissionListener'); console.log('registerMissionListener');
let listenerid = missionManager.registerMissionListener(listener); let listenerid = missionManager.registerMissionListener({
onMissionCreated: (mission) => {console.log('--------onMissionCreated-------');},
onMissionDestroyed: (mission) => {console.log('--------onMissionDestroyed-------');},
onMissionSnapshotChanged: (mission) => {console.log('--------onMissionSnapshotChanged-------');},
onMissionMovedToFront: (mission) => {console.log('--------onMissionMovedToFront-------');},
onMissionIconUpdated: (mission, icon) => {console.log('--------onMissionIconUpdated-------');},
onMissionClosed: (mission) => {console.log('--------onMissionClosed-------');},
onMissionLabelUpdated: (mission) => {console.log('--------onMissionLabelUpdated-------');}
});
missionManager.unregisterMissionListener(listenerid, (error) => { missionManager.unregisterMissionListener(listenerid, (error) => {
console.error('unregisterMissionListener fail, error: ${error}'); console.error('unregisterMissionListener fail, error: ${error}');
...@@ -124,19 +126,21 @@ unregisterMissionListener(listenerId: number): Promise&lt;void&gt;; ...@@ -124,19 +126,21 @@ unregisterMissionListener(listenerId: number): Promise&lt;void&gt;;
**示例:** **示例:**
```ts ```ts
let listener = { import missionManager from '@ohos.application.missionManager';
onMissionCreated: function (mission) {console.log('--------onMissionCreated-------');}, import { BusinessError } from '@ohos.base';
onMissionDestroyed: function (mission) {console.log('--------onMissionDestroyed-------');},
onMissionSnapshotChanged: function (mission) {console.log('--------onMissionSnapshotChanged-------');},
onMissionMovedToFront: function (mission) {console.log('--------onMissionMovedToFront-------');},
onMissionIconUpdated: function (mission, icon) {console.log('--------onMissionIconUpdated-------');},
onMissionClosed: function (mission) {console.log('--------onMissionClosed-------');},
onMissionLabelUpdated: function (mission) {console.log('--------onMissionLabelUpdated-------');}
};
console.log('registerMissionListener'); console.log('registerMissionListener');
let listenerid = missionManager.registerMissionListener(listener); let listenerid = missionManager.registerMissionListener({
onMissionCreated: (mission) => {console.log('--------onMissionCreated-------');},
onMissionDestroyed: (mission) => {console.log('--------onMissionDestroyed-------');},
onMissionSnapshotChanged: (mission) => {console.log('--------onMissionSnapshotChanged-------');},
onMissionMovedToFront: (mission) => {console.log('--------onMissionMovedToFront-------');},
onMissionIconUpdated: (mission, icon) => {console.log('--------onMissionIconUpdated-------');},
onMissionClosed: (mission) => {console.log('--------onMissionClosed-------');},
onMissionLabelUpdated: (mission) => {console.log('--------onMissionLabelUpdated-------');}
});
missionManager.unregisterMissionListener(listenerid).catch(function (error) { missionManager.unregisterMissionListener(listenerid).catch((error: BusinessError) => {
console.error('unregisterMissionListener fail, error: ${error}'); console.error('unregisterMissionListener fail, error: ${error}');
}); });
``` ```
...@@ -166,21 +170,23 @@ getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback&lt;M ...@@ -166,21 +170,23 @@ getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback&lt;M
```ts ```ts
import missionManager from '@ohos.application.missionManager'; import missionManager from '@ohos.application.missionManager';
import { BusinessError } from '@ohos.base';
let allMissions=missionManager.getMissionInfos('',10).catch(function(err){console.log(err);}); let allMissions=missionManager.getMissionInfos('',10).catch((err: BusinessError) => {
missionManager.getMissionInfo('', allMissions[0].missionId, (error, mission) => { console.log('${err}');});
if (error.code) { missionManager.getMissionInfo('', allMissions[0].missionId, (error, mission) => {
console.error('getMissionInfo failed, error.code: ${error.code}, error.message: ${error.message}'); if (error.code) {
return; console.error('getMissionInfo failed, error.code: ${error.code}, error.message: ${error.message}');
} return;
}
console.log('mission.missionId = ${mission.missionId}');
console.log('mission.runningState = ${mission.runningState}'); console.log('mission.missionId = ${mission.missionId}');
console.log('mission.lockedState = ${mission.lockedState}'); console.log('mission.runningState = ${mission.runningState}');
console.log('mission.timestamp = ${mission.timestamp}'); console.log('mission.lockedState = ${mission.lockedState}');
console.log('mission.label = ${mission.label}'); console.log('mission.timestamp = ${mission.timestamp}');
console.log('mission.iconPath = ${mission.iconPath}'); console.log('mission.label = ${mission.label}');
}); console.log('mission.iconPath = ${mission.iconPath}');
});
``` ```
...@@ -213,8 +219,9 @@ getMissionInfo(deviceId: string, missionId: number): Promise&lt;MissionInfo&gt;; ...@@ -213,8 +219,9 @@ getMissionInfo(deviceId: string, missionId: number): Promise&lt;MissionInfo&gt;;
```ts ```ts
import missionManager from '@ohos.application.missionManager'; import missionManager from '@ohos.application.missionManager';
import { BusinessError } from '@ohos.base';
let mission = missionManager.getMissionInfo('', 10).catch(function (error){ let mission = missionManager.getMissionInfo('', 10).catch((error: BusinessError) => {
console.error('getMissionInfo fail, error: ${error}'); console.error('getMissionInfo fail, error: ${error}');
}); });
``` ```
...@@ -285,8 +292,9 @@ getMissionInfos(deviceId: string, numMax: number): Promise&lt;Array&lt;MissionIn ...@@ -285,8 +292,9 @@ getMissionInfos(deviceId: string, numMax: number): Promise&lt;Array&lt;MissionIn
```ts ```ts
import missionManager from '@ohos.application.missionManager'; import missionManager from '@ohos.application.missionManager';
import { BusinessError } from '@ohos.base';
let allMissions = missionManager.getMissionInfos('', 10).catch(function (error){ let allMissions = missionManager.getMissionInfos('', 10).catch((error: BusinessError) => {
console.error('getMissionInfos fail, error: ${error}'); console.error('getMissionInfos fail, error: ${error}');
}); });
``` ```
...@@ -366,20 +374,21 @@ getMissionSnapShot(deviceId: string, missionId: number): Promise&lt;MissionSnaps ...@@ -366,20 +374,21 @@ getMissionSnapShot(deviceId: string, missionId: number): Promise&lt;MissionSnaps
```ts ```ts
import missionManager from '@ohos.application.missionManager'; import missionManager from '@ohos.application.missionManager';
import { BusinessError } from '@ohos.base';
let allMissions; let id: number = -1;
missionManager.getMissionInfos('',10).then(function(res){ missionManager.getMissionInfos('',10).then((res) => {
allMissions=res; let allMissions = res;
}).catch(function(error) {
console.error('getMissionInfos fail, error: ${error}');
});
console.log('size = ${allMissions.length}'); console.log('size = ${allMissions.length}');
console.log('missions = ${JSON.stringify(allMissions)}'); console.log('missions = ${JSON.stringify(allMissions)}');
let id = allMissions[0].missionId; id = allMissions[0].missionId;
}).catch((error: BusinessError) => {
console.error('getMissionInfos fail, error: ${error}');
});
let snapshot = missionManager.getMissionSnapShot('', id).catch(function (error){ let snapshot = missionManager.getMissionSnapShot('', id).catch((error: BusinessError) => {
console.error('getMissionSnapShot fail, error: ${error}'); console.error('getMissionSnapShot fail, error: ${error}');
}); });
``` ```
## missionManager.lockMission ## missionManager.lockMission
...@@ -450,17 +459,19 @@ lockMission(missionId: number): Promise&lt;void&gt;; ...@@ -450,17 +459,19 @@ lockMission(missionId: number): Promise&lt;void&gt;;
```ts ```ts
import missionManager from '@ohos.application.missionManager'; import missionManager from '@ohos.application.missionManager';
let allMissions; import { BusinessError } from '@ohos.base';
missionManager.getMissionInfos('',10).then(function(res){
allMissions=res; let id: number = -1;
}).catch(function(error) { missionManager.getMissionInfos('',10).then((res) => {
let allMissions = res;
console.log('size = ${allMissions.length}');
console.log('missions = ${JSON.stringify(allMissions)}');
id = allMissions[0].missionId;
}).catch((error: BusinessError) => {
console.error('getMissionInfos fail, error: ${error}'); console.error('getMissionInfos fail, error: ${error}');
}); });
console.log('size = ${allMissions.length}');
console.log('missions = ${JSON.stringify(allMissions)}');
let id = allMissions[0].missionId;
missionManager.lockMission(id).catch(function (error){ missionManager.lockMission(id).catch((error: BusinessError) => {
console.error('lockMission fail, error: ${error}'); console.error('lockMission fail, error: ${error}');
}); });
``` ```
...@@ -534,21 +545,22 @@ unlockMission(missionId: number): Promise&lt;void&gt;; ...@@ -534,21 +545,22 @@ unlockMission(missionId: number): Promise&lt;void&gt;;
```ts ```ts
import missionManager from '@ohos.application.missionManager'; import missionManager from '@ohos.application.missionManager';
import { BusinessError } from '@ohos.base';
let allMissions; let id: number = -1;
missionManager.getMissionInfos('',10).then(function(res){ missionManager.getMissionInfos('',10).then((res) => {
allMissions=res; let allMissions = res;
}).catch(function(error) { console.log('size = ${allMissions.length}');
console.log('missions = ${JSON.stringify(allMissions)}');
id = allMissions[0].missionId;
}).catch((error: BusinessError) => {
console.error('getMissionInfos fail, error: ${error}'); console.error('getMissionInfos fail, error: ${error}');
}); });
console.log('size = ${allMissions.length}');
console.log('missions = ${JSON.stringify(allMissions)}');
let id = allMissions[0].missionId;
missionManager.lockMission(id).catch(function (error){ missionManager.lockMission(id).catch((error: BusinessError) => {
console.error('lockMission fail, error: ${error}'); console.error('lockMission fail, error: ${error}');
}); });
missionManager.unlockMission(id).catch(function (error){ missionManager.unlockMission(id).catch((error: BusinessError) => {
console.error('unlockMission fail, error: ${error}'); console.error('unlockMission fail, error: ${error}');
}); });
``` ```
...@@ -622,18 +634,19 @@ clearMission(missionId: number): Promise&lt;void&gt;; ...@@ -622,18 +634,19 @@ clearMission(missionId: number): Promise&lt;void&gt;;
```ts ```ts
import missionManager from '@ohos.application.missionManager'; import missionManager from '@ohos.application.missionManager';
import { BusinessError } from '@ohos.base';
let allMissions; let id: number = -1;
missionManager.getMissionInfos('',10).then(function(res){ missionManager.getMissionInfos('',10).then((res) => {
allMissions=res; let allMissions = res;
}).catch(function(error) { console.log('size = ${allMissions.length}');
console.log('missions = ${JSON.stringify(allMissions)}');
id = allMissions[0].missionId;
}).catch((error: BusinessError) => {
console.error('getMissionInfos fail, error: ${error}'); console.error('getMissionInfos fail, error: ${error}');
}); });
console.log('size = ${allMissions.length}');
console.log('missions = ${JSON.stringify(allMissions)}');
let id = allMissions[0].missionId;
missionManager.clearMission(id).catch(function (error){ missionManager.clearMission(id).catch((error: BusinessError) => {
console.error('clearMission fail, error: ${error}'); console.error('clearMission fail, error: ${error}');
}); });
``` ```
...@@ -684,7 +697,9 @@ clearAllMissions(): Promise&lt;void&gt;; ...@@ -684,7 +697,9 @@ clearAllMissions(): Promise&lt;void&gt;;
```ts ```ts
import missionManager from '@ohos.application.missionManager'; import missionManager from '@ohos.application.missionManager';
missionManager.clearAllMissions().catch(function (error){ import { BusinessError } from '@ohos.base';
missionManager.clearAllMissions().catch((error: BusinessError) => {
console.error('clearAllMissions fail, error: ${error}'); console.error('clearAllMissions fail, error: ${error}');
}); });
``` ```
...@@ -800,18 +815,19 @@ moveMissionToFront(missionId: number, options?: StartOptions): Promise&lt;void&g ...@@ -800,18 +815,19 @@ moveMissionToFront(missionId: number, options?: StartOptions): Promise&lt;void&g
```ts ```ts
import missionManager from '@ohos.application.missionManager'; import missionManager from '@ohos.application.missionManager';
import { BusinessError } from '@ohos.base';
let allMissions; let id: number = -1;
missionManager.getMissionInfos('',10).then(function(res){ missionManager.getMissionInfos('',10).then((res) => {
allMissions=res; let allMissions = res;
}).catch(function(error) { console.log('size = ${allMissions.length}');
console.log('missions = ${JSON.stringify(allMissions)}');
id = allMissions[0].missionId;
}).catch((error: BusinessError) => {
console.error('getMissionInfos fail, error: ${error}'); console.error('getMissionInfos fail, error: ${error}');
}); });
console.log('size = ${allMissions.length}');
console.log('missions = ${JSON.stringify(allMissions)}');
let id = allMissions[0].missionId;
missionManager.moveMissionToFront(id).catch(function (error){ missionManager.moveMissionToFront(id).catch((error: BusinessError) => {
console.error('moveMissionToFront fail, error: ${error}'); console.error('moveMissionToFront fail, error: ${error}');
}); });
``` ```
\ No newline at end of file
...@@ -41,8 +41,11 @@ onReceiveEvent(event: CommonEventData): void; ...@@ -41,8 +41,11 @@ onReceiveEvent(event: CommonEventData): void;
**示例:** **示例:**
```ts ```ts
import StaticSubscriberExtensionAbility from '@ohos.application.StaticSubscriberExtensionAbility';
import CommonEventManager from '@ohos.commonEventManager';
class MyStaticSubscriberExtensionAbility extends StaticSubscriberExtensionAbility { class MyStaticSubscriberExtensionAbility extends StaticSubscriberExtensionAbility {
onReceiveEvent(event) { onReceiveEvent(event: CommonEventManager.CommonEventData) {
console.log('onReceiveEvent, event: ${JSON.stringify(event)}'); console.log('onReceiveEvent, event: ${JSON.stringify(event)}');
} }
} }
......
...@@ -25,6 +25,8 @@ onPrepare(): void ...@@ -25,6 +25,8 @@ onPrepare(): void
**示例:** **示例:**
```ts ```ts
import TestRunner from '@ohos.application.testRunner';
export default class UserTestRunner implements TestRunner { export default class UserTestRunner implements TestRunner {
onPrepare() { onPrepare() {
console.log('Trigger onPrepare'); console.log('Trigger onPrepare');
...@@ -46,6 +48,8 @@ onRun(): void ...@@ -46,6 +48,8 @@ onRun(): void
**示例:** **示例:**
```ts ```ts
import TestRunner from '@ohos.application.testRunner';
export default class UserTestRunner implements TestRunner { export default class UserTestRunner implements TestRunner {
onPrepare() {} onPrepare() {}
onRun() { onRun() {
......
...@@ -33,13 +33,15 @@ import Want from '@ohos.application.Want'; ...@@ -33,13 +33,15 @@ import Want from '@ohos.application.Want';
- 基础用法(在UIAbility对象中调用,其中示例中的context为UIAbility的上下文对象) - 基础用法(在UIAbility对象中调用,其中示例中的context为UIAbility的上下文对象)
```ts ```ts
let want = { import Want from '@ohos.application.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
'deviceId': '', // deviceId为空表示本设备 'deviceId': '', // deviceId为空表示本设备
'bundleName': 'com.example.myapplication', 'bundleName': 'com.example.myapplication',
'abilityName': 'EntryAbility', 'abilityName': 'EntryAbility',
'moduleName': 'entry' // moduleName非必选
}; };
this.context.startAbility(want, (error) => { this.context.startAbility(want, (error: BusinessError) => {
// 显式拉起Ability,通过bundleName、abilityName和moduleName可以唯一确定一个Ability // 显式拉起Ability,通过bundleName、abilityName和moduleName可以唯一确定一个Ability
console.error('error.code = ${error.code}'); console.error('error.code = ${error.code}');
}); });
...@@ -49,7 +51,9 @@ import Want from '@ohos.application.Want'; ...@@ -49,7 +51,9 @@ import Want from '@ohos.application.Want';
* 字符串(String) * 字符串(String)
```ts ```ts
let want = { import Want from '@ohos.application.Want';
let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility', abilityName: 'EntryAbility',
parameters: { parameters: {
...@@ -59,7 +63,9 @@ import Want from '@ohos.application.Want'; ...@@ -59,7 +63,9 @@ import Want from '@ohos.application.Want';
``` ```
* 数字(Number) * 数字(Number)
```ts ```ts
let want = { import Want from '@ohos.application.Want';
let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility', abilityName: 'EntryAbility',
parameters: { parameters: {
...@@ -70,7 +76,9 @@ import Want from '@ohos.application.Want'; ...@@ -70,7 +76,9 @@ import Want from '@ohos.application.Want';
``` ```
* 布尔(Boolean) * 布尔(Boolean)
```ts ```ts
let want = { import Want from '@ohos.application.Want';
let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility', abilityName: 'EntryAbility',
parameters: { parameters: {
...@@ -80,7 +88,9 @@ import Want from '@ohos.application.Want'; ...@@ -80,7 +88,9 @@ import Want from '@ohos.application.Want';
``` ```
* 对象(Object) * 对象(Object)
```ts ```ts
let want = { import Want from '@ohos.application.Want';
let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility', abilityName: 'EntryAbility',
parameters: { parameters: {
...@@ -95,7 +105,9 @@ import Want from '@ohos.application.Want'; ...@@ -95,7 +105,9 @@ import Want from '@ohos.application.Want';
``` ```
* 数组(Array) * 数组(Array)
```ts ```ts
let want = { import Want from '@ohos.application.Want';
let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility', abilityName: 'EntryAbility',
parameters: { parameters: {
...@@ -109,22 +121,24 @@ import Want from '@ohos.application.Want'; ...@@ -109,22 +121,24 @@ import Want from '@ohos.application.Want';
* 文件描述符(FD) * 文件描述符(FD)
```ts ```ts
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
let fd; import Want from '@ohos.application.Want';
import { BusinessError } from '@ohos.base';
let fd: number = 0;
try { try {
fd = fs.openSync('/data/storage/el2/base/haps/pic.png').fd; fd = fs.openSync('/data/storage/el2/base/haps/pic.png').fd;
} catch(e) { } catch(e) {
console.error('openSync fail: ${JSON.stringify(e)}'); console.error('openSync fail: ${JSON.stringify(e)}');
} }
let want = { let want: Want = {
'deviceId': '', // deviceId为空表示本设备 deviceId: '', // deviceId为空表示本设备
'bundleName': 'com.example.myapplication', bundleName: 'com.example.myapplication',
'abilityName': 'EntryAbility', abilityName: 'EntryAbility',
'moduleName': 'entry', // moduleName非必选 parameters: {
'parameters': {
'keyFd':{'type':'FD', 'value':fd} 'keyFd':{'type':'FD', 'value':fd}
} }
}; };
this.context.startAbility(want, (error) => { this.context.startAbility(want, (error: BusinessError) => {
// 显式拉起Ability,通过bundleName、abilityName和moduleName可以唯一确定一个Ability // 显式拉起Ability,通过bundleName、abilityName和moduleName可以唯一确定一个Ability
console.error('error.code = ${error.code}'); console.error('error.code = ${error.code}');
}); });
......
...@@ -72,17 +72,20 @@ queryBusinessAbilityInfo(filter: BusinessAbilityFilter, callback: AsyncCallback\ ...@@ -72,17 +72,20 @@ queryBusinessAbilityInfo(filter: BusinessAbilityFilter, callback: AsyncCallback\
```ts ```ts
import businessAbilityRouter from '@ohos.app.businessAbilityRouter'; import businessAbilityRouter from '@ohos.app.businessAbilityRouter';
let filter = {businessType: businessAbilityRouter.BusinessType.SHARE}; import { BusinessError } from '@ohos.base';
let filter: businessAbilityRouter.BusinessAbilityFilter = {businessType: businessAbilityRouter.BusinessType.SHARE};
try { try {
businessAbilityRouter.queryBusinessAbilityInfo(filter) businessAbilityRouter.queryBusinessAbilityInfo(filter)
.then(() => { .then(() => {
console.info('queryBusinessAbilityInfo success'); console.info('queryBusinessAbilityInfo success');
}).catch((error) => { }).catch((error: BusinessError) => {
console.error('queryBusinessAbilityInfo failed ' + error.message); console.error('queryBusinessAbilityInfo failed ' + error.message);
}); });
} catch (error) { } catch (error) {
console.error('queryBusinessAbilityInfo failed ' + error.message); let message = (error as BusinessError).message;
console.error('queryBusinessAbilityInfo failed ' + message);
} }
``` ```
...@@ -114,7 +117,9 @@ queryBusinessAbilityInfo(filter: BusinessAbilityFilter): Promise\<Array\<Busines ...@@ -114,7 +117,9 @@ queryBusinessAbilityInfo(filter: BusinessAbilityFilter): Promise\<Array\<Busines
```ts ```ts
import businessAbilityRouter from '@ohos.app.businessAbilityRouter'; import businessAbilityRouter from '@ohos.app.businessAbilityRouter';
let filter = {businessType: businessAbilityRouter.BusinessType.SHARE}; import { BusinessError } from '@ohos.base';
let filter: businessAbilityRouter.BusinessAbilityFilter = {businessType: businessAbilityRouter.BusinessType.SHARE};
try { try {
businessAbilityRouter.queryBusinessAbilityInfo(filter, (error, data) => { businessAbilityRouter.queryBusinessAbilityInfo(filter, (error, data) => {
...@@ -125,6 +130,7 @@ try { ...@@ -125,6 +130,7 @@ try {
console.info('queryBusinessAbilityInfo success'); console.info('queryBusinessAbilityInfo success');
}); });
} catch (error) { } catch (error) {
console.error('queryBusinessAbilityInfo failed ' + error.message); let message = (error as BusinessError).message;
console.error('queryBusinessAbilityInfo failed ' + message);
} }
``` ```
...@@ -25,7 +25,10 @@ import common from '@ohos.app.ability.common'; ...@@ -25,7 +25,10 @@ import common from '@ohos.app.ability.common';
**示例:** **示例:**
```ts ```ts
let want = { import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let want: Want = {
bundleName: 'com.example.myapp', bundleName: 'com.example.myapp',
abilityName: 'MyAbility' abilityName: 'MyAbility'
}; };
...@@ -42,5 +45,5 @@ import common from '@ohos.app.ability.common'; ...@@ -42,5 +45,5 @@ import common from '@ohos.app.ability.common';
} }
}; };
let connection = this.context.connectAbility(want, connectOptions); let connection: number = this.context.connectAbility(want, connectOptions);
``` ```
\ No newline at end of file
...@@ -40,7 +40,9 @@ openFile(uri: string, mode: string, callback: AsyncCallback\<number>): void ...@@ -40,7 +40,9 @@ openFile(uri: string, mode: string, callback: AsyncCallback\<number>): void
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
...@@ -78,7 +80,9 @@ openFile(uri: string, mode: string): Promise\<number> ...@@ -78,7 +80,9 @@ openFile(uri: string, mode: string): Promise\<number>
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
...@@ -107,7 +111,9 @@ on(type: 'dataChange', uri: string, callback: AsyncCallback\<void>): void ...@@ -107,7 +111,9 @@ on(type: 'dataChange', uri: string, callback: AsyncCallback\<void>): void
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
...@@ -140,7 +146,9 @@ off(type: 'dataChange', uri: string, callback?: AsyncCallback\<void>): void ...@@ -140,7 +146,9 @@ off(type: 'dataChange', uri: string, callback?: AsyncCallback\<void>): void
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
...@@ -176,7 +184,9 @@ getType(uri: string, callback: AsyncCallback\<string>): void ...@@ -176,7 +184,9 @@ getType(uri: string, callback: AsyncCallback\<string>): void
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
...@@ -212,7 +222,9 @@ getType(uri: string): Promise\<string> ...@@ -212,7 +222,9 @@ getType(uri: string): Promise\<string>
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
...@@ -240,7 +252,9 @@ getFileTypes(uri: string, mimeTypeFilter: string, callback: AsyncCallback<Array\ ...@@ -240,7 +252,9 @@ getFileTypes(uri: string, mimeTypeFilter: string, callback: AsyncCallback<Array\
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
...@@ -277,7 +291,9 @@ getFileTypes(uri: string, mimeTypeFilter: string): Promise\<Array\<string>> ...@@ -277,7 +291,9 @@ getFileTypes(uri: string, mimeTypeFilter: string): Promise\<Array\<string>>
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
...@@ -304,7 +320,9 @@ normalizeUri(uri: string, callback: AsyncCallback\<string>): void ...@@ -304,7 +320,9 @@ normalizeUri(uri: string, callback: AsyncCallback\<string>): void
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
...@@ -340,7 +358,9 @@ normalizeUri(uri: string): Promise\<string> ...@@ -340,7 +358,9 @@ normalizeUri(uri: string): Promise\<string>
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
...@@ -367,7 +387,9 @@ denormalizeUri(uri: string, callback: AsyncCallback\<string>): void ...@@ -367,7 +387,9 @@ denormalizeUri(uri: string, callback: AsyncCallback\<string>): void
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
...@@ -403,7 +425,9 @@ denormalizeUri(uri: string): Promise\<string> ...@@ -403,7 +425,9 @@ denormalizeUri(uri: string): Promise\<string>
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
...@@ -430,7 +454,9 @@ notifyChange(uri: string, callback: AsyncCallback\<void>): void ...@@ -430,7 +454,9 @@ notifyChange(uri: string, callback: AsyncCallback\<void>): void
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
...@@ -466,7 +492,9 @@ notifyChange(uri: string): Promise\<void> ...@@ -466,7 +492,9 @@ notifyChange(uri: string): Promise\<void>
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
...@@ -494,11 +522,14 @@ insert(uri: string, valuesBucket: rdb.ValuesBucket, callback: AsyncCallback\<num ...@@ -494,11 +522,14 @@ insert(uri: string, valuesBucket: rdb.ValuesBucket, callback: AsyncCallback\<num
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
import rdb from '@ohos.data.rdb';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
const valueBucket = { const valueBucket: rdb.ValuesBucket = {
'name': 'rose', 'name': 'rose',
'age': 22, 'age': 22,
'salary': 200.5, 'salary': 200.5,
...@@ -537,11 +568,14 @@ insert(uri: string, valuesBucket: rdb.ValuesBucket): Promise\<number> ...@@ -537,11 +568,14 @@ insert(uri: string, valuesBucket: rdb.ValuesBucket): Promise\<number>
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
import rdb from '@ohos.data.rdb';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
const valueBucket = { const valueBucket: rdb.ValuesBucket = {
'name': 'rose1', 'name': 'rose1',
'age': 221, 'age': 221,
'salary': 20.5, 'salary': 20.5,
...@@ -571,13 +605,16 @@ batchInsert(uri: string, valuesBuckets: Array\<rdb.ValuesBucket>, callback: Asyn ...@@ -571,13 +605,16 @@ batchInsert(uri: string, valuesBuckets: Array\<rdb.ValuesBucket>, callback: Asyn
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
import rdb from '@ohos.data.rdb';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
let cars = new Array({'name': 'roe11', 'age': 21, 'salary': 20.5, 'blobType': 'u8',}, let cars = new Array({'name': 'roe11', 'age': 21, 'salary': 20.5, 'blobType': 'u8',} as rdb.ValuesBucket,
{'name': 'roe12', 'age': 21, 'salary': 20.5, 'blobType': 'u8',}, {'name': 'roe12', 'age': 21, 'salary': 20.5, 'blobType': 'u8',} as rdb.ValuesBucket,
{'name': 'roe13', 'age': 21, 'salary': 20.5, 'blobType': 'u8',}); {'name': 'roe13', 'age': 21, 'salary': 20.5, 'blobType': 'u8',} as rdb.ValuesBucket);
DAHelper.batchInsert('dataability:///com.example.DataAbility', cars, (error, data) => { DAHelper.batchInsert('dataability:///com.example.DataAbility', cars, (error, data) => {
if (error && error.code !== 0) { if (error && error.code !== 0) {
console.error('batchInsert fail, error: ${JSON.stringify(error)}'); console.error('batchInsert fail, error: ${JSON.stringify(error)}');
...@@ -611,13 +648,16 @@ batchInsert(uri: string, valuesBuckets: Array<rdb.ValuesBucket>): Promise\<numbe ...@@ -611,13 +648,16 @@ batchInsert(uri: string, valuesBuckets: Array<rdb.ValuesBucket>): Promise\<numbe
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
import rdb from '@ohos.data.rdb';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
let cars = new Array({'name': 'roe11', 'age': 21, 'salary': 20.5, 'blobType': 'u8',}, let cars = new Array({'name': 'roe11', 'age': 21, 'salary': 20.5, 'blobType': 'u8',} as rdb.ValuesBucket,
{'name': 'roe12', 'age': 21, 'salary': 20.5, 'blobType': 'u8',}, {'name': 'roe12', 'age': 21, 'salary': 20.5, 'blobType': 'u8',} as rdb.ValuesBucket,
{'name': 'roe13', 'age': 21, 'salary': 20.5, 'blobType': 'u8',}); {'name': 'roe13', 'age': 21, 'salary': 20.5, 'blobType': 'u8',} as rdb.ValuesBucket);
DAHelper.batchInsert('dataability:///com.example.DataAbility', cars).then((data) => { DAHelper.batchInsert('dataability:///com.example.DataAbility', cars).then((data) => {
console.info('batchInsert data: ${JSON.stringify(data)}'); console.info('batchInsert data: ${JSON.stringify(data)}');
}); });
...@@ -642,8 +682,10 @@ delete(uri: string, predicates: dataAbility.DataAbilityPredicates, callback: Asy ...@@ -642,8 +682,10 @@ delete(uri: string, predicates: dataAbility.DataAbilityPredicates, callback: Asy
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataAbility'; import ohos_data_ability from '@ohos.data.dataAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
...@@ -681,8 +723,10 @@ delete(uri: string, predicates?: dataAbility.DataAbilityPredicates): Promise\<nu ...@@ -681,8 +723,10 @@ delete(uri: string, predicates?: dataAbility.DataAbilityPredicates): Promise\<nu
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataAbility'; import ohos_data_ability from '@ohos.data.dataAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
...@@ -712,12 +756,15 @@ update(uri: string, valuesBucket: rdb.ValuesBucket, predicates: dataAbility.Data ...@@ -712,12 +756,15 @@ update(uri: string, valuesBucket: rdb.ValuesBucket, predicates: dataAbility.Data
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataAbility'; import ohos_data_ability from '@ohos.data.dataAbility';
import rdb from '@ohos.data.rdb';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
const va = { const va: rdb.ValuesBucket = {
'name': 'roe1', 'name': 'roe1',
'age': 21, 'age': 21,
'salary': 20.5, 'salary': 20.5,
...@@ -758,12 +805,15 @@ update(uri: string, valuesBucket: rdb.ValuesBucket, predicates?: dataAbility.Dat ...@@ -758,12 +805,15 @@ update(uri: string, valuesBucket: rdb.ValuesBucket, predicates?: dataAbility.Dat
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataAbility'; import ohos_data_ability from '@ohos.data.dataAbility';
import rdb from '@ohos.data.rdb';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
const va = { const va: rdb.ValuesBucket = {
'name': 'roe1', 'name': 'roe1',
'age': 21, 'age': 21,
'salary': 20.5, 'salary': 20.5,
...@@ -795,8 +845,10 @@ query(uri: string, columns: Array\<string>, predicates: dataAbility.DataAbilityP ...@@ -795,8 +845,10 @@ query(uri: string, columns: Array\<string>, predicates: dataAbility.DataAbilityP
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataAbility'; import ohos_data_ability from '@ohos.data.dataAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
...@@ -838,8 +890,10 @@ query(uri: string, columns?: Array\<string>, predicates?: dataAbility.DataAbilit ...@@ -838,8 +890,10 @@ query(uri: string, columns?: Array\<string>, predicates?: dataAbility.DataAbilit
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataAbility'; import ohos_data_ability from '@ohos.data.dataAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility' 'dataability:///com.example.DataAbility'
); );
...@@ -871,6 +925,7 @@ call(uri: string, method: string, arg: string, extras: PacMap, callback: AsyncCa ...@@ -871,6 +925,7 @@ call(uri: string, method: string, arg: string, extras: PacMap, callback: AsyncCa
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
...@@ -912,7 +967,9 @@ call(uri: string, method: string, arg: string, extras: PacMap): Promise\<PacMap> ...@@ -912,7 +967,9 @@ call(uri: string, method: string, arg: string, extras: PacMap): Promise\<PacMap>
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
import { BusinessError } from '@ohos.base';
let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.jsapidemo.UserDataAbility' 'dataability:///com.example.jsapidemo.UserDataAbility'
...@@ -920,7 +977,7 @@ let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbi ...@@ -920,7 +977,7 @@ let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbi
dataAbilityHelper.call('dataability:///com.example.jsapidemo.UserDataAbility', dataAbilityHelper.call('dataability:///com.example.jsapidemo.UserDataAbility',
'method', 'arg', {'key1':'value1'}).then((data) => { 'method', 'arg', {'key1':'value1'}).then((data) => {
console.info('call success, data: ${data}'); console.info('call success, data: ${data}');
}).catch((error) => { }).catch((error: BusinessError) => {
console.error('call failed, error: ${error}'); console.error('call failed, error: ${error}');
}); });
``` ```
...@@ -944,10 +1001,11 @@ executeBatch(uri: string, operations: Array\<DataAbilityOperation>, callback: As ...@@ -944,10 +1001,11 @@ executeBatch(uri: string, operations: Array\<DataAbilityOperation>, callback: As
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
// 根据DataAbilityOperation列表选择要对数据库做的操作 // 根据DataAbilityOperation列表选择要对数据库做的操作
let op=new Array(); let op: Array<ability.DataAbilityOperation> = new Array();
let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.jsapidemo.UserDataAbility' 'dataability:///com.example.jsapidemo.UserDataAbility'
); );
...@@ -984,16 +1042,18 @@ executeBatch(uri: string, operations: Array\<DataAbilityOperation>): Promise\<Ar ...@@ -984,16 +1042,18 @@ executeBatch(uri: string, operations: Array\<DataAbilityOperation>): Promise\<Ar
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
import { BusinessError } from '@ohos.base';
// 根据DataAbilityOperation列表选择要对数据库做的操作 // 根据DataAbilityOperation列表选择要对数据库做的操作
let op=new Array(); let op: Array<ability.DataAbilityOperation> = new Array();
let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.jsapidemo.UserDataAbility' 'dataability:///com.example.jsapidemo.UserDataAbility'
); );
dataAbilityHelper.executeBatch('dataability:///com.example.jsapidemo.UserDataAbility', op).then((data) => { dataAbilityHelper.executeBatch('dataability:///com.example.jsapidemo.UserDataAbility', op).then((data) => {
console.info('executeBatch success, data: ${data}'); console.info('executeBatch success, data: ${data}');
}).catch((error) => { }).catch((error: BusinessError) => {
console.error('executeBatch failed, error: ${error}'); console.error('executeBatch failed, error: ${error}');
}); });
......
...@@ -25,47 +25,42 @@ import ability from '@ohos.ability.ability'; ...@@ -25,47 +25,42 @@ import ability from '@ohos.ability.ability';
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
import rdb from '@ohos.data.rdb';
// 批量执行数据库操作 // 批量执行数据库操作
function executeBatchOperation() { function executeBatchOperation() {
let dataAbilityUri = ('dataability:///com.example.myapplication.TestDataAbility'); let dataAbilityUri = ('dataability:///com.example.myapplication.TestDataAbility');
let DAHelper: ability.DataAbilityHelper; let DAHelper: ability.DataAbilityHelper;
try { DAHelper = featureAbility.acquireDataAbilityHelper(dataAbilityUri);
DAHelper = featureAbility.acquireDataAbilityHelper(dataAbilityUri);
if (DAHelper === null) {
console.error('DAHelper is null');
}
} catch (err) {
console.error('acquireDataAbilityHelper fail, error: ${JSON.stringify(err)}');
}
let valueBucket = { let valueBucket: rdb.ValuesBucket = {
'name': 'DataAbilityHelperTest', 'name': 'DataAbilityHelperTest',
'age': 24, 'age': 24,
'salary': 2024.20, 'salary': 2024.20,
}; };
let operations = [ let predicateBackReferences = new Map<number, number>()
{ predicateBackReferences.set(1, 1)
uri: dataAbilityUri,
type: featureAbility.DataAbilityOperationType.TYPE_INSERT,
valuesBucket: valueBucket,
predicates: null,
expectedCount: 1,
PredicatesBackReferences: {},
interrupted: true,
},
{
uri: dataAbilityUri,
type: featureAbility.DataAbilityOperationType.TYPE_INSERT,
valuesBucket: valueBucket,
predicates: null,
expectedCount: 1,
PredicatesBackReferences: {},
interrupted: true,
}
];
let operations: Array<ability.DataAbilityOperation> = [
{
uri: dataAbilityUri,
type: featureAbility.DataAbilityOperationType.TYPE_INSERT,
valuesBucket: valueBucket,
expectedCount: 1,
predicatesBackReferences: predicateBackReferences,
interrupted: true,
},
{
uri: dataAbilityUri,
type: featureAbility.DataAbilityOperationType.TYPE_INSERT,
valuesBucket: valueBucket,
expectedCount: 1,
predicatesBackReferences: predicateBackReferences,
interrupted: true,
}
];
try { try {
DAHelper.executeBatch(dataAbilityUri, operations).then((data) => { DAHelper.executeBatch(dataAbilityUri, operations).then((data) => {
for (let i = 0; i < data.length; i++) { for (let i = 0; i < data.length; i++) {
...@@ -73,7 +68,7 @@ function executeBatchOperation() { ...@@ -73,7 +68,7 @@ function executeBatchOperation() {
console.log('dataAbilityResult.uri: ${dataAbilityResult.uri}'); console.log('dataAbilityResult.uri: ${dataAbilityResult.uri}');
console.log('dataAbilityResult.count: ${dataAbilityResult.count}'); console.log('dataAbilityResult.count: ${dataAbilityResult.count}');
} }
}).catch(err => { }).catch((err: BusinessError) => {
console.error('executeBatch error: ${JSON.stringify(err)}'); console.error('executeBatch error: ${JSON.stringify(err)}');
}); });
} catch (err) { } catch (err) {
......
...@@ -24,23 +24,23 @@ import ability from '@ohos.ability.ability'; ...@@ -24,23 +24,23 @@ import ability from '@ohos.ability.ability';
**示例:** **示例:**
```ts ```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
import Want from '@ohos.app.ability.Want';
let Want = { let want: Want = {
bundleName: 'com.example.abilityStartSettingApp2', bundleName: 'com.example.abilityStartSettingApp2',
abilityName: 'com.example.abilityStartSettingApp.EntryAbility', abilityName: 'com.example.abilityStartSettingApp.EntryAbility',
}; };
let abilityStartSetting ={
[featureAbility.AbilityStartSetting.BOUNDS_KEY] : [100,200,300,400],
[featureAbility.AbilityStartSetting.WINDOW_MODE_KEY] :
featureAbility.AbilityWindowConfiguration.WINDOW_MODE_UNDEFINED,
[featureAbility.AbilityStartSetting.DISPLAY_ID_KEY] : 1,
};
let startAbilityParameter: ability.StartAbilityParameter = { let startAbilityParameter: ability.StartAbilityParameter = {
want : Want, want : want,
abilityStartSetting : abilityStartSetting abilityStartSetting : {
abilityBounds : [100,200,300,400],
windowMode :
featureAbility.AbilityWindowConfiguration.WINDOW_MODE_UNDEFINED,
displayId : 1,
}
}; };
try { try {
......
...@@ -33,13 +33,16 @@ import Want from '@ohos.app.ability.Want'; ...@@ -33,13 +33,16 @@ import Want from '@ohos.app.ability.Want';
- 基础用法(在UIAbility对象中调用,其中示例中的context为UIAbility的上下文对象) - 基础用法(在UIAbility对象中调用,其中示例中的context为UIAbility的上下文对象)
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
'deviceId': '', // deviceId为空表示本设备 import { BusinessError } from '@ohos.base';
'bundleName': 'com.example.myapplication',
'abilityName': 'EntryAbility', let want: Want = {
'moduleName': 'entry' // moduleName非必选 deviceId: '', // deviceId为空表示本设备
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility',
moduleName: 'entry' // moduleName非必选
}; };
this.context.startAbility(want, (error) => { this.context.startAbility(want, (error: BusinessError) => {
// 显式拉起Ability,通过bundleName、abilityName和moduleName可以唯一确定一个Ability // 显式拉起Ability,通过bundleName、abilityName和moduleName可以唯一确定一个Ability
console.error('error.code = ${error.code}'); console.error('error.code = ${error.code}');
}); });
...@@ -49,24 +52,25 @@ import Want from '@ohos.app.ability.Want'; ...@@ -49,24 +52,25 @@ import Want from '@ohos.app.ability.Want';
```ts ```ts
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
// ... // ...
let fd; let fd: number = 0;
try { try {
fd = fs.openSync('/data/storage/el2/base/haps/pic.png').fd; fd = fs.openSync('/data/storage/el2/base/haps/pic.png').fd;
} catch(e) { } catch(e) {
console.error('openSync fail: ${JSON.stringify(e)}'); console.error('openSync fail: ${JSON.stringify(e)}');
} }
let want = { let want: Want = {
'deviceId': '', // deviceId为空表示本设备 deviceId: '', // deviceId为空表示本设备
'bundleName': 'com.example.myapplication', bundleName: 'com.example.myapplication',
'abilityName': 'EntryAbility', abilityName: 'EntryAbility',
'moduleName': 'entry', // moduleName非必选 moduleName: 'entry', // moduleName非必选
'parameters': { parameters: {
'keyFd':{'type':'FD', 'value':fd} 'keyFd':{'type':'FD', 'value':fd}
} }
}; };
this.context.startAbility(want, (error) => { this.context.startAbility(want, (error: BusinessError) => {
// 显式拉起Ability,通过bundleName、abilityName和moduleName可以唯一确定一个Ability // 显式拉起Ability,通过bundleName、abilityName和moduleName可以唯一确定一个Ability
console.error('error.code = ${error.code}'); console.error('error.code = ${error.code}');
}); });
......
...@@ -174,8 +174,7 @@ verifyPermission(permission: string, options?: PermissionOptions): Promise\<numb ...@@ -174,8 +174,7 @@ verifyPermission(permission: string, options?: PermissionOptions): Promise\<numb
```ts ```ts
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
let context: featureAbility.Context = featureAbility.getContext(); let context: featureAbility.Context = featureAbility.getContext();
let Permission = {pid:1}; context.verifyPermission('com.context.permission', {pid:1}).then((data) => {
context.verifyPermission('com.context.permission',Permission).then((data) => {
console.info('verifyPermission data: ${JSON.stringify(data)}'); console.info('verifyPermission data: ${JSON.stringify(data)}');
}); });
``` ```
......
...@@ -47,19 +47,22 @@ addAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\<void>): void ...@@ -47,19 +47,22 @@ addAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\<void>): void
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
function onAbilityCreateCallback(data) { function onAbilityCreateCallback(data: UIAbility) {
console.info('onAbilityCreateCallback, data: ${JSON.stringify(data)}'); console.info('onAbilityCreateCallback, data: ${JSON.stringify(data)}');
} }
let monitor = { let monitor: AbilityDelegatorRegistry.AbilityMonitor = {
abilityName: 'abilityname', abilityName: 'abilityname',
onAbilityCreate: onAbilityCreateCallback onAbilityCreate: onAbilityCreateCallback
}; };
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityMonitor(monitor, (error : any) => { abilityDelegator.addAbilityMonitor(monitor, (error: BusinessError) => {
console.error('addAbilityMonitor fail, error: ${JSON.stringify(error)}'); console.error('addAbilityMonitor fail, error: ${JSON.stringify(error)}');
}); });
``` ```
...@@ -95,17 +98,19 @@ addAbilityMonitor(monitor: AbilityMonitor): Promise\<void>; ...@@ -95,17 +98,19 @@ addAbilityMonitor(monitor: AbilityMonitor): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
function onAbilityCreateCallback(data) { function onAbilityCreateCallback(data: UIAbility) {
console.info('onAbilityCreateCallback'); console.info('onAbilityCreateCallback');
} }
let monitor = { let monitor: AbilityDelegatorRegistry.AbilityMonitor = {
abilityName: 'abilityname', abilityName: 'abilityname',
onAbilityCreate: onAbilityCreateCallback onAbilityCreate: onAbilityCreateCallback
}; };
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityMonitor(monitor).then(() => { abilityDelegator.addAbilityMonitor(monitor).then(() => {
console.info('addAbilityMonitor promise'); console.info('addAbilityMonitor promise');
...@@ -138,19 +143,23 @@ removeAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\<void>): v ...@@ -138,19 +143,23 @@ removeAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\<void>): v
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
function onAbilityCreateCallback(data) { function onAbilityCreateCallback(data: UIAbility) {
console.info('onAbilityCreateCallback'); console.info('onAbilityCreateCallback');
} }
let monitor = { let monitor: AbilityDelegatorRegistry.AbilityMonitor = {
abilityName: 'abilityname', abilityName: 'abilityname',
onAbilityCreate: onAbilityCreateCallback onAbilityCreate: onAbilityCreateCallback
}; };
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.removeAbilityMonitor(monitor, (error : any) => { abilityDelegator.removeAbilityMonitor(monitor, (error: BusinessError) => {
console.error('removeAbilityMonitor fail, error: ${JSON.stringify(error)}'); console.error('removeAbilityMonitor fail, error: ${JSON.stringify(error)}');
}); });
``` ```
...@@ -186,13 +195,16 @@ removeAbilityMonitor(monitor: AbilityMonitor): Promise\<void>; ...@@ -186,13 +195,16 @@ removeAbilityMonitor(monitor: AbilityMonitor): Promise\<void>;
- 示例 - 示例
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
function onAbilityCreateCallback(data) { function onAbilityCreateCallback(data: UIAbility) {
console.info('onAbilityCreateCallback'); console.info('onAbilityCreateCallback');
} }
let monitor = { let monitor: AbilityDelegatorRegistry.AbilityMonitor = {
abilityName: 'abilityname', abilityName: 'abilityname',
onAbilityCreate: onAbilityCreateCallback onAbilityCreate: onAbilityCreateCallback
}; };
...@@ -229,19 +241,23 @@ waitAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\<UIAbility>) ...@@ -229,19 +241,23 @@ waitAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\<UIAbility>)
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
function onAbilityCreateCallback(data) { function onAbilityCreateCallback(data: UIAbility) {
console.info('onAbilityCreateCallback'); console.info('onAbilityCreateCallback');
} }
let monitor = { let monitor: AbilityDelegatorRegistry.AbilityMonitor = {
abilityName: 'abilityname', abilityName: 'abilityname',
onAbilityCreate: onAbilityCreateCallback onAbilityCreate: onAbilityCreateCallback
}; };
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityMonitor(monitor, (error : any, data : any) => { abilityDelegator.waitAbilityMonitor(monitor, (error : BusinessError, data : UIAbility) => {
if (error) { if (error) {
console.error('waitAbilityMonitor fail, error: ${JSON.stringify(error)}'); console.error('waitAbilityMonitor fail, error: ${JSON.stringify(error)}');
} else { } else {
...@@ -277,20 +293,24 @@ waitAbilityMonitor(monitor: AbilityMonitor, timeout: number, callback: AsyncCall ...@@ -277,20 +293,24 @@ waitAbilityMonitor(monitor: AbilityMonitor, timeout: number, callback: AsyncCall
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let timeout = 100; let timeout = 100;
function onAbilityCreateCallback(data) { function onAbilityCreateCallback(data: UIAbility) {
console.info('onAbilityCreateCallback'); console.info('onAbilityCreateCallback');
} }
let monitor = { let monitor: AbilityDelegatorRegistry.AbilityMonitor = {
abilityName: 'abilityname', abilityName: 'abilityname',
onAbilityCreate: onAbilityCreateCallback onAbilityCreate: onAbilityCreateCallback
}; };
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityMonitor(monitor, timeout, (error : any, data : any) => { abilityDelegator.waitAbilityMonitor(monitor, timeout, (error : BusinessError, data : UIAbility) => {
if (error && error.code !== 0) { if (error && error.code !== 0) {
console.error('waitAbilityMonitor fail, error: ${JSON.stringify(error)}'); console.error('waitAbilityMonitor fail, error: ${JSON.stringify(error)}');
} else { } else {
...@@ -333,19 +353,22 @@ waitAbilityMonitor(monitor: AbilityMonitor, timeout?: number): Promise\<UIAbilit ...@@ -333,19 +353,22 @@ waitAbilityMonitor(monitor: AbilityMonitor, timeout?: number): Promise\<UIAbilit
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
function onAbilityCreateCallback(data) { function onAbilityCreateCallback(data: UIAbility) {
console.info('onAbilityCreateCallback'); console.info('onAbilityCreateCallback');
} }
let monitor = { let monitor: AbilityDelegatorRegistry.AbilityMonitor = {
abilityName: 'abilityname', abilityName: 'abilityname',
onAbilityCreate: onAbilityCreateCallback onAbilityCreate: onAbilityCreateCallback
}; };
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityMonitor(monitor).then((data : any) => { abilityDelegator.waitAbilityMonitor(monitor).then((data : BusinessError) => {
console.info('waitAbilityMonitor promise'); console.info('waitAbilityMonitor promise');
}); });
``` ```
...@@ -367,6 +390,8 @@ getAppContext(): Context; ...@@ -367,6 +390,8 @@ getAppContext(): Context;
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
...@@ -396,11 +421,15 @@ getAbilityState(ability: UIAbility): number; ...@@ -396,11 +421,15 @@ getAbilityState(ability: UIAbility): number;
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let ability; let ability: UIAbility;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => { abilityDelegator.getCurrentTopAbility((err : BusinessError, data : UIAbility) => {
console.info('getCurrentTopAbility callback'); console.info('getCurrentTopAbility callback');
ability = data; ability = data;
let state = abilityDelegator.getAbilityState(ability); let state = abilityDelegator.getAbilityState(ability);
...@@ -433,11 +462,15 @@ getCurrentTopAbility(callback: AsyncCallback\<UIAbility>): void; ...@@ -433,11 +462,15 @@ getCurrentTopAbility(callback: AsyncCallback\<UIAbility>): void;
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let ability; let ability: UIAbility;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => { abilityDelegator.getCurrentTopAbility((err : BusinessError, data : UIAbility) => {
console.info('getCurrentTopAbility callback'); console.info('getCurrentTopAbility callback');
ability = data; ability = data;
}); });
...@@ -468,11 +501,14 @@ getCurrentTopAbility(): Promise\<UIAbility>; ...@@ -468,11 +501,14 @@ getCurrentTopAbility(): Promise\<UIAbility>;
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let ability; let ability: UIAbility;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility().then((data : any) => { abilityDelegator.getCurrentTopAbility().then((data : UIAbility) => {
console.info('getCurrentTopAbility promise'); console.info('getCurrentTopAbility promise');
ability = data; ability = data;
}); });
...@@ -518,14 +554,18 @@ startAbility(want: Want, callback: AsyncCallback\<void>): void; ...@@ -518,14 +554,18 @@ startAbility(want: Want, callback: AsyncCallback\<void>): void;
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let want = { let want: Want = {
bundleName: 'bundleName', bundleName: 'bundleName',
abilityName: 'abilityName' abilityName: 'abilityName'
}; };
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.startAbility(want, (err : any, data : any) => { abilityDelegator.startAbility(want, (err : BusinessError, data : void) => {
console.info('startAbility callback'); console.info('startAbility callback');
}); });
``` ```
...@@ -575,14 +615,18 @@ startAbility(want: Want): Promise\<void>; ...@@ -575,14 +615,18 @@ startAbility(want: Want): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
import Want from '@ohos.app.ability.Want';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let want = { let want: Want = {
bundleName: 'bundleName', bundleName: 'bundleName',
abilityName: 'abilityName' abilityName: 'abilityName'
}; };
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.startAbility(want).then((data: any) => { abilityDelegator.startAbility(want).then((data: void) => {
console.info('startAbility promise'); console.info('startAbility promise');
}); });
``` ```
...@@ -613,14 +657,18 @@ doAbilityForeground(ability: UIAbility, callback: AsyncCallback\<void>): void; ...@@ -613,14 +657,18 @@ doAbilityForeground(ability: UIAbility, callback: AsyncCallback\<void>): void;
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let ability; let ability: UIAbility;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => { abilityDelegator.getCurrentTopAbility((err : BusinessError, data : UIAbility) => {
console.info('getCurrentTopAbility callback'); console.info('getCurrentTopAbility callback');
ability = data; ability = data;
abilityDelegator.doAbilityForeground(ability, (err : any) => { abilityDelegator.doAbilityForeground(ability, (err : BusinessError) => {
console.info("doAbilityForeground callback"); console.info("doAbilityForeground callback");
}); });
}); });
...@@ -657,11 +705,15 @@ doAbilityForeground(ability: UIAbility): Promise\<void>; ...@@ -657,11 +705,15 @@ doAbilityForeground(ability: UIAbility): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let ability; let ability: UIAbility;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => { abilityDelegator.getCurrentTopAbility((err : BusinessError, data : UIAbility) => {
console.info('getCurrentTopAbility callback'); console.info('getCurrentTopAbility callback');
ability = data; ability = data;
abilityDelegator.doAbilityForeground(ability).then(() => { abilityDelegator.doAbilityForeground(ability).then(() => {
...@@ -696,14 +748,18 @@ doAbilityBackground(ability: UIAbility, callback: AsyncCallback\<void>): void; ...@@ -696,14 +748,18 @@ doAbilityBackground(ability: UIAbility, callback: AsyncCallback\<void>): void;
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let ability; let ability: UIAbility;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => { abilityDelegator.getCurrentTopAbility((err : BusinessError, data : UIAbility) => {
console.info('getCurrentTopAbility callback'); console.info('getCurrentTopAbility callback');
ability = data; ability = data;
abilityDelegator.doAbilityBackground(ability, (err : any) => { abilityDelegator.doAbilityBackground(ability, (err : BusinessError) => {
console.info("doAbilityBackground callback"); console.info("doAbilityBackground callback");
}); });
}); });
...@@ -740,11 +796,15 @@ doAbilityBackground(ability: UIAbility): Promise\<void>; ...@@ -740,11 +796,15 @@ doAbilityBackground(ability: UIAbility): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let ability; let ability: UIAbility;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => { abilityDelegator.getCurrentTopAbility((err : BusinessError, data : UIAbility) => {
console.info('getCurrentTopAbility callback'); console.info('getCurrentTopAbility callback');
ability = data; ability = data;
abilityDelegator.doAbilityBackground(ability).then(() => { abilityDelegator.doAbilityBackground(ability).then(() => {
...@@ -770,6 +830,8 @@ printSync(msg: string): void; ...@@ -770,6 +830,8 @@ printSync(msg: string): void;
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let msg = 'msg'; let msg = 'msg';
...@@ -795,11 +857,14 @@ print(msg: string, callback: AsyncCallback\<void>): void; ...@@ -795,11 +857,14 @@ print(msg: string, callback: AsyncCallback\<void>): void;
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let msg = 'msg'; let msg = 'msg';
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.print(msg, (err : any) => { abilityDelegator.print(msg, (err : BusinessError) => {
console.info('print callback'); console.info('print callback');
}); });
``` ```
...@@ -827,6 +892,8 @@ print(msg: string): Promise\<void>; ...@@ -827,6 +892,8 @@ print(msg: string): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let msg = 'msg'; let msg = 'msg';
...@@ -856,11 +923,14 @@ executeShellCommand(cmd: string, callback: AsyncCallback\<ShellCmdResult>): void ...@@ -856,11 +923,14 @@ executeShellCommand(cmd: string, callback: AsyncCallback\<ShellCmdResult>): void
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let cmd = 'cmd'; let cmd = 'cmd';
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.executeShellCommand(cmd, (err : any, data : any) => { abilityDelegator.executeShellCommand(cmd, (err : BusinessError, data: AbilityDelegatorRegistry.ShellCmdResult) => {
console.info('executeShellCommand callback'); console.info('executeShellCommand callback');
}); });
``` ```
...@@ -886,12 +956,15 @@ executeShellCommand(cmd: string, timeoutSecs: number, callback: AsyncCallback\<S ...@@ -886,12 +956,15 @@ executeShellCommand(cmd: string, timeoutSecs: number, callback: AsyncCallback\<S
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let cmd = 'cmd'; let cmd = 'cmd';
let timeout = 100; let timeout = 100;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.executeShellCommand(cmd, timeout, (err : any, data : any) => { abilityDelegator.executeShellCommand(cmd, timeout, (err : BusinessError, data: AbilityDelegatorRegistry.ShellCmdResult) => {
console.info('executeShellCommand callback'); console.info('executeShellCommand callback');
}); });
``` ```
...@@ -922,12 +995,14 @@ executeShellCommand(cmd: string, timeoutSecs?: number): Promise\<ShellCmdResult> ...@@ -922,12 +995,14 @@ executeShellCommand(cmd: string, timeoutSecs?: number): Promise\<ShellCmdResult>
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let cmd = 'cmd'; let cmd = 'cmd';
let timeout = 100; let timeout = 100;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.executeShellCommand(cmd, timeout).then((data : any) => { abilityDelegator.executeShellCommand(cmd, timeout).then((data) => {
console.info('executeShellCommand promise'); console.info('executeShellCommand promise');
}); });
``` ```
...@@ -959,11 +1034,14 @@ finishTest(msg: string, code: number, callback: AsyncCallback\<void>): void; ...@@ -959,11 +1034,14 @@ finishTest(msg: string, code: number, callback: AsyncCallback\<void>): void;
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let msg = 'msg'; let msg = 'msg';
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.finishTest(msg, 0, (err : any) => { abilityDelegator.finishTest(msg, 0, (err : BusinessError) => {
console.info('finishTest callback'); console.info('finishTest callback');
}); });
``` ```
...@@ -1000,6 +1078,8 @@ finishTest(msg: string, code: number): Promise\<void>; ...@@ -1000,6 +1078,8 @@ finishTest(msg: string, code: number): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let msg = 'msg'; let msg = 'msg';
...@@ -1035,15 +1115,16 @@ addAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\<vo ...@@ -1035,15 +1115,16 @@ addAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\<vo
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let monitor = { abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityStageMonitor({
moduleName: 'moduleName', moduleName: 'moduleName',
srcEntrance: 'srcEntrance', srcEntrance: 'srcEntrance',
}; }, (err : BusinessError) => {
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityStageMonitor(monitor, (err : any) => {
console.info('addAbilityStageMonitor callback'); console.info('addAbilityStageMonitor callback');
}); });
``` ```
...@@ -1079,15 +1160,15 @@ addAbilityStageMonitor(monitor: AbilityStageMonitor): Promise\<void>; ...@@ -1079,15 +1160,15 @@ addAbilityStageMonitor(monitor: AbilityStageMonitor): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let monitor = { abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityStageMonitor({
moduleName: 'moduleName', moduleName: 'moduleName',
srcEntrance: 'srcEntrance', srcEntrance: 'srcEntrance',
}; }).then(() => {
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityStageMonitor(monitor).then(() => {
console.info('addAbilityStageMonitor promise'); console.info('addAbilityStageMonitor promise');
}); });
``` ```
...@@ -1118,15 +1199,16 @@ removeAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\ ...@@ -1118,15 +1199,16 @@ removeAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let monitor = { abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.removeAbilityStageMonitor({
moduleName: 'moduleName', moduleName: 'moduleName',
srcEntrance: 'srcEntrance', srcEntrance: 'srcEntrance',
}; }, (err : BusinessError) => {
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.removeAbilityStageMonitor(monitor, (err : any) => {
console.info('removeAbilityStageMonitor callback'); console.info('removeAbilityStageMonitor callback');
}); });
``` ```
...@@ -1162,15 +1244,15 @@ removeAbilityStageMonitor(monitor: AbilityStageMonitor): Promise\<void>; ...@@ -1162,15 +1244,15 @@ removeAbilityStageMonitor(monitor: AbilityStageMonitor): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let monitor = { abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.removeAbilityStageMonitor({
moduleName: 'moduleName', moduleName: 'moduleName',
srcEntrance: 'srcEntrance', srcEntrance: 'srcEntrance',
}; }).then(() => {
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.removeAbilityStageMonitor(monitor).then(() => {
console.info('removeAbilityStageMonitor promise'); console.info('removeAbilityStageMonitor promise');
}); });
``` ```
...@@ -1201,19 +1283,16 @@ waitAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\<A ...@@ -1201,19 +1283,16 @@ waitAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\<A
**示例:** **示例:**
```ts ```ts
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import AbilityStage from '@ohos.app.ability.AbilityStage';
function onAbilityCreateCallback(data) { let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
console.info('onAbilityCreateCallback');
}
let monitor = { abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityStageMonitor({
moduleName: 'moduleName', moduleName: 'moduleName',
srcEntrance: 'srcEntrance', srcEntrance: 'srcEntrance',
}; }, (err : BusinessError, data : AbilityStage) => {
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityStageMonitor(monitor, (err : any, data : any) => {
console.info('waitAbilityStageMonitor callback'); console.info('waitAbilityStageMonitor callback');
}); });
``` ```
...@@ -1250,19 +1329,16 @@ waitAbilityStageMonitor(monitor: AbilityStageMonitor, timeout?: number): Promise ...@@ -1250,19 +1329,16 @@ waitAbilityStageMonitor(monitor: AbilityStageMonitor, timeout?: number): Promise
**示例:** **示例:**
```ts ```ts
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import AbilityStage from '@ohos.app.ability.AbilityStage';
function onAbilityCreateCallback(data) { let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
console.info('onAbilityCreateCallback');
}
let monitor = { abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityStageMonitor({
moduleName: 'moduleName', moduleName: 'moduleName',
srcEntrance: 'srcEntrance', srcEntrance: 'srcEntrance',
}; }).then((data : AbilityStage) => {
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityStageMonitor(monitor).then((data : any) => {
console.info('waitAbilityStageMonitor promise'); console.info('waitAbilityStageMonitor promise');
}); });
``` ```
...@@ -1294,20 +1370,18 @@ waitAbilityStageMonitor(monitor: AbilityStageMonitor, timeout: number, callback: ...@@ -1294,20 +1370,18 @@ waitAbilityStageMonitor(monitor: AbilityStageMonitor, timeout: number, callback:
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import AbilityStage from '@ohos.app.ability.AbilityStage';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let timeout = 100; let timeout = 100;
function onAbilityCreateCallback(data) { abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
console.info('onAbilityCreateCallback'); abilityDelegator.waitAbilityStageMonitor({
}
let monitor = {
moduleName: 'moduleName', moduleName: 'moduleName',
srcEntrance: 'srcEntrance', srcEntrance: 'srcEntrance',
}; }, timeout, (err : BusinessError, data : AbilityStage) => {
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityStageMonitor(monitor, timeout, (err : any, data : any) => {
console.info('waitAbilityStageMonitor callback'); console.info('waitAbilityStageMonitor callback');
}); });
``` ```
\ No newline at end of file
...@@ -38,19 +38,21 @@ Ability监听器 ...@@ -38,19 +38,21 @@ Ability监听器
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
function onAbilityCreateCallback(data) { function onAbilityCreateCallback(data: UIAbility) {
console.info('onAbilityCreateCallback, data: ${JSON.stringify(data)}'); console.info('onAbilityCreateCallback, data: ${JSON.stringify(data)}');
} }
let monitor = { let monitor: AbilityDelegatorRegistry.AbilityMonitor = {
abilityName: 'abilityname', abilityName: 'abilityname',
moduleName: "moduleName", moduleName: "moduleName",
onAbilityCreate: onAbilityCreateCallback onAbilityCreate: onAbilityCreateCallback
}; }
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityMonitor(monitor, (error : any) => { abilityDelegator.addAbilityMonitor(monitor, (error : BusinessError) => {
if (error) { if (error) {
console.error('addAbilityMonitor fail, error: ${JSON.stringify(error)}'); console.error('addAbilityMonitor fail, error: ${JSON.stringify(error)}');
} }
......
...@@ -19,13 +19,11 @@ ...@@ -19,13 +19,11 @@
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
let monitor = { let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityStageMonitor({
moduleName: 'feature_as1', moduleName: 'feature_as1',
srcEntrance: './ets/Application/MyAbilityStage.ts', srcEntrance: './ets/Application/MyAbilityStage.ts',
}; }, (error, data) => {
let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityStageMonitor(monitor, (error, data) => {
if (error) { if (error) {
console.error('waitAbilityStageMonitor fail, error: ${JSON.stringify(error)}'); console.error('waitAbilityStageMonitor fail, error: ${JSON.stringify(error)}');
} else { } else {
......
...@@ -18,6 +18,8 @@ import common from '@ohos.app.ability.common'; ...@@ -18,6 +18,8 @@ import common from '@ohos.app.ability.common';
在使用ApplicationContext的功能前,需要通过context的实例获取。 在使用ApplicationContext的功能前,需要通过context的实例获取。
```ts ```ts
import common from '@ohos.app.ability.common';
let applicationContext: common.ApplicationContext = this.context.getApplicationContext(); let applicationContext: common.ApplicationContext = this.context.getApplicationContext();
``` ```
...@@ -46,13 +48,14 @@ on(type: 'abilityLifecycle', callback: AbilityLifecycleCallback): **number**; ...@@ -46,13 +48,14 @@ on(type: 'abilityLifecycle', callback: AbilityLifecycleCallback): **number**;
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let lifecycleId; let lifecycleId: number;
export default class EntryAbility extends UIAbility { export default class EntryAbility extends UIAbility {
onCreate() { onCreate() {
console.log('MyAbility onCreate'); console.log('MyAbility onCreate');
let AbilityLifecycleCallback = { let AbilityLifecycleCallback: AbilityLifecycleCallback = {
onAbilityCreate(ability) { onAbilityCreate(ability) {
console.log('AbilityLifecycleCallback onAbilityCreate ability: ${ability}'); console.log('AbilityLifecycleCallback onAbilityCreate ability: ${ability}');
}, },
...@@ -115,7 +118,7 @@ off(type: 'abilityLifecycle', callbackId: **number**, callback: AsyncCallback<* ...@@ -115,7 +118,7 @@ off(type: 'abilityLifecycle', callbackId: **number**, callback: AsyncCallback<*
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
let lifecycleId; let lifecycleId: number;
export default class EntryAbility extends UIAbility { export default class EntryAbility extends UIAbility {
onDestroy() { onDestroy() {
...@@ -152,7 +155,7 @@ off(type: 'abilityLifecycle', callbackId: number): Promise\<void>; ...@@ -152,7 +155,7 @@ off(type: 'abilityLifecycle', callbackId: number): Promise\<void>;
```ts ```ts
import Ability from '@ohos.app.ability.UIAbility'; import Ability from '@ohos.app.ability.UIAbility';
let lifecycleId; let lifecycleId: number;
export default class MyAbility extends Ability { export default class MyAbility extends Ability {
onDestroy() { onDestroy() {
...@@ -188,26 +191,26 @@ on(type: 'environment', callback: EnvironmentCallback): **number**; ...@@ -188,26 +191,26 @@ on(type: 'environment', callback: EnvironmentCallback): **number**;
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import EnvironmentCallback from '@ohos.app.ability.EnvironmentCallback';
let callbackId; let callbackId: number;
export default class EntryAbility extends UIAbility { export default class EntryAbility extends UIAbility {
onCreate() { onCreate() {
console.log('MyAbility onCreate') console.log('MyAbility onCreate')
globalThis.applicationContext = this.context.getApplicationContext(); let environmentCallback: EnvironmentCallback = {
let environmentCallback = {
onConfigurationUpdated(config){ onConfigurationUpdated(config){
console.log('onConfigurationUpdated config: ${JSON.stringify(config)}'); console.log(`onConfigurationUpdated config: ${JSON.stringify(config)}`);
}, },
onMemoryLevel(level){ onMemoryLevel(level){
console.log('onMemoryLevel level: ${level}'); console.log('onMemoryLevel level: ${level}');
} }
}; };
// 1.获取applicationContext // 1.获取applicationContext
let applicationContext = globalThis.applicationContext; let applicationContext = this.context.getApplicationContext();
// 2.通过applicationContext注册监听系统环境变化 // 2.通过applicationContext注册监听系统环境变化
callbackId = applicationContext.on('environment', environmentCallback); callbackId = applicationContext.on('environment', environmentCallback);
console.log('registerEnvironmentCallback callbackId: ${callbackId}'); console.log(`registerEnvironmentCallback callbackId: ${callbackId}`);
} }
} }
``` ```
...@@ -233,7 +236,7 @@ off(type: 'environment', callbackId: **number**, callback: AsyncCallback<**void ...@@ -233,7 +236,7 @@ off(type: 'environment', callbackId: **number**, callback: AsyncCallback<**void
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
let callbackId; let callbackId: number;
export default class EntryAbility extends UIAbility { export default class EntryAbility extends UIAbility {
onDestroy() { onDestroy() {
...@@ -269,7 +272,7 @@ off(type: 'environment', callbackId: **number**, callback: AsyncCallback<**void ...@@ -269,7 +272,7 @@ off(type: 'environment', callbackId: **number**, callback: AsyncCallback<**void
```ts ```ts
import Ability from '@ohos.app.ability.UIAbility'; import Ability from '@ohos.app.ability.UIAbility';
let callbackId; let callbackId: number;
export default class MyAbility extends Ability { export default class MyAbility extends Ability {
onDestroy() { onDestroy() {
...@@ -298,11 +301,12 @@ on(type: 'applicationStateChange', callback: ApplicationStateChangeCallback): ** ...@@ -298,11 +301,12 @@ on(type: 'applicationStateChange', callback: ApplicationStateChangeCallback): **
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import ApplicationStateChangeCallback from '@ohos.app.ability.ApplicationStateChangeCallback';
export default class MyAbility extends UIAbility { export default class MyAbility extends UIAbility {
onCreate() { onCreate() {
console.log('MyAbility onCreate'); console.log('MyAbility onCreate');
globalThis.applicationStateChangeCallback = { let applicationStateChangeCallback: ApplicationStateChangeCallback = {
onApplicationForeground() { onApplicationForeground() {
console.info('applicationStateChangeCallback onApplicationForeground'); console.info('applicationStateChangeCallback onApplicationForeground');
}, },
...@@ -311,11 +315,10 @@ export default class MyAbility extends UIAbility { ...@@ -311,11 +315,10 @@ export default class MyAbility extends UIAbility {
} }
} }
globalThis.applicationContext = this.context.getApplicationContext();
// 1.获取applicationContext // 1.获取applicationContext
let applicationContext = globalThis.applicationContext; let applicationContext = this.context.getApplicationContext();
// 2.通过applicationContext注册应用前后台状态监听 // 2.通过applicationContext注册应用前后台状态监听
applicationContext.on('applicationStateChange', globalThis.ApplicationStateChangeCallback); applicationContext.on('applicationStateChange', applicationStateChangeCallback);
console.log('Resgiter applicationStateChangeCallback'); console.log('Resgiter applicationStateChangeCallback');
} }
} }
...@@ -375,11 +378,19 @@ getRunningProcessInformation(): Promise\<Array\<ProcessInformation>>; ...@@ -375,11 +378,19 @@ getRunningProcessInformation(): Promise\<Array\<ProcessInformation>>;
**示例:** **示例:**
```ts ```ts
applicationContext.getRunningProcessInformation().then((data) => { import UIAbility from '@ohos.app.ability.UIAbility';
console.log('The process running information is: ${JSON.stringify(data)}'); import { BusinessError } from '@ohos.base';
}).catch((error) => {
console.error('error: ${JSON.stringify(error)}'); export default class MyAbility extends UIAbility {
}); onForeground() {
let applicationContext = this.context.getApplicationContext();
applicationContext.getRunningProcessInformation().then((data) => {
console.log('The process running information is: ${JSON.stringify(data)}');
}).catch((error: BusinessError) => {
console.error('error: ${JSON.stringify(error)}');
});
}
}
``` ```
## ApplicationContext.getRunningProcessInformation<sup>9+</sup> ## ApplicationContext.getRunningProcessInformation<sup>9+</sup>
...@@ -408,13 +419,20 @@ getRunningProcessInformation(callback: AsyncCallback\<Array\<ProcessInformation> ...@@ -408,13 +419,20 @@ getRunningProcessInformation(callback: AsyncCallback\<Array\<ProcessInformation>
**示例:** **示例:**
```ts ```ts
applicationContext.getRunningProcessInformation((err, data) => { import UIAbility from '@ohos.app.ability.UIAbility';
if (err) {
console.error('getRunningProcessInformation faile, err: ${JSON.stringify(err)}'); export default class MyAbility extends UIAbility {
} else { onForeground() {
console.log('The process running information is: ${JSON.stringify(data)}'); let applicationContext = this.context.getApplicationContext();
applicationContext.getRunningProcessInformation((err, data) => {
if (err) {
console.error('getRunningProcessInformation faile, err: ${JSON.stringify(err)}');
} else {
console.log('The process running information is: ${JSON.stringify(data)}');
}
})
} }
}) }
``` ```
## ApplicationContext.killAllProcesses<sup>9+</sup> ## ApplicationContext.killAllProcesses<sup>9+</sup>
...@@ -442,7 +460,14 @@ killAllProcesses(): Promise\<void\>; ...@@ -442,7 +460,14 @@ killAllProcesses(): Promise\<void\>;
**示例:** **示例:**
```ts ```ts
applicationContext.killAllProcesses(); import UIAbility from '@ohos.app.ability.UIAbility';
export default class MyAbility extends UIAbility {
onBackground() {
let applicationContext = this.context.getApplicationContext();
applicationContext.killAllProcesses();
}
}
``` ```
## ApplicationContext.killAllProcesses<sup>9+</sup> ## ApplicationContext.killAllProcesses<sup>9+</sup>
...@@ -470,9 +495,16 @@ killAllProcesses(callback: AsyncCallback\<void\>); ...@@ -470,9 +495,16 @@ killAllProcesses(callback: AsyncCallback\<void\>);
**示例:** **示例:**
```ts ```ts
applicationContext.killAllProcesses(error => { import UIAbility from '@ohos.app.ability.UIAbility';
if (error) {
console.error('killAllProcesses fail, error: ${JSON.stringify(error)}'); export default class MyAbility extends UIAbility {
onBackground() {
let applicationContext = this.context.getApplicationContext();
applicationContext.killAllProcesses(error => {
if (error) {
console.error('killAllProcesses fail, error: ${JSON.stringify(error)}');
}
});
} }
}); }
``` ```
\ No newline at end of file
...@@ -28,7 +28,9 @@ import appManager from '@ohos.app.ability.appManager'; ...@@ -28,7 +28,9 @@ import appManager from '@ohos.app.ability.appManager';
**示例:** **示例:**
```ts ```ts
let applicationStateObserver = { import appManager from '@ohos.app.ability.appManager';
let applicationStateObserver: appManager.ApplicationStateObserver = {
onForegroundApplicationChanged(appStateData) { onForegroundApplicationChanged(appStateData) {
console.log('onForegroundApplicationChanged appStateData: ${JSON.stringify(appStateData)}'); console.log('onForegroundApplicationChanged appStateData: ${JSON.stringify(appStateData)}');
}, },
......
...@@ -26,9 +26,11 @@ import common from '@ohos.app.ability.common'; ...@@ -26,9 +26,11 @@ import common from '@ohos.app.ability.common';
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import Want from '@ohos.app.ability.Want';
class EntryAbility extends UIAbility { class EntryAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
// EntryAbility onCreate, isStageMode: true // EntryAbility onCreate, isStageMode: true
console.log('EntryAbility onCreate, isStageMode: ${this.context.stageMode}'); console.log('EntryAbility onCreate, isStageMode: ${this.context.stageMode}');
} }
......
...@@ -58,6 +58,8 @@ createBundleContext(bundleName: string): Context; ...@@ -58,6 +58,8 @@ createBundleContext(bundleName: string): Context;
**示例:** **示例:**
```ts ```ts
import common from '@ohos.app.ability.common';
let bundleContext: common.Context; let bundleContext: common.Context;
try { try {
bundleContext = this.context.createBundleContext('com.example.test'); bundleContext = this.context.createBundleContext('com.example.test');
...@@ -89,6 +91,8 @@ createModuleContext(moduleName: string): Context; ...@@ -89,6 +91,8 @@ createModuleContext(moduleName: string): Context;
**示例:** **示例:**
```ts ```ts
import common from '@ohos.app.ability.common';
let moduleContext: common.Context; let moduleContext: common.Context;
try { try {
moduleContext = this.context.createModuleContext('entry'); moduleContext = this.context.createModuleContext('entry');
...@@ -123,6 +127,8 @@ createModuleContext(bundleName: string, moduleName: string): Context; ...@@ -123,6 +127,8 @@ createModuleContext(bundleName: string, moduleName: string): Context;
**示例:** **示例:**
```ts ```ts
import common from '@ohos.app.ability.common';
let moduleContext: common.Context; let moduleContext: common.Context;
try { try {
moduleContext = this.context.createModuleContext('com.example.test', 'entry'); moduleContext = this.context.createModuleContext('com.example.test', 'entry');
...@@ -148,6 +154,8 @@ getApplicationContext(): ApplicationContext; ...@@ -148,6 +154,8 @@ getApplicationContext(): ApplicationContext;
**示例:** **示例:**
```ts ```ts
import common from '@ohos.app.ability.common';
let applicationContext: common.Context; let applicationContext: common.Context;
try { try {
applicationContext = this.context.getApplicationContext(); applicationContext = this.context.getApplicationContext();
...@@ -187,8 +195,10 @@ getGroupDir(dataGroupID: string): Promise\<string>; ...@@ -187,8 +195,10 @@ getGroupDir(dataGroupID: string): Promise\<string>;
**示例:** **示例:**
```ts ```ts
import common from '@ohos.app.ability.common';
let groupId = "1"; let groupId = "1";
let getGroupDirContext: common.Context; let getGroupDirContext: common.Context = this.context;
try { try {
getGroupDirContext.getGroupDir(groupId).then(data => { getGroupDirContext.getGroupDir(groupId).then(data => {
console.log("getGroupDir result:" + data); console.log("getGroupDir result:" + data);
...@@ -224,7 +234,9 @@ getGroupDir(dataGroupID: string, callback: AsyncCallback\<string>): void; ...@@ -224,7 +234,9 @@ getGroupDir(dataGroupID: string, callback: AsyncCallback\<string>): void;
**示例:** **示例:**
```ts ```ts
let getGroupDirContext: common.Context; import common from '@ohos.app.ability.common';
let getGroupDirContext: common.Context = this.context;
getGroupDirContext.getGroupDir("1", (err, data) => { getGroupDirContext.getGroupDir("1", (err, data) => {
if (err) { if (err) {
......
...@@ -31,7 +31,7 @@ onUnhandledException(errMsg: string): void; ...@@ -31,7 +31,7 @@ onUnhandledException(errMsg: string): void;
```ts ```ts
import errorManager from '@ohos.app.ability.errorManager'; import errorManager from '@ohos.app.ability.errorManager';
let observer = { let observer: errorManager.ErrorObserver = {
onUnhandledException(errorMsg) { onUnhandledException(errorMsg) {
console.error('onUnhandledException, errorMsg: ', errorMsg); console.error('onUnhandledException, errorMsg: ', errorMsg);
} }
...@@ -63,7 +63,7 @@ onException?(errObject: Error): void; ...@@ -63,7 +63,7 @@ onException?(errObject: Error): void;
```ts ```ts
import errorManager from '@ohos.app.ability.errorManager'; import errorManager from '@ohos.app.ability.errorManager';
let observer = { let observer: errorManager.ErrorObserver = {
onUnhandledException(errorMsg) { onUnhandledException(errorMsg) {
console.error('onUnhandledException, errorMsg: ', errorMsg); console.error('onUnhandledException, errorMsg: ', errorMsg);
}, },
......
...@@ -145,7 +145,7 @@ export default class EntryAbility extends UIAbility { ...@@ -145,7 +145,7 @@ export default class EntryAbility extends UIAbility {
this.context.eventHub.emit('myEvent', 1, 2); this.context.eventHub.emit('myEvent', 1, 2);
} }
eventFunc(argOne, argTwo) { eventFunc(argOne: number, argTwo: number) {
console.log(`eventFunc is called, ${argOne}, ${argTwo}`); console.log(`eventFunc is called, ${argOne}, ${argTwo}`);
} }
} }
......
...@@ -39,24 +39,46 @@ ExtensionContext主要用于查询所属Extension的信息、Module的配置信 ...@@ -39,24 +39,46 @@ ExtensionContext主要用于查询所属Extension的信息、Module的配置信
```ts ```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility'; import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want'; import Want from '@ohos.app.ability.Want';
import rpc from '@ohos.rpc';
export class GlobalContext {
private constructor() {}
private static instance: GlobalContext;
private _objects = new Map<string, Object>();
public static getContext(): GlobalContext {
if (!GlobalContext.instance) {
GlobalContext.instance = new GlobalContext();
}
return GlobalContext.instance;
}
getObject(value: string): Object | undefined {
return this._objects.get(value);
}
setObject(key: string, objectClass: Object): void {
this._objects.set(key, objectClass);
}
}
export default class TheServiceExtension extends ServiceExtension { export default class TheServiceExtension extends ServiceExtension {
onCreate(want:Want) { onCreate(want: Want) {
console.log('ServiceAbility onCreate, want: ${want.abilityName}'); console.log('ServiceAbility onCreate, want: ${want.abilityName}');
// 通过globalThis传递ExtensionContext给entry GlobalContext.getContext().setObject("ExtensionContext", this.context);
globalThis.ExtensionContext = this.context;
} }
onRequest(want, startId) { onRequest(want: Want, startId: number) {
console.log('ServiceAbility onRequest, want: ${want.abilityName}, startId: ${startId}'); console.log('ServiceAbility onRequest, want: ${want.abilityName}, startId: ${startId}');
} }
onConnect(want) { onConnect(want: Want) {
console.log('ServiceAbility onConnect, want: ${want.abilityName}'); console.log('ServiceAbility onConnect, want: ${want.abilityName}');
return null; let remoteObject = new rpc.RemoteObject("test");
return remoteObject;
} }
onDisconnect(want) { onDisconnect(want: Want) {
console.log('ServiceAbility onDisconnect, want: ${want.abilityName}'); console.log('ServiceAbility onDisconnect, want: ${want.abilityName}');
} }
...@@ -69,11 +91,13 @@ export default class TheServiceExtension extends ServiceExtension { ...@@ -69,11 +91,13 @@ export default class TheServiceExtension extends ServiceExtension {
在entry的MainAbility的onCreate回调内启动ServiceExtension 在entry的MainAbility的onCreate回调内启动ServiceExtension
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import Want from '@ohos.app.ability.Want';
export default class EntryAbility extends UIAbility { export default class EntryAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
console.log('[Demo] EntryAbility onCreate'); console.log('[Demo] EntryAbility onCreate');
let wantExt = { let wantExt: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.TheServiceExtension', bundleName: 'com.example.TheServiceExtension',
abilityName: 'TheServiceExtension', abilityName: 'TheServiceExtension',
...@@ -85,19 +109,20 @@ export default class EntryAbility extends UIAbility { ...@@ -85,19 +109,20 @@ export default class EntryAbility extends UIAbility {
在entry内新建一个ServiceModule.ts,专用于执行业务逻辑 在entry内新建一个ServiceModule.ts,专用于执行业务逻辑
```ts ```ts
import { GlobalContext } from '../TheServiceExtension'
export default class ServiceModel { export default class ServiceModel {
moduleName: string; moduleName: string = '';
constructor() {} constructor() {}
executeTask() { executeTask() {
if (globalThis.ExtensionContext === undefined) { if (GlobalContext.getContext().getObject('ExtensionContext') === undefined) {
console.log('ERROR, ServiceExtension does not exist'); console.log('ERROR, ServiceExtension does not exist');
return; return;
} }
let moduleInfo = globalThis.ExtensionContext.currentHapModuleInfo; this.moduleName = GlobalContext.getContext().getObject('ExtensionContext').currentHapModuleInfo.name;
this.moduleName = moduleInfo.name;
// 根据moduleName执行不同的业务逻辑,实现对不同性能设备的区分 // 根据moduleName执行不同的业务逻辑,实现对不同性能设备的区分
switch (this.moduleName) { switch (this.moduleName) {
case 'highPerformance': case 'highPerformance':
......
...@@ -18,21 +18,21 @@ ...@@ -18,21 +18,21 @@
```ts ```ts
import distributedMissionManager from '@ohos.distributedMissionManager'; import distributedMissionManager from '@ohos.distributedMissionManager';
let missionDeviceInfo = { distributedMissionManager.registerMissionListener(
deviceId: '123456' {
}; deviceId: '123456'
let missionCallback = {
notifyMissionsChanged: function (deviceId) {
console.log('notifyMissionsChanged deviceId: ${JSON.stringify(deviceId)}');
}, },
notifySnapshot: function (deviceId, mission) { {
console.log('notifySnapshot deviceId: ${JSON.stringify(deviceId)}'); notifyMissionsChanged: (deviceId) => {
console.log('notifySnapshot mission: ${JSON.stringify(mission)}'); console.log('notifyMissionsChanged deviceId: ${JSON.stringify(deviceId)}');
}, },
notifyNetDisconnect: function (deviceId, state) { notifySnapshot: (deviceId, mission) => {
console.log('notifyNetDisconnect deviceId: ${JSON.stringify(deviceId)}'); console.log('notifySnapshot deviceId: ${JSON.stringify(deviceId)}');
console.log('notifyNetDisconnect state: ${JSON.stringify(state)}'); console.log('notifySnapshot mission: ${JSON.stringify(mission)}');
} },
}; notifyNetDisconnect: (deviceId, state) => {
distributedMissionManager.registerMissionListener(missionDeviceInfo, missionCallback); console.log('notifyNetDisconnect deviceId: ${JSON.stringify(deviceId)}');
console.log('notifyNetDisconnect state: ${JSON.stringify(state)}');
}
});
``` ```
\ No newline at end of file
...@@ -12,21 +12,21 @@ ...@@ -12,21 +12,21 @@
```ts ```ts
import distributedMissionManager from '@ohos.distributedMissionManager'; import distributedMissionManager from '@ohos.distributedMissionManager';
let missionDeviceInfo = { distributedMissionManager.registerMissionListener(
deviceId: '123456' {
}; deviceId: '123456'
let missionCallback = {
notifyMissionsChanged: function (deviceId) {
console.log('notifyMissionsChanged deviceId: ${JSON.stringify(deviceId)}');
}, },
notifySnapshot: function (mission, deviceId) { {
console.log('notifySnapshot mission: ${JSON.stringify(mission)}'); notifyMissionsChanged: (deviceId) => {
console.log('notifySnapshot deviceId: ${JSON.stringify(deviceId)}'); console.log('notifyMissionsChanged deviceId: ${JSON.stringify(deviceId)}');
}, },
notifyNetDisconnect: function (mission, state) { notifySnapshot: (mission, deviceId) => {
console.log('notifyNetDisconnect mission: ${JSON.stringify(mission)}'); console.log('notifySnapshot mission: ${JSON.stringify(mission)}');
console.log('notifyNetDisconnect state: ${JSON.stringify(state)}'); console.log('notifySnapshot deviceId: ${JSON.stringify(deviceId)}');
} },
}; notifyNetDisconnect: (mission, state) => {
distributedMissionManager.registerMissionListener(missionDeviceInfo, missionCallback); console.log('notifyNetDisconnect mission: ${JSON.stringify(mission)}');
console.log('notifyNetDisconnect state: ${JSON.stringify(state)}');
}
});
``` ```
\ No newline at end of file
...@@ -32,27 +32,27 @@ import missionManager from '@ohos.app.ability.missionManager'; ...@@ -32,27 +32,27 @@ import missionManager from '@ohos.app.ability.missionManager';
```ts ```ts
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
let listener = { let listener: missionManager.MissionListener = {
onMissionCreated: function (mission) { onMissionCreated: (mission) => {
console.log('onMissionCreated mission: ${JSON.stringify(mission)}'); console.log('onMissionCreated mission: ${JSON.stringify(mission)}');
}, },
onMissionDestroyed: function (mission) { onMissionDestroyed: (mission) => {
console.log('onMissionDestroyed mission: ${JSON.stringify(mission)}'); console.log('onMissionDestroyed mission: ${JSON.stringify(mission)}');
}, },
onMissionSnapshotChanged: function (mission) { onMissionSnapshotChanged: (mission) => {
console.log('onMissionSnapshotChanged mission: ${JSON.stringify(mission)}'); console.log('onMissionSnapshotChanged mission: ${JSON.stringify(mission)}');
}, },
onMissionMovedToFront: function (mission) { onMissionMovedToFront: (mission) => {
console.log('onMissionMovedToFront mission: ${JSON.stringify(mission)}'); console.log('onMissionMovedToFront mission: ${JSON.stringify(mission)}');
}, },
onMissionLabelUpdated: function (mission) { onMissionLabelUpdated: (mission) => {
console.log('onMissionLabelUpdated mission: ' + JSON.stringify(mission)); console.log('onMissionLabelUpdated mission: ' + JSON.stringify(mission));
}, },
onMissionIconUpdated: function (mission, icon) { onMissionIconUpdated: (mission, icon) => {
console.log('onMissionIconUpdated mission: ' + JSON.stringify(mission)); console.log('onMissionIconUpdated mission: ' + JSON.stringify(mission));
console.log('onMissionIconUpdated icon: ' + JSON.stringify(icon)); console.log('onMissionIconUpdated icon: ' + JSON.stringify(icon));
}, },
onMissionClosed: function (mission) { onMissionClosed: (mission) => {
console.log('onMissionClosed mission: ${JSON.stringify(mission)}'); console.log('onMissionClosed mission: ${JSON.stringify(mission)}');
} }
}; };
......
...@@ -18,13 +18,13 @@ ...@@ -18,13 +18,13 @@
```ts ```ts
import distributedMissionManager from '@ohos.distributedMissionManager'; import distributedMissionManager from '@ohos.distributedMissionManager';
let missionParameter = {
deviceId: '123456',
fixConflict: true,
tag: 123
};
try { try {
distributedMissionManager.startSyncRemoteMissions(missionParameter, distributedMissionManager.startSyncRemoteMissions(
{
deviceId: '123456',
fixConflict: true,
tag: 123
},
(error, data) => { (error, data) => {
if (error && error.code !== 0) { if (error && error.code !== 0) {
console.error('startSyncRemoteMissions fail, error: ${JSON.stringify(error)}'); console.error('startSyncRemoteMissions fail, error: ${JSON.stringify(error)}');
......
...@@ -31,7 +31,7 @@ import appManager from '@ohos.application.appManager'; ...@@ -31,7 +31,7 @@ import appManager from '@ohos.application.appManager';
```ts ```ts
import appManager from '@ohos.application.appManager'; import appManager from '@ohos.application.appManager';
let applicationStateObserver = { let observerCode = appManager.registerApplicationStateObserver({
onForegroundApplicationChanged(appStateData) { onForegroundApplicationChanged(appStateData) {
console.log('onForegroundApplicationChanged appStateData: ${JSON.stringify(appStateData)}'); console.log('onForegroundApplicationChanged appStateData: ${JSON.stringify(appStateData)}');
}, },
...@@ -51,6 +51,5 @@ let applicationStateObserver = { ...@@ -51,6 +51,5 @@ let applicationStateObserver = {
console.log('onProcessStateChanged processData.isContinuousTask : ${JSON.stringify(processData.isContinuousTask)}'); console.log('onProcessStateChanged processData.isContinuousTask : ${JSON.stringify(processData.isContinuousTask)}');
console.log('onProcessStateChanged processData.isKeepAlive : ${JSON.stringify(processData.isKeepAlive)}'); console.log('onProcessStateChanged processData.isKeepAlive : ${JSON.stringify(processData.isKeepAlive)}');
} }
}; });
let observerCode = appManager.registerApplicationStateObserver(applicationStateObserver);
``` ```
\ No newline at end of file
...@@ -9,7 +9,7 @@ ...@@ -9,7 +9,7 @@
## 导入模块 ## 导入模块
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.application.appManager';
``` ```
## 属性 ## 属性
...@@ -29,11 +29,12 @@ import appManager from '@ohos.app.ability.appManager'; ...@@ -29,11 +29,12 @@ import appManager from '@ohos.app.ability.appManager';
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
appManager.getProcessRunningInfos().then((data) => { appManager.getProcessRunningInfos().then((data) => {
console.log('success: ${JSON.stringify(data)}'); console.log('success: ${JSON.stringify(data)}');
}).catch((error) => { }).catch((error: BusinessError) => {
console.error('failed: ${JSON.stringify(error)}'); console.error('failed: ${JSON.stringify(error)}');
}); });
``` ```
...@@ -21,12 +21,12 @@ import common from '@ohos.app.ability.common'; ...@@ -21,12 +21,12 @@ import common from '@ohos.app.ability.common';
```ts ```ts
import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility'; import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility';
import rpc from '@ohos.rpc';
let context; let commRemote: rpc.IRemoteObject; // 断开连接时需要释放
let commRemote; // 断开连接时需要释放
class EntryAbility extends ServiceExtensionAbility { class EntryAbility extends ServiceExtensionAbility {
onCreate() { onCreate() {
context = this.context; // 获取ServiceExtensionContext let context = this.context; // 获取ServiceExtensionContext
} }
} }
``` ```
...@@ -73,13 +73,16 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void; ...@@ -73,13 +73,16 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: 'com.example.myapp', bundleName: 'com.example.myapp',
abilityName: 'MyAbility' abilityName: 'MyAbility'
}; };
try { try {
this.context.startAbility(want, (error) => { this.context.startAbility(want, (error: BusinessError) => {
if (error.code) { if (error.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error('startAbility failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('startAbility failed, error.code: ${error.code}, error.message: ${error.message}');
...@@ -142,21 +145,25 @@ startAbility(want: Want, options?: StartOptions): Promise\<void>; ...@@ -142,21 +145,25 @@ startAbility(want: Want, options?: StartOptions): Promise\<void>;
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: 'com.example.myapp', bundleName: 'com.example.myapp',
abilityName: 'MyAbility' abilityName: 'MyAbility'
}; };
let options = { let options: StartOptions = {
windowMode: 0, windowMode: 0,
}; };
try { try {
this.context.startAbility(want, options) this.context.startAbility(want, options)
.then((data) => { .then((data: void) => {
// 执行正常业务 // 执行正常业务
console.log('startAbility succeed'); console.log('startAbility succeed');
}) })
.catch((error) => { .catch((error: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error('startAbility failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('startAbility failed, error.code: ${error.code}, error.message: ${error.message}');
}); });
...@@ -209,17 +216,21 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void& ...@@ -209,17 +216,21 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void&
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let options = { let options: StartOptions = {
windowMode: 0 windowMode: 0
}; };
try { try {
this.context.startAbility(want, options, (error) => { this.context.startAbility(want, options, (error: BusinessError) => {
if (error.code) { if (error.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error('startAbility failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('startAbility failed, error.code: ${error.code}, error.message: ${error.message}');
...@@ -284,7 +295,10 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< ...@@ -284,7 +295,10 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\<
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
...@@ -292,7 +306,7 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< ...@@ -292,7 +306,7 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\<
let accountId = 100; let accountId = 100;
try { try {
this.context.startAbilityWithAccount(want, accountId, (error) => { this.context.startAbilityWithAccount(want, accountId, (error: BusinessError) => {
if (error.code) { if (error.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error('startAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('startAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}');
...@@ -358,18 +372,22 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca ...@@ -358,18 +372,22 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
import { BusinessError } from '@ohos.base';
let want: 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: StartOptions = {
windowMode: 0 windowMode: 0
}; };
try { try {
this.context.startAbilityWithAccount(want, accountId, options, (error) => { this.context.startAbilityWithAccount(want, accountId, options, (error: BusinessError) => {
if (error.code) { if (error.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error('startAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('startAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}');
...@@ -441,23 +459,27 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): ...@@ -441,23 +459,27 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions):
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
import { BusinessError } from '@ohos.base';
let want: 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: StartOptions = {
windowMode: 0 windowMode: 0
}; };
try { try {
this.context.startAbilityWithAccount(want, accountId, options) this.context.startAbilityWithAccount(want, accountId, options)
.then((data) => { .then((data: void) => {
// 执行正常业务 // 执行正常业务
console.log('startAbilityWithAccount succeed'); console.log('startAbilityWithAccount succeed');
}) })
.catch((error) => { .catch((error: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error('startAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('startAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}');
}); });
...@@ -505,14 +527,17 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void; ...@@ -505,14 +527,17 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
try { try {
this.context.startServiceExtensionAbility(want, (error) => { this.context.startServiceExtensionAbility(want, (error: BusinessError) => {
if (error.code) { if (error.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error('startServiceExtensionAbility failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('startServiceExtensionAbility failed, error.code: ${error.code}, error.message: ${error.message}');
...@@ -570,7 +595,10 @@ startServiceExtensionAbility(want: Want): Promise\<void>; ...@@ -570,7 +595,10 @@ startServiceExtensionAbility(want: Want): Promise\<void>;
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
...@@ -578,11 +606,11 @@ startServiceExtensionAbility(want: Want): Promise\<void>; ...@@ -578,11 +606,11 @@ startServiceExtensionAbility(want: Want): Promise\<void>;
try { try {
this.context.startServiceExtensionAbility(want) this.context.startServiceExtensionAbility(want)
.then((data) => { .then((data: void) => {
// 执行正常业务 // 执行正常业务
console.log('startServiceExtensionAbility succeed'); console.log('startServiceExtensionAbility succeed');
}) })
.catch((error) => { .catch((error: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error('startServiceExtensionAbility failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('startServiceExtensionAbility failed, error.code: ${error.code}, error.message: ${error.message}');
}); });
...@@ -638,7 +666,10 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -638,7 +666,10 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
...@@ -646,7 +677,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -646,7 +677,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
let accountId = 100; let accountId = 100;
try { try {
this.context.startServiceExtensionAbilityWithAccount(want, accountId, (error) => { this.context.startServiceExtensionAbilityWithAccount(want, accountId, (error: BusinessError) => {
if (error.code) { if (error.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error('startServiceExtensionAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('startServiceExtensionAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}');
...@@ -711,7 +742,10 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ ...@@ -711,7 +742,10 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
...@@ -720,11 +754,11 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ ...@@ -720,11 +754,11 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\
try { try {
this.context.startServiceExtensionAbilityWithAccount(want, accountId) this.context.startServiceExtensionAbilityWithAccount(want, accountId)
.then((data) => { .then((data: void) => {
// 执行正常业务 // 执行正常业务
console.log('startServiceExtensionAbilityWithAccount succeed'); console.log('startServiceExtensionAbilityWithAccount succeed');
}) })
.catch((error) => { .catch((error: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error('startServiceExtensionAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('startServiceExtensionAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}');
}); });
...@@ -785,7 +819,7 @@ import extension from '@ohos.app.ability.ServiceExtensionAbility'; ...@@ -785,7 +819,7 @@ import extension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want'; import Want from '@ohos.app.ability.Want';
export default class EntryAbility extends extension { export default class EntryAbility extends extension {
onCreate(want, launchParam) { onCreate(want: Want) {
// want包含启动该应用的Caller信息 // want包含启动该应用的Caller信息
let localWant: Want = want; let localWant: Want = want;
localWant.bundleName = 'com.example.demo'; localWant.bundleName = 'com.example.demo';
...@@ -853,9 +887,10 @@ startAbilityAsCaller(want: Want, options: StartOptions, callback: AsyncCallback\ ...@@ -853,9 +887,10 @@ startAbilityAsCaller(want: Want, options: StartOptions, callback: AsyncCallback\
```ts ```ts
import extension from '@ohos.app.ability.ServiceExtensionAbility'; import extension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want'; import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
export default class EntryAbility extends extension { export default class EntryAbility extends extension {
onCreate(want, launchParam) { onCreate(want: Want) {
// want包含启动该应用的Caller信息 // want包含启动该应用的Caller信息
let localWant: Want = want; let localWant: Want = want;
localWant.bundleName = 'com.example.demo'; localWant.bundleName = 'com.example.demo';
...@@ -934,9 +969,11 @@ startAbilityAsCaller(want: Want, options?: StartOptions): Promise\<void>; ...@@ -934,9 +969,11 @@ startAbilityAsCaller(want: Want, options?: StartOptions): Promise\<void>;
```ts ```ts
import extension from '@ohos.app.ability.ServiceExtensionAbility'; import extension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want'; import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
import { BusinessError } from '@ohos.base';
export default class EntryAbility extends extension { export default class EntryAbility extends extension {
onCreate(want, launchParam) { onCreate(want: Want) {
// want包含启动该应用的Caller信息 // want包含启动该应用的Caller信息
let localWant: Want = want; let localWant: Want = want;
localWant.bundleName = 'com.example.demo'; localWant.bundleName = 'com.example.demo';
...@@ -952,7 +989,7 @@ export default class EntryAbility extends extension { ...@@ -952,7 +989,7 @@ export default class EntryAbility extends extension {
.then(() => { .then(() => {
console.log('startAbilityAsCaller success.'); console.log('startAbilityAsCaller success.');
}) })
.catch((err) => { .catch((err: BusinessError) => {
console.error('startAbilityAsCaller failed, err:' + JSON.stringify(err)); console.error('startAbilityAsCaller failed, err:' + JSON.stringify(err));
}) })
} }
...@@ -995,14 +1032,17 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void; ...@@ -995,14 +1032,17 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
try { try {
this.context.stopServiceExtensionAbility(want, (error) => { this.context.stopServiceExtensionAbility(want, (error: BusinessError) => {
if (error.code) { if (error.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error('stopServiceExtensionAbility failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('stopServiceExtensionAbility failed, error.code: ${error.code}, error.message: ${error.message}');
...@@ -1057,7 +1097,10 @@ stopServiceExtensionAbility(want: Want): Promise\<void>; ...@@ -1057,7 +1097,10 @@ stopServiceExtensionAbility(want: Want): Promise\<void>;
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
...@@ -1065,11 +1108,11 @@ stopServiceExtensionAbility(want: Want): Promise\<void>; ...@@ -1065,11 +1108,11 @@ stopServiceExtensionAbility(want: Want): Promise\<void>;
try { try {
this.context.stopServiceExtensionAbility(want) this.context.stopServiceExtensionAbility(want)
.then((data) => { .then(() => {
// 执行正常业务 // 执行正常业务
console.log('stopServiceExtensionAbility succeed'); console.log('stopServiceExtensionAbility succeed');
}) })
.catch((error) => { .catch((error: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error('stopServiceExtensionAbility failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('stopServiceExtensionAbility failed, error.code: ${error.code}, error.message: ${error.message}');
}); });
...@@ -1121,7 +1164,10 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -1121,7 +1164,10 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
...@@ -1129,7 +1175,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -1129,7 +1175,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
let accountId = 100; let accountId = 100;
try { try {
this.context.stopServiceExtensionAbilityWithAccount(want, accountId, (error) => { this.context.stopServiceExtensionAbilityWithAccount(want, accountId, (error: BusinessError) => {
if (error.code) { if (error.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error('stopServiceExtensionAbilityWithAccount failed, error.code: ${error.code, error.message: ${error.message}'); console.error('stopServiceExtensionAbilityWithAccount failed, error.code: ${error.code, error.message: ${error.message}');
...@@ -1191,7 +1237,10 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< ...@@ -1191,7 +1237,10 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\<
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
...@@ -1200,11 +1249,11 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< ...@@ -1200,11 +1249,11 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\<
try { try {
this.context.stopServiceExtensionAbilityWithAccount(want, accountId) this.context.stopServiceExtensionAbilityWithAccount(want, accountId)
.then((data) => { .then(() => {
// 执行正常业务 // 执行正常业务
console.log('stopServiceExtensionAbilityWithAccount succeed'); console.log('stopServiceExtensionAbilityWithAccount succeed');
}) })
.catch((error) => { .catch((error: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error('stopServiceExtensionAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('stopServiceExtensionAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}');
}); });
...@@ -1246,7 +1295,9 @@ terminateSelf(callback: AsyncCallback&lt;void&gt;): void; ...@@ -1246,7 +1295,9 @@ terminateSelf(callback: AsyncCallback&lt;void&gt;): void;
**示例:** **示例:**
```ts ```ts
this.context.terminateSelf((error) => { import { BusinessError } from '@ohos.base';
this.context.terminateSelf((error: BusinessError) => {
if (error.code) { if (error.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error('terminateSelf failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('terminateSelf failed, error.code: ${error.code}, error.message: ${error.message}');
...@@ -1289,10 +1340,12 @@ terminateSelf(): Promise&lt;void&gt;; ...@@ -1289,10 +1340,12 @@ terminateSelf(): Promise&lt;void&gt;;
**示例:** **示例:**
```ts ```ts
this.context.terminateSelf().then((data) => { import { BusinessError } from '@ohos.base';
this.context.terminateSelf().then(() => {
// 执行正常业务 // 执行正常业务
console.log('terminateSelf succeed'); console.log('terminateSelf succeed');
}).catch((error) => { }).catch((error: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error('terminateSelf failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('terminateSelf failed, error.code: ${error.code}, error.message: ${error.message}');
}); });
...@@ -1341,20 +1394,24 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number; ...@@ -1341,20 +1394,24 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number;
**示例:** **示例:**
```ts ```ts
let want = { import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility';
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: 'com.example.myapp', bundleName: 'com.example.myapp',
abilityName: 'MyAbility' abilityName: 'MyAbility'
}; };
let options = { let options: common.ConnectOptions = {
onConnect(elementName, remote) { onConnect(elementName, remote) {
commRemote = remote; commRemote = remote;
console.log('----------- onConnect -----------'); console.log('----------- onConnect -----------');
}, },
onDisconnect(elementName) { console.log('----------- onDisconnect -----------') }, onDisconnect(elementName) { console.log('----------- onDisconnect -----------') },
onFailed(code) { console.error('----------- onFailed -----------') } onFailed(code) { console.error('----------- onFailed -----------') }
}; };
let connection: number;
let connection = null;
try { try {
connection = this.context.connectServiceExtensionAbility(want, options); connection = this.context.connectServiceExtensionAbility(want, options);
} catch (paramError) { } catch (paramError) {
...@@ -1409,13 +1466,18 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options ...@@ -1409,13 +1466,18 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options
**示例:** **示例:**
```ts ```ts
let want = { import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility';
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: 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: common.ConnectOptions = {
onConnect(elementName, remote) { onConnect(elementName, remote) {
commRemote = remote; commRemote = remote;
console.log('----------- onConnect -----------'); console.log('----------- onConnect -----------');
...@@ -1423,8 +1485,7 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options ...@@ -1423,8 +1485,7 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options
onDisconnect(elementName) { console.log('----------- onDisconnect -----------'); }, onDisconnect(elementName) { console.log('----------- onDisconnect -----------'); },
onFailed(code) { console.log('----------- onFailed -----------'); } onFailed(code) { console.log('----------- onFailed -----------'); }
}; };
let connection: number;
let connection = null;
try { try {
connection = this.context.connectServiceExtensionAbilityWithAccount(want, accountId, options); connection = this.context.connectServiceExtensionAbilityWithAccount(want, accountId, options);
} catch (paramError) { } catch (paramError) {
...@@ -1462,11 +1523,13 @@ disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback&lt; ...@@ -1462,11 +1523,13 @@ disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback&lt;
**示例:** **示例:**
```ts ```ts
import { BusinessError } from '@ohos.base';
// connection为connectServiceExtensionAbility中的返回值 // connection为connectServiceExtensionAbility中的返回值
let connection = 1; let connection = 1;
try { try {
this.context.disconnectServiceExtensionAbility(connection, (error) => { this.context.disconnectServiceExtensionAbility(connection, (error: BusinessError) => {
commRemote = null; commRemote = null;
if (error.code) { if (error.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
...@@ -1517,17 +1580,19 @@ disconnectServiceExtensionAbility(connection: number): Promise&lt;void&gt;; ...@@ -1517,17 +1580,19 @@ disconnectServiceExtensionAbility(connection: number): Promise&lt;void&gt;;
**示例:** **示例:**
```ts ```ts
import { BusinessError } from '@ohos.base';
// connection为connectServiceExtensionAbility中的返回值 // connection为connectServiceExtensionAbility中的返回值
let connection = 1; let connection = 1;
try { try {
this.context.disconnectServiceExtensionAbility(connection) this.context.disconnectServiceExtensionAbility(connection)
.then((data) => { .then(() => {
commRemote = null; commRemote = null;
// 执行正常业务 // 执行正常业务
console.log('disconnectServiceExtensionAbility succeed'); console.log('disconnectServiceExtensionAbility succeed');
}) })
.catch((error) => { .catch((error: BusinessError) => {
commRemote = null; commRemote = null;
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error('disconnectServiceExtensionAbility failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('disconnectServiceExtensionAbility failed, error.code: ${error.code}, error.message: ${error.message}');
...@@ -1589,10 +1654,14 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;; ...@@ -1589,10 +1654,14 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;;
后台启动: 后台启动:
```ts ```ts
let caller; import { Caller } from '@ohos.app.ability.UIAbility';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let caller: Caller;
// 后台启动Ability,不配置parameters // 后台启动Ability,不配置parameters
let wantBackground = { let wantBackground: Want = {
bundleName: 'com.example.myservice', bundleName: 'com.example.myservice',
moduleName: 'entry', moduleName: 'entry',
abilityName: 'EntryAbility', abilityName: 'EntryAbility',
...@@ -1601,11 +1670,11 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;; ...@@ -1601,11 +1670,11 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;;
try { try {
this.context.startAbilityByCall(wantBackground) this.context.startAbilityByCall(wantBackground)
.then((obj) => { .then((obj: Caller) => {
// 执行正常业务 // 执行正常业务
caller = obj; caller = obj;
console.log('startAbilityByCall succeed'); console.log('startAbilityByCall succeed');
}).catch((error) => { }).catch((error: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error('startAbilityByCall failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('startAbilityByCall failed, error.code: ${error.code}, error.message: ${error.message}');
}); });
...@@ -1618,10 +1687,14 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;; ...@@ -1618,10 +1687,14 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;;
前台启动: 前台启动:
```ts ```ts
let caller; import { Caller } from '@ohos.app.ability.UIAbility';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let caller: Caller;
// 前台启动Ability,将parameters中的'ohos.aafwk.param.callAbilityToForeground'配置为true // 前台启动Ability,将parameters中的'ohos.aafwk.param.callAbilityToForeground'配置为true
let wantForeground = { let wantForeground: Want = {
bundleName: 'com.example.myservice', bundleName: 'com.example.myservice',
moduleName: 'entry', moduleName: 'entry',
abilityName: 'EntryAbility', abilityName: 'EntryAbility',
...@@ -1633,11 +1706,11 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;; ...@@ -1633,11 +1706,11 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;;
try { try {
this.context.startAbilityByCall(wantForeground) this.context.startAbilityByCall(wantForeground)
.then((obj) => { .then((obj: Caller) => {
// 执行正常业务 // 执行正常业务
caller = obj; caller = obj;
console.log('startAbilityByCall succeed'); console.log('startAbilityByCall succeed');
}).catch((error) => { }).catch((error: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error('startAbilityByCall failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('startAbilityByCall failed, error.code: ${error.code}, error.message: ${error.message}');
}); });
...@@ -1691,13 +1764,16 @@ startRecentAbility(want: Want, callback: AsyncCallback\<void>): void; ...@@ -1691,13 +1764,16 @@ startRecentAbility(want: Want, callback: AsyncCallback\<void>): void;
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
try { try {
this.context.startRecentAbility(want, (err) => { this.context.startRecentAbility(want, (err: BusinessError) => {
if (err.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`); console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`);
...@@ -1708,7 +1784,9 @@ try { ...@@ -1708,7 +1784,9 @@ try {
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startRecentAbility failed failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startRecentAbility failed, code is ${code}, message is ${message}`);
} }
``` ```
## ServiceExtensionContext.startRecentAbility ## ServiceExtensionContext.startRecentAbility
...@@ -1758,17 +1836,21 @@ startRecentAbility(want: Want, options: StartOptions, callback: AsyncCallback\<v ...@@ -1758,17 +1836,21 @@ startRecentAbility(want: Want, options: StartOptions, callback: AsyncCallback\<v
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let options = { let options: StartOptions = {
windowMode: 0 windowMode: 0
}; };
try { try {
this.context.startRecentAbility(want, options, (err) => { this.context.startRecentAbility(want, options, (err: BusinessError) => {
if (err.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`); console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`);
...@@ -1779,7 +1861,9 @@ try { ...@@ -1779,7 +1861,9 @@ try {
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startRecentAbility failed failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startRecentAbility failed, code is ${code}, message is ${message}`);
} }
``` ```
## ServiceExtensionContext.startRecentAbility ## ServiceExtensionContext.startRecentAbility
...@@ -1828,11 +1912,15 @@ startRecentAbility(want: Want, options?: StartOptions): Promise\<void>; ...@@ -1828,11 +1912,15 @@ startRecentAbility(want: Want, options?: StartOptions): Promise\<void>;
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let options = { let options: StartOptions = {
windowMode: 0, windowMode: 0,
}; };
...@@ -1842,13 +1930,15 @@ try { ...@@ -1842,13 +1930,15 @@ try {
// 执行正常业务 // 执行正常业务
console.info('startRecentAbility succeed'); console.info('startRecentAbility succeed');
}) })
.catch((err) => { .catch((err: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`); console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`);
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startRecentAbility failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -1904,13 +1994,16 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise&lt;Caller& ...@@ -1904,13 +1994,16 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise&lt;Caller&
**示例:** **示例:**
```ts ```ts
let caller; import { Caller } from '@ohos.app.ability.UIAbility';
import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
import { BusinessError } from '@ohos.base';
let caller: Caller;
// 系统账号的账号ID, -1表示当前激活用户 // 系统账号的账号ID, -1表示当前激活用户
let accountId = -1; let accountId = -1;
// 指定启动的Ability // 指定启动的Ability
let want = { let want: Want = {
bundleName: 'com.acts.actscalleeabilityrely', bundleName: 'com.acts.actscalleeabilityrely',
moduleName: 'entry', moduleName: 'entry',
abilityName: 'EntryAbility', abilityName: 'EntryAbility',
...@@ -1923,11 +2016,11 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise&lt;Caller& ...@@ -1923,11 +2016,11 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise&lt;Caller&
try { try {
this.context.startAbilityByCallWithAccount(want, accountId) this.context.startAbilityByCallWithAccount(want, accountId)
.then((obj) => { .then((obj: Caller) => {
// 执行正常业务 // 执行正常业务
caller = obj; caller = obj;
console.log('startAbilityByCallWithAccount succeed'); console.log('startAbilityByCallWithAccount succeed');
}).catch((error) => { }).catch((error: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error('startAbilityByCallWithAccount failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('startAbilityByCallWithAccount failed, error.code: ${error.code}, error.message: ${error.message}');
}); });
......
...@@ -28,11 +28,13 @@ import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry ...@@ -28,11 +28,13 @@ import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let cmd = 'cmd'; let cmd = 'cmd';
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.executeShellCommand(cmd, (error: any, data: any) => { abilityDelegator.executeShellCommand(cmd, (error: BusinessError, data) => {
if (error) { if (error) {
console.error('executeShellCommand fail, error: ${JSON.stringify(error)}'); console.error('executeShellCommand fail, error: ${JSON.stringify(error)}');
} else { } else {
......
...@@ -73,13 +73,16 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void; ...@@ -73,13 +73,16 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
try { try {
this.context.startAbility(want, (err) => { this.context.startAbility(want, (err: BusinessError) => {
if (err.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`); console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
...@@ -90,7 +93,9 @@ try { ...@@ -90,7 +93,9 @@ try {
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startAbility failed failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startAbility failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -140,17 +145,21 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void& ...@@ -140,17 +145,21 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void&
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let options = { let options: StartOptions = {
windowMode: 0 windowMode: 0
}; };
try { try {
this.context.startAbility(want, options, (err) => { this.context.startAbility(want, options, (err: BusinessError) => {
if (err.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`); console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
...@@ -161,7 +170,9 @@ try { ...@@ -161,7 +170,9 @@ try {
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startAbility failed failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startAbility failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -216,11 +227,15 @@ startAbility(want: Want, options?: StartOptions): Promise&lt;void&gt;; ...@@ -216,11 +227,15 @@ startAbility(want: Want, options?: StartOptions): Promise&lt;void&gt;;
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let options = { let options: StartOptions = {
windowMode: 0, windowMode: 0,
}; };
...@@ -230,13 +245,15 @@ try { ...@@ -230,13 +245,15 @@ try {
// 执行正常业务 // 执行正常业务
console.info('startAbility succeed'); console.info('startAbility succeed');
}) })
.catch((err) => { .catch((err: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`); console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startAbility failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -288,25 +305,32 @@ startAbilityForResult(want: Want, callback: AsyncCallback&lt;AbilityResult&gt;): ...@@ -288,25 +305,32 @@ startAbilityForResult(want: Want, callback: AsyncCallback&lt;AbilityResult&gt;):
**示例:** **示例:**
```ts ```ts
let want = { import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
try { try {
this.context.startAbilityForResult(want, (err, result) => { this.context.startAbilityForResult(want, (err: BusinessError, result: common.AbilityResult) => {
if (err.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`); console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`);
return; return;
}
// 执行正常业务 // 执行正常业务
console.info('startAbilityForResult succeed'); console.info('startAbilityForResult succeed');
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startAbilityForResult failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -359,20 +383,27 @@ startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback ...@@ -359,20 +383,27 @@ startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback
**示例:** **示例:**
```ts ```ts
let want = { import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let options = { let options: StartOptions = {
windowMode: 0, windowMode: 0,
}; };
try { try {
this.context.startAbilityForResult(want, options, (err, result) => { this.context.startAbilityForResult(want, options, (err: BusinessError, result: common.AbilityResult) => {
if (err.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`); console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`);
return; return;
} }
// 执行正常业务 // 执行正常业务
...@@ -380,7 +411,9 @@ try { ...@@ -380,7 +411,9 @@ try {
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startAbilityForResult failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -440,27 +473,36 @@ startAbilityForResult(want: Want, options?: StartOptions): Promise&lt;AbilityRes ...@@ -440,27 +473,36 @@ startAbilityForResult(want: Want, options?: StartOptions): Promise&lt;AbilityRes
**示例:** **示例:**
```ts ```ts
let want = { import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let options = { let options: StartOptions = {
windowMode: 0, windowMode: 0,
}; };
try { try {
this.context.startAbilityForResult(want, options) this.context.startAbilityForResult(want, options)
.then((result) => { .then((result: common.AbilityResult) => {
// 执行正常业务 // 执行正常业务
console.info('startAbilityForResult succeed'); console.info('startAbilityForResult succeed');
}) })
.catch((err) => { .catch((err: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`); console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`);
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startAbilityForResult failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -518,7 +560,13 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC ...@@ -518,7 +560,13 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC
**示例:** **示例:**
```ts ```ts
let want = { import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
...@@ -526,7 +574,7 @@ let want = { ...@@ -526,7 +574,7 @@ let want = {
let accountId = 100; let accountId = 100;
try { try {
this.context.startAbilityForResultWithAccount(want, accountId, (err, result) => { this.context.startAbilityForResultWithAccount(want, accountId, (err: BusinessError, result: common.AbilityResult) => {
if (err.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`); console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`);
...@@ -537,7 +585,9 @@ try { ...@@ -537,7 +585,9 @@ try {
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startAbilityForResultWithAccount failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -597,18 +647,22 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp ...@@ -597,18 +647,22 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
import { BusinessError } from '@ohos.base';
let want: 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: StartOptions = {
windowMode: 0 windowMode: 0
}; };
try { try {
this.context.startAbilityForResultWithAccount(want, accountId, options, (err) => { this.context.startAbilityForResultWithAccount(want, accountId, options, (err: BusinessError) => {
if (err.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`); console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`);
...@@ -619,7 +673,9 @@ try { ...@@ -619,7 +673,9 @@ try {
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startAbilityForResultWithAccount failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -684,29 +740,38 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO ...@@ -684,29 +740,38 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO
**示例:** **示例:**
```ts ```ts
let want = { import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
import { BusinessError } from '@ohos.base';
let want: 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: StartOptions = {
windowMode: 0 windowMode: 0
}; };
try { try {
this.context.startAbilityForResultWithAccount(want, accountId, options) this.context.startAbilityForResultWithAccount(want, accountId, options)
.then((result) => { .then((result: common.AbilityResult) => {
// 执行正常业务 // 执行正常业务
console.info('startAbilityForResultWithAccount succeed'); console.info('startAbilityForResultWithAccount succeed');
}) })
.catch((err) => { .catch((err: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`); console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`);
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startAbilityForResultWithAccount failed, code is ${code}, message is ${message}`);
} }
``` ```
## UIAbilityContext.startServiceExtensionAbility ## UIAbilityContext.startServiceExtensionAbility
...@@ -747,7 +812,10 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void; ...@@ -747,7 +812,10 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility' abilityName: 'ServiceExtensionAbility'
...@@ -759,13 +827,15 @@ try { ...@@ -759,13 +827,15 @@ try {
// 执行正常业务 // 执行正常业务
console.info('startServiceExtensionAbility succeed'); console.info('startServiceExtensionAbility succeed');
}) })
.catch((err) => { .catch((err: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); console.error(`startServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startServiceExtensionAbility failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -806,7 +876,10 @@ startServiceExtensionAbility(want: Want): Promise\<void>; ...@@ -806,7 +876,10 @@ startServiceExtensionAbility(want: Want): Promise\<void>;
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility' abilityName: 'ServiceExtensionAbility'
...@@ -818,13 +891,15 @@ try { ...@@ -818,13 +891,15 @@ try {
// 执行正常业务 // 执行正常业务
console.info('startServiceExtensionAbility succeed'); console.info('startServiceExtensionAbility succeed');
}) })
.catch((err) => { .catch((err: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); console.error(`startServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startServiceExtensionAbility failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -873,7 +948,10 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -873,7 +948,10 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility' abilityName: 'ServiceExtensionAbility'
...@@ -881,7 +959,7 @@ let want = { ...@@ -881,7 +959,7 @@ let want = {
let accountId = 100; let accountId = 100;
try { try {
this.context.startServiceExtensionAbilityWithAccount(want, accountId, (err) => { this.context.startServiceExtensionAbilityWithAccount(want, accountId, (err: BusinessError) => {
if (err.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); console.error(`startServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
...@@ -892,7 +970,9 @@ try { ...@@ -892,7 +970,9 @@ try {
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startServiceExtensionAbilityWithAccount failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -940,7 +1020,10 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ ...@@ -940,7 +1020,10 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility' abilityName: 'ServiceExtensionAbility'
...@@ -953,13 +1036,15 @@ try { ...@@ -953,13 +1036,15 @@ try {
// 执行正常业务 // 执行正常业务
console.info('startServiceExtensionAbilityWithAccount succeed'); console.info('startServiceExtensionAbilityWithAccount succeed');
}) })
.catch((err) => { .catch((err: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); console.error(`startServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startServiceExtensionAbilityWithAccount failed, code is ${code}, message is ${message}`);
} }
``` ```
## UIAbilityContext.stopServiceExtensionAbility ## UIAbilityContext.stopServiceExtensionAbility
...@@ -999,14 +1084,17 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void; ...@@ -999,14 +1084,17 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility' abilityName: 'ServiceExtensionAbility'
}; };
try { try {
this.context.stopServiceExtensionAbility(want, (err) => { this.context.stopServiceExtensionAbility(want, (err: BusinessError) => {
if (err.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`stopServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); console.error(`stopServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
...@@ -1017,7 +1105,9 @@ try { ...@@ -1017,7 +1105,9 @@ try {
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`stopServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`stopServiceExtensionAbility failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -1055,7 +1145,10 @@ stopServiceExtensionAbility(want: Want): Promise\<void>; ...@@ -1055,7 +1145,10 @@ stopServiceExtensionAbility(want: Want): Promise\<void>;
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility' abilityName: 'ServiceExtensionAbility'
...@@ -1067,13 +1160,15 @@ try { ...@@ -1067,13 +1160,15 @@ try {
// 执行正常业务 // 执行正常业务
console.info('stopServiceExtensionAbility succeed'); console.info('stopServiceExtensionAbility succeed');
}) })
.catch((err) => { .catch((err: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`stopServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); console.error(`stopServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`stopServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`stopServiceExtensionAbility failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -1119,7 +1214,10 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -1119,7 +1214,10 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility' abilityName: 'ServiceExtensionAbility'
...@@ -1127,7 +1225,7 @@ let want = { ...@@ -1127,7 +1225,7 @@ let want = {
let accountId = 100; let accountId = 100;
try { try {
this.context.stopServiceExtensionAbilityWithAccount(want, accountId, (err) => { this.context.stopServiceExtensionAbilityWithAccount(want, accountId, (err: BusinessError) => {
if (err.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
...@@ -1138,7 +1236,9 @@ try { ...@@ -1138,7 +1236,9 @@ try {
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -1183,7 +1283,10 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< ...@@ -1183,7 +1283,10 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\<
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility' abilityName: 'ServiceExtensionAbility'
...@@ -1196,13 +1299,15 @@ try { ...@@ -1196,13 +1299,15 @@ try {
// 执行正常业务 // 执行正常业务
console.info('stopServiceExtensionAbilityWithAccount succeed'); console.info('stopServiceExtensionAbilityWithAccount succeed');
}) })
.catch((err) => { .catch((err: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -1236,8 +1341,10 @@ terminateSelf(callback: AsyncCallback&lt;void&gt;): void; ...@@ -1236,8 +1341,10 @@ terminateSelf(callback: AsyncCallback&lt;void&gt;): void;
**示例:** **示例:**
```ts ```ts
import { BusinessError } from '@ohos.base';
try { try {
this.context.terminateSelf((err) => { this.context.terminateSelf((err: BusinessError) => {
if (err.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`terminateSelf failed, code is ${err.code}, message is ${err.message}`); console.error(`terminateSelf failed, code is ${err.code}, message is ${err.message}`);
...@@ -1248,7 +1355,9 @@ terminateSelf(callback: AsyncCallback&lt;void&gt;): void; ...@@ -1248,7 +1355,9 @@ terminateSelf(callback: AsyncCallback&lt;void&gt;): void;
}); });
} catch (err) { } catch (err) {
// 捕获同步的参数错误 // 捕获同步的参数错误
console.error(`terminateSelf failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`terminateSelf failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -1283,19 +1392,23 @@ terminateSelf(): Promise&lt;void&gt;; ...@@ -1283,19 +1392,23 @@ terminateSelf(): Promise&lt;void&gt;;
**示例:** **示例:**
```ts ```ts
import { BusinessError } from '@ohos.base';
try { try {
this.context.terminateSelf() this.context.terminateSelf()
.then(() => { .then(() => {
// 执行正常业务 // 执行正常业务
console.info('terminateSelf succeed'); console.info('terminateSelf succeed');
}) })
.catch((err) => { .catch((err: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`terminateSelf failed, code is ${err.code}, message is ${err.message}`); console.error(`terminateSelf failed, code is ${err.code}, message is ${err.message}`);
}); });
} catch (err) { } catch (err) {
// 捕获同步的参数错误 // 捕获同步的参数错误
console.error(`terminateSelf failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`terminateSelf failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -1331,19 +1444,24 @@ terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback&lt;voi ...@@ -1331,19 +1444,24 @@ terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback&lt;voi
**示例:** **示例:**
```ts ```ts
let want = { import UIAbility from '@ohos.app.ability.UIAbility';
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: 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: common.AbilityResult = {
want, want,
resultCode resultCode
}; };
try { try {
this.context.terminateSelfWithResult(abilityResult, (err) => { this.context.terminateSelfWithResult(abilityResult, (err: BusinessError) => {
if (err.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`terminateSelfWithResult failed, code is ${err.code}, message is ${err.message}`); console.error(`terminateSelfWithResult failed, code is ${err.code}, message is ${err.message}`);
...@@ -1354,7 +1472,9 @@ try { ...@@ -1354,7 +1472,9 @@ try {
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`terminateSelfWithResult failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`terminateSelfWithResult failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -1395,13 +1515,18 @@ terminateSelfWithResult(parameter: AbilityResult): Promise&lt;void&gt;; ...@@ -1395,13 +1515,18 @@ terminateSelfWithResult(parameter: AbilityResult): Promise&lt;void&gt;;
**示例:** **示例:**
```ts ```ts
let want = { import UIAbility from '@ohos.app.ability.UIAbility';
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: 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: common.AbilityResult = {
want, want,
resultCode resultCode
}; };
...@@ -1412,13 +1537,15 @@ try { ...@@ -1412,13 +1537,15 @@ try {
// 执行正常业务 // 执行正常业务
console.info('terminateSelfWithResult succeed'); console.info('terminateSelfWithResult succeed');
}) })
.catch((err) => { .catch((err: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`terminateSelfWithResult failed, code is ${err.code}, message is ${err.message}`); console.error(`terminateSelfWithResult failed, code is ${err.code}, message is ${err.message}`);
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`terminateSelfWithResult failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`terminateSelfWithResult failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -1463,13 +1590,19 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number; ...@@ -1463,13 +1590,19 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number;
**示例:** **示例:**
```ts ```ts
let want = { import UIAbility from '@ohos.app.ability.UIAbility';
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
import rpc from '@ohos.rpc';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility' abilityName: 'ServiceExtensionAbility'
}; };
let commRemote; let commRemote: rpc.IRemoteObject;
let options = { let options: common.ConnectOptions = {
onConnect(elementName, remote) { onConnect(elementName, remote) {
commRemote = remote; commRemote = remote;
console.info('onConnect...') console.info('onConnect...')
...@@ -1481,13 +1614,14 @@ let options = { ...@@ -1481,13 +1614,14 @@ let options = {
console.info('onFailed...') console.info('onFailed...')
} }
}; };
let connection: number;
let connection = null;
try { try {
connection = this.context.connectServiceExtensionAbility(want, options); connection = this.context.connectServiceExtensionAbility(want, options);
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`connectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`connectServiceExtensionAbility failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -1542,14 +1676,20 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options ...@@ -1542,14 +1676,20 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options
**示例:** **示例:**
```ts ```ts
let want = { import UIAbility from '@ohos.app.ability.UIAbility';
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
import rpc from '@ohos.rpc';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility' abilityName: 'ServiceExtensionAbility'
}; };
let accountId = 100; let accountId = 100;
let commRemote; let commRemote: rpc.IRemoteObject;
let options = { let options: common.ConnectOptions = {
onConnect(elementName, remote) { onConnect(elementName, remote) {
commRemote = remote; commRemote = remote;
console.info('onConnect...') console.info('onConnect...')
...@@ -1561,13 +1701,14 @@ let options = { ...@@ -1561,13 +1701,14 @@ let options = {
console.info('onFailed...') console.info('onFailed...')
} }
}; };
let connection: number;
let connection = null;
try { try {
connection = this.context.connectServiceExtensionAbilityWithAccount(want, accountId, options); connection = this.context.connectServiceExtensionAbilityWithAccount(want, accountId, options);
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`connectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`connectServiceExtensionAbility failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -1603,25 +1744,27 @@ disconnectServiceExtensionAbility(connection: number): Promise\<void>; ...@@ -1603,25 +1744,27 @@ disconnectServiceExtensionAbility(connection: number): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import { BusinessError } from '@ohos.base';
// connection为connectServiceExtensionAbility中的返回值 // connection为connectServiceExtensionAbility中的返回值
let connection = 1; let connection = 1;
let commRemote; let commRemote: rpc.IRemoteObject | null;
try { try {
this.context.disconnectServiceExtensionAbility(connection, (err) => { this.context.disconnectServiceExtensionAbility(connection).then(() => {
commRemote = null; commRemote = null;
if (err.code) {
// 处理业务逻辑错误
console.error(`disconnectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
return;
}
// 执行正常业务 // 执行正常业务
console.info('disconnectServiceExtensionAbility succeed'); console.info('disconnectServiceExtensionAbility succeed');
}); }).catch((err: BusinessError) => {
// 处理业务逻辑错误
console.error(`disconnectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
})
} catch (err) { } catch (err) {
commRemote = null; commRemote = null;
// 处理入参错误异常 // 处理入参错误异常
console.error(`disconnectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`disconnectServiceExtensionAbility failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -1652,29 +1795,14 @@ disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback\<vo ...@@ -1652,29 +1795,14 @@ disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback\<vo
**示例:** **示例:**
```ts ```ts
import { BusinessError } from '@ohos.base';
// connection为connectServiceExtensionAbility中的返回值 // connection为connectServiceExtensionAbility中的返回值
let connection = 1; let connection = 1;
let commRemote; let commRemote: rpc.IRemoteObject | null;
try {
this.context.disconnectServiceExtensionAbility(connection, (err) => {
commRemote = null;
if (err.code) {
// 处理业务逻辑错误
console.error(`disconnectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
return;
}
// 执行正常业务
console.info('disconnectServiceExtensionAbility succeed');
});
} catch (err) {
commRemote = null;
// 处理入参错误异常
console.error(`disconnectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
}
try { try {
this.context.disconnectServiceExtensionAbility(connection, (err) => { this.context.disconnectServiceExtensionAbility(connection, (err: BusinessError) => {
commRemote = null; commRemote = null;
if (err.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
...@@ -1687,7 +1815,9 @@ try { ...@@ -1687,7 +1815,9 @@ try {
} catch (err) { } catch (err) {
commRemote = null; commRemote = null;
// 处理入参错误异常 // 处理入参错误异常
console.error(`disconnectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`disconnectServiceExtensionAbility failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -1741,10 +1871,14 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;; ...@@ -1741,10 +1871,14 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;;
后台启动: 后台启动:
```ts ```ts
let caller; import { Caller } from '@ohos.app.ability.UIAbility';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let caller: Caller;
// 后台启动Ability,不配置parameters // 后台启动Ability,不配置parameters
let wantBackground = { let wantBackground: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
moduleName: 'entry', moduleName: 'entry',
abilityName: 'EntryAbility', abilityName: 'EntryAbility',
...@@ -1753,27 +1887,33 @@ let wantBackground = { ...@@ -1753,27 +1887,33 @@ let wantBackground = {
try { try {
this.context.startAbilityByCall(wantBackground) this.context.startAbilityByCall(wantBackground)
.then((obj) => { .then((obj: Caller) => {
// 执行正常业务 // 执行正常业务
caller = obj; caller = obj;
console.info('startAbilityByCall succeed'); console.info('startAbilityByCall succeed');
}).catch((err) => { }).catch((err: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startAbilityByCall failed, code is ${err.code}, message is ${err.message}`); console.error(`startAbilityByCall failed, code is ${err.code}, message is ${err.message}`);
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startAbilityByCall failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startAbilityByCall failed, code is ${code}, message is ${message}`);
} }
``` ```
前台启动: 前台启动:
```ts ```ts
let caller; import { Caller } from '@ohos.app.ability.UIAbility';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let caller: Caller;
// 前台启动Ability,将parameters中的'ohos.aafwk.param.callAbilityToForeground'配置为true // 前台启动Ability,将parameters中的'ohos.aafwk.param.callAbilityToForeground'配置为true
let wantForeground = { let wantForeground: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
moduleName: 'entry', moduleName: 'entry',
abilityName: 'EntryAbility', abilityName: 'EntryAbility',
...@@ -1785,17 +1925,19 @@ let wantForeground = { ...@@ -1785,17 +1925,19 @@ let wantForeground = {
try { try {
this.context.startAbilityByCall(wantForeground) this.context.startAbilityByCall(wantForeground)
.then((obj) => { .then((obj: Caller) => {
// 执行正常业务 // 执行正常业务
caller = obj; caller = obj;
console.info('startAbilityByCall succeed'); console.info('startAbilityByCall succeed');
}).catch((err) => { }).catch((err: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startAbilityByCall failed, code is ${err.code}, message is ${err.message}`); console.error(`startAbilityByCall failed, code is ${err.code}, message is ${err.message}`);
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startAbilityByCall failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startAbilityByCall failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -1853,7 +1995,10 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< ...@@ -1853,7 +1995,10 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\<
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
...@@ -1861,7 +2006,7 @@ let want = { ...@@ -1861,7 +2006,7 @@ let want = {
let accountId = 100; let accountId = 100;
try { try {
this.context.startAbilityWithAccount(want, accountId, (err) => { this.context.startAbilityWithAccount(want, accountId, (err: BusinessError) => {
if (err.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
...@@ -1872,7 +2017,9 @@ try { ...@@ -1872,7 +2017,9 @@ try {
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startAbilityWithAccount failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -1932,18 +2079,22 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca ...@@ -1932,18 +2079,22 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
import { BusinessError } from '@ohos.base';
let want: 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: StartOptions = {
windowMode: 0 windowMode: 0
}; };
try { try {
this.context.startAbilityWithAccount(want, accountId, options, (err) => { this.context.startAbilityWithAccount(want, accountId, options, (err: BusinessError) => {
if (err.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
...@@ -1954,7 +2105,9 @@ try { ...@@ -1954,7 +2105,9 @@ try {
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startAbilityWithAccount failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -2013,13 +2166,17 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): ...@@ -2013,13 +2166,17 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions):
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
import { BusinessError } from '@ohos.base';
let want: 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: StartOptions = {
windowMode: 0 windowMode: 0
}; };
...@@ -2029,13 +2186,15 @@ try { ...@@ -2029,13 +2186,15 @@ try {
// 执行正常业务 // 执行正常业务
console.info('startAbilityWithAccount succeed'); console.info('startAbilityWithAccount succeed');
}) })
.catch((err) => { .catch((err: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startAbilityWithAccount failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -2066,7 +2225,9 @@ setMissionLabel(label: string, callback:AsyncCallback&lt;void&gt;): void; ...@@ -2066,7 +2225,9 @@ setMissionLabel(label: string, callback:AsyncCallback&lt;void&gt;): void;
**示例:** **示例:**
```ts ```ts
this.context.setMissionLabel('test', (result) => { import { BusinessError } from '@ohos.base';
this.context.setMissionLabel('test', (result: BusinessError) => {
console.info(`setMissionLabel: ${JSON.stringify(result)}`); console.info(`setMissionLabel: ${JSON.stringify(result)}`);
}); });
``` ```
...@@ -2103,10 +2264,14 @@ setMissionLabel(label: string): Promise&lt;void&gt;; ...@@ -2103,10 +2264,14 @@ setMissionLabel(label: string): Promise&lt;void&gt;;
**示例:** **示例:**
```ts ```ts
import { BusinessError } from '@ohos.base';
this.context.setMissionLabel('test').then(() => { this.context.setMissionLabel('test').then(() => {
console.info('success'); console.info('success');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`setMissionLabel failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`setMissionLabel failed, code is ${code}, message is ${message}`);
}); });
``` ```
## UIAbilityContext.setMissionIcon ## UIAbilityContext.setMissionIcon
...@@ -2138,26 +2303,30 @@ setMissionIcon(icon: image.PixelMap, callback:AsyncCallback\<void>): void; ...@@ -2138,26 +2303,30 @@ setMissionIcon(icon: image.PixelMap, callback:AsyncCallback\<void>): void;
**示例:** **示例:**
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
import image from '@ohos.multimedia.image'; import image from '@ohos.multimedia.image';
let imagePixelMap; export default class EntryAbility extends UIAbility {
let color = new ArrayBuffer(0); onForeground() {
let initializationOptions = { let imagePixelMap: image.PixelMap;
size: { let color = new ArrayBuffer(0);
height: 100, image.createPixelMap(color, {
width: 100 size: {
height: 100,
width: 100
}
}).then((data) => {
imagePixelMap = data;
this.context.setMissionIcon(imagePixelMap, (err: BusinessError) => {
console.error(`setMissionLabel failed, code is ${err.code}, message is ${err.message}`);
})
})
.catch((err: BusinessError) => {
console.error(`createPixelMap failed, code is ${err.code}, message is ${err.message}`);
});
} }
}; }
image.createPixelMap(color, initializationOptions)
.then((data) => {
imagePixelMap = data;
})
.catch((err) => {
console.error(`createPixelMap failed, code is ${err.code}, message is ${err.message}`);
});
this.context.setMissionIcon(imagePixelMap, (err) => {
console.error(`setMissionLabel failed, code is ${err.code}, message is ${err.message}`);
})
``` ```
...@@ -2195,30 +2364,34 @@ setMissionIcon(icon: image.PixelMap): Promise\<void>; ...@@ -2195,30 +2364,34 @@ setMissionIcon(icon: image.PixelMap): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
import image from '@ohos.multimedia.image'; import image from '@ohos.multimedia.image';
let imagePixelMap; export default class EntryAbility extends UIAbility {
let color = new ArrayBuffer(0); onForeground() {
let initializationOptions = { let imagePixelMap: image.PixelMap;
size: { let color = new ArrayBuffer(0);
height: 100, image.createPixelMap(color, {
width: 100 size: {
height: 100,
width: 100
}
}).then((data) => {
imagePixelMap = data;
this.context.setMissionIcon(imagePixelMap)
.then(() => {
console.info('setMissionIcon succeed');
})
.catch((err: BusinessError) => {
console.error(`setMissionLabel failed, code is ${err.code}, message is ${err.message}`);
});
})
.catch((err: BusinessError) => {
console.error(`createPixelMap failed, code is ${err.code}, message is ${err.message}`);
});
} }
}; }
image.createPixelMap(color, initializationOptions)
.then((data) => {
imagePixelMap = data;
})
.catch((err) => {
console.error(`createPixelMap failed, code is ${err.code}, message is ${err.message}`);
});
this.context.setMissionIcon(imagePixelMap)
.then(() => {
console.info('setMissionIcon succeed');
})
.catch((err) => {
console.error(`setMissionLabel failed, code is ${err.code}, message is ${err.message}`);
});
``` ```
## UIAbilityContext.setMissionContinueState<sup>10+</sup> ## UIAbilityContext.setMissionContinueState<sup>10+</sup>
...@@ -2249,8 +2422,9 @@ setMissionContinueState(state: AbilityConstant.ContinueState, callback:AsyncCall ...@@ -2249,8 +2422,9 @@ setMissionContinueState(state: AbilityConstant.ContinueState, callback:AsyncCall
```ts ```ts
import AbilityConstant from '@ohos.app.ability.AbilityConstant'; import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import { BusinessError } from '@ohos.base';
this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE, (result) => { this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE, (result: BusinessError) => {
console.info(`setMissionContinueState: ${JSON.stringify(result)}`); console.info(`setMissionContinueState: ${JSON.stringify(result)}`);
}); });
``` ```
...@@ -2288,10 +2462,11 @@ setMissionContinueState(state: AbilityConstant.ContinueState): Promise&lt;void&g ...@@ -2288,10 +2462,11 @@ setMissionContinueState(state: AbilityConstant.ContinueState): Promise&lt;void&g
```ts ```ts
import AbilityConstant from '@ohos.app.ability.AbilityConstant'; import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import { BusinessError } from '@ohos.base';
this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE).then(() => { this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE).then(() => {
console.info('success'); console.info('success');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`setMissionContinueState failed, code is ${err.code}, message is ${err.message}`); console.error(`setMissionContinueState failed, code is ${err.code}, message is ${err.message}`);
}); });
``` ```
...@@ -2351,7 +2526,7 @@ isTerminating(): boolean; ...@@ -2351,7 +2526,7 @@ isTerminating(): boolean;
**示例:** **示例:**
```ts ```ts
let isTerminating = this.context.isTerminating(); let isTerminating: boolean = this.context.isTerminating();
console.info(`ability state is ${isTerminating}`); console.info(`ability state is ${isTerminating}`);
``` ```
...@@ -2401,15 +2576,17 @@ requestDialogService(want: Want, result: AsyncCallback&lt;dialogRequest.RequestR ...@@ -2401,15 +2576,17 @@ requestDialogService(want: Want, result: AsyncCallback&lt;dialogRequest.RequestR
```ts ```ts
import dialogRequest from '@ohos.app.ability.dialogRequest'; import dialogRequest from '@ohos.app.ability.dialogRequest';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want = { let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'AuthAccountServiceExtension' abilityName: 'AuthAccountServiceExtension'
}; };
try { try {
this.context.requestDialogService(want, (err, result) => { this.context.requestDialogService(want, (err: BusinessError, result: dialogRequest.RequestResult) => {
if (err.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`requestDialogService failed, code is ${err.code}, message is ${err.message}`); console.error(`requestDialogService failed, code is ${err.code}, message is ${err.message}`);
...@@ -2420,7 +2597,9 @@ try { ...@@ -2420,7 +2597,9 @@ try {
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`requestDialogService failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`requestDialogService failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -2476,25 +2655,29 @@ requestDialogService(want: Want): Promise&lt;dialogRequest.RequestResult&gt;; ...@@ -2476,25 +2655,29 @@ requestDialogService(want: Want): Promise&lt;dialogRequest.RequestResult&gt;;
```ts ```ts
import dialogRequest from '@ohos.app.ability.dialogRequest'; import dialogRequest from '@ohos.app.ability.dialogRequest';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want = { let want: 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: dialogRequest.RequestResult) => {
// 执行正常业务 // 执行正常业务
console.info('requestDialogService succeed, result = ${JSON.stringify(result)}'); console.info('requestDialogService succeed, result = ${JSON.stringify(result)}');
}) })
.catch((err) => { .catch((err: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`requestDialogService failed, code is ${err.code}, message is ${err.message}`); console.error(`requestDialogService failed, code is ${err.code}, message is ${err.message}`);
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`requestDialogService failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`requestDialogService failed, code is ${code}, message is ${message}`);
} }
``` ```
## UIAbilityContext.startRecentAbility ## UIAbilityContext.startRecentAbility
...@@ -2544,13 +2727,16 @@ startRecentAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void; ...@@ -2544,13 +2727,16 @@ startRecentAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
try { try {
this.context.startRecentAbility(want, (err) => { this.context.startRecentAbility(want, (err: BusinessError) => {
if (err.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`); console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`);
...@@ -2561,7 +2747,9 @@ try { ...@@ -2561,7 +2747,9 @@ try {
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startRecentAbility failed failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startRecentAbility failed, code is ${code}, message is ${message}`);
} }
``` ```
## UIAbilityContext.startRecentAbility ## UIAbilityContext.startRecentAbility
...@@ -2613,17 +2801,21 @@ startRecentAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt ...@@ -2613,17 +2801,21 @@ startRecentAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '', deviceId: '',
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let options = { let options: StartOptions = {
windowMode: 0 windowMode: 0
}; };
try { try {
this.context.startRecentAbility(want, options, (err) => { this.context.startRecentAbility(want, options, (err: BusinessError) => {
if (err.code) { if (err.code) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`); console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`);
...@@ -2634,7 +2826,9 @@ try { ...@@ -2634,7 +2826,9 @@ try {
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startRecentAbility failed failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startRecentAbility failed, code is ${code}, message is ${message}`);
} }
``` ```
## UIAbilityContext.startRecentAbility ## UIAbilityContext.startRecentAbility
...@@ -2685,11 +2879,15 @@ startRecentAbility(want: Want, options?: StartOptions): Promise&lt;void&gt;; ...@@ -2685,11 +2879,15 @@ startRecentAbility(want: Want, options?: StartOptions): Promise&lt;void&gt;;
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let options = { let options: StartOptions = {
windowMode: 0, windowMode: 0,
}; };
...@@ -2699,13 +2897,15 @@ try { ...@@ -2699,13 +2897,15 @@ try {
// 执行正常业务 // 执行正常业务
console.info('startRecentAbility succeed'); console.info('startRecentAbility succeed');
}) })
.catch((err) => { .catch((err: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`); console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`);
}); });
} catch (err) { } catch (err) {
// 处理入参错误异常 // 处理入参错误异常
console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`startRecentAbility failed, code is ${code}, message is ${message}`);
} }
``` ```
...@@ -2761,13 +2961,17 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise&lt;Caller& ...@@ -2761,13 +2961,17 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise&lt;Caller&
**示例:** **示例:**
```ts ```ts
let caller; import { Caller } from '@ohos.app.ability.UIAbility';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let caller: Caller;
// 系统账号的账号ID, -1表示当前激活用户 // 系统账号的账号ID, -1表示当前激活用户
let accountId = -1; let accountId = -1;
// 指定启动的Ability // 指定启动的Ability
let want = { let want: Want = {
bundleName: 'com.acts.actscalleeabilityrely', bundleName: 'com.acts.actscalleeabilityrely',
moduleName: 'entry', moduleName: 'entry',
abilityName: 'EntryAbility', abilityName: 'EntryAbility',
...@@ -2780,11 +2984,11 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise&lt;Caller& ...@@ -2780,11 +2984,11 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise&lt;Caller&
try { try {
this.context.startAbilityByCallWithAccount(want, accountId) this.context.startAbilityByCallWithAccount(want, accountId)
.then((obj) => { .then((obj: Caller) => {
// 执行正常业务 // 执行正常业务
caller = obj; caller = obj;
console.log('startAbilityByCallWithAccount succeed'); console.log('startAbilityByCallWithAccount succeed');
}).catch((error) => { }).catch((error: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.error('startAbilityByCallWithAccount failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('startAbilityByCallWithAccount failed, error.code: ${error.code}, error.message: ${error.message}');
}); });
...@@ -2842,10 +3046,11 @@ starAbilityAsCaller(want: Want, callback: AsyncCallback\<void>): void; ...@@ -2842,10 +3046,11 @@ starAbilityAsCaller(want: Want, callback: AsyncCallback\<void>): void;
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import Want from '@ohos.app.ability.Want'; import Want from '@ohos.app.ability.Want';
export default class EntryAbility extends UIAbility { export default class EntryAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
// want包含启动该应用的Caller信息 // want包含启动该应用的Caller信息
let localWant: Want = want; let localWant: Want = want;
localWant.bundleName = 'com.example.demo'; localWant.bundleName = 'com.example.demo';
...@@ -2912,17 +3117,19 @@ startAbilityAsCaller(want: Want, options: StartOptions, callback: AsyncCallback\ ...@@ -2912,17 +3117,19 @@ startAbilityAsCaller(want: Want, options: StartOptions, callback: AsyncCallback\
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import StartOptions from '@ohos.app.ability.StartOptions';
import Want from '@ohos.app.ability.Want'; import Want from '@ohos.app.ability.Want';
export default class EntryAbility extends UIAbility { export default class EntryAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
// want包含启动该应用的Caller信息 // want包含启动该应用的Caller信息
let localWant: Want = want; let localWant: Want = want;
localWant.bundleName = 'com.example.demo'; localWant.bundleName = 'com.example.demo';
localWant.moduleName = 'entry'; localWant.moduleName = 'entry';
localWant.abilityName = 'TestAbility'; localWant.abilityName = 'TestAbility';
let option = { let option: StartOptions = {
displayId: 0 displayId: 0
} }
...@@ -2993,10 +3200,13 @@ startAbilityAsCaller(want: Want, options?: StartOptions): Promise\<void>; ...@@ -2993,10 +3200,13 @@ startAbilityAsCaller(want: Want, options?: StartOptions): Promise\<void>;
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import StartOptions from '@ohos.app.ability.StartOptions';
import Want from '@ohos.app.ability.Want'; import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
export default class EntryAbility extends UIAbility { export default class EntryAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
// want包含启动该应用的Caller信息 // want包含启动该应用的Caller信息
let localWant: Want = want; let localWant: Want = want;
localWant.bundleName = 'com.example.demo'; localWant.bundleName = 'com.example.demo';
...@@ -3012,7 +3222,7 @@ export default class EntryAbility extends UIAbility { ...@@ -3012,7 +3222,7 @@ export default class EntryAbility extends UIAbility {
.then(() => { .then(() => {
console.log('startAbilityAsCaller success.'); console.log('startAbilityAsCaller success.');
}) })
.catch((err) => { .catch((err: BusinessError) => {
console.error('startAbilityAsCaller failed, err:' + JSON.stringify(err)); console.error('startAbilityAsCaller failed, err:' + JSON.stringify(err));
}) })
} }
...@@ -3047,6 +3257,7 @@ reportDrawnCompleted(callback: AsyncCallback\<void>): void; ...@@ -3047,6 +3257,7 @@ reportDrawnCompleted(callback: AsyncCallback\<void>): void;
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import window from '@ohos.window'; import window from '@ohos.window';
import { BusinessError } from '@ohos.base';
export default class EntryAbility extends UIAbility { export default class EntryAbility extends UIAbility {
onWindowStageCreate(windowStage: window.WindowStage) { onWindowStageCreate(windowStage: window.WindowStage) {
...@@ -3066,7 +3277,9 @@ export default class EntryAbility extends UIAbility { ...@@ -3066,7 +3277,9 @@ export default class EntryAbility extends UIAbility {
}); });
} catch (err) { } catch (err) {
// 捕获同步的参数错误 // 捕获同步的参数错误
console.error(`reportDrawnCompleted failed, code is ${err.code}, message is ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`reportDrawnCompleted failed, code is ${code}, message is ${message}`);
} }
}); });
console.log("MainAbility onWindowStageCreate") console.log("MainAbility onWindowStageCreate")
......
...@@ -32,14 +32,15 @@ getWant(agent: WantAgent, callback: AsyncCallback\<Want\>): void ...@@ -32,14 +32,15 @@ getWant(agent: WantAgent, callback: AsyncCallback\<Want\>): void
**示例:** **示例:**
```ts ```ts
import WantAgent from '@ohos.wantAgent'; import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
console.info('==========================>getWantAgentCallback=======================>'); console.info('==========================>getWantAgentCallback=======================>');
if (err.code == 0) { if (err.code == 0) {
wantAgent = data; wantAgent = data;
...@@ -49,13 +50,13 @@ function getWantAgentCallback(err, data) { ...@@ -49,13 +50,13 @@ function getWantAgentCallback(err, data) {
} }
//getWant回调 //getWant回调
function getWantCallback(err, data) { let getWantCallback = (err: BusinessError, data: Want) => {
console.info('==========================>getWantCallback=======================>'); console.info('==========================>getWantCallback=======================>');
} }
WantAgent.getWant(wantAgent, getWantCallback); WantAgent.getWant(wantAgent, getWantCallback);
} }
//WantAgentInfo对象
let wantAgentInfo = { WantAgent.getWantAgent({
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -80,9 +81,7 @@ let wantAgentInfo = { ...@@ -80,9 +81,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}; }, getWantAgentCallback);
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback);
``` ```
## WantAgent.getWant ## WantAgent.getWant
...@@ -110,14 +109,13 @@ getWant(agent: WantAgent): Promise\<Want\> ...@@ -110,14 +109,13 @@ getWant(agent: WantAgent): Promise\<Want\>
**示例:** **示例:**
```ts ```ts
import WantAgent from '@ohos.wantAgent'; import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 WantAgent.getWantAgent({
let wantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -142,9 +140,7 @@ let wantAgentInfo = { ...@@ -142,9 +140,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
} }).then((data) => {
WantAgent.getWantAgent(wantAgentInfo).then((data) => {
console.info('==========================>getWantAgentCallback=======================>'); console.info('==========================>getWantAgentCallback=======================>');
wantAgent = data; wantAgent = data;
if (wantAgent) { if (wantAgent) {
...@@ -173,18 +169,19 @@ getWantAgent(info: WantAgentInfo, callback: AsyncCallback\<WantAgent\>): void ...@@ -173,18 +169,19 @@ getWantAgent(info: WantAgentInfo, callback: AsyncCallback\<WantAgent\>): void
**示例:** **示例:**
```ts ```ts
import WantAgent from '@ohos.wantAgent'; import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
import { BusinessError } from '@ohos.base';
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err.code) { if (err.code) {
console.info('getWantAgent Callback err:' + JSON.stringify(err)) console.info('getWantAgent Callback err:' + JSON.stringify(err))
} else { } else {
console.info('getWantAgent Callback success') console.info('getWantAgent Callback success')
} }
} }
//WantAgentInfo对象
let wantAgentInfo = { WantAgent.getWantAgent({
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -209,9 +206,7 @@ let wantAgentInfo = { ...@@ -209,9 +206,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
} }, getWantAgentCallback);
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback);
``` ```
## WantAgent.getWantAgent ## WantAgent.getWantAgent
...@@ -237,11 +232,9 @@ getWantAgent(info: WantAgentInfo): Promise\<WantAgent\> ...@@ -237,11 +232,9 @@ getWantAgent(info: WantAgentInfo): Promise\<WantAgent\>
**示例:** **示例:**
```ts ```ts
import WantAgent from '@ohos.wantAgent'; import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
WantAgent.getWantAgent({
//WantAgentInfo对象
let wantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -266,9 +259,7 @@ let wantAgentInfo = { ...@@ -266,9 +259,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
} }).then((data: _WantAgent) => {
WantAgent.getWantAgent(wantAgentInfo).then((data) => {
console.info('==========================>getWantAgentCallback=======================>'); console.info('==========================>getWantAgentCallback=======================>');
}); });
``` ```
...@@ -291,14 +282,14 @@ getBundleName(agent: WantAgent, callback: AsyncCallback\<string\>): void ...@@ -291,14 +282,14 @@ getBundleName(agent: WantAgent, callback: AsyncCallback\<string\>): void
**示例:** **示例:**
```ts ```ts
import WantAgent from '@ohos.wantAgent'; import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
console.info('==========================>getWantAgentCallback=======================>'); console.info('==========================>getWantAgentCallback=======================>');
if (err.code == 0) { if (err.code == 0) {
wantAgent = data; wantAgent = data;
...@@ -308,13 +299,13 @@ function getWantAgentCallback(err, data) { ...@@ -308,13 +299,13 @@ function getWantAgentCallback(err, data) {
} }
//getBundleName回调 //getBundleName回调
function getBundleNameCallback(err, data) { let getBundleNameCallback = (err: BusinessError, data: string) => {
console.info('==========================>getBundleNameCallback=======================>'); console.info('==========================>getBundleNameCallback=======================>');
} }
WantAgent.getBundleName(wantAgent, getBundleNameCallback); WantAgent.getBundleName(wantAgent, getBundleNameCallback);
} }
//WantAgentInfo对象
let wantAgentInfo = { WantAgent.getWantAgent({
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -339,9 +330,7 @@ let wantAgentInfo = { ...@@ -339,9 +330,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
} }, getWantAgentCallback)
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback)
``` ```
...@@ -369,13 +358,12 @@ getBundleName(agent: WantAgent): Promise\<string\> ...@@ -369,13 +358,12 @@ getBundleName(agent: WantAgent): Promise\<string\>
**示例:** **示例:**
```ts ```ts
import WantAgent from '@ohos.wantAgent'; import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 WantAgent.getWantAgent({
let wantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -400,9 +388,7 @@ let wantAgentInfo = { ...@@ -400,9 +388,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
} }).then((data: _WantAgent) => {
WantAgent.getWantAgent(wantAgentInfo).then((data) => {
console.info('==========================>getWantAgentCallback=======================>'); console.info('==========================>getWantAgentCallback=======================>');
wantAgent = data; wantAgent = data;
if (wantAgent) { if (wantAgent) {
...@@ -433,14 +419,14 @@ getUid(agent: WantAgent, callback: AsyncCallback\<number\>): void ...@@ -433,14 +419,14 @@ getUid(agent: WantAgent, callback: AsyncCallback\<number\>): void
**示例:** **示例:**
```ts ```ts
import WantAgent from '@ohos.wantAgent'; import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
console.info('==========================>getWantAgentCallback=======================>'); console.info('==========================>getWantAgentCallback=======================>');
if (err.code == 0) { if (err.code == 0) {
wantAgent = data; wantAgent = data;
...@@ -450,13 +436,13 @@ function getWantAgentCallback(err, data) { ...@@ -450,13 +436,13 @@ function getWantAgentCallback(err, data) {
} }
//getUid回调 //getUid回调
function getUidCallback(err, data) { let getUidCallback = (err: BusinessError, data: number) => {
console.info('==========================>getUidCallback=======================>'); console.info('==========================>getUidCallback=======================>');
} }
WantAgent.getUid(wantAgent, getUidCallback); WantAgent.getUid(wantAgent, getUidCallback);
} }
//WantAgentInfo对象
let wantAgentInfo = { WantAgent.getWantAgent({
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -481,9 +467,7 @@ let wantAgentInfo = { ...@@ -481,9 +467,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
} }, getWantAgentCallback)
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback)
``` ```
...@@ -511,14 +495,12 @@ getUid(agent: WantAgent): Promise\<number\> ...@@ -511,14 +495,12 @@ getUid(agent: WantAgent): Promise\<number\>
**示例:** **示例:**
```ts ```ts
import WantAgent from '@ohos.wantAgent'; import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 WantAgent.getWantAgent({
let wantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -543,9 +525,7 @@ let wantAgentInfo = { ...@@ -543,9 +525,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
} }).then((data) => {
WantAgent.getWantAgent(wantAgentInfo).then((data) => {
console.info('==========================>getWantAgentCallback=======================>'); console.info('==========================>getWantAgentCallback=======================>');
wantAgent = data; wantAgent = data;
if (wantAgent) { if (wantAgent) {
...@@ -575,14 +555,14 @@ cancel(agent: WantAgent, callback: AsyncCallback\<void\>): void ...@@ -575,14 +555,14 @@ cancel(agent: WantAgent, callback: AsyncCallback\<void\>): void
**示例:** **示例:**
```ts ```ts
import WantAgent from '@ohos.wantAgent'; import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
console.info('==========================>getWantAgentCallback=======================>'); console.info('==========================>getWantAgentCallback=======================>');
if (err.code == 0) { if (err.code == 0) {
wantAgent = data; wantAgent = data;
...@@ -592,13 +572,13 @@ function getWantAgentCallback(err, data) { ...@@ -592,13 +572,13 @@ function getWantAgentCallback(err, data) {
} }
//cancel回调 //cancel回调
function cancelCallback(err, data) { let cancelCallback = (err: BusinessError) => {
console.info('==========================>cancelCallback=======================>'); console.info('==========================>cancelCallback=======================>');
} }
WantAgent.cancel(wantAgent, cancelCallback); WantAgent.cancel(wantAgent, cancelCallback);
} }
//WantAgentInfo对象
let wantAgentInfo = { WantAgent.getWantAgent({
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -623,9 +603,7 @@ let wantAgentInfo = { ...@@ -623,9 +603,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
} }, getWantAgentCallback)
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback)
``` ```
...@@ -653,41 +631,38 @@ cancel(agent: WantAgent): Promise\<void\> ...@@ -653,41 +631,38 @@ cancel(agent: WantAgent): Promise\<void\>
**示例:** **示例:**
```ts ```ts
import WantAgent from '@ohos.wantAgent'; import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 WantAgent.getWantAgent({
let wantAgentInfo = {
wants: [ wants: [
{
deviceId: 'deviceId',
bundleName: 'com.neu.setResultOnAbilityResultTest1',
abilityName: 'com.example.test.EntryAbility',
action: 'action1',
entities: ['entity1'],
type: 'MIMETYPE',
uri: 'key={true,true,false}',
parameters:
{ {
deviceId: 'deviceId', mykey0: 2222,
bundleName: 'com.neu.setResultOnAbilityResultTest1', mykey1: [1, 2, 3],
abilityName: 'com.example.test.EntryAbility', mykey2: '[1, 2, 3]',
action: 'action1', mykey3: 'ssssssssssssssssssssssssss',
entities: ['entity1'], mykey4: [false, true, false],
type: 'MIMETYPE', mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
uri: 'key={true,true,false}', mykey6: true,
parameters:
{
mykey0: 2222,
mykey1: [1, 2, 3],
mykey2: '[1, 2, 3]',
mykey3: 'ssssssssssssssssssssssssss',
mykey4: [false, true, false],
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true,
}
} }
], }
],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
} }).then((data) => {
WantAgent.getWantAgent(wantAgentInfo).then((data) => {
console.info('==========================>getWantAgentCallback=======================>'); console.info('==========================>getWantAgentCallback=======================>');
wantAgent = data; wantAgent = data;
if (wantAgent) { if (wantAgent) {
...@@ -719,14 +694,14 @@ trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: Callback\<Complet ...@@ -719,14 +694,14 @@ trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: Callback\<Complet
**示例:** **示例:**
```ts ```ts
import WantAgent from '@ohos.wantAgent'; import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
console.info('==========================>getWantAgentCallback=======================>'); console.info('==========================>getWantAgentCallback=======================>');
if (err.code == 0) { if (err.code == 0) {
wantAgent = data; wantAgent = data;
...@@ -736,17 +711,14 @@ function getWantAgentCallback(err, data) { ...@@ -736,17 +711,14 @@ function getWantAgentCallback(err, data) {
} }
//trigger回调 //trigger回调
function triggerCallback(data) { let triggerCallback = (data: WantAgent.CompleteData) => {
console.info('==========================>triggerCallback=======================>'); console.info('==========================>triggerCallback=======================>');
} }
var triggerInfo = { WantAgent.trigger(wantAgent, {code:0}, triggerCallback)
code:0
}
WantAgent.trigger(wantAgent, triggerInfo, triggerCallback)
} }
//WantAgentInfo对象
let wantAgentInfo = { WantAgent.getWantAgent({
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -771,9 +743,7 @@ let wantAgentInfo = { ...@@ -771,9 +743,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
} }, getWantAgentCallback)
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback)
``` ```
...@@ -797,15 +767,15 @@ equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback\<boolean\ ...@@ -797,15 +767,15 @@ equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback\<boolean\
**示例:** **示例:**
```ts ```ts
import WantAgent from '@ohos.wantAgent'; import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent1; let wantAgent1: _WantAgent;
let wantAgent2; let wantAgent2: _WantAgent;
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
console.info('==========================>getWantAgentCallback=======================>'); console.info('==========================>getWantAgentCallback=======================>');
if (err.code == 0) { if (err.code == 0) {
wantAgent1 = data; wantAgent1 = data;
...@@ -816,13 +786,13 @@ function getWantAgentCallback(err, data) { ...@@ -816,13 +786,13 @@ function getWantAgentCallback(err, data) {
} }
//equal回调 //equal回调
function equalCallback(err, data) { let equalCallback = (err: BusinessError, data: boolean) => {
console.info('==========================>equalCallback=======================>'); console.info('==========================>equalCallback=======================>');
} }
WantAgent.equal(wantAgent1, wantAgent2, equalCallback) WantAgent.equal(wantAgent1, wantAgent2, equalCallback)
} }
//WantAgentInfo对象
let wantAgentInfo = { WantAgent.getWantAgent({
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -847,9 +817,7 @@ let wantAgentInfo = { ...@@ -847,9 +817,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
} }, getWantAgentCallback)
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback)
``` ```
...@@ -878,15 +846,15 @@ equal(agent: WantAgent, otherAgent: WantAgent): Promise\<boolean\> ...@@ -878,15 +846,15 @@ equal(agent: WantAgent, otherAgent: WantAgent): Promise\<boolean\>
**示例:** **示例:**
```ts ```ts
import WantAgent from '@ohos.wantAgent'; import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent1; let wantAgent1: _WantAgent;
let wantAgent2; let wantAgent2: _WantAgent;
//WantAgentInfo对象 WantAgent.getWantAgent({
let wantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -911,9 +879,7 @@ let wantAgentInfo = { ...@@ -911,9 +879,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
} }).then((data) => {
WantAgent.getWantAgent(wantAgentInfo).then((data) => {
console.info('==========================>getWantAgentCallback=======================>'); console.info('==========================>getWantAgentCallback=======================>');
wantAgent1 = data; wantAgent1 = data;
wantAgent2 = data; wantAgent2 = data;
...@@ -923,10 +889,6 @@ WantAgent.getWantAgent(wantAgentInfo).then((data) => { ...@@ -923,10 +889,6 @@ WantAgent.getWantAgent(wantAgentInfo).then((data) => {
}); });
} }
}); });
WantAgent.equal(wantAgent1, wantAgent2).then((data) => {
console.info('==========================>equalCallback=======================>');
});
``` ```
## WantAgentFlags ## WantAgentFlags
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册