diff --git a/zh-cn/application-dev/reference/apis/Readme-CN.md b/zh-cn/application-dev/reference/apis/Readme-CN.md index fbc6674bdc21d1ff7453ced7517387c39fc458d0..60ecacedebfd44af020e088cced1faeaf12ce7a3 100755 --- a/zh-cn/application-dev/reference/apis/Readme-CN.md +++ b/zh-cn/application-dev/reference/apis/Readme-CN.md @@ -103,7 +103,7 @@ - [MissionSnapshot](js-apis-inner-application-missionSnapshot.md) - [ProcessData](js-apis-inner-application-processData.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) - [UIAbilityContext](js-apis-inner-application-uiAbilityContext.md) - [shellCmdResult](js-apis-inner-application-shellCmdResult.md) diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md index 8617e4935653ad6d8d91a8e1864eb0acd4f38113..2a75a19e7ffee7e93200d0b37f0dacaf3db95bde 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md @@ -110,6 +110,8 @@ class MyAbility extends UIAbility { **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core +**系统API**: 此接口为系统接口,三方应用不支持调用。 + | 名称 | 值 | 说明 | | --- | --- | --- | | WINDOW_MODE_UNDEFINED | 0 | 未定义窗口模式。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md index fc5a920311a1640666ba70a3230c3fde4e434cf5..088c589a0e7224093f2ab63f83f3966596843de9 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md @@ -24,7 +24,7 @@ Ability的状态,该类型为枚举,可配合[AbilityRunningInfo](js-apis-in | 名称 | 值 | 说明 | | -------- | -------- | -------- | | INITIAL | 0 | 表示ability为初始化状态。| -| ACTIVE | 2 | 表示ability为获焦状态。 | +| FOCUS | 2 | 表示ability为获焦状态。 | | FOREGROUND | 9 | 表示ability为前台状态。 | | BACKGROUND | 10 | 表示ability为后台状态。 | | FOREGROUNDING | 11 | 表示ability为前台调度中状态。 | @@ -143,7 +143,7 @@ try { getAbilityRunningInfos(callback: AsyncCallback\>): void -获取Ability运行相关信息(callback形式)。 +获取UIAbility运行相关信息(callback形式)。 **需要权限**: ohos.permission.GET_RUNNING_INFO @@ -186,7 +186,7 @@ try { getAbilityRunningInfos(): Promise\> -获取Ability运行相关信息(Promise形式)。 +获取UIAbility运行相关信息(Promise形式)。 **需要权限**: ohos.permission.GET_RUNNING_INFO diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md index 9141823525d026d73a9b29b79bbd1c6d7d5de11d..5ad46e71c8f6c84d9369f7e6fb6bcb4605459a8b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md @@ -224,9 +224,9 @@ appManager.getAppMemorySize((err, data) => { }) ``` -## appManager.getProcessRunningInformation +## appManager.getRunningProcessInformation -getProcessRunningInformation(): Promise\>; +getRunningProcessInformation(): Promise\>; 获取有关运行进程的信息。 @@ -234,13 +234,11 @@ getProcessRunningInformation(): Promise\>; **系统能力**:SystemCapability.Ability.AbilityRuntime.Core -**系统API**: 此接口为系统接口,三方应用不支持调用。 - **返回值:** | 类型 | 说明 | | -------- | -------- | -| Promise\> | 以Promise方式返回接口运行结果及有关运行进程的信息,可进行错误处理或其他自定义处理。 | +| Promise\> | 以Promise方式返回接口运行结果及有关运行进程的信息,可进行错误处理或其他自定义处理。 | **错误码**: @@ -255,16 +253,16 @@ getProcessRunningInformation(): Promise\>; ```ts import appManager from '@ohos.app.ability.appManager'; -appManager.getProcessRunningInformation().then((data) => { - console.log("The process running information is:" + JSON.stringify(data)); +appManager.getRunningProcessInformation().then((data) => { + console.log("The running process information is:" + JSON.stringify(data)); }).catch((error) => { console.log("error:" + JSON.stringify(error)); }); ``` -## appManager.getProcessRunningInformation9+ +## appManager.getRunningProcessInformation9+ -getProcessRunningInformation(callback: AsyncCallback\>): void; +getRunningProcessInformation(callback: AsyncCallback\>): void; 获取有关运行进程的信息。 @@ -272,13 +270,11 @@ getProcessRunningInformation(callback: AsyncCallback\> | 以回调方式返回接口运行结果及有关运行进程的信息,可进行错误处理或其他自定义处理。 | +|AsyncCallback\> | 以回调方式返回接口运行结果及有关运行进程的信息,可进行错误处理或其他自定义处理。 | **错误码**: @@ -293,9 +289,9 @@ getProcessRunningInformation(callback: AsyncCallback\ { +appManager.getRunningProcessInformation((err, data) => { if (err && err.code !== 0) { - console.log("getProcessRunningInformation fail, err: " + JSON.stringify(err)); + console.log("getRunningProcessInformation fail, err: " + JSON.stringify(err)); } else { console.log("The process running information is:" + JSON.stringify(data)); } diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-startOptions.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-startOptions.md index f1bb4be5f7e464cbd2cda2e033ec791a9a4a4a44..21b53ffa610f263a90f41bc1be77780d64c18ac2 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-startOptions.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-startOptions.md @@ -18,6 +18,8 @@ import StartOptions from '@ohos.app.ability.StartOptions'; **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core +**系统API**: 此接口为系统接口,三方应用不支持调用。 + | 名称 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | [windowMode](js-apis-app-ability-abilityConstant.md#abilityconstantwindowmode) | number | 否 | 窗口模式。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-appManager.md b/zh-cn/application-dev/reference/apis/js-apis-application-appManager.md index a25e60f928746f38fd5213260d49b029c5a2e9c8..4cfc8409ae07629e4fa346ef3180887eab14c98d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-appManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-appManager.md @@ -160,7 +160,7 @@ getProcessRunningInfos(): Promise\>; 获取有关运行进程的信息。 -> 从 API Version 9 开始废弃,建议使用[appManager.getProcessRunningInformation9+](js-apis-app-ability-appManager.md#appmanagergetprocessrunninginformation9)替代。 +> 从 API Version 9 开始废弃,建议使用[appManager.getRunningProcessInformation9+](js-apis-app-ability-appManager.md#appmanagergetrunningprocessinformation)替代。 **需要权限**:ohos.permission.GET_RUNNING_INFO @@ -188,7 +188,7 @@ getProcessRunningInfos(callback: AsyncCallback\>): vo 获取有关运行进程的信息。 -> 从 API Version 9 开始废弃,建议使用[appManager.getProcessRunningInformation9+](js-apis-app-ability-appManager.md#appmanagergetprocessrunninginformation9-1)替代。 +> 从 API Version 9 开始废弃,建议使用[appManager.getRunningProcessInformation9+](js-apis-app-ability-appManager.md#appmanagergetrunningprocessinformation9)替代。 **需要权限**:ohos.permission.GET_RUNNING_INFO @@ -209,6 +209,91 @@ getProcessRunningInfos(callback: AsyncCallback\>): vo }) ``` +## appManager.registerApplicationStateObserver8+ + +registerApplicationStateObserver(observer: ApplicationStateObserver): number; + +注册全部应用程序状态观测器。 + +**需要权限**:ohos.permission.RUNNING_STATE_OBSERVER + +**系统能力**:SystemCapability.Ability.AbilityRuntime.Core + +**系统API**:该接口为系统接口,三方应用不支持调用。 + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| observer | [ApplicationStateObserver](js-apis-inner-application-applicationStateObserver.md) | 是 | 返回观察者的数字代码。 | + +**示例:** + + ```ts + var applicationStateObserver = { + onForegroundApplicationChanged(appStateData) { + console.log('------------ onForegroundApplicationChanged -----------', appStateData); + }, + onAbilityStateChanged(abilityStateData) { + console.log('------------ onAbilityStateChanged -----------', abilityStateData); + }, + onProcessCreated(processData) { + console.log('------------ onProcessCreated -----------', processData); + }, + onProcessDied(processData) { + console.log('------------ onProcessDied -----------', processData); + }, + onProcessStateChanged(processData) { + console.log('------------ onProcessStateChanged -----------', processData); + } + } + const observerCode = appManager.registerApplicationStateObserver(applicationStateObserver); + console.log('-------- observerCode: ---------', observerCode); + ``` + +## appManager.registerApplicationStateObserver9+ + +registerApplicationStateObserver(observer: ApplicationStateObserver, bundleNameList: Array\): number; + +注册指定应用程序状态观测器。 + +**需要权限**:ohos.permission.RUNNING_STATE_OBSERVER + +**系统能力**:SystemCapability.Ability.AbilityRuntime.Core + +**系统API**:该接口为系统接口,三方应用不支持调用。 + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| observer | [ApplicationStateObserver](js-apis-inner-application-applicationStateObserver.md) | 是 | 返回观察者的数字代码。 | +| bundleNameList | Array | 是 | 表示需要注册监听的bundleName数组。最大值128。 | + +**示例:** + + ```ts + var applicationStateObserver = { + onForegroundApplicationChanged(appStateData) { + console.log('------------ onForegroundApplicationChanged -----------', appStateData); + }, + onAbilityStateChanged(abilityStateData) { + console.log('------------ onAbilityStateChanged -----------', abilityStateData); + }, + onProcessCreated(processData) { + console.log('------------ onProcessCreated -----------', processData); + }, + onProcessDied(processData) { + console.log('------------ onProcessDied -----------', processData); + }, + onProcessStateChanged(processData) { + console.log('------------ onProcessStateChanged -----------', processData); + } + } + var bundleNameList = ['bundleName1', 'bundleName2']; + const observerCode = appManager.registerApplicationStateObserver(applicationStateObserver, bundleNameList); + console.log('-------- observerCode: ---------', observerCode); + ``` ## appManager.unregisterApplicationStateObserver8+ unregisterApplicationStateObserver(observerId: number, callback: AsyncCallback\): void; diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInformation.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-processInformation.md similarity index 67% rename from zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInformation.md rename to zh-cn/application-dev/reference/apis/js-apis-inner-application-processInformation.md index a005d33ca82dee9b23e210d5ad6a6c1f7952d983..9977c5a7716a37bead7b9e6ab9f9065fd1730f8b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInformation.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-processInformation.md @@ -1,6 +1,6 @@ -# ProcessRunningInformation +# ProcessInformation -ProcessRunningInformation模块提供对进程运行信息进行查询的能力。 +ProcessInformation模块提供对进程运行信息进行查询的能力。 > **说明:** > @@ -8,12 +8,12 @@ ProcessRunningInformation模块提供对进程运行信息进行查询的能力 ## 使用说明 -通过appManager的[getProcessRunningInformation](js-apis-application-appManager.md#appmanagergetprocessrunninginformation9)来获取。 +通过appManager的[getRunningProcessInformation](js-apis-app-ability-appManager.md#appmanagergetrunningprocessinformation9)来获取。 ```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)); }); ``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInfo.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInfo.md index d28e3d0eb888323684bab4865ad5c0c9011df71d..b9d56003b638b673421f44c6d6a75ebaa978bcf6 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInfo.md @@ -3,7 +3,7 @@ 本模块提供对进程运行信息进行查询的能力。 > **说明:** -> - 本模块接口从API version 9 开始废弃,建议使用[ProcessRunningInformation9+](js-apis-inner-application-processRunningInformation.md)替代。 +> - 本模块接口从API version 9 开始废弃,建议使用[ProcessInformation9+](js-apis-inner-application-processInformation.md)替代。 > - 本模块首批接口从API version 8 开始支持。 ## 属性