FileDocCategorySizeDatePackage
ActivityInfo.javaAPI DocAndroid 5.1 API31577Thu Mar 12 22:22:10 GMT 2015android.content.pm

ActivityInfo

public class ActivityInfo extends ComponentInfo implements android.os.Parcelable
Information you can retrieve about a particular application activity or receiver. This corresponds to information collected from the AndroidManifest.xml's <activity> and <receiver> tags.

Fields Summary
public int
theme
A style resource identifier (in the package's resources) of this activity's theme. From the "theme" attribute or, if not set, 0.
public static final int
LAUNCH_MULTIPLE
Constant corresponding to standard in the {@link android.R.attr#launchMode} attribute.
public static final int
LAUNCH_SINGLE_TOP
Constant corresponding to singleTop in the {@link android.R.attr#launchMode} attribute.
public static final int
LAUNCH_SINGLE_TASK
Constant corresponding to singleTask in the {@link android.R.attr#launchMode} attribute.
public static final int
LAUNCH_SINGLE_INSTANCE
Constant corresponding to singleInstance in the {@link android.R.attr#launchMode} attribute.
public int
launchMode
The launch mode style requested by the activity. From the {@link android.R.attr#launchMode} attribute, one of {@link #LAUNCH_MULTIPLE}, {@link #LAUNCH_SINGLE_TOP}, {@link #LAUNCH_SINGLE_TASK}, or {@link #LAUNCH_SINGLE_INSTANCE}.
public static final int
DOCUMENT_LAUNCH_NONE
Constant corresponding to none in the {@link android.R.attr#documentLaunchMode} attribute.
public static final int
DOCUMENT_LAUNCH_INTO_EXISTING
Constant corresponding to intoExisting in the {@link android.R.attr#documentLaunchMode} attribute.
public static final int
DOCUMENT_LAUNCH_ALWAYS
Constant corresponding to always in the {@link android.R.attr#documentLaunchMode} attribute.
public static final int
DOCUMENT_LAUNCH_NEVER
Constant corresponding to never in the {@link android.R.attr#documentLaunchMode} attribute.
public int
documentLaunchMode
The document launch mode style requested by the activity. From the {@link android.R.attr#documentLaunchMode} attribute, one of {@link #DOCUMENT_LAUNCH_NONE}, {@link #DOCUMENT_LAUNCH_INTO_EXISTING}, {@link #DOCUMENT_LAUNCH_ALWAYS}.

Modes DOCUMENT_LAUNCH_ALWAYS and DOCUMENT_LAUNCH_INTO_EXISTING are equivalent to {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT Intent.FLAG_ACTIVITY_NEW_DOCUMENT} with and without {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK Intent.FLAG_ACTIVITY_MULTIPLE_TASK} respectively.

public static final int
PERSIST_ROOT_ONLY
Constant corresponding to persistRootOnly in the {@link android.R.attr#persistableMode} attribute.
public static final int
PERSIST_NEVER
Constant corresponding to doNotPersist in the {@link android.R.attr#persistableMode} attribute.
public static final int
PERSIST_ACROSS_REBOOTS
Constant corresponding to persistAcrossReboots in the {@link android.R.attr#persistableMode} attribute.
public int
persistableMode
Value indicating how this activity is to be persisted across reboots for restoring in the Recents list. {@link android.R.attr#persistableMode}
public int
maxRecents
The maximum number of tasks rooted at this activity that can be in the recent task list. Refer to {@link android.R.attr#maxRecents}.
public String
permission
Optional name of a permission required to be able to access this Activity. From the "permission" attribute.
public String
taskAffinity
The affinity this activity has for another task in the system. The string here is the name of the task, often the package name of the overall package. If null, the activity has no affinity. Set from the {@link android.R.attr#taskAffinity} attribute.
public String
targetActivity
If this is an activity alias, this is the real activity class to run for it. Otherwise, this is null.
public static final int
FLAG_MULTIPROCESS
Bit in {@link #flags} indicating whether this activity is able to run in multiple processes. If true, the system may instantiate it in the some process as the process starting it in order to conserve resources. If false, the default, it always runs in {@link #processName}. Set from the {@link android.R.attr#multiprocess} attribute.
public static final int
FLAG_FINISH_ON_TASK_LAUNCH
Bit in {@link #flags} indicating that, when the activity's task is relaunched from home, this activity should be finished. Set from the {@link android.R.attr#finishOnTaskLaunch} attribute.
public static final int
FLAG_CLEAR_TASK_ON_LAUNCH
Bit in {@link #flags} indicating that, when the activity is the root of a task, that task's stack should be cleared each time the user re-launches it from home. As a result, the user will always return to the original activity at the top of the task. This flag only applies to activities that are used to start the root of a new task. Set from the {@link android.R.attr#clearTaskOnLaunch} attribute.
public static final int
FLAG_ALWAYS_RETAIN_TASK_STATE
Bit in {@link #flags} indicating that, when the activity is the root of a task, that task's stack should never be cleared when it is relaunched from home. Set from the {@link android.R.attr#alwaysRetainTaskState} attribute.
public static final int
FLAG_STATE_NOT_NEEDED
Bit in {@link #flags} indicating that the activity's state is not required to be saved, so that if there is a failure the activity will not be removed from the activity stack. Set from the {@link android.R.attr#stateNotNeeded} attribute.
public static final int
FLAG_EXCLUDE_FROM_RECENTS
Bit in {@link #flags} that indicates that the activity should not appear in the list of recently launched activities. Set from the {@link android.R.attr#excludeFromRecents} attribute.
public static final int
FLAG_ALLOW_TASK_REPARENTING
Bit in {@link #flags} that indicates that the activity can be moved between tasks based on its task affinity. Set from the {@link android.R.attr#allowTaskReparenting} attribute.
public static final int
FLAG_NO_HISTORY
Bit in {@link #flags} indicating that, when the user navigates away from an activity, it should be finished. Set from the {@link android.R.attr#noHistory} attribute.
public static final int
FLAG_FINISH_ON_CLOSE_SYSTEM_DIALOGS
Bit in {@link #flags} indicating that, when a request to close system windows happens, this activity is finished. Set from the {@link android.R.attr#finishOnCloseSystemDialogs} attribute.
public static final int
FLAG_HARDWARE_ACCELERATED
Value for {@link #flags}: true when the application's rendering should be hardware accelerated.
public static final int
FLAG_SHOW_ON_LOCK_SCREEN
Value for {@link #flags}: true when the application can be displayed over the lockscreen and consequently over all users' windows.
public static final int
FLAG_IMMERSIVE
Bit in {@link #flags} corresponding to an immersive activity that wishes not to be interrupted by notifications. Applications that hide the system notification bar with {@link android.view.WindowManager.LayoutParams#FLAG_FULLSCREEN} may still be interrupted by high-priority notifications; for example, an incoming phone call may use {@link android.app.Notification#fullScreenIntent fullScreenIntent} to present a full-screen in-call activity to the user, pausing the current activity as a side-effect. An activity with {@link #FLAG_IMMERSIVE} set, however, will not be interrupted; the notification may be shown in some other way (such as a small floating "toast" window). Note that this flag will always reflect the Activity's android:immersive manifest definition, even if the Activity's immersive state is changed at runtime via {@link android.app.Activity#setImmersive(boolean)}.
public static final int
FLAG_RELINQUISH_TASK_IDENTITY
Bit in {@link #flags}: If set, a task rooted at this activity will have its baseIntent replaced by the activity immediately above this. Each activity may further relinquish its identity to the activity above it using this flag. Set from the {@link android.R.attr#relinquishTaskIdentity} attribute.
public static final int
FLAG_AUTO_REMOVE_FROM_RECENTS
Bit in {@link #flags} indicating that tasks started with this activity are to be removed from the recent list of tasks when the last activity in the task is finished. Corresponds to {@link android.R.attr#autoRemoveFromRecents}
public static final int
FLAG_RESUME_WHILE_PAUSING
Bit in {@link #flags} indicating that this activity can start is creation/resume while the previous activity is still pausing. Corresponds to {@link android.R.attr#resumeWhilePausing}
public static final int
FLAG_PRIMARY_USER_ONLY
public static final int
FLAG_SINGLE_USER
Bit in {@link #flags}: If set, a single instance of the receiver will run for all users on the device. Set from the {@link android.R.attr#singleUser} attribute. Note that this flag is only relevant for ActivityInfo structures that are describing receiver components; it is not applied to activities.
public static final int
FLAG_ALLOW_EMBEDDED
public int
flags
Options that have been set in the activity declaration in the manifest. These include: {@link #FLAG_MULTIPROCESS}, {@link #FLAG_FINISH_ON_TASK_LAUNCH}, {@link #FLAG_CLEAR_TASK_ON_LAUNCH}, {@link #FLAG_ALWAYS_RETAIN_TASK_STATE}, {@link #FLAG_STATE_NOT_NEEDED}, {@link #FLAG_EXCLUDE_FROM_RECENTS}, {@link #FLAG_ALLOW_TASK_REPARENTING}, {@link #FLAG_NO_HISTORY}, {@link #FLAG_FINISH_ON_CLOSE_SYSTEM_DIALOGS}, {@link #FLAG_HARDWARE_ACCELERATED}, {@link #FLAG_SINGLE_USER}.
public static final int
SCREEN_ORIENTATION_UNSPECIFIED
Constant corresponding to unspecified in the {@link android.R.attr#screenOrientation} attribute.
public static final int
SCREEN_ORIENTATION_LANDSCAPE
Constant corresponding to landscape in the {@link android.R.attr#screenOrientation} attribute.
public static final int
SCREEN_ORIENTATION_PORTRAIT
Constant corresponding to portrait in the {@link android.R.attr#screenOrientation} attribute.
public static final int
SCREEN_ORIENTATION_USER
Constant corresponding to user in the {@link android.R.attr#screenOrientation} attribute.
public static final int
SCREEN_ORIENTATION_BEHIND
Constant corresponding to behind in the {@link android.R.attr#screenOrientation} attribute.
public static final int
SCREEN_ORIENTATION_SENSOR
Constant corresponding to sensor in the {@link android.R.attr#screenOrientation} attribute.
public static final int
SCREEN_ORIENTATION_NOSENSOR
Constant corresponding to nosensor in the {@link android.R.attr#screenOrientation} attribute.
public static final int
SCREEN_ORIENTATION_SENSOR_LANDSCAPE
Constant corresponding to sensorLandscape in the {@link android.R.attr#screenOrientation} attribute.
public static final int
SCREEN_ORIENTATION_SENSOR_PORTRAIT
Constant corresponding to sensorPortrait in the {@link android.R.attr#screenOrientation} attribute.
public static final int
SCREEN_ORIENTATION_REVERSE_LANDSCAPE
Constant corresponding to reverseLandscape in the {@link android.R.attr#screenOrientation} attribute.
public static final int
SCREEN_ORIENTATION_REVERSE_PORTRAIT
Constant corresponding to reversePortrait in the {@link android.R.attr#screenOrientation} attribute.
public static final int
SCREEN_ORIENTATION_FULL_SENSOR
Constant corresponding to fullSensor in the {@link android.R.attr#screenOrientation} attribute.
public static final int
SCREEN_ORIENTATION_USER_LANDSCAPE
Constant corresponding to userLandscape in the {@link android.R.attr#screenOrientation} attribute.
public static final int
SCREEN_ORIENTATION_USER_PORTRAIT
Constant corresponding to userPortrait in the {@link android.R.attr#screenOrientation} attribute.
public static final int
SCREEN_ORIENTATION_FULL_USER
Constant corresponding to fullUser in the {@link android.R.attr#screenOrientation} attribute.
public static final int
SCREEN_ORIENTATION_LOCKED
Constant corresponding to locked in the {@link android.R.attr#screenOrientation} attribute.
public int
screenOrientation
The preferred screen orientation this activity would like to run in. From the {@link android.R.attr#screenOrientation} attribute, one of {@link #SCREEN_ORIENTATION_UNSPECIFIED}, {@link #SCREEN_ORIENTATION_LANDSCAPE}, {@link #SCREEN_ORIENTATION_PORTRAIT}, {@link #SCREEN_ORIENTATION_USER}, {@link #SCREEN_ORIENTATION_BEHIND}, {@link #SCREEN_ORIENTATION_SENSOR}, {@link #SCREEN_ORIENTATION_NOSENSOR}, {@link #SCREEN_ORIENTATION_SENSOR_LANDSCAPE}, {@link #SCREEN_ORIENTATION_SENSOR_PORTRAIT}, {@link #SCREEN_ORIENTATION_REVERSE_LANDSCAPE}, {@link #SCREEN_ORIENTATION_REVERSE_PORTRAIT}, {@link #SCREEN_ORIENTATION_FULL_SENSOR}, {@link #SCREEN_ORIENTATION_USER_LANDSCAPE}, {@link #SCREEN_ORIENTATION_USER_PORTRAIT}, {@link #SCREEN_ORIENTATION_FULL_USER}, {@link #SCREEN_ORIENTATION_LOCKED},
public static final int
CONFIG_MCC
Bit in {@link #configChanges} that indicates that the activity can itself handle changes to the IMSI MCC. Set from the {@link android.R.attr#configChanges} attribute.
public static final int
CONFIG_MNC
Bit in {@link #configChanges} that indicates that the activity can itself handle changes to the IMSI MNC. Set from the {@link android.R.attr#configChanges} attribute.
public static final int
CONFIG_LOCALE
Bit in {@link #configChanges} that indicates that the activity can itself handle changes to the locale. Set from the {@link android.R.attr#configChanges} attribute.
public static final int
CONFIG_TOUCHSCREEN
Bit in {@link #configChanges} that indicates that the activity can itself handle changes to the touchscreen type. Set from the {@link android.R.attr#configChanges} attribute.
public static final int
CONFIG_KEYBOARD
Bit in {@link #configChanges} that indicates that the activity can itself handle changes to the keyboard type. Set from the {@link android.R.attr#configChanges} attribute.
public static final int
CONFIG_KEYBOARD_HIDDEN
Bit in {@link #configChanges} that indicates that the activity can itself handle changes to the keyboard or navigation being hidden/exposed. Note that inspite of the name, this applies to the changes to any hidden states: keyboard or navigation. Set from the {@link android.R.attr#configChanges} attribute.
public static final int
CONFIG_NAVIGATION
Bit in {@link #configChanges} that indicates that the activity can itself handle changes to the navigation type. Set from the {@link android.R.attr#configChanges} attribute.
public static final int
CONFIG_ORIENTATION
Bit in {@link #configChanges} that indicates that the activity can itself handle changes to the screen orientation. Set from the {@link android.R.attr#configChanges} attribute.
public static final int
CONFIG_SCREEN_LAYOUT
Bit in {@link #configChanges} that indicates that the activity can itself handle changes to the screen layout. Set from the {@link android.R.attr#configChanges} attribute.
public static final int
CONFIG_UI_MODE
Bit in {@link #configChanges} that indicates that the activity can itself handle the ui mode. Set from the {@link android.R.attr#configChanges} attribute.
public static final int
CONFIG_SCREEN_SIZE
Bit in {@link #configChanges} that indicates that the activity can itself handle the screen size. Set from the {@link android.R.attr#configChanges} attribute. This will be set by default for applications that target an earlier version than {@link android.os.Build.VERSION_CODES#HONEYCOMB_MR2}... however, you will not see the bit set here becomes some applications incorrectly compare {@link #configChanges} against an absolute value rather than correctly masking out the bits they are interested in. Please don't do that, thanks.
public static final int
CONFIG_SMALLEST_SCREEN_SIZE
Bit in {@link #configChanges} that indicates that the activity can itself handle the smallest screen size. Set from the {@link android.R.attr#configChanges} attribute. This will be set by default for applications that target an earlier version than {@link android.os.Build.VERSION_CODES#HONEYCOMB_MR2}... however, you will not see the bit set here becomes some applications incorrectly compare {@link #configChanges} against an absolute value rather than correctly masking out the bits they are interested in. Please don't do that, thanks.
public static final int
CONFIG_DENSITY
Bit in {@link #configChanges} that indicates that the activity can itself handle density changes. Set from the {@link android.R.attr#configChanges} attribute.
public static final int
CONFIG_LAYOUT_DIRECTION
Bit in {@link #configChanges} that indicates that the activity can itself handle the change to layout direction. Set from the {@link android.R.attr#configChanges} attribute.
public static final int
CONFIG_FONT_SCALE
Bit in {@link #configChanges} that indicates that the activity can itself handle changes to the font scaling factor. Set from the {@link android.R.attr#configChanges} attribute. This is not a core resource configuration, but a higher-level value, so its constant starts at the high bits.
public static int[]
CONFIG_NATIVE_BITS
public int
configChanges
Bit mask of kinds of configuration changes that this activity can handle itself (without being restarted by the system). Contains any combination of {@link #CONFIG_FONT_SCALE}, {@link #CONFIG_MCC}, {@link #CONFIG_MNC}, {@link #CONFIG_LOCALE}, {@link #CONFIG_TOUCHSCREEN}, {@link #CONFIG_KEYBOARD}, {@link #CONFIG_NAVIGATION}, {@link #CONFIG_ORIENTATION}, {@link #CONFIG_SCREEN_LAYOUT} and {@link #CONFIG_LAYOUT_DIRECTION}. Set from the {@link android.R.attr#configChanges} attribute.
public int
softInputMode
The desired soft input mode for this activity's main window. Set from the {@link android.R.attr#windowSoftInputMode} attribute in the activity's manifest. May be any of the same values allowed for {@link android.view.WindowManager.LayoutParams#softInputMode WindowManager.LayoutParams.softInputMode}. If 0 (unspecified), the mode from the theme will be used.
public int
uiOptions
The desired extra UI options for this activity and its main window. Set from the {@link android.R.attr#uiOptions} attribute in the activity's manifest.
public static final int
UIOPTION_SPLIT_ACTION_BAR_WHEN_NARROW
Flag for use with {@link #uiOptions}. Indicates that the action bar should put all action items in a separate bar when the screen is narrow.

This value corresponds to "splitActionBarWhenNarrow" for the {@link #uiOptions} XML attribute.

public String
parentActivityName
If defined, the activity named here is the logical parent of this activity.
public static final Parcelable.Creator
CREATOR
Constructors Summary
private ActivityInfo(android.os.Parcel source)


       
        super(source);
        theme = source.readInt();
        launchMode = source.readInt();
        permission = source.readString();
        taskAffinity = source.readString();
        targetActivity = source.readString();
        flags = source.readInt();
        screenOrientation = source.readInt();
        configChanges = source.readInt();
        softInputMode = source.readInt();
        uiOptions = source.readInt();
        parentActivityName = source.readString();
        persistableMode = source.readInt();
        maxRecents = source.readInt();
public ActivityInfo()
public ActivityInfo(ActivityInfo orig)

        super(orig);
        theme = orig.theme;
        launchMode = orig.launchMode;
        permission = orig.permission;
        taskAffinity = orig.taskAffinity;
        targetActivity = orig.targetActivity;
        flags = orig.flags;
        screenOrientation = orig.screenOrientation;
        configChanges = orig.configChanges;
        softInputMode = orig.softInputMode;
        uiOptions = orig.uiOptions;
        parentActivityName = orig.parentActivityName;
        maxRecents = orig.maxRecents;
Methods Summary
public static intactivityInfoConfigToNative(int input)

hide
Convert Java change bits to native.

                
         
        int output = 0;
        for (int i=0; i<CONFIG_NATIVE_BITS.length; i++) {
            if ((input&(1<<i)) != 0) {
                output |= CONFIG_NATIVE_BITS[i];
            }
        }
        return output;
public intdescribeContents()

        return 0;
public voiddump(android.util.Printer pw, java.lang.String prefix)

        super.dumpFront(pw, prefix);
        if (permission != null) {
            pw.println(prefix + "permission=" + permission);
        }
        pw.println(prefix + "taskAffinity=" + taskAffinity
                + " targetActivity=" + targetActivity
                + " persistableMode=" + persistableModeToString());
        if (launchMode != 0 || flags != 0 || theme != 0) {
            pw.println(prefix + "launchMode=" + launchMode
                    + " flags=0x" + Integer.toHexString(flags)
                    + " theme=0x" + Integer.toHexString(theme));
        }
        if (screenOrientation != SCREEN_ORIENTATION_UNSPECIFIED
                || configChanges != 0 || softInputMode != 0) {
            pw.println(prefix + "screenOrientation=" + screenOrientation
                    + " configChanges=0x" + Integer.toHexString(configChanges)
                    + " softInputMode=0x" + Integer.toHexString(softInputMode));
        }
        if (uiOptions != 0) {
            pw.println(prefix + " uiOptions=0x" + Integer.toHexString(uiOptions));
        }
        super.dumpBack(pw, prefix);
public intgetRealConfigChanged()

hide
Unfortunately some developers (OpenFeint I am looking at you) have compared the configChanges bit field against absolute values, so if we introduce a new bit they break. To deal with that, we will make sure the public field will not have a value that breaks them, and let the framework call here to get the real value.

        return applicationInfo.targetSdkVersion < android.os.Build.VERSION_CODES.HONEYCOMB_MR2
                ? (configChanges | ActivityInfo.CONFIG_SCREEN_SIZE
                        | ActivityInfo.CONFIG_SMALLEST_SCREEN_SIZE)
                : configChanges;
public final intgetThemeResource()
Return the theme resource identifier to use for this activity. If the activity defines a theme, that is used; else, the application theme is used.

return
The theme associated with this activity.

        return theme != 0 ? theme : applicationInfo.theme;
private java.lang.StringpersistableModeToString()

        switch(persistableMode) {
            case PERSIST_ROOT_ONLY: return "PERSIST_ROOT_ONLY";
            case PERSIST_NEVER: return "PERSIST_NEVER";
            case PERSIST_ACROSS_REBOOTS: return "PERSIST_ACROSS_REBOOTS";
            default: return "UNKNOWN=" + persistableMode;
        }
public java.lang.StringtoString()

        return "ActivityInfo{"
            + Integer.toHexString(System.identityHashCode(this))
            + " " + name + "}";
public voidwriteToParcel(android.os.Parcel dest, int parcelableFlags)

        super.writeToParcel(dest, parcelableFlags);
        dest.writeInt(theme);
        dest.writeInt(launchMode);
        dest.writeString(permission);
        dest.writeString(taskAffinity);
        dest.writeString(targetActivity);
        dest.writeInt(flags);
        dest.writeInt(screenOrientation);
        dest.writeInt(configChanges);
        dest.writeInt(softInputMode);
        dest.writeInt(uiOptions);
        dest.writeString(parentActivityName);
        dest.writeInt(persistableMode);
        dest.writeInt(maxRecents);