Added in API level 1

ActivityInfo

---

Kotlin |Java

open class ActivityInfo : ComponentInfo, Parcelable

kotlin.Any
↳	android.content.pm.PackageItemInfo
	↳	android.content.pm.ComponentInfo
		↳	android.content.pm.ActivityInfo

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.

Summary

Nested classes
	WindowLayout Contains information about position and size of the activity on the display.

Constants
static Int	COLOR_MODE_DEFAULT Value for colorMode indicating that the activity should use the default color mode (sRGB, low dynamic range).
static Int	COLOR_MODE_HDR Value of colorMode indicating that the activity should use a high dynamic range if the presentation display supports it.
static Int	COLOR_MODE_WIDE_COLOR_GAMUT Value of colorMode indicating that the activity should use a wide color gamut if the presentation display supports it.
static Int	CONFIG_COLOR_MODE Bit in configChanges that indicates that the activity can itself handle the change to the display color gamut or dynamic range.
static Int	CONFIG_DENSITY Bit in configChanges that indicates that the activity can itself handle density changes.
static Int	CONFIG_FONT_SCALE Bit in configChanges that indicates that the activity can itself handle changes to the font scaling factor.
static Int	CONFIG_FONT_WEIGHT_ADJUSTMENT Bit in configChanges that indicates that the activity can itself handle changes to font weight.
static Int	CONFIG_GRAMMATICAL_GENDER Bit in configChanges that indicates that the activity can itself handle the change to gender.
static Int	CONFIG_KEYBOARD Bit in configChanges that indicates that the activity can itself handle changes to the keyboard type.
static Int	CONFIG_KEYBOARD_HIDDEN Bit in configChanges that indicates that the activity can itself handle changes to the keyboard or navigation being hidden/exposed.
static Int	CONFIG_LAYOUT_DIRECTION Bit in configChanges that indicates that the activity can itself handle the change to layout direction.
static Int	CONFIG_LOCALE Bit in configChanges that indicates that the activity can itself handle changes to the locale.
static Int	CONFIG_MCC Bit in configChanges that indicates that the activity can itself handle changes to the IMSI MCC.
static Int	CONFIG_MNC Bit in configChanges that indicates that the activity can itself handle changes to the IMSI MNC.
static Int	CONFIG_NAVIGATION Bit in configChanges that indicates that the activity can itself handle changes to the navigation type.
static Int	CONFIG_ORIENTATION Bit in configChanges that indicates that the activity can itself handle changes to the screen orientation.
static Int	CONFIG_SCREEN_LAYOUT Bit in configChanges that indicates that the activity can itself handle changes to the screen layout.
static Int	CONFIG_SCREEN_SIZE Bit in configChanges that indicates that the activity can itself handle the screen size.
static Int	CONFIG_SMALLEST_SCREEN_SIZE Bit in configChanges that indicates that the activity can itself handle the smallest screen size.
static Int	CONFIG_TOUCHSCREEN Bit in configChanges that indicates that the activity can itself handle changes to the touchscreen type.
static Int	CONFIG_UI_MODE Bit in configChanges that indicates that the activity can itself handle the ui mode.
static Int	DOCUMENT_LAUNCH_ALWAYS Constant corresponding to always in the android.R.attr#documentLaunchMode attribute.
static Int	DOCUMENT_LAUNCH_INTO_EXISTING Constant corresponding to intoExisting in the android.R.attr#documentLaunchMode attribute.
static Int	DOCUMENT_LAUNCH_NEVER Constant corresponding to never in the android.R.attr#documentLaunchMode attribute.
static Int	DOCUMENT_LAUNCH_NONE Constant corresponding to none in the android.R.attr#documentLaunchMode attribute.
static Int	FLAG_ALLOW_TASK_REPARENTING Bit in flags that indicates that the activity can be moved between tasks based on its task affinity.
static Int	FLAG_ALLOW_UNTRUSTED_ACTIVITY_EMBEDDING Bit in flags: If set, indicates that the activity can be embedded by untrusted hosts.
static Int	FLAG_ALWAYS_RETAIN_TASK_STATE Bit in 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.
static Int	FLAG_AUTO_REMOVE_FROM_RECENTS Bit in 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.
static Int	FLAG_CLEAR_TASK_ON_LAUNCH Bit in 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.
static Int	FLAG_ENABLE_VR_MODE Bit in flags indicating that this activity should be run with VR mode enabled.
static Int	FLAG_EXCLUDE_FROM_RECENTS Bit in flags that indicates that the activity should not appear in the list of recently launched activities.
static Int	FLAG_FINISH_ON_CLOSE_SYSTEM_DIALOGS Bit in flags indicating that, when a request to close system windows happens, this activity is finished.
static Int	FLAG_FINISH_ON_TASK_LAUNCH Bit in flags indicating that, when the activity's task is relaunched from home, this activity should be finished.
static Int	FLAG_HARDWARE_ACCELERATED Value for flags: true when the application's rendering should be hardware accelerated.
static Int	FLAG_IMMERSIVE Bit in flags corresponding to an immersive activity that wishes not to be interrupted by notifications.
static Int	FLAG_MULTIPROCESS Bit in flags indicating whether this activity is able to run in multiple processes.
static Int	FLAG_NO_HISTORY Bit in flags indicating that, when the user navigates away from an activity, it should be finished.
static Int	FLAG_PREFER_MINIMAL_POST_PROCESSING Bit in flags indicating whether the display should preferably be switched to a minimal post processing mode.
static Int	FLAG_RELINQUISH_TASK_IDENTITY Bit in flags: If set, a task rooted at this activity will have its baseIntent replaced by the activity immediately above this.
static Int	FLAG_RESUME_WHILE_PAUSING Bit in flags indicating that this activity can start is creation/resume while the previous activity is still pausing.
static Int	FLAG_SINGLE_USER Bit in flags: If set, a single instance of the receiver will run for all users on the device.
static Int	FLAG_STATE_NOT_NEEDED Bit in 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.
static Int	LAUNCH_MULTIPLE Constant corresponding to standard in the android.R.attr#launchMode attribute.
static Int	LAUNCH_SINGLE_INSTANCE Constant corresponding to singleInstance in the android.R.attr#launchMode attribute.
static Int	LAUNCH_SINGLE_INSTANCE_PER_TASK Constant corresponding to singleInstancePerTask in the android.R.attr#launchMode attribute.
static Int	LAUNCH_SINGLE_TASK Constant corresponding to singleTask in the android.R.attr#launchMode attribute.
static Int	LAUNCH_SINGLE_TOP Constant corresponding to singleTop in the android.R.attr#launchMode attribute.
static Int	PERSIST_ACROSS_REBOOTS Constant corresponding to persistAcrossReboots in the android.R.attr#persistableMode attribute.
static Int	PERSIST_NEVER Constant corresponding to doNotPersist in the android.R.attr#persistableMode attribute.
static Int	PERSIST_ROOT_ONLY Constant corresponding to persistRootOnly in the android.R.attr#persistableMode attribute.
static Int	SCREEN_ORIENTATION_BEHIND Constant corresponding to behind in the android.R.attr#screenOrientation attribute.
static Int	SCREEN_ORIENTATION_FULL_SENSOR Constant corresponding to fullSensor in the android.R.attr#screenOrientation attribute.
static Int	SCREEN_ORIENTATION_FULL_USER Constant corresponding to fullUser in the android.R.attr#screenOrientation attribute.
static Int	SCREEN_ORIENTATION_LANDSCAPE Constant corresponding to landscape in the android.R.attr#screenOrientation attribute.
static Int	SCREEN_ORIENTATION_LOCKED Constant corresponding to locked in the android.R.attr#screenOrientation attribute.
static Int	SCREEN_ORIENTATION_NOSENSOR Constant corresponding to nosensor in the android.R.attr#screenOrientation attribute.
static Int	SCREEN_ORIENTATION_PORTRAIT Constant corresponding to portrait in the android.R.attr#screenOrientation attribute.
static Int	SCREEN_ORIENTATION_REVERSE_LANDSCAPE Constant corresponding to reverseLandscape in the android.R.attr#screenOrientation attribute.
static Int	SCREEN_ORIENTATION_REVERSE_PORTRAIT Constant corresponding to reversePortrait in the android.R.attr#screenOrientation attribute.
static Int	SCREEN_ORIENTATION_SENSOR Constant corresponding to sensor in the android.R.attr#screenOrientation attribute.
static Int	SCREEN_ORIENTATION_SENSOR_LANDSCAPE Constant corresponding to sensorLandscape in the android.R.attr#screenOrientation attribute.
static Int	SCREEN_ORIENTATION_SENSOR_PORTRAIT Constant corresponding to sensorPortrait in the android.R.attr#screenOrientation attribute.
static Int	SCREEN_ORIENTATION_UNSPECIFIED Constant corresponding to unspecified in the android.R.attr#screenOrientation attribute.
static Int	SCREEN_ORIENTATION_USER Constant corresponding to user in the android.R.attr#screenOrientation attribute.
static Int	SCREEN_ORIENTATION_USER_LANDSCAPE Constant corresponding to userLandscape in the android.R.attr#screenOrientation attribute.
static Int	SCREEN_ORIENTATION_USER_PORTRAIT Constant corresponding to userPortrait in the android.R.attr#screenOrientation attribute.
static Int	UIOPTION_SPLIT_ACTION_BAR_WHEN_NARROW Flag for use with uiOptions.

Inherited constants

From class Parcelable Int CONTENTS_FILE_DESCRIPTOR Descriptor bit used with describeContents(): indicates that the Parcelable object's flattened representation includes a file descriptor. Int PARCELABLE_WRITE_RETURN_VALUE Flag for use with writeToParcel: the object being written is a return value, that is the result of a function such as "Parcelable someFunction()", "void someFunction(out Parcelable)", or "void someFunction(inout Parcelable)". Some implementations may want to release resources at this point.

Public constructors
ActivityInfo()
ActivityInfo(orig: ActivityInfo!)

Public methods
open Int	describeContents()
open Unit	dump(pw: Printer!, prefix: String!)
open MutableSet<String!>	getKnownActivityEmbeddingCerts() Gets the trusted host certificate digests of apps that are allowed to embed this activity.
Int	getThemeResource() Return the theme resource identifier to use for this activity.
open String	toString()
open Unit	writeToParcel(dest: Parcel, parcelableFlags: Int)

Inherited functions
From class ComponentInfo Unit dumpBack(pw: Printer!, prefix: String!) Unit dumpFront(pw: Printer!, prefix: String!) Int getBannerResource() Return the banner resource identifier to use for this component. If the component defines a banner, that is used; else, the application banner is used. Int getIconResource() Return the icon resource identifier to use for this component. If the component defines an icon, that is used; else, the application icon is used. Int getLogoResource() Return the logo resource identifier to use for this component. If the component defines a logo, that is used; else, the application logo is used. Boolean isEnabled() Return whether this component and its enclosing application are enabled.
From class PackageItemInfo Drawable! loadBanner(pm: PackageManager!) Retrieve the current graphical banner associated with this item. This will call back on the given PackageManager to load the banner from the application. Drawable! loadIcon(pm: PackageManager!) Retrieve the current graphical icon associated with this item. This will call back on the given PackageManager to load the icon from the application. CharSequence loadLabel(pm: PackageManager) Retrieve the current textual label associated with this item. This will call back on the given PackageManager to load the label from the application. Drawable! loadLogo(pm: PackageManager!) Retrieve the current graphical logo associated with this item. This will call back on the given PackageManager to load the logo from the application. Drawable! loadUnbadgedIcon(pm: PackageManager!) Retrieve the current graphical icon associated with this item without the addition of a work badge if applicable. This will call back on the given PackageManager to load the icon from the application. XmlResourceParser! loadXmlMetaData(pm: PackageManager!, name: String!) Load an XML resource attached to the meta-data of this item. This will retrieved the name meta-data entry, and if defined call back on the given PackageManager to load its XML file from the application.

Properties
static Parcelable.Creator<ActivityInfo!>	CREATOR
Int	colorMode The color mode requested by this activity.
Int	configChanges Bit mask of kinds of configuration changes that this activity can handle itself (without being restarted by the system).
Int	documentLaunchMode The document launch mode style requested by the activity.
Int	flags Options that have been set in the activity declaration in the manifest.
Int	launchMode The launch mode style requested by the activity.
Int	maxRecents The maximum number of tasks rooted at this activity that can be in the recent task list.
String!	parentActivityName If defined, the activity named here is the logical parent of this activity.
String!	permission Optional name of a permission required to be able to access this Activity.
Int	persistableMode Value indicating how this activity is to be persisted across reboots for restoring in the Recents list.
String?	requiredDisplayCategory Specifies the required display category of the activity.
Int	screenOrientation The preferred screen orientation this activity would like to run in.
Int	softInputMode The desired soft input mode for this activity's main window.
String!	targetActivity If this is an activity alias, this is the real activity class to run for it.
String!	taskAffinity The affinity this activity has for another task in the system.
Int	theme A style resource identifier (in the package's resources) of this activity's theme.
Int	uiOptions The desired extra UI options for this activity and its main window.
ActivityInfo.WindowLayout!	windowLayout Information about desired position and size of activity on the display when it is first started.

Inherited properties
From class ComponentInfo ApplicationInfo! applicationInfo Global information about the application/package this component is a part of. Array<String!>! attributionTags Set of attribution tags that should be automatically applied to this component. When this component represents an Activity, Service, ContentResolver or BroadcastReceiver, each instance will be automatically configured with Context#createAttributionContext using the first attribution tag contained here. Additionally, when this component represents a BroadcastReceiver and the sender of a broadcast requires the receiver to hold one or more specific permissions, those permission checks will be performed using each of the attributions tags contained here. Int descriptionRes A string resource identifier (in the package's resources) containing a user-readable description of the component. From the "description" attribute or, if not set, 0. Boolean directBootAware Indicates if this component is aware of direct boot lifecycle, and can be safely run before the user has entered their credentials (such as a lock pattern or PIN). Boolean enabled Indicates whether or not this component may be instantiated. Note that this value can be overridden by the one in its parent ApplicationInfo. Boolean exported Set to true if this component is available for use by other applications. Comes from android:exported of the <activity>, <receiver>, <service>, or <provider> tag. String! processName The name of the process this component should run in. From the "android:process" attribute or, if not set, the same as applicationInfo.processName. String! splitName The name of the split in which this component is declared. Null if the component was declared in the base APK.
From class PackageItemInfo Int banner A drawable resource identifier (in the package's resources) of this component's banner. From the "banner" attribute or, if not set, 0. Int icon A drawable resource identifier (in the package's resources) of this component's icon. From the "icon" attribute or, if not set, 0. Boolean isArchived Whether the package is currently in an archived state. Packages can be archived through PackageInstaller#requestArchive and do not have any APKs stored on the device, but do keep the data directory. Int labelRes A string resource identifier (in the package's resources) of this component's label. From the "label" attribute or, if not set, 0. Int logo A drawable resource identifier (in the package's resources) of this component's logo. Logos may be larger/wider than icons and are displayed by certain UI elements in place of a name or name/icon combination. From the "logo" attribute or, if not set, 0. Bundle! metaData Additional meta-data associated with this component. This field will only be filled in if you set the PackageManager#GET_META_DATA flag when requesting the info. String! name Public name of this item. From the "android:name" attribute. CharSequence! nonLocalizedLabel The string provided in the AndroidManifest file, if any. You probably don't want to use this. You probably want PackageManager#getApplicationLabel String! packageName Name of the package that this item is in.

Constants

COLOR_MODE_DEFAULT

Added in API level 26

static val COLOR_MODE_DEFAULT: Int

Value for colorMode indicating that the activity should use the default color mode (sRGB, low dynamic range).

Value: 0

See Also

• android.R.attr#colorMode

COLOR_MODE_HDR

Added in API level 26

static val COLOR_MODE_HDR: Int

Value of colorMode indicating that the activity should use a high dynamic range if the presentation display supports it.

Value: 2

See Also

• android.R.attr#colorMode

COLOR_MODE_WIDE_COLOR_GAMUT

Added in API level 26

static val COLOR_MODE_WIDE_COLOR_GAMUT: Int

Value of colorMode indicating that the activity should use a wide color gamut if the presentation display supports it.

Value: 1

See Also

• android.R.attr#colorMode

CONFIG_COLOR_MODE

Added in API level 26

static val CONFIG_COLOR_MODE: Int

Bit in configChanges that indicates that the activity can itself handle the change to the display color gamut or dynamic range. Set from the android.R.attr#configChanges attribute.

Value: 16384

CONFIG_DENSITY

Added in API level 17

static val CONFIG_DENSITY: Int

Bit in configChanges that indicates that the activity can itself handle density changes. Set from the android.R.attr#configChanges attribute.

Value: 4096

CONFIG_FONT_SCALE

Added in API level 1

static val CONFIG_FONT_SCALE: Int

Bit in configChanges that indicates that the activity can itself handle changes to the font scaling factor. Set from the 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.

Value: 1073741824

CONFIG_FONT_WEIGHT_ADJUSTMENT

Added in API level 31

static val CONFIG_FONT_WEIGHT_ADJUSTMENT: Int

Bit in configChanges that indicates that the activity can itself handle changes to font weight. Set from the 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.

Value: 268435456

CONFIG_GRAMMATICAL_GENDER

Added in API level 34

static val CONFIG_GRAMMATICAL_GENDER: Int

Bit in configChanges that indicates that the activity can itself handle the change to gender. Set from the android.R.attr#configChanges attribute.

Value: 32768

CONFIG_KEYBOARD

Added in API level 1

static val CONFIG_KEYBOARD: Int

Bit in configChanges that indicates that the activity can itself handle changes to the keyboard type. Set from the android.R.attr#configChanges attribute.

Value: 16

CONFIG_KEYBOARD_HIDDEN

Added in API level 1

static val CONFIG_KEYBOARD_HIDDEN: Int

Bit in 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 android.R.attr#configChanges attribute.

Value: 32

CONFIG_LAYOUT_DIRECTION

Added in API level 17

static val CONFIG_LAYOUT_DIRECTION: Int

Bit in configChanges that indicates that the activity can itself handle the change to layout direction. Set from the android.R.attr#configChanges attribute.

Value: 8192

CONFIG_LOCALE

Added in API level 1

static val CONFIG_LOCALE: Int

Bit in configChanges that indicates that the activity can itself handle changes to the locale. Set from the android.R.attr#configChanges attribute.

Value: 4

CONFIG_MCC

Added in API level 1

static val CONFIG_MCC: Int

Bit in configChanges that indicates that the activity can itself handle changes to the IMSI MCC. Set from the android.R.attr#configChanges attribute.

Value: 1

CONFIG_MNC

Added in API level 1

static val CONFIG_MNC: Int

Bit in configChanges that indicates that the activity can itself handle changes to the IMSI MNC. Set from the android.R.attr#configChanges attribute.

Value: 2

CONFIG_NAVIGATION

Added in API level 1

static val CONFIG_NAVIGATION: Int

Bit in configChanges that indicates that the activity can itself handle changes to the navigation type. Set from the android.R.attr#configChanges attribute.

Value: 64

CONFIG_ORIENTATION

Added in API level 1

static val CONFIG_ORIENTATION: Int

Bit in configChanges that indicates that the activity can itself handle changes to the screen orientation. Set from the android.R.attr#configChanges attribute.

Value: 128

CONFIG_SCREEN_LAYOUT

Added in API level 4

static val CONFIG_SCREEN_LAYOUT: Int

Bit in configChanges that indicates that the activity can itself handle changes to the screen layout. Set from the android.R.attr#configChanges attribute.

Value: 256

CONFIG_SCREEN_SIZE

Added in API level 13

static val CONFIG_SCREEN_SIZE: Int

Bit in configChanges that indicates that the activity can itself handle the screen size. Set from the android.R.attr#configChanges attribute. This will be set by default for applications that target an earlier version than android.os.Build.VERSION_CODES#HONEYCOMB_MR2... however, you will not see the bit set here becomes some applications incorrectly compare configChanges against an absolute value rather than correctly masking out the bits they are interested in. Please don't do that, thanks.

Value: 1024

CONFIG_SMALLEST_SCREEN_SIZE

Added in API level 13

static val CONFIG_SMALLEST_SCREEN_SIZE: Int

Bit in configChanges that indicates that the activity can itself handle the smallest screen size. Set from the android.R.attr#configChanges attribute. This will be set by default for applications that target an earlier version than android.os.Build.VERSION_CODES#HONEYCOMB_MR2... however, you will not see the bit set here becomes some applications incorrectly compare configChanges against an absolute value rather than correctly masking out the bits they are interested in. Please don't do that, thanks.

Value: 2048

CONFIG_TOUCHSCREEN

Added in API level 1

static val CONFIG_TOUCHSCREEN: Int

Bit in configChanges that indicates that the activity can itself handle changes to the touchscreen type. Set from the android.R.attr#configChanges attribute.

Value: 8

CONFIG_UI_MODE

Added in API level 8

static val CONFIG_UI_MODE: Int

Bit in configChanges that indicates that the activity can itself handle the ui mode. Set from the android.R.attr#configChanges attribute.

Value: 512

DOCUMENT_LAUNCH_ALWAYS

Added in API level 21

static val DOCUMENT_LAUNCH_ALWAYS: Int

Constant corresponding to always in the android.R.attr#documentLaunchMode attribute.

Value: 2

DOCUMENT_LAUNCH_INTO_EXISTING

Added in API level 21

static val DOCUMENT_LAUNCH_INTO_EXISTING: Int

Constant corresponding to intoExisting in the android.R.attr#documentLaunchMode attribute.

Value: 1

DOCUMENT_LAUNCH_NEVER

Added in API level 21

static val DOCUMENT_LAUNCH_NEVER: Int

Constant corresponding to never in the android.R.attr#documentLaunchMode attribute.

Value: 3

DOCUMENT_LAUNCH_NONE

Added in API level 21

static val DOCUMENT_LAUNCH_NONE: Int

Constant corresponding to none in the android.R.attr#documentLaunchMode attribute.

Value: 0

FLAG_ALLOW_TASK_REPARENTING

Added in API level 1

static val FLAG_ALLOW_TASK_REPARENTING: Int

Bit in flags that indicates that the activity can be moved between tasks based on its task affinity. Set from the android.R.attr#allowTaskReparenting attribute.

Value: 64

FLAG_ALLOW_UNTRUSTED_ACTIVITY_EMBEDDING

Added in API level 33

static val FLAG_ALLOW_UNTRUSTED_ACTIVITY_EMBEDDING: Int

Bit in flags: If set, indicates that the activity can be embedded by untrusted hosts. In this case the interactions with and visibility of the embedded activity may be limited. Set from the android.R.attr#allowUntrustedActivityEmbedding attribute.

Value: 268435456

FLAG_ALWAYS_RETAIN_TASK_STATE

Added in API level 1

static val FLAG_ALWAYS_RETAIN_TASK_STATE: Int

Bit in 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 android.R.attr#alwaysRetainTaskState attribute.

Value: 8

FLAG_AUTO_REMOVE_FROM_RECENTS

Added in API level 21

static val FLAG_AUTO_REMOVE_FROM_RECENTS: Int

Bit in 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 android.R.attr#autoRemoveFromRecents

Value: 8192

FLAG_CLEAR_TASK_ON_LAUNCH

Added in API level 1

static val FLAG_CLEAR_TASK_ON_LAUNCH: Int

Bit in 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 android.R.attr#clearTaskOnLaunch attribute.

Value: 4

FLAG_ENABLE_VR_MODE

Added in API level 24

static val FLAG_ENABLE_VR_MODE: Int

Bit in flags indicating that this activity should be run with VR mode enabled.

Value: 32768

See Also

• android.app.Activity#setVrModeEnabled(boolean, ComponentName)

FLAG_EXCLUDE_FROM_RECENTS

Added in API level 1

static val FLAG_EXCLUDE_FROM_RECENTS: Int

Bit in flags that indicates that the activity should not appear in the list of recently launched activities. Set from the android.R.attr#excludeFromRecents attribute.

Value: 32

FLAG_FINISH_ON_CLOSE_SYSTEM_DIALOGS

Added in API level 5

static val FLAG_FINISH_ON_CLOSE_SYSTEM_DIALOGS: Int

Bit in flags indicating that, when a request to close system windows happens, this activity is finished. Set from the android.R.attr#finishOnCloseSystemDialogs attribute.

Value: 256

FLAG_FINISH_ON_TASK_LAUNCH

Added in API level 1

static val FLAG_FINISH_ON_TASK_LAUNCH: Int

Bit in flags indicating that, when the activity's task is relaunched from home, this activity should be finished. Set from the android.R.attr#finishOnTaskLaunch attribute.

Value: 2

FLAG_HARDWARE_ACCELERATED

Added in API level 11

static val FLAG_HARDWARE_ACCELERATED: Int

Value for flags: true when the application's rendering should be hardware accelerated.

Value: 512

FLAG_IMMERSIVE

Added in API level 18

static val FLAG_IMMERSIVE: Int

Bit in flags corresponding to an immersive activity that wishes not to be interrupted by notifications. Applications that hide the system notification bar with android.view.WindowManager.LayoutParams#FLAG_FULLSCREEN may still be interrupted by high-priority notifications; for example, an incoming phone call may use fullScreenIntent to present a full-screen in-call activity to the user, pausing the current activity as a side-effect. An activity with 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 android.app.Activity#setImmersive(boolean).

Value: 2048

See Also

• android.app.Notification#FLAG_HIGH_PRIORITY
• android.app.Activity#setImmersive(boolean)

FLAG_MULTIPROCESS

Added in API level 1

static val FLAG_MULTIPROCESS: Int

Bit in 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 processName. Set from the android.R.attr#multiprocess attribute.

Value: 1

FLAG_NO_HISTORY

Added in API level 3

static val FLAG_NO_HISTORY: Int

Bit in flags indicating that, when the user navigates away from an activity, it should be finished. Set from the android.R.attr#noHistory attribute.

Value: 128

FLAG_PREFER_MINIMAL_POST_PROCESSING

Added in API level 30

static val FLAG_PREFER_MINIMAL_POST_PROCESSING: Int

Bit in flags indicating whether the display should preferably be switched to a minimal post processing mode. See android.R.attr#preferMinimalPostProcessing

Value: 33554432

FLAG_RELINQUISH_TASK_IDENTITY

Added in API level 21

static val FLAG_RELINQUISH_TASK_IDENTITY: Int

Bit in 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 android.R.attr#relinquishTaskIdentity attribute.

Value: 4096

FLAG_RESUME_WHILE_PAUSING

Added in API level 21

static val FLAG_RESUME_WHILE_PAUSING: Int

Bit in flags indicating that this activity can start is creation/resume while the previous activity is still pausing. Corresponds to android.R.attr#resumeWhilePausing

Value: 16384

FLAG_SINGLE_USER

Added in API level 17

static val FLAG_SINGLE_USER: Int

Bit in flags: If set, a single instance of the receiver will run for all users on the device. Set from the 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.

Value: 1073741824

FLAG_STATE_NOT_NEEDED

Added in API level 1

static val FLAG_STATE_NOT_NEEDED: Int

Bit in 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 android.R.attr#stateNotNeeded attribute.

Value: 16

LAUNCH_MULTIPLE

Added in API level 1

static val LAUNCH_MULTIPLE: Int

Constant corresponding to standard in the android.R.attr#launchMode attribute.

Value: 0

LAUNCH_SINGLE_INSTANCE

Added in API level 1

static val LAUNCH_SINGLE_INSTANCE: Int

Constant corresponding to singleInstance in the android.R.attr#launchMode attribute.

Value: 3

LAUNCH_SINGLE_INSTANCE_PER_TASK

Added in API level 31

static val LAUNCH_SINGLE_INSTANCE_PER_TASK: Int

Constant corresponding to singleInstancePerTask in the android.R.attr#launchMode attribute.

Value: 4

LAUNCH_SINGLE_TASK

Added in API level 1

static val LAUNCH_SINGLE_TASK: Int

Constant corresponding to singleTask in the android.R.attr#launchMode attribute.

Value: 2

LAUNCH_SINGLE_TOP

Added in API level 1

static val LAUNCH_SINGLE_TOP: Int

Constant corresponding to singleTop in the android.R.attr#launchMode attribute.

Value: 1

PERSIST_ACROSS_REBOOTS

Added in API level 21

static val PERSIST_ACROSS_REBOOTS: Int

Constant corresponding to persistAcrossReboots in the android.R.attr#persistableMode attribute.

Value: 2

PERSIST_NEVER

Added in API level 21

static val PERSIST_NEVER: Int

Constant corresponding to doNotPersist in the android.R.attr#persistableMode attribute.

Value: 1

PERSIST_ROOT_ONLY

Added in API level 21

static val PERSIST_ROOT_ONLY: Int

Constant corresponding to persistRootOnly in the android.R.attr#persistableMode attribute.

Value: 0

SCREEN_ORIENTATION_BEHIND

Added in API level 1

static val SCREEN_ORIENTATION_BEHIND: Int

Constant corresponding to behind in the android.R.attr#screenOrientation attribute.

Value: 3

SCREEN_ORIENTATION_FULL_SENSOR

Added in API level 9

static val SCREEN_ORIENTATION_FULL_SENSOR: Int

Constant corresponding to fullSensor in the android.R.attr#screenOrientation attribute.

Value: 10

SCREEN_ORIENTATION_FULL_USER

Added in API level 18

static val SCREEN_ORIENTATION_FULL_USER: Int

Constant corresponding to fullUser in the android.R.attr#screenOrientation attribute.

Value: 13

SCREEN_ORIENTATION_LANDSCAPE

Added in API level 1

static val SCREEN_ORIENTATION_LANDSCAPE: Int

Constant corresponding to landscape in the android.R.attr#screenOrientation attribute.

Value: 0

SCREEN_ORIENTATION_LOCKED

Added in API level 18

static val SCREEN_ORIENTATION_LOCKED: Int

Constant corresponding to locked in the android.R.attr#screenOrientation attribute.

Value: 14

SCREEN_ORIENTATION_NOSENSOR

Added in API level 1

static val SCREEN_ORIENTATION_NOSENSOR: Int

Constant corresponding to nosensor in the android.R.attr#screenOrientation attribute.

Value: 5

SCREEN_ORIENTATION_PORTRAIT

Added in API level 1

static val SCREEN_ORIENTATION_PORTRAIT: Int

Constant corresponding to portrait in the android.R.attr#screenOrientation attribute.

Value: 1

SCREEN_ORIENTATION_REVERSE_LANDSCAPE

Added in API level 9

static val SCREEN_ORIENTATION_REVERSE_LANDSCAPE: Int

Constant corresponding to reverseLandscape in the android.R.attr#screenOrientation attribute.

Value: 8

SCREEN_ORIENTATION_REVERSE_PORTRAIT

Added in API level 9

static val SCREEN_ORIENTATION_REVERSE_PORTRAIT: Int

Constant corresponding to reversePortrait in the android.R.attr#screenOrientation attribute.

Value: 9

SCREEN_ORIENTATION_SENSOR

Added in API level 1

static val SCREEN_ORIENTATION_SENSOR: Int

Constant corresponding to sensor in the android.R.attr#screenOrientation attribute.

Value: 4

SCREEN_ORIENTATION_SENSOR_LANDSCAPE

Added in API level 9

static val SCREEN_ORIENTATION_SENSOR_LANDSCAPE: Int

Constant corresponding to sensorLandscape in the android.R.attr#screenOrientation attribute.

Value: 6

SCREEN_ORIENTATION_SENSOR_PORTRAIT

Added in API level 9

static val SCREEN_ORIENTATION_SENSOR_PORTRAIT: Int

Constant corresponding to sensorPortrait in the android.R.attr#screenOrientation attribute.

Value: 7

SCREEN_ORIENTATION_UNSPECIFIED

Added in API level 1

static val SCREEN_ORIENTATION_UNSPECIFIED: Int

Constant corresponding to unspecified in the android.R.attr#screenOrientation attribute.

Value: -1

SCREEN_ORIENTATION_USER

Added in API level 1

static val SCREEN_ORIENTATION_USER: Int

Constant corresponding to user in the android.R.attr#screenOrientation attribute.

Value: 2

SCREEN_ORIENTATION_USER_LANDSCAPE

Added in API level 18

static val SCREEN_ORIENTATION_USER_LANDSCAPE: Int

Constant corresponding to userLandscape in the android.R.attr#screenOrientation attribute.

Value: 11

SCREEN_ORIENTATION_USER_PORTRAIT

Added in API level 18

static val SCREEN_ORIENTATION_USER_PORTRAIT: Int

Constant corresponding to userPortrait in the android.R.attr#screenOrientation attribute.

Value: 12

UIOPTION_SPLIT_ACTION_BAR_WHEN_NARROW

Added in API level 14

static val UIOPTION_SPLIT_ACTION_BAR_WHEN_NARROW: Int

Flag for use with 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 uiOptions XML attribute.

Value: 1

Public constructors

ActivityInfo

Added in API level 1

ActivityInfo()

ActivityInfo

Added in API level 1

ActivityInfo(orig: ActivityInfo!)

Public methods

describeContents

Added in API level 1

open fun describeContents(): Int

Return
Int	a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either 0 or android.os.Parcelable#CONTENTS_FILE_DESCRIPTOR

dump

Added in API level 1

open fun dump(
    pw: Printer!, 
    prefix: String!
): Unit

getKnownActivityEmbeddingCerts

Added in API level 33

open fun getKnownActivityEmbeddingCerts(): MutableSet<String!>

Gets the trusted host certificate digests of apps that are allowed to embed this activity. The digests are computed using the SHA-256 digest algorithm.

Return
MutableSet<String!>	This value cannot be null.

See Also

• android.R.attr#knownActivityEmbeddingCerts

getThemeResource

Added in API level 1

fun getThemeResource(): Int

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
Int	The theme associated with this activity.

toString

Added in API level 1

open fun toString(): String

Return
String	a string representation of the object.

writeToParcel

Added in API level 1

open fun writeToParcel(
    dest: Parcel, 
    parcelableFlags: Int
): Unit

Parameters
dest	Parcel: The Parcel in which the object should be written. This value cannot be null.
flags	Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE. Value is either 0 or a combination of android.os.Parcelable#PARCELABLE_WRITE_RETURN_VALUE, and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES

Properties

CREATOR

Added in API level 1

static val CREATOR: Parcelable.Creator<ActivityInfo!>

colorMode

Added in API level 26

var colorMode: Int

The color mode requested by this activity. The target display may not be able to honor the request.
Value is android.content.pm.ActivityInfo#COLOR_MODE_DEFAULT, android.content.pm.ActivityInfo#COLOR_MODE_WIDE_COLOR_GAMUT, android.content.pm.ActivityInfo#COLOR_MODE_HDR, or android.content.pm.ActivityInfo.COLOR_MODE_A8

configChanges

Added in API level 1

var configChanges: Int

Bit mask of kinds of configuration changes that this activity can handle itself (without being restarted by the system). Contains any combination of CONFIG_FONT_SCALE, CONFIG_MCC, CONFIG_MNC, CONFIG_LOCALE, CONFIG_TOUCHSCREEN, CONFIG_KEYBOARD, CONFIG_NAVIGATION, CONFIG_ORIENTATION, CONFIG_SCREEN_LAYOUT, CONFIG_DENSITY, CONFIG_LAYOUT_DIRECTION, CONFIG_COLOR_MODE, and {link #CONFIG_GRAMMATICAL_GENDER}. Set from the android.R.attr#configChanges attribute.

documentLaunchMode

Added in API level 21

var documentLaunchMode: Int

The document launch mode style requested by the activity. From the android.R.attr#documentLaunchMode attribute, one of DOCUMENT_LAUNCH_NONE, DOCUMENT_LAUNCH_INTO_EXISTING, DOCUMENT_LAUNCH_ALWAYS.

Modes DOCUMENT_LAUNCH_ALWAYS and DOCUMENT_LAUNCH_INTO_EXISTING are equivalent to Intent.FLAG_ACTIVITY_NEW_DOCUMENT with and without Intent.FLAG_ACTIVITY_MULTIPLE_TASK respectively.

flags

Added in API level 1

var flags: Int

Options that have been set in the activity declaration in the manifest. These include: FLAG_MULTIPROCESS, FLAG_FINISH_ON_TASK_LAUNCH, FLAG_CLEAR_TASK_ON_LAUNCH, FLAG_ALWAYS_RETAIN_TASK_STATE, FLAG_STATE_NOT_NEEDED, FLAG_EXCLUDE_FROM_RECENTS, FLAG_ALLOW_TASK_REPARENTING, FLAG_NO_HISTORY, FLAG_FINISH_ON_CLOSE_SYSTEM_DIALOGS, FLAG_HARDWARE_ACCELERATED, FLAG_SINGLE_USER, FLAG_ALLOW_UNTRUSTED_ACTIVITY_EMBEDDING.

launchMode

Added in API level 1

var launchMode: Int

The launch mode style requested by the activity. From the android.R.attr#launchMode attribute.
Value is android.content.pm.ActivityInfo#LAUNCH_MULTIPLE, android.content.pm.ActivityInfo#LAUNCH_SINGLE_TOP, android.content.pm.ActivityInfo#LAUNCH_SINGLE_TASK, android.content.pm.ActivityInfo#LAUNCH_SINGLE_INSTANCE, or android.content.pm.ActivityInfo#LAUNCH_SINGLE_INSTANCE_PER_TASK

maxRecents

Added in API level 21

var maxRecents: Int

The maximum number of tasks rooted at this activity that can be in the recent task list. Refer to android.R.attr#maxRecents.

parentActivityName

Added in API level 16

var parentActivityName: String!

If defined, the activity named here is the logical parent of this activity.

permission

Added in API level 1

var permission: String!

Optional name of a permission required to be able to access this Activity. From the "permission" attribute.

persistableMode

Added in API level 21

var persistableMode: Int

Value indicating how this activity is to be persisted across reboots for restoring in the Recents list. android.R.attr#persistableMode

requiredDisplayCategory

Added in API level 34

var requiredDisplayCategory: String?

Specifies the required display category of the activity. Set from the android.R.attr#requiredDisplayCategory attribute. Upon creation, a display can specify which display categories it supports and one of the category must be present in the <activity> element to allow this activity to run. The default value is null, which indicates the activity does not have a required display category and thus can only run on a display that didn't specify any display categories. Each activity can only specify one required category but a display can support multiple display categories.

This field should be formatted as a Java-language-style free form string(for example, com.google.automotive_entertainment), which may contain uppercase or lowercase letters ('A' through 'Z'), numbers, and underscores ('_') but may only start with letters.

screenOrientation

Added in API level 1

var screenOrientation: Int

The preferred screen orientation this activity would like to run in. From the android.R.attr#screenOrientation attribute, one of SCREEN_ORIENTATION_UNSPECIFIED, SCREEN_ORIENTATION_LANDSCAPE, SCREEN_ORIENTATION_PORTRAIT, SCREEN_ORIENTATION_USER, SCREEN_ORIENTATION_BEHIND, SCREEN_ORIENTATION_SENSOR, SCREEN_ORIENTATION_NOSENSOR, SCREEN_ORIENTATION_SENSOR_LANDSCAPE, SCREEN_ORIENTATION_SENSOR_PORTRAIT, SCREEN_ORIENTATION_REVERSE_LANDSCAPE, SCREEN_ORIENTATION_REVERSE_PORTRAIT, SCREEN_ORIENTATION_FULL_SENSOR, SCREEN_ORIENTATION_USER_LANDSCAPE, SCREEN_ORIENTATION_USER_PORTRAIT, SCREEN_ORIENTATION_FULL_USER, SCREEN_ORIENTATION_LOCKED,
Value is android.content.pm.ActivityInfo.SCREEN_ORIENTATION_UNSET, android.content.pm.ActivityInfo#SCREEN_ORIENTATION_UNSPECIFIED, android.content.pm.ActivityInfo#SCREEN_ORIENTATION_LANDSCAPE, android.content.pm.ActivityInfo#SCREEN_ORIENTATION_PORTRAIT, android.content.pm.ActivityInfo#SCREEN_ORIENTATION_USER, android.content.pm.ActivityInfo#SCREEN_ORIENTATION_BEHIND, android.content.pm.ActivityInfo#SCREEN_ORIENTATION_SENSOR, android.content.pm.ActivityInfo#SCREEN_ORIENTATION_NOSENSOR, android.content.pm.ActivityInfo#SCREEN_ORIENTATION_SENSOR_LANDSCAPE, android.content.pm.ActivityInfo#SCREEN_ORIENTATION_SENSOR_PORTRAIT, android.content.pm.ActivityInfo#SCREEN_ORIENTATION_REVERSE_LANDSCAPE, android.content.pm.ActivityInfo#SCREEN_ORIENTATION_REVERSE_PORTRAIT, android.content.pm.ActivityInfo#SCREEN_ORIENTATION_FULL_SENSOR, android.content.pm.ActivityInfo#SCREEN_ORIENTATION_USER_LANDSCAPE, android.content.pm.ActivityInfo#SCREEN_ORIENTATION_USER_PORTRAIT, android.content.pm.ActivityInfo#SCREEN_ORIENTATION_FULL_USER, or android.content.pm.ActivityInfo#SCREEN_ORIENTATION_LOCKED

softInputMode

Added in API level 3

var softInputMode: Int

The desired soft input mode for this activity's main window. Set from the android.R.attr#windowSoftInputMode attribute in the activity's manifest. May be any of the same values allowed for WindowManager.LayoutParams.softInputMode. If 0 (unspecified), the mode from the theme will be used.
Value is either 0 or a combination of android.view.WindowManager.LayoutParams#SOFT_INPUT_STATE_UNSPECIFIED, android.view.WindowManager.LayoutParams#SOFT_INPUT_STATE_UNCHANGED, android.view.WindowManager.LayoutParams#SOFT_INPUT_STATE_HIDDEN, android.view.WindowManager.LayoutParams#SOFT_INPUT_STATE_ALWAYS_HIDDEN, android.view.WindowManager.LayoutParams#SOFT_INPUT_STATE_VISIBLE, android.view.WindowManager.LayoutParams#SOFT_INPUT_STATE_ALWAYS_VISIBLE, android.view.WindowManager.LayoutParams#SOFT_INPUT_ADJUST_UNSPECIFIED, android.view.WindowManager.LayoutParams#SOFT_INPUT_ADJUST_RESIZE, android.view.WindowManager.LayoutParams#SOFT_INPUT_ADJUST_PAN, android.view.WindowManager.LayoutParams#SOFT_INPUT_ADJUST_NOTHING, and android.view.WindowManager.LayoutParams#SOFT_INPUT_IS_FORWARD_NAVIGATION

targetActivity

Added in API level 1

var targetActivity: String!

If this is an activity alias, this is the real activity class to run for it. Otherwise, this is null.

taskAffinity

Added in API level 1

var taskAffinity: String!

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 android.R.attr#taskAffinity attribute.

theme

Added in API level 1

var theme: Int

A style resource identifier (in the package's resources) of this activity's theme. From the "theme" attribute or, if not set, 0.

uiOptions

Added in API level 14

var uiOptions: Int

The desired extra UI options for this activity and its main window. Set from the android.R.attr#uiOptions attribute in the activity's manifest.

windowLayout

Added in API level 24

var windowLayout: ActivityInfo.WindowLayout!

Information about desired position and size of activity on the display when it is first started.