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。