RunningAppProcessInfo

Kotlin |Java

open class RunningAppProcessInfo : Parcelable

kotlin.Any
↳	android.app.ActivityManager.RunningAppProcessInfo

Information you can retrieve about a running process.

Summary

Constants
static Int	`IMPORTANCE_BACKGROUND`
static Int	`IMPORTANCE_CACHED` Constant for `importance`: This process contains cached code that is expendable, not actively running any app components we care about.
static Int	`IMPORTANCE_CANT_SAVE_STATE` Constant for `importance`: This process is running an application that can not save its state, and thus can't be killed while in the background.
static Int	`IMPORTANCE_EMPTY` Constant for `importance`: This process is empty of any actively running code.
static Int	`IMPORTANCE_FOREGROUND` Constant for `importance`: This process is running the foreground UI; that is, it is the thing currently at the top of the screen that the user is interacting with.
static Int	`IMPORTANCE_FOREGROUND_SERVICE` Constant for `importance`: This process is running a foreground service, for example to perform music playback even while the user is not immediately in the app.
static Int	`IMPORTANCE_GONE` Constant for `importance`: This process does not exist.
static Int	`IMPORTANCE_PERCEPTIBLE` Constant for `importance`: This process is not something the user is directly aware of, but is otherwise perceptible to them to some degree.
static Int	`IMPORTANCE_PERCEPTIBLE_PRE_26` Constant for `importance`: `IMPORTANCE_PERCEPTIBLE` had this wrong value before `Build.VERSION_CODES.O`.
static Int	`IMPORTANCE_SERVICE` Constant for `importance`: This process contains services that should remain running.
static Int	`IMPORTANCE_TOP_SLEEPING` Constant for `importance`: This process is running the foreground UI, but the device is asleep so it is not visible to the user.
static Int	`IMPORTANCE_TOP_SLEEPING_PRE_28`
static Int	`IMPORTANCE_VISIBLE` Constant for `importance`: This process is running something that is actively visible to the user, though not in the immediate foreground.
static Int	`REASON_PROVIDER_IN_USE` Constant for `importanceReasonCode`: one of the application's content providers is being used by another process.
static Int	`REASON_SERVICE_IN_USE` Constant for `importanceReasonCode`: one of the application's content providers is being used by another process.
static Int	`REASON_UNKNOWN` Constant for `importanceReasonCode`: nothing special has been specified for the reason for this level.

Inherited constants

From class Parcelable

Int

CONTENTS_FILE_DESCRIPTOR

Descriptor bit used with describeContents(): indicates that the Parcelable object's flattened representation includes a file descriptor.

Int

PARCELABLE_WRITE_RETURN_VALUE

Flag for use with writeToParcel: the object being written is a return value, that is the result of a function such as "Parcelable someFunction()", "void someFunction(out Parcelable)", or "void someFunction(inout Parcelable)". Some implementations may want to release resources at this point.

Public constructors
`RunningAppProcessInfo()`
`RunningAppProcessInfo(pProcessName: String!, pPid: Int, pArr: Array<String!>!)`

Public methods
open Int	`describeContents()`
open Unit	`readFromParcel(source: Parcel!)`
open Unit	`writeToParcel(dest: Parcel, flags: Int)`

Properties
static Parcelable.Creator<ActivityManager.RunningAppProcessInfo!>	`CREATOR`
Int	`importance` The relative importance level that the system places on this process.
Int	`importanceReasonCode` The reason for `importance`, if any.
ComponentName!	`importanceReasonComponent` For the specified values of `importanceReasonCode`, this is the name of the component that is being used in this process.
Int	`importanceReasonPid` For the specified values of `importanceReasonCode`, this is the process ID of the other process that is a client of this process.
Int	`lastTrimLevel` Last memory trim level reported to the process: corresponds to the values supplied to `ComponentCallbacks2.onTrimMemory(int)`.
Int	`lru` An additional ordering within a particular `importance` category, providing finer-grained information about the relative utility of processes within a category.
Int	`pid` The pid of this process; 0 if none
Array<String!>!	`pkgList` All packages that have been loaded into the process.
String!	`processName` The name of the process that this object is associated with
Int	`uid` The user id of this process.

Constants

IMPORTANCE_BACKGROUND

Added in API level 3
Deprecated in API level 26

static val IMPORTANCE_BACKGROUND: Int

Deprecated: Renamed to IMPORTANCE_CACHED.

Value: 400

IMPORTANCE_CACHED

Added in API level 26

static val IMPORTANCE_CACHED: Int

Constant for importance: This process contains cached code that is expendable, not actively running any app components we care about.

Value: 400

IMPORTANCE_CANT_SAVE_STATE

Added in API level 28

static val IMPORTANCE_CANT_SAVE_STATE: Int

Constant for importance: This process is running an application that can not save its state, and thus can't be killed while in the background. This will be used with apps that have android.R.attr#cantSaveState set on their application tag.

Value: 350

IMPORTANCE_EMPTY

Added in API level 3
Deprecated in API level 26

static val IMPORTANCE_EMPTY: Int

Deprecated: This value is no longer reported, use IMPORTANCE_CACHED instead.

Constant for importance: This process is empty of any actively running code.

Value: 500

IMPORTANCE_FOREGROUND

Added in API level 3

static val IMPORTANCE_FOREGROUND: Int

Constant for importance: This process is running the foreground UI; that is, it is the thing currently at the top of the screen that the user is interacting with.

Value: 100

IMPORTANCE_FOREGROUND_SERVICE

Added in API level 23

static val IMPORTANCE_FOREGROUND_SERVICE: Int

Constant for importance: This process is running a foreground service, for example to perform music playback even while the user is not immediately in the app. This generally indicates that the process is doing something the user actively cares about.

Value: 125

IMPORTANCE_GONE

Added in API level 21

static val IMPORTANCE_GONE: Int

Constant for importance: This process does not exist.

Value: 1000

IMPORTANCE_PERCEPTIBLE

Added in API level 9

static val IMPORTANCE_PERCEPTIBLE: Int

Constant for importance: This process is not something the user is directly aware of, but is otherwise perceptible to them to some degree.

Value: 230

IMPORTANCE_PERCEPTIBLE_PRE_26

Added in API level 26

static val IMPORTANCE_PERCEPTIBLE_PRE_26: Int

Constant for importance: IMPORTANCE_PERCEPTIBLE had this wrong value before Build.VERSION_CODES.O. Since the Build.VERSION_CODES.O SDK, the value of IMPORTANCE_PERCEPTIBLE has been fixed.

The system will return this value instead of IMPORTANCE_PERCEPTIBLE on Android versions below Build.VERSION_CODES.O.

On Android version Build.VERSION_CODES.O and later, this value will still be returned for apps with the target API level below Build.VERSION_CODES.O. For apps targeting version Build.VERSION_CODES.O and later, the correct value IMPORTANCE_PERCEPTIBLE will be returned.

Value: 130

IMPORTANCE_SERVICE

Added in API level 3

static val IMPORTANCE_SERVICE: Int

Constant for importance: This process contains services that should remain running. These are background services apps have started, not something the user is aware of, so they may be killed by the system relatively freely (though it is generally desired that they stay running as long as they want to).

Value: 300

IMPORTANCE_TOP_SLEEPING

Added in API level 23

static val IMPORTANCE_TOP_SLEEPING: Int

Constant for importance: This process is running the foreground UI, but the device is asleep so it is not visible to the user. Though the system will try hard to keep its process from being killed, in all other ways we consider it a kind of cached process, with the limitations that go along with that state: network access, running background services, etc.

Value: 325

IMPORTANCE_TOP_SLEEPING_PRE_28

Added in API level 28
Deprecated in API level 28

static val IMPORTANCE_TOP_SLEEPING_PRE_28: Int

Deprecated: Pre-android.os.Build.VERSION_CODES#P version of IMPORTANCE_TOP_SLEEPING. As of Android android.os.Build.VERSION_CODES#P, this is considered much less important since we want to reduce what apps can do when the screen is off.

Value: 150

IMPORTANCE_VISIBLE

Added in API level 3

static val IMPORTANCE_VISIBLE: Int

Constant for importance: This process is running something that is actively visible to the user, though not in the immediate foreground. This may be running a window that is behind the current foreground (so paused and with its state saved, not interacting with the user, but visible to them to some degree); it may also be running other services under the system's control that it considers important.

Value: 200

REASON_PROVIDER_IN_USE

Added in API level 5

static val REASON_PROVIDER_IN_USE: Int

Constant for importanceReasonCode: one of the application's content providers is being used by another process. The pid of the client process is in importanceReasonPid and the target provider in this process is in importanceReasonComponent.

Value: 1

REASON_SERVICE_IN_USE

Added in API level 5

static val REASON_SERVICE_IN_USE: Int

Value: 2

REASON_UNKNOWN

Added in API level 5

static val REASON_UNKNOWN: Int

Constant for importanceReasonCode: nothing special has been specified for the reason for this level.

Value: 0

Public constructors

RunningAppProcessInfo

Added in API level 3

RunningAppProcessInfo()

RunningAppProcessInfo

Added in API level 3

RunningAppProcessInfo(
    pProcessName: String!, 
    pPid: Int, 
    pArr: Array<String!>!)

Public methods

describeContents

Added in API level 3

open fun describeContents(): Int

Return
`Int`	a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either `0` or `android.os.Parcelable#CONTENTS_FILE_DESCRIPTOR`

readFromParcel

Added in API level 3

open fun readFromParcel(source: Parcel!): Unit

writeToParcel

Added in API level 3

open fun writeToParcel(
    dest: Parcel, 
    flags: Int
): Unit

Parameters
`dest`	Parcel: The Parcel in which the object should be written. This value cannot be `null`.
`flags`	Int: Additional flags about how the object should be written. May be 0 or `PARCELABLE_WRITE_RETURN_VALUE`. Value is either `0` or a combination of `android.os.Parcelable#PARCELABLE_WRITE_RETURN_VALUE`, and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES

Properties

CREATOR

Added in API level 3

static val CREATOR: Parcelable.Creator<ActivityManager.RunningAppProcessInfo!>

importance

Added in API level 3

var importance: Int

importanceReasonCode

Added in API level 5

var importanceReasonCode: Int

The reason for importance, if any.

importanceReasonComponent

Added in API level 5

var importanceReasonComponent: ComponentName!

For the specified values of importanceReasonCode, this is the name of the component that is being used in this process.

importanceReasonPid

Added in API level 5

var importanceReasonPid: Int

For the specified values of importanceReasonCode, this is the process ID of the other process that is a client of this process. This will be 0 if no other process is using this one.

lastTrimLevel

Added in API level 16

var lastTrimLevel: Int

Last memory trim level reported to the process: corresponds to the values supplied to ComponentCallbacks2.onTrimMemory(int).

lru

Added in API level 3

var lru: Int

An additional ordering within a particular importance category, providing finer-grained information about the relative utility of processes within a category. This number means nothing except that a smaller values are more recently used (and thus more important). Currently an LRU value is only maintained for the IMPORTANCE_CACHED category, though others may be maintained in the future.

pid

Added in API level 3

var pid: Int

The pid of this process; 0 if none

pkgList

Added in API level 3

var pkgList: Array<String!>!

All packages that have been loaded into the process.

processName

Added in API level 3

var processName: String!

The name of the process that this object is associated with

uid

Added in API level 5

var uid: Int

The user id of this process.