ComponentActivity

Added in 1.0.0

Kotlin |Java

public class ComponentActivity extends Activity implements LifecycleOwner, ContextAware, ViewModelStoreOwner, HasDefaultViewModelProviderFactory, SavedStateRegistryOwner, OnBackPressedDispatcherOwner, ActivityResultRegistryOwner, ActivityResultCaller, OnConfigurationChangedProvider, OnTrimMemoryProvider, OnNewIntentProvider, OnMultiWindowModeChangedProvider, OnPictureInPictureModeChangedProvider, OnUserLeaveHintProvider, MenuHost, FullyDrawnReporterOwner

java.lang.Object
↳	android.content.Context
	↳	android.content.ContextWrapper
		↳	android.view.ContextThemeWrapper
			↳	android.app.Activity
				↳	androidx.activity.ComponentActivity

Known direct subclasses

FragmentActivity, SdkActivity

`FragmentActivity`	Base class for activities that want to use the support-based `Fragments`.
`SdkActivity`	Activity to start for SDKs running locally.

Known indirect subclasses

AppCompatActivity, BaseCarAppActivity, CarAppActivity, LauncherActivity

`AppCompatActivity`	Base class for activities that wish to use some of the newer platform features on older Android devices.
`BaseCarAppActivity`	Core logic for CarAppLibrary Activity interaction with a host.
`CarAppActivity`	The class representing a car app activity in the main display.
`LauncherActivity`	This class handles providing the right launcher activity when running native applications and Car App Library applications.

Base class for activities that enables composition of higher level components.

Rather than all functionality being built directly into this class, only the minimal set of lower level building blocks are included. Higher level components can then be used as needed without enforcing a deep Activity class hierarchy or strong coupling between components.

Summary

Public constructors
`ComponentActivity()`
`@ContentView ComponentActivity(@LayoutRes int contentLayoutId)` Alternate constructor that can be used to provide a default layout that will be inflated as part of `super.onCreate(savedInstanceState)`.

Public methods
`void`	`addContentView(View view, ViewGroup.LayoutParams params)`
`void`	`addMenuProvider(@NonNull MenuProvider provider)` Adds the given `MenuProvider` to this `MenuHost`.
`void`	`addMenuProvider( @NonNull MenuProvider provider, @NonNull LifecycleOwner owner )` Adds the given `MenuProvider` to this `MenuHost`.
`void`	`addMenuProvider( @NonNull MenuProvider provider, @NonNull LifecycleOwner owner, @NonNull Lifecycle.State state )` Adds the given `MenuProvider` to this `MenuHost` once the given `LifecycleOwner` reaches the given `Lifecycle.State`.
`final void`	`addOnConfigurationChangedListener( @NonNull Consumer<@NonNull Configuration> listener )` Add a new listener that will get a callback associated with ComponentCallbacks.onConfigurationChanged with the new `Configuration`.
`final void`	`addOnContextAvailableListener( @NonNull OnContextAvailableListener listener )` {@inheritDoc}
`final void`	`addOnMultiWindowModeChangedListener( @NonNull Consumer<@NonNull MultiWindowModeChangedInfo> listener )` Add a new listener that will get a callback associated with `Activity.onMultiWindowModeChanged` with the new `MultiWindowModeChangedInfo`.
`final void`	`addOnNewIntentListener(@NonNull Consumer<@NonNull Intent> listener)` Add a new listener that will get a callback associated with `Activity.onNewIntent` with the new `Intent`.
`final void`	`addOnPictureInPictureModeChangedListener( @NonNull Consumer<@NonNull PictureInPictureModeChangedInfo> listener )` Add a new listener that will get a callback associated with `Activity.onPictureInPictureModeChanged` with the new `PictureInPictureModeChangedInfo`.
`final void`	`addOnTrimMemoryListener(@NonNull Consumer<@NonNull Integer> listener)` Add a new listener that will get a callback associated with ComponentCallbacks2.onTrimMemory with the `int` representing the level of trimming.
`final void`	`addOnUserLeaveHintListener(@NonNull Runnable listener)` Add a new listener that will get a callback associated with `Activity.onUserLeaveHint`
`final @NonNull ActivityResultRegistry`	`getActivityResultRegistry()` Get the `ActivityResultRegistry` associated with this activity.
`@NonNull CreationExtras`	`@CallSuper getDefaultViewModelCreationExtras()` {@inheritDoc}
`@NonNull ViewModelProvider.Factory`	`getDefaultViewModelProviderFactory()`
`@NonNull FullyDrawnReporter`	`getFullyDrawnReporter()` Retrieve the `FullyDrawnReporter` that should handle the independent parts of the UI that separately report that they are fully drawn.
`Object`	`getLastCustomNonConfigurationInstance()` This method is deprecated. Use a {@link androidx.lifecycle.ViewModel} to store non config state.
`@NonNull Lifecycle`	`getLifecycle()` {@inheritDoc}
`final @NonNull OnBackPressedDispatcher`	`getOnBackPressedDispatcher()` Retrieve the `OnBackPressedDispatcher` that will be triggered when `onBackPressed` is called.
`final @NonNull SavedStateRegistry`	`getSavedStateRegistry()`
`@NonNull ViewModelStore`	`getViewModelStore()` Returns the `ViewModelStore` associated with this activity
`void`	`@CallSuper initializeViewTreeOwners()` Sets the view tree owners before setting the content view so that the inflation process and attach listeners will see them already present.
`void`	`invalidateMenu()` Invalidates the `android.view.Menu` to ensure that what is displayed matches the current internal state of the menu.
`void`	`@MainThread @CallSuper onBackPressed()` This method is deprecated. This method has been deprecated in favor of using the {@link OnBackPressedDispatcher} via {@link #getOnBackPressedDispatcher()}.
`void`	`@CallSuper onConfigurationChanged(@NonNull Configuration newConfig)` {@inheritDoc}
`boolean`	`onCreatePanelMenu(int featureId, @NonNull Menu menu)`
`boolean`	`onMenuItemSelected(int featureId, @NonNull MenuItem item)`
`void`	`@CallSuper onMultiWindowModeChanged(boolean isInMultiWindowMode)` This method is deprecated. Deprecated in android.app.Activity
`void`	`@RequiresApi(api = 26) @CallSuper onMultiWindowModeChanged( boolean isInMultiWindowMode, @NonNull Configuration newConfig )` {@inheritDoc}
`void`	`onPanelClosed(int featureId, @NonNull Menu menu)`
`void`	`@CallSuper onPictureInPictureModeChanged(boolean isInPictureInPictureMode)` This method is deprecated. Deprecated in android.app.Activity
`void`	`@RequiresApi(api = 26) @CallSuper onPictureInPictureModeChanged( boolean isInPictureInPictureMode, @NonNull Configuration newConfig )` {@inheritDoc}
`boolean`	`onPreparePanel(int featureId, View view, @NonNull Menu menu)`
`void`	`@CallSuper onRequestPermissionsResult( int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults )` This method is deprecated. This method has been deprecated in favor of using the Activity Result API which brings increased type safety via an {@link ActivityResultContract} and the prebuilt contracts for common intents available in {@link androidx.activity.result.contract.ActivityResultContracts}, provides hooks for testing, and allow receiving results in separate, testable classes independent from your activity.
`Object`	`onRetainCustomNonConfigurationInstance()` This method is deprecated. Use a {@link androidx.lifecycle.ViewModel} to store non config state.
`final Object`	`onRetainNonConfigurationInstance()` Retain all appropriate non-config state.
`void`	`@CallSuper onTrimMemory(int level)` {@inheritDoc}
`Context`	`peekAvailableContext()` Get the `Context` if it is currently available.
`final @NonNull ActivityResultLauncher<@NonNull I>`	`<I extends Object, O extends Object> registerForActivityResult( @NonNull ActivityResultContract<@NonNull I, @NonNull O> contract, @NonNull ActivityResultCallback<@NonNull O> callback )` Register a request to `start an activity for result`, designated by the given `contract`.
`final @NonNull ActivityResultLauncher<@NonNull I>`	`<I extends Object, O extends Object> registerForActivityResult( @NonNull ActivityResultContract<@NonNull I, @NonNull O> contract, @NonNull ActivityResultRegistry registry, @NonNull ActivityResultCallback<@NonNull O> callback )` Register a request to `start an activity for result`, designated by the given `contract`.
`void`	`removeMenuProvider(@NonNull MenuProvider provider)` Removes the given `MenuProvider` from this `MenuHost`.
`final void`	`removeOnConfigurationChangedListener( @NonNull Consumer<@NonNull Configuration> listener )` Remove a previously added listener.
`final void`	`removeOnContextAvailableListener( @NonNull OnContextAvailableListener listener )` Remove a `OnContextAvailableListener` previously added via `addOnContextAvailableListener`.
`final void`	`removeOnMultiWindowModeChangedListener( @NonNull Consumer<@NonNull MultiWindowModeChangedInfo> listener )` Remove a previously added listener.
`final void`	`removeOnNewIntentListener(@NonNull Consumer<@NonNull Intent> listener)` Remove a previously added listener.
`final void`	`removeOnPictureInPictureModeChangedListener( @NonNull Consumer<@NonNull PictureInPictureModeChangedInfo> listener )` Remove a previously added listener.
`final void`	`removeOnTrimMemoryListener(@NonNull Consumer<@NonNull Integer> listener)` Remove a previously added listener.
`final void`	`removeOnUserLeaveHintListener(@NonNull Runnable listener)` Remove a previously added listener.
`void`	`reportFullyDrawn()`
`void`	`setContentView(@LayoutRes int layoutResID)`
`void`	`setContentView(View view)`
`void`	`setContentView(View view, ViewGroup.LayoutParams params)`
`void`	`startActivityForResult(@NonNull Intent intent, int requestCode)` This method is deprecated. This method has been deprecated in favor of using the Activity Result API which brings increased type safety via an {@link ActivityResultContract} and the prebuilt contracts for common intents available in {@link androidx.activity.result.contract.ActivityResultContracts}, provides hooks for testing, and allow receiving results in separate, testable classes independent from your activity.
`void`	`startActivityForResult( @NonNull Intent intent, int requestCode, Bundle options )` This method is deprecated. This method has been deprecated in favor of using the Activity Result API which brings increased type safety via an {@link ActivityResultContract} and the prebuilt contracts for common intents available in {@link androidx.activity.result.contract.ActivityResultContracts}, provides hooks for testing, and allow receiving results in separate, testable classes independent from your activity.
`void`	`startIntentSenderForResult( @NonNull IntentSender intent, int requestCode, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags )` This method is deprecated. This method has been deprecated in favor of using the Activity Result API which brings increased type safety via an {@link ActivityResultContract} and the prebuilt contracts for common intents available in {@link androidx.activity.result.contract.ActivityResultContracts}, provides hooks for testing, and allow receiving results in separate, testable classes independent from your activity.
`void`	`startIntentSenderForResult( @NonNull IntentSender intent, int requestCode, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, Bundle options )` This method is deprecated. This method has been deprecated in favor of using the Activity Result API which brings increased type safety via an {@link ActivityResultContract} and the prebuilt contracts for common intents available in {@link androidx.activity.result.contract.ActivityResultContracts}, provides hooks for testing, and allow receiving results in separate, testable classes independent from your activity.

Protected methods
`void`	`@CallSuper onActivityResult(int requestCode, int resultCode, Intent data)` This method is deprecated. This method has been deprecated in favor of using the Activity Result API which brings increased type safety via an {@link ActivityResultContract} and the prebuilt contracts for common intents available in {@link androidx.activity.result.contract.ActivityResultContracts}, provides hooks for testing, and allow receiving results in separate, testable classes independent from your activity.
`void`	`onCreate(Bundle savedInstanceState)` {@inheritDoc}
`void`	`@CallSuper onNewIntent(@NonNull Intent intent)` {@inheritDoc}
`void`	`@CallSuper onSaveInstanceState(@NonNull Bundle outState)`
`void`	`@CallSuper onUserLeaveHint()` {@inheritDoc}

Extension functions
`final @NonNull Lazy<@NonNull VM>`	`@MainThread <VM extends ViewModel> ActivityViewModelLazyKt.viewModels( @NonNull ComponentActivity receiver, Function0<@NonNull CreationExtras> extrasProducer, Function0<@NonNull ViewModelProvider.Factory> factoryProducer )` Returns a `Lazy` delegate to access the ComponentActivity's ViewModel, if `factoryProducer` is specified then `ViewModelProvider.Factory` returned by it will be used to create `ViewModel` first time.
`final void`	`EdgeToEdge.enableEdgeToEdge( @NonNull ComponentActivity receiver, @NonNull SystemBarStyle statusBarStyle, @NonNull SystemBarStyle navigationBarStyle )` Enables the edge-to-edge display for this `ComponentActivity`.

Extension functions

final @NonNull Lazy<@NonNull VM>

@MainThread
<VM extends ViewModel> ActivityViewModelLazyKt.viewModels(
    @NonNull ComponentActivity receiver,
    Function0<@NonNull CreationExtras> extrasProducer,
    Function0<@NonNull ViewModelProvider.Factory> factoryProducer
)

Returns a Lazy delegate to access the ComponentActivity's ViewModel, if factoryProducer is specified then ViewModelProvider.Factory returned by it will be used to create ViewModel first time.

final void

EdgeToEdge.enableEdgeToEdge(
    @NonNull ComponentActivity receiver,
    @NonNull SystemBarStyle statusBarStyle,
    @NonNull SystemBarStyle navigationBarStyle
)

Enables the edge-to-edge display for this ComponentActivity.

Inherited methods

From android.app.Activity

`void`	`attachBaseContext(@NonNull Context p0)`
`void`	`clearOverrideActivityTransition(int p0)`
`void`	`closeContextMenu()`
`void`	`closeOptionsMenu()`
`@NonNull PendingIntent`	`createPendingResult(int p0, @NonNull Intent p1, int p2)`
`final void`	`dismissDialog(int p0)` This method is deprecated. Deprecated in Java
`final void`	`dismissKeyboardShortcutsHelper()`
`boolean`	`dispatchGenericMotionEvent(@NonNull MotionEvent p0)`
`boolean`	`dispatchPopulateAccessibilityEvent(@NonNull AccessibilityEvent p0)`
`boolean`	`dispatchTouchEvent(@NonNull MotionEvent p0)`
`boolean`	`dispatchTrackballEvent(@NonNull MotionEvent p0)`
`void`	`dump( @NonNull String p0, @Nullable FileDescriptor p1, @NonNull PrintWriter p2, @Nullable String[] p3 )`
`void`	`enterPictureInPictureMode()` This method is deprecated. Deprecated in Java
`boolean`	`enterPictureInPictureMode(@NonNull PictureInPictureParams p0)`
`@NonNull T`	`<T extends View> findViewById(int p0)`
`void`	`finish()`
`void`	`finishActivity(int p0)`
`void`	`finishActivityFromChild(@NonNull Activity p0, int p1)` This method is deprecated. Deprecated in Java
`void`	`finishAffinity()`
`void`	`finishAfterTransition()`
`void`	`finishAndRemoveTask()`
`void`	`finishFromChild(@NonNull Activity p0)` This method is deprecated. Deprecated in Java
`@Nullable ActionBar`	`getActionBar()`
`final @NonNull Application`	`getApplication()`
`@Nullable ComponentName`	`getCallingActivity()`
`@Nullable String`	`getCallingPackage()`
`int`	`getChangingConfigurations()`
`@NonNull ComponentName`	`getComponentName()`
`@NonNull Scene`	`getContentScene()`
`@NonNull TransitionManager`	`getContentTransitionManager()`
`@Nullable View`	`getCurrentFocus()`
`@NonNull FragmentManager`	`getFragmentManager()` This method is deprecated. Deprecated in Java
`@NonNull Intent`	`getIntent()`
`@Nullable Object`	`getLastNonConfigurationInstance()`
`@Nullable String`	`getLaunchedFromPackage()`
`int`	`getLaunchedFromUid()`
`@NonNull LayoutInflater`	`getLayoutInflater()`
`@NonNull LoaderManager`	`getLoaderManager()` This method is deprecated. Deprecated in Java
`@NonNull String`	`getLocalClassName()`
`int`	`getMaxNumPictureInPictureActions()`
`final @NonNull MediaController`	`getMediaController()`
`@NonNull MenuInflater`	`getMenuInflater()`
`@NonNull OnBackInvokedDispatcher`	`getOnBackInvokedDispatcher()`
`final @NonNull Activity`	`getParent()`
`@Nullable Intent`	`getParentActivityIntent()`
`@NonNull SharedPreferences`	`getPreferences(int p0)`
`@Nullable Uri`	`getReferrer()`
`int`	`getRequestedOrientation()`
`final @NonNull SearchEvent`	`getSearchEvent()`
`final @NonNull SplashScreen`	`getSplashScreen()`
`@NonNull Object`	`getSystemService(@RecentlyNonNull @NonNull String p0)`
`int`	`getTaskId()`
`final @NonNull CharSequence`	`getTitle()`
`final int`	`getTitleColor()`
`@NonNull VoiceInteractor`	`getVoiceInteractor()`
`final int`	`getVolumeControlStream()`
`@NonNull Window`	`getWindow()`
`@NonNull WindowManager`	`getWindowManager()`
`boolean`	`hasWindowFocus()`
`void`	`invalidateOptionsMenu()`
`boolean`	`isActivityTransitionRunning()`
`boolean`	`isChangingConfigurations()`
`final boolean`	`isChild()`
`boolean`	`isDestroyed()`
`boolean`	`isFinishing()`
`boolean`	`isImmersive()`
`boolean`	`isInMultiWindowMode()`
`boolean`	`isInPictureInPictureMode()`
`boolean`	`isLaunchedFromBubble()`
`boolean`	`isLocalVoiceInteractionSupported()`
`boolean`	`isTaskRoot()`
`boolean`	`isVoiceInteraction()`
`boolean`	`isVoiceInteractionRoot()`
`final @NonNull Cursor`	`managedQuery( @NonNull Uri p0, @NonNull String[] p1, @NonNull String p2, @NonNull String[] p3, @NonNull String p4 )` This method is deprecated. Deprecated in Java
`boolean`	`moveTaskToBack(boolean p0)`
`boolean`	`navigateUpTo(@NonNull Intent p0)`
`boolean`	`navigateUpToFromChild(@NonNull Activity p0, @NonNull Intent p1)` This method is deprecated. Deprecated in Java
`void`	`onActionModeFinished(@NonNull ActionMode p0)`
`void`	`onActionModeStarted(@NonNull ActionMode p0)`
`void`	`onActivityReenter(int p0, @NonNull Intent p1)`
`void`	`onApplyThemeResource(@NonNull Resources.Theme p0, int p1, boolean p2)`
`void`	`onAttachFragment(@NonNull Fragment p0)` This method is deprecated. Deprecated in Java
`void`	`onAttachedToWindow()`
`void`	`onChildTitleChanged(@NonNull Activity p0, @NonNull CharSequence p1)`
`void`	`onContentChanged()`
`boolean`	`onContextItemSelected(@NonNull MenuItem p0)`
`void`	`onContextMenuClosed(@NonNull Menu p0)`
`void`	`onCreate(@Nullable Bundle p0, @Nullable PersistableBundle p1)`
`void`	`onCreateContextMenu( @NonNull ContextMenu p0, @NonNull View p1, @NonNull ContextMenu.ContextMenuInfo p2 )`
`@Nullable CharSequence`	`onCreateDescription()`
`@NonNull Dialog`	`onCreateDialog(int p0)` This method is deprecated. Deprecated in Java
`@Nullable Dialog`	`onCreateDialog(int p0, @NonNull Bundle p1)` This method is deprecated. Deprecated in Java
`void`	`onCreateNavigateUpTaskStack(@NonNull TaskStackBuilder p0)`
`boolean`	`onCreateOptionsMenu(@NonNull Menu p0)`
`@Nullable View`	`onCreatePanelView(int p0)`
`boolean`	`onCreateThumbnail(@NonNull Bitmap p0, @NonNull Canvas p1)` This method is deprecated. Deprecated in Java
`@Nullable View`	`onCreateView( @NonNull String p0, @NonNull Context p1, @NonNull AttributeSet p2 )`
`@Nullable View`	`onCreateView( @Nullable View p0, @NonNull String p1, @NonNull Context p2, @NonNull AttributeSet p3 )`
`void`	`onDestroy()`
`void`	`onDetachedFromWindow()`
`void`	`onEnterAnimationComplete()`
`boolean`	`onGenericMotionEvent(@NonNull MotionEvent p0)`
`void`	`onGetDirectActions( @NonNull CancellationSignal p0, @NonNull Consumer<@NonNull List<@NonNull DirectAction>> p1 )`
`boolean`	`onKeyDown(int p0, @NonNull KeyEvent p1)`
`boolean`	`onKeyLongPress(int p0, @NonNull KeyEvent p1)`
`boolean`	`onKeyMultiple(int p0, int p1, @NonNull KeyEvent p2)`
`boolean`	`onKeyShortcut(int p0, @NonNull KeyEvent p1)`
`boolean`	`onKeyUp(int p0, @NonNull KeyEvent p1)`
`void`	`onLocalVoiceInteractionStarted()`
`void`	`onLocalVoiceInteractionStopped()`
`void`	`onLowMemory()`
`boolean`	`onMenuOpened(int p0, @NonNull Menu p1)`
`boolean`	`onNavigateUp()`
`boolean`	`onNavigateUpFromChild(@NonNull Activity p0)` This method is deprecated. Deprecated in Java
`boolean`	`onOptionsItemSelected(@NonNull MenuItem p0)`
`void`	`onOptionsMenuClosed(@NonNull Menu p0)`
`void`	`onPause()`
`void`	`onPerformDirectAction( @NonNull String p0, @NonNull Bundle p1, @NonNull CancellationSignal p2, @NonNull Consumer<@NonNull Bundle> p3 )`
`boolean`	`onPictureInPictureRequested()`
`void`	`onPictureInPictureUiStateChanged(@NonNull PictureInPictureUiState p0)`
`void`	`onPostCreate(@Nullable Bundle p0)`
`void`	`onPostCreate(@Nullable Bundle p0, @Nullable PersistableBundle p1)`
`void`	`onPostResume()`
`void`	`onPrepareDialog(int p0, @NonNull Dialog p1)` This method is deprecated. Deprecated in Java
`void`	`onPrepareDialog(int p0, @NonNull Dialog p1, @NonNull Bundle p2)` This method is deprecated. Deprecated in Java
`void`	`onPrepareNavigateUpTaskStack(@NonNull TaskStackBuilder p0)`
`boolean`	`onPrepareOptionsMenu(@NonNull Menu p0)`
`void`	`onProvideAssistContent(@NonNull AssistContent p0)`
`void`	`onProvideAssistData(@NonNull Bundle p0)`
`void`	`onProvideKeyboardShortcuts( @NonNull List<@NonNull KeyboardShortcutGroup> p0, Menu p1, int p2 )`
`@NonNull Uri`	`onProvideReferrer()`
`void`	`onRestart()`
`void`	`onRestoreInstanceState(@NonNull Bundle p0)`
`void`	`onRestoreInstanceState(@Nullable Bundle p0, @Nullable PersistableBundle p1)`
`void`	`onResume()`
`void`	`onSaveInstanceState(@NonNull Bundle p0, @NonNull PersistableBundle p1)`
`boolean`	`onSearchRequested()`
`boolean`	`onSearchRequested(@Nullable SearchEvent p0)`
`void`	`onStart()`
`void`	`onStateNotSaved()` This method is deprecated. Deprecated in Java
`void`	`onStop()`
`void`	`onTitleChanged(@NonNull CharSequence p0, int p1)`
`void`	`onTopResumedActivityChanged(boolean p0)`
`boolean`	`onTouchEvent(@NonNull MotionEvent p0)`
`boolean`	`onTrackballEvent(@NonNull MotionEvent p0)`
`void`	`onUserInteraction()`
`void`	`onVisibleBehindCanceled()` This method is deprecated. Deprecated in Java
`void`	`onWindowAttributesChanged(@NonNull WindowManager.LayoutParams p0)`
`void`	`onWindowFocusChanged(boolean p0)`
`@Nullable ActionMode`	`onWindowStartingActionMode(@NonNull ActionMode.Callback p0)`
`@Nullable ActionMode`	`onWindowStartingActionMode(@NonNull ActionMode.Callback p0, int p1)`
`void`	`openContextMenu(@NonNull View p0)`
`void`	`openOptionsMenu()`
`void`	`overrideActivityTransition(int p0, int p1, int p2)`
`void`	`overrideActivityTransition(int p0, int p1, int p2, int p3)`
`void`	`overridePendingTransition(int p0, int p1)` This method is deprecated. Deprecated in Java
`void`	`overridePendingTransition(int p0, int p1, int p2)` This method is deprecated. Deprecated in Java
`void`	`postponeEnterTransition()`
`void`	`recreate()`
`void`	`registerActivityLifecycleCallbacks( @NonNull Application.ActivityLifecycleCallbacks p0 )`
`void`	`registerComponentCallbacks(@NonNull ComponentCallbacks p0)`
`void`	`registerForContextMenu(@NonNull View p0)`
`void`	`registerScreenCaptureCallback( @NonNull Executor p0, @NonNull Activity.ScreenCaptureCallback p1 )`
`boolean`	`releaseInstance()`
`final void`	`removeDialog(int p0)` This method is deprecated. Deprecated in Java
`@NonNull DragAndDropPermissions`	`requestDragAndDropPermissions(@NonNull DragEvent p0)`
`void`	`requestFullscreenMode( int p0, @Nullable OutcomeReceiver<@NonNull Void, @NonNull Throwable> p1 )`
`final void`	`requestPermissions(@NonNull String[] p0, int p1)`
`final void`	`requestShowKeyboardShortcuts()`
`boolean`	`requestVisibleBehind(boolean p0)` This method is deprecated. Deprecated in Java
`final boolean`	`requestWindowFeature(int p0)`
`final @NonNull T`	`<T extends View> requireViewById(int p0)`
`final void`	`runOnUiThread(@NonNull Runnable p0)`
`void`	`setActionBar(@Nullable Toolbar p0)`
`void`	`setContentTransitionManager(@NonNull TransitionManager p0)`
`final void`	`setDefaultKeyMode(int p0)`
`void`	`setEnterSharedElementCallback(@NonNull SharedElementCallback p0)`
`void`	`setExitSharedElementCallback(@NonNull SharedElementCallback p0)`
`final void`	`setFeatureDrawable(int p0, @NonNull Drawable p1)`
`final void`	`setFeatureDrawableAlpha(int p0, int p1)`
`final void`	`setFeatureDrawableResource(int p0, int p1)`
`final void`	`setFeatureDrawableUri(int p0, @NonNull Uri p1)`
`void`	`setFinishOnTouchOutside(boolean p0)`
`void`	`setImmersive(boolean p0)`
`void`	`setInheritShowWhenLocked(boolean p0)`
`void`	`setIntent(@NonNull Intent p0)`
`void`	`setLocusContext(@Nullable LocusId p0, @Nullable Bundle p1)`
`final void`	`setMediaController(@NonNull MediaController p0)`
`void`	`setPictureInPictureParams(@NonNull PictureInPictureParams p0)`
`final void`	`setProgress(int p0)` This method is deprecated. Deprecated in Java
`final void`	`setProgressBarIndeterminate(boolean p0)` This method is deprecated. Deprecated in Java
`final void`	`setProgressBarIndeterminateVisibility(boolean p0)` This method is deprecated. Deprecated in Java
`final void`	`setProgressBarVisibility(boolean p0)` This method is deprecated. Deprecated in Java
`void`	`setRecentsScreenshotEnabled(boolean p0)`
`void`	`setRequestedOrientation(int p0)`
`final void`	`setResult(int p0)`
`final void`	`setResult(int p0, @NonNull Intent p1)`
`final void`	`setSecondaryProgress(int p0)` This method is deprecated. Deprecated in Java
`void`	`setShouldDockBigOverlays(boolean p0)`
`void`	`setShowWhenLocked(boolean p0)`
`void`	`setTaskDescription(@NonNull ActivityManager.TaskDescription p0)`
`void`	`setTheme(int p0)`
`void`	`setTitle(@NonNull CharSequence p0)`
`void`	`setTitle(int p0)`
`void`	`setTitleColor(int p0)` This method is deprecated. Deprecated in Java
`boolean`	`setTranslucent(boolean p0)`
`void`	`setTurnScreenOn(boolean p0)`
`void`	`setVisible(boolean p0)`
`final void`	`setVolumeControlStream(int p0)`
`void`	`setVrModeEnabled(boolean p0, @NonNull ComponentName p1)`
`boolean`	`shouldDockBigOverlays()`
`boolean`	`shouldShowRequestPermissionRationale(@NonNull String p0)`
`boolean`	`shouldUpRecreateTask(@NonNull Intent p0)`
`boolean`	`showAssist(@NonNull Bundle p0)`
`final void`	`showDialog(int p0)` This method is deprecated. Deprecated in Java
`final boolean`	`showDialog(int p0, @NonNull Bundle p1)` This method is deprecated. Deprecated in Java
`void`	`showLockTaskEscapeMessage()`
`@Nullable ActionMode`	`startActionMode(@NonNull ActionMode.Callback p0)`
`@Nullable ActionMode`	`startActionMode(@NonNull ActionMode.Callback p0, int p1)`
`void`	`startActivities(@NonNull Intent[] p0)`
`void`	`startActivities(@NonNull Intent[] p0, @Nullable Bundle p1)`
`void`	`startActivity(@NonNull Intent p0)`
`void`	`startActivity(@NonNull Intent p0, @Nullable Bundle p1)`
`void`	`startActivityFromChild(@NonNull Activity p0, @NonNull Intent p1, int p2)` This method is deprecated. Deprecated in Java
`void`	`startActivityFromChild( @NonNull Activity p0, @NonNull Intent p1, int p2, @Nullable Bundle p3 )` This method is deprecated. Deprecated in Java
`void`	`startActivityFromFragment(@NonNull Fragment p0, @NonNull Intent p1, int p2)` This method is deprecated. Deprecated in Java
`void`	`startActivityFromFragment( @NonNull Fragment p0, @NonNull Intent p1, int p2, @Nullable Bundle p3 )` This method is deprecated. Deprecated in Java
`boolean`	`startActivityIfNeeded(@NonNull Intent p0, int p1)`
`boolean`	`startActivityIfNeeded(@NonNull Intent p0, int p1, @Nullable Bundle p2)`
`void`	`startIntentSender( @NonNull IntentSender p0, @Nullable Intent p1, int p2, int p3, int p4 )`
`void`	`startIntentSender( @NonNull IntentSender p0, @Nullable Intent p1, int p2, int p3, int p4, @Nullable Bundle p5 )`
`void`	`startIntentSenderFromChild( @NonNull Activity p0, @NonNull IntentSender p1, int p2, @NonNull Intent p3, int p4, int p5, int p6 )` This method is deprecated. Deprecated in Java
`void`	`startIntentSenderFromChild( @NonNull Activity p0, @NonNull IntentSender p1, int p2, @NonNull Intent p3, int p4, int p5, int p6, @Nullable Bundle p7 )` This method is deprecated. Deprecated in Java
`void`	`startLocalVoiceInteraction(@NonNull Bundle p0)`
`void`	`startLockTask()`
`void`	`startManagingCursor(@NonNull Cursor p0)` This method is deprecated. Deprecated in Java
`boolean`	`startNextMatchingActivity(@NonNull Intent p0)`
`boolean`	`startNextMatchingActivity(@NonNull Intent p0, @Nullable Bundle p1)`
`void`	`startPostponedEnterTransition()`
`void`	`startSearch(@Nullable String p0, boolean p1, @Nullable Bundle p2, boolean p3)`
`void`	`stopLocalVoiceInteraction()`
`void`	`stopLockTask()`
`void`	`stopManagingCursor(@NonNull Cursor p0)` This method is deprecated. Deprecated in Java
`void`	`takeKeyEvents(boolean p0)`
`void`	`triggerSearch(@NonNull String p0, @Nullable Bundle p1)`
`void`	`unregisterActivityLifecycleCallbacks( @NonNull Application.ActivityLifecycleCallbacks p0 )`
`void`	`unregisterComponentCallbacks(@NonNull ComponentCallbacks p0)`
`void`	`unregisterForContextMenu(@NonNull View p0)`
`void`	`unregisterScreenCaptureCallback( @NonNull Activity.ScreenCaptureCallback p0 )`

From android.content.Context

`boolean`	`bindIsolatedService( @NonNull Intent p0, @NonNull Context.BindServiceFlags p1, @NonNull String p2, @NonNull Executor p3, @NonNull ServiceConnection p4 )`
`final int`	`getColor(int p0)`
`final @NonNull ColorStateList`	`getColorStateList(int p0)`
`final @Nullable Drawable`	`getDrawable(int p0)`
`final @NonNull String`	`getString(int p0)`
`final @NonNull String`	`getString(int p0, @NonNull Object p1)`
`final @NonNull T`	`<T extends Object> getSystemService(@NonNull Class<@NonNull T> p0)`
`final @NonNull CharSequence`	`getText(int p0)`
`final @NonNull TypedArray`	`obtainStyledAttributes(@NonNull int[] p0)`
`final @NonNull TypedArray`	`obtainStyledAttributes(@Nullable AttributeSet p0, @NonNull int[] p1)`
`final @NonNull TypedArray`	`obtainStyledAttributes(int p0, @NonNull int[] p1)`
`final @NonNull TypedArray`	`obtainStyledAttributes( @Nullable AttributeSet p0, @NonNull int[] p1, int p2, int p3 )`
`void`	`revokeSelfPermissionOnKill(@NonNull String p0)`
`void`	`sendBroadcastWithMultiplePermissions( @NonNull Intent p0, @NonNull String[] p1 )`

From android.view.ContextThemeWrapper

`void`	`applyOverrideConfiguration(@NonNull Configuration p0)`
`@NonNull AssetManager`	`getAssets()`
`@NonNull Resources`	`getResources()`
`@NonNull Resources.Theme`	`getTheme()`
`void`	`setTheme(@Nullable Resources.Theme p0)`

From android.content.ContextWrapper

`boolean`	`bindIsolatedService( @NonNull Intent p0, int p1, @NonNull String p2, @NonNull Executor p3, @NonNull ServiceConnection p4 )`
`boolean`	`bindService( @NonNull Intent p0, @NonNull ServiceConnection p1, @NonNull Context.BindServiceFlags p2 )`
`boolean`	`bindService(@NonNull Intent p0, @NonNull ServiceConnection p1, int p2)`
`boolean`	`bindService( @NonNull Intent p0, @NonNull Context.BindServiceFlags p1, @NonNull Executor p2, @NonNull ServiceConnection p3 )`
`boolean`	`bindService( @NonNull Intent p0, int p1, @NonNull Executor p2, @NonNull ServiceConnection p3 )`
`boolean`	`bindServiceAsUser( @NonNull Intent p0, @NonNull ServiceConnection p1, @NonNull Context.BindServiceFlags p2, @NonNull UserHandle p3 )`
`boolean`	`bindServiceAsUser( @NonNull Intent p0, @NonNull ServiceConnection p1, int p2, @NonNull UserHandle p3 )`
`int`	`checkCallingOrSelfPermission(@NonNull String p0)`
`int`	`checkCallingOrSelfUriPermission(@NonNull Uri p0, int p1)`
`@NonNull int[]`	`checkCallingOrSelfUriPermissions(@NonNull List<@NonNull Uri> p0, int p1)`
`int`	`checkCallingPermission(@NonNull String p0)`
`int`	`checkCallingUriPermission(@NonNull Uri p0, int p1)`
`@NonNull int[]`	`checkCallingUriPermissions(@NonNull List<@NonNull Uri> p0, int p1)`
`int`	`checkPermission(@NonNull String p0, int p1, int p2)`
`int`	`checkSelfPermission(@NonNull String p0)`
`int`	`checkUriPermission(@NonNull Uri p0, int p1, int p2, int p3)`
`int`	`checkUriPermission( @Nullable Uri p0, @Nullable String p1, @Nullable String p2, int p3, int p4, int p5 )`
`@NonNull int[]`	`checkUriPermissions(@NonNull List<@NonNull Uri> p0, int p1, int p2, int p3)`
`void`	`clearWallpaper()` This method is deprecated. Deprecated in Java
`@NonNull Context`	`createAttributionContext(@Nullable String p0)`
`@NonNull Context`	`createConfigurationContext(@NonNull Configuration p0)`
`@NonNull Context`	`createContext(@NonNull ContextParams p0)`
`@NonNull Context`	`createContextForSplit(@NonNull String p0)`
`@NonNull Context`	`createDeviceContext(int p0)`
`@NonNull Context`	`createDeviceProtectedStorageContext()`
`@NonNull Context`	`createDisplayContext(@NonNull Display p0)`
`@NonNull Context`	`createPackageContext(@NonNull String p0, int p1)`
`@NonNull Context`	`createWindowContext(int p0, @Nullable Bundle p1)`
`@NonNull Context`	`createWindowContext(@NonNull Display p0, int p1, @Nullable Bundle p2)`
`@NonNull String[]`	`databaseList()`
`boolean`	`deleteDatabase(@NonNull String p0)`
`boolean`	`deleteFile(@NonNull String p0)`
`boolean`	`deleteSharedPreferences(@NonNull String p0)`
`void`	`enforceCallingOrSelfPermission(@NonNull String p0, @Nullable String p1)`
`void`	`enforceCallingOrSelfUriPermission( @NonNull Uri p0, int p1, @NonNull String p2 )`
`void`	`enforceCallingPermission(@NonNull String p0, @Nullable String p1)`
`void`	`enforceCallingUriPermission(@NonNull Uri p0, int p1, @NonNull String p2)`
`void`	`enforcePermission(@NonNull String p0, int p1, int p2, @Nullable String p3)`
`void`	`enforceUriPermission( @NonNull Uri p0, int p1, int p2, int p3, @NonNull String p4 )`
`void`	`enforceUriPermission( @Nullable Uri p0, @Nullable String p1, @Nullable String p2, int p3, int p4, int p5, @Nullable String p6 )`
`@NonNull String[]`	`fileList()`
`@NonNull Context`	`getApplicationContext()`
`@NonNull ApplicationInfo`	`getApplicationInfo()`
`@NonNull AttributionSource`	`getAttributionSource()`
`@Nullable String`	`getAttributionTag()`
`@NonNull Context`	`getBaseContext()`
`@NonNull File`	`getCacheDir()`
`@NonNull ClassLoader`	`getClassLoader()`
`@NonNull File`	`getCodeCacheDir()`
`@NonNull ContentResolver`	`getContentResolver()`
`@NonNull File`	`getDataDir()`
`@NonNull File`	`getDatabasePath(@NonNull String p0)`
`int`	`getDeviceId()`
`@NonNull File`	`getDir(@NonNull String p0, int p1)`
`@Nullable Display`	`getDisplay()`
`@Nullable File`	`getExternalCacheDir()`
`@NonNull File[]`	`getExternalCacheDirs()`
`@Nullable File`	`getExternalFilesDir(@Nullable String p0)`
`@NonNull File[]`	`getExternalFilesDirs(@NonNull String p0)`
`@NonNull File[]`	`getExternalMediaDirs()`
`@NonNull File`	`getFileStreamPath(@NonNull String p0)`
`@NonNull File`	`getFilesDir()`
`@NonNull Executor`	`getMainExecutor()`
`@NonNull Looper`	`getMainLooper()`
`@NonNull File`	`getNoBackupFilesDir()`
`@NonNull File`	`getObbDir()`
`@NonNull File[]`	`getObbDirs()`
`@NonNull String`	`getOpPackageName()`
`@NonNull String`	`getPackageCodePath()`
`@NonNull PackageManager`	`getPackageManager()`
`@NonNull String`	`getPackageName()`
`@NonNull String`	`getPackageResourcePath()`
`@Nullable ContextParams`	`getParams()`
`@NonNull SharedPreferences`	`getSharedPreferences(@NonNull String p0, int p1)`
`String`	`getSystemServiceName(@NonNull Class<@NonNull ?> p0)`
`@NonNull Drawable`	`getWallpaper()` This method is deprecated. Deprecated in Java
`int`	`getWallpaperDesiredMinimumHeight()` This method is deprecated. Deprecated in Java
`int`	`getWallpaperDesiredMinimumWidth()` This method is deprecated. Deprecated in Java
`void`	`grantUriPermission(@NonNull String p0, @NonNull Uri p1, int p2)`
`boolean`	`isDeviceProtectedStorage()`
`boolean`	`isRestricted()`
`boolean`	`isUiContext()`
`boolean`	`moveDatabaseFrom(@NonNull Context p0, @NonNull String p1)`
`boolean`	`moveSharedPreferencesFrom(@NonNull Context p0, @NonNull String p1)`
`@NonNull FileInputStream`	`openFileInput(@NonNull String p0)`
`@NonNull FileOutputStream`	`openFileOutput(@NonNull String p0, int p1)`
`@NonNull SQLiteDatabase`	`openOrCreateDatabase( @NonNull String p0, int p1, @NonNull SQLiteDatabase.CursorFactory p2 )`
`@NonNull SQLiteDatabase`	`openOrCreateDatabase( @NonNull String p0, int p1, @NonNull SQLiteDatabase.CursorFactory p2, @Nullable DatabaseErrorHandler p3 )`
`@NonNull Drawable`	`peekWallpaper()` This method is deprecated. Deprecated in Java
`void`	`registerDeviceIdChangeListener( @NonNull Executor p0, @NonNull IntConsumer p1 )`
`Intent`	`registerReceiver(@Nullable BroadcastReceiver p0, @NonNull IntentFilter p1)`
`Intent`	`registerReceiver( @Nullable BroadcastReceiver p0, @NonNull IntentFilter p1, int p2 )`
`Intent`	`registerReceiver( @Nullable BroadcastReceiver p0, @NonNull IntentFilter p1, @Nullable String p2, @Nullable Handler p3 )`
`Intent`	`registerReceiver( @Nullable BroadcastReceiver p0, @NonNull IntentFilter p1, @Nullable String p2, @Nullable Handler p3, int p4 )`
`void`	`removeStickyBroadcast(@NonNull Intent p0)` This method is deprecated. Deprecated in Java
`void`	`removeStickyBroadcastAsUser(@NonNull Intent p0, @NonNull UserHandle p1)` This method is deprecated. Deprecated in Java
`void`	`revokeSelfPermissionsOnKill(@NonNull Collection<@NonNull String> p0)`
`void`	`revokeUriPermission(@NonNull Uri p0, int p1)`
`void`	`revokeUriPermission(@NonNull String p0, @NonNull Uri p1, int p2)`
`void`	`sendBroadcast(@NonNull Intent p0)`
`void`	`sendBroadcast(@NonNull Intent p0, @Nullable String p1)`
`void`	`sendBroadcast(@NonNull Intent p0, @Nullable String p1, @Nullable Bundle p2)`
`void`	`sendBroadcastAsUser(@NonNull Intent p0, @NonNull UserHandle p1)`
`void`	`sendBroadcastAsUser(@NonNull Intent p0, @NonNull UserHandle p1, String p2)`
`void`	`sendOrderedBroadcast(@NonNull Intent p0, @Nullable String p1)`
`void`	`sendOrderedBroadcast( @NonNull Intent p0, @Nullable String p1, @Nullable Bundle p2 )`
`void`	`sendOrderedBroadcast( @NonNull Intent p0, @Nullable String p1, @Nullable BroadcastReceiver p2, @Nullable Handler p3, int p4, @Nullable String p5, @Nullable Bundle p6 )`
`void`	`sendOrderedBroadcast( @NonNull Intent p0, @Nullable String p1, @Nullable Bundle p2, @Nullable BroadcastReceiver p3, @Nullable Handler p4, int p5, @Nullable String p6, @Nullable Bundle p7 )`
`void`	`sendOrderedBroadcast( @NonNull Intent p0, @Nullable String p1, @Nullable String p2, @Nullable BroadcastReceiver p3, @Nullable Handler p4, int p5, @Nullable String p6, @Nullable Bundle p7 )`
`void`	`sendOrderedBroadcast( @NonNull Intent p0, int p1, @Nullable String p2, @Nullable String p3, @Nullable BroadcastReceiver p4, @Nullable Handler p5, @Nullable String p6, @Nullable Bundle p7, @Nullable Bundle p8 )`
`void`	`sendOrderedBroadcastAsUser( @NonNull Intent p0, @NonNull UserHandle p1, @Nullable String p2, @Nullable BroadcastReceiver p3, @Nullable Handler p4, int p5, @Nullable String p6, @Nullable Bundle p7 )`
`void`	`sendStickyBroadcast(@NonNull Intent p0)` This method is deprecated. Deprecated in Java
`void`	`sendStickyBroadcast(@NonNull Intent p0, @Nullable Bundle p1)` This method is deprecated. Deprecated in Java
`void`	`sendStickyBroadcastAsUser(@NonNull Intent p0, @NonNull UserHandle p1)` This method is deprecated. Deprecated in Java
`void`	`sendStickyOrderedBroadcast( @NonNull Intent p0, @Nullable BroadcastReceiver p1, @Nullable Handler p2, int p3, @Nullable String p4, @Nullable Bundle p5 )` This method is deprecated. Deprecated in Java
`void`	`sendStickyOrderedBroadcastAsUser( @NonNull Intent p0, @NonNull UserHandle p1, @Nullable BroadcastReceiver p2, @Nullable Handler p3, int p4, @Nullable String p5, @Nullable Bundle p6 )` This method is deprecated. Deprecated in Java
`void`	`setWallpaper(@NonNull Bitmap p0)` This method is deprecated. Deprecated in Java
`void`	`setWallpaper(@NonNull InputStream p0)` This method is deprecated. Deprecated in Java
`@Nullable ComponentName`	`startForegroundService(@NonNull Intent p0)`
`boolean`	`startInstrumentation( @NonNull ComponentName p0, @Nullable String p1, @Nullable Bundle p2 )`
`@Nullable ComponentName`	`startService(@NonNull Intent p0)`
`boolean`	`stopService(@NonNull Intent p0)`
`void`	`unbindService(@NonNull ServiceConnection p0)`
`void`	`unregisterDeviceIdChangeListener(@NonNull IntConsumer p0)`
`void`	`unregisterReceiver(@NonNull BroadcastReceiver p0)`
`void`	`updateServiceGroup(@NonNull ServiceConnection p0, int p1, int p2)`

From android.view.Window.Callback

void

onPointerCaptureChanged(boolean p0)

Public constructors

ComponentActivity

Added in 1.0.0

public ComponentActivity()

ComponentActivity

Added in 1.0.0

@ContentView
public ComponentActivity(@LayoutRes int contentLayoutId)

Alternate constructor that can be used to provide a default layout that will be inflated as part of super.onCreate(savedInstanceState).

This should generally be called from your constructor that takes no parameters, as is required for API 27 and lower or when using the default android.app.AppComponentFactory.

Public methods

addContentView

public void addContentView(View view, ViewGroup.LayoutParams params)

addMenuProvider

Added in 1.4.0

public void addMenuProvider(@NonNull MenuProvider provider)

Adds the given MenuProvider to this MenuHost. If using this method, you must manually remove the provider when necessary.

Parameters
`@NonNull MenuProvider provider`	the MenuProvider to be added

See also
`removeMenuProvider`

addMenuProvider

Added in 1.4.0

public void addMenuProvider(
    @NonNull MenuProvider provider,
    @NonNull LifecycleOwner owner
)

Adds the given MenuProvider to this MenuHost. This MenuProvider will be removed once the given LifecycleOwner receives an Lifecycle.Event.ON_DESTROY event.

Parameters
`@NonNull MenuProvider provider`	the MenuProvider to be added
`@NonNull LifecycleOwner owner`	the Lifecycle owner whose state will determine the removal of the provider

addMenuProvider

Added in 1.4.0

public void addMenuProvider(
    @NonNull MenuProvider provider,
    @NonNull LifecycleOwner owner,
    @NonNull Lifecycle.State state
)

Adds the given MenuProvider to this MenuHost once the given LifecycleOwner reaches the given Lifecycle.State. This MenuProvider will be removed once the given LifecycleOwner goes down from the given Lifecycle.State.

Parameters
`@NonNull MenuProvider provider`	the MenuProvider to be added
`@NonNull LifecycleOwner owner`	the Lifecycle owner whose state will be used for automated addition/removal
`@NonNull Lifecycle.State state`	the Lifecycle.State to check for automated addition/removal

addOnConfigurationChangedListener

Added in 1.5.0

public final void addOnConfigurationChangedListener(
    @NonNull Consumer<@NonNull Configuration> listener
)

Add a new listener that will get a callback associated with ComponentCallbacks.onConfigurationChanged with the new Configuration.

Parameters
`@NonNull Consumer<@NonNull Configuration> listener`	The listener that should be called whenever {ComponentCallbacks.onConfigurationChanged was called.

addOnContextAvailableListener

Added in 1.10.0-beta01

public final void addOnContextAvailableListener(
    @NonNull OnContextAvailableListener listener
)

{@inheritDoc}

Any listener added here will receive a callback as part of super.onCreate(), but importantly before any other logic is done (including calling through to the framework Activity.onCreate with the exception of restoring the state of the savedStateRegistry for use in your listener.

addOnMultiWindowModeChangedListener

Added in 1.5.0

public final void addOnMultiWindowModeChangedListener(
    @NonNull Consumer<@NonNull MultiWindowModeChangedInfo> listener
)

Add a new listener that will get a callback associated with Activity.onMultiWindowModeChanged with the new MultiWindowModeChangedInfo.

Parameters
`@NonNull Consumer<@NonNull MultiWindowModeChangedInfo> listener`	The listener that should be called whenever Activity#onMultiWindowModeChanged was called.

addOnNewIntentListener

Added in 1.5.0

public final void addOnNewIntentListener(@NonNull Consumer<@NonNull Intent> listener)

Add a new listener that will get a callback associated with Activity.onNewIntent with the new Intent.

Parameters
`@NonNull Consumer<@NonNull Intent> listener`	The listener that should be called whenever android.app.Activity#onNewIntent was called.

addOnPictureInPictureModeChangedListener

Added in 1.5.0

public final void addOnPictureInPictureModeChangedListener(
    @NonNull Consumer<@NonNull PictureInPictureModeChangedInfo> listener
)

Add a new listener that will get a callback associated with Activity.onPictureInPictureModeChanged with the new PictureInPictureModeChangedInfo.

Parameters
`@NonNull Consumer<@NonNull PictureInPictureModeChangedInfo> listener`	The listener that should be called whenever `Activity.onPictureInPictureModeChanged` was called.

addOnTrimMemoryListener

Added in 1.5.0

public final void addOnTrimMemoryListener(@NonNull Consumer<@NonNull Integer> listener)

Add a new listener that will get a callback associated with ComponentCallbacks2.onTrimMemory with the int representing the level of trimming.

Parameters
`@NonNull Consumer<@NonNull Integer> listener`	The listener that should be called whenever ComponentCallbacks2.onTrimMemory was called.

addOnUserLeaveHintListener

Added in 1.9.0

public final void addOnUserLeaveHintListener(@NonNull Runnable listener)

Add a new listener that will get a callback associated with Activity.onUserLeaveHint

Parameters
`@NonNull Runnable listener`	The listener that should be called whenever `Activity.onUserLeaveHint` was called.

getActivityResultRegistry

Added in 1.10.0-beta01

public final @NonNull ActivityResultRegistry getActivityResultRegistry()

Get the ActivityResultRegistry associated with this activity.

Returns
`@NonNull ActivityResultRegistry`	the `ActivityResultRegistry`

getDefaultViewModelCreationExtras

@CallSuper
public @NonNull CreationExtras getDefaultViewModelCreationExtras()

{@inheritDoc}

The extras of getIntent when this is first called will be used as the defaults to any androidx.lifecycle.SavedStateHandle passed to a view model created using this extra.

getDefaultViewModelProviderFactory

Added in 1.1.0

public @NonNull ViewModelProvider.Factory getDefaultViewModelProviderFactory()

getFullyDrawnReporter

Added in 1.10.0-beta01

public @NonNull FullyDrawnReporter getFullyDrawnReporter()

Retrieve the FullyDrawnReporter that should handle the independent parts of the UI that separately report that they are fully drawn.

getLastCustomNonConfigurationInstance

Added in 1.0.0

Deprecated in 1.0.0

public Object getLastCustomNonConfigurationInstance()

Return the value previously returned from onRetainCustomNonConfigurationInstance.

getLifecycle

Added in 1.0.0

public @NonNull Lifecycle getLifecycle()

{@inheritDoc}

Overriding this method is no longer supported and this method will be made final in a future version of ComponentActivity. If you do override this method, you must:

Return an instance of LifecycleRegistry
Lazily initialize your LifecycleRegistry object when this is first called.

Note that this method will be called in the super classes' constructor, before any field initialization or object state creation is complete.

getOnBackPressedDispatcher

Added in 1.10.0-beta01

public final @NonNull OnBackPressedDispatcher getOnBackPressedDispatcher()

Retrieve the OnBackPressedDispatcher that will be triggered when onBackPressed is called.

Returns
`@NonNull OnBackPressedDispatcher`	The `OnBackPressedDispatcher` associated with this ComponentActivity.

getSavedStateRegistry

Added in 1.0.0

public final @NonNull SavedStateRegistry getSavedStateRegistry()

getViewModelStore

Added in 1.0.0

public @NonNull ViewModelStore getViewModelStore()

Returns the ViewModelStore associated with this activity

Overriding this method is no longer supported and this method will be made final in a future version of ComponentActivity.

Returns
`@NonNull ViewModelStore`	a `ViewModelStore`

Throws
`kotlin.IllegalStateException`	if called before the Activity is attached to the Application instance i.e., before onCreate()

initializeViewTreeOwners

Added in 1.8.0

@CallSuper
public void initializeViewTreeOwners()

Sets the view tree owners before setting the content view so that the inflation process and attach listeners will see them already present.

invalidateMenu

Added in 1.4.0

public void invalidateMenu()

Invalidates the android.view.Menu to ensure that what is displayed matches the current internal state of the menu. This should be called whenever the state of the menu is changed, such as items being removed or disabled based on some user event.

onBackPressed

Added in 1.6.0

@MainThread
@CallSuper
public void onBackPressed()

Called when the activity has detected the user's press of the back key. The onBackPressedDispatcher will be given a chance to handle the back button before the default behavior of android.app.Activity.onBackPressed is invoked.

See also
`onBackPressedDispatcher`

onConfigurationChanged

@CallSuper
public void onConfigurationChanged(@NonNull Configuration newConfig)

{@inheritDoc}

Dispatches this call to all listeners added via addOnConfigurationChangedListener.

public boolean onCreatePanelMenu(int featureId, @NonNull Menu menu)

onMenuItemSelected

public boolean onMenuItemSelected(int featureId, @NonNull MenuItem item)

onMultiWindowModeChanged

Added in 1.5.0

@CallSuper
public void onMultiWindowModeChanged(boolean isInMultiWindowMode)

{@inheritDoc}

Dispatches this call to all listeners added via addOnMultiWindowModeChangedListener.

onMultiWindowModeChanged

@RequiresApi(api = 26)
@CallSuper
public void onMultiWindowModeChanged(
    boolean isInMultiWindowMode,
    @NonNull Configuration newConfig
)

{@inheritDoc}

Dispatches this call to all listeners added via addOnMultiWindowModeChangedListener.

public void onPanelClosed(int featureId, @NonNull Menu menu)

onPictureInPictureModeChanged

Added in 1.5.0

@CallSuper
public void onPictureInPictureModeChanged(boolean isInPictureInPictureMode)

{@inheritDoc}

Dispatches this call to all listeners added via addOnPictureInPictureModeChangedListener.

onPictureInPictureModeChanged

@RequiresApi(api = 26)
@CallSuper
public void onPictureInPictureModeChanged(
    boolean isInPictureInPictureMode,
    @NonNull Configuration newConfig
)

{@inheritDoc}

Dispatches this call to all listeners added via addOnPictureInPictureModeChangedListener.

public boolean onPreparePanel(int featureId, View view, @NonNull Menu menu)

onRequestPermissionsResult

Added in 1.2.0

Deprecated in 1.2.0

@CallSuper
public void onRequestPermissionsResult(
    int requestCode,
    @NonNull String[] permissions,
    @NonNull int[] grantResults
)

{@inheritDoc}

onRetainCustomNonConfigurationInstance

Added in 1.0.0

Deprecated in 1.0.0

public Object onRetainCustomNonConfigurationInstance()

Use this instead of onRetainNonConfigurationInstance. Retrieve later with lastCustomNonConfigurationInstance.

onRetainNonConfigurationInstance

Added in 1.0.0

public final Object onRetainNonConfigurationInstance()

Retain all appropriate non-config state. You can NOT override this yourself! Use a androidx.lifecycle.ViewModel if you want to retain your own non config state.

onTrimMemory

@CallSuper
public void onTrimMemory(int level)

{@inheritDoc}

Dispatches this call to all listeners added via addOnTrimMemoryListener.

peekAvailableContext

Added in 1.10.0-beta01

public Context peekAvailableContext()

Get the Context if it is currently available. If this returns null, you can use addOnContextAvailableListener to receive a callback for when it available.

Returns
`Context`	the Context if it is currently available.

registerForActivityResult

Added in 1.10.0-beta01

public final @NonNull ActivityResultLauncher<@NonNull I> <I extends Object, O extends Object> registerForActivityResult(
    @NonNull ActivityResultContract<@NonNull I, @NonNull O> contract,
    @NonNull ActivityResultCallback<@NonNull O> callback
)

This creates a record in the registry associated with this caller, managing request code, as well as conversions to/from Intent under the hood.

This must be called unconditionally, as part of initialization path, typically as a field initializer of an Activity or Fragment.

Parameters
`<I extends Object>`	the type of the input(if any) required to call the activity
`<O extends Object>`	the type of output returned as an activity result
`@NonNull ActivityResultContract<@NonNull I, @NonNull O> contract`	the contract, specifying conversions to/from `Intent`s
`@NonNull ActivityResultCallback<@NonNull O> callback`	the callback to be called on the main thread when activity result is available

Returns
`@NonNull ActivityResultLauncher<@NonNull I>`	the launcher that can be used to start the activity or dispose of the prepared call.

registerForActivityResult

Added in 1.10.0-beta01

public final @NonNull ActivityResultLauncher<@NonNull I> <I extends Object, O extends Object> registerForActivityResult(
    @NonNull ActivityResultContract<@NonNull I, @NonNull O> contract,
    @NonNull ActivityResultRegistry registry,
    @NonNull ActivityResultCallback<@NonNull O> callback
)

This creates a record in the given registry, managing request code, as well as conversions to/from Intent under the hood.

This must be called unconditionally, as part of initialization path, typically as a field initializer of an Activity or Fragment.

Parameters
`<I extends Object>`	the type of the input(if any) required to call the activity
`<O extends Object>`	the type of output returned as an activity result
`@NonNull ActivityResultContract<@NonNull I, @NonNull O> contract`	the contract, specifying conversions to/from `Intent`s
`@NonNull ActivityResultRegistry registry`	the registry where to hold the record.
`@NonNull ActivityResultCallback<@NonNull O> callback`	the callback to be called on the main thread when activity result is available

Returns
`@NonNull ActivityResultLauncher<@NonNull I>`	the launcher that can be used to start the activity or dispose of the prepared call.

removeMenuProvider

Added in 1.4.0

public void removeMenuProvider(@NonNull MenuProvider provider)

Removes the given MenuProvider from this MenuHost.

Parameters
`@NonNull MenuProvider provider`	the MenuProvider to be removed

removeOnConfigurationChangedListener

Added in 1.5.0

public final void removeOnConfigurationChangedListener(
    @NonNull Consumer<@NonNull Configuration> listener
)

Remove a previously added listener. It will not receive any future callbacks.

Parameters
`@NonNull Consumer<@NonNull Configuration> listener`	The listener previously added with `addOnConfigurationChangedListener` that should be removed.

removeOnContextAvailableListener

Added in 1.10.0-beta01

public final void removeOnContextAvailableListener(
    @NonNull OnContextAvailableListener listener
)

Remove a OnContextAvailableListener previously added via addOnContextAvailableListener.

Parameters
`@NonNull OnContextAvailableListener listener`	The listener that should be removed.

See also
`addOnContextAvailableListener`

removeOnMultiWindowModeChangedListener

Added in 1.5.0

public final void removeOnMultiWindowModeChangedListener(
    @NonNull Consumer<@NonNull MultiWindowModeChangedInfo> listener
)

Remove a previously added listener. It will not receive any future callbacks.

Parameters
`@NonNull Consumer<@NonNull MultiWindowModeChangedInfo> listener`	The listener previously added with `addOnMultiWindowModeChangedListener` that should be removed.

removeOnNewIntentListener

Added in 1.5.0

public final void removeOnNewIntentListener(@NonNull Consumer<@NonNull Intent> listener)

Remove a previously added listener. It will not receive any future callbacks.

Parameters
`@NonNull Consumer<@NonNull Intent> listener`	The listener previously added with `addOnNewIntentListener` that should be removed.

removeOnPictureInPictureModeChangedListener

Added in 1.5.0

public final void removeOnPictureInPictureModeChangedListener(
    @NonNull Consumer<@NonNull PictureInPictureModeChangedInfo> listener
)

Remove a previously added listener. It will not receive any future callbacks.

Parameters
`@NonNull Consumer<@NonNull PictureInPictureModeChangedInfo> listener`	The listener previously added with `addOnPictureInPictureModeChangedListener` that should be removed.

removeOnTrimMemoryListener

Added in 1.5.0

public final void removeOnTrimMemoryListener(@NonNull Consumer<@NonNull Integer> listener)

Remove a previously added listener. It will not receive any future callbacks.

Parameters
`@NonNull Consumer<@NonNull Integer> listener`	The listener previously added with .addOnTrimMemoryListener that should be removed.

removeOnUserLeaveHintListener

Added in 1.9.0

public final void removeOnUserLeaveHintListener(@NonNull Runnable listener)

Remove a previously added listener. It will not receive any future callbacks.

Parameters
`@NonNull Runnable listener`	The listener previously added with `addOnUserLeaveHintListener` that should be removed.

reportFullyDrawn

public void reportFullyDrawn()

setContentView

public void setContentView(@LayoutRes int layoutResID)

setContentView

public void setContentView(View view)

setContentView

public void setContentView(View view, ViewGroup.LayoutParams params)

startActivityForResult

Added in 1.2.0

Deprecated in 1.2.0

public void startActivityForResult(@NonNull Intent intent, int requestCode)

{@inheritDoc}

startActivityForResult

Added in 1.2.0

Deprecated in 1.2.0

public void startActivityForResult(
    @NonNull Intent intent,
    int requestCode,
    Bundle options
)

{@inheritDoc}

startIntentSenderForResult

Added in 1.2.0

Deprecated in 1.2.0

public void startIntentSenderForResult(
    @NonNull IntentSender intent,
    int requestCode,
    Intent fillInIntent,
    int flagsMask,
    int flagsValues,
    int extraFlags
)

{@inheritDoc}

startIntentSenderForResult

Added in 1.2.0

Deprecated in 1.2.0

public void startIntentSenderForResult(
    @NonNull IntentSender intent,
    int requestCode,
    Intent fillInIntent,
    int flagsMask,
    int flagsValues,
    int extraFlags,
    Bundle options
)

{@inheritDoc}

Protected methods

onActivityResult

Added in 1.2.0

Deprecated in 1.2.0

@CallSuper
protected void onActivityResult(int requestCode, int resultCode, Intent data)

{@inheritDoc}

onCreate

protected void onCreate(Bundle savedInstanceState)

{@inheritDoc}

If your ComponentActivity is annotated with ContentView, this will call setContentView for you.

onNewIntent

@CallSuper
protected void onNewIntent(@NonNull Intent intent)

{@inheritDoc}

Dispatches this call to all listeners added via addOnNewIntentListener.

onSaveInstanceState

@CallSuper
protected void onSaveInstanceState(@NonNull Bundle outState)

onUserLeaveHint

@CallSuper
protected void onUserLeaveHint()

{@inheritDoc}

Dispatches this call to all listeners added via addOnUserLeaveHintListener.

Extension functions

ActivityViewModelLazyKt.viewModels

Artifact: androidx.activity:activity

View Source

@MainThread
public final @NonNull Lazy<@NonNull VM> <VM extends ViewModel> ActivityViewModelLazyKt.viewModels(
    @NonNull ComponentActivity receiver,
    Function0<@NonNull CreationExtras> extrasProducer,
    Function0<@NonNull ViewModelProvider.Factory> factoryProducer
)

Returns a Lazy delegate to access the ComponentActivity's ViewModel, if factoryProducer is specified then ViewModelProvider.Factory returned by it will be used to create ViewModel first time.

class MyComponentActivity : ComponentActivity() {
    val viewmodel: MyViewModel by viewModels()
}

This property can be accessed only after the Activity is attached to the Application, and access prior to that will result in IllegalArgumentException.

EdgeToEdge.enableEdgeToEdge

Artifact: androidx.activity:activity

View Source

public final void EdgeToEdge.enableEdgeToEdge(
    @NonNull ComponentActivity receiver,
    @NonNull SystemBarStyle statusBarStyle,
    @NonNull SystemBarStyle navigationBarStyle
)

Enables the edge-to-edge display for this ComponentActivity.

To set it up with the default style, call this method in your Activity's onCreate method:

    override fun onCreate(savedInstanceState: Bundle?) {
        enableEdgeToEdge()
        super.onCreate(savedInstanceState)
        ...
    }

The default style configures the system bars with a transparent background when contrast can be enforced by the system (API 29 or above). On older platforms (which only have 3-button/2-button navigation modes), an equivalent scrim is applied to ensure contrast with the system bars.

See SystemBarStyle for more customization options.

Parameters
`@NonNull SystemBarStyle statusBarStyle`	The `SystemBarStyle` for the status bar.
`@NonNull SystemBarStyle navigationBarStyle`	The `SystemBarStyle` for the navigation bar.