Added in API level 21

AppTask

open class AppTask
kotlin.Any
   ↳ android.app.ActivityManager.AppTask

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

Summary

Public methods
open Unit

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

open ActivityManager.RecentTaskInfo!

Get the RecentTaskInfo associated with this task.

open Unit

Bring this task to the foreground.

open Unit

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

open Unit
startActivity(context: Context!, intent: Intent!, options: Bundle!)

Start an activity in this task.

Public methods

finishAndRemoveTask

Added in API level 21
open fun finishAndRemoveTask(): Unit

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

getTaskInfo

Added in API level 21
open fun getTaskInfo(): ActivityManager.RecentTaskInfo!

Get the RecentTaskInfo associated with this task.

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

moveToFront

Added in API level 21
open fun moveToFront(): Unit

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
open fun setExcludeFromRecents(exclude: Boolean): Unit

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

Parameters
exclude Boolean: If true, Intent#FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS will be set; otherwise, it will be cleared.

startActivity

Added in API level 21
open fun startActivity(
    context: Context!,
    intent: Intent!,
    options: Bundle!
): Unit

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 Intent#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 Intent#FLAG_ACTIVITY_NEW_TASK or Intent#FLAG_ACTIVITY_NEW_DOCUMENT, and let the system do the right thing.

Parameters
intent Intent!: The Intent describing the new activity to be launched on the task.
options Bundle!: Optional launch options.

See Also