Skip to content

Most visited

Recently visited

navigation

ActivityManager.AppTask

public static class ActivityManager.AppTask
extends Object

java.lang.Object
   ↳ android.app.ActivityManager.AppTask


The AppTask allows you to manage your own application's tasks. See getAppTasks()

Summary

Public methods

void finishAndRemoveTask()

Finishes all activities in this task and removes it from the recent tasks list.

ActivityManager.RecentTaskInfo getTaskInfo()

Get the RecentTaskInfo associated with this task.

void moveToFront()

Bring this task to the foreground.

void setExcludeFromRecents(boolean exclude)

Modify the FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS flag in the root Intent of this AppTask.

void startActivity(Context context, Intent intent, Bundle options)

Start an activity in this task.

Inherited methods

From class java.lang.Object

Public methods

finishAndRemoveTask

added in API level 21
void finishAndRemoveTask ()

Finishes all activities in this task and removes it from the recent tasks list.

getTaskInfo

added in API level 21
ActivityManager.RecentTaskInfo getTaskInfo ()

Get the RecentTaskInfo associated with this task.

Returns
ActivityManager.RecentTaskInfo The RecentTaskInfo for this task, or null if the task no longer exists.

moveToFront

added in API level 21
void moveToFront ()

Bring this task to the foreground. If it contains activities, they will be brought to the foreground with it and their instances re-created if needed. If it doesn't contain activities, the root activity of the task will be re-launched.

setExcludeFromRecents

added in API level 21
void setExcludeFromRecents (boolean exclude)

Modify the FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS flag in the root Intent of this AppTask.

Parameters
exclude boolean: If true, FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS will be set; otherwise, it will be cleared.

startActivity

added in API level 21
void startActivity (Context context, 
                Intent intent, 
                Bundle options)

Start an activity in this task. Brings the task to the foreground. If this task is not currently active (that is, its id < 0), then a new activity for the given Intent will be launched as the root of the task and the task brought to the foreground. Otherwise, if this task is currently active and the Intent does not specify an activity to launch in a new task, then a new activity for the given Intent will be launched on top of the task and the task brought to the foreground. If this task is currently active and the Intent specifies FLAG_ACTIVITY_NEW_TASK or would otherwise be launched in to a new task, then the activity not launched but this task be brought to the foreground and a new intent delivered to the top activity if appropriate.

In other words, you generally want to use an Intent here that does not specify FLAG_ACTIVITY_NEW_TASK or FLAG_ACTIVITY_NEW_DOCUMENT, and let the system do the right thing.

Parameters
context Context

intent Intent: The Intent describing the new activity to be launched on the task.

options Bundle: Optional launch options.

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience. (Dec 2017 Android Platform & Tools Survey)