鸿蒙OS IAbilityManager

IAbilityManager

public interface IAbilityManager

获取应用程序的运行进程和内存信息。

字段摘要

修饰符和类型	字段	描述
static int	DEFAULT_DENSITY	表示默认密度。
static int	DEFAULT_HEAPSIZE	表示基本内存大小。
static int	DEFAULT_ICONSIZE	指示默认图标大小，以像素为单位。
static int	LOCK_MISSION_MODE_LOCKED	表示启用了完整的任务锁定模式。
static int	LOCK_MISSION_MODE_NULL	表示锁定任务模式已禁用。
static int	LOCK_MISSION_MODE_PINNED	表示开启任务锁定模式。

方法总结

修饰符和类型	方法	描述
boolean	canAbilityStartOnDisplay(Context context, int displayId, Intent intent)	检查当有多个物理显示设备时，是否可以在指定的显示器上启动ability。
boolean	clearUpApplicationData()	清除应用程序的用户数据，相当于初始化应用程序。
ListRunningProcessInfo	getAllRunningProcesses()	获取有关设备上运行的应用程序进程的信息。
int	getAppLargeMemory()	获取当前设备上的应用程序可以使用的最大内存。
int	getAppMemory()	获取当前设备上的应用程序可以使用的内存。
DeviceConfigInfo	getDeviceConfigInfo()	获取设备的配置信息，如触摸类型、键盘类型、导航设备等。
int	getHomeScreenIconDensity()	获取主屏幕图标的密度。
int	getHomeScreenIconSize()	获取主屏幕图标的大小。
int	getMissionLockModeState()	获取锁任务模式的当前状态。
void	getMyProcessMemoryInfo(RunningProcessInfo outState)	获取调用进程的内存信息，帮助您了解当前应用程序运行的进程的内存使用情况。
ListProcessErrorInfo	getProcessesErrorInfo()	获取进程错误信息列表。
MemoryInfo[]	getProcessMemoryInfo(int[] pids)	获取指定进程的内存使用情况。
void	getSystemMemoryInfo(SystemMemoryInfo outInfo)	获取系统内存信息，包括系统总内存、可用系统内存、系统内存是否低。
boolean	isBackgroundRunningRestricted()	检查此应用程序的进程是否被禁止在后台运行。
boolean	isLowRamDevice()	检查当前设备是否为低 RAM 设备。
boolean	isUserKingKong()	user kingkong test
void	killProcessesByBundleName(String bundleName)	杀死与指定包关联的所有后台进程。
ListAbilityMissionInfo	queryRecentAbilityMissionInfo(int maxMissionNum, int flag)	查询近期ability任务信息。
ListAbilityMissionInfo	queryRunningAbilityMissionInfo(int maxMissionNum)	查询运行ability任务信息。
void	updateDeviceLocale(LocaleProfile localeProfile)	更新设备的当前语言环境。

字段详细信息

DEFAULT_DENSITY

static final int DEFAULT_DENSITY

表示默认密度。

DEFAULT_HEAPSIZE

static final int DEFAULT_HEAPSIZE

表示基本内存大小。

DEFAULT_ICONSIZE

static final int DEFAULT_ICONSIZE

指示默认图标大小，以像素为单位。

LOCK_MISSION_MODE_LOCKED

static final int LOCK_MISSION_MODE_LOCKED

表示启用了完整的任务锁定模式。

常数值为 0x00000001。 此模式下的应用程序被锁定，Home 键和Recent 键被禁用。

LOCK_MISSION_MODE_NULL

static final int LOCK_MISSION_MODE_NULL

表示锁定任务模式已禁用。

常数值为 0x00000000。

LOCK_MISSION_MODE_PINNED

static final int LOCK_MISSION_MODE_PINNED

表示开启任务锁定模式。

常数值为 0x00000002。 此模式下的应用程序被锁定，但启用了 Return 键、Home 键和最近键。

方法详情

getProcessMemoryInfo

MemoryInfo[] getProcessMemoryInfo(int[] pids)

获取指定进程的内存使用情况。

参数:

参数名称	参数描述
pids	表示需要查询内存使用的进程的PID。

返回:

返回每个请求进程的内存使用情况。

getProcessesErrorInfo

ListProcessErrorInfo getProcessesErrorInfo()

获取进程错误信息列表。

返回:

返回进程错误信息列表，如果没有当前错误条件，则返回 null

getAllRunningProcesses

ListRunningProcessInfo getAllRunningProcesses()

获取有关设备上运行的应用程序进程的信息。

返回:

返回正在运行的进程列表。

getAppLargeMemory

int getAppLargeMemory()

获取当前设备上的应用程序可以使用的最大内存。

不建议将此方法返回的最大内存大小作为您的应用程序的内存使用标准。 相反，请使用 getAppMemory() 返回的值作为参考。

返回:

返回应用程序可以使用的最大内存大小，以 MB 为单位。

getAppMemory

int getAppMemory()

获取当前设备上的应用程序可以使用的内存。

您可以使用此方法返回的内存大小作为标准来确定如何优化应用程序中的内存使用。

返回:

返回应用程序可以使用的内存大小，以 MB 为单位。

getSystemMemoryInfo

void getSystemMemoryInfo(SystemMemoryInfo outInfo)

获取系统内存信息，包括系统总内存、可用系统内存、系统内存是否低。

您可以在应用程序调试时使用此方法来学习和优化当前系统的内存使用情况。

参数:

参数名称	参数描述
outInfo	表示存储系统内存信息的对象。

getMyProcessMemoryInfo

void getMyProcessMemoryInfo(RunningProcessInfo outState)

获取调用进程的内存信息，帮助您了解当前应用程序运行的进程的内存使用情况。 RunningProcessInfo 对象中将填写的信息包括 PID、UID、最后修整级别、重要性级别和重要性原因。

参数:

参数名称	参数描述
outState	表示为调用进程存储内存信息的对象。

isLowRamDevice

boolean isLowRamDevice()

检查当前设备是否为低 RAM 设备。

此方法可帮助您确定是否优化您的应用程序，例如，禁用一些消耗 RAM 的功能，以便它可以在低 RAM 设备上正常运行。

返回:

如果当前设备是低 RAM 设备，则返回 true； 否则返回 false。

clearUpApplicationData

boolean clearUpApplicationData()

清除应用程序的用户数据，相当于初始化应用程序。

此方法会删除与应用程序相关的所有动态数据和通知，并撤销用户授予它的所有权限，但不会删除其核心文件。 使用此方法时要小心。

返回:

如果成功清除应用程序的用户数据，则返回 true； 否则返回 false。

killProcessesByBundleName

void killProcessesByBundleName(String bundleName)

杀死与指定包关联的所有后台进程。

此方法不会永久终止这些后台进程。 系统将根据需要重新启动它们。

要使用此方法，您需要向系统请求 ohos.permission.CLEAN_BACKGROUND_PROCESSES 权限。 ohos.permission.CLEAN_BACKGROUND_PROCESSES 权限为正常级别。

参数:

参数名称	参数描述
bundleName	指示要终止其进程的包的名称。

getDeviceConfigInfo

DeviceConfigInfo getDeviceConfigInfo()

获取设备的配置信息，如触摸类型、键盘类型、导航设备等。

返回:

返回包含设备配置信息的 DeviceConfigInfo 对象。

getHomeScreenIconDensity

int getHomeScreenIconDensity()

获取主屏幕图标的密度。

当您为应用程序创建图标或快捷方式时，将使用此信息。

返回:

返回主屏幕上图标的密度。

getHomeScreenIconSize

int getHomeScreenIconSize()

获取主屏幕图标的大小。

当您为应用程序创建图标或快捷方式时，将使用此信息。

返回:

返回主屏幕上图标的大小，以像素为单位。

isUserKingKong

boolean isUserKingKong()

user kingkong test

返回:

user 是否是 kingkong.

canAbilityStartOnDisplay

boolean canAbilityStartOnDisplay(Context context, int displayId, Intent intent)

检查当有多个物理显示设备时，是否可以在指定的显示器上启动能力。

参数:

参数名称	参数描述
context	指示将启动该功能的上下文。 此参数不能为空。
displayId	指示将在其上启动该功能的目标显示器的 ID。
intent	表示启动该ability的intent。 此参数不能为空。

返回:

如果ability可以在指定的显示器上启动，则返回 true； 否则返回 false。

getMissionLockModeState

int getMissionLockModeState()

获取锁任务模式的当前状态。

您可以调用 Context.lockMission() 来启用锁定任务模式，并调用 Context.unlockMission() 来禁用它。

返回:

返回锁任务模式的当前状态，可以是 LOCK_MISSION_MODE_NULL、LOCK_MISSION_MODE_LOCKED 或 LOCK_MISSION_MODE_PINNED。

updateDeviceLocale

void updateDeviceLocale(LocaleProfile localeProfile)

更新设备的当前语言环境。 要使用此方法，您需要向系统请求 ohos.permission.UPDATE_CONFIGURATION 和 ohos.permission.MODIFY_SETTINGS 权限。

参数:

参数名称	参数描述
localeProfile	指示包含新语言环境的 LocaleProfile 对象。

queryRunningAbilityMissionInfo

ListAbilityMissionInfo queryRunningAbilityMissionInfo(int maxMissionNum)

查询运行能力任务信息。 开发者可以获取自己的AbilityMissionInfo，或者使用系统应用的ohos.permission.ACCESS_MISSIONS权限获取所有正在运行的应用AbilityMissionInfo。

参数:

参数名称	参数描述
maxMissionNum	表示返回列表的最大数量。

返回:

返回AbilityMissionInfos。

queryRecentAbilityMissionInfo

ListAbilityMissionInfo queryRecentAbilityMissionInfo(int maxMissionNum, int flag)

查询近期技能任务信息。 开发者可以获取自己的AbilityMissionInfo，或者使用系统应用有ohos.permission.ACCESS_MISSIONS权限来获取所有最近应用的AbilityMissionInfo。

参数:

参数名称	参数描述
maxMissionNum	表示返回列表的最大数量。
flag	表示用于查询能力信息的标志，1表示获取所有最近的应用程序，否则返回用户不可用任务的信息。

返回:

返回AbilityMissionInfos。

isBackgroundRunningRestricted

boolean isBackgroundRunningRestricted()

检查此应用程序的进程是否被禁止在后台运行。

返回:

如果不允许此应用程序在后台运行，则返回 true； 否则返回 false。