Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
4c80388d
D
Docs
项目概览
OpenHarmony
/
Docs
12 个月 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
4c80388d
编写于
2月 22, 2023
作者:
zyjhandsome
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Add a guide to subscribe to changes in system environment variables.
Signed-off-by:
zyjhandsome
<
zyjhandsome@126.com
>
上级
2932cc0e
变更
2
隐藏空白更改
内联
并排
Showing
2 changed file
with
134 addition
and
0 deletion
+134
-0
zh-cn/application-dev/application-models/Readme-CN.md
zh-cn/application-dev/application-models/Readme-CN.md
+1
-0
zh-cn/application-dev/application-models/subscribe-system-environment-variable-changes.md
...n-models/subscribe-system-environment-variable-changes.md
+133
-0
未找到文件。
zh-cn/application-dev/application-models/Readme-CN.md
浏览文件 @
4c80388d
...
...
@@ -35,6 +35,7 @@
-
[
流转概述
](
inter-device-interaction-hop-overview.md
)
-
[
跨端迁移(仅对系统应用开放)
](
hop-cross-device-migration.md
)
-
[
多端协同(仅对系统应用开放)
](
hop-multi-device-collaboration.md
)
-
[
订阅系统环境变量的变化
](
subscribe-system-environment-variable-changes.md
)
-
进程间通信
-
[
进程模型
](
process-model-stage.md
)
-
公共事件
...
...
zh-cn/application-dev/application-models/subscribe-system-environment-variable-changes.md
0 → 100644
浏览文件 @
4c80388d
# 订阅系统环境变量的变化
在应用程序运行期间,设备的系统配置(例如系统的语言环境、屏幕方向等)可能会发生变化。例如,用户更改系统语言设置时,应用程序可以自动根据新的语言设置更新用户界面的语言;当用户将设备旋转到横屏或者竖屏时,应用程序可以重新布局用户界面,以适应屏幕方向和尺寸。
系统配置的变化通常由“设置”中的选项或“控制中心”中的图标触发。订阅系统环境变量变化,可以使应用程序更加智能地响应系统环境变化,从而提供更好的用户体验。查看当前支持订阅变化的系统环境变量,请参见
[
Configuration
](
../reference/apis/js-apis-app-ability-configuration.md
)
。
基于OpenHarmony应用模型,可以通过以下几种方式来实现订阅系统环境变量的变化。
-
[
使用ApplicationContext订阅回调
](
#使用applicationcontext订阅回调
)
-
[
在AbilityStage组件容器中订阅回调
](
#在abilitystage组件容器中订阅回调
)
-
[
在UIAbility组件中订阅回调
](
#在uiability组件中订阅回调
)
## 使用ApplicationContext订阅回调
[
ApplicationContext
](
../reference/apis/js-apis-inner-application-applicationContext.md
)
提供了注册回调函数以订阅系统环境变量的变化,并且可以通过调用相应的方法来撤销该回调。这有助于在资源不再需要时释放相关资源,从而提高系统的可靠性和性能。
1.
使用
[
ApplicationContext.on()
](
../reference/apis/js-apis-inner-application-applicationContext.md#applicationcontextontype-environment-callback-environmentcallback
)
方法订阅系统环境变量的变化,以便应用程序可以动态响应这些变化。例如,可以使用该方法来监测系统语言的变化。
```
ts
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
let
callbackId
:
number
;
// 注册订阅系统环境变化的ID
let
systemLanguage
:
string
;
// 系统当前语言
export
default
class
EntryAbility
extends
UIAbility
{
onCreate
(
want
,
launchParam
)
{
// 1.获取ApplicationContext
let
applicationContext
=
this
.
context
.
getApplicationContext
();
systemLanguage
=
this
.
context
.
config
.
language
;
// 获取系统当前语言
// 2.通过applicationContext订阅环境变量变化
let
environmentCallback
=
{
onConfigurationUpdated
(
newConfig
)
{
console
.
info
(
`onConfigurationUpdated newConfig:
${
JSON
.
stringify
(
newConfig
)}
`
);
if
(
systemLanguage
!==
newConfig
.
language
)
{
console
.
info
(
`systemLanguage from
${
systemLanguage
}
changed to
${
newConfig
.
language
}
`
);
}
},
onMemoryLevel
(
level
)
{
console
.
info
(
`onMemoryLevel level:
${
level
}
`
);
}
}
callbackId
=
applicationContext
.
on
(
'
environment
'
,
environmentCallback
);
}
// ...
}
```
2.
在资源使用完成之后,可以通过调用
[
ApplicationContext.off()
](
../reference/apis/js-apis-inner-application-applicationContext.md#applicationcontextofftype-environment-callbackid-number-callback-asynccallback
)
方法释放相关资源。
```
ts
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
let
callbackId
:
number
;
// 注册订阅系统环境变化的ID
export
default
class
EntryAbility
extends
UIAbility
{
// ...
onDestroy
()
{
let
applicationContext
=
this
.
context
.
getApplicationContext
();
applicationContext
.
off
(
'
environment
'
,
callbackId
);
}
}
```
## 在AbilityStage组件容器中订阅回调
使用
[
AbilityStage.onConfigurationUpdate()
](
../reference/apis/js-apis-app-ability-abilityStage.md#abilitystageonconfigurationupdate
)
回调方法订阅系统环境变量的变化。当系统环境变量发生变化时,会调用该回调方法。在该方法中,通过
[
Configuration
](
../reference/apis/js-apis-app-ability-configuration.md
)
对象获取最新的系统环境配置信息,而无需重启UIAbility。可以进行相应的界面适配等操作,从而提高系统的灵活性和可维护性。
> **说明:**
>
> - DevEco Studio默认工程中未自动生成AbilityStage,AbilityStage文件的创建请参见[AbilityStage组件容器](abilitystage.md)。
> - 当使用回调方法订阅系统环境变量的变化时,该回调方法会随着[AbilityStage](../reference/apis/js-apis-app-ability-abilityStage.md)的生命周期而存在,在[Module](../reference/apis/js-apis-app-module-module.md)销毁时一并销毁。
例如,在
[
AbilityStage.onConfigurationUpdate()
](
../reference/apis/js-apis-app-ability-abilityStage.md#abilitystageonconfigurationupdate
)
回调方法中实现监测系统语言的变化。
```
ts
import
AbilityStage
from
'
@ohos.app.ability.AbilityStage
'
;
let
systemLanguage
:
string
;
// 系统当前语言
export
default
class
MyAbilityStage
extends
AbilityStage
{
onCreate
()
{
systemLanguage
=
this
.
context
.
config
.
language
;
// Module首次加载时,获取系统当前语言
console
.
info
(
`systemLanguage is
${
systemLanguage
}
`
);
}
onConfigurationUpdate
(
newConfig
)
{
console
.
info
(
`onConfigurationUpdated systemLanguage is
${
systemLanguage
}
, newConfig:
${
JSON
.
stringify
(
newConfig
)}
`
);
if
(
systemLanguage
!==
newConfig
.
language
)
{
console
.
info
(
`systemLanguage from
${
systemLanguage
}
changed to
${
newConfig
.
language
}
`
);
systemLanguage
=
newConfig
.
language
;
// 将变化之后的系统语言保存,作为下一次变化前的系统语言
}
}
}
```
## 在UIAbility组件中订阅回调
也可以使用UIAbility.onConfigurationUpdate()回调方法订阅系统环境变量的变化。当系统环境变量发生变化时,会调用该回调方法。在该方法中,通过
[
Configuration
](
../reference/apis/js-apis-app-ability-configuration.md
)
对象获取最新的系统环境配置信息,而无需重启UIAbility。
> **说明:**
>
> 当使用回调方法订阅系统环境变量的变化时,该回调方法会随着UIAbility的生命周期而存在,在UIAbility销毁时一并销毁。
例如,在UIAbility.onConfigurationUpdate()回调方法中实现监测系统语言的变化。
```
ts
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
let
systemLanguage
:
string
;
// 系统当前语言
export
default
class
EntryAbility
extends
UIAbility
{
onCreate
(
want
,
launchParam
)
{
systemLanguage
=
this
.
context
.
config
.
language
;
// UIAbility实例首次加载时,获取系统当前语言
console
.
info
(
`systemLanguage is
${
systemLanguage
}
`
);
}
onConfigurationUpdate
(
newConfig
)
{
console
.
info
(
`onConfigurationUpdated systemLanguage is
${
systemLanguage
}
, newConfig:
${
JSON
.
stringify
(
newConfig
)}
`
);
if
(
systemLanguage
!==
newConfig
.
language
)
{
console
.
info
(
`systemLanguage from
${
systemLanguage
}
changed to
${
newConfig
.
language
}
`
);
systemLanguage
=
newConfig
.
language
;
// 将变化之后的系统语言保存,作为下一次变化前的系统语言
}
}
// ...
}
```
\ No newline at end of file
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录