HarmonyOS实战开发：@ohos.app.ability.appManager (appManager)

最新推荐文章于 2024-08-21 16:52:55 发布
最新推荐文章于 2024-08-21 16:52:55 发布
阅读量996 收藏 12
点赞数 10
分类专栏： 鸿蒙 文章标签： harmonyos 华为 鸿蒙系统 鸿蒙 android
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2401_84194030/article/details/138924037
版权

appManager模块提供App管理的能力，包括查询当前是否处于稳定性测试场景、查询是否为ram受限设备、获取应用程序的内存大小、获取有关运行进程的信息等。

说明：

本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import appManager from '@ohos.app.ability.appManager';

appManager.isRunningInStabilityTest

isRunningInStabilityTest(callback: AsyncCallback<boolean>): void

查询当前是否处于稳定性测试场景。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名类型必填说明
callbackAsyncCallback<boolean>是以回调方式返回接口运行结果及当前是否处于稳定性测试场景，可进行错误处理或其他自定义处理。true: 处于稳定性测试场景，false：处于非稳定性测试场景。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';

appManager.isRunningInStabilityTest((err, flag) => {
    if (err) {
        console.error(`isRunningInStabilityTest fail, err: ${JSON.stringify(err)}`);
    } else {
        console.log(`The result of isRunningInStabilityTest is: ${JSON.stringify(flag)}`);
    }
});

appManager.isRunningInStabilityTest

isRunningInStabilityTest(): Promise<boolean>

查询当前是否处于稳定性测试场景。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

返回值：

类型说明
Promise<boolean>以Promise方式返回接口运行结果及当前是否处于稳定性测试场景，可进行错误处理或其他自定义处理。true: 处于稳定性测试场景，false：处于非稳定性测试场景。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

appManager.isRunningInStabilityTest().then((flag) => {
    console.log(`The result of isRunningInStabilityTest is: ${JSON.stringify(flag)}`);
}).catch((error: BusinessError) => {
    console.error(`error: ${JSON.stringify(error)}`);
});

appManager.isRamConstrainedDevice

isRamConstrainedDevice(): Promise<boolean>;

查询是否为ram受限设备。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

返回值：

类型说明
Promise<boolean>以Promise方式返回接口运行结果及当前设备是否为ram受限设备，可进行错误处理或其他自定义处理。true：当前设备为ram受限设备，false：当前设备为非ram受限设备。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

appManager.isRamConstrainedDevice().then((data) => {
    console.log(`The result of isRamConstrainedDevice is: ${JSON.stringify(data)}`);
}).catch((error: BusinessError) => {
    console.error(`error: ${JSON.stringify(error)}`);
});

appManager.isRamConstrainedDevice

isRamConstrainedDevice(callback: AsyncCallback<boolean>): void;

查询是否为ram受限设备。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名类型必填说明
callbackAsyncCallback<boolean>是以回调方式返回接口运行结果及当前设备是否为ram受限设备，可进行错误处理或其他自定义处理。true：当前设备为ram受限设备，false：当前设备为非ram受限设备。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';

appManager.isRamConstrainedDevice((err, data) => {
    if (err) {
        console.error(`isRamConstrainedDevice fail, err: ${JSON.stringify(err)}`);
    } else {
        console.log(`The result of isRamConstrainedDevice is: ${JSON.stringify(data)}`);
    }
});

appManager.getAppMemorySize

getAppMemorySize(): Promise<number>;

获取应用程序的内存大小。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

返回值：

类型说明
Promise<number>以Promise方式返回接口运行结果及应用程序内存大小，可进行错误处理或其他自定义处理。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError} from '@ohos.base'

appManager.getAppMemorySize().then((data) => {
    console.log(`The size of app memory is: ${JSON.stringify(data)}`);
}).catch((error: BusinessError) => {
    console.error(`error: ${JSON.stringify(error)}`);
});

appManager.getAppMemorySize

getAppMemorySize(callback: AsyncCallback<number>): void;

获取应用程序的内存大小。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名类型必填说明
callbackAsyncCallback<number>是以回调方式返回接口运行结果及应用程序内存大小，可进行错误处理或其他自定义处理。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';

appManager.getAppMemorySize((err, data) => {
    if (err) {
        console.error(`getAppMemorySize fail, err: ${JSON.stringify(err)}`);
    } else {
        console.log(`The size of app memory is: ${JSON.stringify(data)}`);
    }
});

appManager.getRunningProcessInformation

getRunningProcessInformation(): Promise<Array<ProcessInformation>>;

获取运行进程的有关信息。如果申请了ohos.permission.GET_RUNNING_INFO权限可以获取所有运行进程信息，否则只能获取当前运行进程信息。

需要权限：ohos.permission.GET_RUNNING_INFO

系统能力：SystemCapability.Ability.AbilityRuntime.Core

返回值：

类型说明
Promise<Array<ProcessInformation>>以Promise方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

appManager.getRunningProcessInformation().then((data) => {
    console.log(`The running process information is: ${JSON.stringify(data)}`);
}).catch((error: BusinessError) => {
    console.error(`error: ${JSON.stringify(error)}`);
});

appManager.getRunningProcessInformation9+

getRunningProcessInformation(callback: AsyncCallback<Array<ProcessInformation>>): void;

获取运行进程的有关信息。如果申请了ohos.permission.GET_RUNNING_INFO权限可以获取所有运行进程信息，否则只能获取当前运行进程信息。

需要权限：ohos.permission.GET_RUNNING_INFO

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名类型必填说明
callbackAsyncCallback<Array<ProcessInformation>>是以回调方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';

appManager.getRunningProcessInformation((err, data) => {
    if (err) {
        console.error(`getRunningProcessInformation fail, err: ${JSON.stringify(err)}`);
    } else {
        console.log(`The process running information is: ${JSON.stringify(data)}`);
    }
});

appManager.isSharedBundleRunning10+

isSharedBundleRunning(bundleName: string, versionCode: number): Promise<boolean>;

检查共享库是否正在使用。使用Promise异步回调。

需要权限：ohos.permission.GET_RUNNING_INFO

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统接口：此接口为系统接口。

参数：

参数名类型必填说明
bundleNamestring是表示要查询的共享库包名。
versionCodenumber是表示要查询的共享库版本号。

返回值：

类型说明
Promise<boolean>Promise对象。返回true表示共享库正在使用，返回false表示共享库不在使用。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

const bundleName = "this is a bundleName";
const versionCode = 1;
appManager.isSharedBundleRunning(bundleName, versionCode).then((data) => {
    console.log(`The shared bundle running is: ${JSON.stringify(data)}`);
}).catch((error: BusinessError) => {
    console.error(`error: ${JSON.stringify(error)}`);
});

appManager.isSharedBundleRunning10+

isSharedBundleRunning(bundleName: string, versionCode: number, callback: AsyncCallback<boolean>): void;

检查共享库是否正在使用。使用callback异步回调。

需要权限：ohos.permission.GET_RUNNING_INFO

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统接口：此接口为系统接口。

参数：

参数名类型必填说明
bundleNamestring是表示要查询的共享库包名。
versionCodenumber是表示要查询的共享库版本号。
callbackAsyncCallback<boolean>>是回调函数。返回true表示共享库正在使用，返回false表示共享库不在使用。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';

const bundleName = "this is a bundleName";
const versionCode = 1;
appManager.isSharedBundleRunning(bundleName, versionCode, (err, data) => {
    if (err) {
        console.error(`err: ${JSON.stringify(err)}`);
    } else {
        console.log(`The shared bundle running is: ${JSON.stringify(data)}`);
    }
});

appManager.on

on(type: 'applicationState', observer: ApplicationStateObserver): number;

注册全部应用程序的状态观测器。

需要权限：ohos.permission.RUNNING_STATE_OBSERVER

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API：该接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
typestring是调用接口类型，固定填'applicationState'字符串。
observerApplicationStateObserver是应用状态观测器，用于观测应用的生命周期变化。

返回值：

类型说明
number已注册观测器的数字代码，可用于off接口取消注册观测器。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

let applicationStateObserver: appManager.ApplicationStateObserver = {
    onForegroundApplicationChanged(appStateData) {
        console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`);
    },
    onAbilityStateChanged(abilityStateData) {
        console.log(`[appManager] onAbilityStateChanged: ${JSON.stringify(abilityStateData)}`);
    },
    onProcessCreated(processData) {
        console.log(`[appManager] onProcessCreated: ${JSON.stringify(processData)}`);
    },
    onProcessDied(processData) {
        console.log(`[appManager] onProcessDied: ${JSON.stringify(processData)}`);
    },
    onProcessStateChanged(processData) {
        console.log(`[appManager] onProcessStateChanged: ${JSON.stringify(processData)}`);
    }
};
try {
    const observerId = appManager.on('applicationState', applicationStateObserver);
    console.log(`[appManager] observerCode: ${observerId}`);
} catch (paramError) {
    let code = (paramError as BusinessError).code;
    let message = (paramError as BusinessError).message;
    console.error(`[appManager] error: ${code}, ${message} `);
}

appManager.on

on(type: 'applicationState', observer: ApplicationStateObserver, bundleNameList: Array<string>): number;

注册指定应用程序的状态观测器。

需要权限：ohos.permission.RUNNING_STATE_OBSERVER

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API：该接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
typestring是调用接口类型，固定填'applicationState'字符串。
observerApplicationStateObserver是应用状态观测器，用于观测应用的生命周期变化。
bundleNameListArray<string>是表示需要注册监听的bundleName数组。最大值128。

返回值：

类型说明
number已注册观测器的数字代码，可用于off接口注销观测器。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

let applicationStateObserver: appManager.ApplicationStateObserver = {
    onForegroundApplicationChanged(appStateData) {
        console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`);
    },
    onAbilityStateChanged(abilityStateData) {
        console.log(`[appManager] onAbilityStateChanged: ${JSON.stringify(abilityStateData)}`);
    },
    onProcessCreated(processData) {
        console.log(`[appManager] onProcessCreated: ${JSON.stringify(processData)}`);
    },
    onProcessDied(processData) {
        console.log(`[appManager] onProcessDied: ${JSON.stringify(processData)}`);
    },
    onProcessStateChanged(processData) {
        console.log(`[appManager] onProcessStateChanged: ${JSON.stringify(processData)}`);
    }
};
let bundleNameList = ['bundleName1', 'bundleName2'];
try {
    const observerId = appManager.on('applicationState', applicationStateObserver, bundleNameList);
    console.log(`[appManager] observerCode: ${observerId}`);
} catch (paramError) {
    let code = (paramError as BusinessError).code;
    let message = (paramError as BusinessError).message;
    console.error(`[appManager] error: ${code}, ${message} `);
}

appManager.off

off(type: 'applicationState', observerId: number, callback: AsyncCallback<void>): void;

取消注册应用程序状态观测器。

需要权限：ohos.permission.RUNNING_STATE_OBSERVER

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API：该接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
typestring是调用接口类型，固定填'applicationState'字符串。
observerIdnumber是表示观测器的编号代码。
callbackAsyncCallback<void>是以回调方式返回接口运行结果，可进行错误处理或其他自定义处理。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

let observerId = 0;

// 1.注册应用状态监听器
let applicationStateObserver: appManager.ApplicationStateObserver = {
    onForegroundApplicationChanged(appStateData) {
        console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`);
    },
    onAbilityStateChanged(abilityStateData) {
        console.log(`[appManager] onAbilityStateChanged: ${JSON.stringify(abilityStateData)}`);
    },
    onProcessCreated(processData) {
        console.log(`[appManager] onProcessCreated: ${JSON.stringify(processData)}`);
    },
    onProcessDied(processData) {
        console.log(`[appManager] onProcessDied: ${JSON.stringify(processData)}`);
    },
    onProcessStateChanged(processData) {
        console.log(`[appManager] onProcessStateChanged: ${JSON.stringify(processData)}`);
    }
};
let bundleNameList = ['bundleName1', 'bundleName2'];
try {
    observerId = appManager.on('applicationState', applicationStateObserver, bundleNameList);
    console.log(`[appManager] observerCode: ${observerId}`);
} catch (paramError) {
    let code = (paramError as BusinessError).code;
    let message = (paramError as BusinessError).message;
    console.error(`[appManager] error: ${code}, ${message} `);
}

// 2.注销应用状态监听器
function unregisterApplicationStateObserverCallback(err: BusinessError) {
    if (err) {
        console.error(`unregisterApplicationStateObserverCallback fail, err: ${JSON.stringify(err)}`);
    } else {
        console.log('unregisterApplicationStateObserverCallback success.');
    }
}
try {
    appManager.off('applicationState', observerId, unregisterApplicationStateObserverCallback);
} catch (paramError) {
    let code = (paramError as BusinessError).code;
    let message = (paramError as BusinessError).message;
    console.error(`[appManager] error: ${code}, ${message} `);
}

appManager.off

off(type: 'applicationState', observerId: number): Promise<void>;

取消注册应用程序状态观测器。

需要权限：ohos.permission.RUNNING_STATE_OBSERVER

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API：该接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
typestring是调用接口类型，固定填'applicationState'字符串。
observerIdnumber是表示观测器的编号代码。

返回值：

类型说明
Promise<void>以Promise方式返回接口运行结果，可进行错误处理或其他自定义处理。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

let observerId = 0;

// 1.注册应用状态监听器
let applicationStateObserver: appManager.ApplicationStateObserver = {
    onForegroundApplicationChanged(appStateData) {
        console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`);
    },
    onAbilityStateChanged(abilityStateData) {
        console.log(`[appManager] onAbilityStateChanged: ${JSON.stringify(abilityStateData)}`);
    },
    onProcessCreated(processData) {
        console.log(`[appManager] onProcessCreated: ${JSON.stringify(processData)}`);
    },
    onProcessDied(processData) {
        console.log(`[appManager] onProcessDied: ${JSON.stringify(processData)}`);
    },
    onProcessStateChanged(processData) {
        console.log(`[appManager] onProcessStateChanged: ${JSON.stringify(processData)}`);
    }
};
let bundleNameList = ['bundleName1', 'bundleName2'];
try {
    observerId = appManager.on('applicationState', applicationStateObserver, bundleNameList);
} catch (paramError) {
    let code = (paramError as BusinessError).code;
    let message = (paramError as BusinessError).message;
    console.error(`[appManager] error: ${code}, ${message} `);
}
    
// 2.注销应用状态监听器
try {
    appManager.off('applicationState', observerId).then((data) => {
        console.log(`unregisterApplicationStateObserver success, data: ${JSON.stringify(data)}`);
    }).catch((err: BusinessError) => {
        console.error(`unregisterApplicationStateObserver fail, err: ${JSON.stringify(err)}`);
    });
} catch (paramError) {
    let code = (paramError as BusinessError).code;
    let message = (paramError as BusinessError).message;
    console.error(`[appManager] error: ${code}, ${message} `);
}

appManager.getForegroundApplications

getForegroundApplications(callback: AsyncCallback<Array<AppStateData>>): void;

获取当前所有前台应用的信息。该应用信息由AppStateData定义。

需要权限：ohos.permission.GET_RUNNING_INFO

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API：该接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
callbackAsyncCallback<Array<AppStateData>>是以回调方式方式返回接口运行结果及应用状态数据数组，可进行错误处理或其他自定义处理。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

function getForegroundApplicationsCallback(err: BusinessError, data: Array<appManager.AppStateData>) {
    if (err) {
        console.error(`getForegroundApplicationsCallback fail, err: ${JSON.stringify(err)}`);
    } else {
        console.log(`getForegroundApplicationsCallback success, data: ${JSON.stringify(data)}`);
    }
}
try {
    appManager.getForegroundApplications(getForegroundApplicationsCallback);
} catch (paramError) {
    let code = (paramError as BusinessError).code;
    let message = (paramError as BusinessError).message;
    console.error(`[appManager] error: ${code}, ${message} `);
}

appManager.getForegroundApplications

getForegroundApplications(): Promise<Array<AppStateData>>;

获取当前所有前台应用的信息。该应用信息由AppStateData定义。

需要权限：ohos.permission.GET_RUNNING_INFO

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API：该接口为系统接口，三方应用不支持调用。

返回值：

类型说明
Promise<Array<AppStateData>>返回前台进程应用程序的数组。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

appManager.getForegroundApplications().then((data) => {
    console.log(`getForegroundApplications success, data: ${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getForegroundApplications fail, err: ${JSON.stringify(err)}`);
});Copy to clipboardErrorCopied

appManager.killProcessWithAccount

killProcessWithAccount(bundleName: string, accountId: number): Promise<void>

切断account进程（Promise形式）。

说明：

当accountId为当前用户时，不需要校验ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS权限。

需要权限：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS, ohos.permission.CLEAN_BACKGROUND_PROCESSES

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API: 此接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
bundleNamestring是应用Bundle名称。
accountIdnumber是系统帐号的帐号ID，详情参考getCreatedOsAccountsCount。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

let bundleName = 'bundleName';
let accountId = 0;
try {
    appManager.killProcessWithAccount(bundleName, accountId).then(() => {
        console.log('killProcessWithAccount success');
    }).catch((err: BusinessError) => {
        console.error(`killProcessWithAccount fail, err: ${JSON.stringify(err)}`);
    });
} catch (paramError) {
    let code = (paramError as BusinessError).code;
    let message = (paramError as BusinessError).message;
    console.error(`[appManager] error: ${code}, ${message} `);
}

appManager.killProcessWithAccount

killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCallback<void>): void

切断account进程（callback形式）。

说明：

当accountId为当前用户时，不需要校验ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS权限。

需要权限：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS, ohos.permission.CLEAN_BACKGROUND_PROCESSES

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API: 此接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
bundleNamestring是应用Bundle名称。
accountIdnumber是系统帐号的帐号ID，详情参考getCreatedOsAccountsCount。
callbackAsyncCallback<void>是以回调方式返回接口运行结果，可进行错误处理或其他自定义处理。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

let bundleName = 'bundleName';
let accountId = 0;
function killProcessWithAccountCallback(err: BusinessError) {
    if (err) {
        console.error(`killProcessWithAccountCallback fail, err: ${JSON.stringify(err)}`);
    } else {
        console.log('killProcessWithAccountCallback success.');
    }
}
appManager.killProcessWithAccount(bundleName, accountId, killProcessWithAccountCallback);

appManager.killProcessesByBundleName

killProcessesByBundleName(bundleName: string, callback: AsyncCallback<void>);

通过Bundle名称终止进程。

需要权限：ohos.permission.CLEAN_BACKGROUND_PROCESSES

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API：该接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
bundleNamestring是表示Bundle名称。
callbackAsyncCallback<void>是以回调方式返回接口运行结果，可进行错误处理或其他自定义处理。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

let bundleName = 'bundleName';
function killProcessesByBundleNameCallback(err: BusinessError) {
    if (err) {
        console.error(`killProcessesByBundleNameCallback fail, err: ${JSON.stringify(err)}`);
    } else {
        console.log('killProcessesByBundleNameCallback success.');
    }
}
try {
    appManager.killProcessesByBundleName(bundleName, killProcessesByBundleNameCallback);
} catch (paramError) {
    let code = (paramError as BusinessError).code;
    let message = (paramError as BusinessError).message;
    console.error(`[appManager] error: ${code}, ${message} `);
}

appManager.killProcessesByBundleName

killProcessesByBundleName(bundleName: string): Promise<void>;

通过Bundle名称终止进程。

需要权限：ohos.permission.CLEAN_BACKGROUND_PROCESSES

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API：该接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
bundleNamestring是表示Bundle名称。

返回值：

类型说明
Promise<void>返回执行结果。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

let bundleName = 'bundleName';
try {
    appManager.killProcessesByBundleName(bundleName).then((data) => {
        console.log('killProcessesByBundleName success.');
    }).catch((err: BusinessError) => {
        console.error(`killProcessesByBundleName fail, err: ${JSON.stringify(err)}`);
    });
} catch (paramError) {
    let code = (paramError as BusinessError).code;
    let message = (paramError as BusinessError).message;
    console.error(`[appManager] error: ${code}, ${message} `);
}

appManager.clearUpApplicationData

clearUpApplicationData(bundleName: string, callback: AsyncCallback<void>);

通过Bundle名称清除应用数据。

需要权限：ohos.permission.CLEAN_APPLICATION_DATA

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API：该接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
bundleNamestring是表示Bundle名称。
callbackAsyncCallback<void>是以回调方式返回接口运行结果，可进行错误处理或其他自定义处理。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

let bundleName = 'bundleName';
function clearUpApplicationDataCallback(err: BusinessError) {
    if (err) {
        console.error(`clearUpApplicationDataCallback fail, err: ${JSON.stringify(err)}`);
    } else {
        console.log('clearUpApplicationDataCallback success.');
    }
}
try {
    appManager.clearUpApplicationData(bundleName, clearUpApplicationDataCallback);
} catch (paramError) {
    let code = (paramError as BusinessError).code;
    let message = (paramError as BusinessError).message;
    console.error(`[appManager] error: ${code}, ${message} `);
}

appManager.clearUpApplicationData

clearUpApplicationData(bundleName: string): Promise<void>;

通过Bundle名称清除应用数据。

需要权限：ohos.permission.CLEAN_APPLICATION_DATA

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API：该接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
bundleNamestring是表示Bundle名称。

返回值：

类型说明
Promise<void>以Promise方式返回接口运行结果，可进行错误处理或其他自定义处理。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

let bundleName = 'bundleName';
try {
    appManager.clearUpApplicationData(bundleName).then((data) => {
        console.log('clearUpApplicationData success.');
    }).catch((err: BusinessError) => {
        console.error(`clearUpApplicationData fail, err: ${JSON.stringify(err)}`);
    });
} catch (paramError) {
    let code = (paramError as BusinessError).code;
    let message = (paramError as BusinessError).message;
    console.error(`[appManager] error: ${code}, ${message} `);
}

appManager.getProcessMemoryByPid10+

getProcessMemoryByPid(pid: number, callback: AsyncCallback<number>): void;

通过pid查询对应进程占用的内存大小。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API：此接口为系统接口。

参数：

参数名类型必填说明
pidnumber是表示进程id，详情参考getRunningProcessInfoByBundleName。
callbackAsyncCallback<number>是以回调方式返回接口运行结果及进程占用的内存大小（单位KB），可进行错误处理或其他自定义处理。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

let pid = 0;
function getProcessMemoryByPidCallback(err: BusinessError, data: number) {
    if (err) {
        console.error(`getProcessMemoryByPidCallback fail, err: ${JSON.stringify(err)}`);
    } else {
        console.log('getProcessMemoryByPidCallback success.');
    }
}
try {
    appManager.getProcessMemoryByPid(pid, getProcessMemoryByPidCallback);
} catch (paramError) {
    let code = (paramError as BusinessError).code;
    let message = (paramError as BusinessError).message;
    console.error(`[appManager] error: ${code}, ${message} `);
}

appManager.getProcessMemoryByPid10+

getProcessMemoryByPid(pid: number): Promise<number>;

通过pid查询对应进程占用的内存大小。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API：此接口为系统接口。

参数：

参数名类型必填说明
pidnumber是表示进程id，详情参考getRunningProcessInfoByBundleName。

返回值：

类型说明
Promise<number>以Promise方式返回接口运行结果及进程占用的内存大小（单位KB），可进行错误处理或其他自定义处理。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

let pid = 0;
try {
    appManager.getProcessMemoryByPid(pid).then((data) => {
        console.log('getProcessMemoryByPid success.');
    }).catch((err: BusinessError) => {
        console.error(`getProcessMemoryByPid fail, err: ${JSON.stringify(err)}`);
    });
} catch (paramError) {
    let code = (paramError as BusinessError).code;
    let message = (paramError as BusinessError).message;
    console.error(`[appManager] error: ${code}, ${message} `);
}

appManager.getRunningProcessInfoByBundleName10+

getRunningProcessInfoByBundleName(bundleName: string, callback: AsyncCallback<Array<ProcessInformation>>): void;

通过bundleName获取有关运行进程的信息。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API：此接口为系统接口。

参数：

参数名类型必填说明
bundleNamestring是表示Bundle名称。
callbackAsyncCallback<Array<ProcessInformation>>是以回调方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

let bundleName = "bundleName";
function getRunningProcessInfoByBundleNameCallback(err: BusinessError, data: Array<appManager.ProcessInformation>) {
    if (err) {
        console.error(`getRunningProcessInfoByBundleNameCallback fail, err: ${JSON.stringify(err)}`);
    } else {
        console.log('getRunningProcessInfoByBundleNameCallback success.');
    }
}
try {
    appManager.getRunningProcessInfoByBundleName(bundleName, getRunningProcessInfoByBundleNameCallback);
} catch (paramError) {
    let code = (paramError as BusinessError).code;
    let message = (paramError as BusinessError).message;
    console.error(`[appManager] error: ${code}, ${message} `);
}

appManager.getRunningProcessInfoByBundleName10+

getRunningProcessInfoByBundleName(bundleName: string): Promise<Array<ProcessInformation>>;

通过bundleName获取有关运行进程的信息。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API：此接口为系统接口。

参数：

参数名类型必填说明
bundleNamestring是表示Bundle名称。

返回值：

类型说明
Promise<Array<ProcessInformation>>以Promise方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

let bundleName = "bundleName";
try {
    appManager.getRunningProcessInfoByBundleName(bundleName).then((data) => {
        console.log('getRunningProcessInfoByBundleName success.');
    }).catch((err: BusinessError) => {
        console.error(`getRunningProcessInfoByBundleName fail, err: ${JSON.stringify(err)}`);
    });
} catch (paramError) {
    let code = (paramError as BusinessError).code;
    let message = (paramError as BusinessError).message;
    console.error(`[appManager] error: ${code}, ${message} `);
}

appManager.getRunningProcessInfoByBundleName10+

getRunningProcessInfoByBundleName(bundleName: string, userId: number, callback: AsyncCallback<Array<ProcessInformation>>): void;

通过bundleName和userId获取有关运行进程的信息。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API：此接口为系统接口。

参数：

参数名类型必填说明
bundleNamestring是表示Bundle名称。
userIdnumber是表示用户Id。
callbackAsyncCallback<Array<ProcessInformation>>是以回调方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

let bundleName = "bundleName";
let userId = 0;
function getRunningProcessInfoByBundleNameCallback(err: BusinessError, data: Array<appManager.ProcessInformation>) {
    if (err) {
        console.error(`getRunningProcessInfoByBundleNameCallback fail, err: ${JSON.stringify(err)}`);
    } else {
        console.log('getRunningProcessInfoByBundleNameCallback success.');
    }
}
try {
    appManager.getRunningProcessInfoByBundleName(bundleName, userId, getRunningProcessInfoByBundleNameCallback);
} catch (paramError) {
    let code = (paramError as BusinessError).code;
    let message = (paramError as BusinessError).message;
    console.error(`[appManager] error: ${code}, ${message} `);
}

appManager.getRunningProcessInfoByBundleName10+

getRunningProcessInfoByBundleName(bundleName: string, userId: number): Promise<Array<ProcessInformation>>;

通过bundleName和userId获取有关运行进程的信息。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API：此接口为系统接口。

参数：

参数名类型必填说明
bundleNamestring是表示Bundle名称。
userIdnumber是表示用户Id。

返回值：

类型说明
Promise<Array<ProcessInformation>>以Promise方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。

错误码：

错误码ID错误信息
16000050Internal error.

以上错误码详细介绍请参考元能力子系统错误码。

示例：

import appManager from '@ohos.app.ability.appManager';
import { BusinessError } from '@ohos.base';

let bundleName = "bundleName";
let userId = 0;
try {
    appManager.getRunningProcessInfoByBundleName(bundleName, userId).then((data) => {
        console.log('getRunningProcessInfoByBundleName success.');
    }).catch((err: BusinessError) => {
        console.error(`getRunningProcessInfoByBundleName fail, err: ${JSON.stringify(err)}`);
    });
} catch (paramError) {
    let code = (paramError as BusinessError).code;
    let message = (paramError as BusinessError).message;
    console.error(`[appManager] error: ${code}, ${message} `);
}

ApplicationState

应用状态，该类型为枚举，可配合AbilityStateData返回相应的应用状态。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API: 此接口为系统接口，三方应用不支持调用。

名称值说明
STATE_CREATE1当应用在创建中的时候处于的状态。
STATE_FOREGROUND2当应用切换到前台的时候处于的状态。
STATE_ACTIVE3当应用在获焦的时候处于的状态。
STATE_BACKGROUND4当应用处于后台不可见时处于的状态。
STATE_DESTROY5当应用在销毁的时候处于的状态。

ProcessState10+

进程状态，该类型为枚举，可配合ProcessData返回相应的进程状态。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

名称值说明
STATE_CREATE0当进程在创建中的时候处于的状态。
STATE_FOREGROUND1当进程切换到前台的时候处于的状态。
STATE_ACTIVE2当进程在获焦的时候处于的状态。
STATE_BACKGROUND3当进程处于后台不可见时处于的状态。
STATE_DESTROY4当进程在销毁的时候处于的状态。

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。 

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

  •  HarmonOS基础技能

  • HarmonOS就业必备技能 
  •  HarmonOS多媒体技术

  • 鸿蒙NaPi组件进阶

  • HarmonOS高级技能

  • 初识HarmonOS内核 
  • 实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

图片

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

图片

 《鸿蒙开发基础》

  • ArkTS语言
  • 安装DevEco Studio
  • 运用你的第一个ArkTS应用
  • ArkUI声明式UI开发
  • .……

图片

 《鸿蒙开发进阶》

  • Stage模型入门
  • 网络管理
  • 数据管理
  • 电话服务
  • 分布式应用开发
  • 通知与窗口管理
  • 多媒体技术
  • 安全技能
  • 任务管理
  • WebGL
  • 国际化开发
  • 应用测试
  • DFX面向未来设计
  • 鸿蒙系统移植和裁剪定制
  • ……

图片

《鸿蒙进阶实战》

  • ArkTS实践
  • UIAbility应用
  • 网络案例
  • ……

图片

 获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。

蜀道衫QAQ
关注
  • 10
    点赞
  • 踩
  • 12
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
HarmonyOS启动恢复之init和AppSpawn
weixin_47070198的博客
12-08 2295
本文作者：江苏润和软件股份有限公司 **1.总体描述 1.1.总体介绍** 启动恢复负责在内核启动之后到应用启动之前的系统关键进程和服务的启动过程。涉及以下模块： a) init启动引导 支持使用LiteOS-A内核的平台，当前包括：Hi3516DV300平台和Hi3518EV300平台。 负责处理从内核加载第一个用户态进程开始，到第一个应用程序启动之间的系统服务进程启动过程。启动恢复子系统除负责加载各系统关键进程之外，还需在启动的同时设置其对应权限，并在子进程启动后对指定进程实行保活（若进程意外退出要
AppManager-for-AndroidApp应用管理.rar
07-30
AppManager-for-AndroidApp应用管理.rar,太多无法一一验证是否可用，程序如果跑不起来需要自调，部分代码功能进行参考学习。
HarmonyOS实战开发：AppStateData
2401_84194030的博客
05-21 721
定义应用状态信息.......
HarmonyOS实战开发：ProcessData
2401_84194030的博客
05-23 789
进程数据的对象定义......
HarmonyOS实战开发：ProcessInformation
2401_84194030的博客
05-23 644
ProcessInformation模块提供对进程运行信息进行查询的能力。
HarmonyOS实战开发：ApplicationStateObserver
2401_84194030的博客
05-21 674
定义应用状态监听.........
harmonyos samgr,#2020征文-其它#HarmonyOS启动恢复之init和AppSpawn(下)
weixin_42299140的博客
05-27 333
3.3.appspawn的初始化AppSpawn是一个独立的进程，由init进程初始化阶段拉起。AppSpawn是应用孵化器，作用是Fork出AbilityMain进程。整个系统框架图如下：前面的分布式调度中有介绍最后通过ams拉起FA，ams则是通过AppSpawn来孵化出(Fork出)一个AbilityMain进程。而AbilityMain就是JS应用的native实例，里面包含了ACE(JS...
08-20210305在WIN10下通过网口给华为海思Hi3516DV300刷机（鸿蒙系统）
南岭笑笑生之家
03-05 5230
08-20210301在WIN10下通过网口给华为海思Hi3516DV300刷机（鸿蒙系统） 2021/3/5 11:03 https://bbs.elecfans.com/jishu_2002000_1_1.html [经验] 【HarmonyOS HiSpark AI Camera】初遇鸿蒙系统——2.uboot、kernel、fs文件系统烧写 开发板：【HarmonyOS HiSpark AI Camera】 串口/SSH工具：Xshell-7（Build 0056） USB转串口驱动：CH34
鸿蒙APP框架分析
weixin_40870382的博客
12-17 1770
本文主要描述鸿蒙系统的APP框架的代码组成，APP的一些概念。APP的启动，APP的生命周期，APP之间的交互情况。主要关注进程级别。而进程内的线程级别在其它文章描述。 通过本文的学习，可以对APP的运行机制有一个大致的把握和理解。
07-20210305在WIN10下通过USB口给华为海思Hi3516DV300刷机（鸿蒙系统）
南岭笑笑生之家
03-05 3917
07-20210305在WIN10下通过USB口给华为海思Hi3518EV300刷机（鸿蒙系统） 2021/3/5 17:26 https://blog.csdn.net/cocoron/article/details/105194160 【海思篇】【Hi3516DV300】三、使用USB烧写映像 https://blog.csdn.net/qq_30722795/article/details/113501321 IPC Hi3518EV300开发板——移植Linux 0.串口快速烧录教程 开发
AppManager.zip
04-29
AppManager.zip是一个包含应用程序管理功能的压缩包文件。它提供了对软件进行全方位管理的能力，包括获取、卸载、启动和分享等关键操作。这个压缩包的核心目标是为用户提供一个便捷的方式来管理和控制他们设备上的...
921642635964825AppManager.apk
10-26
921642635964825AppManager.apk
android-appManager.zip_android_应用管理
09-22
本压缩包"android-appManager.zip"显然是一个专为Android平台设计的应用管理工具，名为"DIYAppExplorer1.0"。下面我们将深入探讨Android应用管理和这个工具的相关知识点。 1. **Android应用结构**：Android应用程序...
AppManager.java
08-26
AppManager.java
HarmonyOS 地图服务：深度解析其丰富功能与精准导航实力
最新发布
白晓明的博客
08-21 757
HarmonyOS为开发者和用户带来了强大的地图功能支持，其中包括地图组件MapComponent以及地图组件的主要功能入口类MapComponentController。
HarmonyOS应用四之页面加载构建以及数据请求
zouyang920的博客
08-19 324
【代码】HarmonyOS应用四之页面加载及构建。
HarmonyOs透明弹窗(选择照片弹窗样式)
qq_42111674的博客
08-19 262
鸿蒙中实现一个透明弹窗案例(复制可用)......
鸿蒙内核源码分析(信号生产篇) | 注意结构体的名字和作用.
黎程雨的博客
08-21 357
关于信号篇，本只想写一篇，但发现把它想简单了，内容不多，难度极大.整理了好长时间，理解了为何要单独为它开一章，原因有二
NetIQ AppManager6.0 中文用户手册：操作与监控指南
"AppManager6[1].0_customer menue_chinese" NetIQ AppManager6.0是一款强大的系统管理和监控工具，专为用户提供全面的IT基础设施监控解决方案。本用户手册详细介绍了AppManager的功能、工作原理以及如何操作和配置...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值