From 157f1f8f6653fd13cd6473708f00b4f659c92c55 Mon Sep 17 00:00:00 2001 From: xieqiongyang Date: Fri, 25 Aug 2023 11:01:30 +0000 Subject: [PATCH] update docs Signed-off-by: xieqiongyang Change-Id: I960261ce141c671fca1a9aea09ee123e438ca7fd Signed-off-by: x30043723 --- .../application-models/component-startup-rules-fa.md | 3 +++ .../reference/apis/js-apis-ability-featureAbility.md | 12 ++++++++++++ .../apis/js-apis-ability-particleAbility.md | 12 ++++++++++++ 3 files changed, 27 insertions(+) diff --git a/zh-cn/application-dev/application-models/component-startup-rules-fa.md b/zh-cn/application-dev/application-models/component-startup-rules-fa.md index e5d4cb541b3..288f756492c 100644 --- a/zh-cn/application-dev/application-models/component-startup-rules-fa.md +++ b/zh-cn/application-dev/application-models/component-startup-rules-fa.md @@ -28,6 +28,9 @@ - [组件visible配置参考](../quick-start/module-configuration-file.md#abilities标签) - **位于后台的应用，启动组件需校验BACKGROUND权限** +> **说明：** +> 基于API 8或更早版本SDK开发的应用在启动ServiceAbility组件或DataAbility组件时不受此限制的约束。 + - 应用前后台判断标准：若应用进程获焦或所属的UIAbility位于前台则判定为前台应用，否则为后台应用 - 需校验`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 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 f0076089a38..a6ca75a49d5 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 @@ -121,6 +121,12 @@ acquireDataAbilityHelper(uri: string): DataAbilityHelper 获取dataAbilityHelper对象。 +使用规则： + - 跨应用访问dataAbility，对端应用需配置关联启动 + - 调用方应用位于后台时，使用该接口访问dataAbility需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限（基于API 8或更早版本SDK开发的应用在启动DataAbility组件时不受此限制的约束） + - 跨应用场景下，目标dataAbility的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（FA模型）](../../application-models/component-startup-rules-fa.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel **参数：** @@ -535,6 +541,12 @@ connectAbility(request: Want, options:ConnectOptions): number 将当前Ability与指定的ServiceAbility进行连接。 +使用规则： + - 跨应用连接serviceAbility，对端应用需配置关联启动 + - 调用方应用位于后台时，使用该接口连接serviceAbility需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限（基于API 8或更早版本SDK开发的应用在启动ServiceAbility组件时不受此限制的约束） + - 跨应用场景下，目标serviceAbility的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 c95cf90e830..a506fdb3751 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 @@ -171,6 +171,12 @@ acquireDataAbilityHelper(uri: string): DataAbilityHelper 获取dataAbilityHelper对象。 +使用规则： + - 跨应用访问dataAbility，对端应用需配置关联启动 + - 调用方应用位于后台时，使用该接口访问dataAbility需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限（基于API 8或更早版本SDK开发的应用在启动DataAbility组件时不受此限制的约束） + - 跨应用场景下，目标dataAbility的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（FA模型）](../../application-models/component-startup-rules-fa.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel **参数：** @@ -389,6 +395,12 @@ connectAbility(request: Want, options:ConnectOptions): number 将当前ability与指定的ServiceAbility进行连接（callback形式）。 +使用规则： + - 跨应用连接serviceAbility，对端应用需配置关联启动 + - 调用方应用位于后台时，使用该接口连接serviceAbility需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限（基于API 8或更早版本SDK开发的应用在启动ServiceAbility组件时不受此限制的约束） + - 跨应用场景下，目标serviceAbility的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 组件启动规则详见：[组件启动规则（FA模型）](../../application-models/component-startup-rules-fa.md) + **系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel **参数：** -- Gitee