android.app
Class ActivityManager

java.lang.Object
  android.app.ActivityManager

public class ActivityManager
extends Object

Interact with the overall activities running in the system.

Nested Class Summary

static class	ActivityManager.MemoryInfo Information you can retrieve about the available memory through getMemoryInfo(android.app.ActivityManager.MemoryInfo).
static class	ActivityManager.ProcessErrorStateInfo Information you can retrieve about any processes that are in an error condition.
static class	ActivityManager.RecentTaskInfo Information you can retrieve about tasks that the user has most recently started or visited.
static class	ActivityManager.RunningServiceInfo Information you can retrieve about a particular Service that is currently running in the system.
static class	ActivityManager.RunningTaskInfo Information you can retrieve about a particular task that is currently "running" in the system.

Field Summary

static int

RECENT_WITH_EXCLUDED Flag for use with getRecentTasks(int, int): return all tasks, even those that have set their Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS flag.

Constructor Summary

ActivityManager(Context context, Handler handler)

Method Summary

boolean	clearApplicationUserData(String packageName, IPackageDataObserver observer)
void	getMemoryInfo(ActivityManager.MemoryInfo outInfo)
List<ActivityManager.ProcessErrorStateInfo>	getProcessesInErrorState() Returns a list of any processes that are currently in an error condition.
List<ActivityManager.RecentTaskInfo>	getRecentTasks(int maxNum, int flags) Return a list of the tasks that the user has recently launched, with the most recent being first and older ones after in order.
List<ActivityManager.RunningServiceInfo>	getRunningServices(int maxNum) Return a list of the services that are currently running.
List<ActivityManager.RunningTaskInfo>	getRunningTasks(int maxNum) Return a list of the tasks that are currently running, with the most recent being first and older ones after in order.

Methods inherited from class java.lang.Object

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

Field Detail

RECENT_WITH_EXCLUDED

public static final int RECENT_WITH_EXCLUDED

Flag for use with getRecentTasks(int, int): return all tasks, even those that have set their Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS flag.

See Also:

Constant Field Values

Constructor Detail

ActivityManager

ActivityManager(Context context,
                Handler handler)

Method Detail

getRecentTasks

public List<ActivityManager.RecentTaskInfo> getRecentTasks(int maxNum,
                                                           int flags)
                                                    throws SecurityException

Return a list of the tasks that the user has recently launched, with the most recent being first and older ones after in order.

Parameters:

maxNum - The maximum number of entries to return in the list. The actual number returned may be smaller, depending on how many tasks the user has started and the maximum number the system can remember.

Returns:

Returns a list of RecentTaskInfo records describing each of the recent tasks.

Throws:

SecurityException - Throws SecurityException if the caller does not hold the Manifest.permission.GET_TASKS permission.

getRunningTasks

public List<ActivityManager.RunningTaskInfo> getRunningTasks(int maxNum)
                                                      throws SecurityException

Return a list of the tasks that are currently running, with the most recent being first and older ones after in order. Note that "running" does not mean any of the task's code is currently loaded or activity -- the task may have been frozen by the system, so that it can be restarted in its previous state when next brought to the foreground.

Parameters:

maxNum - The maximum number of entries to return in the list. The actual number returned may be smaller, depending on how many tasks the user has started.

Returns:

Returns a list of RunningTaskInfo records describing each of the running tasks.

Throws:

SecurityException - Throws SecurityException if the caller does not hold the Manifest.permission.GET_TASKS permission.

getRunningServices

public List<ActivityManager.RunningServiceInfo> getRunningServices(int maxNum)
                                                            throws SecurityException

Return a list of the services that are currently running.

Parameters:

maxNum - The maximum number of entries to return in the list. The actual number returned may be smaller, depending on how many services are running.

Returns:

Returns a list of RunningServiceInfo records describing each of the running tasks.

Throws:

SecurityException

getMemoryInfo

public void getMemoryInfo(ActivityManager.MemoryInfo outInfo)

clearApplicationUserData

public boolean clearApplicationUserData(String packageName,
                                        IPackageDataObserver observer)

getProcessesInErrorState

public List<ActivityManager.ProcessErrorStateInfo> getProcessesInErrorState()

Returns a list of any processes that are currently in an error condition. The result will be null if all processes are running properly at this time.

Returns:

Returns a list of ProcessErrorStateInfo records, or null if there are no current error conditions (it will not return an empty list). This list ordering is not specified.