diff --git a/zh-cn/application-dev/application-models/abilitystage.md b/zh-cn/application-dev/application-models/abilitystage.md index 06f611b310263437e64a4d215da5e715b805eb6f..779e7651aba70213002db3618bc4d5686d82881c 100644 --- a/zh-cn/application-dev/application-models/abilitystage.md +++ b/zh-cn/application-dev/application-models/abilitystage.md @@ -5,7 +5,7 @@ [AbilityStage](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md)是一个[Module](../quick-start/application-package-overview.md#应用的多module设计机制)级别的组件容器，应用的[HAP](../quick-start/hap-package.md)在首次加载时会创建一个AbilityStage实例，可以对该Module进行初始化等操作。AbilityStage与Module一一对应，即一个Module拥有一个AbilityStage。 -AbilityStage拥有[onCreate()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#abilitystageoncreate)、[onDestroy()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#abilitystageondestroy12)生命周期回调和[onAcceptWant()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#abilitystageonacceptwant)、[onConfigurationUpdate()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#abilitystageonconfigurationupdate)、[onMemoryLevel()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#abilitystageonmemorylevel)、[onNewProcessRequest()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#abilitystageonnewprocessrequest11)、[onPrepareTermination()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#abilitystageonpreparetermination15)等事件回调。 +AbilityStage拥有[onCreate()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#oncreate)、[onDestroy()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#ondestroy12)生命周期回调和[onAcceptWant()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#onacceptwant)、[onConfigurationUpdate()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#onconfigurationupdate)、[onMemoryLevel()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#onmemorylevel)、[onNewProcessRequest()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#onnewprocessrequest11)、[onPrepareTermination()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#onpreparetermination15)等事件回调。 - onCreate()生命周期回调：在开始加载对应Module的第一个应用组件（如[UIAbility组件](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md)或具体扩展能力的[ExtensionAbility组件](../reference/apis-ability-kit/js-apis-app-ability-extensionAbility.md)）实例之前会先创建AbilityStage，并在AbilityStage创建完成之后执行其onCreate()生命周期回调。AbilityStage模块提供在Module加载的时候，通知开发者，可以在此进行该Module的初始化（如资源预加载、线程创建等）。 @@ -33,7 +33,7 @@ DevEco Studio默认工程中未自动生成AbilityStage，如需要使用Ability 2. 在myabilitystage目录，右键选择“New > ArkTS File”，新建一个文件并命名为MyAbilityStage.ets。 -3. 打开MyAbilityStage.ets文件，导入AbilityStage的依赖包，自定义类继承AbilityStage并加上需要的生命周期回调，示例中增加了一个[onCreate()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#abilitystageoncreate)生命周期回调。 +3. 打开MyAbilityStage.ets文件，导入AbilityStage的依赖包，自定义类继承AbilityStage并加上需要的生命周期回调，示例中增加了一个[onCreate()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#oncreate)生命周期回调。 ```ts import { AbilityStage, Want } from '@kit.AbilityKit'; diff --git a/zh-cn/application-dev/application-models/mission-management-launch-type.md b/zh-cn/application-dev/application-models/mission-management-launch-type.md index ed420e6dccfeba7ae93ca5a915d1ece9cc7d8b48..8a4a6907702739f60accd1d6dd042d990d38c834 100644 --- a/zh-cn/application-dev/application-models/mission-management-launch-type.md +++ b/zh-cn/application-dev/application-models/mission-management-launch-type.md @@ -15,7 +15,7 @@ **图2** 任务与multiton模式 ![mission-and-multiton](figures/mission-and-multiton.png) -- specified：指定实例模式，由[AbilityStage](abilitystage.md)的（[`onAcceptWant()`](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#abilitystageonacceptwant)）决定是否创建新的UIAbility实例。 +- specified：指定实例模式，由[AbilityStage](abilitystage.md)的（[`onAcceptWant()`](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#onacceptwant)）决定是否创建新的UIAbility实例。 **图3** 任务与specified模式 ![mission-and-specified](figures/mission-and-specified.png) diff --git a/zh-cn/application-dev/application-models/process-model-stage.md b/zh-cn/application-dev/application-models/process-model-stage.md index 3f8c0782c4c2cb35d36799223cbcdae305365f4d..7b9b7536ddb27dfce4ee61441cb475ad67160fef 100644 --- a/zh-cn/application-dev/application-models/process-model-stage.md +++ b/zh-cn/application-dev/application-models/process-model-stage.md @@ -10,7 +10,7 @@ > > 仅2in1和tablet设备支持将HAP和UIAbility设置为独立进程，设置方法如下： > - 如果需要指定某个HAP运行在独立进程中，可以在[module.json5配置文件](../quick-start/module-configuration-file.md#配置文件标签)中将isolationMode字段配置为isolationOnly（只在独立进程中运行）或者isolationFirst（优先在独立进程中运行）。 -> - 如果需要指定某个UIAbility运行在独立进程中，可以在module.json5文件中将isolationProcess字段配置为true，同时需要在[onNewProcessRequest](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#abilitystageonnewprocessrequest11)回调中返回一个唯一的进程标识符。 +> - 如果需要指定某个UIAbility运行在独立进程中，可以在module.json5文件中将isolationProcess字段配置为true，同时需要在[onNewProcessRequest](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#onnewprocessrequest11)回调中返回一个唯一的进程标识符。 diff --git a/zh-cn/application-dev/application-models/serviceextensionability.md b/zh-cn/application-dev/application-models/serviceextensionability.md index 8d55d1933d241347f4396841f3d977adb17371f0..cafe528b7a78b7fca3558552ac6e0f948c3c2102 100644 --- a/zh-cn/application-dev/application-models/serviceextensionability.md +++ b/zh-cn/application-dev/application-models/serviceextensionability.md @@ -514,7 +514,6 @@ ServiceExtensionAbility服务组件在onConnect()中返回[IRemoteObject](../ref ```ts import { common } from '@kit.AbilityKit'; - import { promptAction } from '@kit.ArkUI'; import { rpc } from '@kit.IPCKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -547,11 +546,8 @@ ServiceExtensionAbility服务组件在onConnect()中返回[IRemoteObject](../ref if (errCode === 0) { msg = reply.readInt(); } - hilog.info(DOMAIN_NUMBER, TAG, `sendRequest msg:${msg}`); // 成功连接后台服务 - promptAction.showToast({ - message: `sendRequest msg:${msg}` - }); + hilog.info(DOMAIN_NUMBER, TAG, `sendRequest success, msg: ${msg}`); }).catch((error: BusinessError) => { hilog.info(DOMAIN_NUMBER, TAG, `sendRequest failed, ${JSON.stringify(error)}`); }); diff --git a/zh-cn/application-dev/application-models/subscribe-system-environment-variable-changes.md b/zh-cn/application-dev/application-models/subscribe-system-environment-variable-changes.md index b47d172d222231d3f829d947b9455e62a0d95f4d..b487e9865acf497e4d304d50fec493c27774c95d 100644 --- a/zh-cn/application-dev/application-models/subscribe-system-environment-variable-changes.md +++ b/zh-cn/application-dev/application-models/subscribe-system-environment-variable-changes.md @@ -104,14 +104,14 @@ ## 在AbilityStage组件容器中订阅回调 -使用[AbilityStage.onConfigurationUpdate()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#abilitystageonconfigurationupdate)回调方法订阅系统环境变量的变化。当系统环境变量发生变化时，会调用该回调方法。在该方法中，通过[Configuration](../reference/apis-ability-kit/js-apis-app-ability-configuration.md)对象获取最新的系统环境配置信息。可以进行相应的界面适配等操作，从而提高系统的灵活性和可维护性。 +使用[AbilityStage.onConfigurationUpdate()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#onconfigurationupdate)回调方法订阅系统环境变量的变化。当系统环境变量发生变化时，会调用该回调方法。在该方法中，通过[Configuration](../reference/apis-ability-kit/js-apis-app-ability-configuration.md)对象获取最新的系统环境配置信息。可以进行相应的界面适配等操作，从而提高系统的灵活性和可维护性。 > **说明：** > > - DevEco Studio默认工程中未自动生成[AbilityStage](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md)，AbilityStage文件的创建请参见[AbilityStage组件容器](abilitystage.md)。 > - 当使用回调方法订阅系统环境变量的变化时，该回调方法会随着AbilityStage的生命周期而存在，在Module销毁时一并销毁。 -例如，在[AbilityStage.onConfigurationUpdate()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#abilitystageonconfigurationupdate)回调方法中实现监测系统语言的变化。 +例如，在[AbilityStage.onConfigurationUpdate()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#onconfigurationupdate)回调方法中实现监测系统语言的变化。 ```ts import { AbilityStage, Configuration } from '@kit.AbilityKit'; diff --git a/zh-cn/application-dev/application-models/uiability-launch-type.md b/zh-cn/application-dev/application-models/uiability-launch-type.md index a5c1260b1dea767afc1f73b05902e221792bda56..ef3ddfa24c907c1fa6d1bfcea1c51f6d29d058ac 100644 --- a/zh-cn/application-dev/application-models/uiability-launch-type.md +++ b/zh-cn/application-dev/application-models/uiability-launch-type.md @@ -80,7 +80,7 @@ specified启动模式为指定实例模式，针对一些特殊场景使用（ 假设应用有两个[UIAbility](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md)实例，即EntryAbility和SpecifiedAbility。EntryAbility以specified模式启动SpecifiedAbility。基本原理如下： 1. EntryAbility调用[startAbility()](../reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md#startability)方法，并在[Want](../reference/apis-ability-kit/js-apis-app-ability-want.md)的parameters字段中设置唯一的Key值，用于标识SpecifiedAbility。 - 2. 系统在拉起SpecifiedAbility之前，会先进入对应的[AbilityStage](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md)的[onAcceptWant()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#abilitystageonacceptwant)生命周期回调，获取用于标识目标UIAbility的Key值。 + 2. 系统在拉起SpecifiedAbility之前，会先进入对应的[AbilityStage](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md)的[onAcceptWant()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#onacceptwant)生命周期回调，获取用于标识目标UIAbility的Key值。 3. 系统会根据获取的Key值来匹配UIAbility。 * 如果匹配到对应的UIAbility，则会启动该UIAbility实例，并进入[onNewWant()](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md#onnewwant)生命周期回调。 * 如果无法匹配对应的UIAbility，则会创建一个新的UIAbility实例，并进入该UIAbility实例的[onCreate()](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md#oncreate)生命周期回调和[onWindowStageCreate()](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md#onwindowstagecreate)生命周期回调。 @@ -181,7 +181,7 @@ specified启动模式为指定实例模式，针对一些特殊场景使用（ } ``` -3. 开发者根据业务在SpecifiedAbility的[onAcceptWant()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#abilitystageonacceptwant)生命周期回调设置该UIAbility的标识。示例中标识设置为`SpecifiedAbilityInstance_KEY`。 +3. 开发者根据业务在SpecifiedAbility的[onAcceptWant()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#onacceptwant)生命周期回调设置该UIAbility的标识。示例中标识设置为`SpecifiedAbilityInstance_KEY`。 ```ts import { AbilityStage, Want } from '@kit.AbilityKit'; @@ -204,7 +204,7 @@ specified启动模式为指定实例模式，针对一些特殊场景使用（ > **说明：** > - > 1. 当应用的UIAbility实例已经被创建，并且配置为指定实例模式时，如果再次调用[startAbility()](../reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md#startability)方法启动该UIAbility实例，且[AbilityStage](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md)的[onAcceptWant()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#abilitystageonacceptwant)回调匹配到一个已创建的UIAbility实例，则系统会启动原来的UIAbility实例，并且不会重新创建一个新的UIAbility实例。此时，该UIAbility实例的onNewWant()回调会被触发，而不会触发onCreate()和onWindowStageCreate()生命周期回调。 + > 1. 当应用的UIAbility实例已经被创建，并且配置为指定实例模式时，如果再次调用[startAbility()](../reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md#startability)方法启动该UIAbility实例，且[AbilityStage](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md)的[onAcceptWant()](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#onacceptwant)回调匹配到一个已创建的UIAbility实例，则系统会启动原来的UIAbility实例，并且不会重新创建一个新的UIAbility实例。此时，该UIAbility实例的onNewWant()回调会被触发，而不会触发onCreate()和onWindowStageCreate()生命周期回调。 > 2. DevEco Studio默认工程中未自动生成AbilityStage，AbilityStage文件的创建请参见[AbilityStage组件容器](abilitystage.md)。 例如在文档应用中，可以为不同的文档实例内容绑定不同的Key值。每次新建文档时，可以传入一个新的Key值（例如可以将文件的路径作为一个Key标识），此时[AbilityStage](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md)中启动[UIAbility](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md)时都会创建一个新的UIAbility实例；当新建的文档保存之后，回到桌面，或者新打开一个已保存的文档，回到桌面，此时再次打开该已保存的文档，此时AbilityStage中再次启动该UIAbility时，打开的仍然是之前原来已保存的文档界面。 diff --git a/zh-cn/application-dev/application-models/uiability-startup-adjust.md b/zh-cn/application-dev/application-models/uiability-startup-adjust.md index 733b67202b601bee4bef3b5b61171e4029a78266..dc4b9b73dd4f97252d2e6d1b74d7134bb18431cd 100644 --- a/zh-cn/application-dev/application-models/uiability-startup-adjust.md +++ b/zh-cn/application-dev/application-models/uiability-startup-adjust.md @@ -140,7 +140,7 @@ } ``` -2. 调用方通过[openLink](../reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md#openlink12)接口执行跳转，在接口入参需要传入转换后的link和配置[options](../reference/apis-ability-kit/js-apis-app-ability-openLinkOptions.md)，不再传入bundleName、moduleName和abilityName。系统会根据传入的link匹配到符合skills配置的应用。AbilityResult回调结果返回通过入参传入回调函数，在启动ability停止自身后返回给调用方的信息。启动成功和失败结果仍通过Promise返回。
+2. 调用方通过[openLink](../reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md#openlink12)接口执行跳转，在接口入参需要传入转换后的link和配置[options](../reference/apis-ability-kit/js-apis-app-ability-openLinkOptions.md)，不再传入bundleName、moduleName和abilityName。系统会根据传入的link匹配到符合skills配置的应用。AbilityResult回调结果通过入参传入回调函数，在被启动的Ability停止自身后返回给调用方。启动成功和失败结果仍通过Promise返回。
- 当options中的appLinkingOnly为true时，匹配到的应用会经过应用市场域名检查（需联网）返回域名校验检查的唯一匹配项或未匹配结果。 - 当options中的appLinkingOnly为false时，会优先尝试以App Linking的方式拉起，如果没有匹配的应用则改为使用Deep Linking的方式拉起目标应用。 @@ -188,7 +188,7 @@ try { context.openLink(link, openLinkOptions, (err, data) => { - // AbilityResult callback回调函数，仅在被拉起ability死亡时触发 + // AbilityResult回调函数，仅在被启动的Ability终止时触发 hilog.info(DOMAIN_NUMBER, TAG, 'open link success. Callback result:' + JSON.stringify(data)); }).then(() => { hilog.info(DOMAIN_NUMBER, TAG, 'open link success.'); diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-ability.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-ability.md index 87e9793eb89c77ca77f51ebb25d82920c96e042c..e6bb0f17bec28d19d18c390fa95bd672fc7562bc 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-ability.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-ability.md @@ -41,16 +41,17 @@ onConfigurationUpdate(newConfig: Configuration): void | newConfig | [Configuration](js-apis-app-ability-configuration.md) | 是 | 表示需要更新的配置信息。 | **示例：** - ```ts + +```ts // Ability是顶层基类，不支持开发者直接继承。故以派生类UIAbility举例说明。 import { UIAbility, Configuration } from '@kit.AbilityKit'; class MyUIAbility extends UIAbility { - onConfigurationUpdate(config: Configuration) { - console.log(`onConfigurationUpdate, config: ${JSON.stringify(config)}`); - } + onConfigurationUpdate(config: Configuration) { + console.log(`onConfigurationUpdate, config: ${JSON.stringify(config)}`); + } } - ``` +``` ## Ability.onMemoryLevel @@ -70,7 +71,7 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void **示例：** - ```ts +```ts // Ability是顶层基类，不支持开发者直接继承。故以派生类UIAbility举例说明。 import { UIAbility, AbilityConstant } from '@kit.AbilityKit'; @@ -79,4 +80,4 @@ class MyUIAbility extends UIAbility { console.log(`onMemoryLevel, level: ${JSON.stringify(level)}`); } } - ``` +``` diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-abilityConstant.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-abilityConstant.md index 20f3e6ee107030ce7db8ee94846bb40f5537b9c5..bc4840ca1eb991ab13517cd8ad31dc1dcb802b8a 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-abilityConstant.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-abilityConstant.md @@ -347,7 +347,7 @@ export default class MyAbility extends UIAbility { ## PrepareTermination15+ -应用被用户关闭时的动作枚举值，需要配合[AbilityStage](js-apis-app-ability-abilityStage.md)的[onPrepareTermination](js-apis-app-ability-abilityStage.md#abilitystageonpreparetermination15)或者[onPrepareTerminationAsync](js-apis-app-ability-abilityStage.md#abilitystageonprepareterminationasync15)方法使用。 +应用被用户关闭时的动作枚举值，需要配合[AbilityStage](js-apis-app-ability-abilityStage.md)的[onPrepareTermination](js-apis-app-ability-abilityStage.md#onpreparetermination15)或者[onPrepareTerminationAsync](js-apis-app-ability-abilityStage.md#onprepareterminationasync15)方法使用。 **原子化服务API**：从API version 15开始，该接口支持在原子化服务中使用。 diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-abilityManager-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-abilityManager-sys.md index 60c624988ecdcce098db2242078ce6047fc441d4..7808ba2ae00e86fdf49372e41178a5b8d767d6d1 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-abilityManager-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-abilityManager-sys.md @@ -1048,3 +1048,27 @@ export default class EntryAbility extends UIAbility { } } ``` + +## ExtensionRunningInfo + +type ExtensionRunningInfo = _ExtensionRunningInfo + +ExtensionRunningInfo二级模块。 + +**系统能力**：SystemCapability.Ability.AbilityRuntime.Core + +| 类型 | 说明 | +| --- | --- | +| [_ExtensionRunningInfo](js-apis-inner-application-extensionRunningInfo-sys.md) | ExtensionRunningInfo二级模块，提供Extension运行的相关信息。 | + +## AbilityForegroundStateObserver11+ + +type AbilityForegroundStateObserver = _AbilityForegroundStateObserver.default + +AbilityForegroundStateObserver二级模块。 + +**系统能力**：SystemCapability.Ability.AbilityRuntime.Core + +| 类型 | 说明 | +| --- | --- | +| [_AbilityForegroundStateObserver.default](js-apis-inner-application-abilityForegroundStateObserver-sys.md) | AbilityForegroundStateObserver二级模块，用于定义应用前后台状态监听。 | diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-abilityManager.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-abilityManager.md index f99f96565b1bf0916fbdacf8b9527e906855ddc7..22def190283fbe8e5b1d099afe32e5e89c6ccd9d 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-abilityManager.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-abilityManager.md @@ -28,7 +28,7 @@ Ability的状态，该类型为枚举，可配合[AbilityRunningInfo](js-apis-in | BACKGROUNDING | 12 | 表示ability为后台调度中状态。 | -## abilityManager.getAbilityRunningInfos +## abilityManager.getAbilityRunningInfos14+ getAbilityRunningInfos(): Promise\> diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-abilityStage.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-abilityStage.md index d7f97e7e48422e098a49c8e804d28ac16f5323a5..5ab17fd8cab4f5ab29dfd7cf55e32b7df0bf3f80 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-abilityStage.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-abilityStage.md @@ -2,7 +2,7 @@ AbilityStage是一个[Module](../../../application-dev/quick-start/application-package-overview.md#应用的多module设计机制)级别的组件容器，应用的[HAP](../../../application-dev/quick-start/hap-package.md)/[HSP](../../../application-dev/quick-start/in-app-hsp.md)在首次加载时会创建一个AbilityStage实例，开发者可以通过该实例进行Module级别的资源预加载、线程创建等初始化操作。AbilityStage与Module一一对应，即一个Module拥有一个AbilityStage。 -AbilityStage拥有[onCreate()](#abilitystageoncreate)、[onDestroy()](#abilitystageondestroy12)生命周期回调和[onAcceptWant()](#abilitystageonacceptwant)、[onConfigurationUpdate()](#abilitystageonconfigurationupdate)、[onMemoryLevel()](#abilitystageonmemorylevel)事件回调等。 +AbilityStage拥有[onCreate()](#oncreate)、[onDestroy()](#ondestroy12)生命周期回调和[onAcceptWant()](#onacceptwant)、[onConfigurationUpdate()](#onconfigurationupdate)、[onMemoryLevel()](#onmemorylevel)事件回调等。 > **说明：** > @@ -16,7 +16,9 @@ AbilityStage拥有[onCreate()](#abilitystageoncreate)、[onDestroy()](#abilityst import { AbilityStage } from '@kit.AbilityKit'; ``` -## 属性 +## AbilityStage + +### 属性 **原子化服务API**：从API version 11开始，该接口支持在原子化服务中使用。 @@ -26,7 +28,7 @@ import { AbilityStage } from '@kit.AbilityKit'; | -------- | -------- | -------- | -------- | -------- | | context | [AbilityStageContext](js-apis-inner-application-abilityStageContext.md) | 否 | 否 | AbilityStage上下文。 | -## AbilityStage.onCreate +### onCreate onCreate(): void @@ -51,7 +53,7 @@ export default class MyAbilityStage extends AbilityStage { ``` -## AbilityStage.onAcceptWant +### onAcceptWant onAcceptWant(want: Want): string @@ -89,7 +91,7 @@ export default class MyAbilityStage extends AbilityStage { } ``` -## AbilityStage.onNewProcessRequest11+ +### onNewProcessRequest11+ onNewProcessRequest(want: Want): string @@ -123,7 +125,7 @@ export default class MyAbilityStage extends AbilityStage { ``` -## AbilityStage.onConfigurationUpdate +### onConfigurationUpdate onConfigurationUpdate(newConfig: Configuration): void @@ -151,7 +153,7 @@ export default class MyAbilityStage extends AbilityStage { } ``` -## AbilityStage.onMemoryLevel +### onMemoryLevel onMemoryLevel(level: AbilityConstant.MemoryLevel): void @@ -181,7 +183,7 @@ export default class MyAbilityStage extends AbilityStage { } ``` -## AbilityStage.onDestroy12+ +### onDestroy12+ onDestroy(): void @@ -203,7 +205,7 @@ export default class MyAbilityStage extends AbilityStage { } ``` -## AbilityStage.onPrepareTermination15+ +### onPrepareTermination15+ onPrepareTermination(): AbilityConstant.PrepareTermination @@ -215,7 +217,7 @@ onPrepareTermination(): AbilityConstant.PrepareTermination > > - 仅当应用正常退出（例如，通过doc栏/托盘关闭应用，或者应用随设备关机而退出）时会调用该接口。如果应用被强制关闭，则不会调用该接口。 > -> - 当[AbilityStage.onPrepareTerminationAsync](#abilitystageonprepareterminationasync15)实现时，本回调函数将不执行。 +> - 当[AbilityStage.onPrepareTerminationAsync](#onprepareterminationasync15)实现时，本回调函数将不执行。 **需要权限**：ohos.permission.PREPARE_APP_TERMINATE @@ -242,7 +244,7 @@ export default class MyAbilityStage extends AbilityStage { } ``` -## AbilityStage.onPrepareTerminationAsync15+ +### onPrepareTerminationAsync15+ onPrepareTerminationAsync(): Promise\ diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-actionExtensionAbility.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-actionExtensionAbility.md index 76d09acfa34b44de38f0604e8cf8c6900c1d01e8..80fec33b6c685de9a99fee75485acd4a709a5a24 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-actionExtensionAbility.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-actionExtensionAbility.md @@ -1,6 +1,6 @@ # @ohos.app.ability.ActionExtensionAbility (自定义服务扩展能力) -ActionExtensionAbility是为开发者提供的自定义操作业务模板，继承自[UIExtensionAbility](js-apis-app-ability-uiExtensionAbility.md)。ActionExtension主要用于查看宿主应用中的内容以及对其进行对应处理。例如，添加一个书签、将选中的文本翻译成其他语言、在当前页面编辑图像等。各类Ability的继承关系详见[继承关系说明](./js-apis-app-ability-ability.md#ability的继承关系说明)。 +ActionExtensionAbility是为开发者提供的自定义操作业务模板，继承自[UIExtensionAbility](js-apis-app-ability-uiExtensionAbility.md)。ActionExtensionAbility主要用于实现宿主应用的内容查看及交互处理功能。例如，添加一个书签、将选中的文本翻译成其他语言、在当前页面编辑图像等。各类Ability的继承关系详见[继承关系说明](./js-apis-app-ability-ability.md#ability的继承关系说明)。 > **说明：** > @@ -18,7 +18,9 @@ ActionExtensionAbility是为开发者提供的自定义操作业务模板，继 import { ActionExtensionAbility } from '@kit.AbilityKit'; ``` -## 属性 +## ActionExtensionAbility + +### 属性 **系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore @@ -26,7 +28,7 @@ import { ActionExtensionAbility } from '@kit.AbilityKit'; | -------- | -------- | -------- | -------- | -------- | | context | [UIExtensionContext](js-apis-inner-application-uiExtensionContext.md) | 否 | 否 | 上下文。 | -## ActionExtensionAbility.onCreate +### onCreate onCreate(): void @@ -38,7 +40,7 @@ ActionExtensionAbility创建时回调，执行初始化业务逻辑操作。 参见[创建ActionExtensionAbility](#创建actionextensionability)。 -## ActionExtensionAbility.onSessionCreate +### onSessionCreate onSessionCreate(want: Want, session: UIExtensionContentSession): void @@ -57,7 +59,7 @@ onSessionCreate(want: Want, session: UIExtensionContentSession): void 参见[创建ActionExtensionAbility](#创建actionextensionability)。 -## ActionExtensionAbility.onForeground +### onForeground onForeground(): void @@ -69,7 +71,7 @@ ActionExtensionAbility生命周期回调，当ActionExtensionAbility从后台转 参见[创建ActionExtensionAbility](#创建actionextensionability)。 -## ActionExtensionAbility.onBackground +### onBackground onBackground(): void @@ -81,7 +83,7 @@ ActionExtensionAbility生命周期回调，当ActionExtensionAbility从前台转 参见[创建ActionExtensionAbility](#创建actionextensionability)。 -## ActionExtensionAbility.onSessionDestroy +### onSessionDestroy onSessionDestroy(session: UIExtensionContentSession): void @@ -99,7 +101,7 @@ onSessionDestroy(session: UIExtensionContentSession): void 参见[创建ActionExtensionAbility](#创建actionextensionability)。 -## ActionExtensionAbility.onDestroy +### onDestroy onDestroy(): void | Promise<void> diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-common-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-common-sys.md index e3c46b5eb0402ed8b42371455fe5c5095d2d7a67..099fa790c9232ee55515e4cb91f12e40f67198e4 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-common-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-common-sys.md @@ -26,7 +26,7 @@ import { common } from '@kit.AbilityKit'; | AutoStartupInfo11+ | [AutoStartupInfo](js-apis-inner-application-autoStartupInfo-sys.md) | 否 | 否 | AutoStartupInfo二级模块。
**系统接口**：此接口为系统接口。 | | AutoStartupCallback11+ | [AutoStartupCallback](js-apis-inner-application-autoStartupCallback-sys.md) | 否 | 否 | AutoStartupCallback二级模块。
**系统接口**：此接口为系统接口。 | | UIServiceExtensionContext14+ | [UIServiceExtensionContext ](js-apis-inner-application-uiserviceExtensionContext-sys.md) | 否 | 否 |UIServiceExtensionContext 二级模块。
**系统接口**：此接口为系统接口。 | -| UIServiceHostProxy13+ | [UIServiceHostProxy](js-apis-inner-application-uiservicehostproxy-sys.md) | 否 | 否 | UIServiceHostProxy 二级模块。
**系统接口**：此接口为系统接口。 | +| UIServiceHostProxy14+ | [UIServiceHostProxy](js-apis-inner-application-uiservicehostproxy-sys.md) | 否 | 否 | UIServiceHostProxy 二级模块。
**系统接口**：此接口为系统接口。 | **示例：** diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-embeddableUIAbility.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-embeddableUIAbility.md index d157ef34e80e8cf4e0aa815860dfc2b2538e4474..2e9ce9e635e8e89d59c0294cfacfc9bf7b3fa3fc 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-embeddableUIAbility.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-embeddableUIAbility.md @@ -14,7 +14,7 @@ EmbeddableUIAbility是为原子化服务提供可以嵌入式启动的UIAbility import { EmbeddableUIAbility } from '@kit.AbilityKit'; ``` -## 属性 +## EmbeddableUIAbility **系统能力**：SystemCapability.Ability.AbilityRuntime.Core diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-shareExtensionAbility.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-shareExtensionAbility.md index 82f0a302201841d808cdad5c51677400c4501938..3d447f95bbf7ebcaf7b246a264d402bfcc6e46a7 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-shareExtensionAbility.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-shareExtensionAbility.md @@ -18,7 +18,9 @@ ShareExtensionAbility继承自[UIExtensionAbility](js-apis-app-ability-uiExtensi import { ShareExtensionAbility } from '@kit.AbilityKit'; ``` -## 属性 +## ShareExtensionAbility + +### 属性 **系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore @@ -26,7 +28,7 @@ import { ShareExtensionAbility } from '@kit.AbilityKit'; | -------- | -------- | -------- | -------- | -------- | | context | [UIExtensionContext](js-apis-inner-application-uiExtensionContext.md) | 否 | 是 | 上下文。 | -## ShareExtensionAbility.onCreate +### onCreate onCreate(): void @@ -38,7 +40,7 @@ ShareExtensionAbility创建时回调，执行初始化业务逻辑操作。 参见[创建ShareExtensionAbility](#创建shareextensionability)。 -## ShareExtensionAbility.onSessionCreate +### onSessionCreate onSessionCreate(want: Want, session: UIExtensionContentSession): void @@ -57,7 +59,7 @@ onSessionCreate(want: Want, session: UIExtensionContentSession): void 参见[创建ShareExtensionAbility](#创建shareextensionability)。 -## ShareExtensionAbility.onForeground +### onForeground onForeground(): void @@ -69,7 +71,7 @@ ShareExtensionAbility生命周期回调，当ShareExtensionAbility从后台转 参见[创建ShareExtensionAbility](#创建shareextensionability)。 -## ShareExtensionAbility.onBackground +### onBackground onBackground(): void @@ -81,7 +83,7 @@ ShareExtensionAbility生命周期回调，当ShareExtensionAbility从前台转 参见[创建ShareExtensionAbility](#创建shareextensionability)。 -## ShareExtensionAbility.onSessionDestroy +### onSessionDestroy onSessionDestroy(session: UIExtensionContentSession): void @@ -99,7 +101,7 @@ onSessionDestroy(session: UIExtensionContentSession): void 参见[创建ShareExtensionAbility](#创建shareextensionability)。 -## ShareExtensionAbility.onDestroy +### onDestroy onDestroy(): void | Promise<void> diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-uiAbility.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-uiAbility.md index c77e90a75bb5000f917176899336e2566f6febf1..d7f510781f0265947d030b65f7c9503532c7a004 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-uiAbility.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-uiAbility.md @@ -538,7 +538,7 @@ onPrepareToTerminate(): boolean > > - 回调时机：当用户通过点击应用窗口右上角的关闭按钮、或者通过Dock栏/托盘右键退出应用时，可以使用该回调。 > -> - 从API version 15开始，当[UIAbility.onPrepareToTerminateAsync](#onpreparetoterminateasync15)实现时，本回调函数将不执行。当[AbilityStage.onPrepareTerminationAsync](js-apis-app-ability-abilityStage.md#abilitystageonprepareterminationasync15)或[AbilityStage.onPrepareTermination](js-apis-app-ability-abilityStage.md#abilitystageonpreparetermination15)实现时，在dock栏或系统托盘处右键点击关闭，本回调函数将不执行。 +> - 从API version 15开始，当[UIAbility.onPrepareToTerminateAsync](#onpreparetoterminateasync15)实现时，本回调函数将不执行。当[AbilityStage.onPrepareTerminationAsync](js-apis-app-ability-abilityStage.md#onprepareterminationasync15)或[AbilityStage.onPrepareTermination](js-apis-app-ability-abilityStage.md#onpreparetermination15)实现时，在dock栏或系统托盘处右键点击关闭，本回调函数将不执行。 > - 如果应用本身或者所使用的三方框架注册了[window.WindowStage.on('windowStageClose')](../apis-arkui/js-apis-window.md#onwindowstageclose14)监听，本回调函数将不执行。 **需要权限**：ohos.permission.PREPARE_APP_TERMINATE @@ -601,7 +601,7 @@ onPrepareToTerminateAsync(): Promise\ > > - 回调时机：当用户通过点击应用窗口右上角的关闭按钮、或者通过Dock栏/托盘右键退出应用时，可以使用该回调。 > -> - 当[AbilityStage.onPrepareTerminationAsync](js-apis-app-ability-abilityStage.md#abilitystageonprepareterminationasync15)或[AbilityStage.onPrepareTermination](js-apis-app-ability-abilityStage.md#abilitystageonpreparetermination15)实现时，在dock栏或系统托盘处右键点击关闭，本回调函数将不执行。 +> - 当[AbilityStage.onPrepareTerminationAsync](js-apis-app-ability-abilityStage.md#onprepareterminationasync15)或[AbilityStage.onPrepareTermination](js-apis-app-ability-abilityStage.md#onpreparetermination15)实现时，在dock栏或系统托盘处右键点击关闭，本回调函数将不执行。 > - 如果应用本身或者所使用的三方框架注册了[window.WindowStage.on('windowStageClose')](../apis-arkui/js-apis-window.md#onwindowstageclose14)监听，本回调函数将不执行。 > > - 若异步回调内发生crash，按超时处理，执行等待超过10秒未响应，UIAbility将被强制关闭。 diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-appstartup-startupConfig.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-appstartup-startupConfig.md index 992f7b07c149c03f1ad958853619b42875071428..f200dc925e53dba64105ddcd7a530b1179dbbdb5 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-appstartup-startupConfig.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-appstartup-startupConfig.md @@ -36,18 +36,19 @@ export default class MyStartupConfigEntry extends StartupConfigEntry { let onCompletedCallback = (error: BusinessError) => { hilog.info(0x0000, 'testTag', `onCompletedCallback`); if (error) { - hilog.info(0x0000, 'testTag', 'onCompletedCallback: %{public}d, message: %{public}s', error.code, error.message); + hilog.error(0x0000, 'testTag', 'onCompletedCallback: %{public}d, message: %{public}s', error.code, + error.message); } else { hilog.info(0x0000, 'testTag', `onCompletedCallback: success.`); } - } + }; let startupListener: StartupListener = { 'onCompleted': onCompletedCallback - } + }; let config: StartupConfig = { 'timeoutMs': 10000, 'startupListener': startupListener - } + }; return config; } } diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-appstartup-startupListener.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-appstartup-startupListener.md index 1f86e10a7c889e2ca92c56f93026969002c3922c..e7e1e14e348324fbcad368f92c878d8b6e4d0e7d 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-appstartup-startupListener.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-appstartup-startupListener.md @@ -42,18 +42,19 @@ export default class MyStartupConfigEntry extends StartupConfigEntry { let onCompletedCallback = (error: BusinessError) => { hilog.info(0x0000, 'testTag', `onCompletedCallback`); if (error) { - hilog.info(0x0000, 'testTag', 'onCompletedCallback: %{public}d, message: %{public}s', error.code, error.message); + hilog.error(0x0000, 'testTag', 'onCompletedCallback: %{public}d, message: %{public}s', error.code, + error.message); } else { hilog.info(0x0000, 'testTag', `onCompletedCallback: success.`); } - } + }; let startupListener: StartupListener = { 'onCompleted': onCompletedCallback - } + }; let config: StartupConfig = { 'timeoutMs': 10000, 'startupListener': startupListener - } + }; return config; } } diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-application-want.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-application-want.md index 4ff1ad51d94bb12d5626337d74f26a623f3da06c..26c354bf2ab8e84e31b85a6bd39315a087b80f40 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-application-want.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-application-want.md @@ -12,21 +12,21 @@ Want是对象间信息传递的载体，可以用于应用组件间的信息传 import Want from '@ohos.application.Want'; ``` -## 属性 +## Want **系统能力**：SystemCapability.Ability.AbilityBase -| 名称 | 类型 | 必填 | 说明 | +| 名称 | 类型 | 只读 | 可选 | 说明 | | ----------- | -------------------- | ---- | ------------------------------------------------------------ | -| deviceId | string | 否 | 表示运行指定Ability的设备ID。如果未设置该字段，则表明指定本设备。 | -| bundleName | string | 否 | 表示Bundle名称。 | -| abilityName | string | 否 | 表示待启动的Ability名称。如果在Want中该字段同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。AbilityName需要在一个应用的范围内保证唯一。 | -| uri | string | 否 | 表示Uri描述。如果在Want中指定了Uri，则Want将匹配指定的Uri信息，包括scheme、schemeSpecificPart、authority和path信息。 | -| type | string | 否 | 表示MIME type类型描述，打开文件的类型，主要用于文管打开文件。比如：'text/xml' 、 'image/*'等，MIME定义参考：https://www.iana.org/assignments/media-types/media-types.xhtml?utm_source=ld246.com。 | -| flags | number | 否 | 表示处理Want的方式。默认传数字，具体参考：[flags说明](js-apis-ability-wantConstant.md#flags)。 | -| action | string | 否 | 表示要执行的通用操作（如：查看、分享、应用详情）。在隐式Want中，您可以定义该字段，配合uri或parameters来表示对数据要执行的操作。具体参考：[action说明](js-apis-ability-wantConstant.md#action)。隐式Want定义及匹配规则参考：[显式Want与隐式Want匹配规则](../../application-models/explicit-implicit-want-mappings.md)。 | -| parameters | { [key: string]: any } | 否 | 表示WantParams描述，由开发者自行决定传入的键值对。默认会携带以下key值：
ohos.aafwk.param.callerPid 表示拉起方的pid。
ohos.aafwk.param.callerToken 表示拉起方的token。
ohos.aafwk.param.callerUid 表示[bundleInfo](js-apis-bundle-BundleInfo.md#bundleinfodeprecated)中的uid，应用包里应用程序的uid。
- component.startup.newRules：表示是否启用新的管控规则。
- moduleName：表示拉起方的模块名，该字段的值即使定义成其他字符串，在传递到另一端时会被修改为正确的值。
- ohos.dlp.params.sandbox：表示dlp文件才会有。 | -| entities | Array\ | 否 | 表示目标Ability额外的类别信息（如：浏览器、视频播放器）。在隐式Want中是对action字段的补充。在隐式Want中，您可以定义该字段，来过滤匹配Ability类型。具体参考：[entity说明](js-apis-ability-wantConstant.md#entity)。 | +| deviceId | string | 否 | 是 | 表示运行指定Ability的设备ID。如果未设置该字段，则表明指定本设备。 | +| bundleName | string | 否 | 是 | 表示Bundle名称。 | +| abilityName | string | 否 | 是 | 表示待启动的Ability名称。如果在Want中该字段同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。AbilityName需要在一个应用的范围内保证唯一。 | +| uri | string | 否 | 是 | 表示Uri描述。如果在Want中指定了Uri，则Want将匹配指定的Uri信息，包括scheme、schemeSpecificPart、authority和path信息。 | +| type | string | 否 | 是 | 表示MIME type类型描述，打开文件的类型，主要用于文管打开文件。比如：'text/xml' 、 'image/*'等，MIME定义参考：https://www.iana.org/assignments/media-types/media-types.xhtml?utm_source=ld246.com。 | +| flags | number | 否 | 是 | 表示处理Want的方式。默认传数字，具体参考：[flags说明](js-apis-ability-wantConstant.md#flags)。 | +| action | string | 否 | 是 | 表示要执行的通用操作（如：查看、分享、应用详情）。在隐式Want中，您可以定义该字段，配合uri或parameters来表示对数据要执行的操作。具体参考：[action说明](js-apis-ability-wantConstant.md#action)。隐式Want定义及匹配规则参考：[显式Want与隐式Want匹配规则](../../application-models/explicit-implicit-want-mappings.md)。 | +| parameters | { [key: string]: any } | 否 | 是 | 表示WantParams描述，由开发者自行决定传入的键值对。默认会携带以下key值：
ohos.aafwk.param.callerPid 表示拉起方的pid。
ohos.aafwk.param.callerToken 表示拉起方的token。
ohos.aafwk.param.callerUid 表示[bundleInfo](js-apis-bundle-BundleInfo.md#bundleinfodeprecated)中的uid，应用包里应用程序的uid。
- component.startup.newRules：表示是否启用新的管控规则。
- moduleName：表示拉起方的模块名，该字段的值即使定义成其他字符串，在传递到另一端时会被修改为正确的值。
- ohos.dlp.params.sandbox：表示dlp文件才会有。 | +| entities | Array\ | 否 | 是 | 表示目标Ability额外的类别信息（如：浏览器、视频播放器）。在隐式Want中是对action字段的补充。在隐式Want中，您可以定义该字段，来过滤匹配Ability类型。具体参考：[entity说明](js-apis-ability-wantConstant.md#entity)。 | **示例：** diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-ability-want.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-ability-want.md index 711cae2abf79a1032f194ac7499e79791cadda3d..e621b76002b0b52b04cdcbed5cb3091ef3143e6b 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-ability-want.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-ability-want.md @@ -25,7 +25,7 @@ import Want from '@ohos.app.ability.Want'; | type | string | 否 | 是 | 表示MIME type类型，打开文件的类型，主要用于文管打开文件。比如：'text/xml' 、 'image/*'等，MIME定义参考：https://www.iana.org/assignments/media-types/media-types.xhtml?utm_source=ld246.com。 | | flags | number | 否 | 是 | 表示处理Want的方式。默认传数字，具体参考：[flags说明](js-apis-ability-wantConstant.md#flags)。 | | action | string | 否 | 是 | 表示要执行的通用操作（如：查看、分享、应用详情）。在隐式Want中，您可以定义该字段，配合uri或parameters来表示对数据要执行的操作。具体参考：[action说明](js-apis-ability-wantConstant.md#action)。隐式Want定义及匹配规则参考：[显式Want与隐式Want匹配规则](../../application-models/explicit-implicit-want-mappings.md)。 | -| parameters | { [key: string]: any } | 否 | 是 | 表示WantParams，由开发者自行决定传入的键值对。默认会携带以下key值：
ohos.aafwk.callerPid 表示拉起方的pid。
ohos.aafwk.param.callerToken 表示拉起方的token。
ohos.aafwk.param.callerUid 表示[bundleInfo](js-apis-bundleManager-bundleInfo.md#bundleinfo-1)中的uid，应用包里应用程序的uid。
- component.startup.newRules：表示是否启用新的管控规则。
- moduleName：表示拉起方的模块名，该字段的值即使定义成其他字符串，在传递到另一端时会被修改为正确的值。
- ohos.dlp.params.sandbox：表示dlp文件才会有。 | +| parameters | { [key: string]: any } | 否 | 是 | 表示WantParams，由开发者自行决定传入的键值对。默认会携带以下key值：
ohos.aafwk.callerPid 表示拉起方的pid。
ohos.aafwk.param.callerToken 表示拉起方的token。
ohos.aafwk.param.callerUid 表示[bundleInfo](js-apis-bundle-BundleInfo.md#bundleinfodeprecated)中的uid，应用包里应用程序的uid。
- component.startup.newRules：表示是否启用新的管控规则。
- moduleName：表示拉起方的模块名，该字段的值即使定义成其他字符串，在传递到另一端时会被修改为正确的值。
- ohos.dlp.params.sandbox：表示dlp文件才会有。 | | entities | Array\ | 否 | 是 | 表示目标Ability额外的类别信息（如：浏览器、视频播放器），在隐式Want中是对action字段的补充。在隐式Want中，您可以定义该字段，来过滤匹配Ability类型。 | **示例：** diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-abilityMonitor.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-abilityMonitor.md index 6d43ae22a8dc6373b10827c4962b08d876653101..f405c603a1e4b46eb29aebf32fa39fac73f467b1 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-abilityMonitor.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-abilityMonitor.md @@ -16,7 +16,7 @@ import { abilityDelegatorRegistry } from '@kit.TestKit'; 可以作为abilityDelegator中的[addAbilityMonitor](../apis-test-kit/js-apis-inner-application-abilityDelegator.md#addabilitymonitor9)的入参来监听指定Ability的生命周期变化。 -## 属性 +## AbilityMonitor **原子化服务API**：从API version 11开始，该接口支持在原子化服务中使用。 diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-autoStartupCallback-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-autoStartupCallback-sys.md index e0a85240012ed6e7aebfa6cae5aff38251e21f14..a9100067a58f64bd16be69d428b53dda3ab79aea 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-autoStartupCallback-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-autoStartupCallback-sys.md @@ -32,17 +32,19 @@ import { BusinessError } from '@kit.BasicServicesKit'; let autoStartupCallback: common.AutoStartupCallback = { onAutoStartupOn(data: common.AutoStartupInfo) { - console.info('===> autostartupmanager onAutoStartupOn data: ' + JSON.stringify(data)); + console.info(`autostartupmanager onAutoStartupOn, data: ${JSON.stringify(data)}.`); }, onAutoStartupOff(data: common.AutoStartupInfo) { - console.info('===> autostartupmanager onAutoStartupOff data: ' + JSON.stringify(data)); + console.info(`autostartupmanager onAutoStartupOff, data: ${JSON.stringify(data)}}.`); } } try { - autoStartupManager.on('systemAutoStartup', autoStartupCallback) + autoStartupManager.on('systemAutoStartup', autoStartupCallback); } catch (err) { - console.info('===> autostartupmanager on callback err: ' + JSON.stringify(err as BusinessError)); + let code = (err as BusinessError).code; + let msg = (err as BusinessError).message; + console.error(`autoStartupManager.on failed, err code: ${code}, err msg: ${msg}.`); } ``` @@ -70,16 +72,18 @@ import { BusinessError } from '@kit.BasicServicesKit'; let autoStartupCallback: common.AutoStartupCallback = { onAutoStartupOn(data: common.AutoStartupInfo) { - console.info('===> autostartupmanager onAutoStartupOn data: ' + JSON.stringify(data)); + console.info(`autostartupmanager onAutoStartupOn, data: ${JSON.stringify(data)}.`); }, onAutoStartupOff(data: common.AutoStartupInfo) { - console.info('===> autostartupmanager onAutoStartupOff data: ' + JSON.stringify(data)); + console.info(`autostartupmanager onAutoStartupOff, data: ${JSON.stringify(data)}}.`); } } try { - autoStartupManager.on('systemAutoStartup', autoStartupCallback) + autoStartupManager.on('systemAutoStartup', autoStartupCallback); } catch (err) { - console.info('===> autostartupmanager on callback err: ' + JSON.stringify(err as BusinessError)); + let code = (err as BusinessError).code; + let msg = (err as BusinessError).message; + console.error(`autoStartupManager.on failed, err code: ${code}, err msg: ${msg}.`); } ``` diff --git a/zh-cn/application-dev/ui/ui-dark-light-color-adaptation.md b/zh-cn/application-dev/ui/ui-dark-light-color-adaptation.md index 1532531adb8d8dc51792725f9345f4a02d292a8a..cb1c19d2322ccf240b467ed1fd1f0834534099a2 100644 --- a/zh-cn/application-dev/ui/ui-dark-light-color-adaptation.md +++ b/zh-cn/application-dev/ui/ui-dark-light-color-adaptation.md @@ -188,7 +188,7 @@ onCreate(): void { - 建议方法 - 当应用跟随系统深色或浅色模式时，建议采用[AbilityStage的监听回调](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#abilitystageonconfigurationupdate)或[Ability的监听回调](../reference/apis-ability-kit/js-apis-app-ability-ability.md#abilityonconfigurationupdate)方式，主动监听系统深浅色模式变化。一旦颜色模式发生变化，应通过绑定状态变量等方法，执行特定的业务逻辑。 + 当应用跟随系统深色或浅色模式时，建议采用[AbilityStage的监听回调](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md#onconfigurationupdate)或[Ability的监听回调](../reference/apis-ability-kit/js-apis-app-ability-ability.md#abilityonconfigurationupdate)方式，主动监听系统深浅色模式变化。一旦颜色模式发生变化，应通过绑定状态变量等方法，执行特定的业务逻辑。 - 不推荐方法