FragmentActivity

Kotlin |Java

open class FragmentActivity : ComponentActivity, ActivityCompat.OnRequestPermissionsResultCallback, RequestPermissionsRequestCodeValidator

androidx.activity.ComponentActivity
↳	androidx.fragment.app.FragmentActivity

Known Direct Subclasses

AppCompatActivity, WatchFaceConfigActivity

AppCompatActivity	Base class for activities that wish to use some of the newer platform features on older Android devices.
WatchFaceConfigActivity	Config activity for the watch face, which supports complication and provider selection, as well as userStyle configuration.

Base class for activities that want to use the support-based Fragments.

Known limitations:

When using the <fragment> tag, this implementation can not use the parent view's ID as the new fragment's ID. You must explicitly specify an ID (or tag) in the <fragment>.

Summary

Public constructors
`<init>()` Default constructor for FragmentActivity.
`<init>(@LayoutRes contentLayoutId: Int)` Alternate constructor that can be used to provide a default layout that will be inflated as part of `super.onCreate(savedInstanceState)`.

Public methods
open Unit	`dump(@NonNull prefix: String, @Nullable fd: FileDescriptor?, @NonNull writer: PrintWriter, @Nullable args: Array<String!>?)` Print the Activity's state into the given stream.
open FragmentManager	`getSupportFragmentManager()` Return the FragmentManager for interacting with fragments associated with this activity.
open LoaderManager	`getSupportLoaderManager()`
open Unit	`onAttachFragment(@NonNull fragment: Fragment)` Called when a fragment is attached to the activity.
open Unit	`onConfigurationChanged(@NonNull newConfig: Configuration)` Dispatch configuration change to all fragments.
open Boolean	`onCreatePanelMenu(featureId: Int, @NonNull menu: Menu)` Dispatch to Fragment.
open View?	`onCreateView(@Nullable parent: View?, @NonNull name: String, @NonNull context: Context, @NonNull attrs: AttributeSet)`
open View?	`onCreateView(@NonNull name: String, @NonNull context: Context, @NonNull attrs: AttributeSet)`
open Unit	`onLowMemory()` Dispatch onLowMemory() to all fragments.
open Boolean	`onMenuItemSelected(featureId: Int, @NonNull item: MenuItem)` Dispatch context and options menu to fragments.
open Unit	`onMultiWindowModeChanged(isInMultiWindowMode: Boolean)` Note: If you override this method you must call `super.onMultiWindowModeChanged` to correctly dispatch the event to support fragments attached to this activity.
open Unit	`onPanelClosed(featureId: Int, @NonNull menu: Menu)` Call onOptionsMenuClosed() on fragments.
open Unit	`onPictureInPictureModeChanged(isInPictureInPictureMode: Boolean)` Note: If you override this method you must call `super.onPictureInPictureModeChanged` to correctly dispatch the event to support fragments attached to this activity.
open Boolean	`onPreparePanel(featureId: Int, @Nullable view: View?, @NonNull menu: Menu)` Dispatch onPrepareOptionsMenu() to fragments.
open Unit	`onRequestPermissionsResult(requestCode: Int, @NonNull permissions: Array<String!>, @NonNull grantResults: IntArray)`
open Unit	`onStateNotSaved()` Hook in to note that fragment state is no longer saved.
open Unit	`setEnterSharedElementCallback(@Nullable callback: SharedElementCallback?)` When `android.app.ActivityOptions#makeSceneTransitionAnimation(Activity, * android.view.View, String)` was used to start an Activity, callback will be called to handle shared elements on the launched Activity.
open Unit	`setExitSharedElementCallback(@Nullable listener: SharedElementCallback?)` When `android.app.ActivityOptions#makeSceneTransitionAnimation(Activity, * android.view.View, String)` was used to start an Activity, listener will be called to handle shared elements on the launching Activity.
open Unit	`startActivityFromFragment(@NonNull fragment: Fragment, intent: Intent!, requestCode: Int)` Called by Fragment.
open Unit	`startActivityFromFragment(@NonNull fragment: Fragment, intent: Intent!, requestCode: Int, @Nullable options: Bundle?)` Called by Fragment.
open Unit	`startIntentSenderFromFragment(@NonNull fragment: Fragment, intent: IntentSender!, requestCode: Int, @Nullable fillInIntent: Intent?, flagsMask: Int, flagsValues: Int, extraFlags: Int, @Nullable options: Bundle?)` Called by Fragment.
open Unit	`supportFinishAfterTransition()` Reverses the Activity Scene entry Transition and triggers the calling Activity to reverse its exit Transition.
open Unit	`supportInvalidateOptionsMenu()` Support library version of `Activity#invalidateOptionsMenu`.
open Unit	`supportPostponeEnterTransition()` Support library version of `android.app.Activity#postponeEnterTransition()` that works only on API 21 and later.
open Unit	`supportStartPostponedEnterTransition()` Support library version of `android.app.Activity#startPostponedEnterTransition()` that only works with API 21 and later.
Unit	`validateRequestPermissionsRequestCode(requestCode: Int)`

Protected methods
open Unit	`onActivityResult(requestCode: Int, resultCode: Int, @Nullable data: Intent?)`
open Unit	`onCreate(@Nullable savedInstanceState: Bundle?)` Perform initialization of all fragments.
open Unit	`onDestroy()` Destroy all fragments.
open Unit	`onNewIntent(intent: Intent!)` Handle onNewIntent() to inform the fragment manager that the state is not saved.
open Unit	`onPause()` Dispatch onPause() to fragments.
open Unit	`onPostResume()` Dispatch onResume() to fragments.
open Unit	`onResume()` Dispatch onResume() to fragments.
open Unit	`onResumeFragments()` This is the fragment-orientated version of `onResume()` that you can override to perform operations in the Activity at the same point where its fragments are resumed.
open Unit	`onStart()` Dispatch onStart() to all fragments.
open Unit	`onStop()` Dispatch onStop() to all fragments.

Inherited functions

From class ComponentActivity

`Unit`	`addContentView(view: View!, params: LayoutParams!)`
`Unit`	`addOnContextAvailableListener(@NonNull listener: OnContextAvailableListener)` Add a new `OnContextAvailableListener` for receiving a callback for when this class is associated with a `android.content.Context`. Listeners are triggered in the order they are added when added before the Context is available. Listeners added after the context has been made available will have the Context synchronously delivered to them as part of this call. 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(Bundle)` with the exception of restoring the state of the `SavedStateRegistry` for use in your listener.
`ActivityResultRegistry`	`getActivityResultRegistry()` Get the `ActivityResultRegistry` associated with this activity.
`ViewModelProvider.Factory`	`getDefaultViewModelProviderFactory()` Returns the default `ViewModelProvider.Factory` that should be used when no custom `Factory` is provided to the `ViewModelProvider` constructors. 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 factory.
`Any?`	`getLastCustomNonConfigurationInstance()` Return the value previously returned from `onRetainCustomNonConfigurationInstance()`.
`Lifecycle`	`getLifecycle()` Returns the Lifecycle of the provider. 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.
`OnBackPressedDispatcher`	`getOnBackPressedDispatcher()` Retrieve the `OnBackPressedDispatcher` that will be triggered when `onBackPressed()` is called.
`SavedStateRegistry`	`getSavedStateRegistry()`
`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.
`Unit`	`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.
`Any?`	`onRetainCustomNonConfigurationInstance()` Use this instead of `onRetainNonConfigurationInstance()`. Retrieve later with `getLastCustomNonConfigurationInstance()`.
`Any?`	`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.
`Unit`	`onSaveInstanceState(@NonNull outState: Bundle)`
`Context?`	`peekAvailableContext()`
`ActivityResultLauncher<I>`	`registerForActivityResult(@NonNull contract: ActivityResultContract<I, O>, @NonNull registry: ActivityResultRegistry, @NonNull callback: ActivityResultCallback<O>)`
`ActivityResultLauncher<I>`	`registerForActivityResult(@NonNull contract: ActivityResultContract<I, O>, @NonNull callback: ActivityResultCallback<O>)`
`Unit`	`removeOnContextAvailableListener(@NonNull listener: OnContextAvailableListener)`
`Unit`	`setContentView(@LayoutRes layoutResID: Int)`
`Unit`	`setContentView(view: View!)`
`Unit`	`setContentView(view: View!, params: LayoutParams!)`
`Unit`	`startActivityForResult(intent: Intent!, requestCode: Int)`
`Unit`	`startActivityForResult(intent: Intent!, requestCode: Int, @Nullable options: Bundle?)`
`Unit`	`startIntentSenderForResult(intent: IntentSender!, requestCode: Int, @Nullable fillInIntent: Intent?, flagsMask: Int, flagsValues: Int, extraFlags: Int)`
`Unit`	`startIntentSenderForResult(intent: IntentSender!, requestCode: Int, @Nullable fillInIntent: Intent?, flagsMask: Int, flagsValues: Int, extraFlags: Int, @Nullable options: Bundle?)`

Public constructors

<init>

FragmentActivity()

Default constructor for FragmentActivity. All Activities must have a default constructor for API 27 and lower devices or when using the default android.app.AppComponentFactory.

<init>

FragmentActivity(@LayoutRes contentLayoutId: Int)

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.

See Also

#FragmentActivity()

Public methods

dump

open fun dump(
    @NonNull prefix: String, 
    @Nullable fd: FileDescriptor?, 
    @NonNull writer: PrintWriter, 
    @Nullable args: Array<String!>?
): Unit

Print the Activity's state into the given stream. This gets invoked if you run "adb shell dumpsys activity ".

Parameters
`prefix`	String: Desired prefix to prepend at each line of output.
`fd`	FileDescriptor?: The raw file descriptor that the dump is being sent to.
`writer`	PrintWriter: The PrintWriter to which you should dump your state. This will be closed for you after you return.
`args`	Array<String!>?: additional arguments to the dump request.

getSupportFragmentManager

@NonNull open fun getSupportFragmentManager(): FragmentManager

Return the FragmentManager for interacting with fragments associated with this activity.

getSupportLoaderManager

@NonNull open fun getSupportLoaderManager(): LoaderManager

Deprecated: Use LoaderManager.getInstance(this).

onAttachFragment

@MainThread open fun onAttachFragment(@NonNull fragment: Fragment): Unit

Deprecated: The responsibility for listening for fragments being attached has been moved to FragmentManager. You can add a listener to this Activity's FragmentManager by calling FragmentManager#addFragmentOnAttachListener(FragmentOnAttachListener) in your constructor to get callbacks when a fragment is attached directly to the activity's FragmentManager.

Called when a fragment is attached to the activity.

This is called after the attached fragment's onAttach and before the attached fragment's onCreate if the fragment has not yet had a previous call to onCreate.

onConfigurationChanged

open fun onConfigurationChanged(@NonNull newConfig: Configuration): Unit

Dispatch configuration change to all fragments.

onCreatePanelMenu

open fun onCreatePanelMenu(
    featureId: Int, 
    @NonNull