提交 abab2f21 编写于 作者: D dy_study

IssueNo:#I6CMT7

Description: 更新元能力AbilityManager和AppManager相关接口资料
Sig:SIG_ApplicationFramework
Feature or Bugfix:Bugfix
Binary Source: No
Signed-off-by: Ndy_study <dingyao5@huawei.com>
Change-Id: Idc508e1dfd2afdfb96e4bda7aa654957633bcfc1
上级 6d46b894
...@@ -109,7 +109,7 @@ ...@@ -109,7 +109,7 @@
- [MissionSnapshot](js-apis-inner-application-missionSnapshot.md) - [MissionSnapshot](js-apis-inner-application-missionSnapshot.md)
- [ProcessData](js-apis-inner-application-processData.md) - [ProcessData](js-apis-inner-application-processData.md)
- [ProcessRunningInfo](js-apis-inner-application-processRunningInfo.md) - [ProcessRunningInfo](js-apis-inner-application-processRunningInfo.md)
- [ProcessRunningInformation](js-apis-inner-application-processRunningInformation.md) - [ProcessInformation](js-apis-inner-application-processInformation.md)
- [ServiceExtensionContext](js-apis-inner-application-serviceExtensionContext.md) - [ServiceExtensionContext](js-apis-inner-application-serviceExtensionContext.md)
- [UIAbilityContext](js-apis-inner-application-uiAbilityContext.md) - [UIAbilityContext](js-apis-inner-application-uiAbilityContext.md)
- [shellCmdResult](js-apis-inner-application-shellCmdResult.md) - [shellCmdResult](js-apis-inner-application-shellCmdResult.md)
......
...@@ -110,6 +110,8 @@ class MyAbility extends UIAbility { ...@@ -110,6 +110,8 @@ class MyAbility extends UIAbility {
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
**系统API**: 此接口为系统接口,三方应用不支持调用。
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| --- | --- | --- | | --- | --- | --- |
| WINDOW_MODE_UNDEFINED | 0 | 未定义窗口模式。 | | WINDOW_MODE_UNDEFINED | 0 | 未定义窗口模式。 |
......
...@@ -24,6 +24,7 @@ Ability的状态,该类型为枚举,可配合[AbilityRunningInfo](js-apis-in ...@@ -24,6 +24,7 @@ Ability的状态,该类型为枚举,可配合[AbilityRunningInfo](js-apis-in
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| -------- | -------- | -------- | | -------- | -------- | -------- |
| INITIAL | 0 | 表示ability为初始化状态。| | INITIAL | 0 | 表示ability为初始化状态。|
| FOCUS | 2 | 表示ability为获焦状态。 |
| FOREGROUND | 9 | 表示ability为前台状态。 | | FOREGROUND | 9 | 表示ability为前台状态。 |
| BACKGROUND | 10 | 表示ability为后台状态。 | | BACKGROUND | 10 | 表示ability为后台状态。 |
| FOREGROUNDING | 11 | 表示ability为前台调度中状态。 | | FOREGROUNDING | 11 | 表示ability为前台调度中状态。 |
...@@ -142,7 +143,7 @@ try { ...@@ -142,7 +143,7 @@ try {
getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): void getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): void
获取Ability运行相关信息(callback形式)。 获取UIAbility运行相关信息(callback形式)。
**需要权限**: ohos.permission.GET_RUNNING_INFO **需要权限**: ohos.permission.GET_RUNNING_INFO
...@@ -185,7 +186,7 @@ try { ...@@ -185,7 +186,7 @@ try {
getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>> getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>>
获取Ability运行相关信息(Promise形式)。 获取UIAbility运行相关信息(Promise形式)。
**需要权限**: ohos.permission.GET_RUNNING_INFO **需要权限**: ohos.permission.GET_RUNNING_INFO
......
...@@ -224,9 +224,9 @@ appManager.getAppMemorySize((err, data) => { ...@@ -224,9 +224,9 @@ appManager.getAppMemorySize((err, data) => {
}) })
``` ```
## appManager.getProcessRunningInformation ## appManager.getRunningProcessInformation
getProcessRunningInformation(): Promise\<Array\<ProcessRunningInformation>>; getRunningProcessInformation(): Promise\<Array\<ProcessInformation>>;
获取有关运行进程的信息。 获取有关运行进程的信息。
...@@ -234,13 +234,11 @@ getProcessRunningInformation(): Promise\<Array\<ProcessRunningInformation>>; ...@@ -234,13 +234,11 @@ getProcessRunningInformation(): Promise\<Array\<ProcessRunningInformation>>;
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core **系统能力**:SystemCapability.Ability.AbilityRuntime.Core
**系统API**: 此接口为系统接口,三方应用不支持调用。
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise\<Array\<[ProcessRunningInformation](js-apis-inner-application-processRunningInformation.md)>> | 以Promise方式返回接口运行结果及有关运行进程的信息,可进行错误处理或其他自定义处理。 | | Promise\<Array\<[ProcessInformation](js-apis-inner-application-processInformation.md)>> | 以Promise方式返回接口运行结果及有关运行进程的信息,可进行错误处理或其他自定义处理。 |
**错误码** **错误码**
...@@ -255,16 +253,16 @@ getProcessRunningInformation(): Promise\<Array\<ProcessRunningInformation>>; ...@@ -255,16 +253,16 @@ getProcessRunningInformation(): Promise\<Array\<ProcessRunningInformation>>;
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
appManager.getProcessRunningInformation().then((data) => { appManager.getRunningProcessInformation().then((data) => {
console.log("The process running information is:" + JSON.stringify(data)); console.log("The running process information is:" + JSON.stringify(data));
}).catch((error) => { }).catch((error) => {
console.log("error:" + JSON.stringify(error)); console.log("error:" + JSON.stringify(error));
}); });
``` ```
## appManager.getProcessRunningInformation<sup>9+</sup> ## appManager.getRunningProcessInformation<sup>9+</sup>
getProcessRunningInformation(callback: AsyncCallback\<Array\<ProcessRunningInformation>>): void; getRunningProcessInformation(callback: AsyncCallback\<Array\<ProcessInformation>>): void;
获取有关运行进程的信息。 获取有关运行进程的信息。
...@@ -272,13 +270,11 @@ getProcessRunningInformation(callback: AsyncCallback\<Array\<ProcessRunningInfor ...@@ -272,13 +270,11 @@ getProcessRunningInformation(callback: AsyncCallback\<Array\<ProcessRunningInfor
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core **系统能力**:SystemCapability.Ability.AbilityRuntime.Core
**系统API**: 此接口为系统接口,三方应用不支持调用。
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
|AsyncCallback\<Array\<[ProcessRunningInformation](js-apis-inner-application-processRunningInformation.md)>> | 以回调方式返回接口运行结果及有关运行进程的信息,可进行错误处理或其他自定义处理。 | |AsyncCallback\<Array\<[ProcessInformation](js-apis-inner-application-processInformation.md)>> | 以回调方式返回接口运行结果及有关运行进程的信息,可进行错误处理或其他自定义处理。 |
**错误码** **错误码**
...@@ -293,9 +289,9 @@ getProcessRunningInformation(callback: AsyncCallback\<Array\<ProcessRunningInfor ...@@ -293,9 +289,9 @@ getProcessRunningInformation(callback: AsyncCallback\<Array\<ProcessRunningInfor
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
appManager.getProcessRunningInformation((err, data) => { appManager.getRunningProcessInformation((err, data) => {
if (err.code !== 0) { if (err.code !== 0) {
console.log("getProcessRunningInformation faile, err: " + JSON.stringify(err)); console.log("getRunningProcessInformation faile, err: " + JSON.stringify(err));
} else { } else {
console.log("The process running information is:" + JSON.stringify(data)); console.log("The process running information is:" + JSON.stringify(data));
} }
......
...@@ -18,7 +18,9 @@ import StartOptions from '@ohos.app.ability.StartOptions'; ...@@ -18,7 +18,9 @@ import StartOptions from '@ohos.app.ability.StartOptions';
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
**系统API**: 此接口为系统接口,三方应用不支持调用。
| 名称 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| [windowMode](js-apis-application-abilityConstant.md#abilityconstantwindowmode) | number | 否 | 窗口模式。 | | [windowMode](js-apis-app-ability-abilityConstant.md#abilityconstantwindowmode) | number | 否 | 窗口模式。 |
| displayId | number | 否 | 显示ID。 | | displayId | number | 否 | 显示ID。 |
...@@ -161,7 +161,7 @@ getProcessRunningInfos(): Promise\<Array\<ProcessRunningInfo>>; ...@@ -161,7 +161,7 @@ getProcessRunningInfos(): Promise\<Array\<ProcessRunningInfo>>;
获取有关运行进程的信息。 获取有关运行进程的信息。
> 从 API Version 9 开始废弃,建议使用[appManager.getProcessRunningInformation<sup>9+</sup>](#appmanagergetprocessrunninginformation9)替代。 > 从 API Version 9 开始废弃,建议使用[appManager.getRunningProcessInformation<sup>9+</sup>](js-apis-app-ability-appManager.md#appmanagergetrunningprocessinformation)替代。
**需要权限**:ohos.permission.GET_RUNNING_INFO **需要权限**:ohos.permission.GET_RUNNING_INFO
...@@ -189,7 +189,7 @@ getProcessRunningInfos(callback: AsyncCallback\<Array\<ProcessRunningInfo>>): vo ...@@ -189,7 +189,7 @@ getProcessRunningInfos(callback: AsyncCallback\<Array\<ProcessRunningInfo>>): vo
获取有关运行进程的信息。 获取有关运行进程的信息。
> 从 API Version 9 开始废弃,建议使用[appManager.getProcessRunningInformation<sup>9+</sup>](#appmanagergetprocessrunninginformation9-1)替代。 > 从 API Version 9 开始废弃,建议使用[appManager.getRunningProcessInformation<sup>9+</sup>](js-apis-app-ability-appManager.md#appmanagergetrunningprocessinformation9)替代。
**需要权限**:ohos.permission.GET_RUNNING_INFO **需要权限**:ohos.permission.GET_RUNNING_INFO
...@@ -210,57 +210,6 @@ getProcessRunningInfos(callback: AsyncCallback\<Array\<ProcessRunningInfo>>): vo ...@@ -210,57 +210,6 @@ getProcessRunningInfos(callback: AsyncCallback\<Array\<ProcessRunningInfo>>): vo
}) })
``` ```
## appManager.getProcessRunningInformation<sup>9+</sup>
getProcessRunningInformation(): Promise\<Array\<ProcessRunningInformation>>;
获取有关运行进程的信息。
**需要权限**:ohos.permission.GET_RUNNING_INFO
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| Promise\<Array\<[ProcessRunningInformation](js-apis-inner-application-processRunningInformation.md)>> | 获取有关运行进程的信息。 |
**示例:**
```ts
app.getProcessRunningInformation().then((data) => {
console.log('success:' + JSON.stringify(data));
}).catch((error) => {
console.log('failed:' + JSON.stringify(error));
});
```
## appManager.getProcessRunningInformation<sup>9+</sup>
getProcessRunningInformation(callback: AsyncCallback\<Array\<ProcessRunningInformation>>): void;
获取有关运行进程的信息。
**需要权限**:ohos.permission.GET_RUNNING_INFO
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback\<Array\<[ProcessRunningInformation](js-apis-inner-application-processRunningInformation.md)>> | 是 | 获取有关运行进程的信息。 |
**示例:**
```ts
app.getProcessRunningInformation((err, data) => {
console.log('startAbility result failed :' + JSON.stringify(err));
console.log('startAbility result success:' + JSON.stringify(data));
})
```
## appManager.registerApplicationStateObserver<sup>8+</sup> ## appManager.registerApplicationStateObserver<sup>8+</sup>
registerApplicationStateObserver(observer: ApplicationStateObserver): number; registerApplicationStateObserver(observer: ApplicationStateObserver): number;
......
# ProcessRunningInformation # ProcessInformation
ProcessRunningInformation模块提供对进程运行信息进行设置和查询的能力。 ProcessInformation模块提供对进程运行信息进行设置和查询的能力。
> **说明:** > **说明:**
> >
...@@ -8,12 +8,12 @@ ProcessRunningInformation模块提供对进程运行信息进行设置和查询 ...@@ -8,12 +8,12 @@ ProcessRunningInformation模块提供对进程运行信息进行设置和查询
## 使用说明 ## 使用说明
通过appManager的[getProcessRunningInformation](js-apis-application-appManager.md#appmanagergetprocessrunninginformation9)来获取。 通过appManager的[getRunningProcessInformation](js-apis-app-ability-appManager.md#appmanagergetrunningprocessinformation9)来获取。
```ts ```ts
import appManager from '@ohos.application.appManager'; import appManager from '@ohos.app.ability.appManager';
appManager.getProcessRunningInformation((error, data) => { appManager.getRunningProcessInformation((error, data) => {
console.log("error: " + error.code + " data: " + JSON.stringify(data)); console.log("error: " + error.code + " data: " + JSON.stringify(data));
}); });
``` ```
......
...@@ -3,7 +3,7 @@ ...@@ -3,7 +3,7 @@
本模块提供对进程运行信息进行设置和查询的能力。 本模块提供对进程运行信息进行设置和查询的能力。
> **说明:** > **说明:**
> - 本模块接口从API version 9 开始废弃,建议使用[ProcessRunningInformation<sup>9+</sup>](js-apis-inner-application-processRunningInformation.md)替代。 > - 本模块接口从API version 9 开始废弃,建议使用[ProcessInformation<sup>9+</sup>](js-apis-inner-application-processInformation.md)替代。
> - 本模块首批接口从API version 8 开始支持。 > - 本模块首批接口从API version 8 开始支持。
## 属性 ## 属性
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册