diff --git a/zh-cn/application-dev/reference/apis/js-apis-ability-context.md b/zh-cn/application-dev/reference/apis/js-apis-ability-context.md index 637647f8889c9cedc38cf8d2cebbabfdfb96bd41..c9412207bf3a6d742051aa70ee05cc1b1d457f19 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-ability-context.md +++ b/zh-cn/application-dev/reference/apis/js-apis-ability-context.md @@ -363,7 +363,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC 启动一个Ability并在该Ability帐号销毁时返回执行结果（callback形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -420,7 +420,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp 启动一个Ability并在该Ability帐号销毁时返回执行结果（callback形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -481,7 +481,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO 启动一个Ability并在该Ability帐号销毁时返回执行结果（promise形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -646,7 +646,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: 启动一个新的ServiceExtensionAbility（callback形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -701,7 +701,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ 启动一个新的ServiceExtensionAbility（Promise形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -782,8 +782,14 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\): void; }; try { + this.context.startAbility(want, (error) => { + if (error.code != 0) { + console.log("start ability fail, err: " + JSON.stringify(err)); + } + }) + this.context.stopServiceExtensionAbility(want, (error) => { - if (error.code) { + if (error.code != 0) { // 处理业务逻辑错误 console.log('stopServiceExtensionAbility failed, error.code: ' + JSON.stringify(error.code) + ' error.message: ' + JSON.stringify(error.message)); @@ -832,6 +838,12 @@ stopServiceExtensionAbility(want: Want): Promise\; }; try { + this.context.startAbility(want, (error) => { + if (error.code != 0) { + console.log("start ability fail, err: " + JSON.stringify(err)); + } + }) + this.context.stopServiceExtensionAbility(want) .then((data) => { // 执行正常业务 @@ -855,7 +867,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: 使用帐户停止同一应用程序内的服务（callback形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -887,6 +899,12 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: var accountId = 100; try { + this.context.startAbilityWithAccount(want, accountId, (error) => { + if (error.code != 0) { + console.log("start ability fail, err: " + JSON.stringify(err)); + } + }) + this.context.stopServiceExtensionAbilityWithAccount(want, accountId, (error) => { if (error.code) { // 处理业务逻辑错误 @@ -910,7 +928,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< 使用帐户停止同一应用程序内的服务（Promise形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -941,6 +959,12 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< var accountId = 100; try { + this.context.startAbilityWithAccount(want, accountId, (error) => { + if (error.code != 0) { + console.log("start ability fail, err: " + JSON.stringify(err)); + } + }) + this.context.stopServiceExtensionAbilityWithAccount(want, accountId) .then((data) => { // 执行正常业务 @@ -1206,7 +1230,7 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options 使用AbilityInfo.AbilityType.SERVICE模板和account将当前Ability连接到一个Ability。 -**需要权限：** ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限：** ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -1450,7 +1474,7 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< 根据account启动Ability（callback形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -1506,7 +1530,7 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca 根据account启动Ability（callback形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -1566,7 +1590,7 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): 根据account启动Ability（Promise形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core 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 675bb34e28e9985938f77a289db0055c0c95894d..c8fd635c2479c98e51695c4a6df8e302a589755c 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 @@ -154,9 +154,11 @@ onAbilityContinue(ability: [UIAbility](js-apis-app-ability-uiAbility.md)): void; | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 | **示例：** - + +MyAbilityStage.ts ```ts import AbilityLifecycleCallback from "@ohos.app.ability.AbilityLifecycleCallback"; +import AbilityStage from "@ohos.app.ability.AbilityStage" // 声明ability生命周期回调 let abilityLifecycleCallback = { @@ -189,25 +191,31 @@ let abilityLifecycleCallback = { } } -var lifecycleId; - -export default class MyAbility extends UIAbility { +export default class MyAbilityStage extends AbilityStage { onCreate() { - console.log("MyAbility onCreate") + console.log("MyAbilityStage onCreate"); // 1.通过context属性获取applicationContext let applicationContext = this.context.getApplicationContext(); // 2.通过applicationContext注册监听应用内生命周期 try { - lifecycleId = applicationContext.on("abilityLifecycle", abilityLifecycleCallback); + globalThis.lifecycleId = applicationContext.on("abilityLifecycle", abilityLifecycleCallback); console.log("registerAbilityLifecycleCallback number: " + JSON.stringify(lifecycleId)); } catch (paramError) { console.log("error: " + paramError.code + " ," + paramError.message); } - }, + } +} +``` + +MyAbility.ts +```ts +import UIAbility from "ohos.app.ability.UIAbility" + +export default class MyAbility extends UIAbility { onDestroy() { let applicationContext = this.context.getApplicationContext(); // 3.通过applicationContext注销监听应用内生命周期 - applicationContext.off("abilityLifecycle", lifecycleId, (error) => { + applicationContext.off("abilityLifecycle", globalThis.lifecycleId, (error) => { if (error.code != 0) { console.log("unregisterAbilityLifecycleCallback failed, error: " + JSON.stringify(error)); } else { 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 2a701a608d1dd96055087a3b6172d3bcc1eaabe0..8c0eb01de9817dc093e7daf90437d5ffbe03253b 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 @@ -118,7 +118,7 @@ class MyAbilityStage extends AbilityStage { context: [AbilityStageContext](js-apis-inner-application-abilityStageContext.md); -指示AbilityStage的上下文，。 +指示AbilityStage的上下文。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core 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 c8d2a0e34601ff4d15f566f2c9d00f0a5a817579..7ebefaa0e95f93f1aba05ec7b24a0aae020460fb 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 @@ -514,7 +514,7 @@ killProcessWithAccount(bundleName: string, accountId: number): Promise\ 切断account进程（Promise形式）。 -**需要权限**：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS, ohos.permission.CLEAN_BACKGROUND_PROCESSES +**需要权限**：ohos.permission.CLEAN_BACKGROUND_PROCESSES，ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -554,7 +554,7 @@ killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCal **系统API**: 此接口为系统接口，三方应用不支持调用。 -**需要权限**：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS, ohos.permission.CLEAN_BACKGROUND_PROCESSES +**需要权限**：ohos.permission.CLEAN_BACKGROUND_PROCESSES，ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS权限。 **参数：** 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 2070309cee7c13d9ef2339243a76eeeec9a3e014..1dbb0f1e39cb370ef535f3e7628e1a1cbf869f9f 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 @@ -482,7 +482,7 @@ killProcessWithAccount(bundleName: string, accountId: number): Promise\ 切断account进程（Promise形式）。 -**需要权限**：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS, ohos.permission.CLEAN_BACKGROUND_PROCESSES +**需要权限**：ohos.permission.CLEAN_BACKGROUND_PROCESSES，ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -520,7 +520,7 @@ killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCal **系统API**: 此接口为系统接口，三方应用不支持调用。 -**需要权限**：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS, ohos.permission.CLEAN_BACKGROUND_PROCESSES +**需要权限**：ohos.permission.CLEAN_BACKGROUND_PROCESSES，ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS权限。 **参数：** 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 85861abfda9517597aba145bed6686b1c049e841..955b353266f7d982c3028269c136eafd74560b3c 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 @@ -599,7 +599,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: 启动一个新的ServiceExtensionAbility（callback形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -666,7 +666,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ 启动一个新的ServiceExtensionAbility（Promise形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -858,7 +858,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: 使用帐户停止同一应用程序内的服务（callback形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -921,7 +921,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< 使用帐户停止同一应用程序内的服务（Promise形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core 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 8f0c31e365d8aaa42fcb929c5647b00c684b017d..204bc2954e301bc64ea470869dfc769f24aa834b 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 @@ -450,7 +450,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC 启动一个Ability并在该Ability帐号销毁时返回执行结果（callback形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -525,7 +525,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp 启动一个Ability并在该Ability帐号销毁时返回执行结果（callback形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -604,7 +604,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO 启动一个Ability并在该Ability帐号销毁时返回执行结果（promise形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -807,7 +807,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: 启动一个新的ServiceExtensionAbility（callback形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -869,7 +869,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ 启动一个新的ServiceExtensionAbility（Promise形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -1048,7 +1048,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: 使用帐户停止同一应用程序内的服务（callback形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -1111,7 +1111,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< 使用帐户停止同一应用程序内的服务（Promise形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -1436,7 +1436,7 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options 使用AbilityInfo.AbilityType.SERVICE模板和account将当前Ability连接到一个Ability。 -**需要权限：** ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限：** ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -1696,7 +1696,7 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< 根据account启动Ability（callback形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -1770,7 +1770,7 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca 根据account启动Ability（callback形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -1848,7 +1848,7 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): 根据account启动Ability（Promise形式）。 -**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS +**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core