From 57624f9f396480a57282fb22537245ab707651d9 Mon Sep 17 00:00:00 2001 From: l30047846 Date: Mon, 10 Jul 2023 15:47:01 +0800 Subject: [PATCH] =?UTF-8?q?=E8=BF=9B=E7=A8=8B=E5=86=85=E5=AD=98=E4=BF=A1?= =?UTF-8?q?=E6=81=AF=E6=8E=A5=E5=8F=A3=E5=AF=B9=E5=A4=96=E8=B5=84=E6=96=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: l30047846 --- .../apis/js-apis-app-ability-appManager.md | 280 ++++++++++++++++++ 1 file changed, 280 insertions(+) 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 31e7395f99..f57aa303a7 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 @@ -1043,6 +1043,286 @@ try { } ``` +## appManager.getProcessMemoryByPid10+ + +getProcessMemoryByPid(pid: number, callback: AsyncCallback\); + +通过pid查询对应进程的内存大小。 + +**系统能力**：SystemCapability.Ability.AbilityRuntime.Core + +**系统API**：该接口为系统接口，三方应用不支持调用。 + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| pid | number | 是 | 表示进程id。 | +| callback | AsyncCallback\ | 是 | 以回调方式返回接口运行结果及进程内存大小（单位KB），可进行错误处理或其他自定义处理。 | + +**错误码**： + +| 错误码ID | 错误信息 | +| ------- | -------- | +| 16000050 | Internal error. | + +以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 + +**示例：** + +```ts +import appManager from '@ohos.app.ability.appManager'; + +let pid = 0; +function getProcessMemoryByPidCallback(err, data) { + if (err) { + console.error('getProcessMemoryByPidCallback fail, err: ${JSON.stringify(err)}'); + } else { + console.log('getProcessMemoryByPidCallback success.'); + } +} +try { + appManager.getProcessMemoryByPid(pid, getProcessMemoryByPidCallback); +} catch (paramError) { + console.error('error: ${paramError.code}, ${paramError.message}'); +} +``` + +## appManager.getProcessMemoryByPid10+ + +getProcessMemoryByPid(pid: number): Promise\; + +通过pid查询对应进程的内存大小。 + +**系统能力**：SystemCapability.Ability.AbilityRuntime.Core + +**系统API**：该接口为系统接口，三方应用不支持调用。 + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| pid | number | 是 | 表示进程id。 | + +**返回值：** + +| 类型 | 说明 | +| -------- | -------- | +| Promise\ | 以Promise方式返回接口运行结果及进程内存大小（单位KB），可进行错误处理或其他自定义处理。 | + +**错误码**： + +| 错误码ID | 错误信息 | +| ------- | -------- | +| 16000050 | Internal error. | + +以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 + +**示例：** + +```ts +import appManager from '@ohos.app.ability.appManager'; + +let pid = 0; +try { + appManager.getProcessMemoryByPid(pid).then((data) => { + console.log('getProcessMemoryByPid success.'); + }).catch((err) => { + console.error('getProcessMemoryByPid fail, err: ${JSON.stringify(err)}'); + }); +} catch (paramError) { + console.error('error: ${paramError.code}, ${paramError.message}'); +} +``` + +## appManager.getRunningProcessInfoByBundleName10+ + +getRunningProcessInfoByBundleName(bundleName: string, callback: AsyncCallback\>); + +通过bundleName获取有关运行进程的信息。 + +**系统能力**：SystemCapability.Ability.AbilityRuntime.Core + +**系统API**：该接口为系统接口，三方应用不支持调用。 + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| bundleName | string | 是 | 表示Bundle名称。 | +| callback | AsyncCallback\> | 是 | 以回调方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。 | + +**错误码**： + +| 错误码ID | 错误信息 | +| ------- | -------- | +| 16000050 | Internal error. | + +以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 + +**示例：** + +```ts +import appManager from '@ohos.app.ability.appManager'; + +let bundleName = "bundleName"; +function getRunningProcessInfoByBundleNameCallback(err, data) { + if (err) { + console.error('getRunningProcessInfoByBundleNameCallback fail, err: ${JSON.stringify(err)}'); + } else { + console.log('getRunningProcessInfoByBundleNameCallback success.'); + } +} +try { + appManager.getRunningProcessInfoByBundleName(bundleName, getRunningProcessInfoByBundleNameCallback); +} catch (paramError) { + console.error('error: ${paramError.code}, ${paramError.message}'); +} +``` + +## appManager.getRunningProcessInfoByBundleName10+ + +getRunningProcessInfoByBundleName(bundleName: string): Promise\>; + +通过bundleName获取有关运行进程的信息。 + +**系统能力**：SystemCapability.Ability.AbilityRuntime.Core + +**系统API**：该接口为系统接口，三方应用不支持调用。 + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| bundleName | string | 是 | 表示Bundle名称。 | + +**返回值：** + +| 类型 | 说明 | +| -------- | -------- | +| Promise\> | 以Promise方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。 | + +**错误码**： + +| 错误码ID | 错误信息 | +| ------- | -------- | +| 16000050 | Internal error. | + +以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 + +**示例：** + +```ts +import appManager from '@ohos.app.ability.appManager'; + +let bundleName = "bundleName"; +try { + appManager.getRunningProcessInfoByBundleName(bundleName).then((data) => { + console.log('getRunningProcessInfoByBundleName success.'); + }).catch((err) => { + console.error('getRunningProcessInfoByBundleName fail, err: ${JSON.stringify(err)}'); + }); +} catch (paramError) { + console.error('error: ${paramError.code}, ${paramError.message}'); +} +``` + +## appManager.getRunningProcessInfoByBundleName10+ + +getRunningProcessInfoByBundleName(bundleName: string, userId: number, callback: AsyncCallback\>); + +通过bundleName和userId获取有关运行进程的信息。 + +**系统能力**：SystemCapability.Ability.AbilityRuntime.Core + +**系统API**：该接口为系统接口，三方应用不支持调用。 + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| bundleName | string | 是 | 表示Bundle名称。 | +| userId | number | 是 | 表示用户Id。 | +| callback | AsyncCallback\> | 是 | 以回调方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。 | + +**错误码**： + +| 错误码ID | 错误信息 | +| ------- | -------- | +| 16000050 | Internal error. | + +以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 + +**示例：** + +```ts +import appManager from '@ohos.app.ability.appManager'; + +let bundleName = "bundleName"; +let userId = 0; +function getRunningProcessInfoByBundleNameCallback(err, data) { + if (err) { + console.error('getRunningProcessInfoByBundleNameCallback fail, err: ${JSON.stringify(err)}'); + } else { + console.log('getRunningProcessInfoByBundleNameCallback success.'); + } +} +try { + appManager.getRunningProcessInfoByBundleName(bundleName, userId, getRunningProcessInfoByBundleNameCallback); +} catch (paramError) { + console.error('error: ${paramError.code}, ${paramError.message}'); +} +``` + +## appManager.getRunningProcessInfoByBundleName10+ + +getRunningProcessInfoByBundleName(bundleName: string, userId: number): Promise\>; + +通过bundleName和userId获取有关运行进程的信息。 + +**系统能力**：SystemCapability.Ability.AbilityRuntime.Core + +**系统API**：该接口为系统接口，三方应用不支持调用。 + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| bundleName | string | 是 | 表示Bundle名称。 | +| userId | number | 是 | 表示用户Id。 | + +**返回值：** + +| 类型 | 说明 | +| -------- | -------- | +| Promise\> | 以Promise方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。 | + +**错误码**： + +| 错误码ID | 错误信息 | +| ------- | -------- | +| 16000050 | Internal error. | + +以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 + +**示例：** + +```ts +import appManager from '@ohos.app.ability.appManager'; + +let bundleName = "bundleName"; +let userId = 0; +try { + appManager.getRunningProcessInfoByBundleName(bundleName, userId).then((data) => { + console.log('getRunningProcessInfoByBundleName success.'); + }).catch((err) => { + console.error('getRunningProcessInfoByBundleName fail, err: ${JSON.stringify(err)}'); + }); +} catch (paramError) { + console.error('error: ${paramError.code}, ${paramError.message}'); +} +``` + ## ApplicationState 应用状态，该类型为枚举，可配合[AbilityStateData](js-apis-inner-application-appStateData.md)返回相应的应用状态。 -- GitLab