未验证 提交 4b0b5216 编写于 作者: O openharmony_ci 提交者: Gitee

!23375 元能力API文档示例代码ArkTS规范整改

Merge pull request !23375 from liuliu/apicheck
...@@ -35,6 +35,8 @@ getId(uri: string): number ...@@ -35,6 +35,8 @@ getId(uri: string): number
**示例:** **示例:**
```ts ```ts
import dataUriUtils from '@ohos.ability.dataUriUtils';
let id = dataUriUtils.getId('com.example.dataUriUtils/1221'); let id = dataUriUtils.getId('com.example.dataUriUtils/1221');
``` ```
...@@ -64,6 +66,8 @@ attachId(uri: string, id: number): string ...@@ -64,6 +66,8 @@ attachId(uri: string, id: number): string
**示例:** **示例:**
```ts ```ts
import dataUriUtils from '@ohos.ability.dataUriUtils';
let id = 1122; let id = 1122;
let uri = dataUriUtils.attachId( let uri = dataUriUtils.attachId(
'com.example.dataUriUtils', 'com.example.dataUriUtils',
...@@ -96,6 +100,8 @@ deleteId(uri: string): string ...@@ -96,6 +100,8 @@ deleteId(uri: string): string
**示例:** **示例:**
```ts ```ts
import dataUriUtils from '@ohos.ability.dataUriUtils';
let uri = dataUriUtils.deleteId('com.example.dataUriUtils/1221'); let uri = dataUriUtils.deleteId('com.example.dataUriUtils/1221');
``` ```
...@@ -125,6 +131,8 @@ updateId(uri: string, id: number): string ...@@ -125,6 +131,8 @@ updateId(uri: string, id: number): string
**示例:** **示例:**
```ts ```ts
import dataUriUtils from '@ohos.ability.dataUriUtils';
let id = 1122; let id = 1122;
let uri = dataUriUtils.updateId( let uri = dataUriUtils.updateId(
'com.example.dataUriUtils/1221', 'com.example.dataUriUtils/1221',
......
...@@ -587,15 +587,7 @@ connectAbility(request: Want, options:ConnectOptions): number ...@@ -587,15 +587,7 @@ connectAbility(request: Want, options:ConnectOptions): number
```ts ```ts
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
function onConnectCallback(element, remote){
console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
}
function onDisconnectCallback(element){
console.log('ConnectAbility onDisconnect element.deviceId : ${element.deviceId}')
}
function onFailedCallback(code){
console.error('featureAbilityTest ConnectAbility onFailed errCode : ${code}')
}
let connectId = featureAbility.connectAbility( let connectId = featureAbility.connectAbility(
{ {
deviceId: '', deviceId: '',
...@@ -603,9 +595,15 @@ let connectId = featureAbility.connectAbility( ...@@ -603,9 +595,15 @@ let connectId = featureAbility.connectAbility(
abilityName: 'com.ix.ServiceAbility.ServiceAbilityA', abilityName: 'com.ix.ServiceAbility.ServiceAbilityA',
}, },
{ {
onConnect: onConnectCallback, onConnect: (element, remote) => {
onDisconnect: onDisconnectCallback, console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
onFailed: onFailedCallback, },
onDisconnect: (element) => {
console.log('ConnectAbility onDisconnect element.deviceId : ${element.deviceId}')
},
onFailed: (code) => {
console.error('featureAbilityTest ConnectAbility onFailed errCode : ${code}')
},
}, },
); );
``` ```
...@@ -630,24 +628,22 @@ disconnectAbility(connection: number, callback:AsyncCallback\<void>): void ...@@ -630,24 +628,22 @@ disconnectAbility(connection: number, callback:AsyncCallback\<void>): void
```ts ```ts
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
function onConnectCallback(element, remote){
console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
}
function onDisconnectCallback(element){
console.log('ConnectAbility onDisconnect element.deviceId : ${element.deviceId}');
}
function onFailedCallback(code){
console.error('featureAbilityTest ConnectAbility onFailed errCode : ${code}');
}
let connectId = featureAbility.connectAbility( let connectId = featureAbility.connectAbility(
{ {
bundleName: 'com.ix.ServiceAbility', bundleName: 'com.ix.ServiceAbility',
abilityName: 'com.ix.ServiceAbility.ServiceAbilityA', abilityName: 'com.ix.ServiceAbility.ServiceAbilityA',
}, },
{ {
onConnect: onConnectCallback, onConnect: (element, remote) => {
onDisconnect: onDisconnectCallback, console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
onFailed: onFailedCallback, },
onDisconnect: (element) => {
console.log('ConnectAbility onDisconnect element.deviceId : ${element.deviceId}');
},
onFailed: (code) => {
console.error('featureAbilityTest ConnectAbility onFailed errCode : ${code}');
},
}, },
); );
...@@ -685,30 +681,29 @@ disconnectAbility(connection: number): Promise\<void> ...@@ -685,30 +681,29 @@ disconnectAbility(connection: number): Promise\<void>
```ts ```ts
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
function onConnectCallback(element, remote){ import { BusinessError } from '@ohos.base';
console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
}
function onDisconnectCallback(element){
console.log('ConnectAbility onDisconnect element.deviceId : ${element.deviceId}');
}
function onFailedCallback(code){
console.error('featureAbilityTest ConnectAbility onFailed errCode : ${code}');
}
let connectId = featureAbility.connectAbility( let connectId = featureAbility.connectAbility(
{ {
bundleName: 'com.ix.ServiceAbility', bundleName: 'com.ix.ServiceAbility',
abilityName: 'com.ix.ServiceAbility.ServiceAbilityA', abilityName: 'com.ix.ServiceAbility.ServiceAbilityA',
}, },
{ {
onConnect: onConnectCallback, onConnect: (element, remote) => {
onDisconnect: onDisconnectCallback, console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
onFailed: onFailedCallback, },
onDisconnect: (element) => {
console.log('ConnectAbility onDisconnect element.deviceId : ${element.deviceId}');
},
onFailed: (code) => {
console.error('featureAbilityTest ConnectAbility onFailed errCode : ${code}');
},
}, },
); );
featureAbility.disconnectAbility(connectId).then((data) => { featureAbility.disconnectAbility(connectId).then((data) => {
console.log('data: ${data)}') console.log('data: ${data)}')
}).catch((error)=>{ }).catch((error: BusinessError)=>{
console.error('featureAbilityTest result errCode : ${error.code}'); console.error('featureAbilityTest result errCode : ${error.code}');
}); });
``` ```
...@@ -731,7 +726,11 @@ getWindow(callback: AsyncCallback\<window.Window>): void ...@@ -731,7 +726,11 @@ getWindow(callback: AsyncCallback\<window.Window>): void
**示例:** **示例:**
```ts ```ts
featureAbility.getWindow((error, data) => { import featureAbility from '@ohos.ability.featureAbility';
import { BusinessError } from '@ohos.base';
import window from '@ohos.window';
featureAbility.getWindow((error: BusinessError, data: window.Window) => {
if (error && error.code !== 0) { if (error && error.code !== 0) {
console.error('getWindow fail, error: ${JSON.stringify(error)}'); console.error('getWindow fail, error: ${JSON.stringify(error)}');
} else { } else {
...@@ -757,6 +756,8 @@ getWindow(): Promise\<window.Window>; ...@@ -757,6 +756,8 @@ getWindow(): Promise\<window.Window>;
**示例:** **示例:**
```ts ```ts
import featureAbility from '@ohos.ability.featureAbility';
featureAbility.getWindow().then((data) => { featureAbility.getWindow().then((data) => {
console.info('getWindow data: ${typeof(data)}'); console.info('getWindow data: ${typeof(data)}');
}); });
......
...@@ -233,8 +233,9 @@ startBackgroundRunning(id: number, request: NotificationRequest, callback: Async ...@@ -233,8 +233,9 @@ startBackgroundRunning(id: number, request: NotificationRequest, callback: Async
import notification from '@ohos.notification'; import notification from '@ohos.notification';
import particleAbility from '@ohos.ability.particleAbility'; import particleAbility from '@ohos.ability.particleAbility';
import wantAgent from '@ohos.app.ability.wantAgent'; import wantAgent from '@ohos.app.ability.wantAgent';
import { BusinessError } from '@ohos.base';
function callback(error, data) { function callback(error: BusinessError, data: void) {
if (error && error.code !== 0) { if (error && error.code !== 0) {
console.error('Operation failed error: ${JSON.stringify(error)}'); console.error('Operation failed error: ${JSON.stringify(error)}');
} else { } else {
...@@ -242,7 +243,7 @@ function callback(error, data) { ...@@ -242,7 +243,7 @@ function callback(error, data) {
} }
} }
let wantAgentInfo = { let wantAgentInfo: wantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
...@@ -255,20 +256,19 @@ let wantAgentInfo = { ...@@ -255,20 +256,19 @@ let wantAgentInfo = {
}; };
wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => { wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
let basicContent = {
title: 'title',
text: 'text'
};
let notificationContent = {
contentType: notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
normal: basicContent
};
let request = {
content: notificationContent,
wantAgent: wantAgentObj
};
let id = 1; let id = 1;
particleAbility.startBackgroundRunning(id, request, callback); particleAbility.startBackgroundRunning(id, {
content:
{
contentType: notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
normal:
{
title: 'title',
text: 'text'
}
},
wantAgent: wantAgentObj
}, callback);
}); });
``` ```
...@@ -302,8 +302,9 @@ startBackgroundRunning(id: number, request: NotificationRequest): Promise&lt;voi ...@@ -302,8 +302,9 @@ startBackgroundRunning(id: number, request: NotificationRequest): Promise&lt;voi
import notification from '@ohos.notification'; import notification from '@ohos.notification';
import particleAbility from '@ohos.ability.particleAbility'; import particleAbility from '@ohos.ability.particleAbility';
import wantAgent from '@ohos.app.ability.wantAgent'; import wantAgent from '@ohos.app.ability.wantAgent';
import { BusinessError } from '@ohos.base';
let wantAgentInfo = { let wantAgentInfo: wantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
...@@ -316,22 +317,21 @@ let wantAgentInfo = { ...@@ -316,22 +317,21 @@ let wantAgentInfo = {
}; };
wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => { wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
let basicContent = {
title: 'title',
text: 'text'
};
let notificationContent = {
contentType: notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
normal: basicContent
};
let request = {
content: notificationContent,
wantAgent: wantAgentObj
};
let id = 1; let id = 1;
particleAbility.startBackgroundRunning(id, request).then(() => { particleAbility.startBackgroundRunning(id, {
content:
{
contentType: notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
normal:
{
title: 'title',
text: 'text'
}
},
wantAgent: wantAgentObj
}).then(() => {
console.info('Operation succeeded'); console.info('Operation succeeded');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error('Operation failed cause: ${JSON.stringify(err)}'); console.error('Operation failed cause: ${JSON.stringify(err)}');
}); });
}); });
...@@ -356,8 +356,9 @@ cancelBackgroundRunning(callback: AsyncCallback&lt;void&gt;): void; ...@@ -356,8 +356,9 @@ cancelBackgroundRunning(callback: AsyncCallback&lt;void&gt;): void;
```ts ```ts
import particleAbility from '@ohos.ability.particleAbility'; import particleAbility from '@ohos.ability.particleAbility';
import { BusinessError } from '@ohos.base';
function callback(error, data) { function callback(error: BusinessError, data: void) {
if (error && error.code !== 0) { if (error && error.code !== 0) {
console.error('Operation failed error: ${JSON.stringify(error)}'); console.error('Operation failed error: ${JSON.stringify(error)}');
} else { } else {
...@@ -390,7 +391,7 @@ import particleAbility from '@ohos.ability.particleAbility'; ...@@ -390,7 +391,7 @@ import particleAbility from '@ohos.ability.particleAbility';
particleAbility.cancelBackgroundRunning().then(() => { particleAbility.cancelBackgroundRunning().then(() => {
console.info('Operation succeeded'); console.info('Operation succeeded');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error('Operation failed cause: ${JSON.stringify(err)}'); console.error('Operation failed cause: ${JSON.stringify(err)}');
}); });
...@@ -424,33 +425,27 @@ connectAbility(request: Want, options:ConnectOptions): number ...@@ -424,33 +425,27 @@ connectAbility(request: Want, options:ConnectOptions): number
import particleAbility from '@ohos.ability.particleAbility'; import particleAbility from '@ohos.ability.particleAbility';
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
function onConnectCallback(element, remote) {
console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
}
function onDisconnectCallback(element) {
console.log('ConnectAbility onDisconnect element.deviceId: ${element.deviceId}');
}
function onFailedCallback(code) {
console.error('particleAbilityTest ConnectAbility onFailed errCode: ${code}');
}
let connId = particleAbility.connectAbility( let connId = particleAbility.connectAbility(
{ {
bundleName: 'com.ix.ServiceAbility', bundleName: 'com.ix.ServiceAbility',
abilityName: 'ServiceAbilityA', abilityName: 'ServiceAbilityA',
}, },
{ {
onConnect: onConnectCallback, onConnect: (element, remote) => {
onDisconnect: onDisconnectCallback, console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
onFailed: onFailedCallback, },
onDisconnect: (element) => {
console.log('ConnectAbility onDisconnect element.deviceId: ${element.deviceId}');
},
onFailed: (code) => {
console.error('particleAbilityTest ConnectAbility onFailed errCode: ${code}');
},
}, },
); );
particleAbility.disconnectAbility(connId).then((data) => { particleAbility.disconnectAbility(connId).then((data) => {
console.log('data: ${data}'); console.log('data: ${data}');
}).catch((error) => { }).catch((error: BusinessError) => {
console.error('particleAbilityTest result errCode: ${error.code}'); console.error('particleAbilityTest result errCode: ${error.code}');
}); });
``` ```
...@@ -475,27 +470,21 @@ disconnectAbility(connection: number, callback:AsyncCallback\<void>): void; ...@@ -475,27 +470,21 @@ disconnectAbility(connection: number, callback:AsyncCallback\<void>): void;
import particleAbility from '@ohos.ability.particleAbility'; import particleAbility from '@ohos.ability.particleAbility';
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
function onConnectCallback(element, remote) {
console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
}
function onDisconnectCallback(element) {
console.log('ConnectAbility onDisconnect element.deviceId: ${element.deviceId}');
}
function onFailedCallback(code) {
console.error('particleAbilityTest ConnectAbility onFailed errCode: ${code}');
}
let connId = particleAbility.connectAbility( let connId = particleAbility.connectAbility(
{ {
bundleName: 'com.ix.ServiceAbility', bundleName: 'com.ix.ServiceAbility',
abilityName: 'ServiceAbilityA', abilityName: 'ServiceAbilityA',
}, },
{ {
onConnect: onConnectCallback, onConnect: (element, remote) => {
onDisconnect: onDisconnectCallback, console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
onFailed: onFailedCallback, },
onDisconnect: (element) => {
console.log('ConnectAbility onDisconnect element.deviceId: ${element.deviceId}');
},
onFailed: (code) => {
console.error('particleAbilityTest ConnectAbility onFailed errCode: ${code}');
},
}, },
); );
...@@ -524,18 +513,7 @@ disconnectAbility(connection: number): Promise\<void>; ...@@ -524,18 +513,7 @@ disconnectAbility(connection: number): Promise\<void>;
```ts ```ts
import particleAbility from '@ohos.ability.particleAbility'; import particleAbility from '@ohos.ability.particleAbility';
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
import { BusinessError } from '@ohos.base';
function onConnectCallback(element, remote) {
console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
}
function onDisconnectCallback(element) {
console.log('ConnectAbility onDisconnect element.deviceId: ${element.deviceId}');
}
function onFailedCallback(code) {
console.error('particleAbilityTest ConnectAbility onFailed errCode: ${code}');
}
let connId = particleAbility.connectAbility( let connId = particleAbility.connectAbility(
{ {
...@@ -543,18 +521,23 @@ let connId = particleAbility.connectAbility( ...@@ -543,18 +521,23 @@ let connId = particleAbility.connectAbility(
abilityName: 'ServiceAbilityA', abilityName: 'ServiceAbilityA',
}, },
{ {
onConnect: onConnectCallback, onConnect: (element, remote) => {
onDisconnect: onDisconnectCallback, console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}');
onFailed: onFailedCallback, },
onDisconnect: (element) => {
console.log('ConnectAbility onDisconnect element.deviceId: ${element.deviceId}');
},
onFailed: (code) => {
console.error('particleAbilityTest ConnectAbility onFailed errCode: ${code}');
},
}, },
); );
particleAbility.disconnectAbility(connId).then((data) => { particleAbility.disconnectAbility(connId).then((data) => {
console.log(' data: ${data}'); console.log(' data: ${data}');
}).catch((error) => { }).catch((error: BusinessError) => {
console.error('particleAbilityTest result errCode : ${error.code}'); console.error('particleAbilityTest result errCode : ${error.code}');
}); });
``` ```
## ErrorCode ## ErrorCode
......
...@@ -31,9 +31,10 @@ onConfigurationUpdate(newConfig: Configuration): void; ...@@ -31,9 +31,10 @@ onConfigurationUpdate(newConfig: Configuration): void;
```ts ```ts
// Ability是顶层基类,不支持开发者直接继承。故以派生类UIAbility举例说明。 // Ability是顶层基类,不支持开发者直接继承。故以派生类UIAbility举例说明。
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import { Configuration } from '@ohos.app.ability.Configuration';
class MyUIAbility extends UIAbility { class MyUIAbility extends UIAbility {
onConfigurationUpdate(config) { onConfigurationUpdate(config: Configuration) {
console.log('onConfigurationUpdate, config: ${JSON.stringify(config)}'); console.log('onConfigurationUpdate, config: ${JSON.stringify(config)}');
} }
} }
...@@ -58,9 +59,10 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void; ...@@ -58,9 +59,10 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
```ts ```ts
// Ability是顶层基类,不支持开发者直接继承。故以派生类UIAbility举例说明。 // Ability是顶层基类,不支持开发者直接继承。故以派生类UIAbility举例说明。
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyUIAbility extends UIAbility { class MyUIAbility extends UIAbility {
onMemoryLevel(level) { onMemoryLevel(level: AbilityConstant.MemoryLevel) {
console.log('onMemoryLevel, level: ${JSON.stringify(level)}'); console.log('onMemoryLevel, level: ${JSON.stringify(level)}');
} }
} }
......
...@@ -45,9 +45,11 @@ Ability初次启动原因,该类型为枚举,可配合[Ability](js-apis-app- ...@@ -45,9 +45,11 @@ Ability初次启动原因,该类型为枚举,可配合[Ability](js-apis-app-
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import Want from '@ohos.app.ability.Want';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
if (launchParam.launchReason === AbilityConstant.LaunchReason.START_ABILITY) { if (launchParam.launchReason === AbilityConstant.LaunchReason.START_ABILITY) {
console.log('The ability has been started by the way of startAbility.'); console.log('The ability has been started by the way of startAbility.');
} }
...@@ -77,9 +79,11 @@ Ability上次退出原因,该类型为枚举,可配合[Ability](js-apis-app- ...@@ -77,9 +79,11 @@ Ability上次退出原因,该类型为枚举,可配合[Ability](js-apis-app-
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import Want from '@ohos.app.ability.Want';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
if (launchParam.lastExitReason === AbilityConstant.LastExitReason.ABILITY_NOT_RESPONDING) { if (launchParam.lastExitReason === AbilityConstant.LastExitReason.ABILITY_NOT_RESPONDING) {
console.log('The ability has exit last because the ability was not responding.'); console.log('The ability has exit last because the ability was not responding.');
} }
...@@ -103,9 +107,10 @@ Ability迁移结果,该类型为枚举,可配合[Ability](js-apis-app-abilit ...@@ -103,9 +107,10 @@ Ability迁移结果,该类型为枚举,可配合[Ability](js-apis-app-abilit
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onContinue(wantParam) { onContinue(wantParam: Record<string, Object>) {
return AbilityConstant.OnContinueResult.AGREE; return AbilityConstant.OnContinueResult.AGREE;
} }
} }
...@@ -130,18 +135,22 @@ class MyAbility extends UIAbility { ...@@ -130,18 +135,22 @@ class MyAbility extends UIAbility {
**示例:** **示例:**
```ts ```ts
let want = { import StartOptions from '@ohos.app.ability.StartOptions';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
let option = { let option: StartOptions = {
windowMode: AbilityConstant.WindowMode.WINDOW_MODE_FULLSCREEN windowMode: AbilityConstant.WindowMode.WINDOW_MODE_FULLSCREEN
}; };
// 确保从上下文获取到context // 确保从上下文获取到context
this.context.startAbility(want, option).then(()=>{ this.context.startAbility(want, option).then(()=>{
console.log('Succeed to start ability.'); console.log('Succeed to start ability.');
}).catch((error)=>{ }).catch((error: BusinessError)=>{
console.error('Failed to start ability with error: ${JSON.stringify(error)}'); console.error('Failed to start ability with error: ${JSON.stringify(error)}');
}); });
``` ```
...@@ -162,9 +171,10 @@ this.context.startAbility(want, option).then(()=>{ ...@@ -162,9 +171,10 @@ this.context.startAbility(want, option).then(()=>{
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onMemoryLevel(level) { onMemoryLevel(level: AbilityConstant.MemoryLevel) {
if (level === AbilityConstant.MemoryLevel.MEMORY_LEVEL_CRITICAL) { if (level === AbilityConstant.MemoryLevel.MEMORY_LEVEL_CRITICAL) {
console.log('The memory of device is critical, please release some memory.'); console.log('The memory of device is critical, please release some memory.');
} }
...@@ -191,9 +201,10 @@ class MyAbility extends UIAbility { ...@@ -191,9 +201,10 @@ class MyAbility extends UIAbility {
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onSaveState(reason, wantParam) { onSaveState(reason: AbilityConstant.StateType, wantParam: Record<string, Object>) {
return AbilityConstant.OnSaveResult.ALL_AGREE; return AbilityConstant.OnSaveResult.ALL_AGREE;
} }
} }
...@@ -214,9 +225,10 @@ class MyAbility extends UIAbility { ...@@ -214,9 +225,10 @@ class MyAbility extends UIAbility {
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onSaveState(reason, wantParam) { onSaveState(reason: AbilityConstant.StateType, wantParam: Record<string, Object>) {
if (reason === AbilityConstant.StateType.CONTINUATION) { if (reason === AbilityConstant.StateType.CONTINUATION) {
console.log('Save the ability data when the ability continuation.'); console.log('Save the ability data when the ability continuation.');
} }
...@@ -240,8 +252,9 @@ ContinueState说明枚举值。用于表示当前应用任务流转的状态。 ...@@ -240,8 +252,9 @@ ContinueState说明枚举值。用于表示当前应用任务流转的状态。
```ts ```ts
import AbilityConstant from '@ohos.app.ability.AbilityConstant'; import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import { BusinessError } from '@ohos.base';
this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE, (result) => { this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE, (result: BusinessError) => {
console.info(`setMissionContinueState: ${JSON.stringify(result)}`); console.info(`setMissionContinueState: ${JSON.stringify(result)}`);
}); });
``` ```
\ No newline at end of file
...@@ -45,10 +45,11 @@ getAbilityDelegator(): AbilityDelegator ...@@ -45,10 +45,11 @@ getAbilityDelegator(): AbilityDelegator
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
import Want from '@ohos.app.ability.Want';
let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
let want = { let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility' abilityName: 'EntryAbility'
}; };
......
...@@ -29,7 +29,9 @@ onAbilityCreate(ability: UIAbility): void; ...@@ -29,7 +29,9 @@ onAbilityCreate(ability: UIAbility): void;
**示例:** **示例:**
```ts ```ts
let abilityLifecycleCallback = { import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onAbilityCreate(ability){ onAbilityCreate(ability){
console.log('AbilityLifecycleCallback onAbilityCreate.'); console.log('AbilityLifecycleCallback onAbilityCreate.');
} }
...@@ -53,7 +55,9 @@ onWindowStageCreate(ability: UIAbility, windowStage: window.WindowStage): void; ...@@ -53,7 +55,9 @@ onWindowStageCreate(ability: UIAbility, windowStage: window.WindowStage): void;
**示例:** **示例:**
```ts ```ts
let abilityLifecycleCallback = { import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onWindowStageCreate(ability, windowStage){ onWindowStageCreate(ability, windowStage){
console.log('AbilityLifecycleCallback onWindowStageCreate.'); console.log('AbilityLifecycleCallback onWindowStageCreate.');
} }
...@@ -77,7 +81,9 @@ onWindowStageActive(ability: UIAbility, windowStage: window.WindowStage): void; ...@@ -77,7 +81,9 @@ onWindowStageActive(ability: UIAbility, windowStage: window.WindowStage): void;
**示例:** **示例:**
```ts ```ts
let abilityLifecycleCallback = { import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onWindowStageActive(ability, windowStage){ onWindowStageActive(ability, windowStage){
console.log('AbilityLifecycleCallback onWindowStageActive.'); console.log('AbilityLifecycleCallback onWindowStageActive.');
} }
...@@ -101,7 +107,9 @@ onWindowStageInactive(ability: UIAbility, windowStage: window.WindowStage): void ...@@ -101,7 +107,9 @@ onWindowStageInactive(ability: UIAbility, windowStage: window.WindowStage): void
**示例:** **示例:**
```ts ```ts
let abilityLifecycleCallback = { import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onWindowStageInactive(ability, windowStage){ onWindowStageInactive(ability, windowStage){
console.log('AbilityLifecycleCallback onWindowStageInactive.'); console.log('AbilityLifecycleCallback onWindowStageInactive.');
} }
...@@ -125,7 +133,9 @@ onWindowStageDestroy(ability: UIAbility, windowStage: window.WindowStage): void; ...@@ -125,7 +133,9 @@ onWindowStageDestroy(ability: UIAbility, windowStage: window.WindowStage): void;
**示例:** **示例:**
```ts ```ts
let abilityLifecycleCallback = { import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onWindowStageDestroy(ability, windowStage){ onWindowStageDestroy(ability, windowStage){
console.log('AbilityLifecycleCallback onWindowStageDestroy.'); console.log('AbilityLifecycleCallback onWindowStageDestroy.');
} }
...@@ -148,7 +158,9 @@ onAbilityDestroy(ability: UIAbility): void; ...@@ -148,7 +158,9 @@ onAbilityDestroy(ability: UIAbility): void;
**示例:** **示例:**
```ts ```ts
let abilityLifecycleCallback = { import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onAbilityDestroy(ability){ onAbilityDestroy(ability){
console.log('AbilityLifecycleCallback onAbilityDestroy.'); console.log('AbilityLifecycleCallback onAbilityDestroy.');
} }
...@@ -171,7 +183,9 @@ onAbilityForeground(ability: UIAbility): void; ...@@ -171,7 +183,9 @@ onAbilityForeground(ability: UIAbility): void;
**示例:** **示例:**
```ts ```ts
let abilityLifecycleCallback = { import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onAbilityForeground(ability){ onAbilityForeground(ability){
console.log('AbilityLifecycleCallback onAbilityForeground.'); console.log('AbilityLifecycleCallback onAbilityForeground.');
} }
...@@ -194,7 +208,9 @@ onAbilityBackground(ability: UIAbility): void; ...@@ -194,7 +208,9 @@ onAbilityBackground(ability: UIAbility): void;
**示例:** **示例:**
```ts ```ts
let abilityLifecycleCallback = { import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onAbilityBackground(ability){ onAbilityBackground(ability){
console.log('AbilityLifecycleCallback onAbilityBackground.'); console.log('AbilityLifecycleCallback onAbilityBackground.');
} }
...@@ -217,7 +233,9 @@ onAbilityContinue(ability: UIAbility): void; ...@@ -217,7 +233,9 @@ onAbilityContinue(ability: UIAbility): void;
**示例:** **示例:**
```ts ```ts
let abilityLifecycleCallback = { import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
let abilityLifecycleCallback: AbilityLifecycleCallback = {
onAbilityContinue(ability){ onAbilityContinue(ability){
console.log('AbilityLifecycleCallback onAbilityContinue.'); console.log('AbilityLifecycleCallback onAbilityContinue.');
} }
...@@ -227,15 +245,40 @@ let abilityLifecycleCallback = { ...@@ -227,15 +245,40 @@ let abilityLifecycleCallback = {
## AbilityLifecycleCallback使用 ## AbilityLifecycleCallback使用
**示例:** **示例:**
GlobalContext.ts
```ts
// 构造单例对象
export class GlobalContext {
private constructor() {}
private static instance: GlobalContext;
private _objects = new Map<string, Object>();
public static getContext(): GlobalContext {
if (!GlobalContext.instance) {
GlobalContext.instance = new GlobalContext();
}
return GlobalContext.instance;
}
getObject(value: string): Object | undefined {
return this._objects.get(value);
}
setObject(key: string, objectClass: Object): void {
this._objects.set(key, objectClass);
}
}
```
MyFirstAbility.ts MyFirstAbility.ts
```ts ```ts
import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback'; import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
import AbilityStage from '@ohos.app.ability.AbilityStage'; import AbilityStage from '@ohos.app.ability.AbilityStage';
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import { GlobalContext } from '../GlobalContext'
// 声明ability生命周期回调,需配置所有回调后才可以在applicationContext注册 // 声明ability生命周期回调,需配置所有回调后才可以在applicationContext注册
let abilityLifecycleCallback = { let abilityLifecycleCallback: AbilityLifecycleCallback = {
onAbilityCreate(ability){ onAbilityCreate(ability){
console.log('AbilityLifecycleCallback onAbilityCreate.'); console.log('AbilityLifecycleCallback onAbilityCreate.');
}, },
...@@ -272,7 +315,8 @@ export default class MyFirstAbility extends UIAbility { ...@@ -272,7 +315,8 @@ export default class MyFirstAbility extends UIAbility {
let applicationContext = this.context.getApplicationContext(); let applicationContext = this.context.getApplicationContext();
// 2.通过applicationContext注册监听应用内生命周期 // 2.通过applicationContext注册监听应用内生命周期
try { try {
globalThis.lifecycleId = applicationContext.on('abilityLifecycle', abilityLifecycleCallback); let lifecycleId = applicationContext.on('abilityLifecycle', abilityLifecycleCallback);
GlobalContext.getContext().setObject("lifecycleId", lifecycleId);
console.log('registerAbilityLifecycleCallback lifecycleId: ${globalThis.lifecycleId}'); console.log('registerAbilityLifecycleCallback lifecycleId: ${globalThis.lifecycleId}');
} catch (paramError) { } catch (paramError) {
console.error('error: ${paramError.code}, ${paramError.message}'); console.error('error: ${paramError.code}, ${paramError.message}');
...@@ -284,12 +328,14 @@ export default class MyFirstAbility extends UIAbility { ...@@ -284,12 +328,14 @@ export default class MyFirstAbility extends UIAbility {
MySecondAbility.ts MySecondAbility.ts
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import { GlobalContext } from '../GlobalContext'
export default class MySecondAbility extends UIAbility { export default class MySecondAbility extends UIAbility {
onDestroy() { onDestroy() {
let applicationContext = this.context.getApplicationContext(); let applicationContext = this.context.getApplicationContext();
let lifecycleId: number = GlobalContext.getContext().getObject("lifecycleId");
// 3.通过applicationContext注销监听应用内生命周期 // 3.通过applicationContext注销监听应用内生命周期
applicationContext.off('abilityLifecycle', globalThis.lifecycleId, (error) => { applicationContext.off('abilityLifecycle', lifecycleId, (error) => {
if (error && error.code !== 0) { if (error && error.code !== 0) {
console.error('unregisterAbilityLifecycleCallback fail, error: ${JSON.stringify(error)}'); console.error('unregisterAbilityLifecycleCallback fail, error: ${JSON.stringify(error)}');
} else { } else {
......
...@@ -59,9 +59,10 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void ...@@ -59,9 +59,10 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void
```ts ```ts
import abilityManager from '@ohos.app.ability.abilityManager'; import abilityManager from '@ohos.app.ability.abilityManager';
import { Configuration } from '@ohos.app.ability.Configuration';
import ConfigurationConstant from '@ohos.app.ability.ConfigurationConstant'; import ConfigurationConstant from '@ohos.app.ability.ConfigurationConstant';
const config = { const config: Configuration = {
language: 'Zh-Hans', // 简体中文 language: 'Zh-Hans', // 简体中文
colorMode: ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT, // 浅色模式 colorMode: ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT, // 浅色模式
direction: ConfigurationConstant.Direction.DIRECTION_VERTICAL, // 垂直方向 direction: ConfigurationConstant.Direction.DIRECTION_VERTICAL, // 垂直方向
...@@ -117,9 +118,11 @@ updateConfiguration(config: Configuration): Promise\<void> ...@@ -117,9 +118,11 @@ updateConfiguration(config: Configuration): Promise\<void>
```ts ```ts
import abilityManager from '@ohos.app.ability.abilityManager'; import abilityManager from '@ohos.app.ability.abilityManager';
import { Configuration } from '@ohos.app.ability.Configuration';
import ConfigurationConstant from '@ohos.app.ability.ConfigurationConstant'; import ConfigurationConstant from '@ohos.app.ability.ConfigurationConstant';
import { BusinessError } from '@ohos.base';
const config = { const config: Configuration = {
language: 'Zh-Hans', // 简体中文 language: 'Zh-Hans', // 简体中文
colorMode: ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT, // 浅色模式 colorMode: ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT, // 浅色模式
direction: ConfigurationConstant.Direction.DIRECTION_VERTICAL, // 垂直方向 direction: ConfigurationConstant.Direction.DIRECTION_VERTICAL, // 垂直方向
...@@ -131,7 +134,7 @@ const config = { ...@@ -131,7 +134,7 @@ const config = {
try { try {
abilityManager.updateConfiguration(config).then(() => { abilityManager.updateConfiguration(config).then(() => {
console.log('updateConfiguration success.'); console.log('updateConfiguration success.');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error('updateConfiguration fail, err: ${JSON.stringify(err)}'); console.error('updateConfiguration fail, err: ${JSON.stringify(err)}');
}); });
} catch (paramError) { } catch (paramError) {
...@@ -209,11 +212,12 @@ getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>> ...@@ -209,11 +212,12 @@ getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>>
```ts ```ts
import abilityManager from '@ohos.app.ability.abilityManager'; import abilityManager from '@ohos.app.ability.abilityManager';
import { BusinessError } from '@ohos.base';
try { try {
abilityManager.getAbilityRunningInfos().then((data) => { abilityManager.getAbilityRunningInfos().then((data) => {
console.log('getAbilityRunningInfos success, data: ${JSON.stringify(data)}'); console.log('getAbilityRunningInfos success, data: ${JSON.stringify(data)}');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error('getAbilityRunningInfos fail, err: ${JSON.stringify(err)}'); console.error('getAbilityRunningInfos fail, err: ${JSON.stringify(err)}');
}); });
} catch (paramError) { } catch (paramError) {
...@@ -300,13 +304,14 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn ...@@ -300,13 +304,14 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn
```ts ```ts
import abilityManager from '@ohos.app.ability.abilityManager'; import abilityManager from '@ohos.app.ability.abilityManager';
import { BusinessError } from '@ohos.base';
let upperLimit = 10; let upperLimit = 10;
try { try {
abilityManager.getExtensionRunningInfos(upperLimit).then((data) => { abilityManager.getExtensionRunningInfos(upperLimit).then((data) => {
console.log('getExtensionRunningInfos success, data: ${JSON.stringify(data)}'); console.log('getExtensionRunningInfos success, data: ${JSON.stringify(data)}');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error('getExtensionRunningInfos fail, err: ${JSON.stringify(err)}'); console.error('getExtensionRunningInfos fail, err: ${JSON.stringify(err)}');
}); });
} catch (paramError) { } catch (paramError) {
...@@ -376,10 +381,11 @@ getTopAbility(): Promise\<ElementName>; ...@@ -376,10 +381,11 @@ getTopAbility(): Promise\<ElementName>;
```ts ```ts
import abilityManager from '@ohos.app.ability.abilityManager'; import abilityManager from '@ohos.app.ability.abilityManager';
import { BusinessError } from '@ohos.base';
abilityManager.getTopAbility().then((data) => { abilityManager.getTopAbility().then((data) => {
console.log('getTopAbility success, data: ${JSON.stringify(data)}'); console.log('getTopAbility success, data: ${JSON.stringify(data)}');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error('getTopAbility fail, err: ${JSON.stringify(err)}'); console.error('getTopAbility fail, err: ${JSON.stringify(err)}');
}); });
``` ```
...@@ -413,6 +419,8 @@ acquireShareData(missionId: number, callback: AsyncCallback<{[key: string]: Obje ...@@ -413,6 +419,8 @@ acquireShareData(missionId: number, callback: AsyncCallback<{[key: string]: Obje
```ts ```ts
import abilityManager from '@ohos.app.ability.abilityManager'; import abilityManager from '@ohos.app.ability.abilityManager';
import { BusinessError } from '@ohos.base';
try { try {
abilityManager.acquireShareData(1, (err, wantParam) => { abilityManager.acquireShareData(1, (err, wantParam) => {
if (err) { if (err) {
...@@ -422,7 +430,9 @@ try { ...@@ -422,7 +430,9 @@ try {
} }
}); });
} catch (paramError) { } catch (paramError) {
console.error(`error.code: ${JSON.stringify(paramError.code)}, error.message: ${JSON.stringify(paramError.message)}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error.code: ${JSON.stringify(code)}, error.message: ${JSON.stringify(message)}`);
} }
``` ```
...@@ -461,13 +471,17 @@ acquireShareData(missionId: number): Promise<{[key: string]: Object}>; ...@@ -461,13 +471,17 @@ acquireShareData(missionId: number): Promise<{[key: string]: Object}>;
```ts ```ts
import abilityManager from '@ohos.app.ability.abilityManager'; import abilityManager from '@ohos.app.ability.abilityManager';
import { BusinessError } from '@ohos.base';
try { try {
abilityManager.acquireShareData(1).then((wantParam) => { abilityManager.acquireShareData(1).then((wantParam) => {
console.log(`acquireShareData success, data: ${JSON.stringify(wantParam)}`); console.log(`acquireShareData success, data: ${JSON.stringify(wantParam)}`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`acquireShareData fail, err: ${JSON.stringify(err)}`); console.error(`acquireShareData fail, err: ${JSON.stringify(err)}`);
}); });
} catch (paramError) { } catch (paramError) {
console.error(`error.code: ${JSON.stringify(paramError.code)}, error.message: ${JSON.stringify(paramError.message)}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error.code: ${JSON.stringify(code)}, error.message: ${JSON.stringify(message)}`);
} }
``` ```
\ No newline at end of file
...@@ -60,9 +60,10 @@ onAcceptWant(want: Want): string; ...@@ -60,9 +60,10 @@ onAcceptWant(want: Want): string;
```ts ```ts
import AbilityStage from '@ohos.app.ability.AbilityStage'; import AbilityStage from '@ohos.app.ability.AbilityStage';
import Want from '@ohos.app.ability.Want';
class MyAbilityStage extends AbilityStage { class MyAbilityStage extends AbilityStage {
onAcceptWant(want) { onAcceptWant(want: Want) {
console.log('MyAbilityStage.onAcceptWant called'); console.log('MyAbilityStage.onAcceptWant called');
return 'com.example.test'; return 'com.example.test';
} }
...@@ -88,9 +89,10 @@ onConfigurationUpdate(newConfig: Configuration): void; ...@@ -88,9 +89,10 @@ onConfigurationUpdate(newConfig: Configuration): void;
```ts ```ts
import AbilityStage from '@ohos.app.ability.AbilityStage'; import AbilityStage from '@ohos.app.ability.AbilityStage';
import { Configuration } from '@ohos.app.ability.Configuration';
class MyAbilityStage extends AbilityStage { class MyAbilityStage extends AbilityStage {
onConfigurationUpdate(config) { onConfigurationUpdate(config: Configuration) {
console.log('onConfigurationUpdate, language: ${config.language}'); console.log('onConfigurationUpdate, language: ${config.language}');
} }
} }
...@@ -114,9 +116,10 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void; ...@@ -114,9 +116,10 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
```ts ```ts
import AbilityStage from '@ohos.app.ability.AbilityStage'; import AbilityStage from '@ohos.app.ability.AbilityStage';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
class MyAbilityStage extends AbilityStage { class MyAbilityStage extends AbilityStage {
onMemoryLevel(level) { onMemoryLevel(level: AbilityConstant.MemoryLevel) {
console.log('onMemoryLevel, level: ${JSON.stringify(level)}'); console.log('onMemoryLevel, level: ${JSON.stringify(level)}');
} }
} }
......
...@@ -101,7 +101,7 @@ API10时将启动由[setRestartWant](#apprecoverysetrestartwant)指定的Ability ...@@ -101,7 +101,7 @@ API10时将启动由[setRestartWant](#apprecoverysetrestartwant)指定的Ability
import appRecovery from '@ohos.app.ability.appRecovery'; import appRecovery from '@ohos.app.ability.appRecovery';
import errorManager from '@ohos.app.ability.errorManager'; import errorManager from '@ohos.app.ability.errorManager';
let observer = { let observer: errorManager.ErrorObserver = {
onUnhandledException(errorMsg) { onUnhandledException(errorMsg) {
console.log('onUnhandledException, errorMsg: ', errorMsg); console.log('onUnhandledException, errorMsg: ', errorMsg);
appRecovery.restartApp(); appRecovery.restartApp();
...@@ -135,7 +135,7 @@ saveAppState(): boolean; ...@@ -135,7 +135,7 @@ saveAppState(): boolean;
import appRecovery from '@ohos.app.ability.appRecovery'; import appRecovery from '@ohos.app.ability.appRecovery';
import errorManager from '@ohos.app.ability.errorManager'; import errorManager from '@ohos.app.ability.errorManager';
let observer = { let observer: errorManager.ErrorObserver = {
onUnhandledException(errorMsg) { onUnhandledException(errorMsg) {
console.log('onUnhandledException, errorMsg: ', errorMsg); console.log('onUnhandledException, errorMsg: ', errorMsg);
appRecovery.saveAppState(); appRecovery.saveAppState();
...@@ -175,7 +175,7 @@ saveAppState(context?: UIAbilityContext): boolean; ...@@ -175,7 +175,7 @@ saveAppState(context?: UIAbilityContext): boolean;
import appRecovery from '@ohos.app.ability.appRecovery'; import appRecovery from '@ohos.app.ability.appRecovery';
import errorManager from '@ohos.app.ability.errorManager'; import errorManager from '@ohos.app.ability.errorManager';
let observer = { let observer: errorManager.ErrorObserver = {
onUnhandledException(errorMsg) { onUnhandledException(errorMsg) {
console.log('onUnhandledException, errorMsg: ', errorMsg); console.log('onUnhandledException, errorMsg: ', errorMsg);
appRecovery.saveAppState(this.context); appRecovery.saveAppState(this.context);
...@@ -207,12 +207,14 @@ setRestartWant(want: Want): void; ...@@ -207,12 +207,14 @@ setRestartWant(want: Want): void;
```ts ```ts
import appRecovery from '@ohos.app.ability.appRecovery'; import appRecovery from '@ohos.app.ability.appRecovery';
import Want from '@ohos.app.ability.Want';
Button("启动到恢复Ability") Button("启动到恢复Ability")
.fontSize(40) .fontSize(40)
.fontWeight(FontWeight.Bold) .fontWeight(FontWeight.Bold)
.onClick(()=> { .onClick(()=> {
// set restart want // set restart want
let want = { let want: Want = {
bundleName: "ohos.samples.recovery", bundleName: "ohos.samples.recovery",
abilityName: "RecoveryAbility" abilityName: "RecoveryAbility"
}; };
......
...@@ -25,26 +25,56 @@ onApplicationForeground(): void; ...@@ -25,26 +25,56 @@ onApplicationForeground(): void;
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import ApplicationStateChangeCallback from '@ohos.app.ability.ApplicationStateChangeCallback';
// 构造单例对象
export class GlobalContext {
private constructor() {}
private static instance: GlobalContext;
private _objects = new Map<string, Object>();
public static getContext(): GlobalContext {
if (!GlobalContext.instance) {
GlobalContext.instance = new GlobalContext();
}
return GlobalContext.instance;
}
getObject(value: string): Object | undefined {
return this._objects.get(value);
}
globalThis.applicationStateChangeCallback = { setObject(key: string, objectClass: Object): void {
this._objects.set(key, objectClass);
}
}
let applicationStateChangeCallback: ApplicationStateChangeCallback = {
onApplicationForeground() { onApplicationForeground() {
console.info('applicationStateChangeCallback onApplicationForeground'); console.info('applicationStateChangeCallback onApplicationForeground');
} }
} }
GlobalContext.getContext().setObject("applicationStateChangeCallback", applicationStateChangeCallback);
export default class MyAbility extends UIAbility { export default class MyAbility extends UIAbility {
onCreate() { onCreate() {
console.log('MyAbility onCreate'); console.log('MyAbility onCreate');
globalThis.applicationContext = this.context.getApplicationContext(); GlobalContext.getContext().setObject("applicationContext", this.context.getApplicationContext());
// 1.获取applicationContext // 1.获取applicationContext
let applicationContext = globalThis.applicationContext; let applicationContext = GlobalContext.getContext().getObject("applicationContext");
// 2.通过applicationContext注册应用前后台状态监听 // 2.通过applicationContext注册应用前后台状态监听
applicationContext.on('applicationStateChange', globalThis.ApplicationStateChangeCallback); if (applicationContext != undefined) {
applicationContext.on('applicationStateChange',
GlobalContext.getContext().getObject("applicationStateChangeCallback"));
}
} }
onDestroy() { onDestroy() {
let applicationContext = globalThis.applicationContext; let applicationContext = GlobalContext.getContext().getObject("applicationContext");
// 1.通过applicationContext解除注册应用前后台状态监听 // 1.通过applicationContext解除注册应用前后台状态监听
applicationContext.off('applicationStateChange', globalThis.ApplicationStateChangeCallback); if (applicationContext != undefined) {
applicationContext.off('applicationStateChange',
GlobalContext.getContext().getObject("applicationStateChangeCallback"));
}
} }
} }
``` ```
...@@ -61,27 +91,56 @@ onApplicationBackground(): void; ...@@ -61,27 +91,56 @@ onApplicationBackground(): void;
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import ApplicationStateChangeCallback from '@ohos.app.ability.ApplicationStateChangeCallback';
export class GlobalContext {
private constructor() {}
private static instance: GlobalContext;
private _objects = new Map<string, Object>();
public static getContext(): GlobalContext {
if (!GlobalContext.instance) {
GlobalContext.instance = new GlobalContext();
}
return GlobalContext.instance;
}
getObject(value: string): Object | undefined {
return this._objects.get(value);
}
setObject(key: string, objectClass: Object): void {
this._objects.set(key, objectClass);
}
}
globalThis.applicationStateChangeCallback = { let applicationStateChangeCallback: ApplicationStateChangeCallback = {
onApplicationBackground() { onApplicationBackground() {
console.info('applicationStateChangeCallback onApplicationBackground'); console.info('applicationStateChangeCallback onApplicationBackground');
} }
} }
GlobalContext.getContext().setObject("applicationStateChangeCallback", applicationStateChangeCallback);
export default class MyAbility extends UIAbility { export default class MyAbility extends UIAbility {
onCreate() { onCreate() {
console.log('MyAbility onCreate'); console.log('MyAbility onCreate');
globalThis.applicationContext = this.context.getApplicationContext(); GlobalContext.getContext().setObject("applicationContext", this.context.getApplicationContext());
// 1.获取applicationContext // 1.获取applicationContext
let applicationContext = globalThis.applicationContext; let applicationContext = GlobalContext.getContext().getObject("applicationContext");
// 2.通过applicationContext注册应用前后台状态监听 // 2.通过applicationContext注册应用前后台状态监听
applicationContext.on('applicationStateChange', globalThis.ApplicationStateChangeCallback); if (applicationContext != undefined) {
applicationContext.on('applicationStateChange',
GlobalContext.getContext().getObject("applicationStateChangeCallback"));
}
console.log('Resgiter applicationStateChangeCallback'); console.log('Resgiter applicationStateChangeCallback');
} }
onDestroy() { onDestroy() {
let applicationContext = globalThis.applicationContext; let applicationContext = GlobalContext.getContext().getObject("applicationContext");
// 1.通过applicationContext解除注册应用前后台状态监听 // 1.通过applicationContext解除注册应用前后台状态监听
applicationContext.off('applicationStateChange', globalThis.ApplicationStateChangeCallback); if (applicationContext != undefined) {
applicationContext.off('applicationStateChange',
GlobalContext.getContext().getObject("applicationStateChangeCallback"));
}
} }
} }
``` ```
\ No newline at end of file
...@@ -31,10 +31,13 @@ import Configuration from '@ohos.app.ability.Configuration'; ...@@ -31,10 +31,13 @@ import Configuration from '@ohos.app.ability.Configuration';
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import EnvironmentCallback from '@ohos.app.ability.EnvironmentCallback';
import Want from '@ohos.app.ability.Want';
export default class EntryAbility extends UIAbility { export default class EntryAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
let envCallback = { let envCallback: EnvironmentCallback = {
onConfigurationUpdated(config) { onConfigurationUpdated(config) {
console.info(`envCallback onConfigurationUpdated success: ${JSON.stringify(config)}`); console.info(`envCallback onConfigurationUpdated success: ${JSON.stringify(config)}`);
let language = config.language; let language = config.language;
......
...@@ -35,6 +35,8 @@ getId(uri: string): number ...@@ -35,6 +35,8 @@ getId(uri: string): number
**示例:** **示例:**
```ts ```ts
import dataUriUtils from '@ohos.app.ability.dataUriUtils';
try { try {
let id = dataUriUtils.getId('com.example.dataUriUtils/1221'); let id = dataUriUtils.getId('com.example.dataUriUtils/1221');
console.info('get id: ${id}'); console.info('get id: ${id}');
...@@ -69,6 +71,8 @@ attachId(uri: string, id: number): string ...@@ -69,6 +71,8 @@ attachId(uri: string, id: number): string
**示例:** **示例:**
```ts ```ts
import dataUriUtils from '@ohos.app.ability.dataUriUtils';
let id = 1122; let id = 1122;
try { try {
let uri = dataUriUtils.attachId( let uri = dataUriUtils.attachId(
...@@ -107,6 +111,8 @@ deleteId(uri: string): string ...@@ -107,6 +111,8 @@ deleteId(uri: string): string
**示例:** **示例:**
```ts ```ts
import dataUriUtils from '@ohos.app.ability.dataUriUtils';
try { try {
let uri = dataUriUtils.deleteId('com.example.dataUriUtils/1221'); let uri = dataUriUtils.deleteId('com.example.dataUriUtils/1221');
console.info('delete id with the uri is: ${uri}'); console.info('delete id with the uri is: ${uri}');
...@@ -142,6 +148,7 @@ updateId(uri: string, id: number): string ...@@ -142,6 +148,7 @@ updateId(uri: string, id: number): string
**示例:** **示例:**
```ts ```ts
import dataUriUtils from '@ohos.app.ability.dataUriUtils';
try { try {
let id = 1122; let id = 1122;
......
...@@ -38,17 +38,18 @@ getRequestInfo(want: Want): RequestInfo ...@@ -38,17 +38,18 @@ getRequestInfo(want: Want): RequestInfo
```ts ```ts
import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility'; import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
import dialogRequest from '@ohos.app.ability.dialogRequest'; import dialogRequest from '@ohos.app.ability.dialogRequest';
const REQUEST_VALUE = 1; const REQUEST_VALUE = 1;
class StubTest extends rpc.RemoteObject { class StubTest extends rpc.RemoteObject {
constructor(des) { constructor(des: string) {
super(des); super(des);
} }
onRemoteRequest(code, data, reply, option) { onRemoteRequest(code: number, data: rpc.MessageParcel, reply: rpc.MessageParcel, option: rpc.MessageOption) {
if (code === REQUEST_VALUE) { if (code === REQUEST_VALUE) {
let optFir = data.readInt(); let optFir = data.readInt();
let optSec = data.readInt(); let optSec = data.readInt();
...@@ -57,10 +58,6 @@ getRequestInfo(want: Want): RequestInfo ...@@ -57,10 +58,6 @@ getRequestInfo(want: Want): RequestInfo
return true; return true;
} }
queryLocallInterface(descriptor) {
return null;
}
getInterfaceDescriptor() { getInterfaceDescriptor() {
return ""; return "";
} }
...@@ -73,32 +70,32 @@ getRequestInfo(want: Want): RequestInfo ...@@ -73,32 +70,32 @@ getRequestInfo(want: Want): RequestInfo
return REQUEST_VALUE; return REQUEST_VALUE;
} }
attachLocalInterface(localInterface, descriptor) { attachLocalInterface(localInterface: rpc.IRemoteBroker, descriptor: string) {
} }
} }
let TAG = "getRequestInfoTest"; let TAG = "getRequestInfoTest";
export default class ServiceExtAbility extends ServiceExtensionAbility { export default class ServiceExtAbility extends ServiceExtensionAbility {
onCreate(want) { onCreate(want: Want) {
console.info(TAG, `onCreate, want: ${want.abilityName}`); console.info(TAG, `onCreate, want: ${want.abilityName}`);
} }
onRequest(want, startId) { onRequest(want: Want, startId: number) {
console.info(TAG, `onRequest, want: ${want.abilityName}`); console.info(TAG, `onRequest, want: ${want.abilityName}`);
try { try {
var requestInfo = dialogRequest.getRequestInfo(want); let requestInfo = dialogRequest.getRequestInfo(want);
} catch (err) { } catch (err) {
console.error('getRequestInfo err= ${JSON.stringify(err)}'); console.error('getRequestInfo err= ${JSON.stringify(err)}');
} }
} }
onConnect(want) { onConnect(want: Want) {
console.info(TAG, `onConnect, want: ${want.abilityName}`); console.info(TAG, `onConnect, want: ${want.abilityName}`);
return new StubTest("test"); return new StubTest("test");
} }
onDisconnect(want) { onDisconnect(want: Want) {
console.info(TAG, `onDisconnect, want: ${want.abilityName}`); console.info(TAG, `onDisconnect, want: ${want.abilityName}`);
} }
...@@ -132,6 +129,7 @@ getRequestCallback(want: Want): RequestCallback ...@@ -132,6 +129,7 @@ getRequestCallback(want: Want): RequestCallback
```ts ```ts
import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility'; import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
import dialogRequest from '@ohos.app.ability.dialogRequest'; import dialogRequest from '@ohos.app.ability.dialogRequest';
...@@ -140,11 +138,11 @@ getRequestCallback(want: Want): RequestCallback ...@@ -140,11 +138,11 @@ getRequestCallback(want: Want): RequestCallback
const REQUEST_VALUE = 1; const REQUEST_VALUE = 1;
class StubTest extends rpc.RemoteObject { class StubTest extends rpc.RemoteObject {
constructor(des) { constructor(des: string) {
super(des); super(des);
} }
onRemoteRequest(code, data, reply, option) { onRemoteRequest(code: number, data: rpc.MessageParcel, reply: rpc.MessageParcel, option: rpc.MessageOption) {
if (code === REQUEST_VALUE) { if (code === REQUEST_VALUE) {
let optFir = data.readInt(); let optFir = data.readInt();
let optSec = data.readInt(); let optSec = data.readInt();
...@@ -153,10 +151,6 @@ getRequestCallback(want: Want): RequestCallback ...@@ -153,10 +151,6 @@ getRequestCallback(want: Want): RequestCallback
return true; return true;
} }
queryLocallInterface(descriptor) {
return null;
}
getInterfaceDescriptor() { getInterfaceDescriptor() {
return ""; return "";
} }
...@@ -169,30 +163,30 @@ getRequestCallback(want: Want): RequestCallback ...@@ -169,30 +163,30 @@ getRequestCallback(want: Want): RequestCallback
return REQUEST_VALUE; return REQUEST_VALUE;
} }
attachLocalInterface(localInterface, descriptor) { attachLocalInterface(localInterface: rpc.IRemoteBroker, descriptor: string) {
} }
} }
export default class ServiceExtAbility extends ServiceExtensionAbility { export default class ServiceExtAbility extends ServiceExtensionAbility {
onCreate(want) { onCreate(want: Want) {
console.info(TAG, `onCreate, want: ${want.abilityName}`); console.info(TAG, `onCreate, want: ${want.abilityName}`);
} }
onRequest(want, startId) { onRequest(want: Want, startId: number) {
console.info(TAG, `onRequest, want: ${want.abilityName}`); console.info(TAG, `onRequest, want: ${want.abilityName}`);
try { try {
var requestCallback = dialogRequest.getRequestCallback(want); let requestCallback = dialogRequest.getRequestCallback(want);
} catch(err) { } catch(err) {
console.error('getRequestInfo err= ${JSON.stringify(err)}'); console.error('getRequestInfo err= ${JSON.stringify(err)}');
} }
} }
onConnect(want) { onConnect(want: Want) {
console.info(TAG, `onConnect, want: ${want.abilityName}`); console.info(TAG, `onConnect, want: ${want.abilityName}`);
return new StubTest("test"); return new StubTest("test");
} }
onDisconnect(want) { onDisconnect(want: Want) {
console.info(TAG, `onDisconnect, want: ${want.abilityName}`); console.info(TAG, `onDisconnect, want: ${want.abilityName}`);
} }
...@@ -211,6 +205,8 @@ getRequestCallback(want: Want): RequestCallback ...@@ -211,6 +205,8 @@ getRequestCallback(want: Want): RequestCallback
```ts ```ts
import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility'; import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
import dialogRequest from '@ohos.app.ability.dialogRequest'; import dialogRequest from '@ohos.app.ability.dialogRequest';
import window from '@ohos.window'; import window from '@ohos.window';
...@@ -220,11 +216,11 @@ getRequestCallback(want: Want): RequestCallback ...@@ -220,11 +216,11 @@ getRequestCallback(want: Want): RequestCallback
const REQUEST_VALUE = 1; const REQUEST_VALUE = 1;
class StubTest extends rpc.RemoteObject { class StubTest extends rpc.RemoteObject {
constructor(des) { constructor(des: string) {
super(des); super(des);
} }
onRemoteRequest(code, data, reply, option) { onRemoteRequest(code: number, data: rpc.MessageParcel, reply: rpc.MessageParcel, option: rpc.MessageOption) {
if (code === REQUEST_VALUE) { if (code === REQUEST_VALUE) {
let optFir = data.readInt(); let optFir = data.readInt();
let optSec = data.readInt(); let optSec = data.readInt();
...@@ -233,10 +229,6 @@ getRequestCallback(want: Want): RequestCallback ...@@ -233,10 +229,6 @@ getRequestCallback(want: Want): RequestCallback
return true; return true;
} }
queryLocallInterface(descriptor) {
return null;
}
getInterfaceDescriptor() { getInterfaceDescriptor() {
return ""; return "";
} }
...@@ -249,41 +241,48 @@ getRequestCallback(want: Want): RequestCallback ...@@ -249,41 +241,48 @@ getRequestCallback(want: Want): RequestCallback
return REQUEST_VALUE; return REQUEST_VALUE;
} }
attachLocalInterface(localInterface, descriptor) { attachLocalInterface(localInterface: rpc.IRemoteBroker, descriptor: string) {
} }
} }
export default class ServiceExtAbility extends ServiceExtensionAbility { export default class ServiceExtAbility extends ServiceExtensionAbility {
onCreate(want) { onCreate(want: Want) {
console.info(TAG, `onCreate, want: ${want.abilityName}`); console.info(TAG, `onCreate, want: ${want.abilityName}`);
} }
onRequest(want, startId) { onRequest(want: Want, startId: number) {
console.info(TAG, `onRequest, want: ${want.abilityName}`); console.info(TAG, `onRequest, want: ${want.abilityName}`);
let windowClass: window.Window | undefined = undefined;
let config: window.Configuration = {name: "dialogWindow", windowType: window.WindowType.TYPE_DIALOG, ctx: this.context};
try { try {
var requestInfo = dialogRequest.getRequestInfo(want); let requestInfo = dialogRequest.getRequestInfo(want);
let windowClass = null; window.createWindow(config, (err, data) => {
windowClass.bindDialogTarget(requestInfo, () => { if (err.code) {
console.error('Failed to create the window. Cause: ' + JSON.stringify(err));
return;
}
windowClass = data;
windowClass.bindDialogTarget(requestInfo, () => {
console.info('Dialog Window Need Destroy.'); console.info('Dialog Window Need Destroy.');
}, (err) => { }, (err: BusinessError) => {
if (err.code) { if (err.code) {
console.error('Failed to bind dialog target. Cause: ${JSON.stringify(err)}'); console.error('Failed to bind dialog target. Cause: ${JSON.stringify(err)}');
return; return;
} }
console.info('Succeeded in binding dialog target.'); console.info('Succeeded in binding dialog target.');
});
}); });
} catch(err) { } catch(err) {
console.error('getRequestInfo err= ${JSON.stringify(err)}'); console.error('getRequestInfo err= ${JSON.stringify(err)}');
} }
} }
onConnect(want) { onConnect(want: Want) {
console.info(TAG, `onConnect, want: ${want.abilityName}`); console.info(TAG, `onConnect, want: ${want.abilityName}`);
return new StubTest("test"); return new StubTest("test");
} }
onDisconnect(want) { onDisconnect(want: Want) {
console.info(TAG, `onDisconnect, want: ${want.abilityName}`); console.info(TAG, `onDisconnect, want: ${want.abilityName}`);
} }
...@@ -345,6 +344,7 @@ setRequestResult(result: RequestResult): void; ...@@ -345,6 +344,7 @@ setRequestResult(result: RequestResult): void;
```ts ```ts
import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility'; import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
import dialogRequest from '@ohos.app.ability.dialogRequest'; import dialogRequest from '@ohos.app.ability.dialogRequest';
...@@ -353,11 +353,11 @@ setRequestResult(result: RequestResult): void; ...@@ -353,11 +353,11 @@ setRequestResult(result: RequestResult): void;
const REQUEST_VALUE = 1; const REQUEST_VALUE = 1;
class StubTest extends rpc.RemoteObject { class StubTest extends rpc.RemoteObject {
constructor(des) { constructor(des: string) {
super(des); super(des);
} }
onRemoteRequest(code, data, reply, option) { onRemoteRequest(code: number, data: rpc.MessageParcel, reply: rpc.MessageParcel, option: rpc.MessageOption) {
if (code === REQUEST_VALUE) { if (code === REQUEST_VALUE) {
let optFir = data.readInt(); let optFir = data.readInt();
let optSec = data.readInt(); let optSec = data.readInt();
...@@ -366,10 +366,6 @@ setRequestResult(result: RequestResult): void; ...@@ -366,10 +366,6 @@ setRequestResult(result: RequestResult): void;
return true; return true;
} }
queryLocallInterface(descriptor) {
return null;
}
getInterfaceDescriptor() { getInterfaceDescriptor() {
return ""; return "";
} }
...@@ -382,20 +378,20 @@ setRequestResult(result: RequestResult): void; ...@@ -382,20 +378,20 @@ setRequestResult(result: RequestResult): void;
return REQUEST_VALUE; return REQUEST_VALUE;
} }
attachLocalInterface(localInterface, descriptor) { attachLocalInterface(localInterface: rpc.IRemoteBroker, descriptor: string) {
} }
} }
export default class ServiceExtAbility extends ServiceExtensionAbility { export default class ServiceExtAbility extends ServiceExtensionAbility {
onCreate(want) { onCreate(want: Want) {
console.info(TAG, `onCreate, want: ${want.abilityName}`); console.info(TAG, `onCreate, want: ${want.abilityName}`);
} }
onRequest(want, startId) { onRequest(want: Want, startId: number) {
console.info(TAG, `onRequest, want: ${want.abilityName}`); console.info(TAG, `onRequest, want: ${want.abilityName}`);
try { try {
var requestCallback = dialogRequest.getRequestCallback(want); let requestCallback = dialogRequest.getRequestCallback(want);
let myResult = { let myResult: dialogRequest.RequestResult = {
result : dialogRequest.ResultCode.RESULT_CANCEL, result : dialogRequest.ResultCode.RESULT_CANCEL,
}; };
requestCallback.setRequestResult(myResult); requestCallback.setRequestResult(myResult);
...@@ -404,12 +400,12 @@ setRequestResult(result: RequestResult): void; ...@@ -404,12 +400,12 @@ setRequestResult(result: RequestResult): void;
} }
} }
onConnect(want) { onConnect(want: Want) {
console.info(TAG, `onConnect, want: ${want.abilityName}`); console.info(TAG, `onConnect, want: ${want.abilityName}`);
return new StubTest("test"); return new StubTest("test");
} }
onDisconnect(want) { onDisconnect(want: Want) {
console.info(TAG, `onDisconnect, want: ${want.abilityName}`); console.info(TAG, `onDisconnect, want: ${want.abilityName}`);
} }
......
...@@ -46,15 +46,15 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void; ...@@ -46,15 +46,15 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
**示例:** **示例:**
```ts ```ts
import UIAbility from '@ohos.app.ability.Ability'; import UIAbility from '@ohos.app.ability.UIAbility';
import EnvironmentCallback from '@ohos.app.ability.EnvironmentCallback';
let callbackId; let callbackId: number;
export default class MyAbility extends UIAbility { export default class MyAbility extends UIAbility {
onCreate() { onCreate() {
console.log('MyAbility onCreate'); console.log('MyAbility onCreate');
globalThis.applicationContext = this.context.getApplicationContext(); let environmentCallback: EnvironmentCallback = {
let environmentCallback = {
onConfigurationUpdated(config){ onConfigurationUpdated(config){
console.log('onConfigurationUpdated config: ${JSON.stringify(config)}'); console.log('onConfigurationUpdated config: ${JSON.stringify(config)}');
}, },
...@@ -64,14 +64,14 @@ export default class MyAbility extends UIAbility { ...@@ -64,14 +64,14 @@ export default class MyAbility extends UIAbility {
} }
}; };
// 1.获取applicationContext // 1.获取applicationContext
let applicationContext = globalThis.applicationContext; let applicationContext = this.context.getApplicationContext();
// 2.通过applicationContext注册监听应用内生命周期 // 2.通过applicationContext注册监听应用内生命周期
callbackId = applicationContext.registerEnvironmentCallback(environmentCallback); callbackId = applicationContext.on('environmentEvent', environmentCallback);
console.log('registerEnvironmentCallback number: ${JSON.stringify(callbackId)}'); console.log('registerEnvironmentCallback number: ${JSON.stringify(callbackId)}');
} }
onDestroy() { onDestroy() {
let applicationContext = globalThis.applicationContext; let applicationContext = this.context.getApplicationContext();
applicationContext.unregisterEnvironmentCallback(callbackId, (error, data) => { applicationContext.off('environment', callbackId, (error, data) => {
if (error && error.code !== 0) { if (error && error.code !== 0) {
console.error('unregisterEnvironmentCallback fail, error: ${JSON.stringify(error)}'); console.error('unregisterEnvironmentCallback fail, error: ${JSON.stringify(error)}');
} else { } else {
......
...@@ -47,7 +47,10 @@ on(type: 'error', observer: ErrorObserver): number; ...@@ -47,7 +47,10 @@ on(type: 'error', observer: ErrorObserver): number;
**示例:** **示例:**
```ts ```ts
let observer = { import errorManager from '@ohos.app.ability.errorManager';
import { BusinessError } from '@ohos.base';
let observer: errorManager.ErrorObserver = {
onUnhandledException(errorMsg) { onUnhandledException(errorMsg) {
console.log('onUnhandledException, errorMsg: ', errorMsg); console.log('onUnhandledException, errorMsg: ', errorMsg);
}, },
...@@ -63,7 +66,9 @@ let observerId = -1; ...@@ -63,7 +66,9 @@ let observerId = -1;
try { try {
observerId = errorManager.on('error', observer); observerId = errorManager.on('error', observer);
} catch (paramError) { } catch (paramError) {
console.error(`error: ${paramError.code}, ${paramError.message}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message}`);
} }
``` ```
...@@ -98,9 +103,12 @@ off(type: 'error', observerId: number, callback: AsyncCallback\<void>): void; ...@@ -98,9 +103,12 @@ off(type: 'error', observerId: number, callback: AsyncCallback\<void>): void;
**示例:** **示例:**
```ts ```ts
import errorManager from '@ohos.app.ability.errorManager';
import { BusinessError } from '@ohos.base';
let observerId = 100; let observerId = 100;
function unregisterErrorObserverCallback(err) { function unregisterErrorObserverCallback(err: BusinessError) {
if (err) { if (err) {
console.error('------------ unregisterErrorObserverCallback ------------', err); console.error('------------ unregisterErrorObserverCallback ------------', err);
} }
...@@ -108,7 +116,9 @@ function unregisterErrorObserverCallback(err) { ...@@ -108,7 +116,9 @@ function unregisterErrorObserverCallback(err) {
try { try {
errorManager.off('error', observerId, unregisterErrorObserverCallback); errorManager.off('error', observerId, unregisterErrorObserverCallback);
} catch (paramError) { } catch (paramError) {
console.error(`error: ${paramError.code}, ${paramError.message}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message}`);
} }
``` ```
...@@ -148,17 +158,22 @@ off(type: 'error', observerId: number): Promise\<void>; ...@@ -148,17 +158,22 @@ off(type: 'error', observerId: number): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import errorManager from '@ohos.app.ability.errorManager';
import { BusinessError } from '@ohos.base';
let observerId = 100; let observerId = 100;
try { try {
errorManager.off('error', observerId) errorManager.off('error', observerId)
.then((data) => { .then((data) => {
console.log('----------- unregisterErrorObserver success ----------', data); console.log('----------- unregisterErrorObserver success ----------', data);
}) })
.catch((err) => { .catch((err: BusinessError) => {
console.error('----------- unregisterErrorObserver fail ----------', err); console.error('----------- unregisterErrorObserver fail ----------', err);
}); });
} catch (paramError) { } catch (paramError) {
console.error(`error: ${paramError.code}, ${paramError.message}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message}`);
} }
``` ```
...@@ -195,7 +210,10 @@ on(type: 'errorEvent', observer: ErrorObserver): number; ...@@ -195,7 +210,10 @@ on(type: 'errorEvent', observer: ErrorObserver): number;
**示例:** **示例:**
```ts ```ts
let observer = { import errorManager from '@ohos.app.ability.errorManager';
import { BusinessError } from '@ohos.base';
let observer: errorManager.ErrorObserver = {
onUnhandledException(errorMsg) { onUnhandledException(errorMsg) {
console.log('onUnhandledException, errorMsg: ', errorMsg); console.log('onUnhandledException, errorMsg: ', errorMsg);
}, },
...@@ -211,7 +229,9 @@ let observerId = -1; ...@@ -211,7 +229,9 @@ let observerId = -1;
try { try {
observerId = errorManager.on('errorEvent', observer); observerId = errorManager.on('errorEvent', observer);
} catch (paramError) { } catch (paramError) {
console.error(`error: ${paramError.code}, ${paramError.message}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message}`);
} }
``` ```
...@@ -242,12 +262,17 @@ off(type: 'errorEvent', observerId: number): void; ...@@ -242,12 +262,17 @@ off(type: 'errorEvent', observerId: number): void;
**示例:** **示例:**
```ts ```ts
import errorManager from '@ohos.app.ability.errorManager';
import { BusinessError } from '@ohos.base';
let observerId = 100; let observerId = 100;
try { try {
errorManager.off('errorEvent', observerId); errorManager.off('errorEvent', observerId);
} catch (paramError) { } catch (paramError) {
console.error(`error: ${paramError.code}, ${paramError.message}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message}`);
} }
``` ```
<!--no_check--> <!--no_check-->
\ No newline at end of file
...@@ -78,6 +78,8 @@ applyQuickFix(hapModuleQuickFixFiles: Array\<string>, callback: AsyncCallback\<v ...@@ -78,6 +78,8 @@ applyQuickFix(hapModuleQuickFixFiles: Array\<string>, callback: AsyncCallback\<v
**示例:** **示例:**
```ts ```ts
import quickFixManager from '@ohos.app.ability.quickFixManager';
try { try {
let hapModuleQuickFixFiles = ['/data/storage/el2/base/entry.hqf']; let hapModuleQuickFixFiles = ['/data/storage/el2/base/entry.hqf'];
quickFixManager.applyQuickFix(hapModuleQuickFixFiles, (error) => { quickFixManager.applyQuickFix(hapModuleQuickFixFiles, (error) => {
...@@ -130,11 +132,14 @@ applyQuickFix(hapModuleQuickFixFiles: Array\<string>): Promise\<void>; ...@@ -130,11 +132,14 @@ applyQuickFix(hapModuleQuickFixFiles: Array\<string>): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import quickFixManager from '@ohos.app.ability.quickFixManager';
import { BusinessError } from '@ohos.base';
let hapModuleQuickFixFiles = ['/data/storage/el2/base/entry.hqf']; let hapModuleQuickFixFiles = ['/data/storage/el2/base/entry.hqf'];
try { try {
quickFixManager.applyQuickFix(hapModuleQuickFixFiles).then(() => { quickFixManager.applyQuickFix(hapModuleQuickFixFiles).then(() => {
console.info('applyQuickFix success'); console.info('applyQuickFix success');
}).catch((error) => { }).catch((error: BusinessError) => {
console.error(`applyQuickFix err: ${error}`); console.error(`applyQuickFix err: ${error}`);
}); });
} catch (paramError) { } catch (paramError) {
...@@ -173,6 +178,8 @@ getApplicationQuickFixInfo(bundleName: string, callback: AsyncCallback\<Applicat ...@@ -173,6 +178,8 @@ getApplicationQuickFixInfo(bundleName: string, callback: AsyncCallback\<Applicat
**示例:** **示例:**
```ts ```ts
import quickFixManager from '@ohos.app.ability.quickFixManager';
try { try {
let bundleName = 'bundleName'; let bundleName = 'bundleName';
quickFixManager.getApplicationQuickFixInfo(bundleName, (error, data) => { quickFixManager.getApplicationQuickFixInfo(bundleName, (error, data) => {
...@@ -223,11 +230,14 @@ getApplicationQuickFixInfo(bundleName: string): Promise\<ApplicationQuickFixInfo ...@@ -223,11 +230,14 @@ getApplicationQuickFixInfo(bundleName: string): Promise\<ApplicationQuickFixInfo
**示例:** **示例:**
```ts ```ts
import quickFixManager from '@ohos.app.ability.quickFixManager';
import { BusinessError } from '@ohos.base';
try { try {
let bundleName = 'bundleName'; let bundleName = 'bundleName';
quickFixManager.getApplicationQuickFixInfo(bundleName).then((data) => { quickFixManager.getApplicationQuickFixInfo(bundleName).then((data) => {
console.info(`getApplicationQuickFixInfo success: ${data}`); console.info(`getApplicationQuickFixInfo success: ${data}`);
}).catch((error) => { }).catch((error: BusinessError) => {
console.error(`getApplicationQuickFixInfo err: ${error}`); console.error(`getApplicationQuickFixInfo err: ${error}`);
}); });
} catch (paramError) { } catch (paramError) {
...@@ -268,6 +278,8 @@ revokeQuickFix(bundleName: string, callback: AsyncCallback\<void>): void; ...@@ -268,6 +278,8 @@ revokeQuickFix(bundleName: string, callback: AsyncCallback\<void>): void;
**示例:** **示例:**
```ts ```ts
import quickFixManager from '@ohos.app.ability.quickFixManager';
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
quickFixManager.revokeQuickFix(bundleName, (err) => { quickFixManager.revokeQuickFix(bundleName, (err) => {
console.info("revokeQuickFix " + bundleName + " " + JSON.stringify(err)); console.info("revokeQuickFix " + bundleName + " " + JSON.stringify(err));
...@@ -312,10 +324,13 @@ revokeQuickFix(bundleName: string): Promise\<void>; ...@@ -312,10 +324,13 @@ revokeQuickFix(bundleName: string): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import quickFixManager from '@ohos.app.ability.quickFixManager';
import { BusinessError } from '@ohos.base';
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
quickFixManager.revokeQuickFix(bundleName).then(() => { quickFixManager.revokeQuickFix(bundleName).then(() => {
console.info("revokeQuickFix " + bundleName +" ok"); console.info("revokeQuickFix " + bundleName +" ok");
}).catch((err) => { }).catch((err: BusinessError) => {
console.info("revokeQuickFix " + bundleName +" failed, error code is ", JSON.stringify((err))); console.info("revokeQuickFix " + bundleName +" failed, error code is ", JSON.stringify((err)));
}); });
``` ```
\ No newline at end of file
...@@ -48,8 +48,11 @@ Extension生命周期回调,在创建时回调,执行初始化业务逻辑 ...@@ -48,8 +48,11 @@ Extension生命周期回调,在创建时回调,执行初始化业务逻辑
**示例:** **示例:**
```ts ```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
onCreate(want) { onCreate(want: Want) {
console.log('onCreate, want: ${want.abilityName}'); console.log('onCreate, want: ${want.abilityName}');
} }
} }
...@@ -69,6 +72,8 @@ Extension生命周期回调,在销毁时回调,执行资源清理等操作 ...@@ -69,6 +72,8 @@ Extension生命周期回调,在销毁时回调,执行资源清理等操作
**示例:** **示例:**
```ts ```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
onDestroy() { onDestroy() {
console.log('onDestroy'); console.log('onDestroy');
...@@ -97,8 +102,11 @@ Extension生命周期回调,如果是startAbility或者startServiceExtensionAb ...@@ -97,8 +102,11 @@ Extension生命周期回调,如果是startAbility或者startServiceExtensionAb
**示例:** **示例:**
```ts ```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
onRequest(want, startId) { onRequest(want: Want, startId: number) {
console.log('onRequest, want: ${want.abilityName}'); console.log('onRequest, want: ${want.abilityName}');
} }
} }
...@@ -131,15 +139,18 @@ Extension生命周期回调,如果是connectAbility拉起的服务,会在onC ...@@ -131,15 +139,18 @@ Extension生命周期回调,如果是connectAbility拉起的服务,会在onC
```ts ```ts
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
class StubTest extends rpc.RemoteObject{ class StubTest extends rpc.RemoteObject{
constructor(des) { constructor(des: string) {
super(des); super(des);
} }
onConnect(code, data, reply, option) { onConnect(code: number, data: rpc.MessageSequence, reply: rpc.MessageSequence, option: rpc.MessageOption) {
} }
} }
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
onConnect(want) { onConnect(want: Want) {
console.log('onConnect , want: ${want.abilityName}'); console.log('onConnect , want: ${want.abilityName}');
return new StubTest('test'); return new StubTest('test');
} }
...@@ -150,11 +161,14 @@ Extension生命周期回调,如果是connectAbility拉起的服务,会在onC ...@@ -150,11 +161,14 @@ Extension生命周期回调,如果是connectAbility拉起的服务,会在onC
```ts ```ts
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
class StubTest extends rpc.RemoteObject{ class StubTest extends rpc.RemoteObject{
constructor(des) { constructor(des: string) {
super(des); super(des);
} }
onConnect(code, data, reply, option) { onConnect(code: number, data: rpc.MessageSequence, reply: rpc.MessageSequence, option: rpc.MessageOption) {
} }
} }
async function getDescriptor() { async function getDescriptor() {
...@@ -162,7 +176,7 @@ async function getDescriptor() { ...@@ -162,7 +176,7 @@ async function getDescriptor() {
return "asyncTest" return "asyncTest"
} }
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
async onConnect(want) { async onConnect(want: Want) {
console.log(`onConnect , want: ${want.abilityName}`); console.log(`onConnect , want: ${want.abilityName}`);
let descriptor = await getDescriptor(); let descriptor = await getDescriptor();
return new StubTest(descriptor); return new StubTest(descriptor);
...@@ -189,8 +203,11 @@ Extension的生命周期回调,客户端执行断开连接服务时回调。 ...@@ -189,8 +203,11 @@ Extension的生命周期回调,客户端执行断开连接服务时回调。
**示例:** **示例:**
```ts ```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
onDisconnect(want) { onDisconnect(want: Want) {
console.log('onDisconnect, want: ${want.abilityName}'); console.log('onDisconnect, want: ${want.abilityName}');
} }
} }
...@@ -199,8 +216,11 @@ Extension的生命周期回调,客户端执行断开连接服务时回调。 ...@@ -199,8 +216,11 @@ Extension的生命周期回调,客户端执行断开连接服务时回调。
在执行完onDisconnect生命周期回调后,应用可能会退出,从而可能导致onDisconnect中的异步函数未能正确执行,比如异步写入数据库。可以使用异步生命周期,以确保异步onDisconnect完成后再继续后续的生命周期。 在执行完onDisconnect生命周期回调后,应用可能会退出,从而可能导致onDisconnect中的异步函数未能正确执行,比如异步写入数据库。可以使用异步生命周期,以确保异步onDisconnect完成后再继续后续的生命周期。
```ts ```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
async onDisconnect(want) { async onDisconnect(want: Want) {
console.log('onDisconnect, want: ${want.abilityName}'); console.log('onDisconnect, want: ${want.abilityName}');
// 调用异步函数... // 调用异步函数...
} }
...@@ -226,8 +246,11 @@ Extension的生命周期回调,当所有以前的客户端都断开连接之 ...@@ -226,8 +246,11 @@ Extension的生命周期回调,当所有以前的客户端都断开连接之
**示例:** **示例:**
```ts ```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
onReconnect(want) { onReconnect(want: Want) {
console.log('onReconnect, want: ${want.abilityName}'); console.log('onReconnect, want: ${want.abilityName}');
} }
} }
...@@ -252,8 +275,11 @@ onConfigurationUpdate(newConfig: Configuration): void; ...@@ -252,8 +275,11 @@ onConfigurationUpdate(newConfig: Configuration): void;
**示例:** **示例:**
```ts ```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import { Configuration } from '@ohos.app.ability.Configuration';
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
onConfigurationUpdate(config) { onConfigurationUpdate(config: Configuration) {
console.log('onConfigurationUpdate, config: ${JSON.stringify(config)}'); console.log('onConfigurationUpdate, config: ${JSON.stringify(config)}');
} }
} }
...@@ -278,8 +304,10 @@ onDump(params: Array\<string>): Array\<string>; ...@@ -278,8 +304,10 @@ onDump(params: Array\<string>): Array\<string>;
**示例:** **示例:**
```ts ```ts
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
class ServiceExt extends ServiceExtension { class ServiceExt extends ServiceExtension {
onDump(params) { onDump(params: Array<string>) {
console.log('dump, params: ${JSON.stringify(params)}'); console.log('dump, params: ${JSON.stringify(params)}');
return ['params']; return ['params'];
} }
......
...@@ -26,6 +26,8 @@ import StartOptions from '@ohos.app.ability.StartOptions'; ...@@ -26,6 +26,8 @@ import StartOptions from '@ohos.app.ability.StartOptions';
```ts ```ts
import missionManager from '@ohos.app.ability.missionManager'; import missionManager from '@ohos.app.ability.missionManager';
import StartOptions from '@ohos.app.ability.StartOptions';
import { BusinessError } from '@ohos.base';
try { try {
missionManager.getMissionInfos('', 10, (error, missions) => { missionManager.getMissionInfos('', 10, (error, missions) => {
...@@ -37,7 +39,7 @@ import StartOptions from '@ohos.app.ability.StartOptions'; ...@@ -37,7 +39,7 @@ import StartOptions from '@ohos.app.ability.StartOptions';
console.log(`missions = ${JSON.stringify(missions)}`); console.log(`missions = ${JSON.stringify(missions)}`);
let id = missions[0].missionId; let id = missions[0].missionId;
let startOptions = { let startOptions: StartOptions = {
windowMode : 101, windowMode : 101,
displayId: 0 displayId: 0
}; };
...@@ -46,6 +48,8 @@ import StartOptions from '@ohos.app.ability.StartOptions'; ...@@ -46,6 +48,8 @@ import StartOptions from '@ohos.app.ability.StartOptions';
}); });
}); });
} catch (paramError) { } catch (paramError) {
console.error(`error: ${paramError.code}, ${paramError.message}`); let code = (paramError as BusinessError).code;
let message = (paramError as BusinessError).message;
console.error(`error: ${code}, ${message}`);
} }
``` ```
...@@ -35,12 +35,14 @@ import Want from '@ohos.app.ability.Want'; ...@@ -35,12 +35,14 @@ import Want from '@ohos.app.ability.Want';
```ts ```ts
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let want = { let want: Want = {
'deviceId': '', // deviceId为空表示本设备 deviceId: '', // deviceId为空表示本设备
'bundleName': 'com.example.myapplication', bundleName: 'com.example.myapplication',
'abilityName': 'FuncAbility', abilityName: 'FuncAbility',
'moduleName': 'entry' // moduleName非必选 moduleName: 'entry' // moduleName非必选
}; };
context.startAbility(want, (err) => { context.startAbility(want, (err) => {
...@@ -54,8 +56,10 @@ import Want from '@ohos.app.ability.Want'; ...@@ -54,8 +56,10 @@ import Want from '@ohos.app.ability.Want';
* 字符串(String) * 字符串(String)
```ts ```ts
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let want = { let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility', abilityName: 'FuncAbility',
parameters: { parameters: {
...@@ -70,8 +74,10 @@ import Want from '@ohos.app.ability.Want'; ...@@ -70,8 +74,10 @@ import Want from '@ohos.app.ability.Want';
* 数字(Number) * 数字(Number)
```ts ```ts
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let want = { let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility', abilityName: 'FuncAbility',
parameters: { parameters: {
...@@ -87,8 +93,10 @@ import Want from '@ohos.app.ability.Want'; ...@@ -87,8 +93,10 @@ import Want from '@ohos.app.ability.Want';
* 布尔(Boolean) * 布尔(Boolean)
```ts ```ts
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let want = { let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility', abilityName: 'FuncAbility',
parameters: { parameters: {
...@@ -103,8 +111,10 @@ import Want from '@ohos.app.ability.Want'; ...@@ -103,8 +111,10 @@ import Want from '@ohos.app.ability.Want';
* 对象(Object) * 对象(Object)
```ts ```ts
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let want = { let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility', abilityName: 'FuncAbility',
parameters: { parameters: {
...@@ -124,8 +134,10 @@ import Want from '@ohos.app.ability.Want'; ...@@ -124,8 +134,10 @@ import Want from '@ohos.app.ability.Want';
* 数组(Array) * 数组(Array)
```ts ```ts
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let want = { let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility', abilityName: 'FuncAbility',
parameters: { parameters: {
...@@ -142,23 +154,27 @@ import Want from '@ohos.app.ability.Want'; ...@@ -142,23 +154,27 @@ import Want from '@ohos.app.ability.Want';
``` ```
* 文件描述符(FD) * 文件描述符(FD)
```ts ```ts
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let fd; let fd: number = 0;
try { try {
fd = fs.openSync('/data/storage/el2/base/haps/pic.png').fd; fd = fs.openSync('/data/storage/el2/base/haps/pic.png').fd;
} catch(err) { } catch(err) {
console.error(`Failed to openSync. Code: ${err.code}, message: ${err.message}`); let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
console.error(`Failed to openSync. Code: ${code}, message: ${message}`);
} }
let want = { let want: Want = {
'deviceId': '', // deviceId为空表示本设备 deviceId: '', // deviceId为空表示本设备
'bundleName': 'com.example.myapplication', bundleName: 'com.example.myapplication',
'abilityName': 'FuncAbility', abilityName: 'FuncAbility',
'moduleName': 'entry', // moduleName非必选 moduleName: 'entry', // moduleName非必选
'parameters': { parameters: {
'keyFd': { 'type': 'FD', 'value': fd } // {'type':'FD', 'value':fd}是固定用法,用于表示该数据是FD 'keyFd': { 'type': 'FD', 'value': fd } // {'type':'FD', 'value':fd}是固定用法,用于表示该数据是FD
} }
}; };
...@@ -172,8 +188,10 @@ import Want from '@ohos.app.ability.Want'; ...@@ -172,8 +188,10 @@ import Want from '@ohos.app.ability.Want';
```ts ```ts
// (1) UIAbility1启动一个ServiceExtension // (1) UIAbility1启动一个ServiceExtension
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext
let want = { let want: Want = {
bundleName: 'com.example.myapplication1', bundleName: 'com.example.myapplication1',
abilityName: 'ServiceExtensionAbility', abilityName: 'ServiceExtensionAbility',
}; };
...@@ -184,8 +202,11 @@ import Want from '@ohos.app.ability.Want'; ...@@ -184,8 +202,11 @@ import Want from '@ohos.app.ability.Want';
```ts ```ts
// (2) 该ServiceExtension去启动另一个UIAbility2,并在启动的时候携带参数ability.params.backToOtherMissionStack为true // (2) 该ServiceExtension去启动另一个UIAbility2,并在启动的时候携带参数ability.params.backToOtherMissionStack为true
let context ; // ServiceExtensionContext import common from '@ohos.app.ability.common';
let want = { import Want from '@ohos.app.ability.Want';
let context = getContext(this) as common.ServiceExtensionContext; // ServiceExtensionContext
let want: Want = {
bundleName: 'com.example.myapplication2', bundleName: 'com.example.myapplication2',
abilityName: 'MainAbility', abilityName: 'MainAbility',
parameters: { parameters: {
......
...@@ -39,10 +39,14 @@ getWantAgent(info: WantAgentInfo, callback: AsyncCallback\<WantAgent\>): void ...@@ -39,10 +39,14 @@ getWantAgent(info: WantAgentInfo, callback: AsyncCallback\<WantAgent\>): void
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -62,7 +66,7 @@ let wantAgentInfo = { ...@@ -62,7 +66,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -70,7 +74,7 @@ let wantAgentInfo = { ...@@ -70,7 +74,7 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
...@@ -118,9 +122,13 @@ getWantAgent(info: WantAgentInfo): Promise\<WantAgent\> ...@@ -118,9 +122,13 @@ getWantAgent(info: WantAgentInfo): Promise\<WantAgent\>
**示例:** **示例:**
```ts ```ts
let wantAgent; import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -140,7 +148,7 @@ let wantAgentInfo = { ...@@ -140,7 +148,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -150,7 +158,7 @@ let wantAgentInfo = { ...@@ -150,7 +158,7 @@ let wantAgentInfo = {
try { try {
WantAgent.getWantAgent(wantAgentInfo).then((data) => { WantAgent.getWantAgent(wantAgentInfo).then((data) => {
wantAgent = data; wantAgent = data;
}).catch((err) => { }).catch((err: BusinessError) => {
console.error('getWantAgent failed! ${err.code} ${err.message}'); console.error('getWantAgent failed! ${err.code} ${err.message}');
}); });
} catch (err) { } catch (err) {
...@@ -187,10 +195,14 @@ getBundleName(agent: WantAgent, callback: AsyncCallback\<string\>): void ...@@ -187,10 +195,14 @@ getBundleName(agent: WantAgent, callback: AsyncCallback\<string\>): void
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -210,7 +222,7 @@ let wantAgentInfo = { ...@@ -210,7 +222,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -218,14 +230,14 @@ let wantAgentInfo = { ...@@ -218,14 +230,14 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
console.error('getWantAgent failed ${JSON.stringify(wantAgent)}'); console.error('getWantAgent failed ${JSON.stringify(wantAgent)}');
} }
//getBundleName回调 //getBundleName回调
function getBundleNameCallback(err, data) { let getBundleNameCallback = (err: BusinessError, data: string) => {
if(err) { if(err) {
console.error('getBundleName failed! ${err.code} ${err.message}'); console.error('getBundleName failed! ${err.code} ${err.message}');
} else { } else {
...@@ -279,10 +291,14 @@ getBundleName(agent: WantAgent): Promise\<string\> ...@@ -279,10 +291,14 @@ getBundleName(agent: WantAgent): Promise\<string\>
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -302,7 +318,7 @@ let wantAgentInfo = { ...@@ -302,7 +318,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -310,7 +326,7 @@ let wantAgentInfo = { ...@@ -310,7 +326,7 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
...@@ -319,7 +335,7 @@ function getWantAgentCallback(err, data) { ...@@ -319,7 +335,7 @@ function getWantAgentCallback(err, data) {
try { try {
WantAgent.getBundleName(wantAgent).then((data)=>{ WantAgent.getBundleName(wantAgent).then((data)=>{
console.info('getBundleName ok! ${JSON.stringify(data)}'); console.info('getBundleName ok! ${JSON.stringify(data)}');
}).catch((err)=>{ }).catch((err: BusinessError)=>{
console.error('getBundleName failed! ${err.code} ${err.message}'); console.error('getBundleName failed! ${err.code} ${err.message}');
}); });
} catch(err){ } catch(err){
...@@ -362,11 +378,14 @@ getUid(agent: WantAgent, callback: AsyncCallback\<number\>): void ...@@ -362,11 +378,14 @@ getUid(agent: WantAgent, callback: AsyncCallback\<number\>): void
**示例:** **示例:**
```ts ```ts
import WantAgent from '@ohos.app.ability.wantAgent'; import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -386,7 +405,7 @@ let wantAgentInfo = { ...@@ -386,7 +405,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -394,14 +413,14 @@ let wantAgentInfo = { ...@@ -394,14 +413,14 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
console.info('getWantAgent failed ${JSON.stringify(err)}'); console.info('getWantAgent failed ${JSON.stringify(err)}');
} }
//getUid回调 //getUid回调
function getUidCallback(err, data) { let getUidCallback = (err: BusinessError, data: number) => {
if(err) { if(err) {
console.error('getUid failed! ${err.code} ${err.message}'); console.error('getUid failed! ${err.code} ${err.message}');
} else { } else {
...@@ -455,10 +474,14 @@ getUid(agent: WantAgent): Promise\<number\> ...@@ -455,10 +474,14 @@ getUid(agent: WantAgent): Promise\<number\>
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -478,7 +501,7 @@ let wantAgentInfo = { ...@@ -478,7 +501,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -486,7 +509,7 @@ let wantAgentInfo = { ...@@ -486,7 +509,7 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
...@@ -495,7 +518,7 @@ function getWantAgentCallback(err, data) { ...@@ -495,7 +518,7 @@ function getWantAgentCallback(err, data) {
try { try {
WantAgent.getUid(wantAgent).then((data)=>{ WantAgent.getUid(wantAgent).then((data)=>{
console.info('getUid ok! ${JSON.stringify(data)}'); console.info('getUid ok! ${JSON.stringify(data)}');
}).catch((err)=>{ }).catch((err: BusinessError)=>{
console.error('getUid failed! ${err.code} ${err.message}'); console.error('getUid failed! ${err.code} ${err.message}');
}); });
} catch(err){ } catch(err){
...@@ -540,10 +563,14 @@ getWant(agent: WantAgent, callback: AsyncCallback\<Want\>): void ...@@ -540,10 +563,14 @@ getWant(agent: WantAgent, callback: AsyncCallback\<Want\>): void
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -563,7 +590,7 @@ let wantAgentInfo = { ...@@ -563,7 +590,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -571,14 +598,14 @@ let wantAgentInfo = { ...@@ -571,14 +598,14 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
console.error('getWantAgent failed ${JSON.stringify(wantAgent)}'); console.error('getWantAgent failed ${JSON.stringify(wantAgent)}');
} }
//getWant回调 //getWant回调
function getWantCallback(err, data) { let getWantCallback = (err: BusinessError, data: Want) => {
if(err) { if(err) {
console.error('getWant failed! ${err.code} ${err.message}'); console.error('getWant failed! ${err.code} ${err.message}');
} else { } else {
...@@ -635,10 +662,14 @@ getWant(agent: WantAgent): Promise\<Want\> ...@@ -635,10 +662,14 @@ getWant(agent: WantAgent): Promise\<Want\>
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -658,7 +689,7 @@ let wantAgentInfo = { ...@@ -658,7 +689,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -666,7 +697,7 @@ let wantAgentInfo = { ...@@ -666,7 +697,7 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
...@@ -675,7 +706,7 @@ function getWantAgentCallback(err, data) { ...@@ -675,7 +706,7 @@ function getWantAgentCallback(err, data) {
try { try {
WantAgent.getUid(wantAgent).then((data)=>{ WantAgent.getUid(wantAgent).then((data)=>{
console.info('getUid ok! ${JSON.stringify(data)}'); console.info('getUid ok! ${JSON.stringify(data)}');
}).catch((err)=>{ }).catch((err: BusinessError)=>{
console.error('getUid failed! ${err.code} ${err.message}'); console.error('getUid failed! ${err.code} ${err.message}');
}); });
} catch(err){ } catch(err){
...@@ -718,10 +749,14 @@ cancel(agent: WantAgent, callback: AsyncCallback\<void\>): void ...@@ -718,10 +749,14 @@ cancel(agent: WantAgent, callback: AsyncCallback\<void\>): void
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -741,7 +776,7 @@ let wantAgentInfo = { ...@@ -741,7 +776,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -749,14 +784,14 @@ let wantAgentInfo = { ...@@ -749,14 +784,14 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
console.error('getWantAgent failed ${JSON.stringify(wantAgent)}'); console.error('getWantAgent failed ${JSON.stringify(wantAgent)}');
} }
//cancel回调 //cancel回调
function cancelCallback(err, data) { let cancelCallback = (err: BusinessError, data: void) => {
if(err) { if(err) {
console.error('cancel failed! ${err.code} ${err.message}'); console.error('cancel failed! ${err.code} ${err.message}');
} else { } else {
...@@ -810,10 +845,14 @@ cancel(agent: WantAgent): Promise\<void\> ...@@ -810,10 +845,14 @@ cancel(agent: WantAgent): Promise\<void\>
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -833,7 +872,7 @@ let wantAgentInfo = { ...@@ -833,7 +872,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -841,7 +880,7 @@ let wantAgentInfo = { ...@@ -841,7 +880,7 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
...@@ -850,7 +889,7 @@ function getWantAgentCallback(err, data) { ...@@ -850,7 +889,7 @@ function getWantAgentCallback(err, data) {
try { try {
WantAgent.cancel(wantAgent).then((data)=>{ WantAgent.cancel(wantAgent).then((data)=>{
console.info('cancel ok!'); console.info('cancel ok!');
}).catch((err)=>{ }).catch((err: BusinessError)=>{
console.error('cancel failed! ${err.code} ${err.message}'); console.error('cancel failed! ${err.code} ${err.message}');
}); });
} catch(err){ } catch(err){
...@@ -883,14 +922,18 @@ trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: AsyncCallback\<Co ...@@ -883,14 +922,18 @@ trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: AsyncCallback\<Co
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
// triggerInfo // triggerInfo
let triggerInfo = { let triggerInfo: WantAgent.TriggerInfo = {
code: 0 //自定义义结果码 code: 0 //自定义义结果码
}; };
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -910,7 +953,7 @@ let wantAgentInfo = { ...@@ -910,7 +953,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -918,14 +961,14 @@ let wantAgentInfo = { ...@@ -918,14 +961,14 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
console.error('getWantAgent failed ${JSON.stringify(wantAgent)}'); console.error('getWantAgent failed ${JSON.stringify(wantAgent)}');
} }
//trigger回调 //trigger回调
function triggerCallback(err, data) { let triggerCallback = (err: BusinessError, data: WantAgent.CompleteData) => {
if(err) { if(err) {
console.error('getUid failed! ${err.code} ${err.message}'); console.error('getUid failed! ${err.code} ${err.message}');
} else { } else {
...@@ -966,11 +1009,15 @@ equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback\<boolean\ ...@@ -966,11 +1009,15 @@ equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback\<boolean\
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent1; let wantAgent1: _WantAgent;
let wantAgent2; let wantAgent2: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -990,7 +1037,7 @@ let wantAgentInfo = { ...@@ -990,7 +1037,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -998,7 +1045,7 @@ let wantAgentInfo = { ...@@ -998,7 +1045,7 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent1 = data; wantAgent1 = data;
wantAgent2 = data; wantAgent2 = data;
...@@ -1006,7 +1053,7 @@ function getWantAgentCallback(err, data) { ...@@ -1006,7 +1053,7 @@ function getWantAgentCallback(err, data) {
console.error('getWantAgent failed ${JSON.stringify(wantAgent)}'); console.error('getWantAgent failed ${JSON.stringify(wantAgent)}');
} }
//equal回调 //equal回调
function equalCallback(err, data) { let equalCallback = (err: BusinessError, data: boolean) => {
if(err) { if(err) {
console.error('equal failed! ${err.code} ${err.message}'); console.error('equal failed! ${err.code} ${err.message}');
} else { } else {
...@@ -1052,11 +1099,15 @@ equal(agent: WantAgent, otherAgent: WantAgent): Promise\<boolean\> ...@@ -1052,11 +1099,15 @@ equal(agent: WantAgent, otherAgent: WantAgent): Promise\<boolean\>
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent1; let wantAgent1: _WantAgent;
let wantAgent2; let wantAgent2: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -1076,7 +1127,7 @@ let wantAgentInfo = { ...@@ -1076,7 +1127,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -1084,7 +1135,7 @@ let wantAgentInfo = { ...@@ -1084,7 +1135,7 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent1 = data; wantAgent1 = data;
wantAgent2 = data; wantAgent2 = data;
...@@ -1094,7 +1145,7 @@ function getWantAgentCallback(err, data) { ...@@ -1094,7 +1145,7 @@ function getWantAgentCallback(err, data) {
try { try {
WantAgent.equal(wantAgent1,wantAgent2).then((data)=>{ WantAgent.equal(wantAgent1,wantAgent2).then((data)=>{
console.info('equal ok! ${JSON.stringify(data)}'); console.info('equal ok! ${JSON.stringify(data)}');
}).catch((err)=>{ }).catch((err: BusinessError)=>{
console.error('equal failed! ${err.code} ${err.message}'); console.error('equal failed! ${err.code} ${err.message}');
}) })
} catch(err){ } catch(err){
...@@ -1136,10 +1187,14 @@ getOperationType(agent: WantAgent, callback: AsyncCallback\<number>): void; ...@@ -1136,10 +1187,14 @@ getOperationType(agent: WantAgent, callback: AsyncCallback\<number>): void;
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -1159,7 +1214,7 @@ let wantAgentInfo = { ...@@ -1159,7 +1214,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -1167,14 +1222,14 @@ let wantAgentInfo = { ...@@ -1167,14 +1222,14 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
console.error('getWantAgent failed ${JSON.stringify(wantAgent)}'); console.error('getWantAgent failed ${JSON.stringify(wantAgent)}');
} }
//getOperationTypeCallback回调 //getOperationTypeCallback回调
function getOperationTypeCallback(err, data) { let getOperationTypeCallback = (err: BusinessError, data: number) => {
if(err) { if(err) {
console.error('getOperationType failed! ${err.code} ${err.message}'); console.error('getOperationType failed! ${err.code} ${err.message}');
} else { } else {
...@@ -1227,10 +1282,14 @@ getOperationType(agent: WantAgent): Promise\<number>; ...@@ -1227,10 +1282,14 @@ getOperationType(agent: WantAgent): Promise\<number>;
**示例:** **示例:**
```ts ```ts
import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
//wantAgent对象 //wantAgent对象
let wantAgent; let wantAgent: _WantAgent;
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: WantAgent.WantAgentInfo = {
wants: [ wants: [
{ {
deviceId: 'deviceId', deviceId: 'deviceId',
...@@ -1250,7 +1309,7 @@ let wantAgentInfo = { ...@@ -1250,7 +1309,7 @@ let wantAgentInfo = {
mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
mykey6: true, mykey6: true,
} }
} } as Want
], ],
operationType: WantAgent.OperationType.START_ABILITIES, operationType: WantAgent.OperationType.START_ABILITIES,
requestCode: 0, requestCode: 0,
...@@ -1258,7 +1317,7 @@ let wantAgentInfo = { ...@@ -1258,7 +1317,7 @@ let wantAgentInfo = {
}; };
//getWantAgent回调 //getWantAgent回调
function getWantAgentCallback(err, data) { function getWantAgentCallback(err: BusinessError, data: _WantAgent) {
if (err === undefined) { if (err === undefined) {
wantAgent = data; wantAgent = data;
} else { } else {
...@@ -1267,7 +1326,7 @@ function getWantAgentCallback(err, data) { ...@@ -1267,7 +1326,7 @@ function getWantAgentCallback(err, data) {
try { try {
WantAgent.getOperationType(wantAgent).then((data)=>{ WantAgent.getOperationType(wantAgent).then((data)=>{
console.info('getOperationType ok! ${JSON.stringify(data)}'); console.info('getOperationType ok! ${JSON.stringify(data)}');
}).catch((err)=>{ }).catch((err: BusinessError) => {
console.error('getOperationType failed! ${err.code} ${err.message}'); console.error('getOperationType failed! ${err.code} ${err.message}');
}); });
} catch(err){ } catch(err){
......
...@@ -21,9 +21,10 @@ import StaticSubscriberExtensionContext from '@ohos.application.StaticSubscriber ...@@ -21,9 +21,10 @@ import StaticSubscriberExtensionContext from '@ohos.application.StaticSubscriber
```ts ```ts
import StaticSubscriberExtensionAbility from '@ohos.application.StaticSubscriberExtensionAbility' import StaticSubscriberExtensionAbility from '@ohos.application.StaticSubscriberExtensionAbility'
import StaticSubscriberExtensionContext from '@ohos.application.StaticSubscriberExtensionContext'
export default class MyStaticSubscriberExtensionAbility extends StaticSubscriberExtensionAbility { export default class MyStaticSubscriberExtensionAbility extends StaticSubscriberExtensionAbility {
context = this.context; context: StaticSubscriberExtensionContext = this.context;
}; };
``` ```
...@@ -73,13 +74,16 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void; ...@@ -73,13 +74,16 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: "com.example.myapp", bundleName: "com.example.myapp",
abilityName: "MyAbility" abilityName: "MyAbility"
}; };
try { try {
this.context.startAbility(want, (error) => { this.context.startAbility(want, (error: BusinessError) => {
if (error) { if (error) {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('startAbility failed, error.code: ' + JSON.stringify(error.code) + console.log('startAbility failed, error.code: ' + JSON.stringify(error.code) +
...@@ -91,8 +95,10 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void; ...@@ -91,8 +95,10 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
}); });
} catch (paramError) { } catch (paramError) {
// 处理入参错误异常 // 处理入参错误异常
console.log('startAbility failed, error.code: ' + JSON.stringify(paramError.code) + let code = (paramError as BusinessError).code;
' error.message: ' + JSON.stringify(paramError.message)); let message = (paramError as BusinessError).message;
console.log('startAbility failed, error.code: ' + JSON.stringify(code) +
' error.message: ' + JSON.stringify(message));
} }
``` ```
...@@ -147,7 +153,10 @@ startAbility(want: Want): Promise&lt;void&gt;; ...@@ -147,7 +153,10 @@ startAbility(want: Want): Promise&lt;void&gt;;
**示例:** **示例:**
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
bundleName: "com.example.myapp", bundleName: "com.example.myapp",
abilityName: "MyAbility" abilityName: "MyAbility"
}; };
...@@ -158,14 +167,16 @@ startAbility(want: Want): Promise&lt;void&gt;; ...@@ -158,14 +167,16 @@ startAbility(want: Want): Promise&lt;void&gt;;
// 执行正常业务 // 执行正常业务
console.log('startAbility succeed'); console.log('startAbility succeed');
}) })
.catch((error) => { .catch((error: BusinessError) => {
// 处理业务逻辑错误 // 处理业务逻辑错误
console.log('startAbility failed, error.code: ' + JSON.stringify(error.code) + console.log('startAbility failed, error.code: ' + JSON.stringify(error.code) +
' error.message: ' + JSON.stringify(error.message)); ' error.message: ' + JSON.stringify(error.message));
}); });
} catch (paramError) { } catch (paramError) {
// 处理入参错误异常 // 处理入参错误异常
console.log('startAbility failed, error.code: ' + JSON.stringify(paramError.code) + let code = (paramError as BusinessError).code;
' error.message: ' + JSON.stringify(paramError.message)); let message = (paramError as BusinessError).message;
console.log('startAbility failed, error.code: ' + JSON.stringify(code) +
' error.message: ' + JSON.stringify(message));
} }
``` ```
\ No newline at end of file
...@@ -43,9 +43,9 @@ getAbilityDelegator(): AbilityDelegator ...@@ -43,9 +43,9 @@ getAbilityDelegator(): AbilityDelegator
**示例:** **示例:**
```ts ```ts
let abilityDelegator; import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry';
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
``` ```
## AbilityDelegatorRegistry.getArguments ## AbilityDelegatorRegistry.getArguments
...@@ -65,6 +65,8 @@ getArguments(): AbilityDelegatorArgs ...@@ -65,6 +65,8 @@ getArguments(): AbilityDelegatorArgs
**示例:** **示例:**
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry';
let args = AbilityDelegatorRegistry.getArguments(); let args = AbilityDelegatorRegistry.getArguments();
console.info('getArguments bundleName: ${args.bundleName}'); console.info('getArguments bundleName: ${args.bundleName}');
console.info('getArguments testCaseNames: ${args.testCaseNames}'); console.info('getArguments testCaseNames: ${args.testCaseNames}');
......
...@@ -49,7 +49,10 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void ...@@ -49,7 +49,10 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void
**示例** **示例**
```ts ```ts
let config = { import abilityManager from '@ohos.application.abilityManager';
import { Configuration } from '@ohos.application.Configuration';
let config: Configuration = {
language: 'chinese' language: 'chinese'
}; };
...@@ -83,13 +86,17 @@ updateConfiguration(config: Configuration): Promise\<void> ...@@ -83,13 +86,17 @@ updateConfiguration(config: Configuration): Promise\<void>
**示例** **示例**
```ts ```ts
let config = { import abilityManager from '@ohos.application.abilityManager';
import { Configuration } from '@ohos.application.Configuration';
import { BusinessError } from '@ohos.base';
let config: Configuration = {
language: 'chinese' language: 'chinese'
}; };
abilityManager.updateConfiguration(config).then(() => { abilityManager.updateConfiguration(config).then(() => {
console.log('updateConfiguration success'); console.log('updateConfiguration success');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error('updateConfiguration fail'); console.error('updateConfiguration fail');
}); });
``` ```
...@@ -113,6 +120,8 @@ getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): vo ...@@ -113,6 +120,8 @@ getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): vo
**示例** **示例**
```ts ```ts
import abilityManager from '@ohos.application.abilityManager';
abilityManager.getAbilityRunningInfos((err,data) => { abilityManager.getAbilityRunningInfos((err,data) => {
console.log('getAbilityRunningInfos err: ${err}, data: ${JSON.stringify(data)}'); console.log('getAbilityRunningInfos err: ${err}, data: ${JSON.stringify(data)}');
}); });
...@@ -137,9 +146,12 @@ getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>> ...@@ -137,9 +146,12 @@ getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>>
**示例** **示例**
```ts ```ts
import abilityManager from '@ohos.application.abilityManager';
import { BusinessError } from '@ohos.base';
abilityManager.getAbilityRunningInfos().then((data) => { abilityManager.getAbilityRunningInfos().then((data) => {
console.log('getAbilityRunningInfos data: ${JSON.stringify(data)}'); console.log('getAbilityRunningInfos data: ${JSON.stringify(data)}');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error('getAbilityRunningInfos err: ${JSON.stringify(err)}'); console.error('getAbilityRunningInfos err: ${JSON.stringify(err)}');
}); });
``` ```
\ No newline at end of file
...@@ -29,6 +29,8 @@ static isRunningInStabilityTest(callback: AsyncCallback&lt;boolean&gt;): void ...@@ -29,6 +29,8 @@ static isRunningInStabilityTest(callback: AsyncCallback&lt;boolean&gt;): void
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
appManager.isRunningInStabilityTest((error, flag) => { appManager.isRunningInStabilityTest((error, flag) => {
if (error && error.code !== 0) { if (error && error.code !== 0) {
console.error('isRunningInStabilityTest fail, error: ${JSON.stringify(error)}'); console.error('isRunningInStabilityTest fail, error: ${JSON.stringify(error)}');
...@@ -56,9 +58,12 @@ static isRunningInStabilityTest(): Promise&lt;boolean&gt; ...@@ -56,9 +58,12 @@ static isRunningInStabilityTest(): Promise&lt;boolean&gt;
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
appManager.isRunningInStabilityTest().then((flag) => { appManager.isRunningInStabilityTest().then((flag) => {
console.log('The result of isRunningInStabilityTest is: ${JSON.stringify(flag)}'); console.log('The result of isRunningInStabilityTest is: ${JSON.stringify(flag)}');
}).catch((error) => { }).catch((error: BusinessError) => {
console.error('error: ${JSON.stringify(error)}'); console.error('error: ${JSON.stringify(error)}');
}); });
``` ```
...@@ -81,9 +86,12 @@ isRamConstrainedDevice(): Promise\<boolean>; ...@@ -81,9 +86,12 @@ isRamConstrainedDevice(): Promise\<boolean>;
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
appManager.isRamConstrainedDevice().then((data) => { appManager.isRamConstrainedDevice().then((data) => {
console.log('The result of isRamConstrainedDevice is: ${JSON.stringify(data)}'); console.log('The result of isRamConstrainedDevice is: ${JSON.stringify(data)}');
}).catch((error) => { }).catch((error: BusinessError) => {
console.error('error: ${JSON.stringify(error)}'); console.error('error: ${JSON.stringify(error)}');
}); });
``` ```
...@@ -105,6 +113,8 @@ isRamConstrainedDevice(callback: AsyncCallback\<boolean>): void; ...@@ -105,6 +113,8 @@ isRamConstrainedDevice(callback: AsyncCallback\<boolean>): void;
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
appManager.isRamConstrainedDevice((error, data) => { appManager.isRamConstrainedDevice((error, data) => {
if (error && error.code !== 0) { if (error && error.code !== 0) {
console.error('isRamConstrainedDevice fail, error: ${JSON.stringify(error)}'); console.error('isRamConstrainedDevice fail, error: ${JSON.stringify(error)}');
...@@ -131,9 +141,12 @@ getAppMemorySize(): Promise\<number>; ...@@ -131,9 +141,12 @@ getAppMemorySize(): Promise\<number>;
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
appManager.getAppMemorySize().then((data) => { appManager.getAppMemorySize().then((data) => {
console.log('The size of app memory is: ${JSON.stringify(data)}'); console.log('The size of app memory is: ${JSON.stringify(data)}');
}).catch((error) => { }).catch((error: BusinessError) => {
console.error('error: ${JSON.stringify(error)}'); console.error('error: ${JSON.stringify(error)}');
}); });
``` ```
...@@ -155,6 +168,8 @@ getAppMemorySize(callback: AsyncCallback\<number>): void; ...@@ -155,6 +168,8 @@ getAppMemorySize(callback: AsyncCallback\<number>): void;
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
appManager.getAppMemorySize((error, data) => { appManager.getAppMemorySize((error, data) => {
if (error && error.code !== 0) { if (error && error.code !== 0) {
console.error('getAppMemorySize fail, error: ${JSON.stringify(error)}'); console.error('getAppMemorySize fail, error: ${JSON.stringify(error)}');
...@@ -184,9 +199,12 @@ getProcessRunningInfos(): Promise\<Array\<ProcessRunningInfo>>; ...@@ -184,9 +199,12 @@ getProcessRunningInfos(): Promise\<Array\<ProcessRunningInfo>>;
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
appManager.getProcessRunningInfos().then((data) => { appManager.getProcessRunningInfos().then((data) => {
console.log('The process running infos is: ${JSON.stringify(data)}'); console.log('The process running infos is: ${JSON.stringify(data)}');
}).catch((error) => { }).catch((error: BusinessError) => {
console.error('error: ${JSON.stringify(error)}'); console.error('error: ${JSON.stringify(error)}');
}); });
``` ```
...@@ -212,6 +230,8 @@ getProcessRunningInfos(callback: AsyncCallback\<Array\<ProcessRunningInfo>>): vo ...@@ -212,6 +230,8 @@ getProcessRunningInfos(callback: AsyncCallback\<Array\<ProcessRunningInfo>>): vo
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
appManager.getProcessRunningInfos((error, data) => { appManager.getProcessRunningInfos((error, data) => {
if (error && error.code !== 0) { if (error && error.code !== 0) {
console.error('getProcessRunningInfos fail, error: ${JSON.stringify(error)}'); console.error('getProcessRunningInfos fail, error: ${JSON.stringify(error)}');
...@@ -242,7 +262,9 @@ registerApplicationStateObserver(observer: ApplicationStateObserver): number; ...@@ -242,7 +262,9 @@ registerApplicationStateObserver(observer: ApplicationStateObserver): number;
**示例:** **示例:**
```ts ```ts
let applicationStateObserver = { import appManager from '@ohos.application.appManager';
const observerCode = appManager.registerApplicationStateObserver({
onForegroundApplicationChanged(appStateData) { onForegroundApplicationChanged(appStateData) {
console.log('------------ onForegroundApplicationChanged -----------', appStateData); console.log('------------ onForegroundApplicationChanged -----------', appStateData);
}, },
...@@ -258,8 +280,7 @@ registerApplicationStateObserver(observer: ApplicationStateObserver): number; ...@@ -258,8 +280,7 @@ registerApplicationStateObserver(observer: ApplicationStateObserver): number;
onProcessStateChanged(processData) { onProcessStateChanged(processData) {
console.log('------------ onProcessStateChanged -----------', processData); console.log('------------ onProcessStateChanged -----------', processData);
} }
}; });
const observerCode = appManager.registerApplicationStateObserver(applicationStateObserver);
console.log('-------- observerCode: ---------', observerCode); console.log('-------- observerCode: ---------', observerCode);
``` ```
...@@ -285,9 +306,12 @@ unregisterApplicationStateObserver(observerId: number, callback: AsyncCallback\ ...@@ -285,9 +306,12 @@ unregisterApplicationStateObserver(observerId: number, callback: AsyncCallback\
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let observerId = 100; let observerId = 100;
function unregisterApplicationStateObserverCallback(err) { function unregisterApplicationStateObserverCallback(err: BusinessError) {
if (err) { if (err) {
console.error('------------ unregisterApplicationStateObserverCallback ------------', err); console.error('------------ unregisterApplicationStateObserverCallback ------------', err);
} }
...@@ -322,13 +346,16 @@ unregisterApplicationStateObserver(observerId: number): Promise\<void>; ...@@ -322,13 +346,16 @@ unregisterApplicationStateObserver(observerId: number): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let observerId = 100; let observerId = 100;
appManager.unregisterApplicationStateObserver(observerId) appManager.unregisterApplicationStateObserver(observerId)
.then((data) => { .then((data) => {
console.log('----------- unregisterApplicationStateObserver success ----------', data); console.log('----------- unregisterApplicationStateObserver success ----------', data);
}) })
.catch((err) => { .catch((err: BusinessError) => {
console.error('----------- unregisterApplicationStateObserver fail ----------', err); console.error('----------- unregisterApplicationStateObserver fail ----------', err);
}); });
``` ```
...@@ -354,14 +381,15 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void; ...@@ -354,14 +381,15 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void;
**示例:** **示例:**
```ts ```ts
function getForegroundApplicationsCallback(err, data) { import appManager from '@ohos.application.appManager';
appManager.getForegroundApplications((err, data) => {
if (err) { if (err) {
console.error('--------- getForegroundApplicationsCallback fail ---------', err); console.error('--------- getForegroundApplicationsCallback fail ---------', err);
} else { } else {
console.log('--------- getForegroundApplicationsCallback success ---------', data); console.log('--------- getForegroundApplicationsCallback success ---------', data);
} }
} });
appManager.getForegroundApplications(getForegroundApplicationsCallback);
``` ```
## appManager.getForegroundApplications<sup>8+</sup> ## appManager.getForegroundApplications<sup>8+</sup>
...@@ -385,11 +413,14 @@ getForegroundApplications(): Promise\<Array\<AppStateData>>; ...@@ -385,11 +413,14 @@ getForegroundApplications(): Promise\<Array\<AppStateData>>;
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
appManager.getForegroundApplications() appManager.getForegroundApplications()
.then((data) => { .then((data) => {
console.log('--------- getForegroundApplications success -------', data); console.log('--------- getForegroundApplications success -------', data);
}) })
.catch((err) => { .catch((err: BusinessError) => {
console.error('--------- getForegroundApplications fail -------', err); console.error('--------- getForegroundApplications fail -------', err);
}); });
``` ```
...@@ -420,13 +451,16 @@ killProcessWithAccount(bundleName: string, accountId: number): Promise\<void\> ...@@ -420,13 +451,16 @@ killProcessWithAccount(bundleName: string, accountId: number): Promise\<void\>
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName'; let bundleName = 'bundleName';
let accountId = 0; let accountId = 0;
appManager.killProcessWithAccount(bundleName, accountId) appManager.killProcessWithAccount(bundleName, accountId)
.then((data) => { .then((data) => {
console.log('------------ killProcessWithAccount success ------------', data); console.log('------------ killProcessWithAccount success ------------', data);
}) })
.catch((err) => { .catch((err: BusinessError) => {
console.error('------------ killProcessWithAccount fail ------------', err); console.error('------------ killProcessWithAccount fail ------------', err);
}); });
``` ```
...@@ -459,9 +493,12 @@ killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCal ...@@ -459,9 +493,12 @@ killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCal
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName'; let bundleName = 'bundleName';
let accountId = 0; let accountId = 0;
function killProcessWithAccountCallback(err, data) { function killProcessWithAccountCallback(err: BusinessError, data: void) {
if (err) { if (err) {
console.error('------------- killProcessWithAccountCallback fail, err: --------------', err); console.error('------------- killProcessWithAccountCallback fail, err: --------------', err);
} else { } else {
...@@ -493,8 +530,11 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>); ...@@ -493,8 +530,11 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>);
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName'; let bundleName = 'bundleName';
function killProcessesByBundleNameCallback(err, data) { function killProcessesByBundleNameCallback(err: BusinessError, data: void) {
if (err) { if (err) {
console.error('------------- killProcessesByBundleNameCallback fail, err: --------------', err); console.error('------------- killProcessesByBundleNameCallback fail, err: --------------', err);
} else { } else {
...@@ -531,12 +571,15 @@ killProcessesByBundleName(bundleName: string): Promise\<void>; ...@@ -531,12 +571,15 @@ killProcessesByBundleName(bundleName: string): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'com.example.myapplication'; let bundleName = 'com.example.myapplication';
appManager.killProcessesByBundleName(bundleName) appManager.killProcessesByBundleName(bundleName)
.then((data) => { .then((data) => {
console.log('------------ killProcessesByBundleName success ------------', data); console.log('------------ killProcessesByBundleName success ------------', data);
}) })
.catch((err) => { .catch((err: BusinessError) => {
console.error('------------ killProcessesByBundleName fail ------------', err); console.error('------------ killProcessesByBundleName fail ------------', err);
}); });
``` ```
...@@ -563,8 +606,11 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>); ...@@ -563,8 +606,11 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>);
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName'; let bundleName = 'bundleName';
function clearUpApplicationDataCallback(err, data) { function clearUpApplicationDataCallback(err: BusinessError, data: void) {
if (err) { if (err) {
console.error('------------- clearUpApplicationDataCallback fail, err: --------------', err); console.error('------------- clearUpApplicationDataCallback fail, err: --------------', err);
} else { } else {
...@@ -601,12 +647,15 @@ clearUpApplicationData(bundleName: string): Promise\<void>; ...@@ -601,12 +647,15 @@ clearUpApplicationData(bundleName: string): Promise\<void>;
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager';
import { BusinessError } from '@ohos.base';
let bundleName = 'bundleName'; let bundleName = 'bundleName';
appManager.clearUpApplicationData(bundleName) appManager.clearUpApplicationData(bundleName)
.then((data) => { .then((data) => {
console.log('------------ clearUpApplicationData success ------------', data); console.log('------------ clearUpApplicationData success ------------', data);
}) })
.catch((err) => { .catch((err: BusinessError) => {
console.error('------------ clearUpApplicationData fail ------------', err); console.error('------------ clearUpApplicationData fail ------------', err);
}); });
``` ```
\ No newline at end of file
...@@ -25,17 +25,20 @@ import Configuration from '@ohos.application.Configuration'; ...@@ -25,17 +25,20 @@ import Configuration from '@ohos.application.Configuration';
**示例:** **示例:**
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import EnvironmentCallback from '@ohos.app.ability.EnvironmentCallback';
import Want from '@ohos.app.ability.Want';
import Window from '@ohos.window'; import Window from '@ohos.window';
export default class EntryAbility extends UIAbility { export default class EntryAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
} }
onDestroy() { onDestroy() {
} }
onWindowStageCreate(windowStage: Window.WindowStage) { onWindowStageCreate(windowStage: Window.WindowStage) {
let envCallback = { let envCallback: EnvironmentCallback = {
onConfigurationUpdated(config) { onConfigurationUpdated(config) {
console.info(`envCallback onConfigurationUpdated success: ${JSON.stringify(config)}`); console.info(`envCallback onConfigurationUpdated success: ${JSON.stringify(config)}`);
let language = config.language; let language = config.language;
......
...@@ -43,17 +43,18 @@ registerMissionListener(listener: MissionListener): number; ...@@ -43,17 +43,18 @@ registerMissionListener(listener: MissionListener): number;
**示例:** **示例:**
```ts ```ts
let listener = { import missionManager from '@ohos.application.missionManager';
onMissionCreated: function (mission) {console.log('--------onMissionCreated-------');},
onMissionDestroyed: function (mission) {console.log('--------onMissionDestroyed-------');},
onMissionSnapshotChanged: function (mission) {console.log('--------onMissionSnapshotChanged-------');},
onMissionMovedToFront: function (mission) {console.log('--------onMissionMovedToFront-------');},
onMissionIconUpdated: function (mission, icon) {console.log('--------onMissionIconUpdated-------');},
onMissionClosed: function (mission) {console.log('--------onMissionClosed-------');},
onMissionLabelUpdated: function (mission) {console.log('--------onMissionLabelUpdated-------');}
};
console.log('registerMissionListener'); console.log('registerMissionListener');
let listenerid = missionManager.registerMissionListener(listener); let listenerid = missionManager.registerMissionListener({
onMissionCreated: (mission) => {console.log('--------onMissionCreated-------');},
onMissionDestroyed: (mission) => {console.log('--------onMissionDestroyed-------');},
onMissionSnapshotChanged: (mission) => {console.log('--------onMissionSnapshotChanged-------');},
onMissionMovedToFront: (mission) => {console.log('--------onMissionMovedToFront-------');},
onMissionIconUpdated: (mission, icon) => {console.log('--------onMissionIconUpdated-------');},
onMissionClosed: (mission) => {console.log('--------onMissionClosed-------');},
onMissionLabelUpdated: (mission) => {console.log('--------onMissionLabelUpdated-------');}
});
``` ```
...@@ -79,17 +80,18 @@ unregisterMissionListener(listenerId: number, callback: AsyncCallback&lt;void&gt ...@@ -79,17 +80,18 @@ unregisterMissionListener(listenerId: number, callback: AsyncCallback&lt;void&gt
**示例:** **示例:**
```ts ```ts
let listener = { import missionManager from '@ohos.application.missionManager';
onMissionCreated: function (mission) {console.log('--------onMissionCreated-------');},
onMissionDestroyed: function (mission) {console.log('--------onMissionDestroyed-------');},
onMissionSnapshotChanged: function (mission) {console.log('--------onMissionSnapshotChanged-------');},
onMissionMovedToFront: function (mission) {console.log('--------onMissionMovedToFront-------');},
onMissionIconUpdated: function (mission, icon) {console.log('--------onMissionIconUpdated-------');},
onMissionClosed: function (mission) {console.log('--------onMissionClosed-------');},
onMissionLabelUpdated: function (mission) {console.log('--------onMissionLabelUpdated-------');}
};
console.log('registerMissionListener'); console.log('registerMissionListener');
let listenerid = missionManager.registerMissionListener(listener); let listenerid = missionManager.registerMissionListener({
onMissionCreated: (mission) => {console.log('--------onMissionCreated-------');},
onMissionDestroyed: (mission) => {console.log('--------onMissionDestroyed-------');},
onMissionSnapshotChanged: (mission) => {console.log('--------onMissionSnapshotChanged-------');},
onMissionMovedToFront: (mission) => {console.log('--------onMissionMovedToFront-------');},
onMissionIconUpdated: (mission, icon) => {console.log('--------onMissionIconUpdated-------');},
onMissionClosed: (mission) => {console.log('--------onMissionClosed-------');},
onMissionLabelUpdated: (mission) => {console.log('--------onMissionLabelUpdated-------');}
});
missionManager.unregisterMissionListener(listenerid, (error) => { missionManager.unregisterMissionListener(listenerid, (error) => {
console.error('unregisterMissionListener fail, error: ${error}'); console.error('unregisterMissionListener fail, error: ${error}');
...@@ -124,19 +126,21 @@ unregisterMissionListener(listenerId: number): Promise&lt;void&gt;; ...@@ -124,19 +126,21 @@ unregisterMissionListener(listenerId: number): Promise&lt;void&gt;;
**示例:** **示例:**
```ts ```ts
let listener = { import missionManager from '@ohos.application.missionManager';
onMissionCreated: function (mission) {console.log('--------onMissionCreated-------');}, import { BusinessError } from '@ohos.base';
onMissionDestroyed: function (mission) {console.log('--------onMissionDestroyed-------');},
onMissionSnapshotChanged: function (mission) {console.log('--------onMissionSnapshotChanged-------');},
onMissionMovedToFront: function (mission) {console.log('--------onMissionMovedToFront-------');},
onMissionIconUpdated: function (mission, icon) {console.log('--------onMissionIconUpdated-------');},
onMissionClosed: function (mission) {console.log('--------onMissionClosed-------');},
onMissionLabelUpdated: function (mission) {console.log('--------onMissionLabelUpdated-------');}
};
console.log('registerMissionListener'); console.log('registerMissionListener');
let listenerid = missionManager.registerMissionListener(listener); let listenerid = missionManager.registerMissionListener({
onMissionCreated: (mission) => {console.log('--------onMissionCreated-------');},
onMissionDestroyed: (mission) => {console.log('--------onMissionDestroyed-------');},
onMissionSnapshotChanged: (mission) => {console.log('--------onMissionSnapshotChanged-------');},
onMissionMovedToFront: (mission) => {console.log('--------onMissionMovedToFront-------');},
onMissionIconUpdated: (mission, icon) => {console.log('--------onMissionIconUpdated-------');},
onMissionClosed: (mission) => {console.log('--------onMissionClosed-------');},
onMissionLabelUpdated: (mission) => {console.log('--------onMissionLabelUpdated-------');}
});
missionManager.unregisterMissionListener(listenerid).catch(function (error) { missionManager.unregisterMissionListener(listenerid).catch((error: BusinessError) => {
console.error('unregisterMissionListener fail, error: ${error}'); console.error('unregisterMissionListener fail, error: ${error}');
}); });
``` ```
...@@ -166,21 +170,23 @@ getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback&lt;M ...@@ -166,21 +170,23 @@ getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback&lt;M
```ts ```ts
import missionManager from '@ohos.application.missionManager'; import missionManager from '@ohos.application.missionManager';
import { BusinessError } from '@ohos.base';
let allMissions=missionManager.getMissionInfos('',10).catch(function(err){console.log(err);}); let allMissions=missionManager.getMissionInfos('',10).catch((err: BusinessError) => {
missionManager.getMissionInfo('', allMissions[0].missionId, (error, mission) => { console.log('${err}');});
if (error.code) { missionManager.getMissionInfo('', allMissions[0].missionId, (error, mission) => {
console.error('getMissionInfo failed, error.code: ${error.code}, error.message: ${error.message}'); if (error.code) {
return; console.error('getMissionInfo failed, error.code: ${error.code}, error.message: ${error.message}');
} return;
}
console.log('mission.missionId = ${mission.missionId}');
console.log('mission.runningState = ${mission.runningState}'); console.log('mission.missionId = ${mission.missionId}');
console.log('mission.lockedState = ${mission.lockedState}'); console.log('mission.runningState = ${mission.runningState}');
console.log('mission.timestamp = ${mission.timestamp}'); console.log('mission.lockedState = ${mission.lockedState}');
console.log('mission.label = ${mission.label}'); console.log('mission.timestamp = ${mission.timestamp}');
console.log('mission.iconPath = ${mission.iconPath}'); console.log('mission.label = ${mission.label}');
}); console.log('mission.iconPath = ${mission.iconPath}');
});
``` ```
...@@ -213,8 +219,9 @@ getMissionInfo(deviceId: string, missionId: number): Promise&lt;MissionInfo&gt;; ...@@ -213,8 +219,9 @@ getMissionInfo(deviceId: string, missionId: number): Promise&lt;MissionInfo&gt;;
```ts ```ts
import missionManager from '@ohos.application.missionManager'; import missionManager from '@ohos.application.missionManager';
import { BusinessError } from '@ohos.base';
let mission = missionManager.getMissionInfo('', 10).catch(function (error){ let mission = missionManager.getMissionInfo('', 10).catch((error: BusinessError) => {
console.error('getMissionInfo fail, error: ${error}'); console.error('getMissionInfo fail, error: ${error}');
}); });
``` ```
...@@ -285,8 +292,9 @@ getMissionInfos(deviceId: string, numMax: number): Promise&lt;Array&lt;MissionIn ...@@ -285,8 +292,9 @@ getMissionInfos(deviceId: string, numMax: number): Promise&lt;Array&lt;MissionIn
```ts ```ts
import missionManager from '@ohos.application.missionManager'; import missionManager from '@ohos.application.missionManager';
import { BusinessError } from '@ohos.base';
let allMissions = missionManager.getMissionInfos('', 10).catch(function (error){ let allMissions = missionManager.getMissionInfos('', 10).catch((error: BusinessError) => {
console.error('getMissionInfos fail, error: ${error}'); console.error('getMissionInfos fail, error: ${error}');
}); });
``` ```
...@@ -366,20 +374,21 @@ getMissionSnapShot(deviceId: string, missionId: number): Promise&lt;MissionSnaps ...@@ -366,20 +374,21 @@ getMissionSnapShot(deviceId: string, missionId: number): Promise&lt;MissionSnaps
```ts ```ts
import missionManager from '@ohos.application.missionManager'; import missionManager from '@ohos.application.missionManager';
import { BusinessError } from '@ohos.base';
let allMissions; let id: number = -1;
missionManager.getMissionInfos('',10).then(function(res){ missionManager.getMissionInfos('',10).then((res) => {
allMissions=res; let allMissions = res;
}).catch(function(error) {
console.error('getMissionInfos fail, error: ${error}');
});
console.log('size = ${allMissions.length}'); console.log('size = ${allMissions.length}');
console.log('missions = ${JSON.stringify(allMissions)}'); console.log('missions = ${JSON.stringify(allMissions)}');
let id = allMissions[0].missionId; id = allMissions[0].missionId;
}).catch((error: BusinessError) => {
console.error('getMissionInfos fail, error: ${error}');
});
let snapshot = missionManager.getMissionSnapShot('', id).catch(function (error){ let snapshot = missionManager.getMissionSnapShot('', id).catch((error: BusinessError) => {
console.error('getMissionSnapShot fail, error: ${error}'); console.error('getMissionSnapShot fail, error: ${error}');
}); });
``` ```
## missionManager.lockMission ## missionManager.lockMission
...@@ -450,17 +459,19 @@ lockMission(missionId: number): Promise&lt;void&gt;; ...@@ -450,17 +459,19 @@ lockMission(missionId: number): Promise&lt;void&gt;;
```ts ```ts
import missionManager from '@ohos.application.missionManager'; import missionManager from '@ohos.application.missionManager';
let allMissions; import { BusinessError } from '@ohos.base';
missionManager.getMissionInfos('',10).then(function(res){
allMissions=res; let id: number = -1;
}).catch(function(error) { missionManager.getMissionInfos('',10).then((res) => {
let allMissions = res;
console.log('size = ${allMissions.length}');
console.log('missions = ${JSON.stringify(allMissions)}');
id = allMissions[0].missionId;
}).catch((error: BusinessError) => {
console.error('getMissionInfos fail, error: ${error}'); console.error('getMissionInfos fail, error: ${error}');
}); });
console.log('size = ${allMissions.length}');
console.log('missions = ${JSON.stringify(allMissions)}');
let id = allMissions[0].missionId;
missionManager.lockMission(id).catch(function (error){ missionManager.lockMission(id).catch((error: BusinessError) => {
console.error('lockMission fail, error: ${error}'); console.error('lockMission fail, error: ${error}');
}); });
``` ```
...@@ -534,21 +545,22 @@ unlockMission(missionId: number): Promise&lt;void&gt;; ...@@ -534,21 +545,22 @@ unlockMission(missionId: number): Promise&lt;void&gt;;
```ts ```ts
import missionManager from '@ohos.application.missionManager'; import missionManager from '@ohos.application.missionManager';
import { BusinessError } from '@ohos.base';
let allMissions; let id: number = -1;
missionManager.getMissionInfos('',10).then(function(res){ missionManager.getMissionInfos('',10).then((res) => {
allMissions=res; let allMissions = res;
}).catch(function(error) { console.log('size = ${allMissions.length}');
console.log('missions = ${JSON.stringify(allMissions)}');
id = allMissions[0].missionId;
}).catch((error: BusinessError) => {
console.error('getMissionInfos fail, error: ${error}'); console.error('getMissionInfos fail, error: ${error}');
}); });
console.log('size = ${allMissions.length}');
console.log('missions = ${JSON.stringify(allMissions)}');
let id = allMissions[0].missionId;
missionManager.lockMission(id).catch(function (error){ missionManager.lockMission(id).catch((error: BusinessError) => {
console.error('lockMission fail, error: ${error}'); console.error('lockMission fail, error: ${error}');
}); });
missionManager.unlockMission(id).catch(function (error){ missionManager.unlockMission(id).catch((error: BusinessError) => {
console.error('unlockMission fail, error: ${error}'); console.error('unlockMission fail, error: ${error}');
}); });
``` ```
...@@ -622,18 +634,19 @@ clearMission(missionId: number): Promise&lt;void&gt;; ...@@ -622,18 +634,19 @@ clearMission(missionId: number): Promise&lt;void&gt;;
```ts ```ts
import missionManager from '@ohos.application.missionManager'; import missionManager from '@ohos.application.missionManager';
import { BusinessError } from '@ohos.base';
let allMissions; let id: number = -1;
missionManager.getMissionInfos('',10).then(function(res){ missionManager.getMissionInfos('',10).then((res) => {
allMissions=res; let allMissions = res;
}).catch(function(error) { console.log('size = ${allMissions.length}');
console.log('missions = ${JSON.stringify(allMissions)}');
id = allMissions[0].missionId;
}).catch((error: BusinessError) => {
console.error('getMissionInfos fail, error: ${error}'); console.error('getMissionInfos fail, error: ${error}');
}); });
console.log('size = ${allMissions.length}');
console.log('missions = ${JSON.stringify(allMissions)}');
let id = allMissions[0].missionId;
missionManager.clearMission(id).catch(function (error){ missionManager.clearMission(id).catch((error: BusinessError) => {
console.error('clearMission fail, error: ${error}'); console.error('clearMission fail, error: ${error}');
}); });
``` ```
...@@ -684,7 +697,9 @@ clearAllMissions(): Promise&lt;void&gt;; ...@@ -684,7 +697,9 @@ clearAllMissions(): Promise&lt;void&gt;;
```ts ```ts
import missionManager from '@ohos.application.missionManager'; import missionManager from '@ohos.application.missionManager';
missionManager.clearAllMissions().catch(function (error){ import { BusinessError } from '@ohos.base';
missionManager.clearAllMissions().catch((error: BusinessError) => {
console.error('clearAllMissions fail, error: ${error}'); console.error('clearAllMissions fail, error: ${error}');
}); });
``` ```
...@@ -800,18 +815,19 @@ moveMissionToFront(missionId: number, options?: StartOptions): Promise&lt;void&g ...@@ -800,18 +815,19 @@ moveMissionToFront(missionId: number, options?: StartOptions): Promise&lt;void&g
```ts ```ts
import missionManager from '@ohos.application.missionManager'; import missionManager from '@ohos.application.missionManager';
import { BusinessError } from '@ohos.base';
let allMissions; let id: number = -1;
missionManager.getMissionInfos('',10).then(function(res){ missionManager.getMissionInfos('',10).then((res) => {
allMissions=res; let allMissions = res;
}).catch(function(error) { console.log('size = ${allMissions.length}');
console.log('missions = ${JSON.stringify(allMissions)}');
id = allMissions[0].missionId;
}).catch((error: BusinessError) => {
console.error('getMissionInfos fail, error: ${error}'); console.error('getMissionInfos fail, error: ${error}');
}); });
console.log('size = ${allMissions.length}');
console.log('missions = ${JSON.stringify(allMissions)}');
let id = allMissions[0].missionId;
missionManager.moveMissionToFront(id).catch(function (error){ missionManager.moveMissionToFront(id).catch((error: BusinessError) => {
console.error('moveMissionToFront fail, error: ${error}'); console.error('moveMissionToFront fail, error: ${error}');
}); });
``` ```
\ No newline at end of file
...@@ -41,8 +41,11 @@ onReceiveEvent(event: CommonEventData): void; ...@@ -41,8 +41,11 @@ onReceiveEvent(event: CommonEventData): void;
**示例:** **示例:**
```ts ```ts
import StaticSubscriberExtensionAbility from '@ohos.application.StaticSubscriberExtensionAbility';
import CommonEventManager from '@ohos.commonEventManager';
class MyStaticSubscriberExtensionAbility extends StaticSubscriberExtensionAbility { class MyStaticSubscriberExtensionAbility extends StaticSubscriberExtensionAbility {
onReceiveEvent(event) { onReceiveEvent(event: CommonEventManager.CommonEventData) {
console.log('onReceiveEvent, event: ${JSON.stringify(event)}'); console.log('onReceiveEvent, event: ${JSON.stringify(event)}');
} }
} }
......
...@@ -25,6 +25,8 @@ onPrepare(): void ...@@ -25,6 +25,8 @@ onPrepare(): void
**示例:** **示例:**
```ts ```ts
import TestRunner from '@ohos.application.testRunner';
export default class UserTestRunner implements TestRunner { export default class UserTestRunner implements TestRunner {
onPrepare() { onPrepare() {
console.log('Trigger onPrepare'); console.log('Trigger onPrepare');
...@@ -46,6 +48,8 @@ onRun(): void ...@@ -46,6 +48,8 @@ onRun(): void
**示例:** **示例:**
```ts ```ts
import TestRunner from '@ohos.application.testRunner';
export default class UserTestRunner implements TestRunner { export default class UserTestRunner implements TestRunner {
onPrepare() {} onPrepare() {}
onRun() { onRun() {
......
...@@ -33,13 +33,15 @@ import Want from '@ohos.application.Want'; ...@@ -33,13 +33,15 @@ import Want from '@ohos.application.Want';
- 基础用法(在UIAbility对象中调用,其中示例中的context为UIAbility的上下文对象) - 基础用法(在UIAbility对象中调用,其中示例中的context为UIAbility的上下文对象)
```ts ```ts
let want = { import Want from '@ohos.application.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
'deviceId': '', // deviceId为空表示本设备 'deviceId': '', // deviceId为空表示本设备
'bundleName': 'com.example.myapplication', 'bundleName': 'com.example.myapplication',
'abilityName': 'EntryAbility', 'abilityName': 'EntryAbility',
'moduleName': 'entry' // moduleName非必选
}; };
this.context.startAbility(want, (error) => { this.context.startAbility(want, (error: BusinessError) => {
// 显式拉起Ability,通过bundleName、abilityName和moduleName可以唯一确定一个Ability // 显式拉起Ability,通过bundleName、abilityName和moduleName可以唯一确定一个Ability
console.error('error.code = ${error.code}'); console.error('error.code = ${error.code}');
}); });
...@@ -49,7 +51,9 @@ import Want from '@ohos.application.Want'; ...@@ -49,7 +51,9 @@ import Want from '@ohos.application.Want';
* 字符串(String) * 字符串(String)
```ts ```ts
let want = { import Want from '@ohos.application.Want';
let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility', abilityName: 'EntryAbility',
parameters: { parameters: {
...@@ -59,7 +63,9 @@ import Want from '@ohos.application.Want'; ...@@ -59,7 +63,9 @@ import Want from '@ohos.application.Want';
``` ```
* 数字(Number) * 数字(Number)
```ts ```ts
let want = { import Want from '@ohos.application.Want';
let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility', abilityName: 'EntryAbility',
parameters: { parameters: {
...@@ -70,7 +76,9 @@ import Want from '@ohos.application.Want'; ...@@ -70,7 +76,9 @@ import Want from '@ohos.application.Want';
``` ```
* 布尔(Boolean) * 布尔(Boolean)
```ts ```ts
let want = { import Want from '@ohos.application.Want';
let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility', abilityName: 'EntryAbility',
parameters: { parameters: {
...@@ -80,7 +88,9 @@ import Want from '@ohos.application.Want'; ...@@ -80,7 +88,9 @@ import Want from '@ohos.application.Want';
``` ```
* 对象(Object) * 对象(Object)
```ts ```ts
let want = { import Want from '@ohos.application.Want';
let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility', abilityName: 'EntryAbility',
parameters: { parameters: {
...@@ -95,7 +105,9 @@ import Want from '@ohos.application.Want'; ...@@ -95,7 +105,9 @@ import Want from '@ohos.application.Want';
``` ```
* 数组(Array) * 数组(Array)
```ts ```ts
let want = { import Want from '@ohos.application.Want';
let want: Want = {
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility', abilityName: 'EntryAbility',
parameters: { parameters: {
...@@ -109,22 +121,24 @@ import Want from '@ohos.application.Want'; ...@@ -109,22 +121,24 @@ import Want from '@ohos.application.Want';
* 文件描述符(FD) * 文件描述符(FD)
```ts ```ts
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
let fd; import Want from '@ohos.application.Want';
import { BusinessError } from '@ohos.base';
let fd: number = 0;
try { try {
fd = fs.openSync('/data/storage/el2/base/haps/pic.png').fd; fd = fs.openSync('/data/storage/el2/base/haps/pic.png').fd;
} catch(e) { } catch(e) {
console.error('openSync fail: ${JSON.stringify(e)}'); console.error('openSync fail: ${JSON.stringify(e)}');
} }
let want = { let want: Want = {
'deviceId': '', // deviceId为空表示本设备 deviceId: '', // deviceId为空表示本设备
'bundleName': 'com.example.myapplication', bundleName: 'com.example.myapplication',
'abilityName': 'EntryAbility', abilityName: 'EntryAbility',
'moduleName': 'entry', // moduleName非必选 parameters: {
'parameters': {
'keyFd':{'type':'FD', 'value':fd} 'keyFd':{'type':'FD', 'value':fd}
} }
}; };
this.context.startAbility(want, (error) => { this.context.startAbility(want, (error: BusinessError) => {
// 显式拉起Ability,通过bundleName、abilityName和moduleName可以唯一确定一个Ability // 显式拉起Ability,通过bundleName、abilityName和moduleName可以唯一确定一个Ability
console.error('error.code = ${error.code}'); console.error('error.code = ${error.code}');
}); });
......
...@@ -25,7 +25,10 @@ import common from '@ohos.app.ability.common'; ...@@ -25,7 +25,10 @@ import common from '@ohos.app.ability.common';
**示例:** **示例:**
```ts ```ts
let want = { import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
let want: Want = {
bundleName: 'com.example.myapp', bundleName: 'com.example.myapp',
abilityName: 'MyAbility' abilityName: 'MyAbility'
}; };
...@@ -42,5 +45,5 @@ import common from '@ohos.app.ability.common'; ...@@ -42,5 +45,5 @@ import common from '@ohos.app.ability.common';
} }
}; };
let connection = this.context.connectAbility(want, connectOptions); let connection: number = this.context.connectAbility(want, connectOptions);
``` ```
\ No newline at end of file
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册