Skip to content

D
Docs

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

通知 161
Star 293
Fork 28
D
Docs
提交 10998067 编写于 作者: L liuliu
浏览文件
操作

ability api 

Signed-off-by: Nliuliu <liuliu40@huawei.com>
Change-Id: I17606ce668ee9b396808194a937f10916448c458
上级 a137aadf
隐藏空白更改
内联 并排
Showing with 2598 addition and 1480 deletion
zh-cn/application-dev/reference/apis/js-apis-ability-dataUriUtils.md
浏览文件 @ 10998067
......@@ -35,6 +35,8 @@ getId(uri: string): number
**示例：**
```ts
import dataUriUtils from '@ohos.ability.dataUriUtils';
let id = dataUriUtils.getId('com.example.dataUriUtils/1221');
```
......@@ -64,6 +66,8 @@ attachId(uri: string, id: number): string
**示例：**
```ts
import dataUriUtils from '@ohos.ability.dataUriUtils';
let id = 1122;
let uri = dataUriUtils.attachId(
'com.example.dataUriUtils',
......@@ -96,6 +100,8 @@ deleteId(uri: string): string
**示例：**
```ts
import dataUriUtils from '@ohos.ability.dataUriUtils';
let uri = dataUriUtils.deleteId('com.example.dataUriUtils/1221');
```
......@@ -125,6 +131,8 @@ updateId(uri: string, id: number): string
**示例：**
```ts
import dataUriUtils from '@ohos.ability.dataUriUtils';
let id = 1122;
let uri = dataUriUtils.updateId(
'com.example.dataUriUtils/1221',
......
zh-cn/application-dev/reference/apis/js-apis-ability-featureAbility.md
浏览文件 @ 10998067
......@@ -587,15 +587,7 @@ connectAbility(request: Want, options:ConnectOptions): number
```ts
import rpc from '@ohos.rpc';
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(
{
deviceId: '',
......@@ -603,9 +595,15 @@ let connectId = featureAbility.connectAbility(
abilityName: 'com.ix.ServiceAbility.ServiceAbilityA',
},
{
onConnect: onConnectCallback,
onDisconnect: onDisconnectCallback,
onFailed: onFailedCallback,
onConnect: (element, remote) => {
console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
},
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
```ts
import rpc from '@ohos.rpc';
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(
{
bundleName: 'com.ix.ServiceAbility',
abilityName: 'com.ix.ServiceAbility.ServiceAbilityA',
},
{
onConnect: onConnectCallback,
onDisconnect: onDisconnectCallback,
onFailed: onFailedCallback,
onConnect: (element, remote) => {
console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
},
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>
```ts
import rpc from '@ohos.rpc';
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}');
}
import { BusinessError } from '@ohos.base';
let connectId = featureAbility.connectAbility(
{
bundleName: 'com.ix.ServiceAbility',
abilityName: 'com.ix.ServiceAbility.ServiceAbilityA',
},
{
onConnect: onConnectCallback,
onDisconnect: onDisconnectCallback,
onFailed: onFailedCallback,
onConnect: (element, remote) => {
console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
},
onDisconnect: (element) => {
console.log('ConnectAbility onDisconnect element.deviceId : ${element.deviceId}');
},
onFailed: (code) => {
console.error('featureAbilityTest ConnectAbility onFailed errCode : ${code}');
},
},
);
featureAbility.disconnectAbility(connectId).then((data) => {
console.log('data: ${data)}')
}).catch((error)=>{
}).catch((error: BusinessError)=>{
console.error('featureAbilityTest result errCode : ${error.code}');
});
```
......@@ -731,7 +726,11 @@ getWindow(callback: AsyncCallback\<window.Window>): void
**示例：**
```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) {
console.error('getWindow fail, error: ${JSON.stringify(error)}');
} else {
......@@ -757,6 +756,8 @@ getWindow(): Promise\<window.Window>;
**示例：**
```ts
import featureAbility from '@ohos.ability.featureAbility';
featureAbility.getWindow().then((data) => {
console.info('getWindow data: ${typeof(data)}');
});
......
zh-cn/application-dev/reference/apis/js-apis-ability-particleAbility.md
浏览文件 @ 10998067
......@@ -233,8 +233,9 @@ startBackgroundRunning(id: number, request: NotificationRequest, callback: Async
import notification from '@ohos.notification';
import particleAbility from '@ohos.ability.particleAbility';
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) {
console.error('Operation failed error: ${JSON.stringify(error)}');
} else {
......@@ -242,7 +243,7 @@ function callback(error, data) {
}
}
let wantAgentInfo = {
let wantAgentInfo: wantAgent.WantAgentInfo = {
wants: [
{
bundleName: 'com.example.myapplication',
......@@ -255,20 +256,19 @@ let wantAgentInfo = {
};
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;
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
import notification from '@ohos.notification';
import particleAbility from '@ohos.ability.particleAbility';
import wantAgent from '@ohos.app.ability.wantAgent';
import { BusinessError } from '@ohos.base';
let wantAgentInfo = {
let wantAgentInfo: wantAgent.WantAgentInfo = {
wants: [
{
bundleName: 'com.example.myapplication',
......@@ -316,22 +317,21 @@ let wantAgentInfo = {
};
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;
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');
}).catch((err) => {
}).catch((err: BusinessError) => {
console.error('Operation failed cause: ${JSON.stringify(err)}');
});
});
......@@ -356,8 +356,9 @@ cancelBackgroundRunning(callback: AsyncCallback&lt;void&gt;): void;
```ts
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) {
console.error('Operation failed error: ${JSON.stringify(error)}');
} else {
......@@ -390,7 +391,7 @@ import particleAbility from '@ohos.ability.particleAbility';
particleAbility.cancelBackgroundRunning().then(() => {
console.info('Operation succeeded');
}).catch((err) => {
}).catch((err: BusinessError) => {
console.error('Operation failed cause: ${JSON.stringify(err)}');
});
......@@ -424,33 +425,27 @@ connectAbility(request: Want, options:ConnectOptions): number
import particleAbility from '@ohos.ability.particleAbility';
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(
{
bundleName: 'com.ix.ServiceAbility',
abilityName: 'ServiceAbilityA',
},
{
onConnect: onConnectCallback,
onDisconnect: onDisconnectCallback,
onFailed: onFailedCallback,
onConnect: (element, remote) => {
console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
},
onDisconnect: (element) => {
console.log('ConnectAbility onDisconnect element.deviceId: ${element.deviceId}');
},
onFailed: (code) => {
console.error('particleAbilityTest ConnectAbility onFailed errCode: ${code}');
},
},
);
particleAbility.disconnectAbility(connId).then((data) => {
console.log('data: ${data}');
}).catch((error) => {
}).catch((error: BusinessError) => {
console.error('particleAbilityTest result errCode: ${error.code}');
});
```
......@@ -475,27 +470,21 @@ disconnectAbility(connection: number, callback:AsyncCallback\<void>): void;
import particleAbility from '@ohos.ability.particleAbility';
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(
{
bundleName: 'com.ix.ServiceAbility',
abilityName: 'ServiceAbilityA',
},
{
onConnect: onConnectCallback,
onDisconnect: onDisconnectCallback,
onFailed: onFailedCallback,
onConnect: (element, remote) => {
console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
},
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>;
```ts
import particleAbility from '@ohos.ability.particleAbility';
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}');
}
import { BusinessError } from '@ohos.base';
let connId = particleAbility.connectAbility(
{
......@@ -543,18 +521,23 @@ let connId = particleAbility.connectAbility(
abilityName: 'ServiceAbilityA',
},
{
onConnect: onConnectCallback,
onDisconnect: onDisconnectCallback,
onFailed: onFailedCallback,
onConnect: (element, remote) => {
console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
},
onDisconnect: (element) => {
console.log('ConnectAbility onDisconnect element.deviceId: ${element.deviceId}');
},
onFailed: (code) => {
console.error('particleAbilityTest ConnectAbility onFailed errCode: ${code}');
},
},
);
particleAbility.disconnectAbility(connId).then((data) => {
console.log(' data: ${data}');
}).catch((error) => {
}).catch((error: BusinessError) => {
console.error('particleAbilityTest result errCode : ${error.code}');
});
```
## ErrorCode
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-ability.md
浏览文件 @ 10998067
......@@ -31,9 +31,10 @@ onConfigurationUpdate(newConfig: Configuration): void;
```ts
// Ability是顶层基类，不支持开发者直接继承。故以派生类UIAbility举例说明。
import UIAbility from '@ohos.app.ability.UIAbility';
import { Configuration } from '@ohos.app.ability.Configuration';
class MyUIAbility extends UIAbility {
onConfigurationUpdate(config) {
onConfigurationUpdate(config: Configuration) {
console.log('onConfigurationUpdate, config: ${JSON.stringify(config)}');
}
}
......@@ -58,9 +59,10 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
```ts
// Ability是顶层基类，不支持开发者直接继承。故以派生类UIAbility举例说明。
import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyUIAbility extends UIAbility {
onMemoryLevel(level) {
onMemoryLevel(level: AbilityConstant.MemoryLevel) {
console.log('onMemoryLevel, level: ${JSON.stringify(level)}');
}
}
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md
浏览文件 @ 10998067
......@@ -45,9 +45,11 @@ Ability初次启动原因，该类型为枚举，可配合[Ability](js-apis-app-
```ts
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 {
onCreate(want, launchParam) {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
if (launchParam.launchReason === AbilityConstant.LaunchReason.START_ABILITY) {
console.log('The ability has been started by the way of startAbility.');
}
......@@ -77,9 +79,11 @@ Ability上次退出原因，该类型为枚举，可配合[Ability](js-apis-app-
```ts
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 {
onCreate(want, launchParam) {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
if (launchParam.lastExitReason === AbilityConstant.LastExitReason.ABILITY_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
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyAbility extends UIAbility {
onContinue(wantParam) {
onContinue(wantParam: Record<string, Object>) {
return AbilityConstant.OnContinueResult.AGREE;
}
}
......@@ -130,18 +135,22 @@ class MyAbility extends UIAbility {
**示例：**
```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',
abilityName: 'EntryAbility'
};
let option = {
let option: StartOptions = {
windowMode: AbilityConstant.WindowMode.WINDOW_MODE_FULLSCREEN
};
// 确保从上下文获取到context
this.context.startAbility(want, option).then(()=>{
console.log('Succeed to start ability.');
}).catch((error)=>{
}).catch((error: BusinessError)=>{
console.error('Failed to start ability with error: ${JSON.stringify(error)}');
});
```
......@@ -162,9 +171,10 @@ this.context.startAbility(want, option).then(()=>{
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyAbility extends UIAbility {
onMemoryLevel(level) {
onMemoryLevel(level: AbilityConstant.MemoryLevel) {
if (level === AbilityConstant.MemoryLevel.MEMORY_LEVEL_CRITICAL) {
console.log('The memory of device is critical, please release some memory.');
}
......@@ -191,9 +201,10 @@ class MyAbility extends UIAbility {
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyAbility extends UIAbility {
onSaveState(reason, wantParam) {
onSaveState(reason: AbilityConstant.StateType, wantParam: Record<string, Object>) {
return AbilityConstant.OnSaveResult.ALL_AGREE;
}
}
......@@ -214,9 +225,10 @@ class MyAbility extends UIAbility {
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyAbility extends UIAbility {
onSaveState(reason, wantParam) {
onSaveState(reason: AbilityConstant.StateType, wantParam: Record<string, Object>) {
if (reason === AbilityConstant.StateType.CONTINUATION) {
console.log('Save the ability data when the ability continuation.');
}
......@@ -240,8 +252,9 @@ ContinueState说明枚举值。用于表示当前应用任务流转的状态。
```ts
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)}`);
});
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityDelegatorRegistry.md
浏览文件 @ 10998067
......@@ -45,10 +45,11 @@ getAbilityDelegator(): AbilityDelegator
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import Want from '@ohos.app.ability.Want';
let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
let want = {
let want: Want = {
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
};
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityLifecycleCallback.md
浏览文件 @ 10998067
......@@ -29,7 +29,9 @@ onAbilityCreate(ability: UIAbility): void;
**示例：**
```ts
let abilityLifecycleCallback = {
import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onAbilityCreate(ability){
console.log('AbilityLifecycleCallback onAbilityCreate.');
}
......@@ -53,7 +55,9 @@ onWindowStageCreate(ability: UIAbility, windowStage: window.WindowStage): void;
**示例：**
```ts
let abilityLifecycleCallback = {
import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onWindowStageCreate(ability, windowStage){
console.log('AbilityLifecycleCallback onWindowStageCreate.');
}
......@@ -77,7 +81,9 @@ onWindowStageActive(ability: UIAbility, windowStage: window.WindowStage): void;
**示例：**
```ts
let abilityLifecycleCallback = {
import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onWindowStageActive(ability, windowStage){
console.log('AbilityLifecycleCallback onWindowStageActive.');
}
......@@ -101,7 +107,9 @@ onWindowStageInactive(ability: UIAbility, windowStage: window.WindowStage): void
**示例：**
```ts
let abilityLifecycleCallback = {
import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onWindowStageInactive(ability, windowStage){
console.log('AbilityLifecycleCallback onWindowStageInactive.');
}
......@@ -125,7 +133,9 @@ onWindowStageDestroy(ability: UIAbility, windowStage: window.WindowStage): void;
**示例：**
```ts
let abilityLifecycleCallback = {
import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onWindowStageDestroy(ability, windowStage){
console.log('AbilityLifecycleCallback onWindowStageDestroy.');
}
......@@ -148,7 +158,9 @@ onAbilityDestroy(ability: UIAbility): void;
**示例：**
```ts
let abilityLifecycleCallback = {
import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onAbilityDestroy(ability){
console.log('AbilityLifecycleCallback onAbilityDestroy.');
}
......@@ -171,7 +183,9 @@ onAbilityForeground(ability: UIAbility): void;
**示例：**
```ts
let abilityLifecycleCallback = {
import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onAbilityForeground(ability){
console.log('AbilityLifecycleCallback onAbilityForeground.');
}
......@@ -194,7 +208,9 @@ onAbilityBackground(ability: UIAbility): void;
**示例：**
```ts
let abilityLifecycleCallback = {
import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onAbilityBackground(ability){
console.log('AbilityLifecycleCallback onAbilityBackground.');
}
......@@ -217,7 +233,9 @@ onAbilityContinue(ability: UIAbility): void;
**示例：**
```ts
let abilityLifecycleCallback = {
import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onAbilityContinue(ability){
console.log('AbilityLifecycleCallback onAbilityContinue.');
}
......@@ -227,15 +245,40 @@ let 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
```ts
import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
import AbilityStage from '@ohos.app.ability.AbilityStage';
import UIAbility from '@ohos.app.ability.UIAbility';
import { GlobalContext } from '../GlobalContext'
// 声明ability生命周期回调，需配置所有回调后才可以在applicationContext注册
let abilityLifecycleCallback = {
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onAbilityCreate(ability){
console.log('AbilityLifecycleCallback onAbilityCreate.');
},
......@@ -272,7 +315,8 @@ export default class MyFirstAbility extends UIAbility {
let applicationContext = this.context.getApplicationContext();
// 2.通过applicationContext注册监听应用内生命周期
try {
globalThis.lifecycleId = applicationContext.on('abilityLifecycle', abilityLifecycleCallback);
let lifecycleId = applicationContext.on('abilityLifecycle', abilityLifecycleCallback);
GlobalContext.getContext().setObject("lifecycleId", lifecycleId);
console.log('registerAbilityLifecycleCallback lifecycleId: ${globalThis.lifecycleId}');
} catch (paramError) {
console.error('error: ${paramError.code}, ${paramError.message}');
......@@ -284,12 +328,14 @@ export default class MyFirstAbility extends UIAbility {
MySecondAbility.ts
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import { GlobalContext } from '../GlobalContext'
export default class MySecondAbility extends UIAbility {
onDestroy() {
let applicationContext = this.context.getApplicationContext();
let lifecycleId: number = GlobalContext.getContext().getObject("lifecycleId");
// 3.通过applicationContext注销监听应用内生命周期
applicationContext.off('abilityLifecycle', globalThis.lifecycleId, (error) => {
applicationContext.off('abilityLifecycle', lifecycleId, (error) => {
if (error && error.code !== 0) {
console.error('unregisterAbilityLifecycleCallback fail, error: ${JSON.stringify(error)}');
} else {
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md
浏览文件 @ 10998067
......@@ -59,9 +59,10 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void
```ts
import abilityManager from '@ohos.app.ability.abilityManager';
import { Configuration } from '@ohos.app.ability.Configuration';
import ConfigurationConstant from '@ohos.app.ability.ConfigurationConstant';
const config = {
const config: Configuration = {
language: 'Zh-Hans', // 简体中文
colorMode: ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT, // 浅色模式
direction: ConfigurationConstant.Direction.DIRECTION_VERTICAL, // 垂直方向
......@@ -117,9 +118,11 @@ updateConfiguration(config: Configuration): Promise\<void>
```ts
import abilityManager from '@ohos.app.ability.abilityManager';
import { Configuration } from '@ohos.app.ability.Configuration';
import ConfigurationConstant from '@ohos.app.ability.ConfigurationConstant';
import { BusinessError } from '@ohos.base';
const config = {
const config: Configuration = {
language: 'Zh-Hans', // 简体中文
colorMode: ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT, // 浅色模式
direction: ConfigurationConstant.Direction.DIRECTION_VERTICAL, // 垂直方向
......@@ -131,7 +134,7 @@ const config = {
try {
abilityManager.updateConfiguration(config).then(() => {
console.log('updateConfiguration success.');
}).catch((err) => {
}).catch((err: BusinessError) => {
console.error('updateConfiguration fail, err: ${JSON.stringify(err)}');
});
} catch (paramError) {
......@@ -209,11 +212,12 @@ getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>>
```ts
import abilityManager from '@ohos.app.ability.abilityManager';
import { BusinessError } from '@ohos.base';
try {
abilityManager.getAbilityRunningInfos().then((data) => {
console.log('getAbilityRunningInfos success, data: ${JSON.stringify(data)}');
}).catch((err) => {
}).catch((err: BusinessError) => {
console.error('getAbilityRunningInfos fail, err: ${JSON.stringify(err)}');
});
} catch (paramError) {
......@@ -300,13 +304,14 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn
```ts
import abilityManager from '@ohos.app.ability.abilityManager';
import { BusinessError } from '@ohos.base';
let upperLimit = 10;
try {
abilityManager.getExtensionRunningInfos(upperLimit).then((data) => {
console.log('getExtensionRunningInfos success, data: ${JSON.stringify(data)}');
}).catch((err) => {
}).catch((err: BusinessError) => {
console.error('getExtensionRunningInfos fail, err: ${JSON.stringify(err)}');
});
} catch (paramError) {
......@@ -376,10 +381,11 @@ getTopAbility(): Promise\<ElementName>;
```ts
import abilityManager from '@ohos.app.ability.abilityManager';
import { BusinessError } from '@ohos.base';
abilityManager.getTopAbility().then((data) => {
console.log('getTopAbility success, data: ${JSON.stringify(data)}');
}).catch((err) => {
}).catch((err: BusinessError) => {
console.error('getTopAbility fail, err: ${JSON.stringify(err)}');
});
```
......@@ -413,6 +419,8 @@ acquireShareData(missionId: number, callback: AsyncCallback<{[key: string]: Obje
```ts
import abilityManager from '@ohos.app.ability.abilityManager';
import { BusinessError } from '@ohos.base';
try {
abilityManager.acquireShareData(1, (err, wantParam) => {
if (err) {
......@@ -422,7 +430,9 @@ try {
}
});
} 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}>;
```ts
import abilityManager from '@ohos.app.ability.abilityManager';
import { BusinessError } from '@ohos.base';
try {
abilityManager.acquireShareData(1).then((wantParam) => {
console.log(`acquireShareData success, data: ${JSON.stringify(wantParam)}`);
}).catch((err) => {
}).catch((err: BusinessError) => {
console.error(`acquireShareData fail, err: ${JSON.stringify(err)}`);
});
} 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
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityStage.md
浏览文件 @ 10998067
......@@ -60,9 +60,10 @@ onAcceptWant(want: Want): string;
```ts
import AbilityStage from '@ohos.app.ability.AbilityStage';
import Want from '@ohos.app.ability.Want';
class MyAbilityStage extends AbilityStage {
onAcceptWant(want) {
onAcceptWant(want: Want) {
console.log('MyAbilityStage.onAcceptWant called');
return 'com.example.test';
}
......@@ -88,9 +89,10 @@ onConfigurationUpdate(newConfig: Configuration): void;
```ts
import AbilityStage from '@ohos.app.ability.AbilityStage';
import { Configuration } from '@ohos.app.ability.Configuration';
class MyAbilityStage extends AbilityStage {
onConfigurationUpdate(config) {
onConfigurationUpdate(config: Configuration) {
console.log('onConfigurationUpdate, language: ${config.language}');
}
}
......@@ -114,9 +116,10 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
```ts
import AbilityStage from '@ohos.app.ability.AbilityStage';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyAbilityStage extends AbilityStage {
onMemoryLevel(level) {
onMemoryLevel(level: AbilityConstant.MemoryLevel) {
console.log('onMemoryLevel, level: ${JSON.stringify(level)}');
}
}
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md
浏览文件 @ 10998067
......@@ -75,10 +75,11 @@ static isRunningInStabilityTest(): Promise&lt;boolean&gt;
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
appManager.isRunningInStabilityTest().then((flag) => {
console.log(`The result of isRunningInStabilityTest is: ${JSON.stringify(flag)}`);
}).catch((error) => {
}).catch((error: BusinessError) => {
console.error(`error: ${JSON.stringify(error)}`);
});
```
......@@ -110,10 +111,11 @@ isRamConstrainedDevice(): Promise\<boolean>;
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
appManager.isRamConstrainedDevice().then((data) => {
console.log(`The result of isRamConstrainedDevice is: ${JSON.stringify(data)}`);
}).catch((error) => {
}).catch((error: BusinessError) => {
console.error(`error: ${JSON.stringify(error)}`);
});
```
......@@ -180,10 +182,11 @@ getAppMemorySize(): Promise\<number>;
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError} from '@ohos.base'
appManager.getAppMemorySize().then((data) => {
console.log(`The size of app memory is: ${JSON.stringify(data)}`);
}).catch((error) => {
}).catch((error: BusinessError) => {
console.error(`error: ${JSON.stringify(error)}`);
});
```
......@@ -252,10 +255,11 @@ getRunningProcessInformation(): Promise\<Array\<ProcessInformation>>;
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
appManager.getRunningProcessInformation().then((data) => {
console.log(`The running process information is: ${JSON.stringify(data)}`);
}).catch((error) => {
}).catch((error: BusinessError) => {
console.error(`error: ${JSON.stringify(error)}`);
});
```
......@@ -335,12 +339,13 @@ isSharedBundleRunning(bundleName: string, versionCode: number): Promise\<boolean
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
const bundleName = "this is a bundleName";
const versionCode = 1;
appManager.isSharedBundleRunning(bundleName, versionCode).then((data) => {
console.log(`The shared bundle running is: ${JSON.stringify(data)}`);
}).catch((error) => {
}).catch((error: BusinessError) => {
console.error(`error: ${JSON.stringify(error)}`);
});
```
......@@ -430,8 +435,9 @@ on(type: 'applicationState', observer: ApplicationStateObserver): number;
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let applicationStateObserver = {
let applicationStateObserver: appManager.ApplicationStateObserver = {
onForegroundApplicationChanged(appStateData) {
console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`);
},
......@@ -452,7 +458,9 @@ try {
const observerId = appManager.on('applicationState', applicationStateObserver);
console.log(`[appManager] observerCode: ${observerId}`);
} 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} `);
}
```
......@@ -498,8 +506,9 @@ on(type: 'applicationState', observer: ApplicationStateObserver, bundleNameList:
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let applicationStateObserver = {
let applicationStateObserver: appManager.ApplicationStateObserver = {
onForegroundApplicationChanged(appStateData) {
console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`);
},
......@@ -521,7 +530,9 @@ try {
const observerId = appManager.on('applicationState', applicationStateObserver, bundleNameList);
console.log(`[appManager] observerCode: ${observerId}`);
} 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} `);
}
```
......@@ -561,11 +572,12 @@ off(type: 'applicationState', observerId: number, callback: AsyncCallback\<void
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let observerId = 0;
// 1.注册应用状态监听器
let applicationStateObserver = {
let applicationStateObserver: appManager.ApplicationStateObserver = {
onForegroundApplicationChanged(appStateData) {
console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`);
},
......@@ -587,11 +599,13 @@ try {
observerId = appManager.on('applicationState', applicationStateObserver, bundleNameList);
console.log(`[appManager] observerCode: ${observerId}`);
} 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.注销应用状态监听器
function unregisterApplicationStateObserverCallback(err) {
function unregisterApplicationStateObserverCallback(err: BusinessError) {
if (err) {
console.error(`unregisterApplicationStateObserverCallback fail, err: ${JSON.stringify(err)}`);
} else {
......@@ -601,7 +615,9 @@ function unregisterApplicationStateObserverCallback(err) {
try {
appManager.off('applicationState', observerId, unregisterApplicationStateObserverCallback);
} 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} `);
}
```
......@@ -646,11 +662,12 @@ off(type: 'applicationState', observerId: number): Promise\<void>;
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let observerId = 0;
// 1.注册应用状态监听器
let applicationStateObserver = {
let applicationStateObserver: appManager.ApplicationStateObserver = {
onForegroundApplicationChanged(appStateData) {
console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`);
},
......@@ -670,20 +687,23 @@ let applicationStateObserver = {
let bundleNameList = ['bundleName1', 'bundleName2'];
try {
observerId = appManager.on('applicationState', applicationStateObserver, bundleNameList);
console.log(`[appManager] observerCode: ${observerId}`);
} 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.注销应用状态监听器
try {
appManager.off('applicationState', observerId).then((data) => {
console.log(`unregisterApplicationStateObserver success, data: ${JSON.stringify(data)}`);
}).catch((err) => {
}).catch((err: BusinessError) => {
console.error(`unregisterApplicationStateObserver fail, err: ${JSON.stringify(err)}`);
});
} 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} `);
}
```
......@@ -724,8 +744,9 @@ on(type: 'applicationStateEvent', observer: ApplicationStateObserver): number;
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let applicationStateObserver = {
let applicationStateObserver: appManager.ApplicationStateObserver = {
onForegroundApplicationChanged(appStateData) {
console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`);
},
......@@ -746,7 +767,9 @@ try {
const observerId = appManager.on('applicationStateEvent', applicationStateObserver);
console.log(`[appManager] observerCode: ${observerId}`);
} 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} `);
}
```
......@@ -788,8 +811,9 @@ on(type: 'applicationStateEvent', observer: ApplicationStateObserver, bundleName
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let applicationStateObserver = {
let applicationStateObserver: appManager.ApplicationStateObserver = {
onForegroundApplicationChanged(appStateData) {
console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`);
},
......@@ -811,7 +835,9 @@ try {
const observerId = appManager.on('applicationStateEvent', applicationStateObserver, bundleNameList);
console.log(`[appManager] observerCode: ${observerId}`);
} 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} `);
}
```
......@@ -847,11 +873,12 @@ off(type: 'applicationStateEvent', observerId: number): void;
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let observerId = 0;
// 1.注册应用状态监听器
let applicationStateObserver = {
let applicationStateObserver: appManager.ApplicationStateObserver = {
onForegroundApplicationChanged(appStateData) {
console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`);
},
......@@ -873,14 +900,18 @@ try {
observerId = appManager.on('applicationStateEvent', applicationStateObserver, bundleNameList);
console.log(`[appManager] observerCode: ${observerId}`);
} 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.注销应用状态监听器
try {
appManager.off('applicationStateEvent', observerId);
} 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} `);
}
```
......@@ -914,8 +945,9 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void;
```ts
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) {
console.error(`getForegroundApplicationsCallback fail, err: ${JSON.stringify(err)}`);
} else {
......@@ -925,7 +957,9 @@ function getForegroundApplicationsCallback(err, data) {
try {
appManager.getForegroundApplications(getForegroundApplicationsCallback);
} 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} `);
}
```
......@@ -959,10 +993,11 @@ getForegroundApplications(): Promise\<Array\<AppStateData>>;
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
appManager.getForegroundApplications().then((data) => {
console.log(`getForegroundApplications success, data: ${JSON.stringify(data)}`);
}).catch((err) => {
}).catch((err: BusinessError) => {
console.error(`getForegroundApplications fail, err: ${JSON.stringify(err)}`);
});
```
......@@ -1002,17 +1037,20 @@ killProcessWithAccount(bundleName: string, accountId: number): Promise\<void\>
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName';
let accountId = 0;
try {
appManager.killProcessWithAccount(bundleName, accountId).then(() => {
console.log('killProcessWithAccount success');
}).catch((err) => {
}).catch((err: BusinessError) => {
console.error(`killProcessWithAccount fail, err: ${JSON.stringify(err)}`);
});
} 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} `);
}
```
......@@ -1053,10 +1091,11 @@ killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCal
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName';
let accountId = 0;
function killProcessWithAccountCallback(err, data) {
function killProcessWithAccountCallback(err: BusinessError) {
if (err) {
console.error(`killProcessWithAccountCallback fail, err: ${JSON.stringify(err)}`);
} else {
......@@ -1097,9 +1136,10 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>);
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName';
function killProcessesByBundleNameCallback(err, data) {
function killProcessesByBundleNameCallback(err: BusinessError) {
if (err) {
console.error(`killProcessesByBundleNameCallback fail, err: ${JSON.stringify(err)}`);
} else {
......@@ -1109,7 +1149,9 @@ function killProcessesByBundleNameCallback(err, data) {
try {
appManager.killProcessesByBundleName(bundleName, killProcessesByBundleNameCallback);
} 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} `);
}
```
......@@ -1149,16 +1191,19 @@ killProcessesByBundleName(bundleName: string): Promise\<void>;
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName';
try {
appManager.killProcessesByBundleName(bundleName).then((data) => {
console.log('killProcessesByBundleName success.');
}).catch((err) => {
}).catch((err: BusinessError) => {
console.error(`killProcessesByBundleName fail, err: ${JSON.stringify(err)}`);
});
} 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} `);
}
```
......@@ -1193,9 +1238,10 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>);
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName';
function clearUpApplicationDataCallback(err, data) {
function clearUpApplicationDataCallback(err: BusinessError) {
if (err) {
console.error(`clearUpApplicationDataCallback fail, err: ${JSON.stringify(err)}`);
} else {
......@@ -1205,7 +1251,9 @@ function clearUpApplicationDataCallback(err, data) {
try {
appManager.clearUpApplicationData(bundleName, clearUpApplicationDataCallback);
} 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} `);
}
```
......@@ -1245,16 +1293,19 @@ clearUpApplicationData(bundleName: string): Promise\<void>;
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName';
try {
appManager.clearUpApplicationData(bundleName).then((data) => {
console.log('clearUpApplicationData success.');
}).catch((err) => {
}).catch((err: BusinessError) => {
console.error(`clearUpApplicationData fail, err: ${JSON.stringify(err)}`);
});
} 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} `);
}
```
......@@ -1287,9 +1338,10 @@ getProcessMemoryByPid(pid: number, callback: AsyncCallback\<number>): void;
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let pid = 0;
function getProcessMemoryByPidCallback(err, data) {
function getProcessMemoryByPidCallback(err: BusinessError, data: number) {
if (err) {
console.error(`getProcessMemoryByPidCallback fail, err: ${JSON.stringify(err)}`);
} else {
......@@ -1299,7 +1351,9 @@ function getProcessMemoryByPidCallback(err, data) {
try {
appManager.getProcessMemoryByPid(pid, getProcessMemoryByPidCallback);
} 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} `);
}
```
......@@ -1337,16 +1391,19 @@ getProcessMemoryByPid(pid: number): Promise\<number>;
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let pid = 0;
try {
appManager.getProcessMemoryByPid(pid).then((data) => {
console.log('getProcessMemoryByPid success.');
}).catch((err) => {
}).catch((err: BusinessError) => {
console.error(`getProcessMemoryByPid fail, err: ${JSON.stringify(err)}`);
});
} 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} `);
}
```
......@@ -1379,9 +1436,10 @@ getRunningProcessInfoByBundleName(bundleName: string, callback: AsyncCallback\<A
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = "bundleName";
function getRunningProcessInfoByBundleNameCallback(err, data) {
function getRunningProcessInfoByBundleNameCallback(err: BusinessError, data: appManager.Array<ProcessInformation>) {
if (err) {
console.error(`getRunningProcessInfoByBundleNameCallback fail, err: ${JSON.stringify(err)}`);
} else {
......@@ -1391,7 +1449,9 @@ function getRunningProcessInfoByBundleNameCallback(err, data) {
try {
appManager.getRunningProcessInfoByBundleName(bundleName, getRunningProcessInfoByBundleNameCallback);
} 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} `);
}
```
......@@ -1429,16 +1489,19 @@ getRunningProcessInfoByBundleName(bundleName: string): Promise\<Array\<ProcessIn
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = "bundleName";
try {
appManager.getRunningProcessInfoByBundleName(bundleName).then((data) => {
console.log('getRunningProcessInfoByBundleName success.');
}).catch((err) => {
}).catch((err: BusinessError) => {
console.error(`getRunningProcessInfoByBundleName fail, err: ${JSON.stringify(err)}`);
});
} 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} `);
}
```
......@@ -1472,10 +1535,11 @@ getRunningProcessInfoByBundleName(bundleName: string, userId: number, callback:
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = "bundleName";
let userId = 0;
function getRunningProcessInfoByBundleNameCallback(err, data) {
function getRunningProcessInfoByBundleNameCallback(err: BusinessError, data: Array<appManager.ProcessInformation>) {
if (err) {
console.error(`getRunningProcessInfoByBundleNameCallback fail, err: ${JSON.stringify(err)}`);
} else {
......@@ -1485,7 +1549,9 @@ function getRunningProcessInfoByBundleNameCallback(err, data) {
try {
appManager.getRunningProcessInfoByBundleName(bundleName, userId, getRunningProcessInfoByBundleNameCallback);
} 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} `);
}
```
......@@ -1524,17 +1590,20 @@ getRunningProcessInfoByBundleName(bundleName: string, userId: number): Promise\<
```ts
import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = "bundleName";
let userId = 0;
try {
appManager.getRunningProcessInfoByBundleName(bundleName, userId).then((data) => {
console.log('getRunningProcessInfoByBundleName success.');
}).catch((err) => {
}).catch((err: BusinessError) => {
console.error(`getRunningProcessInfoByBundleName fail, err: ${JSON.stringify(err)}`);
});
} 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} `);
}
```
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-appRecovery.md
浏览文件 @ 10998067
......@@ -101,7 +101,7 @@ API10时将启动由[setRestartWant](#apprecoverysetrestartwant)指定的Ability
import appRecovery from '@ohos.app.ability.appRecovery';
import errorManager from '@ohos.app.ability.errorManager';
let observer = {
let observer: errorManager.ErrorObserver = {
onUnhandledException(errorMsg) {
console.log('onUnhandledException, errorMsg: ', errorMsg);
appRecovery.restartApp();
......@@ -135,7 +135,7 @@ saveAppState(): boolean;
import appRecovery from '@ohos.app.ability.appRecovery';
import errorManager from '@ohos.app.ability.errorManager';
let observer = {
let observer: errorManager.ErrorObserver = {
onUnhandledException(errorMsg) {
console.log('onUnhandledException, errorMsg: ', errorMsg);
appRecovery.saveAppState();
......@@ -175,7 +175,7 @@ saveAppState(context?: UIAbilityContext): boolean;
import appRecovery from '@ohos.app.ability.appRecovery';
import errorManager from '@ohos.app.ability.errorManager';
let observer = {
let observer: errorManager.ErrorObserver = {
onUnhandledException(errorMsg) {
console.log('onUnhandledException, errorMsg: ', errorMsg);
appRecovery.saveAppState(this.context);
......@@ -207,12 +207,14 @@ setRestartWant(want: Want): void;
```ts
import appRecovery from '@ohos.app.ability.appRecovery';
import Want from '@ohos.app.ability.Want';
Button("启动到恢复Ability")
.fontSize(40)
.fontWeight(FontWeight.Bold)
.onClick(()=> {
// set restart want
let want = {
let want: Want = {
bundleName: "ohos.samples.recovery",
abilityName: "RecoveryAbility"
};
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-applicationStateChangeCallback.md
浏览文件 @ 10998067
......@@ -25,26 +25,56 @@ onApplicationForeground(): void;
```ts
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() {
console.info('applicationStateChangeCallback onApplicationForeground');
}
}
GlobalContext.getContext().setObject("applicationStateChangeCallback", applicationStateChangeCallback);
export default class MyAbility extends UIAbility {
onCreate() {
console.log('MyAbility onCreate');
globalThis.applicationContext = this.context.getApplicationContext();
GlobalContext.getContext().setObject("applicationContext", this.context.getApplicationContext());
// 1.获取applicationContext
let applicationContext = globalThis.applicationContext;
let applicationContext = GlobalContext.getContext().getObject("applicationContext");
// 2.通过applicationContext注册应用前后台状态监听
applicationContext.on('applicationStateChange', globalThis.ApplicationStateChangeCallback);
if (applicationContext != undefined) {
applicationContext.on('applicationStateChange',
GlobalContext.getContext().getObject("applicationStateChangeCallback"));
}
}
onDestroy() {
let applicationContext = globalThis.applicationContext;
let applicationContext = GlobalContext.getContext().getObject("applicationContext");
// 1.通过applicationContext解除注册应用前后台状态监听
applicationContext.off('applicationStateChange', globalThis.ApplicationStateChangeCallback);
if (applicationContext != undefined) {
applicationContext.off('applicationStateChange',
GlobalContext.getContext().getObject("applicationStateChangeCallback"));
}
}
}
```
......@@ -61,27 +91,56 @@ onApplicationBackground(): void;
```ts
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() {
console.info('applicationStateChangeCallback onApplicationBackground');
}
}
GlobalContext.getContext().setObject("applicationStateChangeCallback", applicationStateChangeCallback);
export default class MyAbility extends UIAbility {
onCreate() {
console.log('MyAbility onCreate');
globalThis.applicationContext = this.context.getApplicationContext();
GlobalContext.getContext().setObject("applicationContext", this.context.getApplicationContext());
// 1.获取applicationContext
let applicationContext = globalThis.applicationContext;
let applicationContext = GlobalContext.getContext().getObject("applicationContext");
// 2.通过applicationContext注册应用前后台状态监听
applicationContext.on('applicationStateChange', globalThis.ApplicationStateChangeCallback);
if (applicationContext != undefined) {
applicationContext.on('applicationStateChange',
GlobalContext.getContext().getObject("applicationStateChangeCallback"));
}
console.log('Resgiter applicationStateChangeCallback');
}
onDestroy() {
let applicationContext = globalThis.applicationContext;
let applicationContext = GlobalContext.getContext().getObject("applicationContext");
// 1.通过applicationContext解除注册应用前后台状态监听
applicationContext.off('applicationStateChange', globalThis.ApplicationStateChangeCallback);
if (applicationContext != undefined) {
applicationContext.off('applicationStateChange',
GlobalContext.getContext().getObject("applicationStateChangeCallback"));
}
}
}
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-app-ability-configuration.md
浏览文件 @ 10998067
......@@ -31,10 +31,13 @@ import Configuration from '@ohos.app.ability.Configuration';
```ts
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 {
onCreate(want, launchParam) {
let envCallback = {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
let envCallback: EnvironmentCallback = {
onConfigurationUpdated(config) {
console.info(`envCallback onConfigurationUpdated success: ${JSON.stringify(config)}`);
let language = config.language;
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-dataUriUtils.md
浏览文件 @ 10998067
......@@ -35,6 +35,8 @@ getId(uri: string): number
**示例：**
```ts
import dataUriUtils from '@ohos.app.ability.dataUriUtils';
try {
let id = dataUriUtils.getId('com.example.dataUriUtils/1221');
console.info('get id: ${id}');
......@@ -69,6 +71,8 @@ attachId(uri: string, id: number): string
**示例：**
```ts
import dataUriUtils from '@ohos.app.ability.dataUriUtils';
let id = 1122;
try {
let uri = dataUriUtils.attachId(
......@@ -107,6 +111,8 @@ deleteId(uri: string): string
**示例：**
```ts
import dataUriUtils from '@ohos.app.ability.dataUriUtils';
try {
let uri = dataUriUtils.deleteId('com.example.dataUriUtils/1221');
console.info('delete id with the uri is: ${uri}');
......@@ -142,6 +148,7 @@ updateId(uri: string, id: number): string
**示例：**
```ts
import dataUriUtils from '@ohos.app.ability.dataUriUtils';
try {
let id = 1122;
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-dialogRequest.md
浏览文件 @ 10998067
......@@ -38,17 +38,18 @@ getRequestInfo(want: Want): RequestInfo
```ts
import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
import rpc from '@ohos.rpc';
import dialogRequest from '@ohos.app.ability.dialogRequest';
const REQUEST_VALUE = 1;
class StubTest extends rpc.RemoteObject {
constructor(des) {
constructor(des: string) {
super(des);
}
onRemoteRequest(code, data, reply, option) {
onRemoteRequest(code: number, data: rpc.MessageParcel, reply: rpc.MessageParcel, option: rpc.MessageOption) {
if (code === REQUEST_VALUE) {
let optFir = data.readInt();
let optSec = data.readInt();
......@@ -57,10 +58,6 @@ getRequestInfo(want: Want): RequestInfo
return true;
}
queryLocallInterface(descriptor) {
return null;
}
getInterfaceDescriptor() {
return "";
}
......@@ -73,32 +70,32 @@ getRequestInfo(want: Want): RequestInfo
return REQUEST_VALUE;
}
attachLocalInterface(localInterface, descriptor) {
attachLocalInterface(localInterface: rpc.IRemoteBroker, descriptor: string) {
}
}
let TAG = "getRequestInfoTest";
export default class ServiceExtAbility extends ServiceExtensionAbility {
onCreate(want) {
onCreate(want: Want) {
console.info(TAG, `onCreate, want: ${want.abilityName}`);
}
onRequest(want, startId) {
onRequest(want: Want, startId: number) {
console.info(TAG, `onRequest, want: ${want.abilityName}`);
try {
var requestInfo = dialogRequest.getRequestInfo(want);
let requestInfo = dialogRequest.getRequestInfo(want);
} catch (err) {
console.error('getRequestInfo err= ${JSON.stringify(err)}');
}
}
onConnect(want) {
onConnect(want: Want) {
console.info(TAG, `onConnect, want: ${want.abilityName}`);
return new StubTest("test");
}
onDisconnect(want) {
onDisconnect(want: Want) {
console.info(TAG, `onDisconnect, want: ${want.abilityName}`);
}
......@@ -132,6 +129,7 @@ getRequestCallback(want: Want): RequestCallback
```ts
import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
import rpc from '@ohos.rpc';
import dialogRequest from '@ohos.app.ability.dialogRequest';
......@@ -140,11 +138,11 @@ getRequestCallback(want: Want): RequestCallback
const REQUEST_VALUE = 1;
class StubTest extends rpc.RemoteObject {
constructor(des) {
constructor(des: string) {
super(des);
}
onRemoteRequest(code, data, reply, option) {
onRemoteRequest(code: number, data: rpc.MessageParcel, reply: rpc.MessageParcel, option: rpc.MessageOption) {
if (code === REQUEST_VALUE) {
let optFir = data.readInt();
let optSec = data.readInt();
......@@ -153,10 +151,6 @@ getRequestCallback(want: Want): RequestCallback
return true;
}
queryLocallInterface(descriptor) {
return null;
}
getInterfaceDescriptor() {
return "";
}
......@@ -169,30 +163,30 @@ getRequestCallback(want: Want): RequestCallback
return REQUEST_VALUE;
}
attachLocalInterface(localInterface, descriptor) {
attachLocalInterface(localInterface: rpc.IRemoteBroker, descriptor: string) {
}
}
export default class ServiceExtAbility extends ServiceExtensionAbility {
onCreate(want) {
onCreate(want: Want) {
console.info(TAG, `onCreate, want: ${want.abilityName}`);
}
onRequest(want, startId) {
onRequest(want: Want, startId: number) {
console.info(TAG, `onRequest, want: ${want.abilityName}`);
try {
var requestCallback = dialogRequest.getRequestCallback(want);
let requestCallback = dialogRequest.getRequestCallback(want);
} catch(err) {
console.error('getRequestInfo err= ${JSON.stringify(err)}');
}
}
onConnect(want) {
onConnect(want: Want) {
console.info(TAG, `onConnect, want: ${want.abilityName}`);
return new StubTest("test");
}
onDisconnect(want) {
onDisconnect(want: Want) {
console.info(TAG, `onDisconnect, want: ${want.abilityName}`);
}
......@@ -211,6 +205,8 @@ getRequestCallback(want: Want): RequestCallback
```ts
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 dialogRequest from '@ohos.app.ability.dialogRequest';
import window from '@ohos.window';
......@@ -220,11 +216,11 @@ getRequestCallback(want: Want): RequestCallback
const REQUEST_VALUE = 1;
class StubTest extends rpc.RemoteObject {
constructor(des) {
constructor(des: string) {
super(des);
}
onRemoteRequest(code, data, reply, option) {
onRemoteRequest(code: number, data: rpc.MessageParcel, reply: rpc.MessageParcel, option: rpc.MessageOption) {
if (code === REQUEST_VALUE) {
let optFir = data.readInt();
let optSec = data.readInt();
......@@ -233,10 +229,6 @@ getRequestCallback(want: Want): RequestCallback
return true;
}
queryLocallInterface(descriptor) {
return null;
}
getInterfaceDescriptor() {
return "";
}
......@@ -249,41 +241,48 @@ getRequestCallback(want: Want): RequestCallback
return REQUEST_VALUE;
}
attachLocalInterface(localInterface, descriptor) {
attachLocalInterface(localInterface: rpc.IRemoteBroker, descriptor: string) {
}
}
export default class ServiceExtAbility extends ServiceExtensionAbility {
onCreate(want) {
onCreate(want: Want) {
console.info(TAG, `onCreate, want: ${want.abilityName}`);
}
onRequest(want, startId) {
onRequest(want: Want, startId: number) {
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 {
var requestInfo = dialogRequest.getRequestInfo(want);
let windowClass = null;
windowClass.bindDialogTarget(requestInfo, () => {
let requestInfo = dialogRequest.getRequestInfo(want);
window.createWindow(config, (err, data) => {
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.');
}, (err) => {
if (err.code) {
console.error('Failed to bind dialog target. Cause: ${JSON.stringify(err)}');
return;
}
console.info('Succeeded in binding dialog target.');
}, (err: BusinessError) => {
if (err.code) {
console.error('Failed to bind dialog target. Cause: ${JSON.stringify(err)}');
return;
}
console.info('Succeeded in binding dialog target.');
});
});
} catch(err) {
console.error('getRequestInfo err= ${JSON.stringify(err)}');
}
}
onConnect(want) {
onConnect(want: Want) {
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}`);
}
......@@ -345,6 +344,7 @@ setRequestResult(result: RequestResult): void;
```ts
import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
import rpc from '@ohos.rpc';
import dialogRequest from '@ohos.app.ability.dialogRequest';
......@@ -353,11 +353,11 @@ setRequestResult(result: RequestResult): void;
const REQUEST_VALUE = 1;
class StubTest extends rpc.RemoteObject {
constructor(des) {
constructor(des: string) {
super(des);
}
onRemoteRequest(code, data, reply, option) {
onRemoteRequest(code: number, data: rpc.MessageParcel, reply: rpc.MessageParcel, option: rpc.MessageOption) {
if (code === REQUEST_VALUE) {
let optFir = data.readInt();
let optSec = data.readInt();
......@@ -366,10 +366,6 @@ setRequestResult(result: RequestResult): void;
return true;
}
queryLocallInterface(descriptor) {
return null;
}
getInterfaceDescriptor() {
return "";
}
......@@ -382,20 +378,20 @@ setRequestResult(result: RequestResult): void;
return REQUEST_VALUE;
}
attachLocalInterface(localInterface, descriptor) {
attachLocalInterface(localInterface: rpc.IRemoteBroker, descriptor: string) {
}
}
export default class ServiceExtAbility extends ServiceExtensionAbility {
onCreate(want) {
onCreate(want: Want) {
console.info(TAG, `onCreate, want: ${want.abilityName}`);
}
onRequest(want, startId) {
onRequest(want: Want, startId: number) {
console.info(TAG, `onRequest, want: ${want.abilityName}`);
try {
var requestCallback = dialogRequest.getRequestCallback(want);
let myResult = {
let requestCallback = dialogRequest.getRequestCallback(want);
let myResult: dialogRequest.RequestResult = {
result : dialogRequest.ResultCode.RESULT_CANCEL,
};
requestCallback.setRequestResult(myResult);
......@@ -404,12 +400,12 @@ setRequestResult(result: RequestResult): void;
}
}
onConnect(want) {
onConnect(want: Want) {
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}`);
}
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-environmentCallback.md
浏览文件 @ 10998067
......@@ -46,15 +46,15 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
**示例：**
```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 {
onCreate() {
console.log('MyAbility onCreate');
globalThis.applicationContext = this.context.getApplicationContext();
let environmentCallback = {
let environmentCallback: EnvironmentCallback = {
onConfigurationUpdated(config){
console.log('onConfigurationUpdated config: ${JSON.stringify(config)}');
},
......@@ -64,14 +64,14 @@ export default class MyAbility extends UIAbility {
}
};
// 1.获取applicationContext
let applicationContext = globalThis.applicationContext;
let applicationContext = this.context.getApplicationContext();
// 2.通过applicationContext注册监听应用内生命周期
callbackId = applicationContext.registerEnvironmentCallback(environmentCallback);
callbackId = applicationContext.on('environmentEvent', environmentCallback);
console.log('registerEnvironmentCallback number: ${JSON.stringify(callbackId)}');
}
onDestroy() {
let applicationContext = globalThis.applicationContext;
applicationContext.unregisterEnvironmentCallback(callbackId, (error, data) => {
let applicationContext = this.context.getApplicationContext();
applicationContext.off('environment', callbackId, (error, data) => {
if (error && error.code !== 0) {
console.error('unregisterEnvironmentCallback fail, error: ${JSON.stringify(error)}');
} else {
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-errorManager.md
浏览文件 @ 10998067
......@@ -47,7 +47,10 @@ on(type: 'error', observer: ErrorObserver): number;
**示例：**
```ts
let observer = {
import errorManager from '@ohos.app.ability.errorManager';
import { BusinessError } from '@ohos.base';
let observer: errorManager.ErrorObserver = {
onUnhandledException(errorMsg) {
console.log('onUnhandledException, errorMsg: ', errorMsg);
},
......@@ -63,7 +66,9 @@ let observerId = -1;
try {
observerId = errorManager.on('error', observer);
} 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}`);
}
```
......@@ -98,9 +103,12 @@ off(type: 'error', observerId: number, callback: AsyncCallback\<void>): void;
**示例：**
```ts
import errorManager from '@ohos.app.ability.errorManager';
import { BusinessError } from '@ohos.base';
let observerId = 100;
function unregisterErrorObserverCallback(err) {
function unregisterErrorObserverCallback(err: BusinessError) {
if (err) {
console.error('------------ unregisterErrorObserverCallback ------------', err);
}
......@@ -108,7 +116,9 @@ function unregisterErrorObserverCallback(err) {
try {
errorManager.off('error', observerId, unregisterErrorObserverCallback);
} 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}`);
}
```
......@@ -148,17 +158,22 @@ off(type: 'error', observerId: number): Promise\<void>;
**示例：**
```ts
import errorManager from '@ohos.app.ability.errorManager';
import { BusinessError } from '@ohos.base';
let observerId = 100;
try {
errorManager.off('error', observerId)
.then((data) => {
console.log('----------- unregisterErrorObserver success ----------', data);
})
.catch((err) => {
.catch((err: BusinessError) => {
console.error('----------- unregisterErrorObserver fail ----------', err);
});
} 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}`);
}
```
......@@ -195,7 +210,10 @@ on(type: 'errorEvent', observer: ErrorObserver): number;
**示例：**
```ts
let observer = {
import errorManager from '@ohos.app.ability.errorManager';
import { BusinessError } from '@ohos.base';
let observer: errorManager.ErrorObserver = {
onUnhandledException(errorMsg) {
console.log('onUnhandledException, errorMsg: ', errorMsg);
},
......@@ -211,7 +229,9 @@ let observerId = -1;
try {
observerId = errorManager.on('errorEvent', observer);
} 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}`);
}
```
......@@ -242,12 +262,17 @@ off(type: 'errorEvent', observerId: number): void;
**示例：**
```ts
import errorManager from '@ohos.app.ability.errorManager';
import { BusinessError } from '@ohos.base';
let observerId = 100;
try {
errorManager.off('errorEvent', observerId);
} 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}`);
}
```
<!--no_check-->
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-app-ability-missionManager.md
浏览文件 @ 10998067
......@@ -50,46 +50,57 @@ on(type:'mission', listener: MissionListener): number;
```ts
import missionManager from '@ohos.app.ability.missionManager';
import UIAbility from '@ohos.app.ability.UIAbility';
let listener = {
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-------');}
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';
import window from '@ohos.window';
let listener: missionManager.MissionListener = {
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-------');}
};
let listenerId = -1;
let abilityWant: Want;
let context: common.UIAbilityContext;
export default class EntryAbility extends UIAbility {
onCreate(want, launchParam) {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
console.log('[Demo] EntryAbility onCreate');
globalThis.abilityWant = want;
globalThis.context = this.context;
abilityWant = want;
context = this.context;
}
onDestroy() {
try {
if (listenerId !== -1) {
missionManager.off('mission', listenerId).catch(function (err) {
missionManager.off('mission', listenerId).catch((err: BusinessError) => {
console.log(err);
});
}
} 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');
}
onWindowStageCreate(windowStage) {
onWindowStageCreate(windowStage: window.WindowStage) {
// Main window is created, set main page for this ability
console.log('[Demo] EntryAbility onWindowStageCreate');
try {
listenerId = missionManager.on('mission', listener);
} 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) => {
......@@ -99,10 +110,6 @@ export default class EntryAbility extends UIAbility {
}
console.info(`Succeeded in loading the content. Data: ${JSON.stringify(data)}`);
});
if (globalThis.flag) {
return;
}
}
};
```
......@@ -144,59 +151,66 @@ off(type: 'mission', listenerId: number, callback: AsyncCallback&lt;void&gt;): v
```ts
import missionManager from '@ohos.app.ability.missionManager';
import UIAbility from '@ohos.app.ability.UIAbility';
let listener = {
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-------');}
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';
import window from '@ohos.window';
let listener: missionManager.MissionListener = {
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-------');}
};
let listenerId = -1;
let abilityWant: Want;
let context: common.UIAbilityContext;
export default class EntryAbility extends UIAbility {
onCreate(want, launchParam) {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
console.log('[Demo] EntryAbility onCreate');
globalThis.abilityWant = want;
globalThis.context = this.context;
abilityWant = want;
context = this.context;
}
onDestroy() {
try {
if (listenerId !== -1) {
missionManager.off('mission', listenerId, (err) => {
console.log(err);
console.log('$(err.code)');
});
}
} 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');
}
onWindowStageCreate(windowStage) {
onWindowStageCreate(windowStage: window.WindowStage) {
// Main window is created, set main page for this ability
console.log('[Demo] EntryAbility onWindowStageCreate');
try {
listenerId = missionManager.on('mission', listener);
} 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) {
console.error(`Failed to load the content. Cause: ${JSON.stringify(err)}`);
return;
}
console.info(`Succeeded in loading the content. Data: ${JSON.stringify(data)}`);
});
if (globalThis.flag) {
return;
}
}
};
```
......@@ -243,59 +257,66 @@ off(type: 'mission', listenerId: number): Promise&lt;void&gt;;
```ts
import missionManager from '@ohos.app.ability.missionManager';
import UIAbility from '@ohos.app.ability.UIAbility';
let listener = {
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-------');}
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';
import window from '@ohos.window';
let listener: missionManager.MissionListener = {
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-------');}
};
let listenerId = -1;
let abilityWant: Want;
let context: common.UIAbilityContext;
export default class EntryAbility extends UIAbility {
onCreate(want, launchParam) {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
console.log('[Demo] EntryAbility onCreate');
globalThis.abilityWant = want;
globalThis.context = this.context;
abilityWant = want;
context = this.context;
}
onDestroy() {
try {
if (listenerId !== -1) {
missionManager.off('mission', listenerId).catch(function (err) {
console.log(err);
missionManager.off('mission', listenerId).catch((err: BusinessError) => {
console.log('$(err.code)');
});
}
} 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');
}
onWindowStageCreate(windowStage) {
onWindowStageCreate(windowStage: window.WindowStage) {
// Main window is created, set main page for this ability
console.log('[Demo] EntryAbility onWindowStageCreate');
try {
listenerId = missionManager.on('mission', listener);
} 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) {
console.error(`Failed to load the content. Cause: ${JSON.stringify(err)}`);
return;
}
console.info(`Succeeded in loading the content. Data: ${JSON.stringify(data)}`);
});
if (globalThis.flag) {
return;
}
}
};
```
......@@ -330,24 +351,31 @@ on(type:'missionEvent', listener: MissionListener): number;
```ts
import missionManager from '@ohos.app.ability.missionManager';
import UIAbility from '@ohos.app.ability.UIAbility';
let listener = {
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-------');}
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';
import window from '@ohos.window';
let listener: missionManager.MissionListener = {
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-------');}
};
let listenerId = -1;
let abilityWant: Want;
let context: common.UIAbilityContext;
export default class EntryAbility extends UIAbility {
onCreate(want, launchParam) {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
console.log('[Demo] EntryAbility onCreate');
globalThis.abilityWant = want;
globalThis.context = this.context;
abilityWant = want;
context = this.context;
}
onDestroy() {
......@@ -356,18 +384,22 @@ export default class EntryAbility extends UIAbility {
missionManager.off('missionEvent', listenerId);
}
} 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');
}
onWindowStageCreate(windowStage) {
onWindowStageCreate(windowStage: window.WindowStage) {
// Main window is created, set main page for this ability
console.log('[Demo] EntryAbility onWindowStageCreate');
try {
listenerId = missionManager.on('missionEvent', listener);
} 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) => {
......@@ -377,10 +409,6 @@ export default class EntryAbility extends UIAbility {
}
console.info(`Succeeded in loading the content. Data: ${JSON.stringify(data)}`);
});
if (globalThis.flag) {
return;
}
}
};
```
......@@ -418,24 +446,31 @@ off(type: 'missionEvent', listenerId: number): void;
```ts
import missionManager from '@ohos.app.ability.missionManager';
import UIAbility from '@ohos.app.ability.UIAbility';
let listener = {
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-------');}
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';
import window from '@ohos.window';
let listener: missionManager.MissionListener = {
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-------');}
};
let listenerId = -1;
let abilityWant: Want;
let context: common.UIAbilityContext;
export default class EntryAbility extends UIAbility {
onCreate(want, launchParam) {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
console.log('[Demo] EntryAbility onCreate');
globalThis.abilityWant = want;
globalThis.context = this.context;
abilityWant = want;
context = this.context;
}
onDestroy() {
......@@ -444,18 +479,22 @@ export default class EntryAbility extends UIAbility {
missionManager.off('missionEvent', listenerId);
}
} 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');
}
onWindowStageCreate(windowStage) {
onWindowStageCreate(windowStage: window.WindowStage) {
// Main window is created, set main page for this ability
console.log('[Demo] EntryAbility onWindowStageCreate');
try {
listenerId = missionManager.on('missionEvent', listener);
} 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) => {
......@@ -465,10 +504,6 @@ export default class EntryAbility extends UIAbility {
}
console.info(`Succeeded in loading the content. Data: ${JSON.stringify(data)}`);
});
if (globalThis.flag) {
return;
}
}
};
```
......@@ -497,6 +532,7 @@ getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback&lt;M
```ts
import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
let testMissionId = 1;
......@@ -520,10 +556,12 @@ getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback&lt;M
}
});
} 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
......@@ -555,12 +593,13 @@ getMissionInfo(deviceId: string, missionId: number): Promise&lt;MissionInfo&gt;;
```ts
import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
let testMissionId = 1;
try {
missionManager.getMissionInfo('', testMissionId).then((data) => {
console.info('getMissionInfo successfully. Data: ${JSON.stringify(data)}');
}).catch(error => {
}).catch((error: BusinessError) => {
console.error('getMissionInfo failed. Cause: ${error.message}');
});
} catch (error) {
......@@ -592,6 +631,7 @@ getMissionInfos(deviceId: string, numMax: number, callback: AsyncCallback&lt;Arr
```ts
import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
try {
missionManager.getMissionInfos('', 10, (error, missions) => {
......@@ -603,7 +643,9 @@ getMissionInfos(deviceId: string, numMax: number, callback: AsyncCallback&lt;Arr
}
});
} 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} `);
}
```
......@@ -637,11 +679,12 @@ getMissionInfos(deviceId: string, numMax: number): Promise&lt;Array&lt;MissionIn
```ts
import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
try {
missionManager.getMissionInfos('', 10).then((data) => {
console.info('getMissionInfos successfully. Data: ${JSON.stringify(data)}');
}).catch(error => {
}).catch((error: BusinessError) => {
console.error('getMissionInfos failed. Cause: ${error.message}');
});
} catch (error) {
......@@ -715,12 +758,13 @@ getMissionSnapShot(deviceId: string, missionId: number): Promise&lt;MissionSnaps
**示例：**
```ts
import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
let testMissionId = 2;
try {
missionManager.getMissionSnapShot('', testMissionId).then((data) => {
console.info('getMissionSnapShot successfully. Data: ${JSON.stringify(data)}');
}).catch(error => {
}).catch((error: BusinessError) => {
console.error('getMissionSnapShot failed. Cause: ${error.message}');
});
} catch (error) {
......@@ -795,12 +839,13 @@ getLowResolutionMissionSnapShot(deviceId: string, missionId: number): Promise\<M
```ts
import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
let testMissionId = 2;
try {
missionManager.getLowResolutionMissionSnapShot('', testMissionId).then((data) => {
console.info('getLowResolutionMissionSnapShot successfully. Data: ${JSON.stringify(data)}');
}).catch(error => {
}).catch((error: BusinessError) => {
console.error('getLowResolutionMissionSnapShot failed. Cause: ${error.message}');
});
} catch (error) {
......@@ -890,12 +935,13 @@ lockMission(missionId: number): Promise&lt;void&gt;;
**示例：**
```ts
import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
let testMissionId = 2;
try {
missionManager.lockMission(testMissionId).then((data) => {
console.info('lockMission successfully. Data: ${JSON.stringify(data)}');
}).catch(error => {
}).catch((error: BusinessError) => {
console.error('lockMission failed. Cause: ${error.message}');
});
} catch (error) {
......@@ -984,12 +1030,13 @@ unlockMission(missionId: number): Promise&lt;void&gt;;
```ts
import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
let testMissionId = 2;
try {
missionManager.unlockMission(testMissionId).then((data) => {
console.info('unlockMission successfully. Data: ${JSON.stringify(data)}');
}).catch(error => {
}).catch((error: BusinessError) => {
console.error('unlockMission failed. Cause: ${error.message}');
});
} catch (error) {
......@@ -1064,12 +1111,13 @@ clearMission(missionId: number): Promise&lt;void&gt;;
```ts
import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
let testMissionId = 2;
try {
missionManager.clearMission(testMissionId).then((data) => {
console.info('clearMission successfully. Data: ${JSON.stringify(data)}');
}).catch(error => {
}).catch((error: BusinessError) => {
console.error('clearMission failed. Cause: ${error.message}');
});
} catch (error) {
......@@ -1129,11 +1177,12 @@ clearAllMissions(): Promise&lt;void&gt;;
```ts
import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
try {
missionManager.clearAllMissions().then((data) => {
console.info('clearAllMissions successfully. Data: ${JSON.stringify(data)}');
}).catch(err => {
}).catch((err: BusinessError) => {
console.error('clearAllMissions failed: ${err.message}');
});
} catch (err) {
......@@ -1271,12 +1320,13 @@ moveMissionToFront(missionId: number, options?: StartOptions): Promise&lt;void&g
```ts
import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
let testMissionId = 2;
try {
missionManager.moveMissionToFront(testMissionId).then((data) => {
console.info('moveMissionToFront successfully. Data: ${JSON.stringify(data)}');
}).catch(error => {
}).catch((error: BusinessError) => {
console.error('moveMissionToFront failed. Cause: ${error.message}');
});
} catch (error) {
......@@ -1316,6 +1366,7 @@ moveMissionsToForeground(missionIds: Array&lt;number&gt;, callback: AsyncCallbac
```ts
import abilityManager from '@ohos.app.ability.abilityManager';
import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
try {
missionManager.getMissionInfos("", 10, (error, missionInfos) => {
......@@ -1342,7 +1393,9 @@ try {
});
});
} 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} `);
}
```
......@@ -1380,6 +1433,7 @@ moveMissionsToForeground(missionIds: Array&lt;number&gt;, topMission: number, ca
```ts
import abilityManager from '@ohos.app.ability.abilityManager';
import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
try {
missionManager.getMissionInfos("", 10, (error, missionInfos) => {
......@@ -1406,7 +1460,9 @@ try {
});
});
} 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} `);
}
```
......@@ -1449,6 +1505,7 @@ moveMissionsToForeground(missionIds: Array&lt;number&gt;, topMission?: number):
```ts
import abilityManager from '@ohos.app.ability.abilityManager';
import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
try {
missionManager.getMissionInfos("", 10, (error, missionInfos) => {
......@@ -1471,7 +1528,9 @@ try {
});
});
} 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} `);
}
```
......@@ -1508,6 +1567,7 @@ moveMissionsToBackground(missionIds: Array&lt;number&gt;, callback: AsyncCallbac
```ts
import abilityManager from '@ohos.app.ability.abilityManager';
import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
try {
missionManager.getMissionInfos("", 10, (error, missionInfos) => {
......@@ -1531,7 +1591,9 @@ try {
});
});
} 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} `);
}
```
......@@ -1572,6 +1634,7 @@ moveMissionsToBackground(missionIds : Array&lt;number&gt;): Promise&lt;Array&lt;
```ts
import abilityManager from '@ohos.app.ability.abilityManager';
import missionManager from '@ohos.app.ability.missionManager';
import { BusinessError } from '@ohos.base';
try {
missionManager.getMissionInfos("", 10, (error, missionInfos) => {
......@@ -1591,7 +1654,9 @@ try {
});
});
} 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} `);
}
```
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-quickFixManager.md
浏览文件 @ 10998067
......@@ -78,6 +78,8 @@ applyQuickFix(hapModuleQuickFixFiles: Array\<string>, callback: AsyncCallback\<v
**示例：**
```ts
import quickFixManager from '@ohos.app.ability.quickFixManager';
try {
let hapModuleQuickFixFiles = ['/data/storage/el2/base/entry.hqf'];
quickFixManager.applyQuickFix(hapModuleQuickFixFiles, (error) => {
......@@ -130,11 +132,14 @@ applyQuickFix(hapModuleQuickFixFiles: Array\<string>): Promise\<void>;
**示例：**
```ts
import quickFixManager from '@ohos.app.ability.quickFixManager';
import { BusinessError } from '@ohos.base';
let hapModuleQuickFixFiles = ['/data/storage/el2/base/entry.hqf'];
try {
quickFixManager.applyQuickFix(hapModuleQuickFixFiles).then(() => {
console.info('applyQuickFix success');
}).catch((error) => {
}).catch((error: BusinessError) => {
console.error(`applyQuickFix err: ${error}`);
});
} catch (paramError) {
......@@ -173,6 +178,8 @@ getApplicationQuickFixInfo(bundleName: string, callback: AsyncCallback\<Applicat
**示例：**
```ts
import quickFixManager from '@ohos.app.ability.quickFixManager';
try {
let bundleName = 'bundleName';
quickFixManager.getApplicationQuickFixInfo(bundleName, (error, data) => {
......@@ -223,11 +230,14 @@ getApplicationQuickFixInfo(bundleName: string): Promise\<ApplicationQuickFixInfo
**示例：**
```ts
import quickFixManager from '@ohos.app.ability.quickFixManager';
import { BusinessError } from '@ohos.base';
try {
let bundleName = 'bundleName';
quickFixManager.getApplicationQuickFixInfo(bundleName).then((data) => {
console.info(`getApplicationQuickFixInfo success: ${data}`);
}).catch((error) => {
}).catch((error: BusinessError) => {
console.error(`getApplicationQuickFixInfo err: ${error}`);
});
} catch (paramError) {
......@@ -268,6 +278,8 @@ revokeQuickFix(bundleName: string, callback: AsyncCallback\<void>): void;
**示例：**
```ts
import quickFixManager from '@ohos.app.ability.quickFixManager';
let bundleName = "com.example.myapplication";
quickFixManager.revokeQuickFix(bundleName, (err) => {
console.info("revokeQuickFix " + bundleName + " " + JSON.stringify(err));
......@@ -312,10 +324,13 @@ revokeQuickFix(bundleName: string): Promise\<void>;
**示例：**
```ts
import quickFixManager from '@ohos.app.ability.quickFixManager';
import { BusinessError } from '@ohos.base';
let bundleName = "com.example.myapplication";
quickFixManager.revokeQuickFix(bundleName).then(() => {
console.info("revokeQuickFix " + bundleName +" ok");
}).catch((err) => {
}).catch((err: BusinessError) => {
console.info("revokeQuickFix " + bundleName +" failed, error code is ", JSON.stringify((err)));
});
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-app-ability-serviceExtensionAbility.md
浏览文件 @ 10998067
......@@ -48,8 +48,11 @@ Extension生命周期回调，在创建时回调，执行初始化业务逻辑
**示例：**
```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
class ServiceExt extends ServiceExtension {
onCreate(want) {
onCreate(want: Want) {
console.log('onCreate, want: ${want.abilityName}');
}
}
......@@ -69,6 +72,8 @@ Extension生命周期回调，在销毁时回调，执行资源清理等操作
**示例：**
```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
class ServiceExt extends ServiceExtension {
onDestroy() {
console.log('onDestroy');
......@@ -97,8 +102,11 @@ Extension生命周期回调，如果是startAbility或者startServiceExtensionAb
**示例：**
```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
class ServiceExt extends ServiceExtension {
onRequest(want, startId) {
onRequest(want: Want, startId: number) {
console.log('onRequest, want: ${want.abilityName}');
}
}
......@@ -131,15 +139,18 @@ Extension生命周期回调，如果是connectAbility拉起的服务，会在onC
```ts
import rpc from '@ohos.rpc';
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
class StubTest extends rpc.RemoteObject{
constructor(des) {
constructor(des: string) {
super(des);
}
onConnect(code, data, reply, option) {
onConnect(code: number, data: rpc.MessageSequence, reply: rpc.MessageSequence, option: rpc.MessageOption) {
}
}
class ServiceExt extends ServiceExtension {
onConnect(want) {
onConnect(want: Want) {
console.log('onConnect , want: ${want.abilityName}');
return new StubTest('test');
}
......@@ -150,11 +161,14 @@ Extension生命周期回调，如果是connectAbility拉起的服务，会在onC
```ts
import rpc from '@ohos.rpc';
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
class StubTest extends rpc.RemoteObject{
constructor(des) {
constructor(des: string) {
super(des);
}
onConnect(code, data, reply, option) {
onConnect(code: number, data: rpc.MessageSequence, reply: rpc.MessageSequence, option: rpc.MessageOption) {
}
}
async function getDescriptor() {
......@@ -162,7 +176,7 @@ async function getDescriptor() {
return "asyncTest"
}
class ServiceExt extends ServiceExtension {
async onConnect(want) {
async onConnect(want: Want) {
console.log(`onConnect , want: ${want.abilityName}`);
let descriptor = await getDescriptor();
return new StubTest(descriptor);
......@@ -189,8 +203,11 @@ Extension的生命周期回调，客户端执行断开连接服务时回调。
**示例：**
```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
class ServiceExt extends ServiceExtension {
onDisconnect(want) {
onDisconnect(want: Want) {
console.log('onDisconnect, want: ${want.abilityName}');
}
}
......@@ -199,8 +216,11 @@ Extension的生命周期回调，客户端执行断开连接服务时回调。
在执行完onDisconnect生命周期回调后，应用可能会退出，从而可能导致onDisconnect中的异步函数未能正确执行，比如异步写入数据库。可以使用异步生命周期，以确保异步onDisconnect完成后再继续后续的生命周期。
```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
class ServiceExt extends ServiceExtension {
async onDisconnect(want) {
async onDisconnect(want: Want) {
console.log('onDisconnect, want: ${want.abilityName}');
// 调用异步函数...
}
......@@ -226,8 +246,11 @@ Extension的生命周期回调，当所有以前的客户端都断开连接之
**示例：**
```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
class ServiceExt extends ServiceExtension {
onReconnect(want) {
onReconnect(want: Want) {
console.log('onReconnect, want: ${want.abilityName}');
}
}
......@@ -252,8 +275,11 @@ onConfigurationUpdate(newConfig: Configuration): void;
**示例：**
```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import { Configuration } from '@ohos.app.ability.Configuration';
class ServiceExt extends ServiceExtension {
onConfigurationUpdate(config) {
onConfigurationUpdate(config: Configuration) {
console.log('onConfigurationUpdate, config: ${JSON.stringify(config)}');
}
}
......@@ -278,8 +304,10 @@ onDump(params: Array\<string>): Array\<string>;
**示例：**
```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
class ServiceExt extends ServiceExtension {
onDump(params) {
onDump(params: Array<string>) {
console.log('dump, params: ${JSON.stringify(params)}');
return ['params'];
}
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-startOptions.md
浏览文件 @ 10998067
......@@ -26,6 +26,8 @@ import StartOptions from '@ohos.app.ability.StartOptions';
```ts
import missionManager from '@ohos.app.ability.missionManager';
import StartOptions from '@ohos.app.ability.StartOptions';
import { BusinessError } from '@ohos.base';
try {
missionManager.getMissionInfos('', 10, (error, missions) => {
......@@ -37,7 +39,7 @@ import StartOptions from '@ohos.app.ability.StartOptions';
console.log(`missions = ${JSON.stringify(missions)}`);
let id = missions[0].missionId;
let startOptions = {
let startOptions: StartOptions = {
windowMode : 101,
displayId: 0
};
......@@ -46,6 +48,8 @@ import StartOptions from '@ohos.app.ability.StartOptions';
});
});
} 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}`);
}
```
zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
浏览文件 @ 10998067
......@@ -45,8 +45,12 @@ UIAbility创建时回调，执行初始化业务逻辑操作。
**示例：**
```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 {
onCreate(want, launchParam) {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
console.log('onCreate, want: ${want.abilityName}');
}
}
......@@ -70,8 +74,11 @@ onWindowStageCreate(windowStage: window.WindowStage): void
**示例：**
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import window from '@ohos.window';
class MyUIAbility extends UIAbility {
onWindowStageCreate(windowStage) {
onWindowStageCreate(windowStage: window.WindowStage) {
console.log('onWindowStageCreate');
}
}
......@@ -89,6 +96,8 @@ onWindowStageDestroy(): void
**示例：**
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
class MyUIAbility extends UIAbility {
onWindowStageDestroy() {
console.log('onWindowStageDestroy');
......@@ -114,8 +123,11 @@ onWindowStageRestore(windowStage: window.WindowStage): void
**示例：**
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import window from '@ohos.window';
class MyUIAbility extends UIAbility {
onWindowStageRestore(windowStage) {
onWindowStageRestore(windowStage: window.WindowStage) {
console.log('onWindowStageRestore');
}
}
......@@ -134,6 +146,8 @@ UIAbility生命周期回调，在销毁时回调，执行资源清理等操作
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
class MyUIAbility extends UIAbility {
onDestroy() {
console.log('onDestroy');
......@@ -144,6 +158,8 @@ UIAbility生命周期回调，在销毁时回调，执行资源清理等操作
在执行完onDestroy生命周期回调后，应用可能会退出，从而可能导致onDestroy中的异步函数未能正确执行，比如异步写入数据库。可以使用异步生命周期，以确保异步onDestroy完成后再继续后续的生命周期。
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
class MyUIAbility extends UIAbility {
async onDestroy() {
console.log('onDestroy');
......@@ -163,6 +179,8 @@ UIAbility生命周期回调，当应用从后台转到前台时触发。
**示例：**
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
class MyUIAbility extends UIAbility {
onForeground() {
console.log('onForeground');
......@@ -182,6 +200,8 @@ UIAbility生命周期回调，当应用从前台转到后台时触发。
**示例：**
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
class MyUIAbility extends UIAbility {
onBackground() {
console.log('onBackground');
......@@ -213,9 +233,11 @@ onContinue(wantParam: { [key: string]: Object }): AbilityConstant.OnContinueResu
**示例：**
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyUIAbility extends UIAbility {
onContinue(wantParams) {
onContinue(wantParams: Record<string, Object>) {
console.log('onContinue');
wantParams['myData'] = 'my1234567';
return AbilityConstant.OnContinueResult.AGREE;
......@@ -242,8 +264,11 @@ onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void;
**示例：**
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyUIAbility extends UIAbility {
onNewWant(want, launchParam) {
onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam) {
console.log('onNewWant, want: ${want.abilityName}');
console.log('onNewWant, launchParam: ${JSON.stringify(launchParam)}');
}
......@@ -267,8 +292,10 @@ onDump(params: Array\<string>): Array\<string>;
**示例：**
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
class MyUIAbility extends UIAbility {
onDump(params) {
onDump(params: Array<string>) {
console.log('dump, params: ${JSON.stringify(params)}');
return ['params'];
}
......@@ -300,10 +327,11 @@ onSaveState(reason: AbilityConstant.StateType, wantParam : {[key: string]: Objec
**示例：**
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyUIAbility extends UIAbility {
onSaveState(reason, wantParam) {
onSaveState(reason: AbilityConstant.StateType, wantParam: Record<string, Object>) {
console.log('onSaveState');
wantParam['myData'] = 'my1234567';
return AbilityConstant.OnSaveResult.RECOVERY_AGREE;
......@@ -328,9 +356,11 @@ onShare(wantParam:{ [key: string]: Object }): void;
**示例：**
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyUIAbility extends UIAbility {
onShare(wantParams) {
onShare(wantParams: Record<string, Object>) {
console.log('onShare');
wantParams['ohos.extra.param.key.shareUrl'] = 'example.com';
}
......@@ -356,11 +386,15 @@ UIAbility生命周期回调，当系统预关闭开关打开后（配置系统
**示例：**
```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 {
onPrepareToTerminate() {
// 开发者定义预关闭动作
// 例如拉起另一个ability，根据ability处理结果执行异步关闭
let want = {
let want: Want = {
bundleName: "com.example.myapplication",
moduleName: "entry",
abilityName: "SecondAbility"
......@@ -372,7 +406,7 @@ UIAbility生命周期回调，当系统预关闭开关打开后（配置系统
if (result.resultCode === 0) {
this.context.terminateSelf();
}
}).catch((err)=>{
}).catch((err: BusinessError)=>{
// 异常处理
console.log('startAbilityForResult failed, err:' + JSON.stringify(err));
this.context.terminateSelf();
......@@ -421,21 +455,27 @@ call(method: string, data: rpc.Parcelable): Promise&lt;void&gt;;
**示例：**
```ts
class MyMessageAble{ // 自定义的Parcelable数据结构
name:''
str:''
num: 1
constructor(name, str) {
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 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.str = str;
}
marshalling(messageSequence) {
marshalling(messageSequence: rpc.MessageSequence) {
messageSequence.writeInt(this.num);
messageSequence.writeString(this.str);
console.log('MyMessageAble marshalling num[${this.num}] str[${this.str}]');
return true;
}
unmarshalling(messageSequence) {
unmarshalling(messageSequence: rpc.MessageSequence) {
this.num = messageSequence.readInt();
this.str = messageSequence.readString();
console.log('MyMessageAble unmarshalling num[${this.num}] str[${this.str}]');
......@@ -443,9 +483,9 @@ call(method: string, data: rpc.Parcelable): Promise&lt;void&gt;;
}
};
let method = 'call_Function'; // 约定的通知消息字符串
let caller;
let caller: Caller;
export default class MainUIAbility extends UIAbility {
onWindowStageCreate(windowStage) {
onWindowStageCreate(windowStage: window.WindowStage) {
this.context.startAbilityByCall({
bundleName: 'com.example.myservice',
abilityName: 'MainUIAbility',
......@@ -457,10 +497,10 @@ call(method: string, data: rpc.Parcelable): Promise&lt;void&gt;;
.then(() => {
console.log('Caller call() called');
})
.catch((callErr) => {
.catch((callErr: BusinessError) => {
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}');
});
}
......@@ -502,21 +542,27 @@ callWithResult(method: string, data: rpc.Parcelable): Promise&lt;rpc.MessageSequ
**示例：**
```ts
class MyMessageAble{
name:''
str:''
num: 1
constructor(name, str) {
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 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.str = str;
}
marshalling(messageSequence) {
marshalling(messageSequence: rpc.MessageSequence) {
messageSequence.writeInt(this.num);
messageSequence.writeString(this.str);
console.log('MyMessageAble marshalling num[${this.num}] str[${this.str}]');
return true;
}
unmarshalling(messageSequence) {
unmarshalling(messageSequence: rpc.MessageSequence) {
this.num = messageSequence.readInt();
this.str = messageSequence.readString();
console.log('MyMessageAble unmarshalling num[${this.num] str[${this.str}]');
......@@ -524,9 +570,9 @@ callWithResult(method: string, data: rpc.Parcelable): Promise&lt;rpc.MessageSequ
}
};
let method = 'call_Function';
let caller;
let caller: Caller;
export default class MainUIAbility extends UIAbility {
onWindowStageCreate(windowStage) {
onWindowStageCreate(windowStage: window.WindowStage) {
this.context.startAbilityByCall({
bundleName: 'com.example.myservice',
abilityName: 'MainUIAbility',
......@@ -540,10 +586,10 @@ callWithResult(method: string, data: rpc.Parcelable): Promise&lt;rpc.MessageSequ
let retmsg = new MyMessageAble(0, '');
data.readParcelable(retmsg);
})
.catch((callErr) => {
.catch((callErr: BusinessError) => {
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}');
});
}
......@@ -571,9 +617,14 @@ release(): void;
**示例：**
```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 {
onWindowStageCreate(windowStage) {
onWindowStageCreate(windowStage: window.WindowStage) {
this.context.startAbilityByCall({
bundleName: 'com.example.myservice',
abilityName: 'MainUIAbility',
......@@ -585,7 +636,7 @@ release(): void;
} catch (releaseErr) {
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}');
});
}
......@@ -617,9 +668,14 @@ release(): void;
**示例：**
```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 {
onWindowStageCreate(windowStage) {
onWindowStageCreate(windowStage: window.WindowStage) {
this.context.startAbilityByCall({
bundleName: 'com.example.myservice',
abilityName: 'MainUIAbility',
......@@ -633,7 +689,7 @@ release(): void;
} catch (error) {
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}');
});
}
......@@ -666,9 +722,11 @@ onRemoteStateChange(callback: OnRemoteStateChangeCallback): void;
```ts
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;
let caller: Caller;
let dstDeviceId: string;
export default class MainAbility extends UIAbility {
onWindowStageCreate(windowStage: window.WindowStage) {
......@@ -685,7 +743,7 @@ onRemoteStateChange(callback: OnRemoteStateChangeCallback): void;
} catch (error) {
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)}');
})
}
......@@ -719,9 +777,14 @@ on(type: 'release', callback: OnReleaseCallback): void;
**示例：**
```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 {
onWindowStageCreate(windowStage) {
onWindowStageCreate(windowStage: window.WindowStage) {
this.context.startAbilityByCall({
bundleName: 'com.example.myservice',
abilityName: 'MainUIAbility',
......@@ -735,7 +798,7 @@ on(type: 'release', callback: OnReleaseCallback): void;
} catch (error) {
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}');
});
}
......@@ -766,9 +829,14 @@ off(type: 'release', callback: OnReleaseCallback): void;
**示例：**
```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 {
onWindowStageCreate(windowStage) {
onWindowStageCreate(windowStage: window.WindowStage) {
this.context.startAbilityByCall({
bundleName: 'com.example.myservice',
abilityName: 'MainUIAbility',
......@@ -776,7 +844,7 @@ off(type: 'release', callback: OnReleaseCallback): void;
}).then((obj) => {
caller = obj;
try {
let onReleaseCallBack = (str) => {
let onReleaseCallBack: OnReleaseCallback = (str) => {
console.log(' Caller OnRelease CallBack is called ${str}');
};
caller.on('release', onReleaseCallBack);
......@@ -784,7 +852,7 @@ off(type: 'release', callback: OnReleaseCallback): void;
} catch (error) {
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}');
});
}
......@@ -808,9 +876,14 @@ off(type: 'release'): void;
**示例：**
```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 {
onWindowStageCreate(windowStage) {
onWindowStageCreate(windowStage: window.WindowStage) {
this.context.startAbilityByCall({
bundleName: 'com.example.myservice',
abilityName: 'MainUIAbility',
......@@ -818,7 +891,7 @@ off(type: 'release'): void;
}).then((obj) => {
caller = obj;
try {
let onReleaseCallBack = (str) => {
let onReleaseCallBack: OnReleaseCallback = (str) => {
console.log(' Caller OnRelease CallBack is called ${str}');
};
caller.on('release', onReleaseCallBack);
......@@ -826,7 +899,7 @@ off(type: 'release'): void;
} catch (error) {
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}');
});
}
......@@ -864,21 +937,26 @@ on(method: string, callback: CalleeCallback): void;
**示例：**
```ts
class MyMessageAble{
name:''
str:''
num: 1
constructor(name, str) {
import UIAbility, { CalleeCallback } from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import Want from '@ohos.app.ability.Want';
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.str = str;
}
marshalling(messageSequence) {
marshalling(messageSequence: rpc.MessageSequence) {
messageSequence.writeInt(this.num);
messageSequence.writeString(this.str);
console.log('MyMessageAble marshalling num[${this.num}] str[${this.str}]');
return true;
}
unmarshalling(messageSequence) {
unmarshalling(messageSequence: rpc.MessageSequence) {
this.num = messageSequence.readInt();
this.str = messageSequence.readString();
console.log('MyMessageAble unmarshalling num[${this.num}] str[${this.str}]');
......@@ -886,14 +964,14 @@ on(method: string, callback: CalleeCallback): void;
}
};
let method = 'call_Function';
function funcCallBack(pdata) {
function funcCallBack(pdata: rpc.MessageSequence) {
console.log('Callee funcCallBack is called ${pdata}');
let msg = new MyMessageAble('test', '');
pdata.readParcelable(msg);
return new MyMessageAble('test1', 'Callee test');
}
export default class MainUIAbility extends UIAbility {
onCreate(want, launchParam) {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
console.log('Callee onCreate is called');
try {
this.callee.on(method, funcCallBack);
......@@ -931,9 +1009,13 @@ off(method: string): void;
**示例：**
```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';
export default class MainUIAbility extends UIAbility {
onCreate(want, launchParam) {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
console.log('Callee onCreate is called');
try {
this.callee.off(method);
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-want.md
浏览文件 @ 10998067
......@@ -35,12 +35,14 @@ import Want from '@ohos.app.ability.Want';
```ts
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let want = {
'deviceId': '', // deviceId为空表示本设备
'bundleName': 'com.example.myapplication',
'abilityName': 'FuncAbility',
'moduleName': 'entry' // moduleName非必选
let want: Want = {
deviceId: '', // deviceId为空表示本设备
bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility',
moduleName: 'entry' // moduleName非必选
};
context.startAbility(want, (err) => {
......@@ -54,8 +56,10 @@ import Want from '@ohos.app.ability.Want';
* 字符串（String）
```ts
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let want = {
let want: Want = {
bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility',
parameters: {
......@@ -70,8 +74,10 @@ import Want from '@ohos.app.ability.Want';
* 数字（Number）
```ts
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let want = {
let want: Want = {
bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility',
parameters: {
......@@ -87,8 +93,10 @@ import Want from '@ohos.app.ability.Want';
* 布尔（Boolean）
```ts
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let want = {
let want: Want = {
bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility',
parameters: {
......@@ -103,8 +111,10 @@ import Want from '@ohos.app.ability.Want';
* 对象（Object）
```ts
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let want = {
let want: Want = {
bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility',
parameters: {
......@@ -124,8 +134,10 @@ import Want from '@ohos.app.ability.Want';
* 数组（Array）
```ts
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let want = {
let want: Want = {
bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility',
parameters: {
......@@ -142,23 +154,27 @@ import Want from '@ohos.app.ability.Want';
```
* 文件描述符（FD）
```ts
import fs from '@ohos.file.fs';
import fs from '@ohos.file.fs';
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 fd;
let fd: number = 0;
try {
fd = fs.openSync('/data/storage/el2/base/haps/pic.png').fd;
} catch(err) {
console.error(`Failed to openSync. Code: ${err.code}, message: ${err.message}`);
let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`Failed to openSync. Code: ${code}, message: ${message}`);
}
let want = {
'deviceId': '', // deviceId为空表示本设备
'bundleName': 'com.example.myapplication',
'abilityName': 'FuncAbility',
'moduleName': 'entry', // moduleName非必选
'parameters': {
let want: Want = {
deviceId: '', // deviceId为空表示本设备
bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility',
moduleName: 'entry', // moduleName非必选
parameters: {
'keyFd': { 'type': 'FD', 'value': fd } // {'type':'FD', 'value':fd}是固定用法，用于表示该数据是FD
}
};
......@@ -172,8 +188,10 @@ import Want from '@ohos.app.ability.Want';
```ts
// (1) UIAbility1启动一个ServiceExtension
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let want = {
let want: Want = {
bundleName: 'com.example.myapplication1',
abilityName: 'ServiceExtensionAbility',
};
......@@ -184,8 +202,11 @@ import Want from '@ohos.app.ability.Want';
```ts
// (2) 该ServiceExtension去启动另一个UIAbility2，并在启动的时候携带参数ability.params.backToOtherMissionStack为true
let context ; // ServiceExtensionContext
let want = {
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.ServiceExtensionContext; // ServiceExtensionContext
let want: Want = {
bundleName: 'com.example.myapplication2',
abilityName: 'MainAbility',
parameters: {
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-wantAgent.md
浏览文件 @ 10998067
......@@ -39,10 +39,14 @@ getWantAgent(info: WantAgentInfo, callback: AsyncCallback\<WantAgent\>): void
**示例：**
```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象
let wantAgent;
let wantAgent: _WantAgent;
//WantAgentInfo对象
let wantAgentInfo = {
let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [
{
deviceId: 'deviceId',
......@@ -62,7 +66,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true,
}
}
} as Want
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
......@@ -70,7 +74,7 @@ let wantAgentInfo = {
};
//getWantAgent回调
function getWantAgentCallback(err, data) {
function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) {
wantAgent = data;
} else {
......@@ -118,9 +122,13 @@ getWantAgent(info: WantAgentInfo): Promise\<WantAgent\>
**示例：**
```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对象
let wantAgentInfo = {
let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [
{
deviceId: 'deviceId',
......@@ -140,7 +148,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true,
}
}
} as Want
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
......@@ -150,7 +158,7 @@ let wantAgentInfo = {
try {
WantAgent.getWantAgent(wantAgentInfo).then((data) => {
wantAgent = data;
}).catch((err) => {
}).catch((err: BusinessError) => {
console.error('getWantAgent failed! ${err.code} ${err.message}');
});
} catch (err) {
......@@ -187,10 +195,14 @@ getBundleName(agent: WantAgent, callback: AsyncCallback\<string\>): void
**示例：**
```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象
let wantAgent;
let wantAgent: _WantAgent;
//WantAgentInfo对象
let wantAgentInfo = {
let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [
{
deviceId: 'deviceId',
......@@ -210,7 +222,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true,
}
}
} as Want
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
......@@ -218,14 +230,14 @@ let wantAgentInfo = {
};
//getWantAgent回调
function getWantAgentCallback(err, data) {
function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) {
wantAgent = data;
} else {
console.error('getWantAgent failed ${JSON.stringify(wantAgent)}');
}
//getBundleName回调
function getBundleNameCallback(err, data) {
let getBundleNameCallback = (err: BusinessError, data: string) => {
if(err) {
console.error('getBundleName failed! ${err.code} ${err.message}');
} else {
......@@ -279,10 +291,14 @@ getBundleName(agent: WantAgent): Promise\<string\>
**示例：**
```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象
let wantAgent;
let wantAgent: _WantAgent;
//WantAgentInfo对象
let wantAgentInfo = {
let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [
{
deviceId: 'deviceId',
......@@ -302,7 +318,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true,
}
}
} as Want
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
......@@ -310,7 +326,7 @@ let wantAgentInfo = {
};
//getWantAgent回调
function getWantAgentCallback(err, data) {
function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) {
wantAgent = data;
} else {
......@@ -319,7 +335,7 @@ function getWantAgentCallback(err, data) {
try {
WantAgent.getBundleName(wantAgent).then((data)=>{
console.info('getBundleName ok! ${JSON.stringify(data)}');
}).catch((err)=>{
}).catch((err: BusinessError)=>{
console.error('getBundleName failed! ${err.code} ${err.message}');
});
} catch(err){
......@@ -362,11 +378,14 @@ getUid(agent: WantAgent, callback: AsyncCallback\<number\>): void
**示例：**
```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对象
let wantAgent;
let wantAgent: _WantAgent;
//WantAgentInfo对象
let wantAgentInfo = {
let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [
{
deviceId: 'deviceId',
......@@ -386,7 +405,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true,
}
}
} as Want
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
......@@ -394,14 +413,14 @@ let wantAgentInfo = {
};
//getWantAgent回调
function getWantAgentCallback(err, data) {
function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) {
wantAgent = data;
} else {
console.info('getWantAgent failed ${JSON.stringify(err)}');
}
//getUid回调
function getUidCallback(err, data) {
let getUidCallback = (err: BusinessError, data: number) => {
if(err) {
console.error('getUid failed! ${err.code} ${err.message}');
} else {
......@@ -455,10 +474,14 @@ getUid(agent: WantAgent): Promise\<number\>
**示例：**
```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象
let wantAgent;
let wantAgent: _WantAgent;
//WantAgentInfo对象
let wantAgentInfo = {
let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [
{
deviceId: 'deviceId',
......@@ -478,7 +501,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true,
}
}
} as Want
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
......@@ -486,7 +509,7 @@ let wantAgentInfo = {
};
//getWantAgent回调
function getWantAgentCallback(err, data) {
function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) {
wantAgent = data;
} else {
......@@ -495,7 +518,7 @@ function getWantAgentCallback(err, data) {
try {
WantAgent.getUid(wantAgent).then((data)=>{
console.info('getUid ok! ${JSON.stringify(data)}');
}).catch((err)=>{
}).catch((err: BusinessError)=>{
console.error('getUid failed! ${err.code} ${err.message}');
});
} catch(err){
......@@ -540,10 +563,14 @@ getWant(agent: WantAgent, callback: AsyncCallback\<Want\>): void
**示例：**
```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象
let wantAgent;
let wantAgent: _WantAgent;
//WantAgentInfo对象
let wantAgentInfo = {
let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [
{
deviceId: 'deviceId',
......@@ -563,7 +590,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true,
}
}
} as Want
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
......@@ -571,14 +598,14 @@ let wantAgentInfo = {
};
//getWantAgent回调
function getWantAgentCallback(err, data) {
function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) {
wantAgent = data;
} else {
console.error('getWantAgent failed ${JSON.stringify(wantAgent)}');
}
//getWant回调
function getWantCallback(err, data) {
let getWantCallback = (err: BusinessError, data: Want) => {
if(err) {
console.error('getWant failed! ${err.code} ${err.message}');
} else {
......@@ -635,10 +662,14 @@ getWant(agent: WantAgent): Promise\<Want\>
**示例：**
```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象
let wantAgent;
let wantAgent: _WantAgent;
//WantAgentInfo对象
let wantAgentInfo = {
let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [
{
deviceId: 'deviceId',
......@@ -658,7 +689,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true,
}
}
} as Want
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
......@@ -666,7 +697,7 @@ let wantAgentInfo = {
};
//getWantAgent回调
function getWantAgentCallback(err, data) {
function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) {
wantAgent = data;
} else {
......@@ -675,7 +706,7 @@ function getWantAgentCallback(err, data) {
try {
WantAgent.getUid(wantAgent).then((data)=>{
console.info('getUid ok! ${JSON.stringify(data)}');
}).catch((err)=>{
}).catch((err: BusinessError)=>{
console.error('getUid failed! ${err.code} ${err.message}');
});
} catch(err){
......@@ -718,10 +749,14 @@ cancel(agent: WantAgent, callback: AsyncCallback\<void\>): void
**示例：**
```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象
let wantAgent;
let wantAgent: _WantAgent;
//WantAgentInfo对象
let wantAgentInfo = {
let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [
{
deviceId: 'deviceId',
......@@ -741,7 +776,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true,
}
}
} as Want
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
......@@ -749,14 +784,14 @@ let wantAgentInfo = {
};
//getWantAgent回调
function getWantAgentCallback(err, data) {
function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) {
wantAgent = data;
} else {
console.error('getWantAgent failed ${JSON.stringify(wantAgent)}');
}
//cancel回调
function cancelCallback(err, data) {
let cancelCallback = (err: BusinessError, data: void) => {
if(err) {
console.error('cancel failed! ${err.code} ${err.message}');
} else {
......@@ -810,10 +845,14 @@ cancel(agent: WantAgent): Promise\<void\>
**示例：**
```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象
let wantAgent;
let wantAgent: _WantAgent;
//WantAgentInfo对象
let wantAgentInfo = {
let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [
{
deviceId: 'deviceId',
......@@ -833,7 +872,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true,
}
}
} as Want
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
......@@ -841,7 +880,7 @@ let wantAgentInfo = {
};
//getWantAgent回调
function getWantAgentCallback(err, data) {
function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) {
wantAgent = data;
} else {
......@@ -850,7 +889,7 @@ function getWantAgentCallback(err, data) {
try {
WantAgent.cancel(wantAgent).then((data)=>{
console.info('cancel ok!');
}).catch((err)=>{
}).catch((err: BusinessError)=>{
console.error('cancel failed! ${err.code} ${err.message}');
});
} catch(err){
......@@ -883,14 +922,18 @@ trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: AsyncCallback\<Co
**示例：**
```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象
let wantAgent;
let wantAgent: _WantAgent;
// triggerInfo
let triggerInfo = {
let triggerInfo: WantAgent.TriggerInfo = {
code: 0 //自定义义结果码
};
//WantAgentInfo对象
let wantAgentInfo = {
let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [
{
deviceId: 'deviceId',
......@@ -910,7 +953,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true,
}
}
} as Want
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
......@@ -918,14 +961,14 @@ let wantAgentInfo = {
};
//getWantAgent回调
function getWantAgentCallback(err, data) {
function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) {
wantAgent = data;
} else {
console.error('getWantAgent failed ${JSON.stringify(wantAgent)}');
}
//trigger回调
function triggerCallback(err, data) {
let triggerCallback = (err: BusinessError, data: WantAgent.CompleteData) => {
if(err) {
console.error('getUid failed! ${err.code} ${err.message}');
} else {
......@@ -966,11 +1009,15 @@ equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback\<boolean\
**示例：**
```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象
let wantAgent1;
let wantAgent2;
let wantAgent1: _WantAgent;
let wantAgent2: _WantAgent;
//WantAgentInfo对象
let wantAgentInfo = {
let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [
{
deviceId: 'deviceId',
......@@ -990,7 +1037,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true,
}
}
} as Want
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
......@@ -998,7 +1045,7 @@ let wantAgentInfo = {
};
//getWantAgent回调
function getWantAgentCallback(err, data) {
function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) {
wantAgent1 = data;
wantAgent2 = data;
......@@ -1006,7 +1053,7 @@ function getWantAgentCallback(err, data) {
console.error('getWantAgent failed ${JSON.stringify(wantAgent)}');
}
//equal回调
function equalCallback(err, data) {
let equalCallback = (err: BusinessError, data: boolean) => {
if(err) {
console.error('equal failed! ${err.code} ${err.message}');
} else {
......@@ -1052,11 +1099,15 @@ equal(agent: WantAgent, otherAgent: WantAgent): Promise\<boolean\>
**示例：**
```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象
let wantAgent1;
let wantAgent2;
let wantAgent1: _WantAgent;
let wantAgent2: _WantAgent;
//WantAgentInfo对象
let wantAgentInfo = {
let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [
{
deviceId: 'deviceId',
......@@ -1076,7 +1127,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true,
}
}
} as Want
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
......@@ -1084,7 +1135,7 @@ let wantAgentInfo = {
};
//getWantAgent回调
function getWantAgentCallback(err, data) {
function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) {
wantAgent1 = data;
wantAgent2 = data;
......@@ -1094,7 +1145,7 @@ function getWantAgentCallback(err, data) {
try {
WantAgent.equal(wantAgent1,wantAgent2).then((data)=>{
console.info('equal ok! ${JSON.stringify(data)}');
}).catch((err)=>{
}).catch((err: BusinessError)=>{
console.error('equal failed! ${err.code} ${err.message}');
})
} catch(err){
......@@ -1136,10 +1187,14 @@ getOperationType(agent: WantAgent, callback: AsyncCallback\<number>): void;
**示例：**
```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象
let wantAgent;
let wantAgent: _WantAgent;
//WantAgentInfo对象
let wantAgentInfo = {
let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [
{
deviceId: 'deviceId',
......@@ -1159,7 +1214,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true,
}
}
} as Want
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
......@@ -1167,14 +1222,14 @@ let wantAgentInfo = {
};
//getWantAgent回调
function getWantAgentCallback(err, data) {
function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) {
wantAgent = data;
} else {
console.error('getWantAgent failed ${JSON.stringify(wantAgent)}');
}
//getOperationTypeCallback回调
function getOperationTypeCallback(err, data) {
let getOperationTypeCallback = (err: BusinessError, data: number) => {
if(err) {
console.error('getOperationType failed! ${err.code} ${err.message}');
} else {
......@@ -1227,10 +1282,14 @@ getOperationType(agent: WantAgent): Promise\<number>;
**示例：**
```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象
let wantAgent;
let wantAgent: _WantAgent;
//WantAgentInfo对象
let wantAgentInfo = {
let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [
{
deviceId: 'deviceId',
......@@ -1250,7 +1309,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true,
}
}
} as Want
],
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
......@@ -1258,7 +1317,7 @@ let wantAgentInfo = {
};
//getWantAgent回调
function getWantAgentCallback(err, data) {
function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) {
wantAgent = data;
} else {
......@@ -1267,7 +1326,7 @@ function getWantAgentCallback(err, data) {
try {
WantAgent.getOperationType(wantAgent).then((data)=>{
console.info('getOperationType ok! ${JSON.stringify(data)}');
}).catch((err)=>{
}).catch((err: BusinessError) => {
console.error('getOperationType failed! ${err.code} ${err.message}');
});
} catch(err){
......
zh-cn/application-dev/reference/apis/js-apis-application-StaticSubscriberExtensionContext.md
浏览文件 @ 10998067
......@@ -21,9 +21,10 @@ import StaticSubscriberExtensionContext from '@ohos.application.StaticSubscriber
```ts
import StaticSubscriberExtensionAbility from '@ohos.application.StaticSubscriberExtensionAbility'
import StaticSubscriberExtensionContext from '@ohos.application.StaticSubscriberExtensionContext'
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;
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: "com.example.myapp",
abilityName: "MyAbility"
};
try {
this.context.startAbility(want, (error) => {
this.context.startAbility(want, (error: BusinessError) => {
if (error) {
// 处理业务逻辑错误
console.log('startAbility failed, error.code: ' + JSON.stringify(error.code) +
......@@ -91,8 +95,10 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
});
} catch (paramError) {
// 处理入参错误异常
console.log('startAbility failed, 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.log('startAbility failed, error.code: ' + JSON.stringify(code) +
' error.message: ' + JSON.stringify(message));
}
```
......@@ -147,7 +153,10 @@ startAbility(want: Want): Promise&lt;void&gt;;
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: "com.example.myapp",
abilityName: "MyAbility"
};
......@@ -158,14 +167,16 @@ startAbility(want: Want): Promise&lt;void&gt;;
// 执行正常业务
console.log('startAbility succeed');
})
.catch((error) => {
.catch((error: BusinessError) => {
// 处理业务逻辑错误
console.log('startAbility failed, error.code: ' + JSON.stringify(error.code) +
' error.message: ' + JSON.stringify(error.message));
});
} catch (paramError) {
// 处理入参错误异常
console.log('startAbility failed, 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.log('startAbility failed, error.code: ' + JSON.stringify(code) +
' error.message: ' + JSON.stringify(message));
}
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegatorRegistry.md
浏览文件 @ 10998067
......@@ -43,9 +43,9 @@ getAbilityDelegator(): AbilityDelegator
**示例：**
```ts
let abilityDelegator;
import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry';
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
```
## AbilityDelegatorRegistry.getArguments
......@@ -65,6 +65,8 @@ getArguments(): AbilityDelegatorArgs
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry';
let args = AbilityDelegatorRegistry.getArguments();
console.info('getArguments bundleName: ${args.bundleName}');
console.info('getArguments testCaseNames: ${args.testCaseNames}');
......
zh-cn/application-dev/reference/apis/js-apis-application-abilityManager.md
浏览文件 @ 10998067
......@@ -49,7 +49,10 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void
**示例**：
```ts
let config = {
import abilityManager from '@ohos.application.abilityManager';
import { Configuration } from '@ohos.application.Configuration';
let config: Configuration = {
language: 'chinese'
};
......@@ -83,13 +86,17 @@ updateConfiguration(config: Configuration): Promise\<void>
**示例**：
```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'
};
abilityManager.updateConfiguration(config).then(() => {
console.log('updateConfiguration success');
}).catch((err) => {
}).catch((err: BusinessError) => {
console.error('updateConfiguration fail');
});
```
......@@ -113,6 +120,8 @@ getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): vo
**示例**：
```ts
import abilityManager from '@ohos.application.abilityManager';
abilityManager.getAbilityRunningInfos((err,data) => {
console.log('getAbilityRunningInfos err: ${err}, data: ${JSON.stringify(data)}');
});
......@@ -137,9 +146,12 @@ getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>>
**示例**：
```ts
import abilityManager from '@ohos.application.abilityManager';
import { BusinessError } from '@ohos.base';
abilityManager.getAbilityRunningInfos().then((data) => {
console.log('getAbilityRunningInfos data: ${JSON.stringify(data)}');
}).catch((err) => {
}).catch((err: BusinessError) => {
console.error('getAbilityRunningInfos err: ${JSON.stringify(err)}');
});
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-application-appManager.md
浏览文件 @ 10998067
......@@ -29,6 +29,8 @@ static isRunningInStabilityTest(callback: AsyncCallback&lt;boolean&gt;): void
**示例：**
```ts
import appManager from '@ohos.application.appManager';
appManager.isRunningInStabilityTest((error, flag) => {
if (error && error.code !== 0) {
console.error('isRunningInStabilityTest fail, error: ${JSON.stringify(error)}');
......@@ -56,9 +58,12 @@ static isRunningInStabilityTest(): Promise&lt;boolean&gt;
**示例：**
```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
appManager.isRunningInStabilityTest().then((flag) => {
console.log('The result of isRunningInStabilityTest is: ${JSON.stringify(flag)}');
}).catch((error) => {
}).catch((error: BusinessError) => {
console.error('error: ${JSON.stringify(error)}');
});
```
......@@ -81,9 +86,12 @@ isRamConstrainedDevice(): Promise\<boolean>;
**示例：**
```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
appManager.isRamConstrainedDevice().then((data) => {
console.log('The result of isRamConstrainedDevice is: ${JSON.stringify(data)}');
}).catch((error) => {
}).catch((error: BusinessError) => {
console.error('error: ${JSON.stringify(error)}');
});
```
......@@ -105,6 +113,8 @@ isRamConstrainedDevice(callback: AsyncCallback\<boolean>): void;
**示例：**
```ts
import appManager from '@ohos.application.appManager';
appManager.isRamConstrainedDevice((error, data) => {
if (error && error.code !== 0) {
console.error('isRamConstrainedDevice fail, error: ${JSON.stringify(error)}');
......@@ -131,9 +141,12 @@ getAppMemorySize(): Promise\<number>;
**示例：**
```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
appManager.getAppMemorySize().then((data) => {
console.log('The size of app memory is: ${JSON.stringify(data)}');
}).catch((error) => {
}).catch((error: BusinessError) => {
console.error('error: ${JSON.stringify(error)}');
});
```
......@@ -155,6 +168,8 @@ getAppMemorySize(callback: AsyncCallback\<number>): void;
**示例：**
```ts
import appManager from '@ohos.application.appManager';
appManager.getAppMemorySize((error, data) => {
if (error && error.code !== 0) {
console.error('getAppMemorySize fail, error: ${JSON.stringify(error)}');
......@@ -184,9 +199,12 @@ getProcessRunningInfos(): Promise\<Array\<ProcessRunningInfo>>;
**示例：**
```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
appManager.getProcessRunningInfos().then((data) => {
console.log('The process running infos is: ${JSON.stringify(data)}');
}).catch((error) => {
}).catch((error: BusinessError) => {
console.error('error: ${JSON.stringify(error)}');
});
```
......@@ -212,6 +230,8 @@ getProcessRunningInfos(callback: AsyncCallback\<Array\<ProcessRunningInfo>>): vo
**示例：**
```ts
import appManager from '@ohos.application.appManager';
appManager.getProcessRunningInfos((error, data) => {
if (error && error.code !== 0) {
console.error('getProcessRunningInfos fail, error: ${JSON.stringify(error)}');
......@@ -242,7 +262,9 @@ registerApplicationStateObserver(observer: ApplicationStateObserver): number;
**示例：**
```ts
let applicationStateObserver = {
import appManager from '@ohos.application.appManager';
const observerCode = appManager.registerApplicationStateObserver({
onForegroundApplicationChanged(appStateData) {
console.log('------------ onForegroundApplicationChanged -----------', appStateData);
},
......@@ -258,8 +280,7 @@ registerApplicationStateObserver(observer: ApplicationStateObserver): number;
onProcessStateChanged(processData) {
console.log('------------ onProcessStateChanged -----------', processData);
}
};
const observerCode = appManager.registerApplicationStateObserver(applicationStateObserver);
});
console.log('-------- observerCode: ---------', observerCode);
```
......@@ -285,9 +306,12 @@ unregisterApplicationStateObserver(observerId: number, callback: AsyncCallback\
**示例：**
```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let observerId = 100;
function unregisterApplicationStateObserverCallback(err) {
function unregisterApplicationStateObserverCallback(err: BusinessError) {
if (err) {
console.error('------------ unregisterApplicationStateObserverCallback ------------', err);
}
......@@ -322,13 +346,16 @@ unregisterApplicationStateObserver(observerId: number): Promise\<void>;
**示例：**
```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let observerId = 100;
appManager.unregisterApplicationStateObserver(observerId)
.then((data) => {
console.log('----------- unregisterApplicationStateObserver success ----------', data);
})
.catch((err) => {
.catch((err: BusinessError) => {
console.error('----------- unregisterApplicationStateObserver fail ----------', err);
});
```
......@@ -354,14 +381,15 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void;
**示例：**
```ts
function getForegroundApplicationsCallback(err, data) {
import appManager from '@ohos.application.appManager';
appManager.getForegroundApplications((err, data) => {
if (err) {
console.error('--------- getForegroundApplicationsCallback fail ---------', err);
} else {
console.log('--------- getForegroundApplicationsCallback success ---------', data);
}
}
appManager.getForegroundApplications(getForegroundApplicationsCallback);
});
```
## appManager.getForegroundApplications<sup>8+</sup>
......@@ -385,11 +413,14 @@ getForegroundApplications(): Promise\<Array\<AppStateData>>;
**示例：**
```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
appManager.getForegroundApplications()
.then((data) => {
console.log('--------- getForegroundApplications success -------', data);
})
.catch((err) => {
.catch((err: BusinessError) => {
console.error('--------- getForegroundApplications fail -------', err);
});
```
......@@ -420,13 +451,16 @@ killProcessWithAccount(bundleName: string, accountId: number): Promise\<void\>
**示例：**
```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName';
let accountId = 0;
appManager.killProcessWithAccount(bundleName, accountId)
.then((data) => {
console.log('------------ killProcessWithAccount success ------------', data);
})
.catch((err) => {
.catch((err: BusinessError) => {
console.error('------------ killProcessWithAccount fail ------------', err);
});
```
......@@ -459,9 +493,12 @@ killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCal
**示例：**
```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName';
let accountId = 0;
function killProcessWithAccountCallback(err, data) {
function killProcessWithAccountCallback(err: BusinessError, data: void) {
if (err) {
console.error('------------- killProcessWithAccountCallback fail, err: --------------', err);
} else {
......@@ -493,8 +530,11 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>);
**示例：**
```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName';
function killProcessesByBundleNameCallback(err, data) {
function killProcessesByBundleNameCallback(err: BusinessError, data: void) {
if (err) {
console.error('------------- killProcessesByBundleNameCallback fail, err: --------------', err);
} else {
......@@ -531,12 +571,15 @@ killProcessesByBundleName(bundleName: string): Promise\<void>;
**示例：**
```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'com.example.myapplication';
appManager.killProcessesByBundleName(bundleName)
.then((data) => {
console.log('------------ killProcessesByBundleName success ------------', data);
})
.catch((err) => {
.catch((err: BusinessError) => {
console.error('------------ killProcessesByBundleName fail ------------', err);
});
```
......@@ -563,8 +606,11 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>);
**示例：**
```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName';
function clearUpApplicationDataCallback(err, data) {
function clearUpApplicationDataCallback(err: BusinessError, data: void) {
if (err) {
console.error('------------- clearUpApplicationDataCallback fail, err: --------------', err);
} else {
......@@ -601,12 +647,15 @@ clearUpApplicationData(bundleName: string): Promise\<void>;
**示例：**
```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName';
appManager.clearUpApplicationData(bundleName)
.then((data) => {
console.log('------------ clearUpApplicationData success ------------', data);
})
.catch((err) => {
.catch((err: BusinessError) => {
console.error('------------ clearUpApplicationData fail ------------', err);
});
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-application-configuration.md
浏览文件 @ 10998067
......@@ -25,17 +25,20 @@ import Configuration from '@ohos.application.Configuration';
**示例：**
```ts
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';
export default class EntryAbility extends UIAbility {
onCreate(want, launchParam) {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
}
onDestroy() {
}
onWindowStageCreate(windowStage: Window.WindowStage) {
let envCallback = {
let envCallback: EnvironmentCallback = {
onConfigurationUpdated(config) {
console.info(`envCallback onConfigurationUpdated success: ${JSON.stringify(config)}`);
let language = config.language;
......
zh-cn/application-dev/reference/apis/js-apis-application-missionManager.md
浏览文件 @ 10998067
......@@ -43,17 +43,18 @@ registerMissionListener(listener: MissionListener): number;
**示例：**
```ts
let listener = {
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-------');}
};
import missionManager from '@ohos.application.missionManager';
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
**示例：**
```ts
let listener = {
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-------');}
};
import missionManager from '@ohos.application.missionManager';
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) => {
console.error('unregisterMissionListener fail, error: ${error}');
......@@ -124,19 +126,21 @@ unregisterMissionListener(listenerId: number): Promise&lt;void&gt;;
**示例：**
```ts
let listener = {
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-------');}
};
import missionManager from '@ohos.application.missionManager';
import { BusinessError } from '@ohos.base';
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}');
});
```
......@@ -166,21 +170,23 @@ getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback&lt;M
```ts
import missionManager from '@ohos.application.missionManager';
import { BusinessError } from '@ohos.base';
let allMissions=missionManager.getMissionInfos('',10).catch(function(err){console.log(err);});
missionManager.getMissionInfo('', allMissions[0].missionId, (error, mission) => {
if (error.code) {
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.lockedState = ${mission.lockedState}');
console.log('mission.timestamp = ${mission.timestamp}');
console.log('mission.label = ${mission.label}');
console.log('mission.iconPath = ${mission.iconPath}');
});
let allMissions=missionManager.getMissionInfos('',10).catch((err: BusinessError) => {
console.log('${err}');});
missionManager.getMissionInfo('', allMissions[0].missionId, (error, mission) => {
if (error.code) {
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.lockedState = ${mission.lockedState}');
console.log('mission.timestamp = ${mission.timestamp}');
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;;
```ts
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}');
});
```
......@@ -285,8 +292,9 @@ getMissionInfos(deviceId: string, numMax: number): Promise&lt;Array&lt;MissionIn
```ts
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}');
});
```
......@@ -366,20 +374,21 @@ getMissionSnapShot(deviceId: string, missionId: number): Promise&lt;MissionSnaps
```ts
import missionManager from '@ohos.application.missionManager';
import { BusinessError } from '@ohos.base';
let allMissions;
missionManager.getMissionInfos('',10).then(function(res){
allMissions=res;
}).catch(function(error) {
console.error('getMissionInfos fail, error: ${error}');
});
let id: number = -1;
missionManager.getMissionInfos('',10).then((res) => {
let allMissions = res;
console.log('size = ${allMissions.length}');
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){
console.error('getMissionSnapShot fail, error: ${error}');
});
let snapshot = missionManager.getMissionSnapShot('', id).catch((error: BusinessError) => {
console.error('getMissionSnapShot fail, error: ${error}');
});
```
## missionManager.lockMission
......@@ -450,17 +459,19 @@ lockMission(missionId: number): Promise&lt;void&gt;;
```ts
import missionManager from '@ohos.application.missionManager';
let allMissions;
missionManager.getMissionInfos('',10).then(function(res){
allMissions=res;
}).catch(function(error) {
import { BusinessError } from '@ohos.base';
let id: number = -1;
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.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}');
});
```
......@@ -534,21 +545,22 @@ unlockMission(missionId: number): Promise&lt;void&gt;;
```ts
import missionManager from '@ohos.application.missionManager';
import { BusinessError } from '@ohos.base';
let allMissions;
missionManager.getMissionInfos('',10).then(function(res){
allMissions=res;
}).catch(function(error) {
let id: number = -1;
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.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}');
});
missionManager.unlockMission(id).catch(function (error){
missionManager.unlockMission(id).catch((error: BusinessError) => {
console.error('unlockMission fail, error: ${error}');
});
```
......@@ -622,18 +634,19 @@ clearMission(missionId: number): Promise&lt;void&gt;;
```ts
import missionManager from '@ohos.application.missionManager';
import { BusinessError } from '@ohos.base';
let allMissions;
missionManager.getMissionInfos('',10).then(function(res){
allMissions=res;
}).catch(function(error) {
let id: number = -1;
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.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}');
});
```
......@@ -684,7 +697,9 @@ clearAllMissions(): Promise&lt;void&gt;;
```ts
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}');
});
```
......@@ -800,18 +815,19 @@ moveMissionToFront(missionId: number, options?: StartOptions): Promise&lt;void&g
```ts
import missionManager from '@ohos.application.missionManager';
import { BusinessError } from '@ohos.base';
let allMissions;
missionManager.getMissionInfos('',10).then(function(res){
allMissions=res;
}).catch(function(error) {
let id: number = -1;
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.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}');
});
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-application-staticSubscriberExtensionAbility.md
浏览文件 @ 10998067
......@@ -41,8 +41,11 @@ onReceiveEvent(event: CommonEventData): void;
**示例：**
```ts
import StaticSubscriberExtensionAbility from '@ohos.application.StaticSubscriberExtensionAbility';
import CommonEventManager from '@ohos.commonEventManager';
class MyStaticSubscriberExtensionAbility extends StaticSubscriberExtensionAbility {
onReceiveEvent(event) {
onReceiveEvent(event: CommonEventManager.CommonEventData) {
console.log('onReceiveEvent, event: ${JSON.stringify(event)}');
}
}
......
zh-cn/application-dev/reference/apis/js-apis-application-testRunner.md
浏览文件 @ 10998067
......@@ -25,6 +25,8 @@ onPrepare(): void
**示例：**
```ts
import TestRunner from '@ohos.application.testRunner';
export default class UserTestRunner implements TestRunner {
onPrepare() {
console.log('Trigger onPrepare');
......@@ -46,6 +48,8 @@ onRun(): void
**示例：**
```ts
import TestRunner from '@ohos.application.testRunner';
export default class UserTestRunner implements TestRunner {
onPrepare() {}
onRun() {
......
zh-cn/application-dev/reference/apis/js-apis-application-want.md
浏览文件 @ 10998067
......@@ -33,13 +33,15 @@ import Want from '@ohos.application.Want';
- 基础用法(在UIAbility对象中调用，其中示例中的context为UIAbility的上下文对象)
```ts
let want = {
import Want from '@ohos.application.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
'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
console.error('error.code = ${error.code}');
});
......@@ -49,7 +51,9 @@ import Want from '@ohos.application.Want';
* 字符串（String）
```ts
let want = {
import Want from '@ohos.application.Want';
let want: Want = {
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility',
parameters: {
......@@ -59,7 +63,9 @@ import Want from '@ohos.application.Want';
```
* 数字（Number）
```ts
let want = {
import Want from '@ohos.application.Want';
let want: Want = {
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility',
parameters: {
......@@ -70,7 +76,9 @@ import Want from '@ohos.application.Want';
```
* 布尔（Boolean）
```ts
let want = {
import Want from '@ohos.application.Want';
let want: Want = {
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility',
parameters: {
......@@ -80,7 +88,9 @@ import Want from '@ohos.application.Want';
```
* 对象（Object）
```ts
let want = {
import Want from '@ohos.application.Want';
let want: Want = {
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility',
parameters: {
......@@ -95,7 +105,9 @@ import Want from '@ohos.application.Want';
```
* 数组（Array）
```ts
let want = {
import Want from '@ohos.application.Want';
let want: Want = {
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility',
parameters: {
......@@ -109,22 +121,24 @@ import Want from '@ohos.application.Want';
* 文件描述符（FD）
```ts
import fs from '@ohos.file.fs';
let fd;
import Want from '@ohos.application.Want';
import { BusinessError } from '@ohos.base';
let fd: number = 0;
try {
fd = fs.openSync('/data/storage/el2/base/haps/pic.png').fd;
} catch(e) {
console.error('openSync fail: ${JSON.stringify(e)}');
}
let want = {
'deviceId': '', // deviceId为空表示本设备
'bundleName': 'com.example.myapplication',
'abilityName': 'EntryAbility',
'moduleName': 'entry', // moduleName非必选
'parameters': {
let want: Want = {
deviceId: '', // deviceId为空表示本设备
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility',
parameters: {
'keyFd':{'type':'FD', 'value':fd}
}
};
this.context.startAbility(want, (error) => {
this.context.startAbility(want, (error: BusinessError) => {
// 显式拉起Ability，通过bundleName、abilityName和moduleName可以唯一确定一个Ability
console.error('error.code = ${error.code}');
});
......
zh-cn/application-dev/reference/apis/js-apis-businessAbilityRouter.md
浏览文件 @ 10998067
......@@ -72,17 +72,20 @@ queryBusinessAbilityInfo(filter: BusinessAbilityFilter, callback: AsyncCallback\
```ts
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 {
businessAbilityRouter.queryBusinessAbilityInfo(filter)
.then(() => {
console.info('queryBusinessAbilityInfo success');
}).catch((error) => {
}).catch((error: BusinessError) => {
console.error('queryBusinessAbilityInfo failed ' + error.message);
});
} 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
```ts
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 {
businessAbilityRouter.queryBusinessAbilityInfo(filter, (error, data) => {
......@@ -125,6 +130,7 @@ try {
console.info('queryBusinessAbilityInfo success');
});
} catch (error) {
console.error('queryBusinessAbilityInfo failed ' + error.message);
let message = (error as BusinessError).message;
console.error('queryBusinessAbilityInfo failed ' + message);
}
```
zh-cn/application-dev/reference/apis/js-apis-inner-ability-connectOptions.md
浏览文件 @ 10998067
......@@ -25,7 +25,10 @@ import common from '@ohos.app.ability.common';
**示例：**
```ts
let want = {
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let want: Want = {
bundleName: 'com.example.myapp',
abilityName: 'MyAbility'
};
......@@ -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
zh-cn/application-dev/reference/apis/js-apis-inner-ability-dataAbilityHelper.md
浏览文件 @ 10998067
......@@ -40,7 +40,9 @@ openFile(uri: string, mode: string, callback: AsyncCallback\<number>): void
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
......@@ -78,7 +80,9 @@ openFile(uri: string, mode: string): Promise\<number>
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
......@@ -107,7 +111,9 @@ on(type: 'dataChange', uri: string, callback: AsyncCallback\<void>): void
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
......@@ -140,7 +146,9 @@ off(type: 'dataChange', uri: string, callback?: AsyncCallback\<void>): void
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
......@@ -176,7 +184,9 @@ getType(uri: string, callback: AsyncCallback\<string>): void
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
......@@ -212,7 +222,9 @@ getType(uri: string): Promise\<string>
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
......@@ -240,7 +252,9 @@ getFileTypes(uri: string, mimeTypeFilter: string, callback: AsyncCallback<Array\
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
......@@ -277,7 +291,9 @@ getFileTypes(uri: string, mimeTypeFilter: string): Promise\<Array\<string>>
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
......@@ -304,7 +320,9 @@ normalizeUri(uri: string, callback: AsyncCallback\<string>): void
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
......@@ -340,7 +358,9 @@ normalizeUri(uri: string): Promise\<string>
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
......@@ -367,7 +387,9 @@ denormalizeUri(uri: string, callback: AsyncCallback\<string>): void
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
......@@ -403,7 +425,9 @@ denormalizeUri(uri: string): Promise\<string>
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
......@@ -430,7 +454,9 @@ notifyChange(uri: string, callback: AsyncCallback\<void>): void
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
......@@ -466,7 +492,9 @@ notifyChange(uri: string): Promise\<void>
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
......@@ -494,11 +522,14 @@ insert(uri: string, valuesBucket: rdb.ValuesBucket, callback: AsyncCallback\<num
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
import rdb from '@ohos.data.rdb';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
const valueBucket = {
const valueBucket: rdb.ValuesBucket = {
'name': 'rose',
'age': 22,
'salary': 200.5,
......@@ -537,11 +568,14 @@ insert(uri: string, valuesBucket: rdb.ValuesBucket): Promise\<number>
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
import rdb from '@ohos.data.rdb';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
const valueBucket = {
const valueBucket: rdb.ValuesBucket = {
'name': 'rose1',
'age': 221,
'salary': 20.5,
......@@ -571,13 +605,16 @@ batchInsert(uri: string, valuesBuckets: Array\<rdb.ValuesBucket>, callback: Asyn
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
import rdb from '@ohos.data.rdb';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
let cars = new Array({'name': 'roe11', 'age': 21, 'salary': 20.5, 'blobType': 'u8',},
{'name': 'roe12', 'age': 21, 'salary': 20.5, 'blobType': 'u8',},
{'name': 'roe13', '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',} as rdb.ValuesBucket,
{'name': 'roe13', 'age': 21, 'salary': 20.5, 'blobType': 'u8',} as rdb.ValuesBucket);
DAHelper.batchInsert('dataability:///com.example.DataAbility', cars, (error, data) => {
if (error && error.code !== 0) {
console.error('batchInsert fail, error: ${JSON.stringify(error)}');
......@@ -611,13 +648,16 @@ batchInsert(uri: string, valuesBuckets: Array<rdb.ValuesBucket>): Promise\<numbe
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
import rdb from '@ohos.data.rdb';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
let cars = new Array({'name': 'roe11', 'age': 21, 'salary': 20.5, 'blobType': 'u8',},
{'name': 'roe12', 'age': 21, 'salary': 20.5, 'blobType': 'u8',},
{'name': 'roe13', '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',} as rdb.ValuesBucket,
{'name': 'roe13', 'age': 21, 'salary': 20.5, 'blobType': 'u8',} as rdb.ValuesBucket);
DAHelper.batchInsert('dataability:///com.example.DataAbility', cars).then((data) => {
console.info('batchInsert data: ${JSON.stringify(data)}');
});
......@@ -642,8 +682,10 @@ delete(uri: string, predicates: dataAbility.DataAbilityPredicates, callback: Asy
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
......@@ -681,8 +723,10 @@ delete(uri: string, predicates?: dataAbility.DataAbilityPredicates): Promise\<nu
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
......@@ -712,12 +756,15 @@ update(uri: string, valuesBucket: rdb.ValuesBucket, predicates: dataAbility.Data
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataAbility';
import rdb from '@ohos.data.rdb';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
const va = {
const va: rdb.ValuesBucket = {
'name': 'roe1',
'age': 21,
'salary': 20.5,
......@@ -758,12 +805,15 @@ update(uri: string, valuesBucket: rdb.ValuesBucket, predicates?: dataAbility.Dat
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataAbility';
import rdb from '@ohos.data.rdb';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
const va = {
const va: rdb.ValuesBucket = {
'name': 'roe1',
'age': 21,
'salary': 20.5,
......@@ -795,8 +845,10 @@ query(uri: string, columns: Array\<string>, predicates: dataAbility.DataAbilityP
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
......@@ -838,8 +890,10 @@ query(uri: string, columns?: Array\<string>, predicates?: dataAbility.DataAbilit
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataAbility';
let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.DataAbility'
);
......@@ -871,6 +925,7 @@ call(uri: string, method: string, arg: string, extras: PacMap, callback: AsyncCa
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
......@@ -912,7 +967,9 @@ call(uri: string, method: string, arg: string, extras: PacMap): Promise\<PacMap>
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
import { BusinessError } from '@ohos.base';
let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.jsapidemo.UserDataAbility'
......@@ -920,7 +977,7 @@ let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbi
dataAbilityHelper.call('dataability:///com.example.jsapidemo.UserDataAbility',
'method', 'arg', {'key1':'value1'}).then((data) => {
console.info('call success, data: ${data}');
}).catch((error) => {
}).catch((error: BusinessError) => {
console.error('call failed, error: ${error}');
});
```
......@@ -944,10 +1001,11 @@ executeBatch(uri: string, operations: Array\<DataAbilityOperation>, callback: As
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
// 根据DataAbilityOperation列表选择要对数据库做的操作
let op=new Array();
let op: Array<ability.DataAbilityOperation> = new Array();
let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.jsapidemo.UserDataAbility'
);
......@@ -984,16 +1042,18 @@ executeBatch(uri: string, operations: Array\<DataAbilityOperation>): Promise\<Ar
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
import { BusinessError } from '@ohos.base';
// 根据DataAbilityOperation列表选择要对数据库做的操作
let op=new Array();
let op: Array<ability.DataAbilityOperation> = new Array();
let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper(
'dataability:///com.example.jsapidemo.UserDataAbility'
);
dataAbilityHelper.executeBatch('dataability:///com.example.jsapidemo.UserDataAbility', op).then((data) => {
console.info('executeBatch success, data: ${data}');
}).catch((error) => {
}).catch((error: BusinessError) => {
console.error('executeBatch failed, error: ${error}');
});
......
zh-cn/application-dev/reference/apis/js-apis-inner-ability-dataAbilityResult.md
浏览文件 @ 10998067
......@@ -25,47 +25,42 @@ import ability from '@ohos.ability.ability';
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
import rdb from '@ohos.data.rdb';
// 批量执行数据库操作
function executeBatchOperation() {
let dataAbilityUri = ('dataability:///com.example.myapplication.TestDataAbility');
let DAHelper: ability.DataAbilityHelper;
try {
DAHelper = featureAbility.acquireDataAbilityHelper(dataAbilityUri);
if (DAHelper === null) {
console.error('DAHelper is null');
}
} catch (err) {
console.error('acquireDataAbilityHelper fail, error: ${JSON.stringify(err)}');
}
DAHelper = featureAbility.acquireDataAbilityHelper(dataAbilityUri);
let valueBucket = {
let valueBucket: rdb.ValuesBucket = {
'name': 'DataAbilityHelperTest',
'age': 24,
'salary': 2024.20,
};
let operations = [
{
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 predicateBackReferences = new Map<number, number>()
predicateBackReferences.set(1, 1)
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 {
DAHelper.executeBatch(dataAbilityUri, operations).then((data) => {
for (let i = 0; i < data.length; i++) {
......@@ -73,7 +68,7 @@ function executeBatchOperation() {
console.log('dataAbilityResult.uri: ${dataAbilityResult.uri}');
console.log('dataAbilityResult.count: ${dataAbilityResult.count}');
}
}).catch(err => {
}).catch((err: BusinessError) => {
console.error('executeBatch error: ${JSON.stringify(err)}');
});
} catch (err) {
......
zh-cn/application-dev/reference/apis/js-apis-inner-ability-startAbilityParameter.md
浏览文件 @ 10998067
......@@ -24,23 +24,23 @@ import ability from '@ohos.ability.ability';
**示例：**
```ts
import ability from '@ohos.ability.ability';
import featureAbility from '@ohos.ability.featureAbility';
import Want from '@ohos.app.ability.Want';
let Want = {
let want: Want = {
bundleName: 'com.example.abilityStartSettingApp2',
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 = {
want : Want,
abilityStartSetting : abilityStartSetting
want : want,
abilityStartSetting : {
abilityBounds : [100,200,300,400],
windowMode :
featureAbility.AbilityWindowConfiguration.WINDOW_MODE_UNDEFINED,
displayId : 1,
}
};
try {
......
zh-cn/application-dev/reference/apis/js-apis-inner-ability-want.md
浏览文件 @ 10998067
......@@ -33,13 +33,16 @@ import Want from '@ohos.app.ability.Want';
- 基础用法(在UIAbility对象中调用，其中示例中的context为UIAbility的上下文对象)
```ts
let want = {
'deviceId': '', // deviceId为空表示本设备
'bundleName': 'com.example.myapplication',
'abilityName': 'EntryAbility',
'moduleName': 'entry' // moduleName非必选
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
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
console.error('error.code = ${error.code}');
});
......@@ -49,24 +52,25 @@ import Want from '@ohos.app.ability.Want';
```ts
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 {
fd = fs.openSync('/data/storage/el2/base/haps/pic.png').fd;
} catch(e) {
console.error('openSync fail: ${JSON.stringify(e)}');
}
let want = {
'deviceId': '', // deviceId为空表示本设备
'bundleName': 'com.example.myapplication',
'abilityName': 'EntryAbility',
'moduleName': 'entry', // moduleName非必选
'parameters': {
let want: Want = {
deviceId: '', // deviceId为空表示本设备
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility',
moduleName: 'entry', // moduleName非必选
parameters: {
'keyFd':{'type':'FD', 'value':fd}
}
};
this.context.startAbility(want, (error) => {
this.context.startAbility(want, (error: BusinessError) => {
// 显式拉起Ability，通过bundleName、abilityName和moduleName可以唯一确定一个Ability
console.error('error.code = ${error.code}');
});
......
zh-cn/application-dev/reference/apis/js-apis-inner-app-context.md
浏览文件 @ 10998067
......@@ -174,8 +174,7 @@ verifyPermission(permission: string, options?: PermissionOptions): Promise\<numb
```ts
import featureAbility from '@ohos.ability.featureAbility';
let context: featureAbility.Context = featureAbility.getContext();
let Permission = {pid:1};
context.verifyPermission('com.context.permission',Permission).then((data) => {
context.verifyPermission('com.context.permission', {pid:1}).then((data) => {
console.info('verifyPermission data: ${JSON.stringify(data)}');
});
```
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityDelegator.md
浏览文件 @ 10998067
......@@ -47,19 +47,22 @@ addAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\<void>): void
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
function onAbilityCreateCallback(data) {
function onAbilityCreateCallback(data: UIAbility) {
console.info('onAbilityCreateCallback, data: ${JSON.stringify(data)}');
}
let monitor = {
let monitor: AbilityDelegatorRegistry.AbilityMonitor = {
abilityName: 'abilityname',
onAbilityCreate: onAbilityCreateCallback
};
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityMonitor(monitor, (error : any) => {
abilityDelegator.addAbilityMonitor(monitor, (error: BusinessError) => {
console.error('addAbilityMonitor fail, error: ${JSON.stringify(error)}');
});
```
......@@ -95,17 +98,19 @@ addAbilityMonitor(monitor: AbilityMonitor): Promise\<void>;
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
function onAbilityCreateCallback(data) {
function onAbilityCreateCallback(data: UIAbility) {
console.info('onAbilityCreateCallback');
}
let monitor = {
let monitor: AbilityDelegatorRegistry.AbilityMonitor = {
abilityName: 'abilityname',
onAbilityCreate: onAbilityCreateCallback
};
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityMonitor(monitor).then(() => {
console.info('addAbilityMonitor promise');
......@@ -138,13 +143,19 @@ addAbilityMonitorSync(monitor: AbilityMonitor): void;
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let monitor = {
function onAbilityCreateCallback(data: UIAbility) {
console.info('onAbilityCreateCallback');
}
let monitor: AbilityDelegatorRegistry.AbilityMonitor = {
abilityName: 'abilityname',
onAbilityCreate: onAbilityCreateCallback
};
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityMonitorSync(monitor);
```
......@@ -175,19 +186,23 @@ removeAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\<void>): v
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
function onAbilityCreateCallback(data) {
function onAbilityCreateCallback(data: UIAbility) {
console.info('onAbilityCreateCallback');
}
let monitor = {
let monitor: AbilityDelegatorRegistry.AbilityMonitor = {
abilityName: 'abilityname',
onAbilityCreate: onAbilityCreateCallback
};
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.removeAbilityMonitor(monitor, (error : any) => {
abilityDelegator.removeAbilityMonitor(monitor, (error: BusinessError) => {
console.error('removeAbilityMonitor fail, error: ${JSON.stringify(error)}');
});
```
......@@ -223,13 +238,16 @@ removeAbilityMonitor(monitor: AbilityMonitor): Promise\<void>;
- 示例
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
function onAbilityCreateCallback(data) {
function onAbilityCreateCallback(data: UIAbility) {
console.info('onAbilityCreateCallback');
}
let monitor = {
let monitor: AbilityDelegatorRegistry.AbilityMonitor = {
abilityName: 'abilityname',
onAbilityCreate: onAbilityCreateCallback
};
......@@ -266,9 +284,16 @@ removeAbilityMonitorSync(monitor: AbilityMonitor): void;
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let monitor = {
function onAbilityCreateCallback(data: UIAbility) {
console.info('onAbilityCreateCallback');
}
let monitor: AbilityDelegatorRegistry.AbilityMonitor = {
abilityName: 'abilityname',
onAbilityCreate: onAbilityCreateCallback
};
......@@ -303,19 +328,23 @@ waitAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\<UIAbility>)
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
function onAbilityCreateCallback(data) {
function onAbilityCreateCallback(data: UIAbility) {
console.info('onAbilityCreateCallback');
}
let monitor = {
let monitor: AbilityDelegatorRegistry.AbilityMonitor = {
abilityName: 'abilityname',
onAbilityCreate: onAbilityCreateCallback
};
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityMonitor(monitor, (error : any, data : any) => {
abilityDelegator.waitAbilityMonitor(monitor, (error : BusinessError, data : UIAbility) => {
if (error) {
console.error('waitAbilityMonitor fail, error: ${JSON.stringify(error)}');
} else {
......@@ -351,20 +380,24 @@ waitAbilityMonitor(monitor: AbilityMonitor, timeout: number, callback: AsyncCall
**示例：**
```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 timeout = 100;
function onAbilityCreateCallback(data) {
function onAbilityCreateCallback(data: UIAbility) {
console.info('onAbilityCreateCallback');
}
let monitor = {
let monitor: AbilityDelegatorRegistry.AbilityMonitor = {
abilityName: 'abilityname',
onAbilityCreate: onAbilityCreateCallback
};
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityMonitor(monitor, timeout, (error : any, data : any) => {
abilityDelegator.waitAbilityMonitor(monitor, timeout, (error : BusinessError, data : UIAbility) => {
if (error && error.code !== 0) {
console.error('waitAbilityMonitor fail, error: ${JSON.stringify(error)}');
} else {
......@@ -407,19 +440,22 @@ waitAbilityMonitor(monitor: AbilityMonitor, timeout?: number): Promise\<UIAbilit
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
function onAbilityCreateCallback(data) {
function onAbilityCreateCallback(data: UIAbility) {
console.info('onAbilityCreateCallback');
}
let monitor = {
let monitor: AbilityDelegatorRegistry.AbilityMonitor = {
abilityName: 'abilityname',
onAbilityCreate: onAbilityCreateCallback
};
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityMonitor(monitor).then((data : any) => {
abilityDelegator.waitAbilityMonitor(monitor).then((data : BusinessError) => {
console.info('waitAbilityMonitor promise');
});
```
......@@ -441,6 +477,8 @@ getAppContext(): Context;
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
......@@ -470,11 +508,15 @@ getAbilityState(ability: UIAbility): number;
**示例：**
```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 ability;
let ability: UIAbility;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => {
abilityDelegator.getCurrentTopAbility((err : BusinessError, data : UIAbility) => {
console.info('getCurrentTopAbility callback');
ability = data;
let state = abilityDelegator.getAbilityState(ability);
......@@ -507,11 +549,15 @@ getCurrentTopAbility(callback: AsyncCallback\<UIAbility>): void;
**示例：**
```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 ability;
let ability: UIAbility;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => {
abilityDelegator.getCurrentTopAbility((err : BusinessError, data : UIAbility) => {
console.info('getCurrentTopAbility callback');
ability = data;
});
......@@ -542,11 +588,14 @@ getCurrentTopAbility(): Promise\<UIAbility>;
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import UIAbility from '@ohos.app.ability.UIAbility';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let ability;
let ability: UIAbility;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility().then((data : any) => {
abilityDelegator.getCurrentTopAbility().then((data : UIAbility) => {
console.info('getCurrentTopAbility promise');
ability = data;
});
......@@ -592,14 +641,18 @@ startAbility(want: Want, callback: AsyncCallback\<void>): void;
**示例：**
```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 want = {
let want: Want = {
bundleName: 'bundleName',
abilityName: 'abilityName'
};
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.startAbility(want, (err : any, data : any) => {
abilityDelegator.startAbility(want, (err : BusinessError, data : void) => {
console.info('startAbility callback');
});
```
......@@ -649,14 +702,18 @@ startAbility(want: Want): Promise\<void>;
**示例：**
```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 want = {
let want: Want = {
bundleName: 'bundleName',
abilityName: 'abilityName'
};
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.startAbility(want).then((data: any) => {
abilityDelegator.startAbility(want).then((data: void) => {
console.info('startAbility promise');
});
```
......@@ -687,14 +744,18 @@ doAbilityForeground(ability: UIAbility, callback: AsyncCallback\<void>): void;
**示例：**
```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 ability;
let ability: UIAbility;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => {
abilityDelegator.getCurrentTopAbility((err : BusinessError, data : UIAbility) => {
console.info('getCurrentTopAbility callback');
ability = data;
abilityDelegator.doAbilityForeground(ability, (err : any) => {
abilityDelegator.doAbilityForeground(ability, (err : BusinessError) => {
console.info("doAbilityForeground callback");
});
});
......@@ -731,11 +792,15 @@ doAbilityForeground(ability: UIAbility): Promise\<void>;
**示例：**
```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 ability;
let ability: UIAbility;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => {
abilityDelegator.getCurrentTopAbility((err : BusinessError, data : UIAbility) => {
console.info('getCurrentTopAbility callback');
ability = data;
abilityDelegator.doAbilityForeground(ability).then(() => {
......@@ -770,14 +835,18 @@ doAbilityBackground(ability: UIAbility, callback: AsyncCallback\<void>): void;
**示例：**
```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 ability;
let ability: UIAbility;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => {
abilityDelegator.getCurrentTopAbility((err : BusinessError, data : UIAbility) => {
console.info('getCurrentTopAbility callback');
ability = data;
abilityDelegator.doAbilityBackground(ability, (err : any) => {
abilityDelegator.doAbilityBackground(ability, (err : BusinessError) => {
console.info("doAbilityBackground callback");
});
});
......@@ -814,11 +883,15 @@ doAbilityBackground(ability: UIAbility): Promise\<void>;
**示例：**
```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 ability;
let ability: UIAbility;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => {
abilityDelegator.getCurrentTopAbility((err : BusinessError, data : UIAbility) => {
console.info('getCurrentTopAbility callback');
ability = data;
abilityDelegator.doAbilityBackground(ability).then(() => {
......@@ -844,6 +917,8 @@ printSync(msg: string): void;
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let msg = 'msg';
......@@ -869,11 +944,14 @@ print(msg: string, callback: AsyncCallback\<void>): void;
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let msg = 'msg';
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.print(msg, (err : any) => {
abilityDelegator.print(msg, (err : BusinessError) => {
console.info('print callback');
});
```
......@@ -901,6 +979,8 @@ print(msg: string): Promise\<void>;
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let msg = 'msg';
......@@ -930,11 +1010,14 @@ executeShellCommand(cmd: string, callback: AsyncCallback\<ShellCmdResult>): void
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let cmd = 'cmd';
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.executeShellCommand(cmd, (err : any, data : any) => {
abilityDelegator.executeShellCommand(cmd, (err : BusinessError, data: AbilityDelegatorRegistry.ShellCmdResult) => {
console.info('executeShellCommand callback');
});
```
......@@ -960,12 +1043,15 @@ executeShellCommand(cmd: string, timeoutSecs: number, callback: AsyncCallback\<S
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let cmd = 'cmd';
let timeout = 100;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.executeShellCommand(cmd, timeout, (err : any, data : any) => {
abilityDelegator.executeShellCommand(cmd, timeout, (err : BusinessError, data: AbilityDelegatorRegistry.ShellCmdResult) => {
console.info('executeShellCommand callback');
});
```
......@@ -996,12 +1082,14 @@ executeShellCommand(cmd: string, timeoutSecs?: number): Promise\<ShellCmdResult>
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let cmd = 'cmd';
let timeout = 100;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.executeShellCommand(cmd, timeout).then((data : any) => {
abilityDelegator.executeShellCommand(cmd, timeout).then((data) => {
console.info('executeShellCommand promise');
});
```
......@@ -1033,11 +1121,14 @@ finishTest(msg: string, code: number, callback: AsyncCallback\<void>): void;
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let msg = 'msg';
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.finishTest(msg, 0, (err : any) => {
abilityDelegator.finishTest(msg, 0, (err : BusinessError) => {
console.info('finishTest callback');
});
```
......@@ -1074,6 +1165,8 @@ finishTest(msg: string, code: number): Promise\<void>;
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let msg = 'msg';
......@@ -1109,15 +1202,16 @@ addAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\<vo
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let monitor = {
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityStageMonitor({
moduleName: 'moduleName',
srcEntrance: 'srcEntrance',
};
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityStageMonitor(monitor, (err : any) => {
}, (err : BusinessError) => {
console.info('addAbilityStageMonitor callback');
});
```
......@@ -1153,15 +1247,15 @@ addAbilityStageMonitor(monitor: AbilityStageMonitor): Promise\<void>;
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let monitor = {
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityStageMonitor({
moduleName: 'moduleName',
srcEntrance: 'srcEntrance',
};
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityStageMonitor(monitor).then(() => {
}).then(() => {
console.info('addAbilityStageMonitor promise');
});
```
......@@ -1193,15 +1287,15 @@ addAbilityStageMonitorSync(monitor: AbilityStageMonitor): void;
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let monitor = {
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityStageMonitorSync({
moduleName: 'moduleName',
srcEntrance: 'srcEntrance',
};
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityStageMonitorSync(monitor);
});
```
### removeAbilityStageMonitor<sup>9+</sup>
......@@ -1230,15 +1324,16 @@ removeAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let monitor = {
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.removeAbilityStageMonitor({
moduleName: 'moduleName',
srcEntrance: 'srcEntrance',
};
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.removeAbilityStageMonitor(monitor, (err : any) => {
}, (err : BusinessError) => {
console.info('removeAbilityStageMonitor callback');
});
```
......@@ -1274,15 +1369,15 @@ removeAbilityStageMonitor(monitor: AbilityStageMonitor): Promise\<void>;
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let monitor = {
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.removeAbilityStageMonitor({
moduleName: 'moduleName',
srcEntrance: 'srcEntrance',
};
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.removeAbilityStageMonitor(monitor).then(() => {
}).then(() => {
console.info('removeAbilityStageMonitor promise');
});
```
......@@ -1313,15 +1408,15 @@ removeAbilityStageMonitorSync(monitor: AbilityStageMonitor): void;
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let monitor = {
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.removeAbilityStageMonitorSync({
moduleName: 'moduleName',
srcEntrance: 'srcEntrance',
};
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.removeAbilityStageMonitorSync(monitor);
});
```
### waitAbilityStageMonitor<sup>9+</sup>
......@@ -1350,19 +1445,16 @@ waitAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\<A
**示例：**
```ts
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import AbilityStage from '@ohos.app.ability.AbilityStage';
function onAbilityCreateCallback(data) {
console.info('onAbilityCreateCallback');
}
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let monitor = {
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityStageMonitor({
moduleName: 'moduleName',
srcEntrance: 'srcEntrance',
};
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityStageMonitor(monitor, (err : any, data : any) => {
}, (err : BusinessError, data : AbilityStage) => {
console.info('waitAbilityStageMonitor callback');
});
```
......@@ -1399,19 +1491,16 @@ waitAbilityStageMonitor(monitor: AbilityStageMonitor, timeout?: number): Promise
**示例：**
```ts
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import AbilityStage from '@ohos.app.ability.AbilityStage';
function onAbilityCreateCallback(data) {
console.info('onAbilityCreateCallback');
}
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let monitor = {
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityStageMonitor({
moduleName: 'moduleName',
srcEntrance: 'srcEntrance',
};
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityStageMonitor(monitor).then((data : any) => {
}).then((data : AbilityStage) => {
console.info('waitAbilityStageMonitor promise');
});
```
......@@ -1443,20 +1532,18 @@ waitAbilityStageMonitor(monitor: AbilityStageMonitor, timeout: number, callback:
**示例：**
```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 timeout = 100;
function onAbilityCreateCallback(data) {
console.info('onAbilityCreateCallback');
}
let monitor = {
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityStageMonitor({
moduleName: 'moduleName',
srcEntrance: 'srcEntrance',
};
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityStageMonitor(monitor, timeout, (err : any, data : any) => {
}, timeout, (err : BusinessError, data : AbilityStage) => {
console.info('waitAbilityStageMonitor callback');
});
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityMonitor.md
浏览文件 @ 10998067
......@@ -38,19 +38,21 @@ Ability监听器
```ts
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)}');
}
let monitor = {
let monitor: AbilityDelegatorRegistry.AbilityMonitor = {
abilityName: 'abilityname',
moduleName: "moduleName",
onAbilityCreate: onAbilityCreateCallback
};
}
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityMonitor(monitor, (error : any) => {
abilityDelegator.addAbilityMonitor(monitor, (error : BusinessError) => {
if (error) {
console.error('addAbilityMonitor fail, error: ${JSON.stringify(error)}');
}
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityStageMonitor.md
浏览文件 @ 10998067
......@@ -19,13 +19,11 @@
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
let monitor = {
let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityStageMonitor({
moduleName: 'feature_as1',
srcEntrance: './ets/Application/MyAbilityStage.ts',
};
let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityStageMonitor(monitor, (error, data) => {
}, (error, data) => {
if (error) {
console.error('waitAbilityStageMonitor fail, error: ${JSON.stringify(error)}');
} else {
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-applicationContext.md
浏览文件 @ 10998067
......@@ -18,6 +18,8 @@ import common from '@ohos.app.ability.common';
在使用ApplicationContext的功能前，需要通过context的实例获取。
```ts
import common from '@ohos.app.ability.common';
let applicationContext: common.ApplicationContext = this.context.getApplicationContext();
```
......@@ -50,13 +52,14 @@ on(type: 'abilityLifecycle', callback: AbilityLifecycleCallback): **number**;
```ts
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 {
onCreate() {
console.log('MyAbility onCreate');
let AbilityLifecycleCallback = {
let AbilityLifecycleCallback: AbilityLifecycleCallback = {
onAbilityCreate(ability) {
console.log(`AbilityLifecycleCallback onAbilityCreate ability: ${ability}`);
},
......@@ -93,7 +96,7 @@ export default class EntryAbility extends UIAbility {
let applicationContext = this.context.getApplicationContext();
// 2.通过applicationContext注册监听应用内生命周期
lifecycleId = applicationContext.on('abilityLifecycle', AbilityLifecycleCallback);
console.log(`registerAbilityLifecycleCallback lifecycleId: ${lifecycleId)}`);
console.log(`registerAbilityLifecycleCallback lifecycleId: ${lifecycleId}`);
}
}
```
......@@ -123,13 +126,14 @@ on(type: 'abilityLifecycleEvent', callback: AbilityLifecycleCallback): **number*
```ts
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 {
onCreate() {
console.log('MyAbility onCreate');
let AbilityLifecycleCallback = {
let AbilityLifecycleCallback: AbilityLifecycleCallback = {
onAbilityCreate(ability) {
console.log(`AbilityLifecycleCallback onAbilityCreate ability: ${ability}`);
},
......@@ -166,7 +170,7 @@ export default class EntryAbility extends UIAbility {
let applicationContext = this.context.getApplicationContext();
// 2.通过applicationContext注册监听应用内生命周期
lifecycleId = applicationContext.on('abilityLifecycleEvent', AbilityLifecycleCallback);
console.log(`registerAbilityLifecycleCallback lifecycleId: ${lifecycleId)}`);
console.log('registerAbilityLifecycleCallback lifecycleId: ${lifecycleId}');
}
}
```
......@@ -196,7 +200,7 @@ off(type: 'abilityLifecycle', callbackId: **number**, callback: AsyncCallback<*
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
let lifecycleId;
let lifecycleId: number;
export default class EntryAbility extends UIAbility {
onDestroy() {
......@@ -237,7 +241,7 @@ off(type: 'abilityLifecycle', callbackId: number): Promise\<void>;
```ts
import Ability from '@ohos.app.ability.UIAbility';
let lifecycleId;
let lifecycleId: number;
export default class MyAbility extends Ability {
onDestroy() {
......@@ -268,7 +272,7 @@ off(type: 'abilityLifecycleEvent', callbackId: number): <void>;
```ts
import Ability from '@ohos.app.ability.UIAbility';
let lifecycleId;
let lifecycleId: number;
export default class MyAbility extends Ability {
onDestroy() {
......@@ -308,14 +312,14 @@ on(type: 'environment', callback: EnvironmentCallback): **number**;
```ts
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 {
onCreate() {
console.log('MyAbility onCreate')
globalThis.applicationContext = this.context.getApplicationContext();
let environmentCallback = {
let environmentCallback: EnvironmentCallback = {
onConfigurationUpdated(config){
console.log(`onConfigurationUpdated config: ${JSON.stringify(config)}`);
},
......@@ -324,7 +328,7 @@ export default class EntryAbility extends UIAbility {
}
};
// 1.获取applicationContext
let applicationContext = globalThis.applicationContext;
let applicationContext = this.context.getApplicationContext();
// 2.通过applicationContext注册监听系统环境变化
callbackId = applicationContext.on('environment', environmentCallback);
console.log(`registerEnvironmentCallback callbackId: ${callbackId}`);
......@@ -357,14 +361,14 @@ on(type: 'environmentEvent', callback: EnvironmentCallback): **number**;
```ts
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 {
onCreate() {
console.log('MyAbility onCreate')
globalThis.applicationContext = this.context.getApplicationContext();
let environmentCallback = {
let environmentCallback: EnvironmentCallback = {
onConfigurationUpdated(config){
console.log('onConfigurationUpdated config: ${JSON.stringify(config)}');
},
......@@ -373,7 +377,7 @@ export default class EntryAbility extends UIAbility {
}
};
// 1.获取applicationContext
let applicationContext = globalThis.applicationContext;
let applicationContext = this.context.getApplicationContext();
// 2.通过applicationContext注册监听系统环境变化
callbackId = applicationContext.on('environmentEvent', environmentCallback);
console.log(`registerEnvironmentCallback callbackId: ${callbackId}`);
......@@ -406,7 +410,7 @@ off(type: 'environment', callbackId: **number**, callback: AsyncCallback<**void
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
let callbackId;
let callbackId: number;
export default class EntryAbility extends UIAbility {
onDestroy() {
......@@ -446,7 +450,7 @@ off(type: 'environment', callbackId: **number**, callback: AsyncCallback<**void
```ts
import Ability from '@ohos.app.ability.UIAbility';
let callbackId;
let callbackId: number;
export default class MyAbility extends Ability {
onDestroy() {
......@@ -476,7 +480,7 @@ off(type: 'environmentEvent', callbackId: **number**, callback: AsyncCallback<*
```ts
import Ability from '@ohos.app.ability.UIAbility';
let callbackId;
let callbackId: number;
export default class MyAbility extends Ability {
onDestroy() {
......@@ -505,11 +509,12 @@ on(type: 'applicationStateChange', callback: ApplicationStateChangeCallback): **
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import ApplicationStateChangeCallback from '@ohos.app.ability.ApplicationStateChangeCallback';
export default class MyAbility extends UIAbility {
onCreate() {
console.log('MyAbility onCreate');
globalThis.applicationStateChangeCallback = {
let applicationStateChangeCallback: ApplicationStateChangeCallback = {
onApplicationForeground() {
console.info('applicationStateChangeCallback onApplicationForeground');
},
......@@ -518,11 +523,10 @@ export default class MyAbility extends UIAbility {
}
}
globalThis.applicationContext = this.context.getApplicationContext();
// 1.获取applicationContext
let applicationContext = globalThis.applicationContext;
let applicationContext = this.context.getApplicationContext();
// 2.通过applicationContext注册应用前后台状态监听
applicationContext.on('applicationStateChange', globalThis.ApplicationStateChangeCallback);
applicationContext.on('applicationStateChange', applicationStateChangeCallback);
console.log('Resgiter applicationStateChangeCallback');
}
}
......@@ -582,11 +586,19 @@ getRunningProcessInformation(): Promise\<Array\<ProcessInformation>>;
**示例：**
```ts
applicationContext.getRunningProcessInformation().then((data) => {
console.log('The process running information is: ${JSON.stringify(data)}');
}).catch((error) => {
console.error('error: ${JSON.stringify(error)}');
});
import UIAbility from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
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>
......@@ -615,13 +627,20 @@ getRunningProcessInformation(callback: AsyncCallback\<Array\<ProcessInformation>
**示例：**
```ts
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)}');
import UIAbility from '@ohos.app.ability.UIAbility';
export default class MyAbility extends UIAbility {
onForeground() {
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>
......@@ -649,7 +668,14 @@ killAllProcesses(): Promise\<void\>;
**示例：**
```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>
......@@ -677,10 +703,17 @@ killAllProcesses(callback: AsyncCallback\<void\>);
**示例：**
```ts
applicationContext.killAllProcesses(error => {
if (error) {
console.error('killAllProcesses fail, error: ${JSON.stringify(error)}');
import UIAbility from '@ohos.app.ability.UIAbility';
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_check-->
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-inner-application-applicationStateObserver.md
浏览文件 @ 10998067
......@@ -28,7 +28,9 @@ import appManager from '@ohos.app.ability.appManager';
**示例：**
```ts
let applicationStateObserver = {
import appManager from '@ohos.app.ability.appManager';
let applicationStateObserver: appManager.ApplicationStateObserver = {
onForegroundApplicationChanged(appStateData) {
console.log('onForegroundApplicationChanged appStateData: ${JSON.stringify(appStateData)}');
},
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-baseContext.md
浏览文件 @ 10998067
......@@ -26,9 +26,11 @@ import common from '@ohos.app.ability.common';
```ts
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 {
onCreate(want, launchParam) {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
// EntryAbility onCreate, isStageMode: true
console.log('EntryAbility onCreate, isStageMode: ${this.context.stageMode}');
}
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-context.md
浏览文件 @ 10998067
......@@ -58,6 +58,8 @@ createBundleContext(bundleName: string): Context;
**示例：**
```ts
import common from '@ohos.app.ability.common';
let bundleContext: common.Context;
try {
bundleContext = this.context.createBundleContext('com.example.test');
......@@ -89,6 +91,8 @@ createModuleContext(moduleName: string): Context;
**示例：**
```ts
import common from '@ohos.app.ability.common';
let moduleContext: common.Context;
try {
moduleContext = this.context.createModuleContext('entry');
......@@ -125,6 +129,8 @@ createModuleContext(bundleName: string, moduleName: string): Context;
**示例：**
```ts
import common from '@ohos.app.ability.common';
let moduleContext: common.Context;
try {
moduleContext = this.context.createModuleContext('com.example.test', 'entry');
......@@ -150,6 +156,8 @@ getApplicationContext(): ApplicationContext;
**示例：**
```ts
import common from '@ohos.app.ability.common';
let applicationContext: common.Context;
try {
applicationContext = this.context.getApplicationContext();
......@@ -189,8 +197,10 @@ getGroupDir(dataGroupID: string): Promise\<string>;
**示例：**
```ts
import common from '@ohos.app.ability.common';
let groupId = "1";
let getGroupDirContext: common.Context;
let getGroupDirContext: common.Context = this.context;
try {
getGroupDirContext.getGroupDir(groupId).then(data => {
console.log("getGroupDir result:" + data);
......@@ -226,7 +236,9 @@ getGroupDir(dataGroupID: string, callback: AsyncCallback\<string>): void;
**示例：**
```ts
let getGroupDirContext: common.Context;
import common from '@ohos.app.ability.common';
let getGroupDirContext: common.Context = this.context;
getGroupDirContext.getGroupDir("1", (err, data) => {
if (err) {
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-errorObserver.md
浏览文件 @ 10998067
......@@ -31,7 +31,7 @@ onUnhandledException(errMsg: string): void;
```ts
import errorManager from '@ohos.app.ability.errorManager';
let observer = {
let observer: errorManager.ErrorObserver = {
onUnhandledException(errorMsg) {
console.error('onUnhandledException, errorMsg: ', errorMsg);
}
......@@ -63,7 +63,7 @@ onException?(errObject: Error): void;
```ts
import errorManager from '@ohos.app.ability.errorManager';
let observer = {
let observer: errorManager.ErrorObserver = {
onUnhandledException(errorMsg) {
console.error('onUnhandledException, errorMsg: ', errorMsg);
},
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-eventHub.md
浏览文件 @ 10998067
......@@ -145,7 +145,7 @@ export default class EntryAbility extends UIAbility {
this.context.eventHub.emit('myEvent', 1, 2);
}
eventFunc(argOne, argTwo) {
eventFunc(argOne: number, argTwo: number) {
console.log(`eventFunc is called, ${argOne}, ${argTwo}`);
}
}
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-extensionContext.md
浏览文件 @ 10998067
......@@ -39,24 +39,46 @@ ExtensionContext主要用于查询所属Extension的信息、Module的配置信
```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
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 {
onCreate(want:Want) {
onCreate(want: Want) {
console.log('ServiceAbility onCreate, want: ${want.abilityName}');
// 通过globalThis传递ExtensionContext给entry
globalThis.ExtensionContext = this.context;
GlobalContext.getContext().setObject("ExtensionContext", this.context);
}
onRequest(want, startId) {
onRequest(want: Want, startId: number) {
console.log('ServiceAbility onRequest, want: ${want.abilityName}, startId: ${startId}');
}
onConnect(want) {
onConnect(want: Want) {
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}');
}
......@@ -69,11 +91,13 @@ export default class TheServiceExtension extends ServiceExtension {
在entry的MainAbility的onCreate回调内启动ServiceExtension
```ts
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 {
onCreate(want, launchParam) {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
console.log('[Demo] EntryAbility onCreate');
let wantExt = {
let wantExt: Want = {
deviceId: '',
bundleName: 'com.example.TheServiceExtension',
abilityName: 'TheServiceExtension',
......@@ -85,19 +109,20 @@ export default class EntryAbility extends UIAbility {
在entry内新建一个ServiceModule.ts，专用于执行业务逻辑
```ts
import { GlobalContext } from '../TheServiceExtension'
export default class ServiceModel {
moduleName: string;
moduleName: string = '';
constructor() {}
executeTask() {
if (globalThis.ExtensionContext === undefined) {
if (GlobalContext.getContext().getObject('ExtensionContext') === undefined) {
console.log('ERROR, ServiceExtension does not exist');
return;
}
let moduleInfo = globalThis.ExtensionContext.currentHapModuleInfo;
this.moduleName = moduleInfo.name;
this.moduleName = GlobalContext.getContext().getObject('ExtensionContext').currentHapModuleInfo.name;
// 根据moduleName执行不同的业务逻辑，实现对不同性能设备的区分
switch (this.moduleName) {
case 'highPerformance':
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-missionCallbacks.md
浏览文件 @ 10998067
......@@ -18,21 +18,21 @@
```ts
import distributedMissionManager from '@ohos.distributedMissionManager';
let missionDeviceInfo = {
deviceId: '123456'
};
let missionCallback = {
notifyMissionsChanged: function (deviceId) {
console.log('notifyMissionsChanged deviceId: ${JSON.stringify(deviceId)}');
distributedMissionManager.registerMissionListener(
{
deviceId: '123456'
},
notifySnapshot: function (deviceId, mission) {
console.log('notifySnapshot deviceId: ${JSON.stringify(deviceId)}');
console.log('notifySnapshot mission: ${JSON.stringify(mission)}');
},
notifyNetDisconnect: function (deviceId, state) {
console.log('notifyNetDisconnect deviceId: ${JSON.stringify(deviceId)}');
console.log('notifyNetDisconnect state: ${JSON.stringify(state)}');
}
};
distributedMissionManager.registerMissionListener(missionDeviceInfo, missionCallback);
{
notifyMissionsChanged: (deviceId) => {
console.log('notifyMissionsChanged deviceId: ${JSON.stringify(deviceId)}');
},
notifySnapshot: (deviceId, mission) => {
console.log('notifySnapshot deviceId: ${JSON.stringify(deviceId)}');
console.log('notifySnapshot mission: ${JSON.stringify(mission)}');
},
notifyNetDisconnect: (deviceId, state) => {
console.log('notifyNetDisconnect deviceId: ${JSON.stringify(deviceId)}');
console.log('notifyNetDisconnect state: ${JSON.stringify(state)}');
}
});
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-inner-application-missionDeviceInfo.md
浏览文件 @ 10998067
......@@ -12,21 +12,21 @@
```ts
import distributedMissionManager from '@ohos.distributedMissionManager';
let missionDeviceInfo = {
deviceId: '123456'
};
let missionCallback = {
notifyMissionsChanged: function (deviceId) {
console.log('notifyMissionsChanged deviceId: ${JSON.stringify(deviceId)}');
distributedMissionManager.registerMissionListener(
{
deviceId: '123456'
},
notifySnapshot: function (mission, deviceId) {
console.log('notifySnapshot mission: ${JSON.stringify(mission)}');
console.log('notifySnapshot deviceId: ${JSON.stringify(deviceId)}');
},
notifyNetDisconnect: function (mission, state) {
console.log('notifyNetDisconnect mission: ${JSON.stringify(mission)}');
console.log('notifyNetDisconnect state: ${JSON.stringify(state)}');
}
};
distributedMissionManager.registerMissionListener(missionDeviceInfo, missionCallback);
{
notifyMissionsChanged: (deviceId) => {
console.log('notifyMissionsChanged deviceId: ${JSON.stringify(deviceId)}');
},
notifySnapshot: (mission, deviceId) => {
console.log('notifySnapshot mission: ${JSON.stringify(mission)}');
console.log('notifySnapshot deviceId: ${JSON.stringify(deviceId)}');
},
notifyNetDisconnect: (mission, state) => {
console.log('notifyNetDisconnect mission: ${JSON.stringify(mission)}');
console.log('notifyNetDisconnect state: ${JSON.stringify(state)}');
}
});
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-inner-application-missionListener.md
浏览文件 @ 10998067
......@@ -32,27 +32,27 @@ import missionManager from '@ohos.app.ability.missionManager';
```ts
import missionManager from '@ohos.app.ability.missionManager';
let listener = {
onMissionCreated: function (mission) {
let listener: missionManager.MissionListener = {
onMissionCreated: (mission) => {
console.log('onMissionCreated mission: ${JSON.stringify(mission)}');
},
onMissionDestroyed: function (mission) {
onMissionDestroyed: (mission) => {
console.log('onMissionDestroyed mission: ${JSON.stringify(mission)}');
},
onMissionSnapshotChanged: function (mission) {
onMissionSnapshotChanged: (mission) => {
console.log('onMissionSnapshotChanged mission: ${JSON.stringify(mission)}');
},
onMissionMovedToFront: function (mission) {
onMissionMovedToFront: (mission) => {
console.log('onMissionMovedToFront mission: ${JSON.stringify(mission)}');
},
onMissionLabelUpdated: function (mission) {
onMissionLabelUpdated: (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 icon: ' + JSON.stringify(icon));
},
onMissionClosed: function (mission) {
onMissionClosed: (mission) => {
console.log('onMissionClosed mission: ${JSON.stringify(mission)}');
}
};
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-missionParameter.md
浏览文件 @ 10998067
......@@ -18,13 +18,13 @@
```ts
import distributedMissionManager from '@ohos.distributedMissionManager';
let missionParameter = {
deviceId: '123456',
fixConflict: true,
tag: 123
};
try {
distributedMissionManager.startSyncRemoteMissions(missionParameter,
distributedMissionManager.startSyncRemoteMissions(
{
deviceId: '123456',
fixConflict: true,
tag: 123
},
(error, data) => {
if (error && error.code !== 0) {
console.error('startSyncRemoteMissions fail, error: ${JSON.stringify(error)}');
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-processData.md
浏览文件 @ 10998067
......@@ -31,7 +31,7 @@ import appManager from '@ohos.application.appManager';
```ts
import appManager from '@ohos.application.appManager';
let applicationStateObserver = {
let observerCode = appManager.registerApplicationStateObserver({
onForegroundApplicationChanged(appStateData) {
console.log('onForegroundApplicationChanged appStateData: ${JSON.stringify(appStateData)}');
},
......@@ -51,6 +51,5 @@ let applicationStateObserver = {
console.log('onProcessStateChanged processData.isContinuousTask : ${JSON.stringify(processData.isContinuousTask)}');
console.log('onProcessStateChanged processData.isKeepAlive : ${JSON.stringify(processData.isKeepAlive)}');
}
};
let observerCode = appManager.registerApplicationStateObserver(applicationStateObserver);
});
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInfo.md
浏览文件 @ 10998067
......@@ -9,7 +9,7 @@
## 导入模块
```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';
**示例：**
```ts
import appManager from '@ohos.app.ability.appManager';
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
appManager.getProcessRunningInfos().then((data) => {
console.log('success: ${JSON.stringify(data)}');
}).catch((error) => {
}).catch((error: BusinessError) => {
console.error('failed: ${JSON.stringify(error)}');
});
```
zh-cn/application-dev/reference/apis/js-apis-inner-application-serviceExtensionContext.md
浏览文件 @ 10998067
......@@ -21,12 +21,12 @@ import common from '@ohos.app.ability.common';
```ts
import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility';
import rpc from '@ohos.rpc';
let context;
let commRemote; // 断开连接时需要释放
let commRemote: rpc.IRemoteObject; // 断开连接时需要释放
class EntryAbility extends ServiceExtensionAbility {
onCreate() {
context = this.context; // 获取ServiceExtensionContext
let context = this.context; // 获取ServiceExtensionContext
}
}
```
......@@ -73,13 +73,16 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: 'com.example.myapp',
abilityName: 'MyAbility'
};
try {
this.context.startAbility(want, (error) => {
this.context.startAbility(want, (error: BusinessError) => {
if (error.code) {
// 处理业务逻辑错误
console.error('startAbility failed, error.code: ${error.code}, error.message: ${error.message}');
......@@ -142,21 +145,25 @@ startAbility(want: Want, options?: StartOptions): Promise\<void>;
**示例：**
```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',
abilityName: 'MyAbility'
};
let options = {
let options: StartOptions = {
windowMode: 0,
};
try {
this.context.startAbility(want, options)
.then((data) => {
.then((data: void) => {
// 执行正常业务
console.log('startAbility succeed');
})
.catch((error) => {
.catch((error: BusinessError) => {
// 处理业务逻辑错误
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&
**示例：**
```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: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
};
let options = {
let options: StartOptions = {
windowMode: 0
};
try {
this.context.startAbility(want, options, (error) => {
this.context.startAbility(want, options, (error: BusinessError) => {
if (error.code) {
// 处理业务逻辑错误
console.error('startAbility failed, error.code: ${error.code}, error.message: ${error.message}');
......@@ -284,7 +295,10 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\<
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
......@@ -292,7 +306,7 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\<
let accountId = 100;
try {
this.context.startAbilityWithAccount(want, accountId, (error) => {
this.context.startAbilityWithAccount(want, accountId, (error: BusinessError) => {
if (error.code) {
// 处理业务逻辑错误
console.error('startAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}');
......@@ -358,18 +372,22 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca
**示例：**
```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: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
};
let accountId = 100;
let options = {
let options: StartOptions = {
windowMode: 0
};
try {
this.context.startAbilityWithAccount(want, accountId, options, (error) => {
this.context.startAbilityWithAccount(want, accountId, options, (error: BusinessError) => {
if (error.code) {
// 处理业务逻辑错误
console.error('startAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}');
......@@ -441,23 +459,27 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions):
**示例：**
```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: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
};
let accountId = 100;
let options = {
let options: StartOptions = {
windowMode: 0
};
try {
this.context.startAbilityWithAccount(want, accountId, options)
.then((data) => {
.then((data: void) => {
// 执行正常业务
console.log('startAbilityWithAccount succeed');
})
.catch((error) => {
.catch((error: BusinessError) => {
// 处理业务逻辑错误
console.error('startAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}');
});
......@@ -505,14 +527,17 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
};
try {
this.context.startServiceExtensionAbility(want, (error) => {
this.context.startServiceExtensionAbility(want, (error: BusinessError) => {
if (error.code) {
// 处理业务逻辑错误
console.error('startServiceExtensionAbility failed, error.code: ${error.code}, error.message: ${error.message}');
......@@ -570,7 +595,10 @@ startServiceExtensionAbility(want: Want): Promise\<void>;
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
......@@ -578,11 +606,11 @@ startServiceExtensionAbility(want: Want): Promise\<void>;
try {
this.context.startServiceExtensionAbility(want)
.then((data) => {
.then((data: void) => {
// 执行正常业务
console.log('startServiceExtensionAbility succeed');
})
.catch((error) => {
.catch((error: BusinessError) => {
// 处理业务逻辑错误
console.error('startServiceExtensionAbility failed, error.code: ${error.code}, error.message: ${error.message}');
});
......@@ -638,7 +666,10 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
......@@ -646,7 +677,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
let accountId = 100;
try {
this.context.startServiceExtensionAbilityWithAccount(want, accountId, (error) => {
this.context.startServiceExtensionAbilityWithAccount(want, accountId, (error: BusinessError) => {
if (error.code) {
// 处理业务逻辑错误
console.error('startServiceExtensionAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}');
......@@ -711,7 +742,10 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
......@@ -720,11 +754,11 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\
try {
this.context.startServiceExtensionAbilityWithAccount(want, accountId)
.then((data) => {
.then((data: void) => {
// 执行正常业务
console.log('startServiceExtensionAbilityWithAccount succeed');
})
.catch((error) => {
.catch((error: BusinessError) => {
// 处理业务逻辑错误
console.error('startServiceExtensionAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}');
});
......@@ -785,7 +819,7 @@ import extension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
export default class EntryAbility extends extension {
onCreate(want, launchParam) {
onCreate(want: Want) {
// want包含启动该应用的Caller信息
let localWant: Want = want;
localWant.bundleName = 'com.example.demo';
......@@ -853,9 +887,10 @@ startAbilityAsCaller(want: Want, options: StartOptions, callback: AsyncCallback\
```ts
import extension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
export default class EntryAbility extends extension {
onCreate(want, launchParam) {
onCreate(want: Want) {
// want包含启动该应用的Caller信息
let localWant: Want = want;
localWant.bundleName = 'com.example.demo';
......@@ -934,9 +969,11 @@ startAbilityAsCaller(want: Want, options?: StartOptions): Promise\<void>;
```ts
import extension from '@ohos.app.ability.ServiceExtensionAbility';
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 {
onCreate(want, launchParam) {
onCreate(want: Want) {
// want包含启动该应用的Caller信息
let localWant: Want = want;
localWant.bundleName = 'com.example.demo';
......@@ -952,7 +989,7 @@ export default class EntryAbility extends extension {
.then(() => {
console.log('startAbilityAsCaller success.');
})
.catch((err) => {
.catch((err: BusinessError) => {
console.error('startAbilityAsCaller failed, err:' + JSON.stringify(err));
})
}
......@@ -995,14 +1032,17 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
};
try {
this.context.stopServiceExtensionAbility(want, (error) => {
this.context.stopServiceExtensionAbility(want, (error: BusinessError) => {
if (error.code) {
// 处理业务逻辑错误
console.error('stopServiceExtensionAbility failed, error.code: ${error.code}, error.message: ${error.message}');
......@@ -1057,7 +1097,10 @@ stopServiceExtensionAbility(want: Want): Promise\<void>;
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
......@@ -1065,11 +1108,11 @@ stopServiceExtensionAbility(want: Want): Promise\<void>;
try {
this.context.stopServiceExtensionAbility(want)
.then((data) => {
.then(() => {
// 执行正常业务
console.log('stopServiceExtensionAbility succeed');
})
.catch((error) => {
.catch((error: BusinessError) => {
// 处理业务逻辑错误
console.error('stopServiceExtensionAbility failed, error.code: ${error.code}, error.message: ${error.message}');
});
......@@ -1121,7 +1164,10 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
......@@ -1129,7 +1175,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
let accountId = 100;
try {
this.context.stopServiceExtensionAbilityWithAccount(want, accountId, (error) => {
this.context.stopServiceExtensionAbilityWithAccount(want, accountId, (error: BusinessError) => {
if (error.code) {
// 处理业务逻辑错误
console.error('stopServiceExtensionAbilityWithAccount failed, error.code: ${error.code, error.message: ${error.message}');
......@@ -1191,7 +1237,10 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\<
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
......@@ -1200,11 +1249,11 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\<
try {
this.context.stopServiceExtensionAbilityWithAccount(want, accountId)
.then((data) => {
.then(() => {
// 执行正常业务
console.log('stopServiceExtensionAbilityWithAccount succeed');
})
.catch((error) => {
.catch((error: BusinessError) => {
// 处理业务逻辑错误
console.error('stopServiceExtensionAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}');
});
......@@ -1246,7 +1295,9 @@ terminateSelf(callback: AsyncCallback&lt;void&gt;): void;
**示例：**
```ts
this.context.terminateSelf((error) => {
import { BusinessError } from '@ohos.base';
this.context.terminateSelf((error: BusinessError) => {
if (error.code) {
// 处理业务逻辑错误
console.error('terminateSelf failed, error.code: ${error.code}, error.message: ${error.message}');
......@@ -1289,10 +1340,12 @@ terminateSelf(): Promise&lt;void&gt;;
**示例：**
```ts
this.context.terminateSelf().then((data) => {
import { BusinessError } from '@ohos.base';
this.context.terminateSelf().then(() => {
// 执行正常业务
console.log('terminateSelf succeed');
}).catch((error) => {
}).catch((error: BusinessError) => {
// 处理业务逻辑错误
console.error('terminateSelf failed, error.code: ${error.code}, error.message: ${error.message}');
});
......@@ -1341,20 +1394,24 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number;
**示例：**
```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',
abilityName: 'MyAbility'
};
let options = {
onConnect(elementName, remote) {
let options: common.ConnectOptions = {
onConnect(elementName, remote) {
commRemote = remote;
console.log('----------- onConnect -----------');
console.log('----------- onConnect -----------');
},
onDisconnect(elementName) { console.log('----------- onDisconnect -----------') },
onFailed(code) { console.error('----------- onFailed -----------') }
};
let connection = null;
let connection: number;
try {
connection = this.context.connectServiceExtensionAbility(want, options);
} catch (paramError) {
......@@ -1409,13 +1466,18 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options
**示例：**
```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: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
};
let accountId = 100;
let options = {
let options: common.ConnectOptions = {
onConnect(elementName, remote) {
commRemote = remote;
console.log('----------- onConnect -----------');
......@@ -1423,8 +1485,7 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options
onDisconnect(elementName) { console.log('----------- onDisconnect -----------'); },
onFailed(code) { console.log('----------- onFailed -----------'); }
};
let connection = null;
let connection: number;
try {
connection = this.context.connectServiceExtensionAbilityWithAccount(want, accountId, options);
} catch (paramError) {
......@@ -1462,11 +1523,13 @@ disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback&lt;
**示例：**
```ts
import { BusinessError } from '@ohos.base';
// connection为connectServiceExtensionAbility中的返回值
let connection = 1;
try {
this.context.disconnectServiceExtensionAbility(connection, (error) => {
this.context.disconnectServiceExtensionAbility(connection, (error: BusinessError) => {
commRemote = null;
if (error.code) {
// 处理业务逻辑错误
......@@ -1517,17 +1580,19 @@ disconnectServiceExtensionAbility(connection: number): Promise&lt;void&gt;;
**示例：**
```ts
import { BusinessError } from '@ohos.base';
// connection为connectServiceExtensionAbility中的返回值
let connection = 1;
try {
this.context.disconnectServiceExtensionAbility(connection)
.then((data) => {
.then(() => {
commRemote = null;
// 执行正常业务
console.log('disconnectServiceExtensionAbility succeed');
})
.catch((error) => {
.catch((error: BusinessError) => {
commRemote = null;
// 处理业务逻辑错误
console.error('disconnectServiceExtensionAbility failed, error.code: ${error.code}, error.message: ${error.message}');
......@@ -1589,10 +1654,14 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;;
后台启动：
```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
let wantBackground = {
let wantBackground: Want = {
bundleName: 'com.example.myservice',
moduleName: 'entry',
abilityName: 'EntryAbility',
......@@ -1601,11 +1670,11 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;;
try {
this.context.startAbilityByCall(wantBackground)
.then((obj) => {
.then((obj: Caller) => {
// 执行正常业务
caller = obj;
console.log('startAbilityByCall succeed');
}).catch((error) => {
}).catch((error: BusinessError) => {
// 处理业务逻辑错误
console.error('startAbilityByCall failed, error.code: ${error.code}, error.message: ${error.message}');
});
......@@ -1618,10 +1687,14 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;;
前台启动：
```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
let wantForeground = {
let wantForeground: Want = {
bundleName: 'com.example.myservice',
moduleName: 'entry',
abilityName: 'EntryAbility',
......@@ -1633,11 +1706,11 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;;
try {
this.context.startAbilityByCall(wantForeground)
.then((obj) => {
.then((obj: Caller) => {
// 执行正常业务
caller = obj;
console.log('startAbilityByCall succeed');
}).catch((error) => {
}).catch((error: BusinessError) => {
// 处理业务逻辑错误
console.error('startAbilityByCall failed, error.code: ${error.code}, error.message: ${error.message}');
});
......@@ -1691,13 +1764,16 @@ startRecentAbility(want: Want, callback: AsyncCallback\<void>): void;
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
};
try {
this.context.startRecentAbility(want, (err) => {
this.context.startRecentAbility(want, (err: BusinessError) => {
if (err.code) {
// 处理业务逻辑错误
console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`);
......@@ -1708,7 +1784,9 @@ try {
});
} 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
......@@ -1758,17 +1836,21 @@ startRecentAbility(want: Want, options: StartOptions, callback: AsyncCallback\<v
**示例：**
```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: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
};
let options = {
let options: StartOptions = {
windowMode: 0
};
try {
this.context.startRecentAbility(want, options, (err) => {
this.context.startRecentAbility(want, options, (err: BusinessError) => {
if (err.code) {
// 处理业务逻辑错误
console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`);
......@@ -1779,7 +1861,9 @@ try {
});
} 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
......@@ -1828,11 +1912,15 @@ startRecentAbility(want: Want, options?: StartOptions): Promise\<void>;
**示例：**
```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',
abilityName: 'EntryAbility'
};
let options = {
let options: StartOptions = {
windowMode: 0,
};
......@@ -1842,13 +1930,15 @@ try {
// 执行正常业务
console.info('startRecentAbility succeed');
})
.catch((err) => {
.catch((err: BusinessError) => {
// 处理业务逻辑错误
console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`);
});
} 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&
**示例：**
```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表示当前激活用户
let accountId = -1;
// 指定启动的Ability
let want = {
let want: Want = {
bundleName: 'com.acts.actscalleeabilityrely',
moduleName: 'entry',
abilityName: 'EntryAbility',
......@@ -1923,11 +2016,11 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise&lt;Caller&
try {
this.context.startAbilityByCallWithAccount(want, accountId)
.then((obj) => {
.then((obj: Caller) => {
// 执行正常业务
caller = obj;
console.log('startAbilityByCallWithAccount succeed');
}).catch((error) => {
}).catch((error: BusinessError) => {
// 处理业务逻辑错误
console.error('startAbilityByCallWithAccount failed, error.code: ${error.code}, error.message: ${error.message}');
});
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-shellCmdResult.md
浏览文件 @ 10998067
......@@ -28,11 +28,13 @@ import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry
**示例：**
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import { BusinessError } from '@ohos.base';
let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator;
let cmd = 'cmd';
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.executeShellCommand(cmd, (error: any, data: any) => {
abilityDelegator.executeShellCommand(cmd, (error: BusinessError, data) => {
if (error) {
console.error('executeShellCommand fail, error: ${JSON.stringify(error)}');
} else {
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-uiAbilityContext.md
浏览文件 @ 10998067
......@@ -73,13 +73,16 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
};
try {
this.context.startAbility(want, (err) => {
this.context.startAbility(want, (err: BusinessError) => {
if (err.code) {
// 处理业务逻辑错误
console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
......@@ -90,7 +93,9 @@ try {
});
} 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&
**示例：**
```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: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
};
let options = {
let options: StartOptions = {
windowMode: 0
};
try {
this.context.startAbility(want, options, (err) => {
this.context.startAbility(want, options, (err: BusinessError) => {
if (err.code) {
// 处理业务逻辑错误
console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
......@@ -161,7 +170,9 @@ try {
});
} 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;;
**示例：**
```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',
abilityName: 'EntryAbility'
};
let options = {
let options: StartOptions = {
windowMode: 0,
};
......@@ -230,13 +245,15 @@ try {
// 执行正常业务
console.info('startAbility succeed');
})
.catch((err) => {
.catch((err: BusinessError) => {
// 处理业务逻辑错误
console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
});
} 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;):
**示例：**
```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: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
};
try {
this.context.startAbilityForResult(want, (err, result) => {
this.context.startAbilityForResult(want, (err: BusinessError, result: common.AbilityResult) => {
if (err.code) {
// 处理业务逻辑错误
console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`);
return;
}
// 执行正常业务
console.info('startAbilityForResult succeed');
});
} 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
**示例：**
```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: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
};
let options = {
let options: StartOptions = {
windowMode: 0,
};
try {
this.context.startAbilityForResult(want, options, (err, result) => {
this.context.startAbilityForResult(want, options, (err: BusinessError, result: common.AbilityResult) => {
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;
}
// 执行正常业务
......@@ -380,7 +411,9 @@ try {
});
} 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
**示例：**
```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',
abilityName: 'EntryAbility'
};
let options = {
let options: StartOptions = {
windowMode: 0,
};
try {
this.context.startAbilityForResult(want, options)
.then((result) => {
.then((result: common.AbilityResult) => {
// 执行正常业务
console.info('startAbilityForResult succeed');
})
.catch((err) => {
.catch((err: BusinessError) => {
// 处理业务逻辑错误
console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`);
});
} 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
**示例：**
```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: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
......@@ -526,7 +574,7 @@ let want = {
let accountId = 100;
try {
this.context.startAbilityForResultWithAccount(want, accountId, (err, result) => {
this.context.startAbilityForResultWithAccount(want, accountId, (err: BusinessError, result: common.AbilityResult) => {
if (err.code) {
// 处理业务逻辑错误
console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`);
......@@ -537,7 +585,9 @@ try {
});
} 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
**示例：**
```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: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
};
let accountId = 100;
let options = {
let options: StartOptions = {
windowMode: 0
};
try {
this.context.startAbilityForResultWithAccount(want, accountId, options, (err) => {
this.context.startAbilityForResultWithAccount(want, accountId, options, (err: BusinessError) => {
if (err.code) {
// 处理业务逻辑错误
console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`);
......@@ -619,7 +673,9 @@ try {
});
} 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
**示例：**
```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: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
};
let accountId = 100;
let options = {
let options: StartOptions = {
windowMode: 0
};
try {
this.context.startAbilityForResultWithAccount(want, accountId, options)
.then((result) => {
.then((result: common.AbilityResult) => {
// 执行正常业务
console.info('startAbilityForResultWithAccount succeed');
})
.catch((err) => {
.catch((err: BusinessError) => {
// 处理业务逻辑错误
console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`);
});
} 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
......@@ -747,7 +812,10 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '',
bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility'
......@@ -759,13 +827,15 @@ try {
// 执行正常业务
console.info('startServiceExtensionAbility succeed');
})
.catch((err) => {
.catch((err: BusinessError) => {
// 处理业务逻辑错误
console.error(`startServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
});
} 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>;
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '',
bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility'
......@@ -818,13 +891,15 @@ try {
// 执行正常业务
console.info('startServiceExtensionAbility succeed');
})
.catch((err) => {
.catch((err: BusinessError) => {
// 处理业务逻辑错误
console.error(`startServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
});
} 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:
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '',
bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility'
......@@ -881,7 +959,7 @@ let want = {
let accountId = 100;
try {
this.context.startServiceExtensionAbilityWithAccount(want, accountId, (err) => {
this.context.startServiceExtensionAbilityWithAccount(want, accountId, (err: BusinessError) => {
if (err.code) {
// 处理业务逻辑错误
console.error(`startServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
......@@ -892,7 +970,9 @@ try {
});
} 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\
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '',
bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility'
......@@ -953,13 +1036,15 @@ try {
// 执行正常业务
console.info('startServiceExtensionAbilityWithAccount succeed');
})
.catch((err) => {
.catch((err: BusinessError) => {
// 处理业务逻辑错误
console.error(`startServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
});
} 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
......@@ -999,14 +1084,17 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '',
bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility'
};
try {
this.context.stopServiceExtensionAbility(want, (err) => {
this.context.stopServiceExtensionAbility(want, (err: BusinessError) => {
if (err.code) {
// 处理业务逻辑错误
console.error(`stopServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
......@@ -1017,7 +1105,9 @@ try {
});
} 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>;
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '',
bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility'
......@@ -1067,13 +1160,15 @@ try {
// 执行正常业务
console.info('stopServiceExtensionAbility succeed');
})
.catch((err) => {
.catch((err: BusinessError) => {
// 处理业务逻辑错误
console.error(`stopServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
});
} 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:
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '',
bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility'
......@@ -1127,7 +1225,7 @@ let want = {
let accountId = 100;
try {
this.context.stopServiceExtensionAbilityWithAccount(want, accountId, (err) => {
this.context.stopServiceExtensionAbilityWithAccount(want, accountId, (err: BusinessError) => {
if (err.code) {
// 处理业务逻辑错误
console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
......@@ -1138,7 +1236,9 @@ try {
});
} 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\<
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '',
bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility'
......@@ -1196,13 +1299,15 @@ try {
// 执行正常业务
console.info('stopServiceExtensionAbilityWithAccount succeed');
})
.catch((err) => {
.catch((err: BusinessError) => {
// 处理业务逻辑错误
console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
});
} 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;
**示例：**
```ts
import { BusinessError } from '@ohos.base';
try {
this.context.terminateSelf((err) => {
this.context.terminateSelf((err: BusinessError) => {
if (err.code) {
// 处理业务逻辑错误
console.error(`terminateSelf failed, code is ${err.code}, message is ${err.message}`);
......@@ -1248,7 +1355,9 @@ terminateSelf(callback: AsyncCallback&lt;void&gt;): void;
});
} 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;;
**示例：**
```ts
import { BusinessError } from '@ohos.base';
try {
this.context.terminateSelf()
.then(() => {
// 执行正常业务
console.info('terminateSelf succeed');
})
.catch((err) => {
.catch((err: BusinessError) => {
// 处理业务逻辑错误
console.error(`terminateSelf failed, code is ${err.code}, message is ${err.message}`);
});
} 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
**示例：**
```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',
abilityName: 'EntryAbility'
};
let resultCode = 100;
// 返回给接口调用方AbilityResult信息
let abilityResult = {
let abilityResult: common.AbilityResult = {
want,
resultCode
};
try {
this.context.terminateSelfWithResult(abilityResult, (err) => {
this.context.terminateSelfWithResult(abilityResult, (err: BusinessError) => {
if (err.code) {
// 处理业务逻辑错误
console.error(`terminateSelfWithResult failed, code is ${err.code}, message is ${err.message}`);
......@@ -1354,7 +1472,9 @@ try {
});
} 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;;
**示例：**
```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',
abilityName: 'EntryAbility'
};
let resultCode = 100;
// 返回给接口调用方AbilityResult信息
let abilityResult = {
let abilityResult: common.AbilityResult = {
want,
resultCode
};
......@@ -1412,13 +1537,15 @@ try {
// 执行正常业务
console.info('terminateSelfWithResult succeed');
})
.catch((err) => {
.catch((err: BusinessError) => {
// 处理业务逻辑错误
console.error(`terminateSelfWithResult failed, code is ${err.code}, message is ${err.message}`);
});
} 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;
**示例：**
```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: '',
bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility'
};
let commRemote;
let options = {
let commRemote: rpc.IRemoteObject;
let options: common.ConnectOptions = {
onConnect(elementName, remote) {
commRemote = remote;
console.info('onConnect...')
......@@ -1481,13 +1614,14 @@ let options = {
console.info('onFailed...')
}
};
let connection = null;
let connection: number;
try {
connection = this.context.connectServiceExtensionAbility(want, options);
} 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
**示例：**
```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: '',
bundleName: 'com.example.myapplication',
abilityName: 'ServiceExtensionAbility'
};
let accountId = 100;
let commRemote;
let options = {
let commRemote: rpc.IRemoteObject;
let options: common.ConnectOptions = {
onConnect(elementName, remote) {
commRemote = remote;
console.info('onConnect...')
......@@ -1561,13 +1701,14 @@ let options = {
console.info('onFailed...')
}
};
let connection = null;
let connection: number;
try {
connection = this.context.connectServiceExtensionAbilityWithAccount(want, accountId, options);
} 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>;
**示例：**
```ts
import { BusinessError } from '@ohos.base';
// connection为connectServiceExtensionAbility中的返回值
let connection = 1;
let commRemote;
let commRemote: rpc.IRemoteObject | null;
try {
this.context.disconnectServiceExtensionAbility(connection, (err) => {
this.context.disconnectServiceExtensionAbility(connection).then(() => {
commRemote = null;
if (err.code) {
// 处理业务逻辑错误
console.error(`disconnectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
return;
}
// 执行正常业务
console.info('disconnectServiceExtensionAbility succeed');
});
}).catch((err: BusinessError) => {
// 处理业务逻辑错误
console.error(`disconnectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
})
} catch (err) {
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
**示例：**
```ts
import { BusinessError } from '@ohos.base';
// connection为connectServiceExtensionAbility中的返回值
let connection = 1;
let commRemote;
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}`);
}
let commRemote: rpc.IRemoteObject | null;
try {
this.context.disconnectServiceExtensionAbility(connection, (err) => {
this.context.disconnectServiceExtensionAbility(connection, (err: BusinessError) => {
commRemote = null;
if (err.code) {
// 处理业务逻辑错误
......@@ -1687,7 +1815,9 @@ try {
} catch (err) {
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;;
后台启动：
```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
let wantBackground = {
let wantBackground: Want = {
bundleName: 'com.example.myapplication',
moduleName: 'entry',
abilityName: 'EntryAbility',
......@@ -1753,27 +1887,33 @@ let wantBackground = {
try {
this.context.startAbilityByCall(wantBackground)
.then((obj) => {
.then((obj: Caller) => {
// 执行正常业务
caller = obj;
console.info('startAbilityByCall succeed');
}).catch((err) => {
}).catch((err: BusinessError) => {
// 处理业务逻辑错误
console.error(`startAbilityByCall failed, code is ${err.code}, message is ${err.message}`);
});
} 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
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
let wantForeground = {
let wantForeground: Want = {
bundleName: 'com.example.myapplication',
moduleName: 'entry',
abilityName: 'EntryAbility',
......@@ -1785,17 +1925,19 @@ let wantForeground = {
try {
this.context.startAbilityByCall(wantForeground)
.then((obj) => {
.then((obj: Caller) => {
// 执行正常业务
caller = obj;
console.info('startAbilityByCall succeed');
}).catch((err) => {
}).catch((err: BusinessError) => {
// 处理业务逻辑错误
console.error(`startAbilityByCall failed, code is ${err.code}, message is ${err.message}`);
});
} 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\<
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
......@@ -1861,7 +2006,7 @@ let want = {
let accountId = 100;
try {
this.context.startAbilityWithAccount(want, accountId, (err) => {
this.context.startAbilityWithAccount(want, accountId, (err: BusinessError) => {
if (err.code) {
// 处理业务逻辑错误
console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
......@@ -1872,7 +2017,9 @@ try {
});
} 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
**示例：**
```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: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
};
let accountId = 100;
let options = {
let options: StartOptions = {
windowMode: 0
};
try {
this.context.startAbilityWithAccount(want, accountId, options, (err) => {
this.context.startAbilityWithAccount(want, accountId, options, (err: BusinessError) => {
if (err.code) {
// 处理业务逻辑错误
console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
......@@ -1954,7 +2105,9 @@ try {
});
} 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):
**示例：**
```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: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
};
let accountId = 100;
let options = {
let options: StartOptions = {
windowMode: 0
};
......@@ -2029,13 +2186,15 @@ try {
// 执行正常业务
console.info('startAbilityWithAccount succeed');
})
.catch((err) => {
.catch((err: BusinessError) => {
// 处理业务逻辑错误
console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
});
} 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;
**示例：**
```ts
this.context.setMissionLabel('test', (result) => {
import { BusinessError } from '@ohos.base';
this.context.setMissionLabel('test', (result: BusinessError) => {
console.info(`setMissionLabel: ${JSON.stringify(result)}`);
});
```
......@@ -2103,10 +2264,14 @@ setMissionLabel(label: string): Promise&lt;void&gt;;
**示例：**
```ts
import { BusinessError } from '@ohos.base';
this.context.setMissionLabel('test').then(() => {
console.info('success');
}).catch((err) => {
console.error(`setMissionLabel failed, code is ${err.code}, message is ${err.message}`);
}).catch((err: BusinessError) => {
let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`setMissionLabel failed, code is ${code}, message is ${message}`);
});
```
## UIAbilityContext.setMissionIcon
......@@ -2138,26 +2303,30 @@ setMissionIcon(icon: image.PixelMap, callback:AsyncCallback\<void>): void;
**示例：**
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
import image from '@ohos.multimedia.image';
let imagePixelMap;
let color = new ArrayBuffer(0);
let initializationOptions = {
size: {
height: 100,
width: 100
export default class EntryAbility extends UIAbility {
onForeground() {
let imagePixelMap: image.PixelMap;
let color = new ArrayBuffer(0);
image.createPixelMap(color, {
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>;
**示例：**
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
import image from '@ohos.multimedia.image';
let imagePixelMap;
let color = new ArrayBuffer(0);
let initializationOptions = {
size: {
height: 100,
width: 100
export default class EntryAbility extends UIAbility {
onForeground() {
let imagePixelMap: image.PixelMap;
let color = new ArrayBuffer(0);
image.createPixelMap(color, {
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>
......@@ -2249,8 +2422,9 @@ setMissionContinueState(state: AbilityConstant.ContinueState, callback:AsyncCall
```ts
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)}`);
});
```
......@@ -2288,10 +2462,11 @@ setMissionContinueState(state: AbilityConstant.ContinueState): Promise&lt;void&g
```ts
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import { BusinessError } from '@ohos.base';
this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE).then(() => {
console.info('success');
}).catch((err) => {
}).catch((err: BusinessError) => {
console.error(`setMissionContinueState failed, code is ${err.code}, message is ${err.message}`);
});
```
......@@ -2351,7 +2526,7 @@ isTerminating(): boolean;
**示例：**
```ts
let isTerminating = this.context.isTerminating();
let isTerminating: boolean = this.context.isTerminating();
console.info(`ability state is ${isTerminating}`);
```
......@@ -2401,15 +2576,17 @@ requestDialogService(want: Want, result: AsyncCallback&lt;dialogRequest.RequestR
```ts
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: '',
bundleName: 'com.example.myapplication',
abilityName: 'AuthAccountServiceExtension'
};
try {
this.context.requestDialogService(want, (err, result) => {
this.context.requestDialogService(want, (err: BusinessError, result: dialogRequest.RequestResult) => {
if (err.code) {
// 处理业务逻辑错误
console.error(`requestDialogService failed, code is ${err.code}, message is ${err.message}`);
......@@ -2420,7 +2597,9 @@ try {
});
} 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;;
```ts
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',
abilityName: 'AuthAccountServiceExtension'
};
try {
this.context.requestDialogService(want)
.then((result) => {
.then((result: dialogRequest.RequestResult) => {
// 执行正常业务
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}`);
});
} 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
......@@ -2544,13 +2727,16 @@ startRecentAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
**示例：**
```ts
let want = {
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
};
try {
this.context.startRecentAbility(want, (err) => {
this.context.startRecentAbility(want, (err: BusinessError) => {
if (err.code) {
// 处理业务逻辑错误
console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`);
......@@ -2561,7 +2747,9 @@ try {
});
} 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
......@@ -2613,17 +2801,21 @@ startRecentAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt
**示例：**
```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: '',
bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility'
};
let options = {
let options: StartOptions = {
windowMode: 0
};
try {
this.context.startRecentAbility(want, options, (err) => {
this.context.startRecentAbility(want, options, (err: BusinessError) => {
if (err.code) {
// 处理业务逻辑错误
console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`);
......@@ -2634,7 +2826,9 @@ try {
});
} 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
......@@ -2685,11 +2879,15 @@ startRecentAbility(want: Want, options?: StartOptions): Promise&lt;void&gt;;
**示例：**
```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',
abilityName: 'EntryAbility'
};
let options = {
let options: StartOptions = {
windowMode: 0,
};
......@@ -2699,13 +2897,15 @@ try {
// 执行正常业务
console.info('startRecentAbility succeed');
})
.catch((err) => {
.catch((err: BusinessError) => {
// 处理业务逻辑错误
console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`);
});
} 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&
**示例：**
```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表示当前激活用户
let accountId = -1;
// 指定启动的Ability
let want = {
let want: Want = {
bundleName: 'com.acts.actscalleeabilityrely',
moduleName: 'entry',
abilityName: 'EntryAbility',
......@@ -2780,11 +2984,11 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise&lt;Caller&
try {
this.context.startAbilityByCallWithAccount(want, accountId)
.then((obj) => {
.then((obj: Caller) => {
// 执行正常业务
caller = obj;
console.log('startAbilityByCallWithAccount succeed');
}).catch((error) => {
}).catch((error: BusinessError) => {
// 处理业务逻辑错误
console.error('startAbilityByCallWithAccount failed, error.code: ${error.code}, error.message: ${error.message}');
});
......@@ -2842,10 +3046,11 @@ starAbilityAsCaller(want: Want, callback: AsyncCallback\<void>): void;
```ts
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 {
onCreate(want, launchParam) {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
// want包含启动该应用的Caller信息
let localWant: Want = want;
localWant.bundleName = 'com.example.demo';
......@@ -2912,17 +3117,19 @@ startAbilityAsCaller(want: Want, options: StartOptions, callback: AsyncCallback\
```ts
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';
export default class EntryAbility extends UIAbility {
onCreate(want, launchParam) {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
// want包含启动该应用的Caller信息
let localWant: Want = want;
localWant.bundleName = 'com.example.demo';
localWant.moduleName = 'entry';
localWant.abilityName = 'TestAbility';
let option = {
let option: StartOptions = {
displayId: 0
}
......@@ -2993,10 +3200,13 @@ startAbilityAsCaller(want: Want, options?: StartOptions): Promise\<void>;
```ts
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 { BusinessError } from '@ohos.base';
export default class EntryAbility extends UIAbility {
onCreate(want, launchParam) {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
// want包含启动该应用的Caller信息
let localWant: Want = want;
localWant.bundleName = 'com.example.demo';
......@@ -3012,7 +3222,7 @@ export default class EntryAbility extends UIAbility {
.then(() => {
console.log('startAbilityAsCaller success.');
})
.catch((err) => {
.catch((err: BusinessError) => {
console.error('startAbilityAsCaller failed, err:' + JSON.stringify(err));
})
}
......@@ -3047,6 +3257,7 @@ reportDrawnCompleted(callback: AsyncCallback\<void>): void;
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import window from '@ohos.window';
import { BusinessError } from '@ohos.base';
export default class EntryAbility extends UIAbility {
onWindowStageCreate(windowStage: window.WindowStage) {
......@@ -3066,7 +3277,9 @@ export default class EntryAbility extends UIAbility {
});
} 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")
......
zh-cn/application-dev/reference/apis/js-apis-wantAgent.md
浏览文件 @ 10998067
......@@ -32,14 +32,15 @@ getWant(agent: WantAgent, callback: AsyncCallback\<Want\>): void
**示例：**
```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对象
let wantAgent;
let wantAgent: _WantAgent;
//getWantAgent回调
function getWantAgentCallback(err, data) {
function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
console.info('==========================>getWantAgentCallback=======================>');
if (err.code == 0) {
wantAgent = data;
......@@ -49,13 +50,13 @@ function getWantAgentCallback(err, data) {
}
//getWant回调
function getWantCallback(err, data) {
let getWantCallback = (err: BusinessError, data: Want) => {
console.info('==========================>getWantCallback=======================>');
}
WantAgent.getWant(wantAgent, getWantCallback);
}
//WantAgentInfo对象
let wantAgentInfo = {
WantAgent.getWantAgent({
wants: [
{
deviceId: 'deviceId',
......@@ -80,9 +81,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
};
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback);
}, getWantAgentCallback);
```
## WantAgent.getWant
......@@ -110,14 +109,13 @@ getWant(agent: WantAgent): Promise\<Want\>
**示例：**
```ts
import WantAgent from '@ohos.wantAgent';
import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
import { BusinessError } from '@ohos.base';
//wantAgent对象
let wantAgent;
let wantAgent: _WantAgent;
//WantAgentInfo对象
let wantAgentInfo = {
WantAgent.getWantAgent({
wants: [
{
deviceId: 'deviceId',
......@@ -142,9 +140,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo).then((data) => {
}).then((data) => {
console.info('==========================>getWantAgentCallback=======================>');
wantAgent = data;
if (wantAgent) {
......@@ -173,18 +169,19 @@ getWantAgent(info: WantAgentInfo, callback: AsyncCallback\<WantAgent\>): void
**示例：**
```ts
import WantAgent from '@ohos.wantAgent';
import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
import { BusinessError } from '@ohos.base';
//getWantAgent回调
function getWantAgentCallback(err, data) {
function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err.code) {
console.info('getWantAgent Callback err:' + JSON.stringify(err))
} else {
console.info('getWantAgent Callback success')
}
}
//WantAgentInfo对象
let wantAgentInfo = {
WantAgent.getWantAgent({
wants: [
{
deviceId: 'deviceId',
......@@ -209,9 +206,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback);
}, getWantAgentCallback);
```
## WantAgent.getWantAgent
......@@ -237,11 +232,9 @@ getWantAgent(info: WantAgentInfo): Promise\<WantAgent\>
**示例：**
```ts
import WantAgent from '@ohos.wantAgent';
import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
//WantAgentInfo对象
let wantAgentInfo = {
WantAgent.getWantAgent({
wants: [
{
deviceId: 'deviceId',
......@@ -266,9 +259,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo).then((data) => {
}).then((data: _WantAgent) => {
console.info('==========================>getWantAgentCallback=======================>');
});
```
......@@ -291,14 +282,14 @@ getBundleName(agent: WantAgent, callback: AsyncCallback\<string\>): void
**示例：**
```ts
import WantAgent from '@ohos.wantAgent';
import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
import { BusinessError } from '@ohos.base';
//wantAgent对象
let wantAgent;
let wantAgent: _WantAgent;
//getWantAgent回调
function getWantAgentCallback(err, data) {
function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
console.info('==========================>getWantAgentCallback=======================>');
if (err.code == 0) {
wantAgent = data;
......@@ -308,13 +299,13 @@ function getWantAgentCallback(err, data) {
}
//getBundleName回调
function getBundleNameCallback(err, data) {
let getBundleNameCallback = (err: BusinessError, data: string) => {
console.info('==========================>getBundleNameCallback=======================>');
}
WantAgent.getBundleName(wantAgent, getBundleNameCallback);
}
//WantAgentInfo对象
let wantAgentInfo = {
WantAgent.getWantAgent({
wants: [
{
deviceId: 'deviceId',
......@@ -339,9 +330,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback)
}, getWantAgentCallback)
```
......@@ -369,13 +358,12 @@ getBundleName(agent: WantAgent): Promise\<string\>
**示例：**
```ts
import WantAgent from '@ohos.wantAgent';
import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
//wantAgent对象
let wantAgent;
let wantAgent: _WantAgent;
//WantAgentInfo对象
let wantAgentInfo = {
WantAgent.getWantAgent({
wants: [
{
deviceId: 'deviceId',
......@@ -400,9 +388,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo).then((data) => {
}).then((data: _WantAgent) => {
console.info('==========================>getWantAgentCallback=======================>');
wantAgent = data;
if (wantAgent) {
......@@ -433,14 +419,14 @@ getUid(agent: WantAgent, callback: AsyncCallback\<number\>): void
**示例：**
```ts
import WantAgent from '@ohos.wantAgent';
import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
import { BusinessError } from '@ohos.base';
//wantAgent对象
let wantAgent;
let wantAgent: _WantAgent;
//getWantAgent回调
function getWantAgentCallback(err, data) {
function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
console.info('==========================>getWantAgentCallback=======================>');
if (err.code == 0) {
wantAgent = data;
......@@ -450,13 +436,13 @@ function getWantAgentCallback(err, data) {
}
//getUid回调
function getUidCallback(err, data) {
let getUidCallback = (err: BusinessError, data: number) => {
console.info('==========================>getUidCallback=======================>');
}
WantAgent.getUid(wantAgent, getUidCallback);
}
//WantAgentInfo对象
let wantAgentInfo = {
WantAgent.getWantAgent({
wants: [
{
deviceId: 'deviceId',
......@@ -481,9 +467,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback)
}, getWantAgentCallback)
```
......@@ -511,14 +495,12 @@ getUid(agent: WantAgent): Promise\<number\>
**示例：**
```ts
import WantAgent from '@ohos.wantAgent';
import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
//wantAgent对象
let wantAgent;
let wantAgent: _WantAgent;
//WantAgentInfo对象
let wantAgentInfo = {
WantAgent.getWantAgent({
wants: [
{
deviceId: 'deviceId',
......@@ -543,9 +525,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo).then((data) => {
}).then((data) => {
console.info('==========================>getWantAgentCallback=======================>');
wantAgent = data;
if (wantAgent) {
......@@ -575,14 +555,14 @@ cancel(agent: WantAgent, callback: AsyncCallback\<void\>): void
**示例：**
```ts
import WantAgent from '@ohos.wantAgent';
import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
import { BusinessError } from '@ohos.base';
//wantAgent对象
let wantAgent;
let wantAgent: _WantAgent;
//getWantAgent回调
function getWantAgentCallback(err, data) {
function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
console.info('==========================>getWantAgentCallback=======================>');
if (err.code == 0) {
wantAgent = data;
......@@ -592,13 +572,13 @@ function getWantAgentCallback(err, data) {
}
//cancel回调
function cancelCallback(err, data) {
let cancelCallback = (err: BusinessError) => {
console.info('==========================>cancelCallback=======================>');
}
WantAgent.cancel(wantAgent, cancelCallback);
}
//WantAgentInfo对象
let wantAgentInfo = {
WantAgent.getWantAgent({
wants: [
{
deviceId: 'deviceId',
......@@ -623,9 +603,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback)
}, getWantAgentCallback)
```
......@@ -653,41 +631,38 @@ cancel(agent: WantAgent): Promise\<void\>
**示例：**
```ts
import WantAgent from '@ohos.wantAgent';
import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
import { BusinessError } from '@ohos.base';
//wantAgent对象
let wantAgent;
let wantAgent: _WantAgent;
//WantAgentInfo对象
let wantAgentInfo = {
WantAgent.getWantAgent({
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',
bundleName: 'com.neu.setResultOnAbilityResultTest1',
abilityName: 'com.example.test.EntryAbility',
action: 'action1',
entities: ['entity1'],
type: 'MIMETYPE',
uri: 'key={true,true,false}',
parameters:
{
mykey0: 2222,
mykey1: [1, 2, 3],
mykey2: '[1, 2, 3]',
mykey3: 'ssssssssssssssssssssssssss',
mykey4: [false, true, false],
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true,
}
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,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo).then((data) => {
}).then((data) => {
console.info('==========================>getWantAgentCallback=======================>');
wantAgent = data;
if (wantAgent) {
......@@ -719,14 +694,14 @@ trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: Callback\<Complet
**示例：**
```ts
import WantAgent from '@ohos.wantAgent';
import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
import { BusinessError } from '@ohos.base';
//wantAgent对象
let wantAgent;
let wantAgent: _WantAgent;
//getWantAgent回调
function getWantAgentCallback(err, data) {
function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
console.info('==========================>getWantAgentCallback=======================>');
if (err.code == 0) {
wantAgent = data;
......@@ -736,17 +711,14 @@ function getWantAgentCallback(err, data) {
}
//trigger回调
function triggerCallback(data) {
let triggerCallback = (data: WantAgent.CompleteData) => {
console.info('==========================>triggerCallback=======================>');
}
var triggerInfo = {
code:0
}
WantAgent.trigger(wantAgent, triggerInfo, triggerCallback)
WantAgent.trigger(wantAgent, {code:0}, triggerCallback)
}
//WantAgentInfo对象
let wantAgentInfo = {
WantAgent.getWantAgent({
wants: [
{
deviceId: 'deviceId',
......@@ -771,9 +743,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback)
}, getWantAgentCallback)
```
......@@ -797,15 +767,15 @@ equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback\<boolean\
**示例：**
```ts
import WantAgent from '@ohos.wantAgent';
import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
import { BusinessError } from '@ohos.base';
//wantAgent对象
let wantAgent1;
let wantAgent2;
let wantAgent1: _WantAgent;
let wantAgent2: _WantAgent;
//getWantAgent回调
function getWantAgentCallback(err, data) {
function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
console.info('==========================>getWantAgentCallback=======================>');
if (err.code == 0) {
wantAgent1 = data;
......@@ -816,13 +786,13 @@ function getWantAgentCallback(err, data) {
}
//equal回调
function equalCallback(err, data) {
let equalCallback = (err: BusinessError, data: boolean) => {
console.info('==========================>equalCallback=======================>');
}
WantAgent.equal(wantAgent1, wantAgent2, equalCallback)
}
//WantAgentInfo对象
let wantAgentInfo = {
WantAgent.getWantAgent({
wants: [
{
deviceId: 'deviceId',
......@@ -847,9 +817,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback)
}, getWantAgentCallback)
```
......@@ -878,15 +846,15 @@ equal(agent: WantAgent, otherAgent: WantAgent): Promise\<boolean\>
**示例：**
```ts
import WantAgent from '@ohos.wantAgent';
import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent';
import { BusinessError } from '@ohos.base';
//wantAgent对象
let wantAgent1;
let wantAgent2;
let wantAgent1: _WantAgent;
let wantAgent2: _WantAgent;
//WantAgentInfo对象
let wantAgentInfo = {
WantAgent.getWantAgent({
wants: [
{
deviceId: 'deviceId',
......@@ -911,9 +879,7 @@ let wantAgentInfo = {
operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo).then((data) => {
}).then((data) => {
console.info('==========================>getWantAgentCallback=======================>');
wantAgent1 = data;
wantAgent2 = data;
......@@ -923,10 +889,6 @@ WantAgent.getWantAgent(wantAgentInfo).then((data) => {
});
}
});
WantAgent.equal(wantAgent1, wantAgent2).then((data) => {
console.info('==========================>equalCallback=======================>');
});
```
## WantAgentFlags
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或