• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 # AppStateData
2
3定义应用状态信息,可以通过[getForegroundApplications](js-apis-app-ability-appManager.md#appmanagergetforegroundapplications)获取当前应用的相关信息。
4
5> **说明:**
6>
7> 本模块首批接口从API version 8 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8
9## 导入模块
10
11```ts
12import appManager from '@ohos.app.ability.appManager';
13```
14
15## 属性
16
17**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
18
19**系统API**:本模块被标记为@systemapi,对三方应用隐藏
20
21| 名称                      | 类型   | 必填  | 说明       |
22| ------------------------- | ------ | ---- | --------- |
23| bundleName<sup>8+</sup>   | string | 否   | Bundle名称。 |
24| uid<sup>8+</sup>          | number | 否   | 应用程序的uid。   |
25| state<sup>8+</sup>        | number | 否   | 应用状态。<br>0:初始化状态,应用正在初始化<br>1:就绪状态,应用已初始化完毕<br>2:前台状态,应用位于前台<br>3:获焦状态。(预留状态,当前暂不支持)<br>4:后台状态,应用位于后台<br>5:退出状态,应用已退出 |
26
27**示例:**
28
29```ts
30import appManager from '@ohos.app.ability.appManager';
31
32function getForegroundAppInfos() {
33    appManager.getForegroundApplications((error, data) => {
34        if (error) {
35            console.log(`getForegroundApplications failed, error.code: ${JSON.stringify(error.code)}, error.message: ${JSON.stringify(error.message)}`);
36            return;
37        }
38        for (let i = 0; i < data.length; i++) {
39            let appStateData = data[i];
40            console.log(`appStateData.bundleName: ${appStateData.bundleName}`);
41            console.log(`appStateData.uid: ${appStateData.uid}`);
42            console.log(`appStateData.state: ${appStateData.state}`);
43        }
44    });
45}
46```
47