From 593a8ea10eacb13303cf6ad3e8c4e030698aee91 Mon Sep 17 00:00:00 2001 From: zyjhandsome Date: Thu, 23 Feb 2023 16:36:30 +0800 Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85=E4=B8=80=E4=B8=AA=E3=80=8A?= =?UTF-8?q?=E5=9C=A8ExtensionAbility=E7=BB=84=E4=BB=B6=E4=B8=AD=E8=AE=A2?= =?UTF-8?q?=E9=98=85=E5=9B=9E=E8=B0=83=E3=80=8B=E5=9C=BA=E6=99=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: zyjhandsome --- ...ibe-system-environment-variable-changes.md | 32 ++++++++++++++++--- 1 file changed, 28 insertions(+), 4 deletions(-) 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 b81da7af74..846b72bfd4 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 @@ -9,6 +9,7 @@ - [使用ApplicationContext订阅回调](#使用applicationcontext订阅回调) - [在AbilityStage组件容器中订阅回调](#在abilitystage组件容器中订阅回调) - [在UIAbility组件中订阅回调](#在uiability组件中订阅回调) +- [在ExtensionAbility组件中订阅回调](#在extensionability组件中订阅回调) ## 使用ApplicationContext订阅回调 @@ -67,7 +68,7 @@ ## 在AbilityStage组件容器中订阅回调 -使用[AbilityStage.onConfigurationUpdate()](../reference/apis/js-apis-app-ability-abilityStage.md#abilitystageonconfigurationupdate)回调方法订阅系统环境变量的变化。当系统环境变量发生变化时，会调用该回调方法。在该方法中，通过[Configuration](../reference/apis/js-apis-app-ability-configuration.md)对象获取最新的系统环境配置信息，而无需重启UIAbility。可以进行相应的界面适配等操作，从而提高系统的灵活性和可维护性。 +使用[AbilityStage.onConfigurationUpdate()](../reference/apis/js-apis-app-ability-abilityStage.md#abilitystageonconfigurationupdate)回调方法订阅系统环境变量的变化。当系统环境变量发生变化时，会调用该回调方法。在该方法中，通过[Configuration](../reference/apis/js-apis-app-ability-configuration.md)对象获取最新的系统环境配置信息。可以进行相应的界面适配等操作，从而提高系统的灵活性和可维护性。 > **说明：** > @@ -100,13 +101,13 @@ export default class MyAbilityStage extends AbilityStage { ## 在UIAbility组件中订阅回调 -也可以使用UIAbility.onConfigurationUpdate()回调方法订阅系统环境变量的变化。当系统环境变量发生变化时，会调用该回调方法。在该方法中，通过[Configuration](../reference/apis/js-apis-app-ability-configuration.md)对象获取最新的系统环境配置信息，而无需重启UIAbility。 +UIAbility组件提供了`UIAbility.onConfigurationUpdate()`回调方法用于订阅系统环境变量的变化。当系统环境变量发生变化时，会调用该回调方法。在该方法中，通过[Configuration](../reference/apis/js-apis-app-ability-configuration.md)对象获取最新的系统环境配置信息，而无需重启UIAbility。 > **说明：** > > 当使用回调方法订阅系统环境变量的变化时，该回调方法会随着UIAbility的生命周期而存在，在UIAbility销毁时一并销毁。 -例如，在UIAbility.onConfigurationUpdate()回调方法中实现监测系统语言的变化。 +例如，在`onConfigurationUpdate()`回调方法中实现监测系统语言的变化。 ```ts import UIAbility from '@ohos.app.ability.UIAbility'; @@ -130,4 +131,27 @@ export default class EntryAbility extends UIAbility { // ... } -``` \ No newline at end of file +``` + +## 在ExtensionAbility组件中订阅回调 + +ExtensionAbility组件提供了`onConfigurationUpdate()`回调方法用于订阅系统环境变量的变化。当系统环境变量发生变化时，会调用该回调方法。在该方法中，通过[Configuration](../reference/apis/js-apis-app-ability-configuration.md)对象获取最新的系统环境配置信息。 + +> **说明：** +> +> 当使用回调方法订阅系统环境变量的变化时，该回调方法会随着ExtensionAbility的生命周期而存在，在ExtensionAbility销毁时一并销毁。 + +以FormExtensionAbility为例说明。例如，在`onConfigurationUpdate()`回调方法中实现系统环境变量的变化。 + +```ts +import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility'; + +export default class EntryFormAbility extends FormExtensionAbility { + onConfigurationUpdate(newConfig) { + console.info(`newConfig is ${JSON.stringify(newConfig)}`); + } + + // ... +} +``` + -- GitLab