应用上下文

导入模块

import app from '@system.app'

接口定义

方法

获取当前应用的上下文信息，返回一个 Manifest 对象，包含应用的基本信息，例如包名、版本号等。

方法

终止当前应用的运行。调用此方法后，应用将被关闭，用户需要重新启动应用才能继续使用。

注

该 API 未在所有平台上支持，可暂时使用 launch.exit() 方法作为替代。

方法

设置应用是否保持在前台显示，如果 options 参数中的 enable 属性为 true，则应用会试图保持在前台。

使用该方法需要在 manifest.json 文件中声明应用对 watch.permission.FOREGROUND_SERVICE 的权限。

该方法只是一个针对系统行为的提示，并不是强制性的，可能因用户操作或其他高优先级策略将应用切换到后台。使用该方法将应用保持在前台时，设备依然可以进入低功耗模式：

• 如果开启 AOD（Always on Display）模式，那么会降低 UI 刷新率。
• 否则，屏幕会在一段时间后关闭，但应用仍然保持在前台运行。

当设备进入低功耗模式后（包括关闭屏幕），前台应用依然会以较低的频率调度并执行，而不是完全休眠。因此可以用于导航或者健身类的应用。