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 84a51096a15d9e9c526880f7f00e5ee09bfa9268..d4b3356239197752e7838f2de446a02bf6447493 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 @@ -40,6 +40,11 @@ startAbility(want: Want, callback: AsyncCallback<void>): void; 启动Ability（callback形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.Core **参数：** @@ -89,6 +94,11 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void& 启动Ability（callback形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.Core **参数：** @@ -142,6 +152,11 @@ startAbility(want: Want, options?: StartOptions): Promise<void>; 启动Ability（promise形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.Core **参数：** @@ -200,6 +215,11 @@ startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>): 启动一个Ability。Ability被启动后，正常情况下可通过调用[terminateSelfWithResult](#abilitycontextterminateselfwithresult)接口使之终止并且返回结果给调用者。异常情况下比如杀死Ability会返回异常信息给调用者（callback形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.Core **参数：** @@ -250,6 +270,11 @@ startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback 启动一个Ability。Ability被启动后，正常情况下可通过调用[terminateSelfWithResult](#abilitycontextterminateselfwithresult)接口使之终止并且返回结果给调用者。异常情况下比如杀死Ability会返回异常信息给调用者（callback形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.Core **参数：** @@ -305,6 +330,11 @@ startAbilityForResult(want: Want, options?: StartOptions): Promise<AbilityRes 启动一个Ability。Ability被启动后，正常情况下可通过调用[terminateSelfWithResult](#abilitycontextterminateselfwithresult)接口使之终止并且返回结果给调用者。异常情况下比如杀死Ability会返回异常信息给调用者（promise形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.Core **参数：** @@ -363,6 +393,11 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC 启动一个Ability并在该Ability帐号销毁时返回执行结果（callback形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -420,6 +455,11 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp 启动一个Ability并在该Ability帐号销毁时返回执行结果（callback形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -481,6 +521,11 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO 启动一个Ability并在该Ability帐号销毁时返回执行结果（promise形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -1386,6 +1431,11 @@ startAbilityByCall(want: Want): Promise<Caller>; 启动指定Ability至前台或后台，同时获取其Caller通信接口，调用方可使用Caller与被启动的Ability进行通信。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统API**: 此接口为系统接口，三方应用不支持调用。 @@ -1475,6 +1525,11 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< 根据account启动Ability（callback形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -1531,6 +1586,11 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca 根据account启动Ability（callback形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -1591,6 +1651,11 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): 根据account启动Ability（Promise形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core 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 e42ddca1e2711b7b0d5edc56071a0b119351a252..823b65f17dbdd3873fa972bc9e385155d012154f 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 @@ -23,6 +23,11 @@ startAbility(parameter: StartAbilityParameter, callback: AsyncCallback\) 启动新的Ability（callback形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（FA模型）](../../application-models/component-startup-rules-fa.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel **参数：** @@ -66,6 +71,11 @@ startAbility(parameter: StartAbilityParameter): Promise\ 启动新的Ability（Promise形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（FA模型）](../../application-models/component-startup-rules-fa.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel **参数：** @@ -140,6 +150,11 @@ startAbilityForResult(parameter: StartAbilityParameter, callback: AsyncCallback\ 启动一个Ability。Ability被启动后，正常情况下可通过调用[terminateSelfWithResult](#featureabilityterminateselfwithresult7)接口使之终止并且返回结果给调用者。异常情况下比如杀死Ability会返回异常信息给调用者（callback形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（FA模型）](../../application-models/component-startup-rules-fa.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel **参数：** @@ -181,6 +196,11 @@ startAbilityForResult(parameter: StartAbilityParameter): Promise\ 启动一个Ability。Ability被启动后，正常情况下可通过调用[terminateSelfWithResult](#featureabilityterminateselfwithresult7)接口使之终止并且返回结果给调用者。异常情况下比如杀死Ability会返回异常信息给调用者（Promise形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（FA模型）](../../application-models/component-startup-rules-fa.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel **参数：** 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 ab3d9fef4b26858874b39de253f0488ebafa6d5f..41bdcf337bd7f235a16f321274f298638c7adaca 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 @@ -23,6 +23,11 @@ startAbility(parameter: StartAbilityParameter, callback: AsyncCallback\): 启动指定的particleAbility（callback形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（FA模型）](../../application-models/component-startup-rules-fa.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel **参数：** @@ -64,6 +69,11 @@ startAbility(parameter: StartAbilityParameter): Promise\; 启动指定的particleAbility（Promise形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（FA模型）](../../application-models/component-startup-rules-fa.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel **参数：** 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 ead870593b2e9cbf4003b4d5d2736bce0a850af6..690658a9b7b7b89e43b532cc7d9264ea797ce0ee 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 @@ -217,7 +217,7 @@ onContinue(wantParam : {[key: string]: any}): AbilityConstant.OnContinueResult; onNewWant(want: Want, launchParams: AbilityConstant.LaunchParam): void; -启动模式为单例的ability再次被拉起时会回调执行该方法。 +当传入新的Want，ability再次被拉起时会回调执行该方法。 **系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-ability.md b/zh-cn/application-dev/reference/apis/js-apis-application-ability.md index 222bd012a3eb1b695d3d24a0afe4c473eb7c6995..14eeb6d2468387d894fdf7d6974265b8e0ba3278 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-ability.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-ability.md @@ -219,7 +219,7 @@ onContinue(wantParam : {[key: string]: any}): AbilityConstant.OnContinueResult; onNewWant(want: Want, launchParams: AbilityConstant.LaunchParam): void; -启动模式为单例的ability再次被拉起时会回调执行该方法。 +当传入新的Want，ability再次被拉起时会回调执行该方法。 **系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore 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 babcff259e98e6fd531d9efc16c4ef2697683dfd..d645cb1c457ae742033fde456c001b92725fbd2c 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 @@ -245,6 +245,11 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< 根据account启动Ability（callback形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统API**: 此接口为系统接口，三方应用不支持调用。 @@ -316,6 +321,11 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca 根据account启动Ability（callback形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统API**: 此接口为系统接口，三方应用不支持调用。 @@ -392,6 +402,11 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): 根据account启动Ability（Promise形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统API**: 此接口为系统接口，三方应用不支持调用。 @@ -1300,6 +1315,11 @@ startAbilityByCall(want: Want): Promise<Caller>; 启动指定Ability至前台或后台，同时获取其Caller通信接口，调用方可使用Caller与被启动的Ability进行通信。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统API**：此接口为系统接口，三方应用不支持调用。 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 5026864ee6b43076524d493b76473bd049309242..a6f67e175200edb4c3440d5fe45e04f0cfe9ff8a 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 @@ -26,6 +26,11 @@ startAbility(want: Want, callback: AsyncCallback<void>): void; 启动Ability（callback形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.Core **参数：** @@ -91,6 +96,11 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void& 启动Ability（callback形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.Core **参数：** @@ -161,6 +171,11 @@ startAbility(want: Want, options?: StartOptions): Promise<void>; 启动Ability（promise形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.Core **参数：** @@ -235,6 +250,11 @@ startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>): 启动一个Ability。Ability被启动后，正常情况下可通过调用[terminateSelfWithResult](#uiabilitycontextterminateselfwithresult)接口使之终止并且返回结果给调用者。异常情况下比如杀死Ability会返回异常信息给调用者（callback形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.Core **参数：** @@ -302,6 +322,10 @@ startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback 启动一个Ability。Ability被启动后，正常情况下可通过调用[terminateSelfWithResult](#uiabilitycontextterminateselfwithresult)接口使之终止并且返回结果给调用者。异常情况下比如杀死Ability会返回异常信息给调用者（callback形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -375,6 +399,11 @@ startAbilityForResult(want: Want, options?: StartOptions): Promise<AbilityRes 启动一个Ability。Ability被启动后，正常情况下可通过调用[terminateSelfWithResult](#uiabilitycontextterminateselfwithresult)接口使之终止并且返回结果给调用者。异常情况下比如杀死Ability会返回异常信息给调用者（promise形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.Core **参数：** @@ -450,6 +479,11 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC 启动一个Ability并在该Ability销毁时返回执行结果（callback形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -525,6 +559,11 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp 启动一个Ability并在该Ability销毁时返回执行结果（callback形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -604,6 +643,11 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO 启动一个Ability并在该Ability销毁时返回执行结果（promise形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -1623,6 +1667,11 @@ startAbilityByCall(want: Want): Promise<Caller>; 启动指定Ability至前台或后台，同时获取其Caller通信接口，调用方可使用Caller与被启动的Ability进行通信。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.Core **参数：** @@ -1710,6 +1759,11 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< 根据want和accountId启动Ability（callback形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -1784,6 +1838,11 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca 根据want、accountId及startOptions启动Ability（callback形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -1862,6 +1921,11 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): 根据want、accountId和startOptions启动Ability（Promise形式）。 +使用规则： + - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) + **需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core diff --git a/zh-cn/application-dev/reference/apis/js-apis-sensor.md b/zh-cn/application-dev/reference/apis/js-apis-sensor.md index 7ff2b1e66fbeeb4b84fc35c88bbb52a2031a6a69..8638221b66ef061dd51a5333e602aada717900c3 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-sensor.md +++ b/zh-cn/application-dev/reference/apis/js-apis-sensor.md @@ -3496,9 +3496,9 @@ try { | 名称 | 类型 | 可读 | 可写 | 说明 | | ---- | ------ | ---- | ---- | ------------------------------------ | -| x | number | 是 | 是 | 施加在设备x轴的加速度，单位 : m/s2。 | -| y | number | 是 | 是 | 施加在设备y轴的加速度，单位 : m/s2。 | -| z | number | 是 | 是 | 施加在设备z轴的加速度，单位 : m/s2。 | +| x | number | 是 | 是 | 施加在设备x轴的加速度，单位 : m/s²。 | +| y | number | 是 | 是 | 施加在设备y轴的加速度，单位 : m/s²。 | +| z | number | 是 | 是 | 施加在设备z轴的加速度，单位 : m/s²。 | ## LinearAccelerometerResponse @@ -3510,9 +3510,9 @@ try { | 名称 | 类型 | 可读 | 可写 | 说明 | | ---- | ------ | ---- | ---- | ---------------------------------------- | -| x | number | 是 | 是 | 施加在设备x轴的线性加速度，单位 : m/s2。 | -| y | number | 是 | 是 | 施加在设备y轴的线性加速度，单位 : m/s2。 | -| z | number | 是 | 是 | 施加在设备z轴的线性加速度，单位 : m/s2。 | +| x | number | 是 | 是 | 施加在设备x轴的线性加速度，单位 : m/s²。 | +| y | number | 是 | 是 | 施加在设备y轴的线性加速度，单位 : m/s²。 | +| z | number | 是 | 是 | 施加在设备z轴的线性加速度，单位 : m/s²。 | ## AccelerometerUncalibratedResponse @@ -3524,12 +3524,12 @@ try { | 名称 | 类型 | 可读 | 可写 | 说明 | | ----- | ------ | ---- | ---- | ------------------------------------------------ | -| x | number | 是 | 是 | 施加在设备x轴未校准的加速度，单位 : m/s2。 | -| y | number | 是 | 是 | 施加在设备y轴未校准的加速度，单位 : m/s2。 | -| z | number | 是 | 是 | 施加在设备z轴未校准的加速度，单位 : m/s2。 | -| biasX | number | 是 | 是 | 施加在设备x轴未校准的加速度偏量，单位 : m/s2。 | -| biasY | number | 是 | 是 | 施加在设备上y轴未校准的加速度偏量，单位 : m/s2。 | -| biasZ | number | 是 | 是 | 施加在设备z轴未校准的加速度偏量，单位 : m/s2。 | +| x | number | 是 | 是 | 施加在设备x轴未校准的加速度，单位 : m/s²。 | +| y | number | 是 | 是 | 施加在设备y轴未校准的加速度，单位 : m/s²。 | +| z | number | 是 | 是 | 施加在设备z轴未校准的加速度，单位 : m/s²。 | +| biasX | number | 是 | 是 | 施加在设备x轴未校准的加速度偏量，单位 : m/s²。 | +| biasY | number | 是 | 是 | 施加在设备上y轴未校准的加速度偏量，单位 : m/s²。 | +| biasZ | number | 是 | 是 | 施加在设备z轴未校准的加速度偏量，单位 : m/s²。 | ## GravityResponse @@ -3541,9 +3541,9 @@ try { | 名称 | 类型 | 可读 | 可写 | 说明 | | ---- | ------ | ---- | ---- | ---------------------------------------- | -| x | number | 是 | 是 | 施加在设备x轴的重力加速度，单位 : m/s2。 | -| y | number | 是 | 是 | 施加在设备y轴的重力加速度，单位 : m/s2。 | -| z | number | 是 | 是 | 施加在设备z轴的重力加速度，单位 : m/s2。 | +| x | number | 是 | 是 | 施加在设备x轴的重力加速度，单位 : m/s²。 | +| y | number | 是 | 是 | 施加在设备y轴的重力加速度，单位 : m/s²。 | +| z | number | 是 | 是 | 施加在设备z轴的重力加速度，单位 : m/s²。 | ## OrientationResponse diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.1.5/changelogs-geoLocationManager.md b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.1.5/changelogs-geoLocationManager.md new file mode 100644 index 0000000000000000000000000000000000000000..f1e652c43fe7e78d6642b34871cadccd7c2ca85d --- /dev/null +++ b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.1.5/changelogs-geoLocationManager.md @@ -0,0 +1,18 @@ +# 位置服务子系统ChangeLog + +## cl.location.1 删除API9接口geoLocationManager.requestEnableLocation + +在位置开关关闭的场景下，应用可以调用geoLocationManager.requestEnableLocation接口，以请求用户开启位置开关；实际该接口使用较少，并且该接口用户体验不太好，并没有告诉用户该应用在什么场景下使用位置信息。 + +因此变更为由应用本身弹框请求用户跳转到settings开启位置开关，并且在弹框上写清楚会在什么场景下使用位置信息，这样用户体验更好。 + +**变更影响** + +在API9上应用无法使用geoLocationManager.requestEnableLocation请求用户开启位置开关，需要应用自己实现弹框，请求用户开启位置开关。 + +**关键的接口/组件变更** + +| 类名 | 接口类型 | 接口声明 | 变更类型 | +| -- | -- | -- | -- | +|geoLocationManager| method | function requestEnableLocation(callback: AsyncCallback<boolean>): void; | 该接口从API9中删除 | +|geoLocationManager| method | function requestEnableLocation(): Promise<boolean>; | 该接口从API9中删除 | diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.1.5/changelogs-wifiManager.md b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.1.5/changelogs-wifiManager.md new file mode 100644 index 0000000000000000000000000000000000000000..e24ff589dd249e8593c17b5fddaf3f217a655743 --- /dev/null +++ b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.1.5/changelogs-wifiManager.md @@ -0,0 +1,62 @@ +# 基础通信子系统WiFi ChangeLog + +## cl.location.1 位置服务权限变更 + +从API9开始，增加ohos.permission.APPROXIMATELY_LOCATION，表示模糊位置权限。 + +如果应用开发者使用的API版本大于等于9，则需要同时申请ohos.permission.LOCATION和ohos.permission.APPROXIMATELY_LOCATION，单独申请ohos.permission.LOCATION会失败。 + +**变更影响** + +如果是存量应用（使用的API版本小于9），则无影响。如果使用的API版本大于等于9，位置服务权限申请方式有变更，详情如下： + +应用在使用系统能力前，需要检查是否已经获取用户授权访问设备位置信息。如未获得授权，可以向用户申请需要的位置权限，申请方式请参考下文。 + +系统提供的定位权限有： + +- ohos.permission.LOCATION + +- ohos.permission.APPROXIMATELY_LOCATION + +- ohos.permission.LOCATION_IN_BACKGROUND + +访问设备的位置信息，必须申请权限，并且获得用户授权。 + +API9之前的版本，申请ohos.permission.LOCATION即可。 + +API9及之后的版本，需要申请ohos.permission.APPROXIMATELY_LOCATION或者同时申请ohos.permission.APPROXIMATELY_LOCATION和ohos.permission.LOCATION；无法单独申请ohos.permission.LOCATION。 + +| 使用的API版本 | 申请位置权限 | 申请结果 | 位置的精确度 | +| -------- | -------- | -------- | -------- | +| 小于9 | ohos.permission.LOCATION | 成功 | 获取到精准位置，精准度在米级别。 | +| 大于等于9 | ohos.permission.LOCATION | 失败 | 无法获取位置。 | +| 大于等于9 | ohos.permission.APPROXIMATELY_LOCATION | 成功 | 获取到模糊位置，精确度为5公里。 | +| 大于等于9 | ohos.permission.APPROXIMATELY_LOCATION和ohos.permission.LOCATION | 成功 | 获取到精准位置，精准度在米级别。 | + +如果应用在后台运行时也需要访问设备位置，除需要将应用声明为允许后台运行外，还必须申请ohos.permission.LOCATION_IN_BACKGROUND权限，这样应用在切入后台之后，系统可以继续上报位置信息。 + +开发者可以在应用配置文件中声明所需要的权限，具体可参考[授权申请指导](../../../application-dev/security/accesstoken-guidelines.md)。 + +**关键的接口/组件变更** + +| 类名 | 接口类型 | 接口声明 | 变更类型 | +| -- | -- | -- | -- | +|wifiManager| method | function scan(): void; | 权限变更为ohos.permission.SET_WIFI_INFO and ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION | +|wifiManager| method | function getScanResults(): Promise<Array<WifiScanInfo>>; | 权限变更为ohos.permission.GET_WIFI_INFO and (ohos.permission.GET_WIFI_PEERS_MAC or (ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION)) | +|wifiManager| method | function getScanResults(callback: AsyncCallback<Array<WifiScanInfo>>): void; | 权限变更为ohos.permission.GET_WIFI_INFO and (ohos.permission.GET_WIFI_PEERS_MAC or (ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION)) | +|wifiManager| method | function getScanResultsSync(): Array<WifiScanInfo>; | 权限变更为ohos.permission.GET_WIFI_INFO and (ohos.permission.GET_WIFI_PEERS_MAC or (ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION)) | +|wifiManager| method | function getCandidateConfigs(): Array<WifiDeviceConfig>; | 权限变更为ohos.permission.GET_WIFI_INFO and ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION | +|wifiManager| method | function getDeviceConfigs(): Array<WifiDeviceConfig>; | 权限变更为ohos.permission.GET_WIFI_INFO and ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION and ohos.permission.GET_WIFI_CONFIG | +|wifiManager| method | function getStations(): Array<StationInfo>; | 权限变更为ohos.permission.GET_WIFI_INFO and ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION and ohos.permission.MANAGE_WIFI_HOTSPOT | +|wifiManager| method | function getCurrentGroup(): Promise<WifiP2pGroupInfo>; | 权限变更为ohos.permission.GET_WIFI_INFO and ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION | +|wifiManager| method | function getCurrentGroup(callback: AsyncCallback<WifiP2pGroupInfo>): void; | 权限变更为ohos.permission.GET_WIFI_INFO and ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION | +|wifiManager| method | function getP2pPeerDevices(): Promise<WifiP2pDevice[]>; | 权限变更为ohos.permission.GET_WIFI_INFO and ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION | +|wifiManager| method | function getP2pPeerDevices(callback: AsyncCallback<WifiP2pDevice[]>): void; | 权限变更为ohos.permission.GET_WIFI_INFO and ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION | +|wifiManager| method | function p2pConnect(config: WifiP2PConfig): void; | 权限变更为ohos.permission.GET_WIFI_INFO and ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION | +|wifiManager| method | function startDiscoverDevices(): void; | 权限变更为ohos.permission.GET_WIFI_INFO and ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION | +|wifiManager| method | function getP2pGroups(): Promise<Array<WifiP2pGroupInfo>>; | 权限变更为ohos.permission.GET_WIFI_INFO and ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION | +|wifiManager| method | function getP2pGroups(callback: AsyncCallback<Array<WifiP2pGroupInfo>>): void; | 权限变更为ohos.permission.GET_WIFI_INFO and ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION | +|wifiManager| method | function on(type: "p2pDeviceChange", callback: Callback<WifiP2pDevice>): void; | 权限变更为ohos.permission.GET_WIFI_INFO and ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION | +|wifiManager| method | function off(type: "p2pDeviceChange", callback?: Callback<WifiP2pDevice>): void; | 权限变更为ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION | +|wifiManager| method | function on(type: "p2pPeerDeviceChange", callback: Callback<WifiP2pDevice[]>): void; | 权限变更为ohos.permission.GET_WIFI_INFO and ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION | +|wifiManager| method | function off(type: "p2pPeerDeviceChange", callback?: Callback<WifiP2pDevice[]>): void; | 权限变更为ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION | \ No newline at end of file