diff --git a/zh-cn/application-dev/reference/apis/js-apis-ability-dataUriUtils.md b/zh-cn/application-dev/reference/apis/js-apis-ability-dataUriUtils.md index 8b12e20e1b7dd9c859d70bcd4f17581c8d2fdeec..51123dadb0795d368e2f057c7ee2e021341a47a0 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-ability-dataUriUtils.md +++ b/zh-cn/application-dev/reference/apis/js-apis-ability-dataUriUtils.md @@ -35,6 +35,8 @@ getId(uri: string): number **示例：** ```ts +import dataUriUtils from '@ohos.ability.dataUriUtils'; + let id = dataUriUtils.getId('com.example.dataUriUtils/1221'); ``` @@ -64,6 +66,8 @@ attachId(uri: string, id: number): string **示例：** ```ts +import dataUriUtils from '@ohos.ability.dataUriUtils'; + let id = 1122; let uri = dataUriUtils.attachId( 'com.example.dataUriUtils', @@ -96,6 +100,8 @@ deleteId(uri: string): string **示例：** ```ts +import dataUriUtils from '@ohos.ability.dataUriUtils'; + let uri = dataUriUtils.deleteId('com.example.dataUriUtils/1221'); ``` @@ -125,6 +131,8 @@ updateId(uri: string, id: number): string **示例：** ```ts +import dataUriUtils from '@ohos.ability.dataUriUtils'; + let id = 1122; let uri = dataUriUtils.updateId( 'com.example.dataUriUtils/1221', diff --git a/zh-cn/application-dev/reference/apis/js-apis-ability-featureAbility.md b/zh-cn/application-dev/reference/apis/js-apis-ability-featureAbility.md index 8bd95f08ca7b69a0340b387f63e7e304b860803d..83a82c437aa75905e611332b2e05a7c0142d55fc 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-ability-featureAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-ability-featureAbility.md @@ -587,15 +587,7 @@ connectAbility(request: Want, options:ConnectOptions): number ```ts import rpc from '@ohos.rpc'; import featureAbility from '@ohos.ability.featureAbility'; -function onConnectCallback(element, remote){ - console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}'); -} -function onDisconnectCallback(element){ - console.log('ConnectAbility onDisconnect element.deviceId : ${element.deviceId}') -} -function onFailedCallback(code){ - console.error('featureAbilityTest ConnectAbility onFailed errCode : ${code}') -} + let connectId = featureAbility.connectAbility( { deviceId: '', @@ -603,9 +595,15 @@ let connectId = featureAbility.connectAbility( abilityName: 'com.ix.ServiceAbility.ServiceAbilityA', }, { - onConnect: onConnectCallback, - onDisconnect: onDisconnectCallback, - onFailed: onFailedCallback, + onConnect: (element, remote) => { + console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}'); + }, + onDisconnect: (element) => { + console.log('ConnectAbility onDisconnect element.deviceId : ${element.deviceId}') + }, + onFailed: (code) => { + console.error('featureAbilityTest ConnectAbility onFailed errCode : ${code}') + }, }, ); ``` @@ -630,24 +628,22 @@ disconnectAbility(connection: number, callback:AsyncCallback\): void ```ts import rpc from '@ohos.rpc'; import featureAbility from '@ohos.ability.featureAbility'; -function onConnectCallback(element, remote){ - console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}'); -} -function onDisconnectCallback(element){ - console.log('ConnectAbility onDisconnect element.deviceId : ${element.deviceId}'); -} -function onFailedCallback(code){ - console.error('featureAbilityTest ConnectAbility onFailed errCode : ${code}'); -} + let connectId = featureAbility.connectAbility( { bundleName: 'com.ix.ServiceAbility', abilityName: 'com.ix.ServiceAbility.ServiceAbilityA', }, { - onConnect: onConnectCallback, - onDisconnect: onDisconnectCallback, - onFailed: onFailedCallback, + onConnect: (element, remote) => { + console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}'); + }, + onDisconnect: (element) => { + console.log('ConnectAbility onDisconnect element.deviceId : ${element.deviceId}'); + }, + onFailed: (code) => { + console.error('featureAbilityTest ConnectAbility onFailed errCode : ${code}'); + }, }, ); @@ -685,30 +681,29 @@ disconnectAbility(connection: number): Promise\ ```ts import rpc from '@ohos.rpc'; import featureAbility from '@ohos.ability.featureAbility'; -function onConnectCallback(element, remote){ - console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}'); -} -function onDisconnectCallback(element){ - console.log('ConnectAbility onDisconnect element.deviceId : ${element.deviceId}'); -} -function onFailedCallback(code){ - console.error('featureAbilityTest ConnectAbility onFailed errCode : ${code}'); -} +import { BusinessError } from '@ohos.base'; + let connectId = featureAbility.connectAbility( { bundleName: 'com.ix.ServiceAbility', abilityName: 'com.ix.ServiceAbility.ServiceAbilityA', }, { - onConnect: onConnectCallback, - onDisconnect: onDisconnectCallback, - onFailed: onFailedCallback, + onConnect: (element, remote) => { + console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}'); + }, + onDisconnect: (element) => { + console.log('ConnectAbility onDisconnect element.deviceId : ${element.deviceId}'); + }, + onFailed: (code) => { + console.error('featureAbilityTest ConnectAbility onFailed errCode : ${code}'); + }, }, ); featureAbility.disconnectAbility(connectId).then((data) => { console.log('data: ${data)}') -}).catch((error)=>{ +}).catch((error: BusinessError)=>{ console.error('featureAbilityTest result errCode : ${error.code}'); }); ``` @@ -731,7 +726,11 @@ getWindow(callback: AsyncCallback\): void **示例：** ```ts -featureAbility.getWindow((error, data) => { +import featureAbility from '@ohos.ability.featureAbility'; +import { BusinessError } from '@ohos.base'; +import window from '@ohos.window'; + +featureAbility.getWindow((error: BusinessError, data: window.Window) => { if (error && error.code !== 0) { console.error('getWindow fail, error: ${JSON.stringify(error)}'); } else { @@ -757,6 +756,8 @@ getWindow(): Promise\; **示例：** ```ts +import featureAbility from '@ohos.ability.featureAbility'; + featureAbility.getWindow().then((data) => { console.info('getWindow data: ${typeof(data)}'); }); diff --git a/zh-cn/application-dev/reference/apis/js-apis-ability-particleAbility.md b/zh-cn/application-dev/reference/apis/js-apis-ability-particleAbility.md index 03e2820c73190401a157e05136c99490c6544a6f..8b34d32bcfc0bbfd0872550cd15f03e9673976fe 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-ability-particleAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-ability-particleAbility.md @@ -233,8 +233,9 @@ startBackgroundRunning(id: number, request: NotificationRequest, callback: Async import notification from '@ohos.notification'; import particleAbility from '@ohos.ability.particleAbility'; import wantAgent from '@ohos.app.ability.wantAgent'; +import { BusinessError } from '@ohos.base'; -function callback(error, data) { +function callback(error: BusinessError, data: void) { if (error && error.code !== 0) { console.error('Operation failed error: ${JSON.stringify(error)}'); } else { @@ -242,7 +243,7 @@ function callback(error, data) { } } -let wantAgentInfo = { +let wantAgentInfo: wantAgent.WantAgentInfo = { wants: [ { bundleName: 'com.example.myapplication', @@ -255,20 +256,19 @@ let wantAgentInfo = { }; wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => { - let basicContent = { - title: 'title', - text: 'text' - }; - let notificationContent = { - contentType: notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT, - normal: basicContent - }; - let request = { - content: notificationContent, - wantAgent: wantAgentObj - }; let id = 1; - particleAbility.startBackgroundRunning(id, request, callback); + particleAbility.startBackgroundRunning(id, { + content: + { + contentType: notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT, + normal: + { + title: 'title', + text: 'text' + } + }, + wantAgent: wantAgentObj + }, callback); }); ``` @@ -302,8 +302,9 @@ startBackgroundRunning(id: number, request: NotificationRequest): Promise<voi import notification from '@ohos.notification'; import particleAbility from '@ohos.ability.particleAbility'; import wantAgent from '@ohos.app.ability.wantAgent'; +import { BusinessError } from '@ohos.base'; -let wantAgentInfo = { +let wantAgentInfo: wantAgent.WantAgentInfo = { wants: [ { bundleName: 'com.example.myapplication', @@ -316,22 +317,21 @@ let wantAgentInfo = { }; wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => { - let basicContent = { - title: 'title', - text: 'text' - }; - let notificationContent = { - contentType: notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT, - normal: basicContent - }; - let request = { - content: notificationContent, - wantAgent: wantAgentObj - }; let id = 1; - particleAbility.startBackgroundRunning(id, request).then(() => { + particleAbility.startBackgroundRunning(id, { + content: + { + contentType: notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT, + normal: + { + title: 'title', + text: 'text' + } + }, + wantAgent: wantAgentObj + }).then(() => { console.info('Operation succeeded'); - }).catch((err) => { + }).catch((err: BusinessError) => { console.error('Operation failed cause: ${JSON.stringify(err)}'); }); }); @@ -356,8 +356,9 @@ cancelBackgroundRunning(callback: AsyncCallback<void>): void; ```ts import particleAbility from '@ohos.ability.particleAbility'; +import { BusinessError } from '@ohos.base'; -function callback(error, data) { +function callback(error: BusinessError, data: void) { if (error && error.code !== 0) { console.error('Operation failed error: ${JSON.stringify(error)}'); } else { @@ -390,7 +391,7 @@ import particleAbility from '@ohos.ability.particleAbility'; particleAbility.cancelBackgroundRunning().then(() => { console.info('Operation succeeded'); -}).catch((err) => { +}).catch((err: BusinessError) => { console.error('Operation failed cause: ${JSON.stringify(err)}'); }); @@ -424,33 +425,27 @@ connectAbility(request: Want, options:ConnectOptions): number import particleAbility from '@ohos.ability.particleAbility'; import rpc from '@ohos.rpc'; -function onConnectCallback(element, remote) { - console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}'); -} - -function onDisconnectCallback(element) { - console.log('ConnectAbility onDisconnect element.deviceId: ${element.deviceId}'); -} - -function onFailedCallback(code) { - console.error('particleAbilityTest ConnectAbility onFailed errCode: ${code}'); -} - let connId = particleAbility.connectAbility( { bundleName: 'com.ix.ServiceAbility', abilityName: 'ServiceAbilityA', }, { - onConnect: onConnectCallback, - onDisconnect: onDisconnectCallback, - onFailed: onFailedCallback, + onConnect: (element, remote) => { + console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}'); + }, + onDisconnect: (element) => { + console.log('ConnectAbility onDisconnect element.deviceId: ${element.deviceId}'); + }, + onFailed: (code) => { + console.error('particleAbilityTest ConnectAbility onFailed errCode: ${code}'); + }, }, ); particleAbility.disconnectAbility(connId).then((data) => { console.log('data: ${data}'); -}).catch((error) => { +}).catch((error: BusinessError) => { console.error('particleAbilityTest result errCode: ${error.code}'); }); ``` @@ -475,27 +470,21 @@ disconnectAbility(connection: number, callback:AsyncCallback\): void; import particleAbility from '@ohos.ability.particleAbility'; import rpc from '@ohos.rpc'; -function onConnectCallback(element, remote) { - console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}'); -} - -function onDisconnectCallback(element) { - console.log('ConnectAbility onDisconnect element.deviceId: ${element.deviceId}'); -} - -function onFailedCallback(code) { - console.error('particleAbilityTest ConnectAbility onFailed errCode: ${code}'); -} - let connId = particleAbility.connectAbility( { bundleName: 'com.ix.ServiceAbility', abilityName: 'ServiceAbilityA', }, { - onConnect: onConnectCallback, - onDisconnect: onDisconnectCallback, - onFailed: onFailedCallback, + onConnect: (element, remote) => { + console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}'); + }, + onDisconnect: (element) => { + console.log('ConnectAbility onDisconnect element.deviceId: ${element.deviceId}'); + }, + onFailed: (code) => { + console.error('particleAbilityTest ConnectAbility onFailed errCode: ${code}'); + }, }, ); @@ -524,18 +513,7 @@ disconnectAbility(connection: number): Promise\; ```ts import particleAbility from '@ohos.ability.particleAbility'; import rpc from '@ohos.rpc'; - -function onConnectCallback(element, remote) { - console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}'); -} - -function onDisconnectCallback(element) { - console.log('ConnectAbility onDisconnect element.deviceId: ${element.deviceId}'); -} - -function onFailedCallback(code) { - console.error('particleAbilityTest ConnectAbility onFailed errCode: ${code}'); -} +import { BusinessError } from '@ohos.base'; let connId = particleAbility.connectAbility( { @@ -543,18 +521,23 @@ let connId = particleAbility.connectAbility( abilityName: 'ServiceAbilityA', }, { - onConnect: onConnectCallback, - onDisconnect: onDisconnectCallback, - onFailed: onFailedCallback, + onConnect: (element, remote) => { + console.log('ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}'); + }, + onDisconnect: (element) => { + console.log('ConnectAbility onDisconnect element.deviceId: ${element.deviceId}'); + }, + onFailed: (code) => { + console.error('particleAbilityTest ConnectAbility onFailed errCode: ${code}'); + }, }, ); particleAbility.disconnectAbility(connId).then((data) => { console.log(' data: ${data}'); -}).catch((error) => { +}).catch((error: BusinessError) => { console.error('particleAbilityTest result errCode : ${error.code}'); }); - ``` ## ErrorCode diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-ability.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-ability.md index 57550cd1808dbf82d09e594457244dd4d9039189..15eaa262464af15e2724c0f91f0415f2fddfce1e 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-ability.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-ability.md @@ -31,9 +31,10 @@ onConfigurationUpdate(newConfig: Configuration): void; ```ts // Ability是顶层基类，不支持开发者直接继承。故以派生类UIAbility举例说明。 import UIAbility from '@ohos.app.ability.UIAbility'; +import { Configuration } from '@ohos.app.ability.Configuration'; class MyUIAbility extends UIAbility { - onConfigurationUpdate(config) { + onConfigurationUpdate(config: Configuration) { console.log('onConfigurationUpdate, config: ${JSON.stringify(config)}'); } } @@ -58,9 +59,10 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void; ```ts // Ability是顶层基类，不支持开发者直接继承。故以派生类UIAbility举例说明。 import UIAbility from '@ohos.app.ability.UIAbility'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; class MyUIAbility extends UIAbility { - onMemoryLevel(level) { + onMemoryLevel(level: AbilityConstant.MemoryLevel) { console.log('onMemoryLevel, level: ${JSON.stringify(level)}'); } } diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md index 27fc3b44fcef082bab33874884f786bb2642ceb1..b079c04b902fb84ad3e2fa61e0c173ea6ce0b788 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md @@ -45,9 +45,11 @@ Ability初次启动原因，该类型为枚举，可配合[Ability](js-apis-app- ```ts import UIAbility from '@ohos.app.ability.UIAbility'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; +import Want from '@ohos.app.ability.Want'; class MyAbility extends UIAbility { - onCreate(want, launchParam) { + onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { if (launchParam.launchReason === AbilityConstant.LaunchReason.START_ABILITY) { console.log('The ability has been started by the way of startAbility.'); } @@ -77,9 +79,11 @@ Ability上次退出原因，该类型为枚举，可配合[Ability](js-apis-app- ```ts import UIAbility from '@ohos.app.ability.UIAbility'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; +import Want from '@ohos.app.ability.Want'; class MyAbility extends UIAbility { - onCreate(want, launchParam) { + onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { if (launchParam.lastExitReason === AbilityConstant.LastExitReason.ABILITY_NOT_RESPONDING) { console.log('The ability has exit last because the ability was not responding.'); } @@ -103,9 +107,10 @@ Ability迁移结果，该类型为枚举，可配合[Ability](js-apis-app-abilit ```ts import UIAbility from '@ohos.app.ability.UIAbility'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; class MyAbility extends UIAbility { - onContinue(wantParam) { + onContinue(wantParam: Record) { return AbilityConstant.OnContinueResult.AGREE; } } @@ -130,18 +135,22 @@ class MyAbility extends UIAbility { **示例：** ```ts -let want = { +import StartOptions from '@ohos.app.ability.StartOptions'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; -let option = { +let option: StartOptions = { windowMode: AbilityConstant.WindowMode.WINDOW_MODE_FULLSCREEN }; // 确保从上下文获取到context this.context.startAbility(want, option).then(()=>{ console.log('Succeed to start ability.'); -}).catch((error)=>{ +}).catch((error: BusinessError)=>{ console.error('Failed to start ability with error: ${JSON.stringify(error)}'); }); ``` @@ -162,9 +171,10 @@ this.context.startAbility(want, option).then(()=>{ ```ts import UIAbility from '@ohos.app.ability.UIAbility'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; class MyAbility extends UIAbility { - onMemoryLevel(level) { + onMemoryLevel(level: AbilityConstant.MemoryLevel) { if (level === AbilityConstant.MemoryLevel.MEMORY_LEVEL_CRITICAL) { console.log('The memory of device is critical, please release some memory.'); } @@ -191,9 +201,10 @@ class MyAbility extends UIAbility { ```ts import UIAbility from '@ohos.app.ability.UIAbility'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; class MyAbility extends UIAbility { - onSaveState(reason, wantParam) { + onSaveState(reason: AbilityConstant.StateType, wantParam: Record) { return AbilityConstant.OnSaveResult.ALL_AGREE; } } @@ -214,9 +225,10 @@ class MyAbility extends UIAbility { ```ts import UIAbility from '@ohos.app.ability.UIAbility'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; class MyAbility extends UIAbility { - onSaveState(reason, wantParam) { + onSaveState(reason: AbilityConstant.StateType, wantParam: Record) { if (reason === AbilityConstant.StateType.CONTINUATION) { console.log('Save the ability data when the ability continuation.'); } @@ -240,8 +252,9 @@ ContinueState说明枚举值。用于表示当前应用任务流转的状态。 ```ts import AbilityConstant from '@ohos.app.ability.AbilityConstant'; + import { BusinessError } from '@ohos.base'; - this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE, (result) => { + this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE, (result: BusinessError) => { console.info(`setMissionContinueState: ${JSON.stringify(result)}`); }); ``` \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityDelegatorRegistry.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityDelegatorRegistry.md index f5c71a99fb3f6683dd36c007e6bfd434e36253aa..a0aabf2a9e767b1173b2b0940070fd1516bc1967 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityDelegatorRegistry.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityDelegatorRegistry.md @@ -45,10 +45,11 @@ getAbilityDelegator(): AbilityDelegator ```ts import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import Want from '@ohos.app.ability.Want'; let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -let want = { +let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityLifecycleCallback.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityLifecycleCallback.md index 841c76981a4114564a6a099e82c881390069d9d2..c2f4832377f640afb63eb7aca88ae223554f66e6 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityLifecycleCallback.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityLifecycleCallback.md @@ -29,7 +29,9 @@ onAbilityCreate(ability: UIAbility): void; **示例：** ```ts -let abilityLifecycleCallback = { +import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback'; + +let abilityLifecycleCallback: AbilityLifecycleCallback = { onAbilityCreate(ability){ console.log('AbilityLifecycleCallback onAbilityCreate.'); } @@ -53,7 +55,9 @@ onWindowStageCreate(ability: UIAbility, windowStage: window.WindowStage): void; **示例：** ```ts -let abilityLifecycleCallback = { +import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback'; + +let abilityLifecycleCallback: AbilityLifecycleCallback = { onWindowStageCreate(ability, windowStage){ console.log('AbilityLifecycleCallback onWindowStageCreate.'); } @@ -77,7 +81,9 @@ onWindowStageActive(ability: UIAbility, windowStage: window.WindowStage): void; **示例：** ```ts -let abilityLifecycleCallback = { +import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback'; + +let abilityLifecycleCallback: AbilityLifecycleCallback = { onWindowStageActive(ability, windowStage){ console.log('AbilityLifecycleCallback onWindowStageActive.'); } @@ -101,7 +107,9 @@ onWindowStageInactive(ability: UIAbility, windowStage: window.WindowStage): void **示例：** ```ts -let abilityLifecycleCallback = { +import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback'; + +let abilityLifecycleCallback: AbilityLifecycleCallback = { onWindowStageInactive(ability, windowStage){ console.log('AbilityLifecycleCallback onWindowStageInactive.'); } @@ -125,7 +133,9 @@ onWindowStageDestroy(ability: UIAbility, windowStage: window.WindowStage): void; **示例：** ```ts -let abilityLifecycleCallback = { +import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback'; + +let abilityLifecycleCallback: AbilityLifecycleCallback = { onWindowStageDestroy(ability, windowStage){ console.log('AbilityLifecycleCallback onWindowStageDestroy.'); } @@ -148,7 +158,9 @@ onAbilityDestroy(ability: UIAbility): void; **示例：** ```ts -let abilityLifecycleCallback = { +import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback'; + +let abilityLifecycleCallback: AbilityLifecycleCallback = { onAbilityDestroy(ability){ console.log('AbilityLifecycleCallback onAbilityDestroy.'); } @@ -171,7 +183,9 @@ onAbilityForeground(ability: UIAbility): void; **示例：** ```ts -let abilityLifecycleCallback = { +import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback'; + +let abilityLifecycleCallback: AbilityLifecycleCallback = { onAbilityForeground(ability){ console.log('AbilityLifecycleCallback onAbilityForeground.'); } @@ -194,7 +208,9 @@ onAbilityBackground(ability: UIAbility): void; **示例：** ```ts -let abilityLifecycleCallback = { +import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback'; + +let abilityLifecycleCallback: AbilityLifecycleCallback = { onAbilityBackground(ability){ console.log('AbilityLifecycleCallback onAbilityBackground.'); } @@ -217,7 +233,9 @@ onAbilityContinue(ability: UIAbility): void; **示例：** ```ts -let abilityLifecycleCallback = { +import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback'; + +let abilityLifecycleCallback: AbilityLifecycleCallback = { onAbilityContinue(ability){ console.log('AbilityLifecycleCallback onAbilityContinue.'); } @@ -227,15 +245,40 @@ let abilityLifecycleCallback = { ## AbilityLifecycleCallback使用 **示例：** +GlobalContext.ts +```ts +// 构造单例对象 +export class GlobalContext { + private constructor() {} + private static instance: GlobalContext; + private _objects = new Map(); + + public static getContext(): GlobalContext { + if (!GlobalContext.instance) { + GlobalContext.instance = new GlobalContext(); + } + return GlobalContext.instance; + } + + getObject(value: string): Object | undefined { + return this._objects.get(value); + } + + setObject(key: string, objectClass: Object): void { + this._objects.set(key, objectClass); + } +} +``` MyFirstAbility.ts ```ts import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback'; import AbilityStage from '@ohos.app.ability.AbilityStage'; import UIAbility from '@ohos.app.ability.UIAbility'; +import { GlobalContext } from '../GlobalContext' // 声明ability生命周期回调，需配置所有回调后才可以在applicationContext注册 -let abilityLifecycleCallback = { +let abilityLifecycleCallback: AbilityLifecycleCallback = { onAbilityCreate(ability){ console.log('AbilityLifecycleCallback onAbilityCreate.'); }, @@ -272,7 +315,8 @@ export default class MyFirstAbility extends UIAbility { let applicationContext = this.context.getApplicationContext(); // 2.通过applicationContext注册监听应用内生命周期 try { - globalThis.lifecycleId = applicationContext.on('abilityLifecycle', abilityLifecycleCallback); + let lifecycleId = applicationContext.on('abilityLifecycle', abilityLifecycleCallback); + GlobalContext.getContext().setObject("lifecycleId", lifecycleId); console.log('registerAbilityLifecycleCallback lifecycleId: ${globalThis.lifecycleId}'); } catch (paramError) { console.error('error: ${paramError.code}, ${paramError.message}'); @@ -284,12 +328,14 @@ export default class MyFirstAbility extends UIAbility { MySecondAbility.ts ```ts import UIAbility from '@ohos.app.ability.UIAbility'; +import { GlobalContext } from '../GlobalContext' export default class MySecondAbility extends UIAbility { onDestroy() { let applicationContext = this.context.getApplicationContext(); + let lifecycleId: number = GlobalContext.getContext().getObject("lifecycleId"); // 3.通过applicationContext注销监听应用内生命周期 - applicationContext.off('abilityLifecycle', globalThis.lifecycleId, (error) => { + applicationContext.off('abilityLifecycle', lifecycleId, (error) => { if (error && error.code !== 0) { console.error('unregisterAbilityLifecycleCallback fail, error: ${JSON.stringify(error)}'); } else { diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md index 6e452d75ec85680f82d4b9318411e4c53524d6f5..1490004ba313a6433fa78fd30d9feb93a64a7a3c 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md @@ -59,9 +59,10 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\): void ```ts import abilityManager from '@ohos.app.ability.abilityManager'; +import { Configuration } from '@ohos.app.ability.Configuration'; import ConfigurationConstant from '@ohos.app.ability.ConfigurationConstant'; -const config = { +const config: Configuration = { language: 'Zh-Hans', // 简体中文 colorMode: ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT, // 浅色模式 direction: ConfigurationConstant.Direction.DIRECTION_VERTICAL, // 垂直方向 @@ -117,9 +118,11 @@ updateConfiguration(config: Configuration): Promise\ ```ts import abilityManager from '@ohos.app.ability.abilityManager'; +import { Configuration } from '@ohos.app.ability.Configuration'; import ConfigurationConstant from '@ohos.app.ability.ConfigurationConstant'; +import { BusinessError } from '@ohos.base'; -const config = { +const config: Configuration = { language: 'Zh-Hans', // 简体中文 colorMode: ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT, // 浅色模式 direction: ConfigurationConstant.Direction.DIRECTION_VERTICAL, // 垂直方向 @@ -131,7 +134,7 @@ const config = { try { abilityManager.updateConfiguration(config).then(() => { console.log('updateConfiguration success.'); - }).catch((err) => { + }).catch((err: BusinessError) => { console.error('updateConfiguration fail, err: ${JSON.stringify(err)}'); }); } catch (paramError) { @@ -209,11 +212,12 @@ getAbilityRunningInfos(): Promise\> ```ts import abilityManager from '@ohos.app.ability.abilityManager'; +import { BusinessError } from '@ohos.base'; try { abilityManager.getAbilityRunningInfos().then((data) => { console.log('getAbilityRunningInfos success, data: ${JSON.stringify(data)}'); - }).catch((err) => { + }).catch((err: BusinessError) => { console.error('getAbilityRunningInfos fail, err: ${JSON.stringify(err)}'); }); } catch (paramError) { @@ -300,13 +304,14 @@ getExtensionRunningInfos(upperLimit: number): Promise\ { console.log('getExtensionRunningInfos success, data: ${JSON.stringify(data)}'); - }).catch((err) => { + }).catch((err: BusinessError) => { console.error('getExtensionRunningInfos fail, err: ${JSON.stringify(err)}'); }); } catch (paramError) { @@ -376,10 +381,11 @@ getTopAbility(): Promise\; ```ts import abilityManager from '@ohos.app.ability.abilityManager'; +import { BusinessError } from '@ohos.base'; abilityManager.getTopAbility().then((data) => { console.log('getTopAbility success, data: ${JSON.stringify(data)}'); -}).catch((err) => { +}).catch((err: BusinessError) => { console.error('getTopAbility fail, err: ${JSON.stringify(err)}'); }); ``` @@ -413,6 +419,8 @@ acquireShareData(missionId: number, callback: AsyncCallback<{[key: string]: Obje ```ts import abilityManager from '@ohos.app.ability.abilityManager'; +import { BusinessError } from '@ohos.base'; + try { abilityManager.acquireShareData(1, (err, wantParam) => { if (err) { @@ -422,7 +430,9 @@ try { } }); } catch (paramError) { - console.error(`error.code: ${JSON.stringify(paramError.code)}, error.message: ${JSON.stringify(paramError.message)}`); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`error.code: ${JSON.stringify(code)}, error.message: ${JSON.stringify(message)}`); } ``` @@ -461,13 +471,17 @@ acquireShareData(missionId: number): Promise<{[key: string]: Object}>; ```ts import abilityManager from '@ohos.app.ability.abilityManager'; +import { BusinessError } from '@ohos.base'; + try { abilityManager.acquireShareData(1).then((wantParam) => { console.log(`acquireShareData success, data: ${JSON.stringify(wantParam)}`); - }).catch((err) => { + }).catch((err: BusinessError) => { console.error(`acquireShareData fail, err: ${JSON.stringify(err)}`); }); } catch (paramError) { - console.error(`error.code: ${JSON.stringify(paramError.code)}, error.message: ${JSON.stringify(paramError.message)}`); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`error.code: ${JSON.stringify(code)}, error.message: ${JSON.stringify(message)}`); } ``` \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityStage.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityStage.md index 88a86bab78622a767b20e517fc7939f3d0e97b44..d6d9276f0675fabd5b8d36c82cb1ed3444bb32c2 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityStage.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityStage.md @@ -60,9 +60,10 @@ onAcceptWant(want: Want): string; ```ts import AbilityStage from '@ohos.app.ability.AbilityStage'; +import Want from '@ohos.app.ability.Want'; class MyAbilityStage extends AbilityStage { - onAcceptWant(want) { + onAcceptWant(want: Want) { console.log('MyAbilityStage.onAcceptWant called'); return 'com.example.test'; } @@ -88,9 +89,10 @@ onConfigurationUpdate(newConfig: Configuration): void; ```ts import AbilityStage from '@ohos.app.ability.AbilityStage'; +import { Configuration } from '@ohos.app.ability.Configuration'; class MyAbilityStage extends AbilityStage { - onConfigurationUpdate(config) { + onConfigurationUpdate(config: Configuration) { console.log('onConfigurationUpdate, language: ${config.language}'); } } @@ -114,9 +116,10 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void; ```ts import AbilityStage from '@ohos.app.ability.AbilityStage'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; class MyAbilityStage extends AbilityStage { - onMemoryLevel(level) { + onMemoryLevel(level: AbilityConstant.MemoryLevel) { console.log('onMemoryLevel, level: ${JSON.stringify(level)}'); } } diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md index 64e8a9c391835497fb41c8850bc0ac0d3ab0849d..2f53b1e3ad6f65f87732cf06f09ebf19c1a9be62 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md @@ -75,10 +75,11 @@ static isRunningInStabilityTest(): Promise<boolean> ```ts import appManager from '@ohos.app.ability.appManager'; +import { BusinessError } from '@ohos.base'; appManager.isRunningInStabilityTest().then((flag) => { console.log(`The result of isRunningInStabilityTest is: ${JSON.stringify(flag)}`); -}).catch((error) => { +}).catch((error: BusinessError) => { console.error(`error: ${JSON.stringify(error)}`); }); ``` @@ -110,10 +111,11 @@ isRamConstrainedDevice(): Promise\; ```ts import appManager from '@ohos.app.ability.appManager'; +import { BusinessError } from '@ohos.base'; appManager.isRamConstrainedDevice().then((data) => { console.log(`The result of isRamConstrainedDevice is: ${JSON.stringify(data)}`); -}).catch((error) => { +}).catch((error: BusinessError) => { console.error(`error: ${JSON.stringify(error)}`); }); ``` @@ -180,10 +182,11 @@ getAppMemorySize(): Promise\; ```ts import appManager from '@ohos.app.ability.appManager'; +import { BusinessError} from '@ohos.base' appManager.getAppMemorySize().then((data) => { console.log(`The size of app memory is: ${JSON.stringify(data)}`); -}).catch((error) => { +}).catch((error: BusinessError) => { console.error(`error: ${JSON.stringify(error)}`); }); ``` @@ -252,10 +255,11 @@ getRunningProcessInformation(): Promise\>; ```ts import appManager from '@ohos.app.ability.appManager'; +import { BusinessError } from '@ohos.base'; appManager.getRunningProcessInformation().then((data) => { console.log(`The running process information is: ${JSON.stringify(data)}`); -}).catch((error) => { +}).catch((error: BusinessError) => { console.error(`error: ${JSON.stringify(error)}`); }); ``` @@ -335,12 +339,13 @@ isSharedBundleRunning(bundleName: string, versionCode: number): Promise\ { console.log(`The shared bundle running is: ${JSON.stringify(data)}`); -}).catch((error) => { +}).catch((error: BusinessError) => { console.error(`error: ${JSON.stringify(error)}`); }); ``` @@ -426,8 +431,9 @@ on(type: 'applicationState', observer: ApplicationStateObserver): number; ```ts import appManager from '@ohos.app.ability.appManager'; +import { BusinessError } from '@ohos.base'; -let applicationStateObserver = { +let applicationStateObserver: appManager.ApplicationStateObserver = { onForegroundApplicationChanged(appStateData) { console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`); }, @@ -448,7 +454,9 @@ try { const observerId = appManager.on('applicationState', applicationStateObserver); console.log(`[appManager] observerCode: ${observerId}`); } catch (paramError) { - console.error(`[appManager] error: ${paramError.code}, ${paramError.message} `); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`[appManager] error: ${code}, ${message} `); } ``` @@ -490,8 +498,9 @@ on(type: 'applicationState', observer: ApplicationStateObserver, bundleNameList: ```ts import appManager from '@ohos.app.ability.appManager'; +import { BusinessError } from '@ohos.base'; -let applicationStateObserver = { +let applicationStateObserver: appManager.ApplicationStateObserver = { onForegroundApplicationChanged(appStateData) { console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`); }, @@ -513,7 +522,9 @@ try { const observerId = appManager.on('applicationState', applicationStateObserver, bundleNameList); console.log(`[appManager] observerCode: ${observerId}`); } catch (paramError) { - console.error(`[appManager] error: ${paramError.code}, ${paramError.message} `); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`[appManager] error: ${code}, ${message} `); } ``` @@ -549,11 +560,12 @@ off(type: 'applicationState', observerId: number, callback: AsyncCallback\; ```ts import appManager from '@ohos.app.ability.appManager'; +import { BusinessError } from '@ohos.base'; let observerId = 0; // 1.注册应用状态监听器 -let applicationStateObserver = { +let applicationStateObserver: appManager.ApplicationStateObserver = { onForegroundApplicationChanged(appStateData) { console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`); }, @@ -654,20 +671,23 @@ let applicationStateObserver = { let bundleNameList = ['bundleName1', 'bundleName2']; try { observerId = appManager.on('applicationState', applicationStateObserver, bundleNameList); - console.log(`[appManager] observerCode: ${observerId}`); } catch (paramError) { - console.error(`[appManager] error: ${paramError.code}, ${paramError.message} `); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`[appManager] error: ${code}, ${message} `); } // 2.注销应用状态监听器 try { appManager.off('applicationState', observerId).then((data) => { console.log(`unregisterApplicationStateObserver success, data: ${JSON.stringify(data)}`); - }).catch((err) => { + }).catch((err: BusinessError) => { console.error(`unregisterApplicationStateObserver fail, err: ${JSON.stringify(err)}`); }); } catch (paramError) { - console.error(`error: ${paramError.code}, ${paramError.message}`); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`[appManager] error: ${code}, ${message} `); } ``` @@ -701,8 +721,9 @@ getForegroundApplications(callback: AsyncCallback\>): void; ```ts import appManager from '@ohos.app.ability.appManager'; +import { BusinessError } from '@ohos.base'; -function getForegroundApplicationsCallback(err, data) { +function getForegroundApplicationsCallback(err: BusinessError, data: Array) { if (err) { console.error(`getForegroundApplicationsCallback fail, err: ${JSON.stringify(err)}`); } else { @@ -712,7 +733,9 @@ function getForegroundApplicationsCallback(err, data) { try { appManager.getForegroundApplications(getForegroundApplicationsCallback); } catch (paramError) { - console.error(`error: ${paramError.code}, ${paramError.message}`); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`[appManager] error: ${code}, ${message} `); } ``` @@ -746,10 +769,11 @@ getForegroundApplications(): Promise\>; ```ts import appManager from '@ohos.app.ability.appManager'; +import { BusinessError } from '@ohos.base'; appManager.getForegroundApplications().then((data) => { console.log(`getForegroundApplications success, data: ${JSON.stringify(data)}`); -}).catch((err) => { +}).catch((err: BusinessError) => { console.error(`getForegroundApplications fail, err: ${JSON.stringify(err)}`); }); ``` @@ -789,17 +813,20 @@ killProcessWithAccount(bundleName: string, accountId: number): Promise\ ```ts import appManager from '@ohos.app.ability.appManager'; +import { BusinessError } from '@ohos.base'; let bundleName = 'bundleName'; let accountId = 0; try { appManager.killProcessWithAccount(bundleName, accountId).then(() => { console.log('killProcessWithAccount success'); - }).catch((err) => { + }).catch((err: BusinessError) => { console.error(`killProcessWithAccount fail, err: ${JSON.stringify(err)}`); }); } catch (paramError) { - console.error(`error: ${paramError.code}, ${paramError.message}`); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`[appManager] error: ${code}, ${message} `); } ``` @@ -840,10 +867,11 @@ killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCal ```ts import appManager from '@ohos.app.ability.appManager'; +import { BusinessError } from '@ohos.base'; let bundleName = 'bundleName'; let accountId = 0; -function killProcessWithAccountCallback(err, data) { +function killProcessWithAccountCallback(err: BusinessError) { if (err) { console.error(`killProcessWithAccountCallback fail, err: ${JSON.stringify(err)}`); } else { @@ -884,9 +912,10 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\); ```ts import appManager from '@ohos.app.ability.appManager'; +import { BusinessError } from '@ohos.base'; let bundleName = 'bundleName'; -function killProcessesByBundleNameCallback(err, data) { +function killProcessesByBundleNameCallback(err: BusinessError) { if (err) { console.error(`killProcessesByBundleNameCallback fail, err: ${JSON.stringify(err)}`); } else { @@ -896,7 +925,9 @@ function killProcessesByBundleNameCallback(err, data) { try { appManager.killProcessesByBundleName(bundleName, killProcessesByBundleNameCallback); } catch (paramError) { - console.error(`error: ${paramError.code}, ${paramError.message}`); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`[appManager] error: ${code}, ${message} `); } ``` @@ -936,16 +967,19 @@ killProcessesByBundleName(bundleName: string): Promise\; ```ts import appManager from '@ohos.app.ability.appManager'; +import { BusinessError } from '@ohos.base'; let bundleName = 'bundleName'; try { appManager.killProcessesByBundleName(bundleName).then((data) => { console.log('killProcessesByBundleName success.'); - }).catch((err) => { + }).catch((err: BusinessError) => { console.error(`killProcessesByBundleName fail, err: ${JSON.stringify(err)}`); }); } catch (paramError) { - console.error(`error: ${paramError.code}, ${paramError.message}`); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`[appManager] error: ${code}, ${message} `); } ``` @@ -980,9 +1014,10 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\); ```ts import appManager from '@ohos.app.ability.appManager'; +import { BusinessError } from '@ohos.base'; let bundleName = 'bundleName'; -function clearUpApplicationDataCallback(err, data) { +function clearUpApplicationDataCallback(err: BusinessError) { if (err) { console.error(`clearUpApplicationDataCallback fail, err: ${JSON.stringify(err)}`); } else { @@ -992,7 +1027,9 @@ function clearUpApplicationDataCallback(err, data) { try { appManager.clearUpApplicationData(bundleName, clearUpApplicationDataCallback); } catch (paramError) { - console.error(`error: ${paramError.code}, ${paramError.message}`); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`[appManager] error: ${code}, ${message} `); } ``` @@ -1032,16 +1069,19 @@ clearUpApplicationData(bundleName: string): Promise\; ```ts import appManager from '@ohos.app.ability.appManager'; +import { BusinessError } from '@ohos.base'; let bundleName = 'bundleName'; try { appManager.clearUpApplicationData(bundleName).then((data) => { console.log('clearUpApplicationData success.'); - }).catch((err) => { + }).catch((err: BusinessError) => { console.error(`clearUpApplicationData fail, err: ${JSON.stringify(err)}`); }); } catch (paramError) { - console.error(`error: ${paramError.code}, ${paramError.message}`); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`[appManager] error: ${code}, ${message} `); } ``` @@ -1074,9 +1114,10 @@ getProcessMemoryByPid(pid: number, callback: AsyncCallback\): void; ```ts import appManager from '@ohos.app.ability.appManager'; +import { BusinessError } from '@ohos.base'; let pid = 0; -function getProcessMemoryByPidCallback(err, data) { +function getProcessMemoryByPidCallback(err: BusinessError, data: number) { if (err) { console.error(`getProcessMemoryByPidCallback fail, err: ${JSON.stringify(err)}`); } else { @@ -1086,7 +1127,9 @@ function getProcessMemoryByPidCallback(err, data) { try { appManager.getProcessMemoryByPid(pid, getProcessMemoryByPidCallback); } catch (paramError) { - console.error(`error: ${paramError.code}, ${paramError.message}`); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`[appManager] error: ${code}, ${message} `); } ``` @@ -1124,16 +1167,19 @@ getProcessMemoryByPid(pid: number): Promise\; ```ts import appManager from '@ohos.app.ability.appManager'; +import { BusinessError } from '@ohos.base'; let pid = 0; try { appManager.getProcessMemoryByPid(pid).then((data) => { console.log('getProcessMemoryByPid success.'); - }).catch((err) => { + }).catch((err: BusinessError) => { console.error(`getProcessMemoryByPid fail, err: ${JSON.stringify(err)}`); }); } catch (paramError) { - console.error(`error: ${paramError.code}, ${paramError.message}`); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`[appManager] error: ${code}, ${message} `); } ``` @@ -1166,9 +1212,10 @@ getRunningProcessInfoByBundleName(bundleName: string, callback: AsyncCallback\) { if (err) { console.error(`getRunningProcessInfoByBundleNameCallback fail, err: ${JSON.stringify(err)}`); } else { @@ -1178,7 +1225,9 @@ function getRunningProcessInfoByBundleNameCallback(err, data) { try { appManager.getRunningProcessInfoByBundleName(bundleName, getRunningProcessInfoByBundleNameCallback); } catch (paramError) { - console.error(`error: ${paramError.code}, ${paramError.message}`); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`[appManager] error: ${code}, ${message} `); } ``` @@ -1216,16 +1265,19 @@ getRunningProcessInfoByBundleName(bundleName: string): Promise\ { console.log('getRunningProcessInfoByBundleName success.'); - }).catch((err) => { + }).catch((err: BusinessError) => { console.error(`getRunningProcessInfoByBundleName fail, err: ${JSON.stringify(err)}`); }); } catch (paramError) { - console.error(`error: ${paramError.code}, ${paramError.message}`); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`[appManager] error: ${code}, ${message} `); } ``` @@ -1259,10 +1311,11 @@ getRunningProcessInfoByBundleName(bundleName: string, userId: number, callback: ```ts import appManager from '@ohos.app.ability.appManager'; +import { BusinessError } from '@ohos.base'; let bundleName = "bundleName"; let userId = 0; -function getRunningProcessInfoByBundleNameCallback(err, data) { +function getRunningProcessInfoByBundleNameCallback(err: BusinessError, data: Array) { if (err) { console.error(`getRunningProcessInfoByBundleNameCallback fail, err: ${JSON.stringify(err)}`); } else { @@ -1272,7 +1325,9 @@ function getRunningProcessInfoByBundleNameCallback(err, data) { try { appManager.getRunningProcessInfoByBundleName(bundleName, userId, getRunningProcessInfoByBundleNameCallback); } catch (paramError) { - console.error(`error: ${paramError.code}, ${paramError.message}`); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`[appManager] error: ${code}, ${message} `); } ``` @@ -1311,17 +1366,20 @@ getRunningProcessInfoByBundleName(bundleName: string, userId: number): Promise\< ```ts import appManager from '@ohos.app.ability.appManager'; +import { BusinessError } from '@ohos.base'; let bundleName = "bundleName"; let userId = 0; try { appManager.getRunningProcessInfoByBundleName(bundleName, userId).then((data) => { console.log('getRunningProcessInfoByBundleName success.'); - }).catch((err) => { + }).catch((err: BusinessError) => { console.error(`getRunningProcessInfoByBundleName fail, err: ${JSON.stringify(err)}`); }); } catch (paramError) { - console.error(`error: ${paramError.code}, ${paramError.message}`); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`[appManager] error: ${code}, ${message} `); } ``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-appRecovery.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-appRecovery.md index cad9fac4b66a28c0a8f310e639330e5108648823..b76eef09225e3ba3799cc64e6e7d20b8aba2d50a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-appRecovery.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-appRecovery.md @@ -101,7 +101,7 @@ API10时将启动由[setRestartWant](#apprecoverysetrestartwant)指定的Ability import appRecovery from '@ohos.app.ability.appRecovery'; import errorManager from '@ohos.app.ability.errorManager'; -let observer = { +let observer: errorManager.ErrorObserver = { onUnhandledException(errorMsg) { console.log('onUnhandledException, errorMsg: ', errorMsg); appRecovery.restartApp(); @@ -135,7 +135,7 @@ saveAppState(): boolean; import appRecovery from '@ohos.app.ability.appRecovery'; import errorManager from '@ohos.app.ability.errorManager'; -let observer = { +let observer: errorManager.ErrorObserver = { onUnhandledException(errorMsg) { console.log('onUnhandledException, errorMsg: ', errorMsg); appRecovery.saveAppState(); @@ -175,7 +175,7 @@ saveAppState(context?: UIAbilityContext): boolean; import appRecovery from '@ohos.app.ability.appRecovery'; import errorManager from '@ohos.app.ability.errorManager'; -let observer = { +let observer: errorManager.ErrorObserver = { onUnhandledException(errorMsg) { console.log('onUnhandledException, errorMsg: ', errorMsg); appRecovery.saveAppState(this.context); @@ -207,12 +207,14 @@ setRestartWant(want: Want): void; ```ts import appRecovery from '@ohos.app.ability.appRecovery'; +import Want from '@ohos.app.ability.Want'; + Button("启动到恢复Ability") .fontSize(40) .fontWeight(FontWeight.Bold) .onClick(()=> { // set restart want - let want = { + let want: Want = { bundleName: "ohos.samples.recovery", abilityName: "RecoveryAbility" }; diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-applicationStateChangeCallback.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-applicationStateChangeCallback.md index 4cd659d4c26666e669aece55ff7f9d6845eb4447..68e1ff54da71d5237c9bde4cdf6d6e3e69774453 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-applicationStateChangeCallback.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-applicationStateChangeCallback.md @@ -25,26 +25,56 @@ onApplicationForeground(): void; ```ts import UIAbility from '@ohos.app.ability.UIAbility'; +import ApplicationStateChangeCallback from '@ohos.app.ability.ApplicationStateChangeCallback'; + +// 构造单例对象 +export class GlobalContext { + private constructor() {} + private static instance: GlobalContext; + private _objects = new Map(); + + public static getContext(): GlobalContext { + if (!GlobalContext.instance) { + GlobalContext.instance = new GlobalContext(); + } + return GlobalContext.instance; + } + + getObject(value: string): Object | undefined { + return this._objects.get(value); + } -globalThis.applicationStateChangeCallback = { + setObject(key: string, objectClass: Object): void { + this._objects.set(key, objectClass); + } +} + +let applicationStateChangeCallback: ApplicationStateChangeCallback = { onApplicationForeground() { console.info('applicationStateChangeCallback onApplicationForeground'); } } +GlobalContext.getContext().setObject("applicationStateChangeCallback", applicationStateChangeCallback); export default class MyAbility extends UIAbility { onCreate() { console.log('MyAbility onCreate'); - globalThis.applicationContext = this.context.getApplicationContext(); + GlobalContext.getContext().setObject("applicationContext", this.context.getApplicationContext()); // 1.获取applicationContext - let applicationContext = globalThis.applicationContext; + let applicationContext = GlobalContext.getContext().getObject("applicationContext"); // 2.通过applicationContext注册应用前后台状态监听 - applicationContext.on('applicationStateChange', globalThis.ApplicationStateChangeCallback); + if (applicationContext != undefined) { + applicationContext.on('applicationStateChange', + GlobalContext.getContext().getObject("applicationStateChangeCallback")); + } } onDestroy() { - let applicationContext = globalThis.applicationContext; + let applicationContext = GlobalContext.getContext().getObject("applicationContext"); // 1.通过applicationContext解除注册应用前后台状态监听 - applicationContext.off('applicationStateChange', globalThis.ApplicationStateChangeCallback); + if (applicationContext != undefined) { + applicationContext.off('applicationStateChange', + GlobalContext.getContext().getObject("applicationStateChangeCallback")); + } } } ``` @@ -61,27 +91,56 @@ onApplicationBackground(): void; ```ts import UIAbility from '@ohos.app.ability.UIAbility'; +import ApplicationStateChangeCallback from '@ohos.app.ability.ApplicationStateChangeCallback'; + +export class GlobalContext { + private constructor() {} + private static instance: GlobalContext; + private _objects = new Map(); + + public static getContext(): GlobalContext { + if (!GlobalContext.instance) { + GlobalContext.instance = new GlobalContext(); + } + return GlobalContext.instance; + } + + getObject(value: string): Object | undefined { + return this._objects.get(value); + } + + setObject(key: string, objectClass: Object): void { + this._objects.set(key, objectClass); + } +} -globalThis.applicationStateChangeCallback = { +let applicationStateChangeCallback: ApplicationStateChangeCallback = { onApplicationBackground() { console.info('applicationStateChangeCallback onApplicationBackground'); } } +GlobalContext.getContext().setObject("applicationStateChangeCallback", applicationStateChangeCallback); export default class MyAbility extends UIAbility { onCreate() { console.log('MyAbility onCreate'); - globalThis.applicationContext = this.context.getApplicationContext(); + GlobalContext.getContext().setObject("applicationContext", this.context.getApplicationContext()); // 1.获取applicationContext - let applicationContext = globalThis.applicationContext; + let applicationContext = GlobalContext.getContext().getObject("applicationContext"); // 2.通过applicationContext注册应用前后台状态监听 - applicationContext.on('applicationStateChange', globalThis.ApplicationStateChangeCallback); + if (applicationContext != undefined) { + applicationContext.on('applicationStateChange', + GlobalContext.getContext().getObject("applicationStateChangeCallback")); + } console.log('Resgiter applicationStateChangeCallback'); } onDestroy() { - let applicationContext = globalThis.applicationContext; + let applicationContext = GlobalContext.getContext().getObject("applicationContext"); // 1.通过applicationContext解除注册应用前后台状态监听 - applicationContext.off('applicationStateChange', globalThis.ApplicationStateChangeCallback); + if (applicationContext != undefined) { + applicationContext.off('applicationStateChange', + GlobalContext.getContext().getObject("applicationStateChangeCallback")); + } } } ``` \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-configuration.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-configuration.md index 67ff713322188b7817a183df43a4e2c4446e6b29..1c5e9a898d3f61772b75668c7f59b934f1c8af81 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-configuration.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-configuration.md @@ -31,10 +31,13 @@ import Configuration from '@ohos.app.ability.Configuration'; ```ts import UIAbility from '@ohos.app.ability.UIAbility'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; +import EnvironmentCallback from '@ohos.app.ability.EnvironmentCallback'; +import Want from '@ohos.app.ability.Want'; export default class EntryAbility extends UIAbility { - onCreate(want, launchParam) { - let envCallback = { + onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { + let envCallback: EnvironmentCallback = { onConfigurationUpdated(config) { console.info(`envCallback onConfigurationUpdated success: ${JSON.stringify(config)}`); let language = config.language; diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-dataUriUtils.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-dataUriUtils.md index 15b94a4fb2dcbbe24b7be920716a994aa2a6ee45..6fb84111dc9a76bb8f88ce884f966f9b353ba907 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-dataUriUtils.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-dataUriUtils.md @@ -35,6 +35,8 @@ getId(uri: string): number **示例：** ```ts +import dataUriUtils from '@ohos.app.ability.dataUriUtils'; + try { let id = dataUriUtils.getId('com.example.dataUriUtils/1221'); console.info('get id: ${id}'); @@ -69,6 +71,8 @@ attachId(uri: string, id: number): string **示例：** ```ts +import dataUriUtils from '@ohos.app.ability.dataUriUtils'; + let id = 1122; try { let uri = dataUriUtils.attachId( @@ -107,6 +111,8 @@ deleteId(uri: string): string **示例：** ```ts +import dataUriUtils from '@ohos.app.ability.dataUriUtils'; + try { let uri = dataUriUtils.deleteId('com.example.dataUriUtils/1221'); console.info('delete id with the uri is: ${uri}'); @@ -142,6 +148,7 @@ updateId(uri: string, id: number): string **示例：** ```ts +import dataUriUtils from '@ohos.app.ability.dataUriUtils'; try { let id = 1122; diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-dialogRequest.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-dialogRequest.md index 7375d269e851f205f37a74a37437618ec66422b0..9d23dacec669e18663fe6a68a4dc5b4df6db265d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-dialogRequest.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-dialogRequest.md @@ -38,17 +38,18 @@ getRequestInfo(want: Want): RequestInfo ```ts import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility'; + import Want from '@ohos.app.ability.Want'; import rpc from '@ohos.rpc'; import dialogRequest from '@ohos.app.ability.dialogRequest'; const REQUEST_VALUE = 1; class StubTest extends rpc.RemoteObject { - constructor(des) { + constructor(des: string) { super(des); } - onRemoteRequest(code, data, reply, option) { + onRemoteRequest(code: number, data: rpc.MessageParcel, reply: rpc.MessageParcel, option: rpc.MessageOption) { if (code === REQUEST_VALUE) { let optFir = data.readInt(); let optSec = data.readInt(); @@ -57,10 +58,6 @@ getRequestInfo(want: Want): RequestInfo return true; } - queryLocallInterface(descriptor) { - return null; - } - getInterfaceDescriptor() { return ""; } @@ -73,32 +70,32 @@ getRequestInfo(want: Want): RequestInfo return REQUEST_VALUE; } - attachLocalInterface(localInterface, descriptor) { + attachLocalInterface(localInterface: rpc.IRemoteBroker, descriptor: string) { } } let TAG = "getRequestInfoTest"; export default class ServiceExtAbility extends ServiceExtensionAbility { - onCreate(want) { + onCreate(want: Want) { console.info(TAG, `onCreate, want: ${want.abilityName}`); } - onRequest(want, startId) { + onRequest(want: Want, startId: number) { console.info(TAG, `onRequest, want: ${want.abilityName}`); try { - var requestInfo = dialogRequest.getRequestInfo(want); + let requestInfo = dialogRequest.getRequestInfo(want); } catch (err) { console.error('getRequestInfo err= ${JSON.stringify(err)}'); } } - onConnect(want) { + onConnect(want: Want) { console.info(TAG, `onConnect, want: ${want.abilityName}`); return new StubTest("test"); } - onDisconnect(want) { + onDisconnect(want: Want) { console.info(TAG, `onDisconnect, want: ${want.abilityName}`); } @@ -132,6 +129,7 @@ getRequestCallback(want: Want): RequestCallback ```ts import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility'; + import Want from '@ohos.app.ability.Want'; import rpc from '@ohos.rpc'; import dialogRequest from '@ohos.app.ability.dialogRequest'; @@ -140,11 +138,11 @@ getRequestCallback(want: Want): RequestCallback const REQUEST_VALUE = 1; class StubTest extends rpc.RemoteObject { - constructor(des) { + constructor(des: string) { super(des); } - onRemoteRequest(code, data, reply, option) { + onRemoteRequest(code: number, data: rpc.MessageParcel, reply: rpc.MessageParcel, option: rpc.MessageOption) { if (code === REQUEST_VALUE) { let optFir = data.readInt(); let optSec = data.readInt(); @@ -153,10 +151,6 @@ getRequestCallback(want: Want): RequestCallback return true; } - queryLocallInterface(descriptor) { - return null; - } - getInterfaceDescriptor() { return ""; } @@ -169,30 +163,30 @@ getRequestCallback(want: Want): RequestCallback return REQUEST_VALUE; } - attachLocalInterface(localInterface, descriptor) { + attachLocalInterface(localInterface: rpc.IRemoteBroker, descriptor: string) { } } export default class ServiceExtAbility extends ServiceExtensionAbility { - onCreate(want) { + onCreate(want: Want) { console.info(TAG, `onCreate, want: ${want.abilityName}`); } - onRequest(want, startId) { + onRequest(want: Want, startId: number) { console.info(TAG, `onRequest, want: ${want.abilityName}`); try { - var requestCallback = dialogRequest.getRequestCallback(want); + let requestCallback = dialogRequest.getRequestCallback(want); } catch(err) { console.error('getRequestInfo err= ${JSON.stringify(err)}'); } } - onConnect(want) { + onConnect(want: Want) { console.info(TAG, `onConnect, want: ${want.abilityName}`); return new StubTest("test"); } - onDisconnect(want) { + onDisconnect(want: Want) { console.info(TAG, `onDisconnect, want: ${want.abilityName}`); } @@ -211,6 +205,8 @@ getRequestCallback(want: Want): RequestCallback ```ts import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility'; + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; import rpc from '@ohos.rpc'; import dialogRequest from '@ohos.app.ability.dialogRequest'; import window from '@ohos.window'; @@ -220,11 +216,11 @@ getRequestCallback(want: Want): RequestCallback const REQUEST_VALUE = 1; class StubTest extends rpc.RemoteObject { - constructor(des) { + constructor(des: string) { super(des); } - onRemoteRequest(code, data, reply, option) { + onRemoteRequest(code: number, data: rpc.MessageParcel, reply: rpc.MessageParcel, option: rpc.MessageOption) { if (code === REQUEST_VALUE) { let optFir = data.readInt(); let optSec = data.readInt(); @@ -233,10 +229,6 @@ getRequestCallback(want: Want): RequestCallback return true; } - queryLocallInterface(descriptor) { - return null; - } - getInterfaceDescriptor() { return ""; } @@ -249,41 +241,48 @@ getRequestCallback(want: Want): RequestCallback return REQUEST_VALUE; } - attachLocalInterface(localInterface, descriptor) { + attachLocalInterface(localInterface: rpc.IRemoteBroker, descriptor: string) { } } export default class ServiceExtAbility extends ServiceExtensionAbility { - onCreate(want) { + onCreate(want: Want) { console.info(TAG, `onCreate, want: ${want.abilityName}`); } - onRequest(want, startId) { + onRequest(want: Want, startId: number) { console.info(TAG, `onRequest, want: ${want.abilityName}`); + let windowClass: window.Window | undefined = undefined; + let config: window.Configuration = {name: "dialogWindow", windowType: window.WindowType.TYPE_DIALOG, ctx: this.context}; try { - var requestInfo = dialogRequest.getRequestInfo(want); - let windowClass = null; - windowClass.bindDialogTarget(requestInfo, () => { + let requestInfo = dialogRequest.getRequestInfo(want); + window.createWindow(config, (err, data) => { + if (err.code) { + console.error('Failed to create the window. Cause: ' + JSON.stringify(err)); + return; + } + windowClass = data; + windowClass.bindDialogTarget(requestInfo, () => { console.info('Dialog Window Need Destroy.'); - }, (err) => { - if (err.code) { - console.error('Failed to bind dialog target. Cause: ${JSON.stringify(err)}'); - return; - } - console.info('Succeeded in binding dialog target.'); + }, (err: BusinessError) => { + if (err.code) { + console.error('Failed to bind dialog target. Cause: ${JSON.stringify(err)}'); + return; + } + console.info('Succeeded in binding dialog target.'); + }); }); } catch(err) { console.error('getRequestInfo err= ${JSON.stringify(err)}'); } } - onConnect(want) { + onConnect(want: Want) { console.info(TAG, `onConnect, want: ${want.abilityName}`); - return new StubTest("test"); - + return new StubTest("test"); } - onDisconnect(want) { + onDisconnect(want: Want) { console.info(TAG, `onDisconnect, want: ${want.abilityName}`); } @@ -345,6 +344,7 @@ setRequestResult(result: RequestResult): void; ```ts import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility'; + import Want from '@ohos.app.ability.Want'; import rpc from '@ohos.rpc'; import dialogRequest from '@ohos.app.ability.dialogRequest'; @@ -353,11 +353,11 @@ setRequestResult(result: RequestResult): void; const REQUEST_VALUE = 1; class StubTest extends rpc.RemoteObject { - constructor(des) { + constructor(des: string) { super(des); } - onRemoteRequest(code, data, reply, option) { + onRemoteRequest(code: number, data: rpc.MessageParcel, reply: rpc.MessageParcel, option: rpc.MessageOption) { if (code === REQUEST_VALUE) { let optFir = data.readInt(); let optSec = data.readInt(); @@ -366,10 +366,6 @@ setRequestResult(result: RequestResult): void; return true; } - queryLocallInterface(descriptor) { - return null; - } - getInterfaceDescriptor() { return ""; } @@ -382,20 +378,20 @@ setRequestResult(result: RequestResult): void; return REQUEST_VALUE; } - attachLocalInterface(localInterface, descriptor) { + attachLocalInterface(localInterface: rpc.IRemoteBroker, descriptor: string) { } } export default class ServiceExtAbility extends ServiceExtensionAbility { - onCreate(want) { + onCreate(want: Want) { console.info(TAG, `onCreate, want: ${want.abilityName}`); } - onRequest(want, startId) { + onRequest(want: Want, startId: number) { console.info(TAG, `onRequest, want: ${want.abilityName}`); try { - var requestCallback = dialogRequest.getRequestCallback(want); - let myResult = { + let requestCallback = dialogRequest.getRequestCallback(want); + let myResult: dialogRequest.RequestResult = { result : dialogRequest.ResultCode.RESULT_CANCEL, }; requestCallback.setRequestResult(myResult); @@ -404,12 +400,12 @@ setRequestResult(result: RequestResult): void; } } - onConnect(want) { + onConnect(want: Want) { console.info(TAG, `onConnect, want: ${want.abilityName}`); - return new StubTest("test"); + return new StubTest("test"); } - onDisconnect(want) { + onDisconnect(want: Want) { console.info(TAG, `onDisconnect, want: ${want.abilityName}`); } diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-environmentCallback.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-environmentCallback.md index af9b9b229f351d55370c3a3967256c1c6000fc33..13846fea1842b8517fb03f9d0b6a0b3b79a462ca 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-environmentCallback.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-environmentCallback.md @@ -46,15 +46,15 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void; **示例：** ```ts -import UIAbility from '@ohos.app.ability.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; +import EnvironmentCallback from '@ohos.app.ability.EnvironmentCallback'; -let callbackId; +let callbackId: number; export default class MyAbility extends UIAbility { onCreate() { console.log('MyAbility onCreate'); - globalThis.applicationContext = this.context.getApplicationContext(); - let environmentCallback = { + let environmentCallback: EnvironmentCallback = { onConfigurationUpdated(config){ console.log('onConfigurationUpdated config: ${JSON.stringify(config)}'); }, @@ -64,14 +64,14 @@ export default class MyAbility extends UIAbility { } }; // 1.获取applicationContext - let applicationContext = globalThis.applicationContext; + let applicationContext = this.context.getApplicationContext(); // 2.通过applicationContext注册监听应用内生命周期 - callbackId = applicationContext.registerEnvironmentCallback(environmentCallback); + callbackId = applicationContext.on('environmentEvent', environmentCallback); console.log('registerEnvironmentCallback number: ${JSON.stringify(callbackId)}'); } onDestroy() { - let applicationContext = globalThis.applicationContext; - applicationContext.unregisterEnvironmentCallback(callbackId, (error, data) => { + let applicationContext = this.context.getApplicationContext(); + applicationContext.off('environment', callbackId, (error, data) => { if (error && error.code !== 0) { console.error('unregisterEnvironmentCallback fail, error: ${JSON.stringify(error)}'); } else { diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-errorManager.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-errorManager.md index 640b08d8cd0ffe1a259e663a9df514bdc175a61b..9dc4680fb134f8fb6d470463e30fedac0e4b8f08 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-errorManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-errorManager.md @@ -43,7 +43,10 @@ on(type: 'error', observer: ErrorObserver): number; **示例：** ```ts -let observer = { +import errorManager from '@ohos.app.ability.errorManager'; +import { BusinessError } from '@ohos.base'; + +let observer: errorManager.ErrorObserver = { onUnhandledException(errorMsg) { console.log('onUnhandledException, errorMsg: ', errorMsg); }, @@ -59,7 +62,9 @@ let observerId = -1; try { observerId = errorManager.on('error', observer); } catch (paramError) { - console.error('error: ${paramError.code}, ${paramError.message}'); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`error: ${code}, ${message}`); } ``` @@ -90,9 +95,12 @@ off(type: 'error', observerId: number, callback: AsyncCallback\): void; **示例：** ```ts +import errorManager from '@ohos.app.ability.errorManager'; +import { BusinessError } from '@ohos.base'; + let observerId = 100; -function unregisterErrorObserverCallback(err) { +function unregisterErrorObserverCallback(err: BusinessError) { if (err) { console.error('------------ unregisterErrorObserverCallback ------------', err); } @@ -100,7 +108,9 @@ function unregisterErrorObserverCallback(err) { try { errorManager.off('error', observerId, unregisterErrorObserverCallback); } catch (paramError) { - console.error('error: ${paramError.code}, ${paramError.message}'); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`error: ${code}, ${message}`); } ``` @@ -136,17 +146,22 @@ off(type: 'error', observerId: number): Promise\; **示例：** ```ts +import errorManager from '@ohos.app.ability.errorManager'; +import { BusinessError } from '@ohos.base'; + let observerId = 100; try { errorManager.off('error', observerId) .then((data) => { console.log('----------- unregisterErrorObserver success ----------', data); }) - .catch((err) => { + .catch((err: BusinessError) => { console.error('----------- unregisterErrorObserver fail ----------', err); }); } catch (paramError) { - console.error('error: ${paramError.code}, ${paramError.message}'); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`error: ${code}, ${message}`); } ``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-missionManager.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-missionManager.md index dd967e7981f4e2b3aee42a2d67a63440c89b0149..8005c2d46662a900bbb7b7605e522c49a76aa2da 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-missionManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-missionManager.md @@ -45,46 +45,57 @@ on(type:'mission', listener: MissionListener): number; ```ts import missionManager from '@ohos.app.ability.missionManager'; import UIAbility from '@ohos.app.ability.UIAbility'; - -let listener = { - onMissionCreated: function (mission) {console.log('--------onMissionCreated-------');}, - onMissionDestroyed: function (mission) {console.log('--------onMissionDestroyed-------');}, - onMissionSnapshotChanged: function (mission) {console.log('--------onMissionSnapshotChanged-------');}, - onMissionMovedToFront: function (mission) {console.log('--------onMissionMovedToFront-------');}, - onMissionIconUpdated: function (mission, icon) {console.log('--------onMissionIconUpdated-------');}, - onMissionClosed: function (mission) {console.log('--------onMissionClosed-------');}, - onMissionLabelUpdated: function (mission) {console.log('--------onMissionLabelUpdated-------');} +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; +import common from '@ohos.app.ability.common'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; +import window from '@ohos.window'; + +let listener: missionManager.MissionListener = { + onMissionCreated: (mission) => {console.log('--------onMissionCreated-------');}, + onMissionDestroyed: (mission) => {console.log('--------onMissionDestroyed-------');}, + onMissionSnapshotChanged: (mission) => {console.log('--------onMissionSnapshotChanged-------');}, + onMissionMovedToFront: (mission) => {console.log('--------onMissionMovedToFront-------');}, + onMissionIconUpdated: (mission, icon) => {console.log('--------onMissionIconUpdated-------');}, + onMissionClosed: (mission) => {console.log('--------onMissionClosed-------');}, + onMissionLabelUpdated: (mission) => {console.log('--------onMissionLabelUpdated-------');} }; let listenerId = -1; +let abilityWant: Want; +let context: common.UIAbilityContext; export default class EntryAbility extends UIAbility { - onCreate(want, launchParam) { + onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { console.log('[Demo] EntryAbility onCreate'); - globalThis.abilityWant = want; - globalThis.context = this.context; + abilityWant = want; + context = this.context; } onDestroy() { try { if (listenerId !== -1) { - missionManager.off('mission', listenerId).catch(function (err) { + missionManager.off('mission', listenerId).catch((err: BusinessError) => { console.log(err); }); } } catch (paramError) { - console.error('error: ${paramError.code}, ${paramError.message}'); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`error: ${code}, ${message} `); } console.log('[Demo] EntryAbility onDestroy'); } - onWindowStageCreate(windowStage) { + onWindowStageCreate(windowStage: window.WindowStage) { // Main window is created, set main page for this ability console.log('[Demo] EntryAbility onWindowStageCreate'); try { listenerId = missionManager.on('mission', listener); } catch (paramError) { - console.error('error: ${paramError.code}, ${paramError.message}'); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`error: ${code}, ${message} `); } windowStage.loadContent('pages/index', (err, data) => { @@ -94,10 +105,6 @@ export default class EntryAbility extends UIAbility { } console.info('Succeeded in loading the content. Data: ${JSON.stringify(data)}'); }); - - if (globalThis.flag) { - return; - } } }; ``` @@ -135,59 +142,66 @@ off(type: 'mission', listenerId: number, callback: AsyncCallback<void>): v ```ts import missionManager from '@ohos.app.ability.missionManager'; import UIAbility from '@ohos.app.ability.UIAbility'; - -let listener = { - onMissionCreated: function (mission) {console.log('--------onMissionCreated-------');}, - onMissionDestroyed: function (mission) {console.log('--------onMissionDestroyed-------');}, - onMissionSnapshotChanged: function (mission) {console.log('--------onMissionSnapshotChanged-------');}, - onMissionMovedToFront: function (mission) {console.log('--------onMissionMovedToFront-------');}, - onMissionIconUpdated: function (mission, icon) {console.log('--------onMissionIconUpdated-------');}, - onMissionClosed: function (mission) {console.log('--------onMissionClosed-------');}, - onMissionLabelUpdated: function (mission) {console.log('--------onMissionLabelUpdated-------');} +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; +import common from '@ohos.app.ability.common'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; +import window from '@ohos.window'; + +let listener: missionManager.MissionListener = { + onMissionCreated: (mission) => {console.log('--------onMissionCreated-------');}, + onMissionDestroyed: (mission) => {console.log('--------onMissionDestroyed-------');}, + onMissionSnapshotChanged: (mission) => {console.log('--------onMissionSnapshotChanged-------');}, + onMissionMovedToFront: (mission) => {console.log('--------onMissionMovedToFront-------');}, + onMissionIconUpdated: (mission, icon) => {console.log('--------onMissionIconUpdated-------');}, + onMissionClosed: (mission) => {console.log('--------onMissionClosed-------');}, + onMissionLabelUpdated: (mission) => {console.log('--------onMissionLabelUpdated-------');} }; let listenerId = -1; +let abilityWant: Want; +let context: common.UIAbilityContext; export default class EntryAbility extends UIAbility { - onCreate(want, launchParam) { + onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { console.log('[Demo] EntryAbility onCreate'); - globalThis.abilityWant = want; - globalThis.context = this.context; + abilityWant = want; + context = this.context; } onDestroy() { try { if (listenerId !== -1) { missionManager.off('mission', listenerId, (err) => { - console.log(err); + console.log('$(err.code)'); }); } } catch (paramError) { - console.error('error: ${paramError.code}, ${paramError.message}'); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`error: ${code}, ${message} `); } console.log('[Demo] EntryAbility onDestroy'); } - onWindowStageCreate(windowStage) { + onWindowStageCreate(windowStage: window.WindowStage) { // Main window is created, set main page for this ability console.log('[Demo] EntryAbility onWindowStageCreate'); try { listenerId = missionManager.on('mission', listener); } catch (paramError) { - console.error('error: ${paramError.code}, ${paramError.message}'); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`error: ${code}, ${message} `); } - windowStage.loadContent('pages/index', (err, data) => { + windowStage.loadContent('pages/index', (err: BusinessError, data) => { if (err.code) { console.error('Failed to load the content. Cause: ${JSON.stringify(err)}'); return; } console.info('Succeeded in loading the content. Data: ${JSON.stringify(data)}'); }); - - if (globalThis.flag) { - return; - } } }; ``` @@ -230,59 +244,66 @@ off(type: 'mission', listenerId: number): Promise<void>; ```ts import missionManager from '@ohos.app.ability.missionManager'; import UIAbility from '@ohos.app.ability.UIAbility'; - -let listener = { - onMissionCreated: function (mission) {console.log('--------onMissionCreated-------');}, - onMissionDestroyed: function (mission) {console.log('--------onMissionDestroyed-------');}, - onMissionSnapshotChanged: function (mission) {console.log('--------onMissionSnapshotChanged-------');}, - onMissionMovedToFront: function (mission) {console.log('--------onMissionMovedToFront-------');}, - onMissionIconUpdated: function (mission, icon) {console.log('--------onMissionIconUpdated-------');}, - onMissionClosed: function (mission) {console.log('--------onMissionClosed-------');}, - onMissionLabelUpdated: function (mission) {console.log('--------onMissionLabelUpdated-------');} +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; +import common from '@ohos.app.ability.common'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; +import window from '@ohos.window'; + +let listener: missionManager.MissionListener = { + onMissionCreated: (mission) => {console.log('--------onMissionCreated-------');}, + onMissionDestroyed: (mission) => {console.log('--------onMissionDestroyed-------');}, + onMissionSnapshotChanged: (mission) => {console.log('--------onMissionSnapshotChanged-------');}, + onMissionMovedToFront: (mission) => {console.log('--------onMissionMovedToFront-------');}, + onMissionIconUpdated: (mission, icon) => {console.log('--------onMissionIconUpdated-------');}, + onMissionClosed: (mission) => {console.log('--------onMissionClosed-------');}, + onMissionLabelUpdated: (mission) => {console.log('--------onMissionLabelUpdated-------');} }; let listenerId = -1; +let abilityWant: Want; +let context: common.UIAbilityContext; export default class EntryAbility extends UIAbility { - onCreate(want, launchParam) { + onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { console.log('[Demo] EntryAbility onCreate'); - globalThis.abilityWant = want; - globalThis.context = this.context; + abilityWant = want; + context = this.context; } onDestroy() { try { if (listenerId !== -1) { - missionManager.off('mission', listenerId).catch(function (err) { - console.log(err); + missionManager.off('mission', listenerId).catch((err: BusinessError) => { + console.log('$(err.code)'); }); } } catch (paramError) { - console.error('error: ${paramError.code}, ${paramError.message}'); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`error: ${code}, ${message} `); } console.log('[Demo] EntryAbility onDestroy'); } - onWindowStageCreate(windowStage) { + onWindowStageCreate(windowStage: window.WindowStage) { // Main window is created, set main page for this ability console.log('[Demo] EntryAbility onWindowStageCreate'); try { listenerId = missionManager.on('mission', listener); } catch (paramError) { - console.error('error: ${paramError.code}, ${paramError.message}'); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`error: ${code}, ${message} `); } - windowStage.loadContent('pages/index', (err, data) => { + windowStage.loadContent('pages/index', (err: BusinessError, data) => { if (err.code) { console.error('Failed to load the content. Cause: ${JSON.stringify(err)}'); return; } console.info('Succeeded in loading the content. Data: ${JSON.stringify(data)}'); }); - - if (globalThis.flag) { - return; - } } }; ``` @@ -312,6 +333,7 @@ getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback<M ```ts import missionManager from '@ohos.app.ability.missionManager'; + import { BusinessError } from '@ohos.base'; let testMissionId = 1; @@ -335,10 +357,12 @@ getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback<M } }); } catch (paramError) { - console.error('error.code: ${paramError.code}, error.message: ${paramError.message}'); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`error: ${code}, ${message} `); } }) - .catch(function(err){console.log(err);}); + .catch((err: BusinessError) => {console.log('$(err.code)');}); ``` ## missionManager.getMissionInfo @@ -370,12 +394,13 @@ getMissionInfo(deviceId: string, missionId: number): Promise<MissionInfo>; ```ts import missionManager from '@ohos.app.ability.missionManager'; +import { BusinessError } from '@ohos.base'; let testMissionId = 1; try { missionManager.getMissionInfo('', testMissionId).then((data) => { console.info('getMissionInfo successfully. Data: ${JSON.stringify(data)}'); - }).catch(error => { + }).catch((error: BusinessError) => { console.error('getMissionInfo failed. Cause: ${error.message}'); }); } catch (error) { @@ -407,6 +432,7 @@ getMissionInfos(deviceId: string, numMax: number, callback: AsyncCallback<Arr ```ts import missionManager from '@ohos.app.ability.missionManager'; + import { BusinessError } from '@ohos.base'; try { missionManager.getMissionInfos('', 10, (error, missions) => { @@ -418,7 +444,9 @@ getMissionInfos(deviceId: string, numMax: number, callback: AsyncCallback<Arr } }); } catch (paramError) { - console.error('error: ${paramError.code}, ${paramError.message}'); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`error: ${code}, ${message} `); } ``` @@ -452,11 +480,12 @@ getMissionInfos(deviceId: string, numMax: number): Promise<Array<MissionIn ```ts import missionManager from '@ohos.app.ability.missionManager'; +import { BusinessError } from '@ohos.base'; try { missionManager.getMissionInfos('', 10).then((data) => { console.info('getMissionInfos successfully. Data: ${JSON.stringify(data)}'); - }).catch(error => { + }).catch((error: BusinessError) => { console.error('getMissionInfos failed. Cause: ${error.message}'); }); } catch (error) { @@ -530,12 +559,13 @@ getMissionSnapShot(deviceId: string, missionId: number): Promise<MissionSnaps **示例：** ```ts import missionManager from '@ohos.app.ability.missionManager'; +import { BusinessError } from '@ohos.base'; let testMissionId = 2; try { missionManager.getMissionSnapShot('', testMissionId).then((data) => { console.info('getMissionSnapShot successfully. Data: ${JSON.stringify(data)}'); - }).catch(error => { + }).catch((error: BusinessError) => { console.error('getMissionSnapShot failed. Cause: ${error.message}'); }); } catch (error) { @@ -610,12 +640,13 @@ getLowResolutionMissionSnapShot(deviceId: string, missionId: number): Promise\ { console.info('getLowResolutionMissionSnapShot successfully. Data: ${JSON.stringify(data)}'); - }).catch(error => { + }).catch((error: BusinessError) => { console.error('getLowResolutionMissionSnapShot failed. Cause: ${error.message}'); }); } catch (error) { @@ -705,12 +736,13 @@ lockMission(missionId: number): Promise<void>; **示例：** ```ts import missionManager from '@ohos.app.ability.missionManager'; +import { BusinessError } from '@ohos.base'; let testMissionId = 2; try { missionManager.lockMission(testMissionId).then((data) => { console.info('lockMission successfully. Data: ${JSON.stringify(data)}'); - }).catch(error => { + }).catch((error: BusinessError) => { console.error('lockMission failed. Cause: ${error.message}'); }); } catch (error) { @@ -799,12 +831,13 @@ unlockMission(missionId: number): Promise<void>; ```ts import missionManager from '@ohos.app.ability.missionManager'; +import { BusinessError } from '@ohos.base'; let testMissionId = 2; try { missionManager.unlockMission(testMissionId).then((data) => { console.info('unlockMission successfully. Data: ${JSON.stringify(data)}'); - }).catch(error => { + }).catch((error: BusinessError) => { console.error('unlockMission failed. Cause: ${error.message}'); }); } catch (error) { @@ -879,12 +912,13 @@ clearMission(missionId: number): Promise<void>; ```ts import missionManager from '@ohos.app.ability.missionManager'; +import { BusinessError } from '@ohos.base'; let testMissionId = 2; try { missionManager.clearMission(testMissionId).then((data) => { console.info('clearMission successfully. Data: ${JSON.stringify(data)}'); - }).catch(error => { + }).catch((error: BusinessError) => { console.error('clearMission failed. Cause: ${error.message}'); }); } catch (error) { @@ -944,11 +978,12 @@ clearAllMissions(): Promise<void>; ```ts import missionManager from '@ohos.app.ability.missionManager'; +import { BusinessError } from '@ohos.base'; try { missionManager.clearAllMissions().then((data) => { console.info('clearAllMissions successfully. Data: ${JSON.stringify(data)}'); - }).catch(err => { + }).catch((err: BusinessError) => { console.error('clearAllMissions failed: ${err.message}'); }); } catch (err) { @@ -1086,12 +1121,13 @@ moveMissionToFront(missionId: number, options?: StartOptions): Promise<void&g ```ts import missionManager from '@ohos.app.ability.missionManager'; +import { BusinessError } from '@ohos.base'; let testMissionId = 2; try { missionManager.moveMissionToFront(testMissionId).then((data) => { console.info('moveMissionToFront successfully. Data: ${JSON.stringify(data)}'); - }).catch(error => { + }).catch((error: BusinessError) => { console.error('moveMissionToFront failed. Cause: ${error.message}'); }); } catch (error) { @@ -1131,6 +1167,7 @@ moveMissionsToForeground(missionIds: Array<number>, callback: AsyncCallbac ```ts import abilityManager from '@ohos.app.ability.abilityManager'; import missionManager from '@ohos.app.ability.missionManager'; +import { BusinessError } from '@ohos.base'; try { missionManager.getMissionInfos("", 10, (error, missionInfos) => { @@ -1157,7 +1194,9 @@ try { }); }); } catch (paramError) { - console.log("error: " + paramError.code + ", " + paramError.message); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`error: ${code}, ${message} `); } ``` @@ -1195,6 +1234,7 @@ moveMissionsToForeground(missionIds: Array<number>, topMission: number, ca ```ts import abilityManager from '@ohos.app.ability.abilityManager'; import missionManager from '@ohos.app.ability.missionManager'; +import { BusinessError } from '@ohos.base'; try { missionManager.getMissionInfos("", 10, (error, missionInfos) => { @@ -1221,7 +1261,9 @@ try { }); }); } catch (paramError) { - console.log("error: " + paramError.code + ", " + paramError.message); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`error: ${code}, ${message} `); } ``` @@ -1264,6 +1306,7 @@ moveMissionsToForeground(missionIds: Array<number>, topMission?: number): ```ts import abilityManager from '@ohos.app.ability.abilityManager'; import missionManager from '@ohos.app.ability.missionManager'; +import { BusinessError } from '@ohos.base'; try { missionManager.getMissionInfos("", 10, (error, missionInfos) => { @@ -1286,7 +1329,9 @@ try { }); }); } catch (paramError) { - console.log("error: " + paramError.code + ", " + paramError.message); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`error: ${code}, ${message} `); } ``` @@ -1323,6 +1368,7 @@ moveMissionsToBackground(missionIds: Array<number>, callback: AsyncCallbac ```ts import abilityManager from '@ohos.app.ability.abilityManager'; import missionManager from '@ohos.app.ability.missionManager'; +import { BusinessError } from '@ohos.base'; try { missionManager.getMissionInfos("", 10, (error, missionInfos) => { @@ -1346,7 +1392,9 @@ try { }); }); } catch (paramError) { - console.log("error: " + paramError.code + ", " + paramError.message); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`error: ${code}, ${message} `); } ``` @@ -1387,6 +1435,7 @@ moveMissionsToBackground(missionIds : Array<number>): Promise<Array< ```ts import abilityManager from '@ohos.app.ability.abilityManager'; import missionManager from '@ohos.app.ability.missionManager'; +import { BusinessError } from '@ohos.base'; try { missionManager.getMissionInfos("", 10, (error, missionInfos) => { @@ -1406,7 +1455,9 @@ try { }); }); } catch (paramError) { - console.log("error: " + paramError.code + ", " + paramError.message); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`error: ${code}, ${message} `); } ``` \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-quickFixManager.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-quickFixManager.md index 05be616d309b30dc17842f01ae51e98c51d3c3ff..2193248a0be505897f8bb7ed0aa45336e0515abf 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-quickFixManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-quickFixManager.md @@ -78,6 +78,8 @@ applyQuickFix(hapModuleQuickFixFiles: Array\, callback: AsyncCallback\ { @@ -130,11 +132,14 @@ applyQuickFix(hapModuleQuickFixFiles: Array\): Promise\; **示例：** ```ts +import quickFixManager from '@ohos.app.ability.quickFixManager'; +import { BusinessError } from '@ohos.base'; + let hapModuleQuickFixFiles = ['/data/storage/el2/base/entry.hqf']; try { quickFixManager.applyQuickFix(hapModuleQuickFixFiles).then(() => { console.info('applyQuickFix success'); - }).catch((error) => { + }).catch((error: BusinessError) => { console.error(`applyQuickFix err: ${error}`); }); } catch (paramError) { @@ -173,6 +178,8 @@ getApplicationQuickFixInfo(bundleName: string, callback: AsyncCallback\ { @@ -223,11 +230,14 @@ getApplicationQuickFixInfo(bundleName: string): Promise\ { console.info(`getApplicationQuickFixInfo success: ${data}`); - }).catch((error) => { + }).catch((error: BusinessError) => { console.error(`getApplicationQuickFixInfo err: ${error}`); }); } catch (paramError) { @@ -268,6 +278,8 @@ revokeQuickFix(bundleName: string, callback: AsyncCallback\): void; **示例：** ```ts +import quickFixManager from '@ohos.app.ability.quickFixManager'; + let bundleName = "com.example.myapplication"; quickFixManager.revokeQuickFix(bundleName, (err) => { console.info("revokeQuickFix " + bundleName + " " + JSON.stringify(err)); @@ -312,10 +324,13 @@ revokeQuickFix(bundleName: string): Promise\; **示例：** ```ts +import quickFixManager from '@ohos.app.ability.quickFixManager'; +import { BusinessError } from '@ohos.base'; + let bundleName = "com.example.myapplication"; quickFixManager.revokeQuickFix(bundleName).then(() => { console.info("revokeQuickFix " + bundleName +" ok"); - }).catch((err) => { + }).catch((err: BusinessError) => { console.info("revokeQuickFix " + bundleName +" failed, error code is ", JSON.stringify((err))); }); ``` \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-serviceExtensionAbility.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-serviceExtensionAbility.md index af595fc9d82b6cf24ab18323933912ea676ece5b..0b0594b0a346ab7a336fdd672ff5baac5a6c69f3 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-serviceExtensionAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-serviceExtensionAbility.md @@ -48,8 +48,11 @@ Extension生命周期回调，在创建时回调，执行初始化业务逻辑 **示例：** ```ts + import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility'; + import Want from '@ohos.app.ability.Want'; + class ServiceExt extends ServiceExtension { - onCreate(want) { + onCreate(want: Want) { console.log('onCreate, want: ${want.abilityName}'); } } @@ -69,6 +72,8 @@ Extension生命周期回调，在销毁时回调，执行资源清理等操作 **示例：** ```ts + import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility'; + class ServiceExt extends ServiceExtension { onDestroy() { console.log('onDestroy'); @@ -97,8 +102,11 @@ Extension生命周期回调，如果是startAbility或者startServiceExtensionAb **示例：** ```ts + import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility'; + import Want from '@ohos.app.ability.Want'; + class ServiceExt extends ServiceExtension { - onRequest(want, startId) { + onRequest(want: Want, startId: number) { console.log('onRequest, want: ${want.abilityName}'); } } @@ -131,15 +139,18 @@ Extension生命周期回调，如果是connectAbility拉起的服务，会在onC ```ts import rpc from '@ohos.rpc'; + import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility'; + import Want from '@ohos.app.ability.Want'; + class StubTest extends rpc.RemoteObject{ - constructor(des) { + constructor(des: string) { super(des); } - onConnect(code, data, reply, option) { + onConnect(code: number, data: rpc.MessageSequence, reply: rpc.MessageSequence, option: rpc.MessageOption) { } } class ServiceExt extends ServiceExtension { - onConnect(want) { + onConnect(want: Want) { console.log('onConnect , want: ${want.abilityName}'); return new StubTest('test'); } @@ -150,11 +161,14 @@ Extension生命周期回调，如果是connectAbility拉起的服务，会在onC ```ts import rpc from '@ohos.rpc'; +import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility'; +import Want from '@ohos.app.ability.Want'; + class StubTest extends rpc.RemoteObject{ - constructor(des) { + constructor(des: string) { super(des); } - onConnect(code, data, reply, option) { + onConnect(code: number, data: rpc.MessageSequence, reply: rpc.MessageSequence, option: rpc.MessageOption) { } } async function getDescriptor() { @@ -162,7 +176,7 @@ async function getDescriptor() { return "asyncTest" } class ServiceExt extends ServiceExtension { - async onConnect(want) { + async onConnect(want: Want) { console.log(`onConnect , want: ${want.abilityName}`); let descriptor = await getDescriptor(); return new StubTest(descriptor); @@ -189,8 +203,11 @@ Extension的生命周期回调，客户端执行断开连接服务时回调。 **示例：** ```ts + import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility'; + import Want from '@ohos.app.ability.Want'; + class ServiceExt extends ServiceExtension { - onDisconnect(want) { + onDisconnect(want: Want) { console.log('onDisconnect, want: ${want.abilityName}'); } } @@ -199,8 +216,11 @@ Extension的生命周期回调，客户端执行断开连接服务时回调。 在执行完onDisconnect生命周期回调后，应用可能会退出，从而可能导致onDisconnect中的异步函数未能正确执行，比如异步写入数据库。可以使用异步生命周期，以确保异步onDisconnect完成后再继续后续的生命周期。 ```ts +import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility'; +import Want from '@ohos.app.ability.Want'; + class ServiceExt extends ServiceExtension { - async onDisconnect(want) { + async onDisconnect(want: Want) { console.log('onDisconnect, want: ${want.abilityName}'); // 调用异步函数... } @@ -226,8 +246,11 @@ Extension的生命周期回调，当所有以前的客户端都断开连接之 **示例：** ```ts + import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility'; + import Want from '@ohos.app.ability.Want'; + class ServiceExt extends ServiceExtension { - onReconnect(want) { + onReconnect(want: Want) { console.log('onReconnect, want: ${want.abilityName}'); } } @@ -252,8 +275,11 @@ onConfigurationUpdate(newConfig: Configuration): void; **示例：** ```ts + import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility'; + import { Configuration } from '@ohos.app.ability.Configuration'; + class ServiceExt extends ServiceExtension { - onConfigurationUpdate(config) { + onConfigurationUpdate(config: Configuration) { console.log('onConfigurationUpdate, config: ${JSON.stringify(config)}'); } } @@ -278,8 +304,10 @@ onDump(params: Array\): Array\; **示例：** ```ts + import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility'; + class ServiceExt extends ServiceExtension { - onDump(params) { + onDump(params: Array) { console.log('dump, params: ${JSON.stringify(params)}'); return ['params']; } diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-startOptions.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-startOptions.md index 7534098e043ae0a734f4af7ce929bb33b8a4bfd4..056db6735c6ef64bf21a6b0f98dbec813312d95b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-startOptions.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-startOptions.md @@ -26,6 +26,8 @@ import StartOptions from '@ohos.app.ability.StartOptions'; ```ts import missionManager from '@ohos.app.ability.missionManager'; + import StartOptions from '@ohos.app.ability.StartOptions'; + import { BusinessError } from '@ohos.base'; try { missionManager.getMissionInfos('', 10, (error, missions) => { @@ -37,7 +39,7 @@ import StartOptions from '@ohos.app.ability.StartOptions'; console.log(`missions = ${JSON.stringify(missions)}`); let id = missions[0].missionId; - let startOptions = { + let startOptions: StartOptions = { windowMode : 101, displayId: 0 }; @@ -46,6 +48,8 @@ import StartOptions from '@ohos.app.ability.StartOptions'; }); }); } catch (paramError) { - console.error(`error: ${paramError.code}, ${paramError.message}`); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.error(`error: ${code}, ${message}`); } ``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md index 85f978f74b2c4af7cc165dec6123a5a1635b38d6..6aa2b5586131d5094ffbd84a50467b25abb90ded 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md @@ -45,8 +45,12 @@ UIAbility创建时回调，执行初始化业务逻辑操作。 **示例：** ```ts + import UIAbility from '@ohos.app.ability.UIAbility'; + import AbilityConstant from '@ohos.app.ability.AbilityConstant'; + import Want from '@ohos.app.ability.Want'; + class MyUIAbility extends UIAbility { - onCreate(want, launchParam) { + onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { console.log('onCreate, want: ${want.abilityName}'); } } @@ -70,8 +74,11 @@ onWindowStageCreate(windowStage: window.WindowStage): void **示例：** ```ts + import UIAbility from '@ohos.app.ability.UIAbility'; + import window from '@ohos.window'; + class MyUIAbility extends UIAbility { - onWindowStageCreate(windowStage) { + onWindowStageCreate(windowStage: window.WindowStage) { console.log('onWindowStageCreate'); } } @@ -89,6 +96,8 @@ onWindowStageDestroy(): void **示例：** ```ts + import UIAbility from '@ohos.app.ability.UIAbility'; + class MyUIAbility extends UIAbility { onWindowStageDestroy() { console.log('onWindowStageDestroy'); @@ -114,8 +123,11 @@ onWindowStageRestore(windowStage: window.WindowStage): void **示例：** ```ts + import UIAbility from '@ohos.app.ability.UIAbility'; + import window from '@ohos.window'; + class MyUIAbility extends UIAbility { - onWindowStageRestore(windowStage) { + onWindowStageRestore(windowStage: window.WindowStage) { console.log('onWindowStageRestore'); } } @@ -134,6 +146,8 @@ UIAbility生命周期回调，在销毁时回调，执行资源清理等操作 ```ts + import UIAbility from '@ohos.app.ability.UIAbility'; + class MyUIAbility extends UIAbility { onDestroy() { console.log('onDestroy'); @@ -144,6 +158,8 @@ UIAbility生命周期回调，在销毁时回调，执行资源清理等操作 在执行完onDestroy生命周期回调后，应用可能会退出，从而可能导致onDestroy中的异步函数未能正确执行，比如异步写入数据库。可以使用异步生命周期，以确保异步onDestroy完成后再继续后续的生命周期。 ```ts +import UIAbility from '@ohos.app.ability.UIAbility'; + class MyUIAbility extends UIAbility { async onDestroy() { console.log('onDestroy'); @@ -163,6 +179,8 @@ UIAbility生命周期回调，当应用从后台转到前台时触发。 **示例：** ```ts + import UIAbility from '@ohos.app.ability.UIAbility'; + class MyUIAbility extends UIAbility { onForeground() { console.log('onForeground'); @@ -182,6 +200,8 @@ UIAbility生命周期回调，当应用从前台转到后台时触发。 **示例：** ```ts + import UIAbility from '@ohos.app.ability.UIAbility'; + class MyUIAbility extends UIAbility { onBackground() { console.log('onBackground'); @@ -213,9 +233,11 @@ onContinue(wantParam: { [key: string]: Object }): AbilityConstant.OnContinueResu **示例：** ```ts + import UIAbility from '@ohos.app.ability.UIAbility'; import AbilityConstant from '@ohos.app.ability.AbilityConstant'; + class MyUIAbility extends UIAbility { - onContinue(wantParams) { + onContinue(wantParams: Record) { console.log('onContinue'); wantParams['myData'] = 'my1234567'; return AbilityConstant.OnContinueResult.AGREE; @@ -242,8 +264,11 @@ onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void; **示例：** ```ts + import UIAbility from '@ohos.app.ability.UIAbility'; + import AbilityConstant from '@ohos.app.ability.AbilityConstant'; + class MyUIAbility extends UIAbility { - onNewWant(want, launchParam) { + onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam) { console.log('onNewWant, want: ${want.abilityName}'); console.log('onNewWant, launchParam: ${JSON.stringify(launchParam)}'); } @@ -267,8 +292,10 @@ onDump(params: Array\): Array\; **示例：** ```ts + import UIAbility from '@ohos.app.ability.UIAbility'; + class MyUIAbility extends UIAbility { - onDump(params) { + onDump(params: Array) { console.log('dump, params: ${JSON.stringify(params)}'); return ['params']; } @@ -300,10 +327,11 @@ onSaveState(reason: AbilityConstant.StateType, wantParam : {[key: string]: Objec **示例：** ```ts +import UIAbility from '@ohos.app.ability.UIAbility'; import AbilityConstant from '@ohos.app.ability.AbilityConstant'; class MyUIAbility extends UIAbility { - onSaveState(reason, wantParam) { + onSaveState(reason: AbilityConstant.StateType, wantParam: Record) { console.log('onSaveState'); wantParam['myData'] = 'my1234567'; return AbilityConstant.OnSaveResult.RECOVERY_AGREE; @@ -328,9 +356,11 @@ onShare(wantParam:{ [key: string]: Object }): void; **示例：** ```ts +import UIAbility from '@ohos.app.ability.UIAbility'; import AbilityConstant from '@ohos.app.ability.AbilityConstant'; + class MyUIAbility extends UIAbility { - onShare(wantParams) { + onShare(wantParams: Record) { console.log('onShare'); wantParams['ohos.extra.param.key.shareUrl'] = 'example.com'; } @@ -356,11 +386,15 @@ UIAbility生命周期回调，当系统预关闭开关打开后（配置系统 **示例：** ```ts + import UIAbility from '@ohos.app.ability.UIAbility'; + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; + export default class EntryAbility extends UIAbility { onPrepareToTerminate() { // 开发者定义预关闭动作 // 例如拉起另一个ability，根据ability处理结果执行异步关闭 - let want = { + let want: Want = { bundleName: "com.example.myapplication", moduleName: "entry", abilityName: "SecondAbility" @@ -372,7 +406,7 @@ UIAbility生命周期回调，当系统预关闭开关打开后（配置系统 if (result.resultCode === 0) { this.context.terminateSelf(); } - }).catch((err)=>{ + }).catch((err: BusinessError)=>{ // 异常处理 console.log('startAbilityForResult failed, err:' + JSON.stringify(err)); this.context.terminateSelf(); @@ -421,21 +455,27 @@ call(method: string, data: rpc.Parcelable): Promise<void>; **示例：** ```ts - class MyMessageAble{ // 自定义的Parcelable数据结构 - name:'' - str:'' - num: 1 - constructor(name, str) { + import UIAbility from '@ohos.app.ability.UIAbility'; + import { Caller } from '@ohos.app.ability.UIAbility'; + import { BusinessError } from '@ohos.base'; + import window from '@ohos.window'; + import rpc from '@ohos.rpc'; + + class MyMessageAble implements rpc.Parcelable { // 自定义的Parcelable数据结构 + name: string + str: string + num: number = 1 + constructor(name: string, str: string) { this.name = name; this.str = str; } - marshalling(messageSequence) { + marshalling(messageSequence: rpc.MessageSequence) { messageSequence.writeInt(this.num); messageSequence.writeString(this.str); console.log('MyMessageAble marshalling num[${this.num}] str[${this.str}]'); return true; } - unmarshalling(messageSequence) { + unmarshalling(messageSequence: rpc.MessageSequence) { this.num = messageSequence.readInt(); this.str = messageSequence.readString(); console.log('MyMessageAble unmarshalling num[${this.num}] str[${this.str}]'); @@ -443,9 +483,9 @@ call(method: string, data: rpc.Parcelable): Promise<void>; } }; let method = 'call_Function'; // 约定的通知消息字符串 - let caller; + let caller: Caller; export default class MainUIAbility extends UIAbility { - onWindowStageCreate(windowStage) { + onWindowStageCreate(windowStage: window.WindowStage) { this.context.startAbilityByCall({ bundleName: 'com.example.myservice', abilityName: 'MainUIAbility', @@ -457,10 +497,10 @@ call(method: string, data: rpc.Parcelable): Promise<void>; .then(() => { console.log('Caller call() called'); }) - .catch((callErr) => { + .catch((callErr: BusinessError) => { console.log('Caller.call catch error, error.code: ${callErr.code}, error.message: ${callErr.message}'); }); - }).catch((err) => { + }).catch((err: BusinessError) => { console.log('Caller GetCaller error, error.code: ${err.code}, error.message: ${err.message}'); }); } @@ -502,21 +542,27 @@ callWithResult(method: string, data: rpc.Parcelable): Promise<rpc.MessageSequ **示例：** ```ts - class MyMessageAble{ - name:'' - str:'' - num: 1 - constructor(name, str) { + import UIAbility from '@ohos.app.ability.UIAbility'; + import { Caller } from '@ohos.app.ability.UIAbility'; + import { BusinessError } from '@ohos.base'; + import window from '@ohos.window'; + import rpc from '@ohos.rpc'; + + class MyMessageAble implements rpc.Parcelable { + name: string + str: string + num: number = 1 + constructor(name: string, str: string) { this.name = name; this.str = str; } - marshalling(messageSequence) { + marshalling(messageSequence: rpc.MessageSequence) { messageSequence.writeInt(this.num); messageSequence.writeString(this.str); console.log('MyMessageAble marshalling num[${this.num}] str[${this.str}]'); return true; } - unmarshalling(messageSequence) { + unmarshalling(messageSequence: rpc.MessageSequence) { this.num = messageSequence.readInt(); this.str = messageSequence.readString(); console.log('MyMessageAble unmarshalling num[${this.num] str[${this.str}]'); @@ -524,9 +570,9 @@ callWithResult(method: string, data: rpc.Parcelable): Promise<rpc.MessageSequ } }; let method = 'call_Function'; - let caller; + let caller: Caller; export default class MainUIAbility extends UIAbility { - onWindowStageCreate(windowStage) { + onWindowStageCreate(windowStage: window.WindowStage) { this.context.startAbilityByCall({ bundleName: 'com.example.myservice', abilityName: 'MainUIAbility', @@ -540,10 +586,10 @@ callWithResult(method: string, data: rpc.Parcelable): Promise<rpc.MessageSequ let retmsg = new MyMessageAble(0, ''); data.readParcelable(retmsg); }) - .catch((callErr) => { + .catch((callErr: BusinessError) => { console.log('Caller.callWithResult catch error, error.code: ${callErr.code}, error.message: ${callErr.message}'); }); - }).catch((err) => { + }).catch((err: BusinessError) => { console.log('Caller GetCaller error, error.code: ${err.code}, error.message: ${err.message}'); }); } @@ -571,9 +617,14 @@ release(): void; **示例：** ```ts - let caller; + import UIAbility from '@ohos.app.ability.UIAbility'; + import { Caller } from '@ohos.app.ability.UIAbility'; + import { BusinessError } from '@ohos.base'; + import window from '@ohos.window'; + + let caller: Caller; export default class MainUIAbility extends UIAbility { - onWindowStageCreate(windowStage) { + onWindowStageCreate(windowStage: window.WindowStage) { this.context.startAbilityByCall({ bundleName: 'com.example.myservice', abilityName: 'MainUIAbility', @@ -585,7 +636,7 @@ release(): void; } catch (releaseErr) { console.log('Caller.release catch error, error.code: ${releaseErr.code}, error.message: ${releaseErr.message}'); } - }).catch((err) => { + }).catch((err: BusinessError) => { console.log('Caller GetCaller error, error.code: ${err.code}, error.message: ${err.message}'); }); } @@ -617,9 +668,14 @@ release(): void; **示例：** ```ts - let caller; + import UIAbility from '@ohos.app.ability.UIAbility'; + import { Caller } from '@ohos.app.ability.UIAbility'; + import { BusinessError } from '@ohos.base'; + import window from '@ohos.window'; + + let caller: Caller; export default class MainUIAbility extends UIAbility { - onWindowStageCreate(windowStage) { + onWindowStageCreate(windowStage: window.WindowStage) { this.context.startAbilityByCall({ bundleName: 'com.example.myservice', abilityName: 'MainUIAbility', @@ -633,7 +689,7 @@ release(): void; } catch (error) { console.log('Caller.onRelease catch error, error.code: $error.code}, error.message: ${error.message}'); } - }).catch((err) => { + }).catch((err: BusinessError) => { console.log('Caller GetCaller error, error.code: ${err.code}, error.message: ${err.message}'); }); } @@ -666,9 +722,11 @@ onRemoteStateChange(callback: OnRemoteStateChangeCallback): void; ```ts import UIAbility from '@ohos.app.ability.UIAbility'; + import { Caller } from '@ohos.app.ability.UIAbility'; + import { BusinessError } from '@ohos.base'; import window from '@ohos.window'; - let caller; + let caller: Caller; let dstDeviceId: string; export default class MainAbility extends UIAbility { onWindowStageCreate(windowStage: window.WindowStage) { @@ -685,7 +743,7 @@ onRemoteStateChange(callback: OnRemoteStateChangeCallback): void; } catch (error) { console.log('Caller.onRemoteStateChange catch error, error.code: ${JSON.stringify(error.code)}, error.message: ${JSON.stringify(error.message)}'); } - }).catch((err) => { + }).catch((err: BusinessError) => { console.log('Caller GetCaller error, error.code: ${JSON.stringify(err.code)}, error.message: ${JSON.stringify(err.message)}'); }) } @@ -719,9 +777,14 @@ on(type: 'release', callback: OnReleaseCallback): void; **示例：** ```ts - let caller; + import UIAbility from '@ohos.app.ability.UIAbility'; + import { Caller } from '@ohos.app.ability.UIAbility'; + import { BusinessError } from '@ohos.base'; + import window from '@ohos.window'; + + let caller: Caller; export default class MainUIAbility extends UIAbility { - onWindowStageCreate(windowStage) { + onWindowStageCreate(windowStage: window.WindowStage) { this.context.startAbilityByCall({ bundleName: 'com.example.myservice', abilityName: 'MainUIAbility', @@ -735,7 +798,7 @@ on(type: 'release', callback: OnReleaseCallback): void; } catch (error) { console.log('Caller.on catch error, error.code: ${error.code}, error.message: ${error.message}'); } - }).catch((err) => { + }).catch((err: BusinessError) => { console.log('Caller GetCaller error, error.code: ${err.code}, error.message: ${err.message}'); }); } @@ -766,9 +829,14 @@ off(type: 'release', callback: OnReleaseCallback): void; **示例：** ```ts - let caller; + import UIAbility, { OnReleaseCallback } from '@ohos.app.ability.UIAbility'; + import { Caller } from '@ohos.app.ability.UIAbility'; + import { BusinessError } from '@ohos.base'; + import window from '@ohos.window'; + + let caller: Caller; export default class MainUIAbility extends UIAbility { - onWindowStageCreate(windowStage) { + onWindowStageCreate(windowStage: window.WindowStage) { this.context.startAbilityByCall({ bundleName: 'com.example.myservice', abilityName: 'MainUIAbility', @@ -776,7 +844,7 @@ off(type: 'release', callback: OnReleaseCallback): void; }).then((obj) => { caller = obj; try { - let onReleaseCallBack = (str) => { + let onReleaseCallBack: OnReleaseCallback = (str) => { console.log(' Caller OnRelease CallBack is called ${str}'); }; caller.on('release', onReleaseCallBack); @@ -784,7 +852,7 @@ off(type: 'release', callback: OnReleaseCallback): void; } catch (error) { console.log('Caller.on or Caller.off catch error, error.code: ${error.code}, error.message: ${error.message}'); } - }).catch((err) => { + }).catch((err: BusinessError) => { console.log('Caller GetCaller error, error.code: ${err.code}, error.message: ${err.message}'); }); } @@ -808,9 +876,14 @@ off(type: 'release'): void; **示例：** ```ts - let caller; + import UIAbility, { OnReleaseCallback } from '@ohos.app.ability.UIAbility'; + import { Caller } from '@ohos.app.ability.UIAbility'; + import { BusinessError } from '@ohos.base'; + import window from '@ohos.window'; + + let caller: Caller; export default class MainUIAbility extends UIAbility { - onWindowStageCreate(windowStage) { + onWindowStageCreate(windowStage: window.WindowStage) { this.context.startAbilityByCall({ bundleName: 'com.example.myservice', abilityName: 'MainUIAbility', @@ -818,7 +891,7 @@ off(type: 'release'): void; }).then((obj) => { caller = obj; try { - let onReleaseCallBack = (str) => { + let onReleaseCallBack: OnReleaseCallback = (str) => { console.log(' Caller OnRelease CallBack is called ${str}'); }; caller.on('release', onReleaseCallBack); @@ -826,7 +899,7 @@ off(type: 'release'): void; } catch (error) { console.error('Caller.on or Caller.off catch error, error.code: ${error.code}, error.message: ${error.message}'); } - }).catch((err) => { + }).catch((err: BusinessError) => { console.error('Caller GetCaller error, error.code: ${err.code}, error.message: ${err.message}'); }); } @@ -864,21 +937,26 @@ on(method: string, callback: CalleeCallback): void; **示例：** ```ts - class MyMessageAble{ - name:'' - str:'' - num: 1 - constructor(name, str) { + import UIAbility, { CalleeCallback } from '@ohos.app.ability.UIAbility'; + import AbilityConstant from '@ohos.app.ability.AbilityConstant'; + import Want from '@ohos.app.ability.Want'; + import rpc from '@ohos.rpc'; + + class MyMessageAble implements rpc.Parcelable { + name: string + str: string + num: number = 1 + constructor(name: string, str: string) { this.name = name; this.str = str; } - marshalling(messageSequence) { + marshalling(messageSequence: rpc.MessageSequence) { messageSequence.writeInt(this.num); messageSequence.writeString(this.str); console.log('MyMessageAble marshalling num[${this.num}] str[${this.str}]'); return true; } - unmarshalling(messageSequence) { + unmarshalling(messageSequence: rpc.MessageSequence) { this.num = messageSequence.readInt(); this.str = messageSequence.readString(); console.log('MyMessageAble unmarshalling num[${this.num}] str[${this.str}]'); @@ -886,14 +964,14 @@ on(method: string, callback: CalleeCallback): void; } }; let method = 'call_Function'; - function funcCallBack(pdata) { + function funcCallBack(pdata: rpc.MessageSequence) { console.log('Callee funcCallBack is called ${pdata}'); let msg = new MyMessageAble('test', ''); pdata.readParcelable(msg); return new MyMessageAble('test1', 'Callee test'); } export default class MainUIAbility extends UIAbility { - onCreate(want, launchParam) { + onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { console.log('Callee onCreate is called'); try { this.callee.on(method, funcCallBack); @@ -931,9 +1009,13 @@ off(method: string): void; **示例：** ```ts + import UIAbility from '@ohos.app.ability.UIAbility'; + import AbilityConstant from '@ohos.app.ability.AbilityConstant'; + import Want from '@ohos.app.ability.Want'; + let method = 'call_Function'; export default class MainUIAbility extends UIAbility { - onCreate(want, launchParam) { + onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { console.log('Callee onCreate is called'); try { this.callee.off(method); diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-want.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-want.md index 73e32a8b62d7b41e62963755e2ed04eec5387705..0c987560be6d0c8c7cabf3e05115da7c88bc40dc 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-want.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-want.md @@ -35,12 +35,14 @@ import Want from '@ohos.app.ability.Want'; ```ts import common from '@ohos.app.ability.common'; + import Want from '@ohos.app.ability.Want'; + let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext - let want = { - 'deviceId': '', // deviceId为空表示本设备 - 'bundleName': 'com.example.myapplication', - 'abilityName': 'FuncAbility', - 'moduleName': 'entry' // moduleName非必选 + let want: Want = { + deviceId: '', // deviceId为空表示本设备 + bundleName: 'com.example.myapplication', + abilityName: 'FuncAbility', + moduleName: 'entry' // moduleName非必选 }; context.startAbility(want, (err) => { @@ -54,8 +56,10 @@ import Want from '@ohos.app.ability.Want'; * 字符串（String） ```ts import common from '@ohos.app.ability.common'; + import Want from '@ohos.app.ability.Want'; + let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext - let want = { + let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'FuncAbility', parameters: { @@ -70,8 +74,10 @@ import Want from '@ohos.app.ability.Want'; * 数字（Number） ```ts import common from '@ohos.app.ability.common'; + import Want from '@ohos.app.ability.Want'; + let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext - let want = { + let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'FuncAbility', parameters: { @@ -87,8 +93,10 @@ import Want from '@ohos.app.ability.Want'; * 布尔（Boolean） ```ts import common from '@ohos.app.ability.common'; + import Want from '@ohos.app.ability.Want'; + let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext - let want = { + let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'FuncAbility', parameters: { @@ -103,8 +111,10 @@ import Want from '@ohos.app.ability.Want'; * 对象（Object） ```ts import common from '@ohos.app.ability.common'; + import Want from '@ohos.app.ability.Want'; + let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext - let want = { + let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'FuncAbility', parameters: { @@ -124,8 +134,10 @@ import Want from '@ohos.app.ability.Want'; * 数组（Array） ```ts import common from '@ohos.app.ability.common'; + import Want from '@ohos.app.ability.Want'; + let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext - let want = { + let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'FuncAbility', parameters: { @@ -142,23 +154,27 @@ import Want from '@ohos.app.ability.Want'; ``` * 文件描述符（FD） ```ts - import fs from '@ohos.file.fs'; - + import fs from '@ohos.file.fs'; import common from '@ohos.app.ability.common'; + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; + let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext - let fd; + let fd: number = 0; try { fd = fs.openSync('/data/storage/el2/base/haps/pic.png').fd; } catch(err) { - console.error(`Failed to openSync. Code: ${err.code}, message: ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`Failed to openSync. Code: ${code}, message: ${message}`); } - let want = { - 'deviceId': '', // deviceId为空表示本设备 - 'bundleName': 'com.example.myapplication', - 'abilityName': 'FuncAbility', - 'moduleName': 'entry', // moduleName非必选 - 'parameters': { + let want: Want = { + deviceId: '', // deviceId为空表示本设备 + bundleName: 'com.example.myapplication', + abilityName: 'FuncAbility', + moduleName: 'entry', // moduleName非必选 + parameters: { 'keyFd': { 'type': 'FD', 'value': fd } // {'type':'FD', 'value':fd}是固定用法，用于表示该数据是FD } }; @@ -172,8 +188,10 @@ import Want from '@ohos.app.ability.Want'; ```ts // (1) UIAbility1启动一个ServiceExtension import common from '@ohos.app.ability.common'; + import Want from '@ohos.app.ability.Want'; + let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext - let want = { + let want: Want = { bundleName: 'com.example.myapplication1', abilityName: 'ServiceExtensionAbility', }; @@ -184,8 +202,11 @@ import Want from '@ohos.app.ability.Want'; ```ts // (2) 该ServiceExtension去启动另一个UIAbility2，并在启动的时候携带参数ability.params.backToOtherMissionStack为true - let context ; // ServiceExtensionContext - let want = { + import common from '@ohos.app.ability.common'; + import Want from '@ohos.app.ability.Want'; + + let context = getContext(this) as common.ServiceExtensionContext; // ServiceExtensionContext + let want: Want = { bundleName: 'com.example.myapplication2', abilityName: 'MainAbility', parameters: { diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-wantAgent.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-wantAgent.md index 480e1b89134b898857b48d37fc4f2556262fc934..749eaca327b165117b4b34b3397274c31a5753e8 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-wantAgent.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-wantAgent.md @@ -39,10 +39,14 @@ getWantAgent(info: WantAgentInfo, callback: AsyncCallback\): void **示例：** ```ts +import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + //wantAgent对象 -let wantAgent; +let wantAgent: _WantAgent; //WantAgentInfo对象 -let wantAgentInfo = { +let wantAgentInfo: WantAgent.WantAgentInfo = { wants: [ { deviceId: 'deviceId', @@ -62,7 +66,7 @@ let wantAgentInfo = { mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey6: true, } - } + } as Want ], operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, @@ -70,7 +74,7 @@ let wantAgentInfo = { }; //getWantAgent回调 -function getWantAgentCallback(err, data) { +function getWantAgentCallback(err: BusinessError, data: _WantAgent) { if (err === undefined) { wantAgent = data; } else { @@ -118,9 +122,13 @@ getWantAgent(info: WantAgentInfo): Promise\ **示例：** ```ts -let wantAgent; +import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + +let wantAgent: _WantAgent; //WantAgentInfo对象 -let wantAgentInfo = { +let wantAgentInfo: WantAgent.WantAgentInfo = { wants: [ { deviceId: 'deviceId', @@ -140,7 +148,7 @@ let wantAgentInfo = { mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey6: true, } - } + } as Want ], operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, @@ -150,7 +158,7 @@ let wantAgentInfo = { try { WantAgent.getWantAgent(wantAgentInfo).then((data) => { wantAgent = data; -}).catch((err) => { +}).catch((err: BusinessError) => { console.error('getWantAgent failed! ${err.code} ${err.message}'); }); } catch (err) { @@ -187,10 +195,14 @@ getBundleName(agent: WantAgent, callback: AsyncCallback\): void **示例：** ```ts +import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + //wantAgent对象 -let wantAgent; +let wantAgent: _WantAgent; //WantAgentInfo对象 -let wantAgentInfo = { +let wantAgentInfo: WantAgent.WantAgentInfo = { wants: [ { deviceId: 'deviceId', @@ -210,7 +222,7 @@ let wantAgentInfo = { mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey6: true, } - } + } as Want ], operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, @@ -218,14 +230,14 @@ let wantAgentInfo = { }; //getWantAgent回调 -function getWantAgentCallback(err, data) { +function getWantAgentCallback(err: BusinessError, data: _WantAgent) { if (err === undefined) { wantAgent = data; } else { console.error('getWantAgent failed ${JSON.stringify(wantAgent)}'); } //getBundleName回调 - function getBundleNameCallback(err, data) { + let getBundleNameCallback = (err: BusinessError, data: string) => { if(err) { console.error('getBundleName failed! ${err.code} ${err.message}'); } else { @@ -279,10 +291,14 @@ getBundleName(agent: WantAgent): Promise\ **示例：** ```ts +import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + //wantAgent对象 -let wantAgent; +let wantAgent: _WantAgent; //WantAgentInfo对象 -let wantAgentInfo = { +let wantAgentInfo: WantAgent.WantAgentInfo = { wants: [ { deviceId: 'deviceId', @@ -302,7 +318,7 @@ let wantAgentInfo = { mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey6: true, } - } + } as Want ], operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, @@ -310,7 +326,7 @@ let wantAgentInfo = { }; //getWantAgent回调 -function getWantAgentCallback(err, data) { +function getWantAgentCallback(err: BusinessError, data: _WantAgent) { if (err === undefined) { wantAgent = data; } else { @@ -319,7 +335,7 @@ function getWantAgentCallback(err, data) { try { WantAgent.getBundleName(wantAgent).then((data)=>{ console.info('getBundleName ok! ${JSON.stringify(data)}'); - }).catch((err)=>{ + }).catch((err: BusinessError)=>{ console.error('getBundleName failed! ${err.code} ${err.message}'); }); } catch(err){ @@ -362,11 +378,14 @@ getUid(agent: WantAgent, callback: AsyncCallback\): void **示例：** ```ts -import WantAgent from '@ohos.app.ability.wantAgent'; +import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + //wantAgent对象 -let wantAgent; +let wantAgent: _WantAgent; //WantAgentInfo对象 -let wantAgentInfo = { +let wantAgentInfo: WantAgent.WantAgentInfo = { wants: [ { deviceId: 'deviceId', @@ -386,7 +405,7 @@ let wantAgentInfo = { mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey6: true, } - } + } as Want ], operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, @@ -394,14 +413,14 @@ let wantAgentInfo = { }; //getWantAgent回调 -function getWantAgentCallback(err, data) { +function getWantAgentCallback(err: BusinessError, data: _WantAgent) { if (err === undefined) { wantAgent = data; } else { console.info('getWantAgent failed ${JSON.stringify(err)}'); } //getUid回调 - function getUidCallback(err, data) { + let getUidCallback = (err: BusinessError, data: number) => { if(err) { console.error('getUid failed! ${err.code} ${err.message}'); } else { @@ -455,10 +474,14 @@ getUid(agent: WantAgent): Promise\ **示例：** ```ts +import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + //wantAgent对象 -let wantAgent; +let wantAgent: _WantAgent; //WantAgentInfo对象 -let wantAgentInfo = { +let wantAgentInfo: WantAgent.WantAgentInfo = { wants: [ { deviceId: 'deviceId', @@ -478,7 +501,7 @@ let wantAgentInfo = { mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey6: true, } - } + } as Want ], operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, @@ -486,7 +509,7 @@ let wantAgentInfo = { }; //getWantAgent回调 -function getWantAgentCallback(err, data) { +function getWantAgentCallback(err: BusinessError, data: _WantAgent) { if (err === undefined) { wantAgent = data; } else { @@ -495,7 +518,7 @@ function getWantAgentCallback(err, data) { try { WantAgent.getUid(wantAgent).then((data)=>{ console.info('getUid ok! ${JSON.stringify(data)}'); - }).catch((err)=>{ + }).catch((err: BusinessError)=>{ console.error('getUid failed! ${err.code} ${err.message}'); }); } catch(err){ @@ -540,10 +563,14 @@ getWant(agent: WantAgent, callback: AsyncCallback\): void **示例：** ```ts +import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + //wantAgent对象 -let wantAgent; +let wantAgent: _WantAgent; //WantAgentInfo对象 -let wantAgentInfo = { +let wantAgentInfo: WantAgent.WantAgentInfo = { wants: [ { deviceId: 'deviceId', @@ -563,7 +590,7 @@ let wantAgentInfo = { mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey6: true, } - } + } as Want ], operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, @@ -571,14 +598,14 @@ let wantAgentInfo = { }; //getWantAgent回调 -function getWantAgentCallback(err, data) { +function getWantAgentCallback(err: BusinessError, data: _WantAgent) { if (err === undefined) { wantAgent = data; } else { console.error('getWantAgent failed ${JSON.stringify(wantAgent)}'); } //getWant回调 - function getWantCallback(err, data) { + let getWantCallback = (err: BusinessError, data: Want) => { if(err) { console.error('getWant failed! ${err.code} ${err.message}'); } else { @@ -635,10 +662,14 @@ getWant(agent: WantAgent): Promise\ **示例：** ```ts +import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + //wantAgent对象 -let wantAgent; +let wantAgent: _WantAgent; //WantAgentInfo对象 -let wantAgentInfo = { +let wantAgentInfo: WantAgent.WantAgentInfo = { wants: [ { deviceId: 'deviceId', @@ -658,7 +689,7 @@ let wantAgentInfo = { mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey6: true, } - } + } as Want ], operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, @@ -666,7 +697,7 @@ let wantAgentInfo = { }; //getWantAgent回调 -function getWantAgentCallback(err, data) { +function getWantAgentCallback(err: BusinessError, data: _WantAgent) { if (err === undefined) { wantAgent = data; } else { @@ -675,7 +706,7 @@ function getWantAgentCallback(err, data) { try { WantAgent.getUid(wantAgent).then((data)=>{ console.info('getUid ok! ${JSON.stringify(data)}'); - }).catch((err)=>{ + }).catch((err: BusinessError)=>{ console.error('getUid failed! ${err.code} ${err.message}'); }); } catch(err){ @@ -718,10 +749,14 @@ cancel(agent: WantAgent, callback: AsyncCallback\): void **示例：** ```ts +import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + //wantAgent对象 -let wantAgent; +let wantAgent: _WantAgent; //WantAgentInfo对象 -let wantAgentInfo = { +let wantAgentInfo: WantAgent.WantAgentInfo = { wants: [ { deviceId: 'deviceId', @@ -741,7 +776,7 @@ let wantAgentInfo = { mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey6: true, } - } + } as Want ], operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, @@ -749,14 +784,14 @@ let wantAgentInfo = { }; //getWantAgent回调 -function getWantAgentCallback(err, data) { +function getWantAgentCallback(err: BusinessError, data: _WantAgent) { if (err === undefined) { wantAgent = data; } else { console.error('getWantAgent failed ${JSON.stringify(wantAgent)}'); } //cancel回调 - function cancelCallback(err, data) { + let cancelCallback = (err: BusinessError, data: void) => { if(err) { console.error('cancel failed! ${err.code} ${err.message}'); } else { @@ -810,10 +845,14 @@ cancel(agent: WantAgent): Promise\ **示例：** ```ts +import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + //wantAgent对象 -let wantAgent; +let wantAgent: _WantAgent; //WantAgentInfo对象 -let wantAgentInfo = { +let wantAgentInfo: WantAgent.WantAgentInfo = { wants: [ { deviceId: 'deviceId', @@ -833,7 +872,7 @@ let wantAgentInfo = { mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey6: true, } - } + } as Want ], operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, @@ -841,7 +880,7 @@ let wantAgentInfo = { }; //getWantAgent回调 -function getWantAgentCallback(err, data) { +function getWantAgentCallback(err: BusinessError, data: _WantAgent) { if (err === undefined) { wantAgent = data; } else { @@ -850,7 +889,7 @@ function getWantAgentCallback(err, data) { try { WantAgent.cancel(wantAgent).then((data)=>{ console.info('cancel ok!'); - }).catch((err)=>{ + }).catch((err: BusinessError)=>{ console.error('cancel failed! ${err.code} ${err.message}'); }); } catch(err){ @@ -883,14 +922,18 @@ trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: AsyncCallback\ { if(err) { console.error('getUid failed! ${err.code} ${err.message}'); } else { @@ -966,11 +1009,15 @@ equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback\ { if(err) { console.error('equal failed! ${err.code} ${err.message}'); } else { @@ -1052,11 +1099,15 @@ equal(agent: WantAgent, otherAgent: WantAgent): Promise\ **示例：** ```ts +import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + //wantAgent对象 -let wantAgent1; -let wantAgent2; +let wantAgent1: _WantAgent; +let wantAgent2: _WantAgent; //WantAgentInfo对象 -let wantAgentInfo = { +let wantAgentInfo: WantAgent.WantAgentInfo = { wants: [ { deviceId: 'deviceId', @@ -1076,7 +1127,7 @@ let wantAgentInfo = { mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey6: true, } - } + } as Want ], operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, @@ -1084,7 +1135,7 @@ let wantAgentInfo = { }; //getWantAgent回调 -function getWantAgentCallback(err, data) { +function getWantAgentCallback(err: BusinessError, data: _WantAgent) { if (err === undefined) { wantAgent1 = data; wantAgent2 = data; @@ -1094,7 +1145,7 @@ function getWantAgentCallback(err, data) { try { WantAgent.equal(wantAgent1,wantAgent2).then((data)=>{ console.info('equal ok! ${JSON.stringify(data)}'); - }).catch((err)=>{ + }).catch((err: BusinessError)=>{ console.error('equal failed! ${err.code} ${err.message}'); }) } catch(err){ @@ -1136,10 +1187,14 @@ getOperationType(agent: WantAgent, callback: AsyncCallback\): void; **示例：** ```ts +import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + //wantAgent对象 -let wantAgent; +let wantAgent: _WantAgent; //WantAgentInfo对象 -let wantAgentInfo = { +let wantAgentInfo: WantAgent.WantAgentInfo = { wants: [ { deviceId: 'deviceId', @@ -1159,7 +1214,7 @@ let wantAgentInfo = { mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey6: true, } - } + } as Want ], operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, @@ -1167,14 +1222,14 @@ let wantAgentInfo = { }; //getWantAgent回调 -function getWantAgentCallback(err, data) { +function getWantAgentCallback(err: BusinessError, data: _WantAgent) { if (err === undefined) { wantAgent = data; } else { console.error('getWantAgent failed ${JSON.stringify(wantAgent)}'); } //getOperationTypeCallback回调 - function getOperationTypeCallback(err, data) { + let getOperationTypeCallback = (err: BusinessError, data: number) => { if(err) { console.error('getOperationType failed! ${err.code} ${err.message}'); } else { @@ -1227,10 +1282,14 @@ getOperationType(agent: WantAgent): Promise\; **示例：** ```ts +import WantAgent, { WantAgent as _WantAgent} from '@ohos.app.ability.wantAgent'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + //wantAgent对象 -let wantAgent; +let wantAgent: _WantAgent; //WantAgentInfo对象 -let wantAgentInfo = { +let wantAgentInfo: WantAgent.WantAgentInfo = { wants: [ { deviceId: 'deviceId', @@ -1250,7 +1309,7 @@ let wantAgentInfo = { mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], mykey6: true, } - } + } as Want ], operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, @@ -1258,7 +1317,7 @@ let wantAgentInfo = { }; //getWantAgent回调 -function getWantAgentCallback(err, data) { +function getWantAgentCallback(err: BusinessError, data: _WantAgent) { if (err === undefined) { wantAgent = data; } else { @@ -1267,7 +1326,7 @@ function getWantAgentCallback(err, data) { try { WantAgent.getOperationType(wantAgent).then((data)=>{ console.info('getOperationType ok! ${JSON.stringify(data)}'); - }).catch((err)=>{ + }).catch((err: BusinessError) => { console.error('getOperationType failed! ${err.code} ${err.message}'); }); } catch(err){ diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-StaticSubscriberExtensionContext.md b/zh-cn/application-dev/reference/apis/js-apis-application-StaticSubscriberExtensionContext.md index 90a11780c424866b4b75aa924f9c905ffb3e89c7..9f89fdbef6741fca05a6e6e99c9f2017b0e8a6dc 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-StaticSubscriberExtensionContext.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-StaticSubscriberExtensionContext.md @@ -21,9 +21,10 @@ import StaticSubscriberExtensionContext from '@ohos.application.StaticSubscriber ```ts import StaticSubscriberExtensionAbility from '@ohos.application.StaticSubscriberExtensionAbility' +import StaticSubscriberExtensionContext from '@ohos.application.StaticSubscriberExtensionContext' export default class MyStaticSubscriberExtensionAbility extends StaticSubscriberExtensionAbility { - context = this.context; + context: StaticSubscriberExtensionContext = this.context; }; ``` @@ -73,13 +74,16 @@ startAbility(want: Want, callback: AsyncCallback<void>): void; **示例：** ```ts - let want = { + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; + + let want: Want = { bundleName: "com.example.myapp", abilityName: "MyAbility" }; try { - this.context.startAbility(want, (error) => { + this.context.startAbility(want, (error: BusinessError) => { if (error) { // 处理业务逻辑错误 console.log('startAbility failed, error.code: ' + JSON.stringify(error.code) + @@ -91,8 +95,10 @@ startAbility(want: Want, callback: AsyncCallback<void>): void; }); } catch (paramError) { // 处理入参错误异常 - console.log('startAbility failed, error.code: ' + JSON.stringify(paramError.code) + - ' error.message: ' + JSON.stringify(paramError.message)); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.log('startAbility failed, error.code: ' + JSON.stringify(code) + + ' error.message: ' + JSON.stringify(message)); } ``` @@ -147,7 +153,10 @@ startAbility(want: Want): Promise<void>; **示例：** ```ts - let want = { + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; + + let want: Want = { bundleName: "com.example.myapp", abilityName: "MyAbility" }; @@ -158,14 +167,16 @@ startAbility(want: Want): Promise<void>; // 执行正常业务 console.log('startAbility succeed'); }) - .catch((error) => { + .catch((error: BusinessError) => { // 处理业务逻辑错误 console.log('startAbility failed, error.code: ' + JSON.stringify(error.code) + ' error.message: ' + JSON.stringify(error.message)); }); } catch (paramError) { // 处理入参错误异常 - console.log('startAbility failed, error.code: ' + JSON.stringify(paramError.code) + - ' error.message: ' + JSON.stringify(paramError.message)); + let code = (paramError as BusinessError).code; + let message = (paramError as BusinessError).message; + console.log('startAbility failed, error.code: ' + JSON.stringify(code) + + ' error.message: ' + JSON.stringify(message)); } ``` \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegatorRegistry.md b/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegatorRegistry.md index 6f4b2e791182d8dfaa95bd921070f8cf9e1a6a4a..94e4928b3ff130ec4dcdc20e134a71810d271e19 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegatorRegistry.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegatorRegistry.md @@ -43,9 +43,9 @@ getAbilityDelegator(): AbilityDelegator **示例：** ```ts -let abilityDelegator; +import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'; -abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); +let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); ``` ## AbilityDelegatorRegistry.getArguments @@ -65,6 +65,8 @@ getArguments(): AbilityDelegatorArgs **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'; + let args = AbilityDelegatorRegistry.getArguments(); console.info('getArguments bundleName: ${args.bundleName}'); console.info('getArguments testCaseNames: ${args.testCaseNames}'); diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-abilityManager.md b/zh-cn/application-dev/reference/apis/js-apis-application-abilityManager.md index 1b786fc961b4597a3773ce43c8897718110702fc..3b279ffa585580c20c0fe772d14363fdfe474ae4 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-abilityManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-abilityManager.md @@ -49,7 +49,10 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\): void **示例**： ```ts -let config = { +import abilityManager from '@ohos.application.abilityManager'; +import { Configuration } from '@ohos.application.Configuration'; + +let config: Configuration = { language: 'chinese' }; @@ -83,13 +86,17 @@ updateConfiguration(config: Configuration): Promise\ **示例**： ```ts -let config = { +import abilityManager from '@ohos.application.abilityManager'; +import { Configuration } from '@ohos.application.Configuration'; +import { BusinessError } from '@ohos.base'; + +let config: Configuration = { language: 'chinese' }; abilityManager.updateConfiguration(config).then(() => { console.log('updateConfiguration success'); -}).catch((err) => { +}).catch((err: BusinessError) => { console.error('updateConfiguration fail'); }); ``` @@ -113,6 +120,8 @@ getAbilityRunningInfos(callback: AsyncCallback\>): vo **示例**： ```ts +import abilityManager from '@ohos.application.abilityManager'; + abilityManager.getAbilityRunningInfos((err,data) => { console.log('getAbilityRunningInfos err: ${err}, data: ${JSON.stringify(data)}'); }); @@ -137,9 +146,12 @@ getAbilityRunningInfos(): Promise\> **示例**： ```ts +import abilityManager from '@ohos.application.abilityManager'; +import { BusinessError } from '@ohos.base'; + abilityManager.getAbilityRunningInfos().then((data) => { console.log('getAbilityRunningInfos data: ${JSON.stringify(data)}'); -}).catch((err) => { +}).catch((err: BusinessError) => { console.error('getAbilityRunningInfos err: ${JSON.stringify(err)}'); }); ``` \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-appManager.md b/zh-cn/application-dev/reference/apis/js-apis-application-appManager.md index b8e5b98293ecc4f6c7d96f0eb872f1365644abfb..f1f53e5c8667696d0f6ad626e4c5aae2ed1e16b2 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-appManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-appManager.md @@ -29,6 +29,8 @@ static isRunningInStabilityTest(callback: AsyncCallback<boolean>): void **示例：** ```ts + import appManager from '@ohos.application.appManager'; + appManager.isRunningInStabilityTest((error, flag) => { if (error && error.code !== 0) { console.error('isRunningInStabilityTest fail, error: ${JSON.stringify(error)}'); @@ -56,9 +58,12 @@ static isRunningInStabilityTest(): Promise<boolean> **示例：** ```ts + import appManager from '@ohos.application.appManager'; + import { BusinessError } from '@ohos.base'; + appManager.isRunningInStabilityTest().then((flag) => { console.log('The result of isRunningInStabilityTest is: ${JSON.stringify(flag)}'); - }).catch((error) => { + }).catch((error: BusinessError) => { console.error('error: ${JSON.stringify(error)}'); }); ``` @@ -81,9 +86,12 @@ isRamConstrainedDevice(): Promise\; **示例：** ```ts + import appManager from '@ohos.application.appManager'; + import { BusinessError } from '@ohos.base'; + appManager.isRamConstrainedDevice().then((data) => { console.log('The result of isRamConstrainedDevice is: ${JSON.stringify(data)}'); - }).catch((error) => { + }).catch((error: BusinessError) => { console.error('error: ${JSON.stringify(error)}'); }); ``` @@ -105,6 +113,8 @@ isRamConstrainedDevice(callback: AsyncCallback\): void; **示例：** ```ts + import appManager from '@ohos.application.appManager'; + appManager.isRamConstrainedDevice((error, data) => { if (error && error.code !== 0) { console.error('isRamConstrainedDevice fail, error: ${JSON.stringify(error)}'); @@ -131,9 +141,12 @@ getAppMemorySize(): Promise\; **示例：** ```ts + import appManager from '@ohos.application.appManager'; + import { BusinessError } from '@ohos.base'; + appManager.getAppMemorySize().then((data) => { console.log('The size of app memory is: ${JSON.stringify(data)}'); - }).catch((error) => { + }).catch((error: BusinessError) => { console.error('error: ${JSON.stringify(error)}'); }); ``` @@ -155,6 +168,8 @@ getAppMemorySize(callback: AsyncCallback\): void; **示例：** ```ts + import appManager from '@ohos.application.appManager'; + appManager.getAppMemorySize((error, data) => { if (error && error.code !== 0) { console.error('getAppMemorySize fail, error: ${JSON.stringify(error)}'); @@ -184,9 +199,12 @@ getProcessRunningInfos(): Promise\>; **示例：** ```ts + import appManager from '@ohos.application.appManager'; + import { BusinessError } from '@ohos.base'; + appManager.getProcessRunningInfos().then((data) => { console.log('The process running infos is: ${JSON.stringify(data)}'); - }).catch((error) => { + }).catch((error: BusinessError) => { console.error('error: ${JSON.stringify(error)}'); }); ``` @@ -212,6 +230,8 @@ getProcessRunningInfos(callback: AsyncCallback\>): vo **示例：** ```ts + import appManager from '@ohos.application.appManager'; + appManager.getProcessRunningInfos((error, data) => { if (error && error.code !== 0) { console.error('getProcessRunningInfos fail, error: ${JSON.stringify(error)}'); @@ -242,7 +262,9 @@ registerApplicationStateObserver(observer: ApplicationStateObserver): number; **示例：** ```ts - let applicationStateObserver = { + import appManager from '@ohos.application.appManager'; + + const observerCode = appManager.registerApplicationStateObserver({ onForegroundApplicationChanged(appStateData) { console.log('------------ onForegroundApplicationChanged -----------', appStateData); }, @@ -258,8 +280,7 @@ registerApplicationStateObserver(observer: ApplicationStateObserver): number; onProcessStateChanged(processData) { console.log('------------ onProcessStateChanged -----------', processData); } - }; - const observerCode = appManager.registerApplicationStateObserver(applicationStateObserver); + }); console.log('-------- observerCode: ---------', observerCode); ``` @@ -285,9 +306,12 @@ unregisterApplicationStateObserver(observerId: number, callback: AsyncCallback\ **示例：** ```ts + import appManager from '@ohos.application.appManager'; + import { BusinessError } from '@ohos.base'; + let observerId = 100; - function unregisterApplicationStateObserverCallback(err) { + function unregisterApplicationStateObserverCallback(err: BusinessError) { if (err) { console.error('------------ unregisterApplicationStateObserverCallback ------------', err); } @@ -322,13 +346,16 @@ unregisterApplicationStateObserver(observerId: number): Promise\; **示例：** ```ts + import appManager from '@ohos.application.appManager'; + import { BusinessError } from '@ohos.base'; + let observerId = 100; appManager.unregisterApplicationStateObserver(observerId) .then((data) => { console.log('----------- unregisterApplicationStateObserver success ----------', data); }) - .catch((err) => { + .catch((err: BusinessError) => { console.error('----------- unregisterApplicationStateObserver fail ----------', err); }); ``` @@ -354,14 +381,15 @@ getForegroundApplications(callback: AsyncCallback\>): void; **示例：** ```ts - function getForegroundApplicationsCallback(err, data) { + import appManager from '@ohos.application.appManager'; + + appManager.getForegroundApplications((err, data) => { if (err) { console.error('--------- getForegroundApplicationsCallback fail ---------', err); } else { console.log('--------- getForegroundApplicationsCallback success ---------', data); } - } - appManager.getForegroundApplications(getForegroundApplicationsCallback); + }); ``` ## appManager.getForegroundApplications8+ @@ -385,11 +413,14 @@ getForegroundApplications(): Promise\>; **示例：** ```ts + import appManager from '@ohos.application.appManager'; + import { BusinessError } from '@ohos.base'; + appManager.getForegroundApplications() .then((data) => { console.log('--------- getForegroundApplications success -------', data); }) - .catch((err) => { + .catch((err: BusinessError) => { console.error('--------- getForegroundApplications fail -------', err); }); ``` @@ -420,13 +451,16 @@ killProcessWithAccount(bundleName: string, accountId: number): Promise\ **示例：** ```ts +import appManager from '@ohos.application.appManager'; +import { BusinessError } from '@ohos.base'; + let bundleName = 'bundleName'; let accountId = 0; appManager.killProcessWithAccount(bundleName, accountId) .then((data) => { console.log('------------ killProcessWithAccount success ------------', data); }) - .catch((err) => { + .catch((err: BusinessError) => { console.error('------------ killProcessWithAccount fail ------------', err); }); ``` @@ -459,9 +493,12 @@ killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCal **示例：** ```ts +import appManager from '@ohos.application.appManager'; +import { BusinessError } from '@ohos.base'; + let bundleName = 'bundleName'; let accountId = 0; -function killProcessWithAccountCallback(err, data) { +function killProcessWithAccountCallback(err: BusinessError, data: void) { if (err) { console.error('------------- killProcessWithAccountCallback fail, err: --------------', err); } else { @@ -493,8 +530,11 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\); **示例：** ```ts + import appManager from '@ohos.application.appManager'; +import { BusinessError } from '@ohos.base'; + let bundleName = 'bundleName'; - function killProcessesByBundleNameCallback(err, data) { + function killProcessesByBundleNameCallback(err: BusinessError, data: void) { if (err) { console.error('------------- killProcessesByBundleNameCallback fail, err: --------------', err); } else { @@ -531,12 +571,15 @@ killProcessesByBundleName(bundleName: string): Promise\; **示例：** ```ts + import appManager from '@ohos.application.appManager'; + import { BusinessError } from '@ohos.base'; + let bundleName = 'com.example.myapplication'; appManager.killProcessesByBundleName(bundleName) .then((data) => { console.log('------------ killProcessesByBundleName success ------------', data); }) - .catch((err) => { + .catch((err: BusinessError) => { console.error('------------ killProcessesByBundleName fail ------------', err); }); ``` @@ -563,8 +606,11 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\); **示例：** ```ts + import appManager from '@ohos.application.appManager'; + import { BusinessError } from '@ohos.base'; + let bundleName = 'bundleName'; - function clearUpApplicationDataCallback(err, data) { + function clearUpApplicationDataCallback(err: BusinessError, data: void) { if (err) { console.error('------------- clearUpApplicationDataCallback fail, err: --------------', err); } else { @@ -601,12 +647,15 @@ clearUpApplicationData(bundleName: string): Promise\; **示例：** ```ts + import appManager from '@ohos.application.appManager'; + import { BusinessError } from '@ohos.base'; + let bundleName = 'bundleName'; appManager.clearUpApplicationData(bundleName) .then((data) => { console.log('------------ clearUpApplicationData success ------------', data); }) - .catch((err) => { + .catch((err: BusinessError) => { console.error('------------ clearUpApplicationData fail ------------', err); }); ``` \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-configuration.md b/zh-cn/application-dev/reference/apis/js-apis-application-configuration.md index ecedf1806d4bfdd8f6c50e94e57f0b6e73d023c6..c2b16b57feadc0d6729f03423c094f32b5f15000 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-configuration.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-configuration.md @@ -25,17 +25,20 @@ import Configuration from '@ohos.application.Configuration'; **示例：** ```ts import UIAbility from '@ohos.app.ability.UIAbility'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; +import EnvironmentCallback from '@ohos.app.ability.EnvironmentCallback'; +import Want from '@ohos.app.ability.Want'; import Window from '@ohos.window'; export default class EntryAbility extends UIAbility { - onCreate(want, launchParam) { + onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { } onDestroy() { } onWindowStageCreate(windowStage: Window.WindowStage) { - let envCallback = { + let envCallback: EnvironmentCallback = { onConfigurationUpdated(config) { console.info(`envCallback onConfigurationUpdated success: ${JSON.stringify(config)}`); let language = config.language; diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-missionManager.md b/zh-cn/application-dev/reference/apis/js-apis-application-missionManager.md index bc25988f7a20c5d3693aa5f0b9949045965299be..1f3a27e412fcec3e839ac3b23232499f9ead5e21 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-missionManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-missionManager.md @@ -43,17 +43,18 @@ registerMissionListener(listener: MissionListener): number; **示例：** ```ts -let listener = { - onMissionCreated: function (mission) {console.log('--------onMissionCreated-------');}, - onMissionDestroyed: function (mission) {console.log('--------onMissionDestroyed-------');}, - onMissionSnapshotChanged: function (mission) {console.log('--------onMissionSnapshotChanged-------');}, - onMissionMovedToFront: function (mission) {console.log('--------onMissionMovedToFront-------');}, - onMissionIconUpdated: function (mission, icon) {console.log('--------onMissionIconUpdated-------');}, - onMissionClosed: function (mission) {console.log('--------onMissionClosed-------');}, - onMissionLabelUpdated: function (mission) {console.log('--------onMissionLabelUpdated-------');} -}; +import missionManager from '@ohos.application.missionManager'; + console.log('registerMissionListener'); -let listenerid = missionManager.registerMissionListener(listener); +let listenerid = missionManager.registerMissionListener({ + onMissionCreated: (mission) => {console.log('--------onMissionCreated-------');}, + onMissionDestroyed: (mission) => {console.log('--------onMissionDestroyed-------');}, + onMissionSnapshotChanged: (mission) => {console.log('--------onMissionSnapshotChanged-------');}, + onMissionMovedToFront: (mission) => {console.log('--------onMissionMovedToFront-------');}, + onMissionIconUpdated: (mission, icon) => {console.log('--------onMissionIconUpdated-------');}, + onMissionClosed: (mission) => {console.log('--------onMissionClosed-------');}, + onMissionLabelUpdated: (mission) => {console.log('--------onMissionLabelUpdated-------');} +}); ``` @@ -79,17 +80,18 @@ unregisterMissionListener(listenerId: number, callback: AsyncCallback<void> **示例：** ```ts - let listener = { - onMissionCreated: function (mission) {console.log('--------onMissionCreated-------');}, - onMissionDestroyed: function (mission) {console.log('--------onMissionDestroyed-------');}, - onMissionSnapshotChanged: function (mission) {console.log('--------onMissionSnapshotChanged-------');}, - onMissionMovedToFront: function (mission) {console.log('--------onMissionMovedToFront-------');}, - onMissionIconUpdated: function (mission, icon) {console.log('--------onMissionIconUpdated-------');}, - onMissionClosed: function (mission) {console.log('--------onMissionClosed-------');}, - onMissionLabelUpdated: function (mission) {console.log('--------onMissionLabelUpdated-------');} - }; + import missionManager from '@ohos.application.missionManager'; + console.log('registerMissionListener'); - let listenerid = missionManager.registerMissionListener(listener); + let listenerid = missionManager.registerMissionListener({ + onMissionCreated: (mission) => {console.log('--------onMissionCreated-------');}, + onMissionDestroyed: (mission) => {console.log('--------onMissionDestroyed-------');}, + onMissionSnapshotChanged: (mission) => {console.log('--------onMissionSnapshotChanged-------');}, + onMissionMovedToFront: (mission) => {console.log('--------onMissionMovedToFront-------');}, + onMissionIconUpdated: (mission, icon) => {console.log('--------onMissionIconUpdated-------');}, + onMissionClosed: (mission) => {console.log('--------onMissionClosed-------');}, + onMissionLabelUpdated: (mission) => {console.log('--------onMissionLabelUpdated-------');} + }); missionManager.unregisterMissionListener(listenerid, (error) => { console.error('unregisterMissionListener fail, error: ${error}'); @@ -124,19 +126,21 @@ unregisterMissionListener(listenerId: number): Promise<void>; **示例：** ```ts - let listener = { - onMissionCreated: function (mission) {console.log('--------onMissionCreated-------');}, - onMissionDestroyed: function (mission) {console.log('--------onMissionDestroyed-------');}, - onMissionSnapshotChanged: function (mission) {console.log('--------onMissionSnapshotChanged-------');}, - onMissionMovedToFront: function (mission) {console.log('--------onMissionMovedToFront-------');}, - onMissionIconUpdated: function (mission, icon) {console.log('--------onMissionIconUpdated-------');}, - onMissionClosed: function (mission) {console.log('--------onMissionClosed-------');}, - onMissionLabelUpdated: function (mission) {console.log('--------onMissionLabelUpdated-------');} - }; + import missionManager from '@ohos.application.missionManager'; + import { BusinessError } from '@ohos.base'; + console.log('registerMissionListener'); - let listenerid = missionManager.registerMissionListener(listener); + let listenerid = missionManager.registerMissionListener({ + onMissionCreated: (mission) => {console.log('--------onMissionCreated-------');}, + onMissionDestroyed: (mission) => {console.log('--------onMissionDestroyed-------');}, + onMissionSnapshotChanged: (mission) => {console.log('--------onMissionSnapshotChanged-------');}, + onMissionMovedToFront: (mission) => {console.log('--------onMissionMovedToFront-------');}, + onMissionIconUpdated: (mission, icon) => {console.log('--------onMissionIconUpdated-------');}, + onMissionClosed: (mission) => {console.log('--------onMissionClosed-------');}, + onMissionLabelUpdated: (mission) => {console.log('--------onMissionLabelUpdated-------');} + }); - missionManager.unregisterMissionListener(listenerid).catch(function (error) { + missionManager.unregisterMissionListener(listenerid).catch((error: BusinessError) => { console.error('unregisterMissionListener fail, error: ${error}'); }); ``` @@ -166,21 +170,23 @@ getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback<M ```ts import missionManager from '@ohos.application.missionManager'; + import { BusinessError } from '@ohos.base'; - let allMissions=missionManager.getMissionInfos('',10).catch(function(err){console.log(err);}); - missionManager.getMissionInfo('', allMissions[0].missionId, (error, mission) => { - if (error.code) { - console.error('getMissionInfo failed, error.code: ${error.code}, error.message: ${error.message}'); - return; - } - - console.log('mission.missionId = ${mission.missionId}'); - console.log('mission.runningState = ${mission.runningState}'); - console.log('mission.lockedState = ${mission.lockedState}'); - console.log('mission.timestamp = ${mission.timestamp}'); - console.log('mission.label = ${mission.label}'); - console.log('mission.iconPath = ${mission.iconPath}'); - }); + let allMissions=missionManager.getMissionInfos('',10).catch((err: BusinessError) => { + console.log('${err}');}); + missionManager.getMissionInfo('', allMissions[0].missionId, (error, mission) => { + if (error.code) { + console.error('getMissionInfo failed, error.code: ${error.code}, error.message: ${error.message}'); + return; + } + + console.log('mission.missionId = ${mission.missionId}'); + console.log('mission.runningState = ${mission.runningState}'); + console.log('mission.lockedState = ${mission.lockedState}'); + console.log('mission.timestamp = ${mission.timestamp}'); + console.log('mission.label = ${mission.label}'); + console.log('mission.iconPath = ${mission.iconPath}'); + }); ``` @@ -213,8 +219,9 @@ getMissionInfo(deviceId: string, missionId: number): Promise<MissionInfo>; ```ts import missionManager from '@ohos.application.missionManager'; + import { BusinessError } from '@ohos.base'; - let mission = missionManager.getMissionInfo('', 10).catch(function (error){ + let mission = missionManager.getMissionInfo('', 10).catch((error: BusinessError) => { console.error('getMissionInfo fail, error: ${error}'); }); ``` @@ -285,8 +292,9 @@ getMissionInfos(deviceId: string, numMax: number): Promise<Array<MissionIn ```ts import missionManager from '@ohos.application.missionManager'; + import { BusinessError } from '@ohos.base'; - let allMissions = missionManager.getMissionInfos('', 10).catch(function (error){ + let allMissions = missionManager.getMissionInfos('', 10).catch((error: BusinessError) => { console.error('getMissionInfos fail, error: ${error}'); }); ``` @@ -366,20 +374,21 @@ getMissionSnapShot(deviceId: string, missionId: number): Promise<MissionSnaps ```ts import missionManager from '@ohos.application.missionManager'; + import { BusinessError } from '@ohos.base'; - let allMissions; - missionManager.getMissionInfos('',10).then(function(res){ - allMissions=res; - }).catch(function(error) { - console.error('getMissionInfos fail, error: ${error}'); - }); + let id: number = -1; + missionManager.getMissionInfos('',10).then((res) => { + let allMissions = res; console.log('size = ${allMissions.length}'); console.log('missions = ${JSON.stringify(allMissions)}'); - let id = allMissions[0].missionId; + id = allMissions[0].missionId; + }).catch((error: BusinessError) => { + console.error('getMissionInfos fail, error: ${error}'); + }); - let snapshot = missionManager.getMissionSnapShot('', id).catch(function (error){ - console.error('getMissionSnapShot fail, error: ${error}'); - }); + let snapshot = missionManager.getMissionSnapShot('', id).catch((error: BusinessError) => { + console.error('getMissionSnapShot fail, error: ${error}'); + }); ``` ## missionManager.lockMission @@ -450,17 +459,19 @@ lockMission(missionId: number): Promise<void>; ```ts import missionManager from '@ohos.application.missionManager'; - let allMissions; - missionManager.getMissionInfos('',10).then(function(res){ - allMissions=res; - }).catch(function(error) { + import { BusinessError } from '@ohos.base'; + + let id: number = -1; + missionManager.getMissionInfos('',10).then((res) => { + let allMissions = res; + console.log('size = ${allMissions.length}'); + console.log('missions = ${JSON.stringify(allMissions)}'); + id = allMissions[0].missionId; + }).catch((error: BusinessError) => { console.error('getMissionInfos fail, error: ${error}'); }); - console.log('size = ${allMissions.length}'); - console.log('missions = ${JSON.stringify(allMissions)}'); - let id = allMissions[0].missionId; - missionManager.lockMission(id).catch(function (error){ + missionManager.lockMission(id).catch((error: BusinessError) => { console.error('lockMission fail, error: ${error}'); }); ``` @@ -534,21 +545,22 @@ unlockMission(missionId: number): Promise<void>; ```ts import missionManager from '@ohos.application.missionManager'; + import { BusinessError } from '@ohos.base'; - let allMissions; - missionManager.getMissionInfos('',10).then(function(res){ - allMissions=res; - }).catch(function(error) { + let id: number = -1; + missionManager.getMissionInfos('',10).then((res) => { + let allMissions = res; + console.log('size = ${allMissions.length}'); + console.log('missions = ${JSON.stringify(allMissions)}'); + id = allMissions[0].missionId; + }).catch((error: BusinessError) => { console.error('getMissionInfos fail, error: ${error}'); }); - console.log('size = ${allMissions.length}'); - console.log('missions = ${JSON.stringify(allMissions)}'); - let id = allMissions[0].missionId; - missionManager.lockMission(id).catch(function (error){ + missionManager.lockMission(id).catch((error: BusinessError) => { console.error('lockMission fail, error: ${error}'); }); - missionManager.unlockMission(id).catch(function (error){ + missionManager.unlockMission(id).catch((error: BusinessError) => { console.error('unlockMission fail, error: ${error}'); }); ``` @@ -622,18 +634,19 @@ clearMission(missionId: number): Promise<void>; ```ts import missionManager from '@ohos.application.missionManager'; + import { BusinessError } from '@ohos.base'; - let allMissions; - missionManager.getMissionInfos('',10).then(function(res){ - allMissions=res; - }).catch(function(error) { + let id: number = -1; + missionManager.getMissionInfos('',10).then((res) => { + let allMissions = res; + console.log('size = ${allMissions.length}'); + console.log('missions = ${JSON.stringify(allMissions)}'); + id = allMissions[0].missionId; + }).catch((error: BusinessError) => { console.error('getMissionInfos fail, error: ${error}'); }); - console.log('size = ${allMissions.length}'); - console.log('missions = ${JSON.stringify(allMissions)}'); - let id = allMissions[0].missionId; - missionManager.clearMission(id).catch(function (error){ + missionManager.clearMission(id).catch((error: BusinessError) => { console.error('clearMission fail, error: ${error}'); }); ``` @@ -684,7 +697,9 @@ clearAllMissions(): Promise<void>; ```ts import missionManager from '@ohos.application.missionManager'; - missionManager.clearAllMissions().catch(function (error){ + import { BusinessError } from '@ohos.base'; + + missionManager.clearAllMissions().catch((error: BusinessError) => { console.error('clearAllMissions fail, error: ${error}'); }); ``` @@ -800,18 +815,19 @@ moveMissionToFront(missionId: number, options?: StartOptions): Promise<void&g ```ts import missionManager from '@ohos.application.missionManager'; + import { BusinessError } from '@ohos.base'; - let allMissions; - missionManager.getMissionInfos('',10).then(function(res){ - allMissions=res; - }).catch(function(error) { + let id: number = -1; + missionManager.getMissionInfos('',10).then((res) => { + let allMissions = res; + console.log('size = ${allMissions.length}'); + console.log('missions = ${JSON.stringify(allMissions)}'); + id = allMissions[0].missionId; + }).catch((error: BusinessError) => { console.error('getMissionInfos fail, error: ${error}'); }); - console.log('size = ${allMissions.length}'); - console.log('missions = ${JSON.stringify(allMissions)}'); - let id = allMissions[0].missionId; - missionManager.moveMissionToFront(id).catch(function (error){ + missionManager.moveMissionToFront(id).catch((error: BusinessError) => { console.error('moveMissionToFront fail, error: ${error}'); }); ``` \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-staticSubscriberExtensionAbility.md b/zh-cn/application-dev/reference/apis/js-apis-application-staticSubscriberExtensionAbility.md index 76ebc7ec31c0e07620ddb2d3a2dcac70b827321b..5d646c9d7c75ea552f44b7f7646d038517ff0211 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-staticSubscriberExtensionAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-staticSubscriberExtensionAbility.md @@ -41,8 +41,11 @@ onReceiveEvent(event: CommonEventData): void; **示例：** ```ts + import StaticSubscriberExtensionAbility from '@ohos.application.StaticSubscriberExtensionAbility'; + import CommonEventManager from '@ohos.commonEventManager'; + class MyStaticSubscriberExtensionAbility extends StaticSubscriberExtensionAbility { - onReceiveEvent(event) { + onReceiveEvent(event: CommonEventManager.CommonEventData) { console.log('onReceiveEvent, event: ${JSON.stringify(event)}'); } } diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-testRunner.md b/zh-cn/application-dev/reference/apis/js-apis-application-testRunner.md index 452a1cf96e3829bd278bebdf434561ca390abb54..16b0552dc84cf58fc0405ee50643b3bee9ae8291 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-testRunner.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-testRunner.md @@ -25,6 +25,8 @@ onPrepare(): void **示例：** ```ts +import TestRunner from '@ohos.application.testRunner'; + export default class UserTestRunner implements TestRunner { onPrepare() { console.log('Trigger onPrepare'); @@ -46,6 +48,8 @@ onRun(): void **示例：** ```ts +import TestRunner from '@ohos.application.testRunner'; + export default class UserTestRunner implements TestRunner { onPrepare() {} onRun() { diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-want.md b/zh-cn/application-dev/reference/apis/js-apis-application-want.md index 79ec55abac8102f1ede8c637a516988c1f31a1d3..a755fcb8f0db01967500269de3bceca004942203 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-want.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-want.md @@ -33,13 +33,15 @@ import Want from '@ohos.application.Want'; - 基础用法(在UIAbility对象中调用，其中示例中的context为UIAbility的上下文对象) ```ts - let want = { + import Want from '@ohos.application.Want'; + import { BusinessError } from '@ohos.base'; + + let want: Want = { 'deviceId': '', // deviceId为空表示本设备 'bundleName': 'com.example.myapplication', 'abilityName': 'EntryAbility', - 'moduleName': 'entry' // moduleName非必选 }; - this.context.startAbility(want, (error) => { + this.context.startAbility(want, (error: BusinessError) => { // 显式拉起Ability，通过bundleName、abilityName和moduleName可以唯一确定一个Ability console.error('error.code = ${error.code}'); }); @@ -49,7 +51,9 @@ import Want from '@ohos.application.Want'; * 字符串（String） ```ts - let want = { + import Want from '@ohos.application.Want'; + + let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'EntryAbility', parameters: { @@ -59,7 +63,9 @@ import Want from '@ohos.application.Want'; ``` * 数字（Number） ```ts - let want = { + import Want from '@ohos.application.Want'; + + let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'EntryAbility', parameters: { @@ -70,7 +76,9 @@ import Want from '@ohos.application.Want'; ``` * 布尔（Boolean） ```ts - let want = { + import Want from '@ohos.application.Want'; + + let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'EntryAbility', parameters: { @@ -80,7 +88,9 @@ import Want from '@ohos.application.Want'; ``` * 对象（Object） ```ts - let want = { + import Want from '@ohos.application.Want'; + + let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'EntryAbility', parameters: { @@ -95,7 +105,9 @@ import Want from '@ohos.application.Want'; ``` * 数组（Array） ```ts - let want = { + import Want from '@ohos.application.Want'; + + let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'EntryAbility', parameters: { @@ -109,22 +121,24 @@ import Want from '@ohos.application.Want'; * 文件描述符（FD） ```ts import fs from '@ohos.file.fs'; - let fd; + import Want from '@ohos.application.Want'; + import { BusinessError } from '@ohos.base'; + + let fd: number = 0; try { fd = fs.openSync('/data/storage/el2/base/haps/pic.png').fd; } catch(e) { console.error('openSync fail: ${JSON.stringify(e)}'); } - let want = { - 'deviceId': '', // deviceId为空表示本设备 - 'bundleName': 'com.example.myapplication', - 'abilityName': 'EntryAbility', - 'moduleName': 'entry', // moduleName非必选 - 'parameters': { + let want: Want = { + deviceId: '', // deviceId为空表示本设备 + bundleName: 'com.example.myapplication', + abilityName: 'EntryAbility', + parameters: { 'keyFd':{'type':'FD', 'value':fd} } }; - this.context.startAbility(want, (error) => { + this.context.startAbility(want, (error: BusinessError) => { // 显式拉起Ability，通过bundleName、abilityName和moduleName可以唯一确定一个Ability console.error('error.code = ${error.code}'); }); diff --git a/zh-cn/application-dev/reference/apis/js-apis-businessAbilityRouter.md b/zh-cn/application-dev/reference/apis/js-apis-businessAbilityRouter.md index b2cfd51dd134b9cec1cfbea1184f75ab93e1f366..a00f3b229090fa559df61b310d3f813f623aa0b7 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-businessAbilityRouter.md +++ b/zh-cn/application-dev/reference/apis/js-apis-businessAbilityRouter.md @@ -72,17 +72,20 @@ queryBusinessAbilityInfo(filter: BusinessAbilityFilter, callback: AsyncCallback\ ```ts import businessAbilityRouter from '@ohos.app.businessAbilityRouter'; -let filter = {businessType: businessAbilityRouter.BusinessType.SHARE}; +import { BusinessError } from '@ohos.base'; + +let filter: businessAbilityRouter.BusinessAbilityFilter = {businessType: businessAbilityRouter.BusinessType.SHARE}; try { businessAbilityRouter.queryBusinessAbilityInfo(filter) .then(() => { console.info('queryBusinessAbilityInfo success'); - }).catch((error) => { + }).catch((error: BusinessError) => { console.error('queryBusinessAbilityInfo failed ' + error.message); }); } catch (error) { - console.error('queryBusinessAbilityInfo failed ' + error.message); + let message = (error as BusinessError).message; + console.error('queryBusinessAbilityInfo failed ' + message); } ``` @@ -114,7 +117,9 @@ queryBusinessAbilityInfo(filter: BusinessAbilityFilter): Promise\ { @@ -125,6 +130,7 @@ try { console.info('queryBusinessAbilityInfo success'); }); } catch (error) { - console.error('queryBusinessAbilityInfo failed ' + error.message); + let message = (error as BusinessError).message; + console.error('queryBusinessAbilityInfo failed ' + message); } ``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-ability-connectOptions.md b/zh-cn/application-dev/reference/apis/js-apis-inner-ability-connectOptions.md index b15166676d80960da4103958e9ea15701079dc76..3cc47479530e2fde9ab985c5294974e97814e4ba 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-ability-connectOptions.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-ability-connectOptions.md @@ -25,7 +25,10 @@ import common from '@ohos.app.ability.common'; **示例：** ```ts - let want = { + import common from '@ohos.app.ability.common'; + import Want from '@ohos.app.ability.Want'; + + let want: Want = { bundleName: 'com.example.myapp', abilityName: 'MyAbility' }; @@ -42,5 +45,5 @@ import common from '@ohos.app.ability.common'; } }; - let connection = this.context.connectAbility(want, connectOptions); + let connection: number = this.context.connectAbility(want, connectOptions); ``` \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-ability-dataAbilityHelper.md b/zh-cn/application-dev/reference/apis/js-apis-inner-ability-dataAbilityHelper.md index 553edd2ee170d0c4510799e9fd050baf470d9359..58e4ca785fc43354d9c44bc3b4821d9f0ad009bd 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-ability-dataAbilityHelper.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-ability-dataAbilityHelper.md @@ -40,7 +40,9 @@ openFile(uri: string, mode: string, callback: AsyncCallback\): void **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; + let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 'dataability:///com.example.DataAbility' ); @@ -78,7 +80,9 @@ openFile(uri: string, mode: string): Promise\ **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; + let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 'dataability:///com.example.DataAbility' ); @@ -107,7 +111,9 @@ on(type: 'dataChange', uri: string, callback: AsyncCallback\): void **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; + let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 'dataability:///com.example.DataAbility' ); @@ -140,7 +146,9 @@ off(type: 'dataChange', uri: string, callback?: AsyncCallback\): void **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; + let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 'dataability:///com.example.DataAbility' ); @@ -176,7 +184,9 @@ getType(uri: string, callback: AsyncCallback\): void **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; + let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 'dataability:///com.example.DataAbility' ); @@ -212,7 +222,9 @@ getType(uri: string): Promise\ **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; + let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 'dataability:///com.example.DataAbility' ); @@ -240,7 +252,9 @@ getFileTypes(uri: string, mimeTypeFilter: string, callback: AsyncCallback> **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; + let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 'dataability:///com.example.DataAbility' ); @@ -304,7 +320,9 @@ normalizeUri(uri: string, callback: AsyncCallback\): void **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; + let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 'dataability:///com.example.DataAbility' ); @@ -340,7 +358,9 @@ normalizeUri(uri: string): Promise\ **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; + let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 'dataability:///com.example.DataAbility' ); @@ -367,7 +387,9 @@ denormalizeUri(uri: string, callback: AsyncCallback\): void **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; + let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 'dataability:///com.example.DataAbility' ); @@ -403,7 +425,9 @@ denormalizeUri(uri: string): Promise\ **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; + let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 'dataability:///com.example.DataAbility' ); @@ -430,7 +454,9 @@ notifyChange(uri: string, callback: AsyncCallback\): void **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; + let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 'dataability:///com.example.DataAbility' ); @@ -466,7 +492,9 @@ notifyChange(uri: string): Promise\ **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; + let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 'dataability:///com.example.DataAbility' ); @@ -494,11 +522,14 @@ insert(uri: string, valuesBucket: rdb.ValuesBucket, callback: AsyncCallback\ **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; +import rdb from '@ohos.data.rdb'; + let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 'dataability:///com.example.DataAbility' ); -const valueBucket = { +const valueBucket: rdb.ValuesBucket = { 'name': 'rose1', 'age': 221, 'salary': 20.5, @@ -571,13 +605,16 @@ batchInsert(uri: string, valuesBuckets: Array\, callback: Asyn **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; +import rdb from '@ohos.data.rdb'; + let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 'dataability:///com.example.DataAbility' ); -let cars = new Array({'name': 'roe11', 'age': 21, 'salary': 20.5, 'blobType': 'u8',}, - {'name': 'roe12', 'age': 21, 'salary': 20.5, 'blobType': 'u8',}, - {'name': 'roe13', 'age': 21, 'salary': 20.5, 'blobType': 'u8',}); +let cars = new Array({'name': 'roe11', 'age': 21, 'salary': 20.5, 'blobType': 'u8',} as rdb.ValuesBucket, + {'name': 'roe12', 'age': 21, 'salary': 20.5, 'blobType': 'u8',} as rdb.ValuesBucket, + {'name': 'roe13', 'age': 21, 'salary': 20.5, 'blobType': 'u8',} as rdb.ValuesBucket); DAHelper.batchInsert('dataability:///com.example.DataAbility', cars, (error, data) => { if (error && error.code !== 0) { console.error('batchInsert fail, error: ${JSON.stringify(error)}'); @@ -611,13 +648,16 @@ batchInsert(uri: string, valuesBuckets: Array): Promise\ { console.info('batchInsert data: ${JSON.stringify(data)}'); }); @@ -642,8 +682,10 @@ delete(uri: string, predicates: dataAbility.DataAbilityPredicates, callback: Asy **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; import ohos_data_ability from '@ohos.data.dataAbility'; + let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 'dataability:///com.example.DataAbility' ); @@ -681,8 +723,10 @@ delete(uri: string, predicates?: dataAbility.DataAbilityPredicates): Promise\, predicates: dataAbility.DataAbilityP **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; import ohos_data_ability from '@ohos.data.dataAbility'; + let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 'dataability:///com.example.DataAbility' ); @@ -838,8 +890,10 @@ query(uri: string, columns?: Array\, predicates?: dataAbility.DataAbilit **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; import ohos_data_ability from '@ohos.data.dataAbility'; + let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 'dataability:///com.example.DataAbility' ); @@ -871,6 +925,7 @@ call(uri: string, method: string, arg: string, extras: PacMap, callback: AsyncCa **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( @@ -912,7 +967,9 @@ call(uri: string, method: string, arg: string, extras: PacMap): Promise\ **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; +import { BusinessError } from '@ohos.base'; let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 'dataability:///com.example.jsapidemo.UserDataAbility' @@ -920,7 +977,7 @@ let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbi dataAbilityHelper.call('dataability:///com.example.jsapidemo.UserDataAbility', 'method', 'arg', {'key1':'value1'}).then((data) => { console.info('call success, data: ${data}'); -}).catch((error) => { +}).catch((error: BusinessError) => { console.error('call failed, error: ${error}'); }); ``` @@ -944,10 +1001,11 @@ executeBatch(uri: string, operations: Array\, callback: As **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; // 根据DataAbilityOperation列表选择要对数据库做的操作 -let op=new Array(); +let op: Array = new Array(); let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 'dataability:///com.example.jsapidemo.UserDataAbility' ); @@ -984,16 +1042,18 @@ executeBatch(uri: string, operations: Array\): Promise\ = new Array(); let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 'dataability:///com.example.jsapidemo.UserDataAbility' ); dataAbilityHelper.executeBatch('dataability:///com.example.jsapidemo.UserDataAbility', op).then((data) => { console.info('executeBatch success, data: ${data}'); -}).catch((error) => { +}).catch((error: BusinessError) => { console.error('executeBatch failed, error: ${error}'); }); diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-ability-dataAbilityResult.md b/zh-cn/application-dev/reference/apis/js-apis-inner-ability-dataAbilityResult.md index a4f9f141f628816aa45dac99f0c0ed7b951a43ef..19266d9828db8822040fd8426081a6ebf5ad15a0 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-ability-dataAbilityResult.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-ability-dataAbilityResult.md @@ -25,47 +25,42 @@ import ability from '@ohos.ability.ability'; **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; +import rdb from '@ohos.data.rdb'; // 批量执行数据库操作 function executeBatchOperation() { let dataAbilityUri = ('dataability:///com.example.myapplication.TestDataAbility'); let DAHelper: ability.DataAbilityHelper; - try { - DAHelper = featureAbility.acquireDataAbilityHelper(dataAbilityUri); - if (DAHelper === null) { - console.error('DAHelper is null'); - } - } catch (err) { - console.error('acquireDataAbilityHelper fail, error: ${JSON.stringify(err)}'); - } + DAHelper = featureAbility.acquireDataAbilityHelper(dataAbilityUri); - let valueBucket = { + let valueBucket: rdb.ValuesBucket = { 'name': 'DataAbilityHelperTest', 'age': 24, 'salary': 2024.20, }; - let operations = [ - { - uri: dataAbilityUri, - type: featureAbility.DataAbilityOperationType.TYPE_INSERT, - valuesBucket: valueBucket, - predicates: null, - expectedCount: 1, - PredicatesBackReferences: {}, - interrupted: true, - }, - { - uri: dataAbilityUri, - type: featureAbility.DataAbilityOperationType.TYPE_INSERT, - valuesBucket: valueBucket, - predicates: null, - expectedCount: 1, - PredicatesBackReferences: {}, - interrupted: true, - } - ]; + let predicateBackReferences = new Map() + predicateBackReferences.set(1, 1) + let operations: Array = [ + { + uri: dataAbilityUri, + type: featureAbility.DataAbilityOperationType.TYPE_INSERT, + valuesBucket: valueBucket, + expectedCount: 1, + predicatesBackReferences: predicateBackReferences, + interrupted: true, + }, + { + uri: dataAbilityUri, + type: featureAbility.DataAbilityOperationType.TYPE_INSERT, + valuesBucket: valueBucket, + expectedCount: 1, + predicatesBackReferences: predicateBackReferences, + interrupted: true, + } + ]; try { DAHelper.executeBatch(dataAbilityUri, operations).then((data) => { for (let i = 0; i < data.length; i++) { @@ -73,7 +68,7 @@ function executeBatchOperation() { console.log('dataAbilityResult.uri: ${dataAbilityResult.uri}'); console.log('dataAbilityResult.count: ${dataAbilityResult.count}'); } - }).catch(err => { + }).catch((err: BusinessError) => { console.error('executeBatch error: ${JSON.stringify(err)}'); }); } catch (err) { diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-ability-startAbilityParameter.md b/zh-cn/application-dev/reference/apis/js-apis-inner-ability-startAbilityParameter.md index 3dcf2ddfbd08a06bfa89590c2ba6bf8f0774eab8..6cc763af69abed839d216117427357b834dc3638 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-ability-startAbilityParameter.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-ability-startAbilityParameter.md @@ -24,23 +24,23 @@ import ability from '@ohos.ability.ability'; **示例：** ```ts +import ability from '@ohos.ability.ability'; import featureAbility from '@ohos.ability.featureAbility'; +import Want from '@ohos.app.ability.Want'; -let Want = { +let want: Want = { bundleName: 'com.example.abilityStartSettingApp2', abilityName: 'com.example.abilityStartSettingApp.EntryAbility', }; -let abilityStartSetting ={ - [featureAbility.AbilityStartSetting.BOUNDS_KEY] : [100,200,300,400], - [featureAbility.AbilityStartSetting.WINDOW_MODE_KEY] : - featureAbility.AbilityWindowConfiguration.WINDOW_MODE_UNDEFINED, - [featureAbility.AbilityStartSetting.DISPLAY_ID_KEY] : 1, -}; - let startAbilityParameter: ability.StartAbilityParameter = { - want : Want, - abilityStartSetting : abilityStartSetting + want : want, + abilityStartSetting : { + abilityBounds : [100,200,300,400], + windowMode : + featureAbility.AbilityWindowConfiguration.WINDOW_MODE_UNDEFINED, + displayId : 1, + } }; try { diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-ability-want.md b/zh-cn/application-dev/reference/apis/js-apis-inner-ability-want.md index e317034f81cc54c30b84310e640b213dc01b7134..5dc216f50b9f978f450b5c079ef064b23bdf3364 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-ability-want.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-ability-want.md @@ -33,13 +33,16 @@ import Want from '@ohos.app.ability.Want'; - 基础用法(在UIAbility对象中调用，其中示例中的context为UIAbility的上下文对象) ```ts - let want = { - 'deviceId': '', // deviceId为空表示本设备 - 'bundleName': 'com.example.myapplication', - 'abilityName': 'EntryAbility', - 'moduleName': 'entry' // moduleName非必选 + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; + + let want: Want = { + deviceId: '', // deviceId为空表示本设备 + bundleName: 'com.example.myapplication', + abilityName: 'EntryAbility', + moduleName: 'entry' // moduleName非必选 }; - this.context.startAbility(want, (error) => { + this.context.startAbility(want, (error: BusinessError) => { // 显式拉起Ability，通过bundleName、abilityName和moduleName可以唯一确定一个Ability console.error('error.code = ${error.code}'); }); @@ -49,24 +52,25 @@ import Want from '@ohos.app.ability.Want'; ```ts import fs from '@ohos.file.fs'; - + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; // ... - let fd; + let fd: number = 0; try { fd = fs.openSync('/data/storage/el2/base/haps/pic.png').fd; } catch(e) { console.error('openSync fail: ${JSON.stringify(e)}'); } - let want = { - 'deviceId': '', // deviceId为空表示本设备 - 'bundleName': 'com.example.myapplication', - 'abilityName': 'EntryAbility', - 'moduleName': 'entry', // moduleName非必选 - 'parameters': { + let want: Want = { + deviceId: '', // deviceId为空表示本设备 + bundleName: 'com.example.myapplication', + abilityName: 'EntryAbility', + moduleName: 'entry', // moduleName非必选 + parameters: { 'keyFd':{'type':'FD', 'value':fd} } }; - this.context.startAbility(want, (error) => { + this.context.startAbility(want, (error: BusinessError) => { // 显式拉起Ability，通过bundleName、abilityName和moduleName可以唯一确定一个Ability console.error('error.code = ${error.code}'); }); diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-app-context.md b/zh-cn/application-dev/reference/apis/js-apis-inner-app-context.md index 8bbe8215c820540b61255d53fc3370714dc511d5..9bcbe68d66219e3a9ba560d599e8de0d5e70727f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-app-context.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-app-context.md @@ -174,8 +174,7 @@ verifyPermission(permission: string, options?: PermissionOptions): Promise\ { +context.verifyPermission('com.context.permission', {pid:1}).then((data) => { console.info('verifyPermission data: ${JSON.stringify(data)}'); }); ``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityDelegator.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityDelegator.md index ae9065fb26bfe209b7776a4c86a1892f6076fe88..d9c4bfb595f15df1246e888295ef20ac06861552 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityDelegator.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityDelegator.md @@ -47,19 +47,22 @@ addAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\): void **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import UIAbility from '@ohos.app.ability.UIAbility'; +import { BusinessError } from '@ohos.base'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; -function onAbilityCreateCallback(data) { +function onAbilityCreateCallback(data: UIAbility) { console.info('onAbilityCreateCallback, data: ${JSON.stringify(data)}'); } -let monitor = { +let monitor: AbilityDelegatorRegistry.AbilityMonitor = { abilityName: 'abilityname', onAbilityCreate: onAbilityCreateCallback }; - abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.addAbilityMonitor(monitor, (error : any) => { +abilityDelegator.addAbilityMonitor(monitor, (error: BusinessError) => { console.error('addAbilityMonitor fail, error: ${JSON.stringify(error)}'); }); ``` @@ -95,17 +98,19 @@ addAbilityMonitor(monitor: AbilityMonitor): Promise\; **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import UIAbility from '@ohos.app.ability.UIAbility'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; -function onAbilityCreateCallback(data) { +function onAbilityCreateCallback(data: UIAbility) { console.info('onAbilityCreateCallback'); } -let monitor = { +let monitor: AbilityDelegatorRegistry.AbilityMonitor = { abilityName: 'abilityname', onAbilityCreate: onAbilityCreateCallback }; - abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator.addAbilityMonitor(monitor).then(() => { console.info('addAbilityMonitor promise'); @@ -138,19 +143,23 @@ removeAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\): v **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import UIAbility from '@ohos.app.ability.UIAbility'; +import { BusinessError } from '@ohos.base'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; -function onAbilityCreateCallback(data) { +function onAbilityCreateCallback(data: UIAbility) { console.info('onAbilityCreateCallback'); } -let monitor = { +let monitor: AbilityDelegatorRegistry.AbilityMonitor = { abilityName: 'abilityname', onAbilityCreate: onAbilityCreateCallback }; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.removeAbilityMonitor(monitor, (error : any) => { +abilityDelegator.removeAbilityMonitor(monitor, (error: BusinessError) => { console.error('removeAbilityMonitor fail, error: ${JSON.stringify(error)}'); }); ``` @@ -186,13 +195,16 @@ removeAbilityMonitor(monitor: AbilityMonitor): Promise\; - 示例 ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import UIAbility from '@ohos.app.ability.UIAbility'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; -function onAbilityCreateCallback(data) { +function onAbilityCreateCallback(data: UIAbility) { console.info('onAbilityCreateCallback'); } -let monitor = { +let monitor: AbilityDelegatorRegistry.AbilityMonitor = { abilityName: 'abilityname', onAbilityCreate: onAbilityCreateCallback }; @@ -229,19 +241,23 @@ waitAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\) **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import UIAbility from '@ohos.app.ability.UIAbility'; +import { BusinessError } from '@ohos.base'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; -function onAbilityCreateCallback(data) { +function onAbilityCreateCallback(data: UIAbility) { console.info('onAbilityCreateCallback'); } -let monitor = { +let monitor: AbilityDelegatorRegistry.AbilityMonitor = { abilityName: 'abilityname', onAbilityCreate: onAbilityCreateCallback }; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.waitAbilityMonitor(monitor, (error : any, data : any) => { +abilityDelegator.waitAbilityMonitor(monitor, (error : BusinessError, data : UIAbility) => { if (error) { console.error('waitAbilityMonitor fail, error: ${JSON.stringify(error)}'); } else { @@ -277,20 +293,24 @@ waitAbilityMonitor(monitor: AbilityMonitor, timeout: number, callback: AsyncCall **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import UIAbility from '@ohos.app.ability.UIAbility'; +import { BusinessError } from '@ohos.base'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let timeout = 100; -function onAbilityCreateCallback(data) { +function onAbilityCreateCallback(data: UIAbility) { console.info('onAbilityCreateCallback'); } -let monitor = { +let monitor: AbilityDelegatorRegistry.AbilityMonitor = { abilityName: 'abilityname', onAbilityCreate: onAbilityCreateCallback }; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.waitAbilityMonitor(monitor, timeout, (error : any, data : any) => { +abilityDelegator.waitAbilityMonitor(monitor, timeout, (error : BusinessError, data : UIAbility) => { if (error && error.code !== 0) { console.error('waitAbilityMonitor fail, error: ${JSON.stringify(error)}'); } else { @@ -333,19 +353,22 @@ waitAbilityMonitor(monitor: AbilityMonitor, timeout?: number): Promise\ { +abilityDelegator.waitAbilityMonitor(monitor).then((data : BusinessError) => { console.info('waitAbilityMonitor promise'); }); ``` @@ -367,6 +390,8 @@ getAppContext(): Context; **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); @@ -396,11 +421,15 @@ getAbilityState(ability: UIAbility): number; **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import UIAbility from '@ohos.app.ability.UIAbility'; +import { BusinessError } from '@ohos.base'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; -let ability; +let ability: UIAbility; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.getCurrentTopAbility((err : any, data : any) => { +abilityDelegator.getCurrentTopAbility((err : BusinessError, data : UIAbility) => { console.info('getCurrentTopAbility callback'); ability = data; let state = abilityDelegator.getAbilityState(ability); @@ -433,11 +462,15 @@ getCurrentTopAbility(callback: AsyncCallback\): void; **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import UIAbility from '@ohos.app.ability.UIAbility'; +import { BusinessError } from '@ohos.base'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; -let ability; +let ability: UIAbility; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.getCurrentTopAbility((err : any, data : any) => { +abilityDelegator.getCurrentTopAbility((err : BusinessError, data : UIAbility) => { console.info('getCurrentTopAbility callback'); ability = data; }); @@ -468,11 +501,14 @@ getCurrentTopAbility(): Promise\; **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import UIAbility from '@ohos.app.ability.UIAbility'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; -let ability; +let ability: UIAbility; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.getCurrentTopAbility().then((data : any) => { +abilityDelegator.getCurrentTopAbility().then((data : UIAbility) => { console.info('getCurrentTopAbility promise'); ability = data; }); @@ -518,14 +554,18 @@ startAbility(want: Want, callback: AsyncCallback\): void; **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; -let want = { +let want: Want = { bundleName: 'bundleName', abilityName: 'abilityName' }; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.startAbility(want, (err : any, data : any) => { +abilityDelegator.startAbility(want, (err : BusinessError, data : void) => { console.info('startAbility callback'); }); ``` @@ -575,14 +615,18 @@ startAbility(want: Want): Promise\; **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import UIAbility from '@ohos.app.ability.UIAbility'; +import Want from '@ohos.app.ability.Want'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; -let want = { +let want: Want = { bundleName: 'bundleName', abilityName: 'abilityName' }; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.startAbility(want).then((data: any) => { +abilityDelegator.startAbility(want).then((data: void) => { console.info('startAbility promise'); }); ``` @@ -613,14 +657,18 @@ doAbilityForeground(ability: UIAbility, callback: AsyncCallback\): void; **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import UIAbility from '@ohos.app.ability.UIAbility'; +import { BusinessError } from '@ohos.base'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; -let ability; +let ability: UIAbility; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.getCurrentTopAbility((err : any, data : any) => { +abilityDelegator.getCurrentTopAbility((err : BusinessError, data : UIAbility) => { console.info('getCurrentTopAbility callback'); ability = data; - abilityDelegator.doAbilityForeground(ability, (err : any) => { + abilityDelegator.doAbilityForeground(ability, (err : BusinessError) => { console.info("doAbilityForeground callback"); }); }); @@ -657,11 +705,15 @@ doAbilityForeground(ability: UIAbility): Promise\; **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import UIAbility from '@ohos.app.ability.UIAbility'; +import { BusinessError } from '@ohos.base'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; -let ability; +let ability: UIAbility; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.getCurrentTopAbility((err : any, data : any) => { +abilityDelegator.getCurrentTopAbility((err : BusinessError, data : UIAbility) => { console.info('getCurrentTopAbility callback'); ability = data; abilityDelegator.doAbilityForeground(ability).then(() => { @@ -696,14 +748,18 @@ doAbilityBackground(ability: UIAbility, callback: AsyncCallback\): void; **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import UIAbility from '@ohos.app.ability.UIAbility'; +import { BusinessError } from '@ohos.base'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; -let ability; +let ability: UIAbility; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.getCurrentTopAbility((err : any, data : any) => { +abilityDelegator.getCurrentTopAbility((err : BusinessError, data : UIAbility) => { console.info('getCurrentTopAbility callback'); ability = data; - abilityDelegator.doAbilityBackground(ability, (err : any) => { + abilityDelegator.doAbilityBackground(ability, (err : BusinessError) => { console.info("doAbilityBackground callback"); }); }); @@ -740,11 +796,15 @@ doAbilityBackground(ability: UIAbility): Promise\; **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import UIAbility from '@ohos.app.ability.UIAbility'; +import { BusinessError } from '@ohos.base'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; -let ability; +let ability: UIAbility; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.getCurrentTopAbility((err : any, data : any) => { +abilityDelegator.getCurrentTopAbility((err : BusinessError, data : UIAbility) => { console.info('getCurrentTopAbility callback'); ability = data; abilityDelegator.doAbilityBackground(ability).then(() => { @@ -770,6 +830,8 @@ printSync(msg: string): void; **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let msg = 'msg'; @@ -795,11 +857,14 @@ print(msg: string, callback: AsyncCallback\): void; **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import { BusinessError } from '@ohos.base'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let msg = 'msg'; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.print(msg, (err : any) => { +abilityDelegator.print(msg, (err : BusinessError) => { console.info('print callback'); }); ``` @@ -827,6 +892,8 @@ print(msg: string): Promise\; **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let msg = 'msg'; @@ -856,11 +923,14 @@ executeShellCommand(cmd: string, callback: AsyncCallback\): void **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import { BusinessError } from '@ohos.base'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let cmd = 'cmd'; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.executeShellCommand(cmd, (err : any, data : any) => { +abilityDelegator.executeShellCommand(cmd, (err : BusinessError, data: AbilityDelegatorRegistry.ShellCmdResult) => { console.info('executeShellCommand callback'); }); ``` @@ -886,12 +956,15 @@ executeShellCommand(cmd: string, timeoutSecs: number, callback: AsyncCallback\ { +abilityDelegator.executeShellCommand(cmd, timeout, (err : BusinessError, data: AbilityDelegatorRegistry.ShellCmdResult) => { console.info('executeShellCommand callback'); }); ``` @@ -922,12 +995,14 @@ executeShellCommand(cmd: string, timeoutSecs?: number): Promise\ **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let cmd = 'cmd'; let timeout = 100; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.executeShellCommand(cmd, timeout).then((data : any) => { +abilityDelegator.executeShellCommand(cmd, timeout).then((data) => { console.info('executeShellCommand promise'); }); ``` @@ -959,11 +1034,14 @@ finishTest(msg: string, code: number, callback: AsyncCallback\): void; **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import { BusinessError } from '@ohos.base'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let msg = 'msg'; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.finishTest(msg, 0, (err : any) => { +abilityDelegator.finishTest(msg, 0, (err : BusinessError) => { console.info('finishTest callback'); }); ``` @@ -1000,6 +1078,8 @@ finishTest(msg: string, code: number): Promise\; **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let msg = 'msg'; @@ -1035,15 +1115,16 @@ addAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\ { +}, (err : BusinessError) => { console.info('addAbilityStageMonitor callback'); }); ``` @@ -1079,15 +1160,15 @@ addAbilityStageMonitor(monitor: AbilityStageMonitor): Promise\; **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; -let monitor = { +abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); +abilityDelegator.addAbilityStageMonitor({ moduleName: 'moduleName', srcEntrance: 'srcEntrance', -}; - -abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.addAbilityStageMonitor(monitor).then(() => { +}).then(() => { console.info('addAbilityStageMonitor promise'); }); ``` @@ -1118,15 +1199,16 @@ removeAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\ **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import { BusinessError } from '@ohos.base'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; -let monitor = { +abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); +abilityDelegator.removeAbilityStageMonitor({ moduleName: 'moduleName', srcEntrance: 'srcEntrance', -}; - -abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.removeAbilityStageMonitor(monitor, (err : any) => { +}, (err : BusinessError) => { console.info('removeAbilityStageMonitor callback'); }); ``` @@ -1162,15 +1244,15 @@ removeAbilityStageMonitor(monitor: AbilityStageMonitor): Promise\; **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; -let monitor = { +abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); +abilityDelegator.removeAbilityStageMonitor({ moduleName: 'moduleName', srcEntrance: 'srcEntrance', -}; - -abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.removeAbilityStageMonitor(monitor).then(() => { +}).then(() => { console.info('removeAbilityStageMonitor promise'); }); ``` @@ -1201,19 +1283,16 @@ waitAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\ { +}, (err : BusinessError, data : AbilityStage) => { console.info('waitAbilityStageMonitor callback'); }); ``` @@ -1250,19 +1329,16 @@ waitAbilityStageMonitor(monitor: AbilityStageMonitor, timeout?: number): Promise **示例：** ```ts -let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import AbilityStage from '@ohos.app.ability.AbilityStage'; -function onAbilityCreateCallback(data) { - console.info('onAbilityCreateCallback'); -} +let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; -let monitor = { +abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); +abilityDelegator.waitAbilityStageMonitor({ moduleName: 'moduleName', srcEntrance: 'srcEntrance', -}; - -abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.waitAbilityStageMonitor(monitor).then((data : any) => { +}).then((data : AbilityStage) => { console.info('waitAbilityStageMonitor promise'); }); ``` @@ -1294,20 +1370,18 @@ waitAbilityStageMonitor(monitor: AbilityStageMonitor, timeout: number, callback: **示例：** ```ts +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import AbilityStage from '@ohos.app.ability.AbilityStage'; +import { BusinessError } from '@ohos.base'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let timeout = 100; -function onAbilityCreateCallback(data) { - console.info('onAbilityCreateCallback'); -} - -let monitor = { +abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); +abilityDelegator.waitAbilityStageMonitor({ moduleName: 'moduleName', srcEntrance: 'srcEntrance', -}; - -abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.waitAbilityStageMonitor(monitor, timeout, (err : any, data : any) => { +}, timeout, (err : BusinessError, data : AbilityStage) => { console.info('waitAbilityStageMonitor callback'); }); ``` \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityMonitor.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityMonitor.md index 8a01c8c67322838d684a03677fa54d9f5288adb5..604d15c1a457b4242e9c8cdcf5648aac25312065 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityMonitor.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityMonitor.md @@ -38,19 +38,21 @@ Ability监听器 ```ts import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import UIAbility from '@ohos.app.ability.UIAbility'; +import { BusinessError } from '@ohos.base'; -function onAbilityCreateCallback(data) { +function onAbilityCreateCallback(data: UIAbility) { console.info('onAbilityCreateCallback, data: ${JSON.stringify(data)}'); } -let monitor = { +let monitor: AbilityDelegatorRegistry.AbilityMonitor = { abilityName: 'abilityname', moduleName: "moduleName", onAbilityCreate: onAbilityCreateCallback -}; +} let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.addAbilityMonitor(monitor, (error : any) => { +abilityDelegator.addAbilityMonitor(monitor, (error : BusinessError) => { if (error) { console.error('addAbilityMonitor fail, error: ${JSON.stringify(error)}'); } diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityStageMonitor.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityStageMonitor.md index 4ba721cc2e27ccb0bc6acd6392e16fc7eadd819b..fc9a122b52465751e8bafced74b19baf10ac6302 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityStageMonitor.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityStageMonitor.md @@ -19,13 +19,11 @@ ```ts import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; -let monitor = { +let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); +abilityDelegator.waitAbilityStageMonitor({ moduleName: 'feature_as1', srcEntrance: './ets/Application/MyAbilityStage.ts', -}; - -let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.waitAbilityStageMonitor(monitor, (error, data) => { +}, (error, data) => { if (error) { console.error('waitAbilityStageMonitor fail, error: ${JSON.stringify(error)}'); } else { diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-applicationContext.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-applicationContext.md index aef767e99bd639816a8c132cc435a7c3428f5c66..f9dec3718f7515a7e91fc44188a51090b1931a4e 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-applicationContext.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-applicationContext.md @@ -18,6 +18,8 @@ import common from '@ohos.app.ability.common'; 在使用ApplicationContext的功能前，需要通过context的实例获取。 ```ts +import common from '@ohos.app.ability.common'; + let applicationContext: common.ApplicationContext = this.context.getApplicationContext(); ``` @@ -46,13 +48,14 @@ on(type: 'abilityLifecycle', callback: AbilityLifecycleCallback): **number**; ```ts import UIAbility from '@ohos.app.ability.UIAbility'; +import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback'; -let lifecycleId; +let lifecycleId: number; export default class EntryAbility extends UIAbility { onCreate() { console.log('MyAbility onCreate'); - let AbilityLifecycleCallback = { + let AbilityLifecycleCallback: AbilityLifecycleCallback = { onAbilityCreate(ability) { console.log('AbilityLifecycleCallback onAbilityCreate ability: ${ability}'); }, @@ -115,7 +118,7 @@ off(type: 'abilityLifecycle', callbackId: **number**, callback: AsyncCallback<* ```ts import UIAbility from '@ohos.app.ability.UIAbility'; -let lifecycleId; +let lifecycleId: number; export default class EntryAbility extends UIAbility { onDestroy() { @@ -152,7 +155,7 @@ off(type: 'abilityLifecycle', callbackId: number): Promise\; ```ts import Ability from '@ohos.app.ability.UIAbility'; -let lifecycleId; +let lifecycleId: number; export default class MyAbility extends Ability { onDestroy() { @@ -188,26 +191,26 @@ on(type: 'environment', callback: EnvironmentCallback): **number**; ```ts import UIAbility from '@ohos.app.ability.UIAbility'; +import EnvironmentCallback from '@ohos.app.ability.EnvironmentCallback'; -let callbackId; +let callbackId: number; export default class EntryAbility extends UIAbility { onCreate() { console.log('MyAbility onCreate') - globalThis.applicationContext = this.context.getApplicationContext(); - let environmentCallback = { + let environmentCallback: EnvironmentCallback = { onConfigurationUpdated(config){ - console.log('onConfigurationUpdated config: ${JSON.stringify(config)}'); + console.log(`onConfigurationUpdated config: ${JSON.stringify(config)}`); }, onMemoryLevel(level){ console.log('onMemoryLevel level: ${level}'); } }; // 1.获取applicationContext - let applicationContext = globalThis.applicationContext; + let applicationContext = this.context.getApplicationContext(); // 2.通过applicationContext注册监听系统环境变化 callbackId = applicationContext.on('environment', environmentCallback); - console.log('registerEnvironmentCallback callbackId: ${callbackId}'); + console.log(`registerEnvironmentCallback callbackId: ${callbackId}`); } } ``` @@ -233,7 +236,7 @@ off(type: 'environment', callbackId: **number**, callback: AsyncCallback<**void ```ts import UIAbility from '@ohos.app.ability.UIAbility'; -let callbackId; +let callbackId: number; export default class EntryAbility extends UIAbility { onDestroy() { @@ -269,7 +272,7 @@ off(type: 'environment', callbackId: **number**, callback: AsyncCallback<**void ```ts import Ability from '@ohos.app.ability.UIAbility'; -let callbackId; +let callbackId: number; export default class MyAbility extends Ability { onDestroy() { @@ -298,11 +301,12 @@ on(type: 'applicationStateChange', callback: ApplicationStateChangeCallback): ** ```ts import UIAbility from '@ohos.app.ability.UIAbility'; +import ApplicationStateChangeCallback from '@ohos.app.ability.ApplicationStateChangeCallback'; export default class MyAbility extends UIAbility { onCreate() { console.log('MyAbility onCreate'); - globalThis.applicationStateChangeCallback = { + let applicationStateChangeCallback: ApplicationStateChangeCallback = { onApplicationForeground() { console.info('applicationStateChangeCallback onApplicationForeground'); }, @@ -311,11 +315,10 @@ export default class MyAbility extends UIAbility { } } - globalThis.applicationContext = this.context.getApplicationContext(); // 1.获取applicationContext - let applicationContext = globalThis.applicationContext; + let applicationContext = this.context.getApplicationContext(); // 2.通过applicationContext注册应用前后台状态监听 - applicationContext.on('applicationStateChange', globalThis.ApplicationStateChangeCallback); + applicationContext.on('applicationStateChange', applicationStateChangeCallback); console.log('Resgiter applicationStateChangeCallback'); } } @@ -375,11 +378,19 @@ getRunningProcessInformation(): Promise\>; **示例：** ```ts -applicationContext.getRunningProcessInformation().then((data) => { - console.log('The process running information is: ${JSON.stringify(data)}'); -}).catch((error) => { - console.error('error: ${JSON.stringify(error)}'); -}); +import UIAbility from '@ohos.app.ability.UIAbility'; +import { BusinessError } from '@ohos.base'; + +export default class MyAbility extends UIAbility { + onForeground() { + let applicationContext = this.context.getApplicationContext(); + applicationContext.getRunningProcessInformation().then((data) => { + console.log('The process running information is: ${JSON.stringify(data)}'); + }).catch((error: BusinessError) => { + console.error('error: ${JSON.stringify(error)}'); + }); + } +} ``` ## ApplicationContext.getRunningProcessInformation9+ @@ -408,13 +419,20 @@ getRunningProcessInformation(callback: AsyncCallback\ **示例：** ```ts -applicationContext.getRunningProcessInformation((err, data) => { - if (err) { - console.error('getRunningProcessInformation faile, err: ${JSON.stringify(err)}'); - } else { - console.log('The process running information is: ${JSON.stringify(data)}'); +import UIAbility from '@ohos.app.ability.UIAbility'; + +export default class MyAbility extends UIAbility { + onForeground() { + let applicationContext = this.context.getApplicationContext(); + applicationContext.getRunningProcessInformation((err, data) => { + if (err) { + console.error('getRunningProcessInformation faile, err: ${JSON.stringify(err)}'); + } else { + console.log('The process running information is: ${JSON.stringify(data)}'); + } + }) } -}) +} ``` ## ApplicationContext.killAllProcesses9+ @@ -442,7 +460,14 @@ killAllProcesses(): Promise\; **示例：** ```ts -applicationContext.killAllProcesses(); +import UIAbility from '@ohos.app.ability.UIAbility'; + +export default class MyAbility extends UIAbility { + onBackground() { + let applicationContext = this.context.getApplicationContext(); + applicationContext.killAllProcesses(); + } +} ``` ## ApplicationContext.killAllProcesses9+ @@ -470,9 +495,16 @@ killAllProcesses(callback: AsyncCallback\); **示例：** ```ts -applicationContext.killAllProcesses(error => { - if (error) { - console.error('killAllProcesses fail, error: ${JSON.stringify(error)}'); +import UIAbility from '@ohos.app.ability.UIAbility'; + +export default class MyAbility extends UIAbility { + onBackground() { + let applicationContext = this.context.getApplicationContext(); + applicationContext.killAllProcesses(error => { + if (error) { + console.error('killAllProcesses fail, error: ${JSON.stringify(error)}'); + } + }); } -}); +} ``` \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-applicationStateObserver.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-applicationStateObserver.md index 24d7470fd3a600322d98a00138e6443143f4eec7..f1a30c77b0d0477cb168a75a55c7fe17474b353c 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-applicationStateObserver.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-applicationStateObserver.md @@ -28,7 +28,9 @@ import appManager from '@ohos.app.ability.appManager'; **示例：** ```ts -let applicationStateObserver = { +import appManager from '@ohos.app.ability.appManager'; + +let applicationStateObserver: appManager.ApplicationStateObserver = { onForegroundApplicationChanged(appStateData) { console.log('onForegroundApplicationChanged appStateData: ${JSON.stringify(appStateData)}'); }, diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-baseContext.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-baseContext.md index 00819c66f1af6650a0cc3546d7209017c17d5e81..5c2e85ccfbbbca4ad0149082296e671a5c97e1e5 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-baseContext.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-baseContext.md @@ -26,9 +26,11 @@ import common from '@ohos.app.ability.common'; ```ts import UIAbility from '@ohos.app.ability.UIAbility'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; +import Want from '@ohos.app.ability.Want'; class EntryAbility extends UIAbility { - onCreate(want, launchParam) { + onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { // EntryAbility onCreate, isStageMode: true console.log('EntryAbility onCreate, isStageMode: ${this.context.stageMode}'); } diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-context.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-context.md index 0d3e90f4841580000893068bd70c36be387428c7..590fdbd9319f47f58b149086951badaeaa9e4ae4 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-context.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-context.md @@ -58,6 +58,8 @@ createBundleContext(bundleName: string): Context; **示例：** ```ts +import common from '@ohos.app.ability.common'; + let bundleContext: common.Context; try { bundleContext = this.context.createBundleContext('com.example.test'); @@ -89,6 +91,8 @@ createModuleContext(moduleName: string): Context; **示例：** ```ts +import common from '@ohos.app.ability.common'; + let moduleContext: common.Context; try { moduleContext = this.context.createModuleContext('entry'); @@ -123,6 +127,8 @@ createModuleContext(bundleName: string, moduleName: string): Context; **示例：** ```ts +import common from '@ohos.app.ability.common'; + let moduleContext: common.Context; try { moduleContext = this.context.createModuleContext('com.example.test', 'entry'); @@ -148,6 +154,8 @@ getApplicationContext(): ApplicationContext; **示例：** ```ts +import common from '@ohos.app.ability.common'; + let applicationContext: common.Context; try { applicationContext = this.context.getApplicationContext(); @@ -187,8 +195,10 @@ getGroupDir(dataGroupID: string): Promise\; **示例：** ```ts +import common from '@ohos.app.ability.common'; + let groupId = "1"; -let getGroupDirContext: common.Context; +let getGroupDirContext: common.Context = this.context; try { getGroupDirContext.getGroupDir(groupId).then(data => { console.log("getGroupDir result:" + data); @@ -224,7 +234,9 @@ getGroupDir(dataGroupID: string, callback: AsyncCallback\): void; **示例：** ```ts -let getGroupDirContext: common.Context; +import common from '@ohos.app.ability.common'; + +let getGroupDirContext: common.Context = this.context; getGroupDirContext.getGroupDir("1", (err, data) => { if (err) { diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-errorObserver.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-errorObserver.md index b92c7284d233fbd7dfa9f6859b8a07f6fe06b0a4..f24d7b78a0f9ad9e919e412693a870d28798388b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-errorObserver.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-errorObserver.md @@ -31,7 +31,7 @@ onUnhandledException(errMsg: string): void; ```ts import errorManager from '@ohos.app.ability.errorManager'; -let observer = { +let observer: errorManager.ErrorObserver = { onUnhandledException(errorMsg) { console.error('onUnhandledException, errorMsg: ', errorMsg); } @@ -63,7 +63,7 @@ onException?(errObject: Error): void; ```ts import errorManager from '@ohos.app.ability.errorManager'; -let observer = { +let observer: errorManager.ErrorObserver = { onUnhandledException(errorMsg) { console.error('onUnhandledException, errorMsg: ', errorMsg); }, diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-eventHub.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-eventHub.md index ff0cb5d552c8d24528867dc2310c3bbbb9a59b5d..dd9d0d10cc7792cb0f44c43da101decb06c2504a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-eventHub.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-eventHub.md @@ -145,7 +145,7 @@ export default class EntryAbility extends UIAbility { this.context.eventHub.emit('myEvent', 1, 2); } - eventFunc(argOne, argTwo) { + eventFunc(argOne: number, argTwo: number) { console.log(`eventFunc is called, ${argOne}, ${argTwo}`); } } diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-extensionContext.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-extensionContext.md index 45618ac37bc34995f48fdfb5f368ca30ed14f802..5ea5530b24c91df3f5e66d27e1a0bb3f239c4bb0 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-extensionContext.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-extensionContext.md @@ -39,24 +39,46 @@ ExtensionContext主要用于查询所属Extension的信息、Module的配置信 ```ts import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility'; import Want from '@ohos.app.ability.Want'; +import rpc from '@ohos.rpc'; + +export class GlobalContext { + private constructor() {} + private static instance: GlobalContext; + private _objects = new Map(); + + public static getContext(): GlobalContext { + if (!GlobalContext.instance) { + GlobalContext.instance = new GlobalContext(); + } + return GlobalContext.instance; + } + + getObject(value: string): Object | undefined { + return this._objects.get(value); + } + + setObject(key: string, objectClass: Object): void { + this._objects.set(key, objectClass); + } +} export default class TheServiceExtension extends ServiceExtension { - onCreate(want:Want) { + onCreate(want: Want) { console.log('ServiceAbility onCreate, want: ${want.abilityName}'); - // 通过globalThis传递ExtensionContext给entry - globalThis.ExtensionContext = this.context; + GlobalContext.getContext().setObject("ExtensionContext", this.context); } - onRequest(want, startId) { + onRequest(want: Want, startId: number) { console.log('ServiceAbility onRequest, want: ${want.abilityName}, startId: ${startId}'); } - onConnect(want) { + onConnect(want: Want) { console.log('ServiceAbility onConnect, want: ${want.abilityName}'); - return null; + let remoteObject = new rpc.RemoteObject("test"); + return remoteObject; } - onDisconnect(want) { + onDisconnect(want: Want) { console.log('ServiceAbility onDisconnect, want: ${want.abilityName}'); } @@ -69,11 +91,13 @@ export default class TheServiceExtension extends ServiceExtension { 在entry的MainAbility的onCreate回调内启动ServiceExtension ```ts import UIAbility from '@ohos.app.ability.UIAbility'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; +import Want from '@ohos.app.ability.Want'; export default class EntryAbility extends UIAbility { - onCreate(want, launchParam) { + onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { console.log('[Demo] EntryAbility onCreate'); - let wantExt = { + let wantExt: Want = { deviceId: '', bundleName: 'com.example.TheServiceExtension', abilityName: 'TheServiceExtension', @@ -85,19 +109,20 @@ export default class EntryAbility extends UIAbility { 在entry内新建一个ServiceModule.ts，专用于执行业务逻辑 ```ts +import { GlobalContext } from '../TheServiceExtension' + export default class ServiceModel { - moduleName: string; + moduleName: string = ''; constructor() {} executeTask() { - if (globalThis.ExtensionContext === undefined) { + if (GlobalContext.getContext().getObject('ExtensionContext') === undefined) { console.log('ERROR, ServiceExtension does not exist'); return; } - let moduleInfo = globalThis.ExtensionContext.currentHapModuleInfo; - this.moduleName = moduleInfo.name; + this.moduleName = GlobalContext.getContext().getObject('ExtensionContext').currentHapModuleInfo.name; // 根据moduleName执行不同的业务逻辑，实现对不同性能设备的区分 switch (this.moduleName) { case 'highPerformance': diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-missionCallbacks.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-missionCallbacks.md index e6c77be6f50ab82f4c52bf02617d3ee53e8546c6..1419e318a7bf7e39b3012a132c96dceba9d504ef 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-missionCallbacks.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-missionCallbacks.md @@ -18,21 +18,21 @@ ```ts import distributedMissionManager from '@ohos.distributedMissionManager'; -let missionDeviceInfo = { - deviceId: '123456' -}; -let missionCallback = { - notifyMissionsChanged: function (deviceId) { - console.log('notifyMissionsChanged deviceId: ${JSON.stringify(deviceId)}'); +distributedMissionManager.registerMissionListener( + { + deviceId: '123456' }, - notifySnapshot: function (deviceId, mission) { - console.log('notifySnapshot deviceId: ${JSON.stringify(deviceId)}'); - console.log('notifySnapshot mission: ${JSON.stringify(mission)}'); - }, - notifyNetDisconnect: function (deviceId, state) { - console.log('notifyNetDisconnect deviceId: ${JSON.stringify(deviceId)}'); - console.log('notifyNetDisconnect state: ${JSON.stringify(state)}'); - } -}; -distributedMissionManager.registerMissionListener(missionDeviceInfo, missionCallback); + { + notifyMissionsChanged: (deviceId) => { + console.log('notifyMissionsChanged deviceId: ${JSON.stringify(deviceId)}'); + }, + notifySnapshot: (deviceId, mission) => { + console.log('notifySnapshot deviceId: ${JSON.stringify(deviceId)}'); + console.log('notifySnapshot mission: ${JSON.stringify(mission)}'); + }, + notifyNetDisconnect: (deviceId, state) => { + console.log('notifyNetDisconnect deviceId: ${JSON.stringify(deviceId)}'); + console.log('notifyNetDisconnect state: ${JSON.stringify(state)}'); + } + }); ``` \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-missionDeviceInfo.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-missionDeviceInfo.md index 20b15a9fb4ab32790c79d029c8fba202bf5492da..e3fddced9b053dea010a23d5c044035b13d22f46 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-missionDeviceInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-missionDeviceInfo.md @@ -12,21 +12,21 @@ ```ts import distributedMissionManager from '@ohos.distributedMissionManager'; -let missionDeviceInfo = { - deviceId: '123456' -}; -let missionCallback = { - notifyMissionsChanged: function (deviceId) { - console.log('notifyMissionsChanged deviceId: ${JSON.stringify(deviceId)}'); +distributedMissionManager.registerMissionListener( + { + deviceId: '123456' }, - notifySnapshot: function (mission, deviceId) { - console.log('notifySnapshot mission: ${JSON.stringify(mission)}'); - console.log('notifySnapshot deviceId: ${JSON.stringify(deviceId)}'); - }, - notifyNetDisconnect: function (mission, state) { - console.log('notifyNetDisconnect mission: ${JSON.stringify(mission)}'); - console.log('notifyNetDisconnect state: ${JSON.stringify(state)}'); - } -}; -distributedMissionManager.registerMissionListener(missionDeviceInfo, missionCallback); + { + notifyMissionsChanged: (deviceId) => { + console.log('notifyMissionsChanged deviceId: ${JSON.stringify(deviceId)}'); + }, + notifySnapshot: (mission, deviceId) => { + console.log('notifySnapshot mission: ${JSON.stringify(mission)}'); + console.log('notifySnapshot deviceId: ${JSON.stringify(deviceId)}'); + }, + notifyNetDisconnect: (mission, state) => { + console.log('notifyNetDisconnect mission: ${JSON.stringify(mission)}'); + console.log('notifyNetDisconnect state: ${JSON.stringify(state)}'); + } + }); ``` \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-missionListener.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-missionListener.md index 05060ef4fd317efa7f623683e57db35bc77fb8a2..9977d9f22b30bb3c6c701aa6cb86f149893a102e 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-missionListener.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-missionListener.md @@ -32,27 +32,27 @@ import missionManager from '@ohos.app.ability.missionManager'; ```ts import missionManager from '@ohos.app.ability.missionManager'; -let listener = { - onMissionCreated: function (mission) { +let listener: missionManager.MissionListener = { + onMissionCreated: (mission) => { console.log('onMissionCreated mission: ${JSON.stringify(mission)}'); }, - onMissionDestroyed: function (mission) { + onMissionDestroyed: (mission) => { console.log('onMissionDestroyed mission: ${JSON.stringify(mission)}'); }, - onMissionSnapshotChanged: function (mission) { + onMissionSnapshotChanged: (mission) => { console.log('onMissionSnapshotChanged mission: ${JSON.stringify(mission)}'); }, - onMissionMovedToFront: function (mission) { + onMissionMovedToFront: (mission) => { console.log('onMissionMovedToFront mission: ${JSON.stringify(mission)}'); }, - onMissionLabelUpdated: function (mission) { + onMissionLabelUpdated: (mission) => { console.log('onMissionLabelUpdated mission: ' + JSON.stringify(mission)); }, - onMissionIconUpdated: function (mission, icon) { + onMissionIconUpdated: (mission, icon) => { console.log('onMissionIconUpdated mission: ' + JSON.stringify(mission)); console.log('onMissionIconUpdated icon: ' + JSON.stringify(icon)); }, - onMissionClosed: function (mission) { + onMissionClosed: (mission) => { console.log('onMissionClosed mission: ${JSON.stringify(mission)}'); } }; diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-missionParameter.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-missionParameter.md index ef8d400b1bd5e4095630e335c87bd0b7c800ea7a..a7c28a658835b924e979e6a9d422a0b3301fb468 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-missionParameter.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-missionParameter.md @@ -18,13 +18,13 @@ ```ts import distributedMissionManager from '@ohos.distributedMissionManager'; -let missionParameter = { - deviceId: '123456', - fixConflict: true, - tag: 123 -}; try { - distributedMissionManager.startSyncRemoteMissions(missionParameter, + distributedMissionManager.startSyncRemoteMissions( + { + deviceId: '123456', + fixConflict: true, + tag: 123 + }, (error, data) => { if (error && error.code !== 0) { console.error('startSyncRemoteMissions fail, error: ${JSON.stringify(error)}'); diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-processData.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-processData.md index 2c8b741d66009227d6bb08bbcd5193386ef61ca3..72401bb301faf4250a233b9240e51579105036ab 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-processData.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-processData.md @@ -31,7 +31,7 @@ import appManager from '@ohos.application.appManager'; ```ts import appManager from '@ohos.application.appManager'; -let applicationStateObserver = { +let observerCode = appManager.registerApplicationStateObserver({ onForegroundApplicationChanged(appStateData) { console.log('onForegroundApplicationChanged appStateData: ${JSON.stringify(appStateData)}'); }, @@ -51,6 +51,5 @@ let applicationStateObserver = { console.log('onProcessStateChanged processData.isContinuousTask : ${JSON.stringify(processData.isContinuousTask)}'); console.log('onProcessStateChanged processData.isKeepAlive : ${JSON.stringify(processData.isKeepAlive)}'); } -}; -let observerCode = appManager.registerApplicationStateObserver(applicationStateObserver); +}); ``` \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInfo.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInfo.md index 406abc4babfa5a369ed745f26d50272f83536f75..4ccce37beb3b2cb368bb2abdf8abf3c39d75511f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInfo.md @@ -9,7 +9,7 @@ ## 导入模块 ```ts -import appManager from '@ohos.app.ability.appManager'; +import appManager from '@ohos.application.appManager'; ``` ## 属性 @@ -29,11 +29,12 @@ import appManager from '@ohos.app.ability.appManager'; **示例：** ```ts -import appManager from '@ohos.app.ability.appManager'; +import appManager from '@ohos.application.appManager'; +import { BusinessError } from '@ohos.base'; appManager.getProcessRunningInfos().then((data) => { console.log('success: ${JSON.stringify(data)}'); -}).catch((error) => { +}).catch((error: BusinessError) => { console.error('failed: ${JSON.stringify(error)}'); }); ``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-serviceExtensionContext.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-serviceExtensionContext.md index d821774d1bd3c1dfdc537246c70ff6ea8c98695e..9f6f1b3d33dcce65e8f809f5325358e0d731242b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-serviceExtensionContext.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-serviceExtensionContext.md @@ -21,12 +21,12 @@ import common from '@ohos.app.ability.common'; ```ts import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility'; + import rpc from '@ohos.rpc'; - let context; - let commRemote; // 断开连接时需要释放 + let commRemote: rpc.IRemoteObject; // 断开连接时需要释放 class EntryAbility extends ServiceExtensionAbility { onCreate() { - context = this.context; // 获取ServiceExtensionContext + let context = this.context; // 获取ServiceExtensionContext } } ``` @@ -73,13 +73,16 @@ startAbility(want: Want, callback: AsyncCallback<void>): void; **示例：** ```ts - let want = { + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; + + let want: Want = { bundleName: 'com.example.myapp', abilityName: 'MyAbility' }; try { - this.context.startAbility(want, (error) => { + this.context.startAbility(want, (error: BusinessError) => { if (error.code) { // 处理业务逻辑错误 console.error('startAbility failed, error.code: ${error.code}, error.message: ${error.message}'); @@ -142,21 +145,25 @@ startAbility(want: Want, options?: StartOptions): Promise\; **示例：** ```ts - let want = { + import Want from '@ohos.app.ability.Want'; + import StartOptions from '@ohos.app.ability.StartOptions'; + import { BusinessError } from '@ohos.base'; + + let want: Want = { bundleName: 'com.example.myapp', abilityName: 'MyAbility' }; - let options = { + let options: StartOptions = { windowMode: 0, }; try { this.context.startAbility(want, options) - .then((data) => { + .then((data: void) => { // 执行正常业务 console.log('startAbility succeed'); }) - .catch((error) => { + .catch((error: BusinessError) => { // 处理业务逻辑错误 console.error('startAbility failed, error.code: ${error.code}, error.message: ${error.message}'); }); @@ -209,17 +216,21 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void& **示例：** ```ts - let want = { + import Want from '@ohos.app.ability.Want'; + import StartOptions from '@ohos.app.ability.StartOptions'; + import { BusinessError } from '@ohos.base'; + + let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; - let options = { + let options: StartOptions = { windowMode: 0 }; try { - this.context.startAbility(want, options, (error) => { + this.context.startAbility(want, options, (error: BusinessError) => { if (error.code) { // 处理业务逻辑错误 console.error('startAbility failed, error.code: ${error.code}, error.message: ${error.message}'); @@ -284,7 +295,10 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< **示例：** ```ts - let want = { + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; + + let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' @@ -292,7 +306,7 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< let accountId = 100; try { - this.context.startAbilityWithAccount(want, accountId, (error) => { + this.context.startAbilityWithAccount(want, accountId, (error: BusinessError) => { if (error.code) { // 处理业务逻辑错误 console.error('startAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}'); @@ -358,18 +372,22 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca **示例：** ```ts - let want = { + import Want from '@ohos.app.ability.Want'; + import StartOptions from '@ohos.app.ability.StartOptions'; + import { BusinessError } from '@ohos.base'; + + let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; let accountId = 100; - let options = { + let options: StartOptions = { windowMode: 0 }; try { - this.context.startAbilityWithAccount(want, accountId, options, (error) => { + this.context.startAbilityWithAccount(want, accountId, options, (error: BusinessError) => { if (error.code) { // 处理业务逻辑错误 console.error('startAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}'); @@ -441,23 +459,27 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): **示例：** ```ts - let want = { + import Want from '@ohos.app.ability.Want'; + import StartOptions from '@ohos.app.ability.StartOptions'; + import { BusinessError } from '@ohos.base'; + + let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; let accountId = 100; - let options = { + let options: StartOptions = { windowMode: 0 }; try { this.context.startAbilityWithAccount(want, accountId, options) - .then((data) => { + .then((data: void) => { // 执行正常业务 console.log('startAbilityWithAccount succeed'); }) - .catch((error) => { + .catch((error: BusinessError) => { // 处理业务逻辑错误 console.error('startAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}'); }); @@ -505,14 +527,17 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\): void; **示例：** ```ts - let want = { + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; + + let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; try { - this.context.startServiceExtensionAbility(want, (error) => { + this.context.startServiceExtensionAbility(want, (error: BusinessError) => { if (error.code) { // 处理业务逻辑错误 console.error('startServiceExtensionAbility failed, error.code: ${error.code}, error.message: ${error.message}'); @@ -570,7 +595,10 @@ startServiceExtensionAbility(want: Want): Promise\; **示例：** ```ts - let want = { + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; + + let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' @@ -578,11 +606,11 @@ startServiceExtensionAbility(want: Want): Promise\; try { this.context.startServiceExtensionAbility(want) - .then((data) => { + .then((data: void) => { // 执行正常业务 console.log('startServiceExtensionAbility succeed'); }) - .catch((error) => { + .catch((error: BusinessError) => { // 处理业务逻辑错误 console.error('startServiceExtensionAbility failed, error.code: ${error.code}, error.message: ${error.message}'); }); @@ -638,7 +666,10 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: **示例：** ```ts - let want = { + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; + + let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' @@ -646,7 +677,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: let accountId = 100; try { - this.context.startServiceExtensionAbilityWithAccount(want, accountId, (error) => { + this.context.startServiceExtensionAbilityWithAccount(want, accountId, (error: BusinessError) => { if (error.code) { // 处理业务逻辑错误 console.error('startServiceExtensionAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}'); @@ -711,7 +742,10 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ **示例：** ```ts - let want = { + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; + + let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' @@ -720,11 +754,11 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ try { this.context.startServiceExtensionAbilityWithAccount(want, accountId) - .then((data) => { + .then((data: void) => { // 执行正常业务 console.log('startServiceExtensionAbilityWithAccount succeed'); }) - .catch((error) => { + .catch((error: BusinessError) => { // 处理业务逻辑错误 console.error('startServiceExtensionAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}'); }); @@ -785,7 +819,7 @@ import extension from '@ohos.app.ability.ServiceExtensionAbility'; import Want from '@ohos.app.ability.Want'; export default class EntryAbility extends extension { - onCreate(want, launchParam) { + onCreate(want: Want) { // want包含启动该应用的Caller信息 let localWant: Want = want; localWant.bundleName = 'com.example.demo'; @@ -853,9 +887,10 @@ startAbilityAsCaller(want: Want, options: StartOptions, callback: AsyncCallback\ ```ts import extension from '@ohos.app.ability.ServiceExtensionAbility'; import Want from '@ohos.app.ability.Want'; +import StartOptions from '@ohos.app.ability.StartOptions'; export default class EntryAbility extends extension { - onCreate(want, launchParam) { + onCreate(want: Want) { // want包含启动该应用的Caller信息 let localWant: Want = want; localWant.bundleName = 'com.example.demo'; @@ -934,9 +969,11 @@ startAbilityAsCaller(want: Want, options?: StartOptions): Promise\; ```ts import extension from '@ohos.app.ability.ServiceExtensionAbility'; import Want from '@ohos.app.ability.Want'; +import StartOptions from '@ohos.app.ability.StartOptions'; +import { BusinessError } from '@ohos.base'; export default class EntryAbility extends extension { - onCreate(want, launchParam) { + onCreate(want: Want) { // want包含启动该应用的Caller信息 let localWant: Want = want; localWant.bundleName = 'com.example.demo'; @@ -952,7 +989,7 @@ export default class EntryAbility extends extension { .then(() => { console.log('startAbilityAsCaller success.'); }) - .catch((err) => { + .catch((err: BusinessError) => { console.error('startAbilityAsCaller failed, err:' + JSON.stringify(err)); }) } @@ -995,14 +1032,17 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\): void; **示例：** ```ts - let want = { + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; + + let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; try { - this.context.stopServiceExtensionAbility(want, (error) => { + this.context.stopServiceExtensionAbility(want, (error: BusinessError) => { if (error.code) { // 处理业务逻辑错误 console.error('stopServiceExtensionAbility failed, error.code: ${error.code}, error.message: ${error.message}'); @@ -1057,7 +1097,10 @@ stopServiceExtensionAbility(want: Want): Promise\; **示例：** ```ts - let want = { + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; + + let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' @@ -1065,11 +1108,11 @@ stopServiceExtensionAbility(want: Want): Promise\; try { this.context.stopServiceExtensionAbility(want) - .then((data) => { + .then(() => { // 执行正常业务 console.log('stopServiceExtensionAbility succeed'); }) - .catch((error) => { + .catch((error: BusinessError) => { // 处理业务逻辑错误 console.error('stopServiceExtensionAbility failed, error.code: ${error.code}, error.message: ${error.message}'); }); @@ -1121,7 +1164,10 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: **示例：** ```ts - let want = { + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; + + let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' @@ -1129,7 +1175,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: let accountId = 100; try { - this.context.stopServiceExtensionAbilityWithAccount(want, accountId, (error) => { + this.context.stopServiceExtensionAbilityWithAccount(want, accountId, (error: BusinessError) => { if (error.code) { // 处理业务逻辑错误 console.error('stopServiceExtensionAbilityWithAccount failed, error.code: ${error.code, error.message: ${error.message}'); @@ -1191,7 +1237,10 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< **示例：** ```ts - let want = { + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; + + let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' @@ -1200,11 +1249,11 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< try { this.context.stopServiceExtensionAbilityWithAccount(want, accountId) - .then((data) => { + .then(() => { // 执行正常业务 console.log('stopServiceExtensionAbilityWithAccount succeed'); }) - .catch((error) => { + .catch((error: BusinessError) => { // 处理业务逻辑错误 console.error('stopServiceExtensionAbilityWithAccount failed, error.code: ${error.code}, error.message: ${error.message}'); }); @@ -1246,7 +1295,9 @@ terminateSelf(callback: AsyncCallback<void>): void; **示例：** ```ts - this.context.terminateSelf((error) => { + import { BusinessError } from '@ohos.base'; + + this.context.terminateSelf((error: BusinessError) => { if (error.code) { // 处理业务逻辑错误 console.error('terminateSelf failed, error.code: ${error.code}, error.message: ${error.message}'); @@ -1289,10 +1340,12 @@ terminateSelf(): Promise<void>; **示例：** ```ts - this.context.terminateSelf().then((data) => { + import { BusinessError } from '@ohos.base'; + + this.context.terminateSelf().then(() => { // 执行正常业务 console.log('terminateSelf succeed'); - }).catch((error) => { + }).catch((error: BusinessError) => { // 处理业务逻辑错误 console.error('terminateSelf failed, error.code: ${error.code}, error.message: ${error.message}'); }); @@ -1341,20 +1394,24 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number; **示例：** ```ts - let want = { + import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility'; + import common from '@ohos.app.ability.common'; + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; + + let want: Want = { bundleName: 'com.example.myapp', abilityName: 'MyAbility' }; - let options = { - onConnect(elementName, remote) { + let options: common.ConnectOptions = { + onConnect(elementName, remote) { commRemote = remote; - console.log('----------- onConnect -----------'); + console.log('----------- onConnect -----------'); }, onDisconnect(elementName) { console.log('----------- onDisconnect -----------') }, onFailed(code) { console.error('----------- onFailed -----------') } }; - - let connection = null; + let connection: number; try { connection = this.context.connectServiceExtensionAbility(want, options); } catch (paramError) { @@ -1409,13 +1466,18 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options **示例：** ```ts - let want = { + import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility'; + import common from '@ohos.app.ability.common'; + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; + + let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; let accountId = 100; - let options = { + let options: common.ConnectOptions = { onConnect(elementName, remote) { commRemote = remote; console.log('----------- onConnect -----------'); @@ -1423,8 +1485,7 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options onDisconnect(elementName) { console.log('----------- onDisconnect -----------'); }, onFailed(code) { console.log('----------- onFailed -----------'); } }; - - let connection = null; + let connection: number; try { connection = this.context.connectServiceExtensionAbilityWithAccount(want, accountId, options); } catch (paramError) { @@ -1462,11 +1523,13 @@ disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback< **示例：** ```ts + import { BusinessError } from '@ohos.base'; + // connection为connectServiceExtensionAbility中的返回值 let connection = 1; try { - this.context.disconnectServiceExtensionAbility(connection, (error) => { + this.context.disconnectServiceExtensionAbility(connection, (error: BusinessError) => { commRemote = null; if (error.code) { // 处理业务逻辑错误 @@ -1517,17 +1580,19 @@ disconnectServiceExtensionAbility(connection: number): Promise<void>; **示例：** ```ts + import { BusinessError } from '@ohos.base'; + // connection为connectServiceExtensionAbility中的返回值 let connection = 1; try { this.context.disconnectServiceExtensionAbility(connection) - .then((data) => { + .then(() => { commRemote = null; // 执行正常业务 console.log('disconnectServiceExtensionAbility succeed'); }) - .catch((error) => { + .catch((error: BusinessError) => { commRemote = null; // 处理业务逻辑错误 console.error('disconnectServiceExtensionAbility failed, error.code: ${error.code}, error.message: ${error.message}'); @@ -1589,10 +1654,14 @@ startAbilityByCall(want: Want): Promise<Caller>; 后台启动： ```ts - let caller; + import { Caller } from '@ohos.app.ability.UIAbility'; + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; + + let caller: Caller; // 后台启动Ability，不配置parameters - let wantBackground = { + let wantBackground: Want = { bundleName: 'com.example.myservice', moduleName: 'entry', abilityName: 'EntryAbility', @@ -1601,11 +1670,11 @@ startAbilityByCall(want: Want): Promise<Caller>; try { this.context.startAbilityByCall(wantBackground) - .then((obj) => { + .then((obj: Caller) => { // 执行正常业务 caller = obj; console.log('startAbilityByCall succeed'); - }).catch((error) => { + }).catch((error: BusinessError) => { // 处理业务逻辑错误 console.error('startAbilityByCall failed, error.code: ${error.code}, error.message: ${error.message}'); }); @@ -1618,10 +1687,14 @@ startAbilityByCall(want: Want): Promise<Caller>; 前台启动： ```ts - let caller; + import { Caller } from '@ohos.app.ability.UIAbility'; + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; + + let caller: Caller; // 前台启动Ability，将parameters中的'ohos.aafwk.param.callAbilityToForeground'配置为true - let wantForeground = { + let wantForeground: Want = { bundleName: 'com.example.myservice', moduleName: 'entry', abilityName: 'EntryAbility', @@ -1633,11 +1706,11 @@ startAbilityByCall(want: Want): Promise<Caller>; try { this.context.startAbilityByCall(wantForeground) - .then((obj) => { + .then((obj: Caller) => { // 执行正常业务 caller = obj; console.log('startAbilityByCall succeed'); - }).catch((error) => { + }).catch((error: BusinessError) => { // 处理业务逻辑错误 console.error('startAbilityByCall failed, error.code: ${error.code}, error.message: ${error.message}'); }); @@ -1691,13 +1764,16 @@ startRecentAbility(want: Want, callback: AsyncCallback\): void; **示例：** ```ts -let want = { +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; try { - this.context.startRecentAbility(want, (err) => { + this.context.startRecentAbility(want, (err: BusinessError) => { if (err.code) { // 处理业务逻辑错误 console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`); @@ -1708,7 +1784,9 @@ try { }); } catch (err) { // 处理入参错误异常 - console.error(`startRecentAbility failed failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startRecentAbility failed, code is ${code}, message is ${message}`); } ``` ## ServiceExtensionContext.startRecentAbility @@ -1758,17 +1836,21 @@ startRecentAbility(want: Want, options: StartOptions, callback: AsyncCallback\ { + this.context.startRecentAbility(want, options, (err: BusinessError) => { if (err.code) { // 处理业务逻辑错误 console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`); @@ -1779,7 +1861,9 @@ try { }); } catch (err) { // 处理入参错误异常 - console.error(`startRecentAbility failed failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startRecentAbility failed, code is ${code}, message is ${message}`); } ``` ## ServiceExtensionContext.startRecentAbility @@ -1828,11 +1912,15 @@ startRecentAbility(want: Want, options?: StartOptions): Promise\; **示例：** ```ts -let want = { +import Want from '@ohos.app.ability.Want'; +import StartOptions from '@ohos.app.ability.StartOptions'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; -let options = { +let options: StartOptions = { windowMode: 0, }; @@ -1842,13 +1930,15 @@ try { // 执行正常业务 console.info('startRecentAbility succeed'); }) - .catch((err) => { + .catch((err: BusinessError) => { // 处理业务逻辑错误 console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`); }); } catch (err) { // 处理入参错误异常 - console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startRecentAbility failed, code is ${code}, message is ${message}`); } ``` @@ -1904,13 +1994,16 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise<Caller& **示例：** ```ts - let caller; + import { Caller } from '@ohos.app.ability.UIAbility'; + import Want from '@ohos.app.ability.Want'; + import StartOptions from '@ohos.app.ability.StartOptions'; + import { BusinessError } from '@ohos.base'; + let caller: Caller; // 系统账号的账号ID, -1表示当前激活用户 let accountId = -1; - // 指定启动的Ability - let want = { + let want: Want = { bundleName: 'com.acts.actscalleeabilityrely', moduleName: 'entry', abilityName: 'EntryAbility', @@ -1923,11 +2016,11 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise<Caller& try { this.context.startAbilityByCallWithAccount(want, accountId) - .then((obj) => { + .then((obj: Caller) => { // 执行正常业务 caller = obj; console.log('startAbilityByCallWithAccount succeed'); - }).catch((error) => { + }).catch((error: BusinessError) => { // 处理业务逻辑错误 console.error('startAbilityByCallWithAccount failed, error.code: ${error.code}, error.message: ${error.message}'); }); diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-shellCmdResult.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-shellCmdResult.md index 8d5da70ca93589878900fc34080b521ed21f1bf4..3b57554be3beebdd983591cc6779478055f4a28d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-shellCmdResult.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-shellCmdResult.md @@ -28,11 +28,13 @@ import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry **示例：** ```ts import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; +import { BusinessError } from '@ohos.base'; + let abilityDelegator: AbilityDelegatorRegistry.AbilityDelegator; let cmd = 'cmd'; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.executeShellCommand(cmd, (error: any, data: any) => { +abilityDelegator.executeShellCommand(cmd, (error: BusinessError, data) => { if (error) { console.error('executeShellCommand fail, error: ${JSON.stringify(error)}'); } else { diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-uiAbilityContext.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-uiAbilityContext.md index 5ee5bb06f7185547e2bc37d254845875941fa7c2..d38bf1a062e55c3d4a55afd693bae6109d54b98e 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-uiAbilityContext.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-uiAbilityContext.md @@ -73,13 +73,16 @@ startAbility(want: Want, callback: AsyncCallback<void>): void; **示例：** ```ts -let want = { +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; try { - this.context.startAbility(want, (err) => { + this.context.startAbility(want, (err: BusinessError) => { if (err.code) { // 处理业务逻辑错误 console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`); @@ -90,7 +93,9 @@ try { }); } catch (err) { // 处理入参错误异常 - console.error(`startAbility failed failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startAbility failed, code is ${code}, message is ${message}`); } ``` @@ -140,17 +145,21 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void& **示例：** ```ts -let want = { +import Want from '@ohos.app.ability.Want'; +import StartOptions from '@ohos.app.ability.StartOptions'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; -let options = { +let options: StartOptions = { windowMode: 0 }; try { - this.context.startAbility(want, options, (err) => { + this.context.startAbility(want, options, (err: BusinessError) => { if (err.code) { // 处理业务逻辑错误 console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`); @@ -161,7 +170,9 @@ try { }); } catch (err) { // 处理入参错误异常 - console.error(`startAbility failed failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startAbility failed, code is ${code}, message is ${message}`); } ``` @@ -216,11 +227,15 @@ startAbility(want: Want, options?: StartOptions): Promise<void>; **示例：** ```ts -let want = { +import Want from '@ohos.app.ability.Want'; +import StartOptions from '@ohos.app.ability.StartOptions'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; -let options = { +let options: StartOptions = { windowMode: 0, }; @@ -230,13 +245,15 @@ try { // 执行正常业务 console.info('startAbility succeed'); }) - .catch((err) => { + .catch((err: BusinessError) => { // 处理业务逻辑错误 console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`); }); } catch (err) { // 处理入参错误异常 - console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startAbility failed, code is ${code}, message is ${message}`); } ``` @@ -288,25 +305,32 @@ startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>): **示例：** ```ts -let want = { +import UIAbility from '@ohos.app.ability.UIAbility'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; +import common from '@ohos.app.ability.common'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; try { - this.context.startAbilityForResult(want, (err, result) => { + this.context.startAbilityForResult(want, (err: BusinessError, result: common.AbilityResult) => { if (err.code) { // 处理业务逻辑错误 console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`); return; - } // 执行正常业务 console.info('startAbilityForResult succeed'); }); } catch (err) { // 处理入参错误异常 - console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startAbilityForResult failed, code is ${code}, message is ${message}`); } ``` @@ -359,20 +383,27 @@ startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback **示例：** ```ts -let want = { +import UIAbility from '@ohos.app.ability.UIAbility'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; +import common from '@ohos.app.ability.common'; +import Want from '@ohos.app.ability.Want'; +import StartOptions from '@ohos.app.ability.StartOptions'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; -let options = { +let options: StartOptions = { windowMode: 0, }; try { - this.context.startAbilityForResult(want, options, (err, result) => { + this.context.startAbilityForResult(want, options, (err: BusinessError, result: common.AbilityResult) => { if (err.code) { // 处理业务逻辑错误 - console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`); + console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`); return; } // 执行正常业务 @@ -380,7 +411,9 @@ try { }); } catch (err) { // 处理入参错误异常 - console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startAbilityForResult failed, code is ${code}, message is ${message}`); } ``` @@ -440,27 +473,36 @@ startAbilityForResult(want: Want, options?: StartOptions): Promise<AbilityRes **示例：** ```ts -let want = { +import UIAbility from '@ohos.app.ability.UIAbility'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; +import common from '@ohos.app.ability.common'; +import Want from '@ohos.app.ability.Want'; +import StartOptions from '@ohos.app.ability.StartOptions'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; -let options = { +let options: StartOptions = { windowMode: 0, }; try { this.context.startAbilityForResult(want, options) - .then((result) => { + .then((result: common.AbilityResult) => { // 执行正常业务 console.info('startAbilityForResult succeed'); }) - .catch((err) => { + .catch((err: BusinessError) => { // 处理业务逻辑错误 console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`); }); } catch (err) { // 处理入参错误异常 - console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startAbilityForResult failed, code is ${code}, message is ${message}`); } ``` @@ -518,7 +560,13 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC **示例：** ```ts -let want = { +import UIAbility from '@ohos.app.ability.UIAbility'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; +import common from '@ohos.app.ability.common'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' @@ -526,7 +574,7 @@ let want = { let accountId = 100; try { - this.context.startAbilityForResultWithAccount(want, accountId, (err, result) => { + this.context.startAbilityForResultWithAccount(want, accountId, (err: BusinessError, result: common.AbilityResult) => { if (err.code) { // 处理业务逻辑错误 console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`); @@ -537,7 +585,9 @@ try { }); } catch (err) { // 处理入参错误异常 - console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startAbilityForResultWithAccount failed, code is ${code}, message is ${message}`); } ``` @@ -597,18 +647,22 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp **示例：** ```ts -let want = { +import Want from '@ohos.app.ability.Want'; +import StartOptions from '@ohos.app.ability.StartOptions'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; let accountId = 100; -let options = { +let options: StartOptions = { windowMode: 0 }; try { - this.context.startAbilityForResultWithAccount(want, accountId, options, (err) => { + this.context.startAbilityForResultWithAccount(want, accountId, options, (err: BusinessError) => { if (err.code) { // 处理业务逻辑错误 console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`); @@ -619,7 +673,9 @@ try { }); } catch (err) { // 处理入参错误异常 - console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startAbilityForResultWithAccount failed, code is ${code}, message is ${message}`); } ``` @@ -684,29 +740,38 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO **示例：** ```ts -let want = { +import UIAbility from '@ohos.app.ability.UIAbility'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; +import common from '@ohos.app.ability.common'; +import Want from '@ohos.app.ability.Want'; +import StartOptions from '@ohos.app.ability.StartOptions'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; let accountId = 100; -let options = { +let options: StartOptions = { windowMode: 0 }; try { this.context.startAbilityForResultWithAccount(want, accountId, options) - .then((result) => { + .then((result: common.AbilityResult) => { // 执行正常业务 console.info('startAbilityForResultWithAccount succeed'); }) - .catch((err) => { + .catch((err: BusinessError) => { // 处理业务逻辑错误 console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`); }); } catch (err) { // 处理入参错误异常 - console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startAbilityForResultWithAccount failed, code is ${code}, message is ${message}`); } ``` ## UIAbilityContext.startServiceExtensionAbility @@ -747,7 +812,10 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\): void; **示例：** ```ts -let want = { +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'ServiceExtensionAbility' @@ -759,13 +827,15 @@ try { // 执行正常业务 console.info('startServiceExtensionAbility succeed'); }) - .catch((err) => { + .catch((err: BusinessError) => { // 处理业务逻辑错误 console.error(`startServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); }); } catch (err) { // 处理入参错误异常 - console.error(`startServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startServiceExtensionAbility failed, code is ${code}, message is ${message}`); } ``` @@ -806,7 +876,10 @@ startServiceExtensionAbility(want: Want): Promise\; **示例：** ```ts -let want = { +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'ServiceExtensionAbility' @@ -818,13 +891,15 @@ try { // 执行正常业务 console.info('startServiceExtensionAbility succeed'); }) - .catch((err) => { + .catch((err: BusinessError) => { // 处理业务逻辑错误 console.error(`startServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); }); } catch (err) { // 处理入参错误异常 - console.error(`startServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startServiceExtensionAbility failed, code is ${code}, message is ${message}`); } ``` @@ -873,7 +948,10 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: **示例：** ```ts -let want = { +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'ServiceExtensionAbility' @@ -881,7 +959,7 @@ let want = { let accountId = 100; try { - this.context.startServiceExtensionAbilityWithAccount(want, accountId, (err) => { + this.context.startServiceExtensionAbilityWithAccount(want, accountId, (err: BusinessError) => { if (err.code) { // 处理业务逻辑错误 console.error(`startServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); @@ -892,7 +970,9 @@ try { }); } catch (err) { // 处理入参错误异常 - console.error(`startServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startServiceExtensionAbilityWithAccount failed, code is ${code}, message is ${message}`); } ``` @@ -940,7 +1020,10 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ **示例：** ```ts -let want = { +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'ServiceExtensionAbility' @@ -953,13 +1036,15 @@ try { // 执行正常业务 console.info('startServiceExtensionAbilityWithAccount succeed'); }) - .catch((err) => { + .catch((err: BusinessError) => { // 处理业务逻辑错误 console.error(`startServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); }); } catch (err) { // 处理入参错误异常 - console.error(`startServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startServiceExtensionAbilityWithAccount failed, code is ${code}, message is ${message}`); } ``` ## UIAbilityContext.stopServiceExtensionAbility @@ -999,14 +1084,17 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\): void; **示例：** ```ts -let want = { +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'ServiceExtensionAbility' }; try { - this.context.stopServiceExtensionAbility(want, (err) => { + this.context.stopServiceExtensionAbility(want, (err: BusinessError) => { if (err.code) { // 处理业务逻辑错误 console.error(`stopServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); @@ -1017,7 +1105,9 @@ try { }); } catch (err) { // 处理入参错误异常 - console.error(`stopServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`stopServiceExtensionAbility failed, code is ${code}, message is ${message}`); } ``` @@ -1055,7 +1145,10 @@ stopServiceExtensionAbility(want: Want): Promise\; **示例：** ```ts -let want = { +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'ServiceExtensionAbility' @@ -1067,13 +1160,15 @@ try { // 执行正常业务 console.info('stopServiceExtensionAbility succeed'); }) - .catch((err) => { + .catch((err: BusinessError) => { // 处理业务逻辑错误 console.error(`stopServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); }); } catch (err) { // 处理入参错误异常 - console.error(`stopServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`stopServiceExtensionAbility failed, code is ${code}, message is ${message}`); } ``` @@ -1119,7 +1214,10 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: **示例：** ```ts -let want = { +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'ServiceExtensionAbility' @@ -1127,7 +1225,7 @@ let want = { let accountId = 100; try { - this.context.stopServiceExtensionAbilityWithAccount(want, accountId, (err) => { + this.context.stopServiceExtensionAbilityWithAccount(want, accountId, (err: BusinessError) => { if (err.code) { // 处理业务逻辑错误 console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); @@ -1138,7 +1236,9 @@ try { }); } catch (err) { // 处理入参错误异常 - console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${code}, message is ${message}`); } ``` @@ -1183,7 +1283,10 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< **示例：** ```ts -let want = { +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'ServiceExtensionAbility' @@ -1196,13 +1299,15 @@ try { // 执行正常业务 console.info('stopServiceExtensionAbilityWithAccount succeed'); }) - .catch((err) => { + .catch((err: BusinessError) => { // 处理业务逻辑错误 console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); }); } catch (err) { // 处理入参错误异常 - console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${code}, message is ${message}`); } ``` @@ -1236,8 +1341,10 @@ terminateSelf(callback: AsyncCallback<void>): void; **示例：** ```ts + import { BusinessError } from '@ohos.base'; + try { - this.context.terminateSelf((err) => { + this.context.terminateSelf((err: BusinessError) => { if (err.code) { // 处理业务逻辑错误 console.error(`terminateSelf failed, code is ${err.code}, message is ${err.message}`); @@ -1248,7 +1355,9 @@ terminateSelf(callback: AsyncCallback<void>): void; }); } catch (err) { // 捕获同步的参数错误 - console.error(`terminateSelf failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`terminateSelf failed, code is ${code}, message is ${message}`); } ``` @@ -1283,19 +1392,23 @@ terminateSelf(): Promise<void>; **示例：** ```ts + import { BusinessError } from '@ohos.base'; + try { this.context.terminateSelf() .then(() => { // 执行正常业务 console.info('terminateSelf succeed'); }) - .catch((err) => { + .catch((err: BusinessError) => { // 处理业务逻辑错误 console.error(`terminateSelf failed, code is ${err.code}, message is ${err.message}`); }); } catch (err) { // 捕获同步的参数错误 - console.error(`terminateSelf failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`terminateSelf failed, code is ${code}, message is ${message}`); } ``` @@ -1331,19 +1444,24 @@ terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback<voi **示例：** ```ts -let want = { +import UIAbility from '@ohos.app.ability.UIAbility'; +import common from '@ohos.app.ability.common'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; let resultCode = 100; // 返回给接口调用方AbilityResult信息 -let abilityResult = { +let abilityResult: common.AbilityResult = { want, resultCode }; try { - this.context.terminateSelfWithResult(abilityResult, (err) => { + this.context.terminateSelfWithResult(abilityResult, (err: BusinessError) => { if (err.code) { // 处理业务逻辑错误 console.error(`terminateSelfWithResult failed, code is ${err.code}, message is ${err.message}`); @@ -1354,7 +1472,9 @@ try { }); } catch (err) { // 处理入参错误异常 - console.error(`terminateSelfWithResult failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`terminateSelfWithResult failed, code is ${code}, message is ${message}`); } ``` @@ -1395,13 +1515,18 @@ terminateSelfWithResult(parameter: AbilityResult): Promise<void>; **示例：** ```ts -let want = { +import UIAbility from '@ohos.app.ability.UIAbility'; +import common from '@ohos.app.ability.common'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; let resultCode = 100; // 返回给接口调用方AbilityResult信息 -let abilityResult = { +let abilityResult: common.AbilityResult = { want, resultCode }; @@ -1412,13 +1537,15 @@ try { // 执行正常业务 console.info('terminateSelfWithResult succeed'); }) - .catch((err) => { + .catch((err: BusinessError) => { // 处理业务逻辑错误 console.error(`terminateSelfWithResult failed, code is ${err.code}, message is ${err.message}`); }); } catch (err) { // 处理入参错误异常 - console.error(`terminateSelfWithResult failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`terminateSelfWithResult failed, code is ${code}, message is ${message}`); } ``` @@ -1463,13 +1590,19 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number; **示例：** ```ts -let want = { +import UIAbility from '@ohos.app.ability.UIAbility'; +import common from '@ohos.app.ability.common'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; +import rpc from '@ohos.rpc'; + +let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'ServiceExtensionAbility' }; -let commRemote; -let options = { +let commRemote: rpc.IRemoteObject; +let options: common.ConnectOptions = { onConnect(elementName, remote) { commRemote = remote; console.info('onConnect...') @@ -1481,13 +1614,14 @@ let options = { console.info('onFailed...') } }; - -let connection = null; +let connection: number; try { connection = this.context.connectServiceExtensionAbility(want, options); } catch (err) { // 处理入参错误异常 - console.error(`connectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`connectServiceExtensionAbility failed, code is ${code}, message is ${message}`); } ``` @@ -1542,14 +1676,20 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options **示例：** ```ts -let want = { +import UIAbility from '@ohos.app.ability.UIAbility'; +import common from '@ohos.app.ability.common'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; +import rpc from '@ohos.rpc'; + +let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'ServiceExtensionAbility' }; let accountId = 100; -let commRemote; -let options = { +let commRemote: rpc.IRemoteObject; +let options: common.ConnectOptions = { onConnect(elementName, remote) { commRemote = remote; console.info('onConnect...') @@ -1561,13 +1701,14 @@ let options = { console.info('onFailed...') } }; - -let connection = null; +let connection: number; try { connection = this.context.connectServiceExtensionAbilityWithAccount(want, accountId, options); } catch (err) { // 处理入参错误异常 - console.error(`connectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`connectServiceExtensionAbility failed, code is ${code}, message is ${message}`); } ``` @@ -1603,25 +1744,27 @@ disconnectServiceExtensionAbility(connection: number): Promise\; **示例：** ```ts +import { BusinessError } from '@ohos.base'; + // connection为connectServiceExtensionAbility中的返回值 let connection = 1; -let commRemote; +let commRemote: rpc.IRemoteObject | null; try { - this.context.disconnectServiceExtensionAbility(connection, (err) => { + this.context.disconnectServiceExtensionAbility(connection).then(() => { commRemote = null; - if (err.code) { - // 处理业务逻辑错误 - console.error(`disconnectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); - return; - } // 执行正常业务 console.info('disconnectServiceExtensionAbility succeed'); - }); + }).catch((err: BusinessError) => { + // 处理业务逻辑错误 + console.error(`disconnectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); + }) } catch (err) { commRemote = null; // 处理入参错误异常 - console.error(`disconnectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`disconnectServiceExtensionAbility failed, code is ${code}, message is ${message}`); } ``` @@ -1652,29 +1795,14 @@ disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback\ { - commRemote = null; - if (err.code) { - // 处理业务逻辑错误 - console.error(`disconnectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); - return; - } - // 执行正常业务 - console.info('disconnectServiceExtensionAbility succeed'); - }); -} catch (err) { - commRemote = null; - // 处理入参错误异常 - console.error(`disconnectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); -} +let commRemote: rpc.IRemoteObject | null; try { - this.context.disconnectServiceExtensionAbility(connection, (err) => { + this.context.disconnectServiceExtensionAbility(connection, (err: BusinessError) => { commRemote = null; if (err.code) { // 处理业务逻辑错误 @@ -1687,7 +1815,9 @@ try { } catch (err) { commRemote = null; // 处理入参错误异常 - console.error(`disconnectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`disconnectServiceExtensionAbility failed, code is ${code}, message is ${message}`); } ``` @@ -1741,10 +1871,14 @@ startAbilityByCall(want: Want): Promise<Caller>; 后台启动： ```ts -let caller; +import { Caller } from '@ohos.app.ability.UIAbility'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + +let caller: Caller; // 后台启动Ability，不配置parameters -let wantBackground = { +let wantBackground: Want = { bundleName: 'com.example.myapplication', moduleName: 'entry', abilityName: 'EntryAbility', @@ -1753,27 +1887,33 @@ let wantBackground = { try { this.context.startAbilityByCall(wantBackground) - .then((obj) => { + .then((obj: Caller) => { // 执行正常业务 caller = obj; console.info('startAbilityByCall succeed'); - }).catch((err) => { + }).catch((err: BusinessError) => { // 处理业务逻辑错误 console.error(`startAbilityByCall failed, code is ${err.code}, message is ${err.message}`); }); } catch (err) { // 处理入参错误异常 - console.error(`startAbilityByCall failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startAbilityByCall failed, code is ${code}, message is ${message}`); } ``` 前台启动： ```ts -let caller; +import { Caller } from '@ohos.app.ability.UIAbility'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + +let caller: Caller; // 前台启动Ability，将parameters中的'ohos.aafwk.param.callAbilityToForeground'配置为true -let wantForeground = { +let wantForeground: Want = { bundleName: 'com.example.myapplication', moduleName: 'entry', abilityName: 'EntryAbility', @@ -1785,17 +1925,19 @@ let wantForeground = { try { this.context.startAbilityByCall(wantForeground) - .then((obj) => { + .then((obj: Caller) => { // 执行正常业务 caller = obj; console.info('startAbilityByCall succeed'); - }).catch((err) => { + }).catch((err: BusinessError) => { // 处理业务逻辑错误 console.error(`startAbilityByCall failed, code is ${err.code}, message is ${err.message}`); }); } catch (err) { // 处理入参错误异常 - console.error(`startAbilityByCall failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startAbilityByCall failed, code is ${code}, message is ${message}`); } ``` @@ -1853,7 +1995,10 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< **示例：** ```ts -let want = { +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' @@ -1861,7 +2006,7 @@ let want = { let accountId = 100; try { - this.context.startAbilityWithAccount(want, accountId, (err) => { + this.context.startAbilityWithAccount(want, accountId, (err: BusinessError) => { if (err.code) { // 处理业务逻辑错误 console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); @@ -1872,7 +2017,9 @@ try { }); } catch (err) { // 处理入参错误异常 - console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startAbilityWithAccount failed, code is ${code}, message is ${message}`); } ``` @@ -1932,18 +2079,22 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca **示例：** ```ts -let want = { +import Want from '@ohos.app.ability.Want'; +import StartOptions from '@ohos.app.ability.StartOptions'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; let accountId = 100; -let options = { +let options: StartOptions = { windowMode: 0 }; try { - this.context.startAbilityWithAccount(want, accountId, options, (err) => { + this.context.startAbilityWithAccount(want, accountId, options, (err: BusinessError) => { if (err.code) { // 处理业务逻辑错误 console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); @@ -1954,7 +2105,9 @@ try { }); } catch (err) { // 处理入参错误异常 - console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startAbilityWithAccount failed, code is ${code}, message is ${message}`); } ``` @@ -2013,13 +2166,17 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): **示例：** ```ts -let want = { +import Want from '@ohos.app.ability.Want'; +import StartOptions from '@ohos.app.ability.StartOptions'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; let accountId = 100; -let options = { +let options: StartOptions = { windowMode: 0 }; @@ -2029,13 +2186,15 @@ try { // 执行正常业务 console.info('startAbilityWithAccount succeed'); }) - .catch((err) => { + .catch((err: BusinessError) => { // 处理业务逻辑错误 console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); }); } catch (err) { // 处理入参错误异常 - console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startAbilityWithAccount failed, code is ${code}, message is ${message}`); } ``` @@ -2066,7 +2225,9 @@ setMissionLabel(label: string, callback:AsyncCallback<void>): void; **示例：** ```ts - this.context.setMissionLabel('test', (result) => { + import { BusinessError } from '@ohos.base'; + + this.context.setMissionLabel('test', (result: BusinessError) => { console.info(`setMissionLabel: ${JSON.stringify(result)}`); }); ``` @@ -2103,10 +2264,14 @@ setMissionLabel(label: string): Promise<void>; **示例：** ```ts + import { BusinessError } from '@ohos.base'; + this.context.setMissionLabel('test').then(() => { console.info('success'); - }).catch((err) => { - console.error(`setMissionLabel failed, code is ${err.code}, message is ${err.message}`); + }).catch((err: BusinessError) => { + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`setMissionLabel failed, code is ${code}, message is ${message}`); }); ``` ## UIAbilityContext.setMissionIcon @@ -2138,26 +2303,30 @@ setMissionIcon(icon: image.PixelMap, callback:AsyncCallback\): void; **示例：** ```ts + import UIAbility from '@ohos.app.ability.UIAbility'; + import { BusinessError } from '@ohos.base'; import image from '@ohos.multimedia.image'; - let imagePixelMap; - let color = new ArrayBuffer(0); - let initializationOptions = { - size: { - height: 100, - width: 100 + export default class EntryAbility extends UIAbility { + onForeground() { + let imagePixelMap: image.PixelMap; + let color = new ArrayBuffer(0); + image.createPixelMap(color, { + size: { + height: 100, + width: 100 + } + }).then((data) => { + imagePixelMap = data; + this.context.setMissionIcon(imagePixelMap, (err: BusinessError) => { + console.error(`setMissionLabel failed, code is ${err.code}, message is ${err.message}`); + }) + }) + .catch((err: BusinessError) => { + console.error(`createPixelMap failed, code is ${err.code}, message is ${err.message}`); + }); } - }; - image.createPixelMap(color, initializationOptions) - .then((data) => { - imagePixelMap = data; - }) - .catch((err) => { - console.error(`createPixelMap failed, code is ${err.code}, message is ${err.message}`); - }); - this.context.setMissionIcon(imagePixelMap, (err) => { - console.error(`setMissionLabel failed, code is ${err.code}, message is ${err.message}`); - }) + } ``` @@ -2195,30 +2364,34 @@ setMissionIcon(icon: image.PixelMap): Promise\; **示例：** ```ts + import UIAbility from '@ohos.app.ability.UIAbility'; + import { BusinessError } from '@ohos.base'; import image from '@ohos.multimedia.image'; - let imagePixelMap; - let color = new ArrayBuffer(0); - let initializationOptions = { - size: { - height: 100, - width: 100 + export default class EntryAbility extends UIAbility { + onForeground() { + let imagePixelMap: image.PixelMap; + let color = new ArrayBuffer(0); + image.createPixelMap(color, { + size: { + height: 100, + width: 100 + } + }).then((data) => { + imagePixelMap = data; + this.context.setMissionIcon(imagePixelMap) + .then(() => { + console.info('setMissionIcon succeed'); + }) + .catch((err: BusinessError) => { + console.error(`setMissionLabel failed, code is ${err.code}, message is ${err.message}`); + }); + }) + .catch((err: BusinessError) => { + console.error(`createPixelMap failed, code is ${err.code}, message is ${err.message}`); + }); } - }; - image.createPixelMap(color, initializationOptions) - .then((data) => { - imagePixelMap = data; - }) - .catch((err) => { - console.error(`createPixelMap failed, code is ${err.code}, message is ${err.message}`); - }); - this.context.setMissionIcon(imagePixelMap) - .then(() => { - console.info('setMissionIcon succeed'); - }) - .catch((err) => { - console.error(`setMissionLabel failed, code is ${err.code}, message is ${err.message}`); - }); + } ``` ## UIAbilityContext.setMissionContinueState10+ @@ -2249,8 +2422,9 @@ setMissionContinueState(state: AbilityConstant.ContinueState, callback:AsyncCall ```ts import AbilityConstant from '@ohos.app.ability.AbilityConstant'; + import { BusinessError } from '@ohos.base'; - this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE, (result) => { + this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE, (result: BusinessError) => { console.info(`setMissionContinueState: ${JSON.stringify(result)}`); }); ``` @@ -2288,10 +2462,11 @@ setMissionContinueState(state: AbilityConstant.ContinueState): Promise<void&g ```ts import AbilityConstant from '@ohos.app.ability.AbilityConstant'; + import { BusinessError } from '@ohos.base'; this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE).then(() => { console.info('success'); - }).catch((err) => { + }).catch((err: BusinessError) => { console.error(`setMissionContinueState failed, code is ${err.code}, message is ${err.message}`); }); ``` @@ -2351,7 +2526,7 @@ isTerminating(): boolean; **示例：** ```ts - let isTerminating = this.context.isTerminating(); + let isTerminating: boolean = this.context.isTerminating(); console.info(`ability state is ${isTerminating}`); ``` @@ -2401,15 +2576,17 @@ requestDialogService(want: Want, result: AsyncCallback<dialogRequest.RequestR ```ts import dialogRequest from '@ohos.app.ability.dialogRequest'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; -let want = { +let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'AuthAccountServiceExtension' }; try { - this.context.requestDialogService(want, (err, result) => { + this.context.requestDialogService(want, (err: BusinessError, result: dialogRequest.RequestResult) => { if (err.code) { // 处理业务逻辑错误 console.error(`requestDialogService failed, code is ${err.code}, message is ${err.message}`); @@ -2420,7 +2597,9 @@ try { }); } catch (err) { // 处理入参错误异常 - console.error(`requestDialogService failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`requestDialogService failed, code is ${code}, message is ${message}`); } ``` @@ -2476,25 +2655,29 @@ requestDialogService(want: Want): Promise<dialogRequest.RequestResult>; ```ts import dialogRequest from '@ohos.app.ability.dialogRequest'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; -let want = { +let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'AuthAccountServiceExtension' }; try { this.context.requestDialogService(want) - .then((result) => { + .then((result: dialogRequest.RequestResult) => { // 执行正常业务 console.info('requestDialogService succeed, result = ${JSON.stringify(result)}'); }) - .catch((err) => { + .catch((err: BusinessError) => { // 处理业务逻辑错误 console.error(`requestDialogService failed, code is ${err.code}, message is ${err.message}`); }); } catch (err) { // 处理入参错误异常 - console.error(`requestDialogService failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`requestDialogService failed, code is ${code}, message is ${message}`); } ``` ## UIAbilityContext.startRecentAbility @@ -2544,13 +2727,16 @@ startRecentAbility(want: Want, callback: AsyncCallback<void>): void; **示例：** ```ts -let want = { +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; try { - this.context.startRecentAbility(want, (err) => { + this.context.startRecentAbility(want, (err: BusinessError) => { if (err.code) { // 处理业务逻辑错误 console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`); @@ -2561,7 +2747,9 @@ try { }); } catch (err) { // 处理入参错误异常 - console.error(`startRecentAbility failed failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startRecentAbility failed, code is ${code}, message is ${message}`); } ``` ## UIAbilityContext.startRecentAbility @@ -2613,17 +2801,21 @@ startRecentAbility(want: Want, options: StartOptions, callback: AsyncCallback< **示例：** ```ts -let want = { +import Want from '@ohos.app.ability.Want'; +import StartOptions from '@ohos.app.ability.StartOptions'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { deviceId: '', bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; -let options = { +let options: StartOptions = { windowMode: 0 }; try { - this.context.startRecentAbility(want, options, (err) => { + this.context.startRecentAbility(want, options, (err: BusinessError) => { if (err.code) { // 处理业务逻辑错误 console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`); @@ -2634,7 +2826,9 @@ try { }); } catch (err) { // 处理入参错误异常 - console.error(`startRecentAbility failed failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startRecentAbility failed, code is ${code}, message is ${message}`); } ``` ## UIAbilityContext.startRecentAbility @@ -2685,11 +2879,15 @@ startRecentAbility(want: Want, options?: StartOptions): Promise<void>; **示例：** ```ts -let want = { +import Want from '@ohos.app.ability.Want'; +import StartOptions from '@ohos.app.ability.StartOptions'; +import { BusinessError } from '@ohos.base'; + +let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; -let options = { +let options: StartOptions = { windowMode: 0, }; @@ -2699,13 +2897,15 @@ try { // 执行正常业务 console.info('startRecentAbility succeed'); }) - .catch((err) => { + .catch((err: BusinessError) => { // 处理业务逻辑错误 console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`); }); } catch (err) { // 处理入参错误异常 - console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startRecentAbility failed, code is ${code}, message is ${message}`); } ``` @@ -2761,13 +2961,17 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise<Caller& **示例：** ```ts - let caller; + import { Caller } from '@ohos.app.ability.UIAbility'; + import Want from '@ohos.app.ability.Want'; + import { BusinessError } from '@ohos.base'; + + let caller: Caller; // 系统账号的账号ID, -1表示当前激活用户 let accountId = -1; // 指定启动的Ability - let want = { + let want: Want = { bundleName: 'com.acts.actscalleeabilityrely', moduleName: 'entry', abilityName: 'EntryAbility', @@ -2780,11 +2984,11 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise<Caller& try { this.context.startAbilityByCallWithAccount(want, accountId) - .then((obj) => { + .then((obj: Caller) => { // 执行正常业务 caller = obj; console.log('startAbilityByCallWithAccount succeed'); - }).catch((error) => { + }).catch((error: BusinessError) => { // 处理业务逻辑错误 console.error('startAbilityByCallWithAccount failed, error.code: ${error.code}, error.message: ${error.message}'); }); @@ -2842,10 +3046,11 @@ starAbilityAsCaller(want: Want, callback: AsyncCallback\): void; ```ts import UIAbility from '@ohos.app.ability.UIAbility'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; import Want from '@ohos.app.ability.Want'; export default class EntryAbility extends UIAbility { - onCreate(want, launchParam) { + onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { // want包含启动该应用的Caller信息 let localWant: Want = want; localWant.bundleName = 'com.example.demo'; @@ -2912,17 +3117,19 @@ startAbilityAsCaller(want: Want, options: StartOptions, callback: AsyncCallback\ ```ts import UIAbility from '@ohos.app.ability.UIAbility'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; +import StartOptions from '@ohos.app.ability.StartOptions'; import Want from '@ohos.app.ability.Want'; export default class EntryAbility extends UIAbility { - onCreate(want, launchParam) { + onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { // want包含启动该应用的Caller信息 let localWant: Want = want; localWant.bundleName = 'com.example.demo'; localWant.moduleName = 'entry'; localWant.abilityName = 'TestAbility'; - let option = { + let option: StartOptions = { displayId: 0 } @@ -2993,10 +3200,13 @@ startAbilityAsCaller(want: Want, options?: StartOptions): Promise\; ```ts import UIAbility from '@ohos.app.ability.UIAbility'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; +import StartOptions from '@ohos.app.ability.StartOptions'; import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; export default class EntryAbility extends UIAbility { - onCreate(want, launchParam) { + onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { // want包含启动该应用的Caller信息 let localWant: Want = want; localWant.bundleName = 'com.example.demo'; @@ -3012,7 +3222,7 @@ export default class EntryAbility extends UIAbility { .then(() => { console.log('startAbilityAsCaller success.'); }) - .catch((err) => { + .catch((err: BusinessError) => { console.error('startAbilityAsCaller failed, err:' + JSON.stringify(err)); }) } @@ -3047,6 +3257,7 @@ reportDrawnCompleted(callback: AsyncCallback\): void; ```ts import UIAbility from '@ohos.app.ability.UIAbility'; import window from '@ohos.window'; +import { BusinessError } from '@ohos.base'; export default class EntryAbility extends UIAbility { onWindowStageCreate(windowStage: window.WindowStage) { @@ -3066,7 +3277,9 @@ export default class EntryAbility extends UIAbility { }); } catch (err) { // 捕获同步的参数错误 - console.error(`reportDrawnCompleted failed, code is ${err.code}, message is ${err.message}`); + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`reportDrawnCompleted failed, code is ${code}, message is ${message}`); } }); console.log("MainAbility onWindowStageCreate") diff --git a/zh-cn/application-dev/reference/apis/js-apis-wantAgent.md b/zh-cn/application-dev/reference/apis/js-apis-wantAgent.md index 811d23feb1fec6e0ac79038dc9082c28246581e4..078dc7f4330acd25fac0c55108a4be178f264d97 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-wantAgent.md +++ b/zh-cn/application-dev/reference/apis/js-apis-wantAgent.md @@ -32,14 +32,15 @@ getWant(agent: WantAgent, callback: AsyncCallback\): void **示例：** ```ts -import WantAgent from '@ohos.wantAgent'; - +import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent'; +import Want from '@ohos.app.ability.Want'; +import { BusinessError } from '@ohos.base'; //wantAgent对象 -let wantAgent; +let wantAgent: _WantAgent; //getWantAgent回调 -function getWantAgentCallback(err, data) { +function getWantAgentCallback(err: BusinessError, data: _WantAgent) { console.info('==========================>getWantAgentCallback=======================>'); if (err.code == 0) { wantAgent = data; @@ -49,13 +50,13 @@ function getWantAgentCallback(err, data) { } //getWant回调 - function getWantCallback(err, data) { + let getWantCallback = (err: BusinessError, data: Want) => { console.info('==========================>getWantCallback=======================>'); } WantAgent.getWant(wantAgent, getWantCallback); } -//WantAgentInfo对象 -let wantAgentInfo = { + +WantAgent.getWantAgent({ wants: [ { deviceId: 'deviceId', @@ -80,9 +81,7 @@ let wantAgentInfo = { operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] -}; - -WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback); +}, getWantAgentCallback); ``` ## WantAgent.getWant @@ -110,14 +109,13 @@ getWant(agent: WantAgent): Promise\ **示例：** ```ts -import WantAgent from '@ohos.wantAgent'; - +import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent'; +import { BusinessError } from '@ohos.base'; //wantAgent对象 -let wantAgent; +let wantAgent: _WantAgent; -//WantAgentInfo对象 -let wantAgentInfo = { +WantAgent.getWantAgent({ wants: [ { deviceId: 'deviceId', @@ -142,9 +140,7 @@ let wantAgentInfo = { operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] -} - -WantAgent.getWantAgent(wantAgentInfo).then((data) => { +}).then((data) => { console.info('==========================>getWantAgentCallback=======================>'); wantAgent = data; if (wantAgent) { @@ -173,18 +169,19 @@ getWantAgent(info: WantAgentInfo, callback: AsyncCallback\): void **示例：** ```ts -import WantAgent from '@ohos.wantAgent'; +import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent'; +import { BusinessError } from '@ohos.base'; //getWantAgent回调 -function getWantAgentCallback(err, data) { +function getWantAgentCallback(err: BusinessError, data: _WantAgent) { if (err.code) { console.info('getWantAgent Callback err:' + JSON.stringify(err)) } else { console.info('getWantAgent Callback success') } } -//WantAgentInfo对象 -let wantAgentInfo = { + +WantAgent.getWantAgent({ wants: [ { deviceId: 'deviceId', @@ -209,9 +206,7 @@ let wantAgentInfo = { operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] -} - -WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback); +}, getWantAgentCallback); ``` ## WantAgent.getWantAgent @@ -237,11 +232,9 @@ getWantAgent(info: WantAgentInfo): Promise\ **示例：** ```ts -import WantAgent from '@ohos.wantAgent'; +import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent'; - -//WantAgentInfo对象 -let wantAgentInfo = { +WantAgent.getWantAgent({ wants: [ { deviceId: 'deviceId', @@ -266,9 +259,7 @@ let wantAgentInfo = { operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] -} - -WantAgent.getWantAgent(wantAgentInfo).then((data) => { +}).then((data: _WantAgent) => { console.info('==========================>getWantAgentCallback=======================>'); }); ``` @@ -291,14 +282,14 @@ getBundleName(agent: WantAgent, callback: AsyncCallback\): void **示例：** ```ts -import WantAgent from '@ohos.wantAgent'; - +import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent'; +import { BusinessError } from '@ohos.base'; //wantAgent对象 -let wantAgent; +let wantAgent: _WantAgent; //getWantAgent回调 -function getWantAgentCallback(err, data) { +function getWantAgentCallback(err: BusinessError, data: _WantAgent) { console.info('==========================>getWantAgentCallback=======================>'); if (err.code == 0) { wantAgent = data; @@ -308,13 +299,13 @@ function getWantAgentCallback(err, data) { } //getBundleName回调 - function getBundleNameCallback(err, data) { + let getBundleNameCallback = (err: BusinessError, data: string) => { console.info('==========================>getBundleNameCallback=======================>'); } WantAgent.getBundleName(wantAgent, getBundleNameCallback); } -//WantAgentInfo对象 -let wantAgentInfo = { + +WantAgent.getWantAgent({ wants: [ { deviceId: 'deviceId', @@ -339,9 +330,7 @@ let wantAgentInfo = { operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] -} - -WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback) +}, getWantAgentCallback) ``` @@ -369,13 +358,12 @@ getBundleName(agent: WantAgent): Promise\ **示例：** ```ts -import WantAgent from '@ohos.wantAgent'; +import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent'; //wantAgent对象 -let wantAgent; +let wantAgent: _WantAgent; -//WantAgentInfo对象 -let wantAgentInfo = { +WantAgent.getWantAgent({ wants: [ { deviceId: 'deviceId', @@ -400,9 +388,7 @@ let wantAgentInfo = { operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] -} - -WantAgent.getWantAgent(wantAgentInfo).then((data) => { +}).then((data: _WantAgent) => { console.info('==========================>getWantAgentCallback=======================>'); wantAgent = data; if (wantAgent) { @@ -433,14 +419,14 @@ getUid(agent: WantAgent, callback: AsyncCallback\): void **示例：** ```ts -import WantAgent from '@ohos.wantAgent'; - +import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent'; +import { BusinessError } from '@ohos.base'; //wantAgent对象 -let wantAgent; +let wantAgent: _WantAgent; //getWantAgent回调 -function getWantAgentCallback(err, data) { +function getWantAgentCallback(err: BusinessError, data: _WantAgent) { console.info('==========================>getWantAgentCallback=======================>'); if (err.code == 0) { wantAgent = data; @@ -450,13 +436,13 @@ function getWantAgentCallback(err, data) { } //getUid回调 - function getUidCallback(err, data) { + let getUidCallback = (err: BusinessError, data: number) => { console.info('==========================>getUidCallback=======================>'); } WantAgent.getUid(wantAgent, getUidCallback); } -//WantAgentInfo对象 -let wantAgentInfo = { + +WantAgent.getWantAgent({ wants: [ { deviceId: 'deviceId', @@ -481,9 +467,7 @@ let wantAgentInfo = { operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] -} - -WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback) +}, getWantAgentCallback) ``` @@ -511,14 +495,12 @@ getUid(agent: WantAgent): Promise\ **示例：** ```ts -import WantAgent from '@ohos.wantAgent'; - +import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent'; //wantAgent对象 -let wantAgent; +let wantAgent: _WantAgent; -//WantAgentInfo对象 -let wantAgentInfo = { +WantAgent.getWantAgent({ wants: [ { deviceId: 'deviceId', @@ -543,9 +525,7 @@ let wantAgentInfo = { operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] -} - -WantAgent.getWantAgent(wantAgentInfo).then((data) => { +}).then((data) => { console.info('==========================>getWantAgentCallback=======================>'); wantAgent = data; if (wantAgent) { @@ -575,14 +555,14 @@ cancel(agent: WantAgent, callback: AsyncCallback\): void **示例：** ```ts -import WantAgent from '@ohos.wantAgent'; - +import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent'; +import { BusinessError } from '@ohos.base'; //wantAgent对象 -let wantAgent; +let wantAgent: _WantAgent; //getWantAgent回调 -function getWantAgentCallback(err, data) { +function getWantAgentCallback(err: BusinessError, data: _WantAgent) { console.info('==========================>getWantAgentCallback=======================>'); if (err.code == 0) { wantAgent = data; @@ -592,13 +572,13 @@ function getWantAgentCallback(err, data) { } //cancel回调 - function cancelCallback(err, data) { + let cancelCallback = (err: BusinessError) => { console.info('==========================>cancelCallback=======================>'); } WantAgent.cancel(wantAgent, cancelCallback); } -//WantAgentInfo对象 -let wantAgentInfo = { + +WantAgent.getWantAgent({ wants: [ { deviceId: 'deviceId', @@ -623,9 +603,7 @@ let wantAgentInfo = { operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] -} - -WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback) +}, getWantAgentCallback) ``` @@ -653,41 +631,38 @@ cancel(agent: WantAgent): Promise\ **示例：** ```ts -import WantAgent from '@ohos.wantAgent'; - +import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent'; +import { BusinessError } from '@ohos.base'; //wantAgent对象 -let wantAgent; +let wantAgent: _WantAgent; -//WantAgentInfo对象 -let wantAgentInfo = { +WantAgent.getWantAgent({ wants: [ + { + deviceId: 'deviceId', + bundleName: 'com.neu.setResultOnAbilityResultTest1', + abilityName: 'com.example.test.EntryAbility', + action: 'action1', + entities: ['entity1'], + type: 'MIMETYPE', + uri: 'key={true,true,false}', + parameters: { - deviceId: 'deviceId', - bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.EntryAbility', - action: 'action1', - entities: ['entity1'], - type: 'MIMETYPE', - uri: 'key={true,true,false}', - parameters: - { - mykey0: 2222, - mykey1: [1, 2, 3], - mykey2: '[1, 2, 3]', - mykey3: 'ssssssssssssssssssssssssss', - mykey4: [false, true, false], - mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], - mykey6: true, - } + mykey0: 2222, + mykey1: [1, 2, 3], + mykey2: '[1, 2, 3]', + mykey3: 'ssssssssssssssssssssssssss', + mykey4: [false, true, false], + mykey5: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'], + mykey6: true, } - ], + } +], operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] -} - -WantAgent.getWantAgent(wantAgentInfo).then((data) => { +}).then((data) => { console.info('==========================>getWantAgentCallback=======================>'); wantAgent = data; if (wantAgent) { @@ -719,14 +694,14 @@ trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: Callback\getWantAgentCallback=======================>'); if (err.code == 0) { wantAgent = data; @@ -736,17 +711,14 @@ function getWantAgentCallback(err, data) { } //trigger回调 - function triggerCallback(data) { + let triggerCallback = (data: WantAgent.CompleteData) => { console.info('==========================>triggerCallback=======================>'); } - var triggerInfo = { - code:0 - } - WantAgent.trigger(wantAgent, triggerInfo, triggerCallback) + WantAgent.trigger(wantAgent, {code:0}, triggerCallback) } -//WantAgentInfo对象 -let wantAgentInfo = { + +WantAgent.getWantAgent({ wants: [ { deviceId: 'deviceId', @@ -771,9 +743,7 @@ let wantAgentInfo = { operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] -} - -WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback) +}, getWantAgentCallback) ``` @@ -797,15 +767,15 @@ equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback\getWantAgentCallback=======================>'); if (err.code == 0) { wantAgent1 = data; @@ -816,13 +786,13 @@ function getWantAgentCallback(err, data) { } //equal回调 - function equalCallback(err, data) { + let equalCallback = (err: BusinessError, data: boolean) => { console.info('==========================>equalCallback=======================>'); } WantAgent.equal(wantAgent1, wantAgent2, equalCallback) } -//WantAgentInfo对象 -let wantAgentInfo = { + +WantAgent.getWantAgent({ wants: [ { deviceId: 'deviceId', @@ -847,9 +817,7 @@ let wantAgentInfo = { operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] -} - -WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback) +}, getWantAgentCallback) ``` @@ -878,15 +846,15 @@ equal(agent: WantAgent, otherAgent: WantAgent): Promise\ **示例：** ```ts -import WantAgent from '@ohos.wantAgent'; +import WantAgent, { WantAgent as _WantAgent} from '@ohos.wantAgent'; +import { BusinessError } from '@ohos.base'; //wantAgent对象 -let wantAgent1; -let wantAgent2; +let wantAgent1: _WantAgent; +let wantAgent2: _WantAgent; -//WantAgentInfo对象 -let wantAgentInfo = { +WantAgent.getWantAgent({ wants: [ { deviceId: 'deviceId', @@ -911,9 +879,7 @@ let wantAgentInfo = { operationType: WantAgent.OperationType.START_ABILITIES, requestCode: 0, wantAgentFlags:[WantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] -} - -WantAgent.getWantAgent(wantAgentInfo).then((data) => { +}).then((data) => { console.info('==========================>getWantAgentCallback=======================>'); wantAgent1 = data; wantAgent2 = data; @@ -923,10 +889,6 @@ WantAgent.getWantAgent(wantAgentInfo).then((data) => { }); } }); - -WantAgent.equal(wantAgent1, wantAgent2).then((data) => { - console.info('==========================>equalCallback=======================>'); -}); ``` ## WantAgentFlags