From d848b68c4d3199a3c06de24e36c83c8d0c795a32 Mon Sep 17 00:00:00 2001 From: zhang_hao_zheng Date: Mon, 2 Jun 2025 16:00:55 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=94=B9=E5=8E=86=E5=8F=B2=E5=85=B3?= =?UTF-8?q?=E4=BA=8EserviceExtension=E7=9A=84=E6=8E=A5=E5=8F=A3=E6=8F=8F?= =?UTF-8?q?=E8=BF=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: zhang_hao_zheng Change-Id: I5176c5f4bd038bddca41036ddea77322f2b7406a --- ...-inner-application-uiAbilityContext-sys.md | 52 +++++++++---------- ...apis-inner-application-uiAbilityContext.md | 22 ++++---- 2 files changed, 39 insertions(+), 35 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext-sys.md index cd0efcab0fb..3456a14d0aa 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext-sys.md @@ -314,7 +314,7 @@ export default class EntryAbility extends UIAbility { startServiceExtensionAbility(want: Want, callback: AsyncCallback\): void -启动一个新的ServiceExtensionAbility。使用callback异步回调。 +启动[ServiceExtensionAbility](js-apis-app-ability-serviceExtensionAbility-sys.md)实例。使用callback异步回调。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -324,7 +324,7 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\): void | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| want | [Want](js-apis-app-ability-want.md) | 是 | 启动ServiceExtensionAbility的want信息。 | +| want | [Want](js-apis-app-ability-want.md) | 是 | 启动[ServiceExtensionAbility](js-apis-app-ability-serviceExtensionAbility-sys.md)的Want信息。 | | callback | AsyncCallback\ | 是 | 启动ServiceExtensionAbility的回调函数。 | **错误码：** @@ -385,7 +385,7 @@ export default class EntryAbility extends UIAbility { startServiceExtensionAbility(want: Want): Promise\ -启动一个新的ServiceExtensionAbility。使用Promise异步回调。 +启动[ServiceExtensionAbility](js-apis-app-ability-serviceExtensionAbility-sys.md)实例。使用Promise异步回调。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -395,7 +395,7 @@ startServiceExtensionAbility(want: Want): Promise\ | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| want | [Want](js-apis-app-ability-want.md) | 是 | 启动ServiceExtensionAbility的want信息。 | +| want | [Want](js-apis-app-ability-want.md) | 是 | 启动[ServiceExtensionAbility](js-apis-app-ability-serviceExtensionAbility-sys.md)的Want信息。 | **错误码：** @@ -455,12 +455,12 @@ export default class EntryAbility extends UIAbility { startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\): void -启动一个新的ServiceExtensionAbility。使用callback异步回调。 +启动指定系统账号ID下的[ServiceExtensionAbility](js-apis-app-ability-serviceExtensionAbility-sys.md)实例。使用callback异步回调。 > **说明：** -> +> > 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md)。 -> 当accountId为当前用户时，无需进行权限校验。 +> 当accountId为当前系统账号ID时，无需进行权限校验。 **需要权限**：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS @@ -472,7 +472,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| want | [Want](js-apis-app-ability-want.md) | 是 | 启动ServiceExtensionAbility的want信息。 | +| want | [Want](js-apis-app-ability-want.md) | 是 | 启动[ServiceExtensionAbility](js-apis-app-ability-serviceExtensionAbility-sys.md)的Want信息。 | | accountId | number | 是 | 系统账号的账号ID，详情参考[getCreatedOsAccountsCount](../apis-basic-services-kit/js-apis-osAccount.md#getosaccountcount9)。 | | callback | AsyncCallback\ | 是 | 启动ServiceExtensionAbility的回调函数。 | @@ -535,12 +535,12 @@ export default class EntryAbility extends UIAbility { startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ -启动一个新的ServiceExtensionAbility。使用Promise异步回调。 +启动指定系统账号ID下的[ServiceExtensionAbility](js-apis-app-ability-serviceExtensionAbility-sys.md)实例。使用Promise异步回调。 > **说明：** > > 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md)。 -> 当accountId为当前用户时，无需进行权限校验。 +> 当accountId为当前系统账号ID时，无需进行权限校验。 **需要权限**：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS @@ -552,7 +552,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| want | [Want](js-apis-app-ability-want.md) | 是 | 启动Ability的want信息。 | +| want | [Want](js-apis-app-ability-want.md) | 是 | 启动Ability的Want信息。 | | accountId | number | 是 | 系统账号的账号ID，详情参考[getCreatedOsAccountsCount](../apis-basic-services-kit/js-apis-osAccount.md#getosaccountcount9)。 | **错误码：** @@ -613,7 +613,7 @@ export default class EntryAbility extends UIAbility { stopServiceExtensionAbility(want: Want, callback: AsyncCallback\): void -停止同一应用程序内的服务。使用callback异步回调。 +停止[ServiceExtensionAbility](js-apis-app-ability-serviceExtensionAbility-sys.md)实例。使用callback异步回调。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -623,7 +623,7 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\): void | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| want | [Want](js-apis-app-ability-want.md) | 是 | 停止ServiceExtensionAbility的want信息。 | +| want | [Want](js-apis-app-ability-want.md) | 是 | 停止[ServiceExtensionAbility](js-apis-app-ability-serviceExtensionAbility-sys.md)的Want信息。 | | callback | AsyncCallback\ | 是 | 停止ServiceExtensionAbility的回调函数。 | **错误码：** @@ -682,7 +682,7 @@ export default class EntryAbility extends UIAbility { stopServiceExtensionAbility(want: Want): Promise\ -停止同一应用程序内的服务。使用Promise异步回调。 +停止[ServiceExtensionAbility](js-apis-app-ability-serviceExtensionAbility-sys.md)实例。使用Promise异步回调。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -692,7 +692,7 @@ stopServiceExtensionAbility(want: Want): Promise\ | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| want | [Want](js-apis-app-ability-want.md) | 是 | 停止ServiceExtensionAbility的want信息。 | +| want | [Want](js-apis-app-ability-want.md) | 是 | 停止[ServiceExtensionAbility](js-apis-app-ability-serviceExtensionAbility-sys.md)的Want信息。 | **错误码：** @@ -748,11 +748,11 @@ export default class EntryAbility extends UIAbility { stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\): void -停止同一应用程序内指定账户的服务。使用callback异步回调。 +停止指定系统账号ID下的[ServiceExtensionAbility](js-apis-app-ability-serviceExtensionAbility-sys.md)实例。使用callback异步回调。 > **说明：** > -> 当accountId为当前用户时，无需进行权限校验。 +> 当accountId为当前系统账号ID时，无需进行权限校验。 **需要权限**：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS @@ -764,7 +764,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| want | [Want](js-apis-app-ability-want.md) | 是 | 停止ServiceExtensionAbility的want信息。 | +| want | [Want](js-apis-app-ability-want.md) | 是 | 停止[ServiceExtensionAbility](js-apis-app-ability-serviceExtensionAbility-sys.md)的Want信息。 | | accountId | number | 是 | 系统账号的账号ID，详情参考[getCreatedOsAccountsCount](../apis-basic-services-kit/js-apis-osAccount.md#getosaccountcount9)。 | | callback | AsyncCallback\ | 是 | 停止ServiceExtensionAbility的回调函数。 | @@ -823,11 +823,11 @@ export default class EntryAbility extends UIAbility { stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ -停止同一应用程序内指定账户的服务。使用Promise异步回调。 +停止指定系统账号ID下的[ServiceExtensionAbility](js-apis-app-ability-serviceExtensionAbility-sys.md)实例。使用Promise异步回调。 > **说明：** > -> 当accountId为当前用户时，无需进行权限校验。 +> 当accountId为当前系统账号ID时，无需进行权限校验。 **需要权限**：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS @@ -839,7 +839,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| want | [Want](js-apis-app-ability-want.md) | 是 | 停止ServiceExtensionAbility的want信息。 | +| want | [Want](js-apis-app-ability-want.md) | 是 | 停止[ServiceExtensionAbility](js-apis-app-ability-serviceExtensionAbility-sys.md)的Want信息。 | | accountId | number | 是 | 系统账号的账号ID，详情参考[getCreatedOsAccountsCount](../apis-basic-services-kit/js-apis-osAccount.md#getosaccountcount9)。 | **错误码：** @@ -897,13 +897,13 @@ export default class EntryAbility extends UIAbility { connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options: ConnectOptions): number -将当前Ability连接到一个指定account的ServiceExtensionAbility。仅支持在主线程调用。 +将当前UIAbility连接到指定系统账号ID下的[ServiceExtensionAbility](js-apis-app-ability-serviceExtensionAbility-sys.md)。通过返回的proxy与UIAbility进行通信，以使用ServiceExtensionAbility对外提供的能力。仅支持在主线程调用。 -当前仅在phone、tablet设备上生效。 > **说明：** > > 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md)。 +> 当前仅在phone、tablet设备上生效。 > 当accountId为当前用户时，无需进行权限校验。 **需要权限**：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS @@ -916,15 +916,15 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| want | [Want](js-apis-app-ability-want.md) | 是 | 启动Ability的want信息。 | +| want | [Want](js-apis-app-ability-want.md) | 是 | 连接[ServiceExtensionAbility](js-apis-app-ability-serviceExtensionAbility-sys.md)的Want信息。 | | accountId | number | 是 | 系统账号的账号ID，详情参考[getCreatedOsAccountsCount](../apis-basic-services-kit/js-apis-osAccount.md#getosaccountcount9)。 | -| options | [ConnectOptions](js-apis-inner-ability-connectOptions.md) | 是 | 与ServiceExtensionAbility建立连接后回调函数的实例。 | +| options | [ConnectOptions](js-apis-inner-ability-connectOptions.md) | 是 | ConnectOptions类型的回调函数，返回服务连接成功、连接失败、断开的信息。 | **返回值：** | 类型 | 说明 | | -------- | -------- | -| number | 返回Ability连接的结果code。 | +| number | 返回连接id，[disconnectServiceExtensionAbility](js-apis-inner-application-uiAbilityContext.md#disconnectserviceextensionability)根据该连接id断开连接。 | **错误码：** diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md index a961d91d733..4a007c9018b 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md @@ -920,7 +920,7 @@ export default class EntryAbility extends UIAbility { connectServiceExtensionAbility(want: Want, options: ConnectOptions): number -将当前Ability连接到一个ServiceExtensionAbility。仅支持在主线程调用。 +将当前UIAbility连接到一个ServiceExtensionAbility。通过返回的proxy与UIAbility进行通信，以使用ServiceExtensionAbility对外提供的能力。仅支持在主线程调用。 > **说明：** > @@ -932,14 +932,14 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| want | [Want](js-apis-app-ability-want.md) | 是 | 连接ServiceExtensionAbility的want信息。 | -| options | [ConnectOptions](js-apis-inner-ability-connectOptions.md) | 是 | 与ServiceExtensionAbility建立连接后回调函数的实例。 | +| want | [Want](js-apis-app-ability-want.md) | 是 | 连接ServiceExtensionAbility的Want信息。 | +| options | [ConnectOptions](js-apis-inner-ability-connectOptions.md) | 是 | ConnectOptions类型的回调函数，返回服务连接成功、连接失败、断开的信息。 | **返回值：** | 类型 | 说明 | | -------- | -------- | -| number | 返回Ability连接的结果code。 | +| number | 返回连接id，[disconnectServiceExtensionAbility](#disconnectserviceextensionability)根据该连接id断开连接。 | **错误码：** @@ -1005,7 +1005,9 @@ export default class EntryAbility extends UIAbility { disconnectServiceExtensionAbility(connection: number): Promise\ -断开与ServiceExtensionAbility的连接，断开连接之后需要将连接成功时返回的remote对象置空。使用Promise异步回调。仅支持在主线程调用。 +断开与ServiceExtensionAbility的连接。使用Promise异步回调。仅支持在主线程调用。 + +断开连接之后，为了防止使用可能失效的remote对象进行通信，建议将连接成功时返回的remote对象设置为null。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -1013,13 +1015,13 @@ disconnectServiceExtensionAbility(connection: number): Promise\ | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| connection | number | 是 | 连接的ServiceExtensionAbility的数字代码，即connectServiceExtensionAbility返回的connectionId。 | +| connection | number | 是 | 在[connectServiceExtensionAbility](#connectserviceextensionability)返回的连接id。 | **返回值：** | 类型 | 说明 | | -------- | -------- | -| Promise\ | 返回执行结果。 | +| Promise\ | Promise对象。无返回结果的Promise对象。 | **错误码：** @@ -1068,7 +1070,9 @@ export default class EntryAbility extends UIAbility { disconnectServiceExtensionAbility(connection: number, callback: AsyncCallback\): void -断开与ServiceExtensionAbility的连接，断开连接之后需要将连接成功时返回的remote对象置空。使用callback异步回调。仅支持在主线程调用。 +断开与ServiceExtensionAbility的连接。使用Promise异步回调。仅支持在主线程调用。 + +断开连接之后，为了防止使用可能失效的remote对象进行通信，建议将连接成功时返回的remote对象设置为null。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -1076,7 +1080,7 @@ disconnectServiceExtensionAbility(connection: number, callback: AsyncCallback\ | 是 | callback形式返回断开连接的结果。 | **错误码：** -- Gitee