com.jaredrummler.android.processes

Class AndroidProcesses

java.lang.Object

com.jaredrummler.android.processes.AndroidProcesses

Direct Known Subclasses:

ProcessManager

public class AndroidProcesses
extends java.lang.Object

Helper class to get a list of processes on Android.

Usage:

Get a list of running apps:

 List<AndroidAppProcess> processes = AndroidProcesses.getRunningAppProcesses();
 

Get some information about a process:

 AndroidAppProcess process = processes.get(location);
 String processName = process.name;

 Stat stat = process.stat();
 int pid = stat.getPid();
 int parentProcessId = stat.ppid();
 long startTime = stat.stime();
 int policy = stat.policy();
 char state = stat.state();

 Statm statm = process.statm();
 long totalSizeOfProcess = statm.getSize();
 long residentSetSize = statm.getResidentSetSize();

 PackageInfo packageInfo = process.getPackageInfo(context, 0);
 String appName = packageInfo.applicationInfo.loadLabel(pm).toString();
 

Check if your app is in the foreground:

 if (AndroidProcesses.isMyProcessInTheForeground()) {
   // do stuff
 }
 

Get a list of application processes that are running on the device:

 List<ActivityManager.RunningAppProcessInfo> processes = AndroidProcesses.getRunningAppProcessInfo(context);
 

Limitations

System apps may not be visible because they have a higher SELinux context than third party apps.

Some information that was available through ActivityManager.getRunningAppProcesses() is not available using this library (ActivityManager.RunningAppProcessInfo.pkgList, ActivityManager.RunningAppProcessInfo.lru, ActivityManager.RunningAppProcessInfo.importance, etc.).

This is currently not working on the N developer preview.

Note: You should avoid running methods from this class on the UI thread.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AndroidProcesses.ProcessComparator A Comparator to list processes by name

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	TAG

Method Summary

Modifier and Type	Method and Description
static java.util.List<AndroidAppProcess>	getRunningAppProcesses()
static java.util.List<android.app.ActivityManager.RunningAppProcessInfo>	getRunningAppProcessInfo(android.content.Context context) Returns a list of application processes that are running on the device.
static java.util.List<AndroidAppProcess>	getRunningForegroundApps(android.content.Context context) Get a list of user apps running in the foreground.
static java.util.List<AndroidProcess>	getRunningProcesses()
static boolean	isLoggingEnabled()
static boolean	isMyProcessInTheForeground()
static boolean	isProcessInfoHidden() On Android 7.0+ the procfs filesystem is now mounted with hidepid=2, eliminating access to the /proc/PID directories of other users.
static void	log(java.lang.String message, java.lang.Object... args) Send a log message if logging is enabled.
static void	log(java.lang.Throwable error, java.lang.String message, java.lang.Object... args) Send a log message if logging is enabled.
static void	setLoggingEnabled(boolean enabled) Toggle whether debug logging is enabled.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

TAG

public static final java.lang.String TAG

See Also:

Constant Field Values

Method Detail

setLoggingEnabled

public static void setLoggingEnabled(boolean enabled)

Toggle whether debug logging is enabled.

Parameters:

enabled - true to enable logging. This should be only be used for debugging purposes.

See Also:

isLoggingEnabled(), log(String, Object...), log(Throwable, String, Object...)

isLoggingEnabled

public static boolean isLoggingEnabled()

Returns:

true if logging is enabled.

See Also:

setLoggingEnabled(boolean)

log

public static void log(java.lang.String message,
                       java.lang.Object... args)

Send a log message if logging is enabled.

Parameters:

message - the message to log

args - list of arguments to pass to the formatter

log

public static void log(java.lang.Throwable error,
                       java.lang.String message,
                       java.lang.Object... args)

Send a log message if logging is enabled.

Parameters:

error - An exception to log

message - the message to log

args - list of arguments to pass to the formatter

isProcessInfoHidden

public static boolean isProcessInfoHidden()

On Android 7.0+ the procfs filesystem is now mounted with hidepid=2, eliminating access to the /proc/PID directories of other users. There's a group ("readproc") for making exceptions but it's not exposed as a permission. To get a list of processes on Android 7.0+ you must use UsageStatsManager or have root access.

Returns:

true if procfs is mounted with hidepid=2

getRunningProcesses

public static java.util.List<AndroidProcess> getRunningProcesses()

Returns:

a list of all processes running on the device.

getRunningAppProcesses

public static java.util.List<AndroidAppProcess> getRunningAppProcesses()

Returns:

a list of all running app processes on the device.

getRunningForegroundApps

public static java.util.List<AndroidAppProcess> getRunningForegroundApps(android.content.Context context)

Get a list of user apps running in the foreground.

Parameters:

context - the application context

Returns:

a list of user apps that are in the foreground.

isMyProcessInTheForeground

public static boolean isMyProcessInTheForeground()

Returns:

true if this process is in the foreground.

getRunningAppProcessInfo

public static java.util.List<android.app.ActivityManager.RunningAppProcessInfo> getRunningAppProcessInfo(android.content.Context context)

Returns a list of application processes that are running on the device.

NOTE: On Lollipop (SDK 22) this does not provide ActivityManager.RunningAppProcessInfo.pkgList, ActivityManager.RunningAppProcessInfo.importance, ActivityManager.RunningAppProcessInfo.lru, ActivityManager.RunningAppProcessInfo.importanceReasonCode, ActivityManager.RunningAppProcessInfo.importanceReasonComponent, ActivityManager.RunningAppProcessInfo.importanceReasonPid, etc. If you need more process information try using getRunningAppProcesses() or UsageStatsManager

Parameters:

context - the application context

Returns:

a list of RunningAppProcessInfo records, or null if there are no running processes (it will not return an empty list). This list ordering is not specified.