Skip to content

D
Docs

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

通知 161
Star 293
Fork 28
D
Docs
未验证 提交 3596030e 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!23535 【挑单】元能力API文档示例代码ArkTS规范整改 

Merge pull request !23535 from liuliu/monthly-api
上级 9e7a7b8b cbc11c13
展开全部 隐藏空白更改
内联 并排
Showing with 2480 addition and 1411 deletion
zh-cn/application-dev/reference/apis/js-apis-ability-dataUriUtils.md
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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)}`);
});
```
......@@ -426,8 +431,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)}`);
},
......@@ -448,7 +454,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} `);
}
```
......@@ -490,8 +498,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)}`);
},
......@@ -513,7 +522,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} `);
}
```
......@@ -549,11 +560,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)}`);
},
......@@ -575,11 +587,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 {
......@@ -589,7 +603,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} `);
}
```
......@@ -630,11 +646,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)}`);
},
......@@ -654,20 +671,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} `);
}
```
......@@ -701,8 +721,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 {
......@@ -712,7 +733,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} `);
}
```
......@@ -746,10 +769,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)}`);
});
```
......@@ -789,17 +813,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} `);
}
```
......@@ -840,10 +867,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 {
......@@ -884,9 +912,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 {
......@@ -896,7 +925,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} `);
}
```
......@@ -936,16 +967,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} `);
}
```
......@@ -980,9 +1014,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 {
......@@ -992,7 +1027,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} `);
}
```
......@@ -1032,16 +1069,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} `);
}
```
......@@ -1074,9 +1114,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 {
......@@ -1086,7 +1127,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} `);
}
```
......@@ -1124,16 +1167,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} `);
}
```
......@@ -1166,9 +1212,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 {
......@@ -1178,7 +1225,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} `);
}
```
......@@ -1216,16 +1265,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} `);
}
```
......@@ -1259,10 +1311,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 {
......@@ -1272,7 +1325,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} `);
}
```
......@@ -1311,17 +1366,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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -43,7 +43,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);
},
......@@ -59,7 +62,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}`);
}
```
......@@ -90,9 +95,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);
}
......@@ -100,7 +108,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}`);
}
```
......@@ -136,17 +146,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}`);
}
```
zh-cn/application-dev/reference/apis/js-apis-app-ability-quickFixManager.md
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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-want.md
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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-dataAbilityResult.md
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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-abilityMonitor.md
浏览文件 @ 3596030e
......@@ -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
浏览文件 @ 3596030e
......@@ -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-applicationStateObserver.md
浏览文件 @ 3596030e
......@@ -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)}');
},
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或