Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
public class

IntentCompat

extends Object
java.lang.Object
   ↳ android.support.v4.content.IntentCompat

Class Overview

Helper for accessing features in Intent introduced after API level 4 in a backwards compatible fashion.

Summary

Constants
String ACTION_EXTERNAL_APPLICATIONS_AVAILABLE Broadcast Action: Resources for a set of packages (which were previously unavailable) are currently available since the media on which they exist is available.
String ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE Broadcast Action: Resources for a set of packages are currently unavailable since the media on which they exist is unavailable.
String EXTRA_CHANGED_PACKAGE_LIST This field is part of ACTION_EXTERNAL_APPLICATIONS_AVAILABLE , ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE and contains a string array of all of the components that have changed.
String EXTRA_CHANGED_UID_LIST This field is part of ACTION_EXTERNAL_APPLICATIONS_AVAILABLE , ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE and contains an integer array of uids of all of the components that have changed.
String EXTRA_HTML_TEXT A constant String that is associated with the Intent, used with ACTION_SEND to supply an alternative to EXTRA_TEXT as HTML formatted text.
int FLAG_ACTIVITY_CLEAR_TASK If set in an Intent passed to Context.startActivity() , this flag will cause any existing task that would be associated with the activity to be cleared before the activity is started.
int FLAG_ACTIVITY_TASK_ON_HOME If set in an Intent passed to Context.startActivity() , this flag will cause a newly launching task to be placed on top of the current home activity task (if there is one).
Public Methods
static Intent makeMainActivity ( ComponentName mainActivity)
Create an intent to launch the main (root) activity of a task.
static Intent makeMainSelectorActivity ( String selectorAction, String selectorCategory)
Make an Intent for the main activity of an application, without specifying a specific activity to run but giving a selector to find the activity.
static Intent makeRestartActivityTask ( ComponentName mainActivity)
Make an Intent that can be used to re-launch an application's task in its base state.
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final String ACTION_EXTERNAL_APPLICATIONS_AVAILABLE

Broadcast Action: Resources for a set of packages (which were previously unavailable) are currently available since the media on which they exist is available. The extra data EXTRA_CHANGED_PACKAGE_LIST contains a list of packages whose availability changed. The extra data EXTRA_CHANGED_UID_LIST contains a list of uids of packages whose availability changed. Note that the packages in this list do not receive this broadcast. The specified set of packages are now available on the system.

Includes the following extras:

This is a protected intent that can only be sent by the system.

Constant Value: "android.intent.action.EXTERNAL_APPLICATIONS_AVAILABLE"

public static final String ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE

Broadcast Action: Resources for a set of packages are currently unavailable since the media on which they exist is unavailable. The extra data EXTRA_CHANGED_PACKAGE_LIST contains a list of packages whose availability changed. The extra data EXTRA_CHANGED_UID_LIST contains a list of uids of packages whose availability changed. The specified set of packages can no longer be launched and are practically unavailable on the system.

Inclues the following extras:

This is a protected intent that can only be sent by the system.

Constant Value: "android.intent.action.EXTERNAL_APPLICATIONS_UNAVAILABLE"

public static final String EXTRA_CHANGED_PACKAGE_LIST

This field is part of ACTION_EXTERNAL_APPLICATIONS_AVAILABLE , ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE and contains a string array of all of the components that have changed.

Constant Value: "android.intent.extra.changed_package_list"

public static final String EXTRA_CHANGED_UID_LIST

This field is part of ACTION_EXTERNAL_APPLICATIONS_AVAILABLE , ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE and contains an integer array of uids of all of the components that have changed.

Constant Value: "android.intent.extra.changed_uid_list"

public static final String EXTRA_HTML_TEXT

A constant String that is associated with the Intent, used with ACTION_SEND to supply an alternative to EXTRA_TEXT as HTML formatted text. Note that you must also supply EXTRA_TEXT .

Constant Value: "android.intent.extra.HTML_TEXT"

public static final int FLAG_ACTIVITY_CLEAR_TASK

If set in an Intent passed to Context.startActivity() , this flag will cause any existing task that would be associated with the activity to be cleared before the activity is started. That is, the activity becomes the new root of an otherwise empty task, and any old activities are finished. This can only be used in conjunction with FLAG_ACTIVITY_NEW_TASK .

This flag will only be obeyed on devices supporting API 11 or higher.

Constant Value: 32768 (0x00008000)

public static final int FLAG_ACTIVITY_TASK_ON_HOME

If set in an Intent passed to Context.startActivity() , this flag will cause a newly launching task to be placed on top of the current home activity task (if there is one). That is, pressing back from the task will always return the user to home even if that was not the last activity they saw. This can only be used in conjunction with FLAG_ACTIVITY_NEW_TASK .

Constant Value: 16384 (0x00004000)

Public Methods

public static Intent makeMainActivity ( ComponentName mainActivity)

Create an intent to launch the main (root) activity of a task. This is the Intent that is started when the application's is launched from Home. For anything else that wants to launch an application in the same way, it is important that they use an Intent structured the same way, and can use this function to ensure this is the case.

The returned Intent has the given Activity component as its explicit component, ACTION_MAIN as its action, and includes the category CATEGORY_LAUNCHER . This does not have FLAG_ACTIVITY_NEW_TASK set, though typically you will want to do that through addFlags(int) on the returned Intent.

Parameters
mainActivity The main activity component that this Intent will launch.
Returns
  • Returns a newly created Intent that can be used to launch the activity as a main application entry.

public static Intent makeMainSelectorActivity ( String selectorAction, String selectorCategory)

Make an Intent for the main activity of an application, without specifying a specific activity to run but giving a selector to find the activity. This results in a final Intent that is structured the same as when the application is launched from Home. For anything else that wants to launch an application in the same way, it is important that they use an Intent structured the same way, and can use this function to ensure this is the case.

The returned Intent has ACTION_MAIN as its action, and includes the category CATEGORY_LAUNCHER . This does not have FLAG_ACTIVITY_NEW_TASK set, though typically you will want to do that through addFlags(int) on the returned Intent.

Parameters
selectorAction The action name of the Intent's selector.
selectorCategory The name of a category to add to the Intent's selector.
Returns
  • Returns a newly created Intent that can be used to launch the activity as a main application entry.

public static Intent makeRestartActivityTask ( ComponentName mainActivity)

Make an Intent that can be used to re-launch an application's task in its base state. This is like makeMainActivity(ComponentName) , but also sets the flags FLAG_ACTIVITY_NEW_TASK and FLAG_ACTIVITY_CLEAR_TASK .

Parameters
mainActivity The activity component that is the root of the task; this is the activity that has been published in the application's manifest as the main launcher icon.
Returns
  • Returns a newly created Intent that can be used to relaunch the activity's task in its root state.