Skip to content

Most visited

Recently visited

navigation
Added in API level 1
Deprecated since API level 13

LocalActivityManager

public class LocalActivityManager
extends Object

java.lang.Object
   ↳ android.app.LocalActivityManager


This class was deprecated in API level 13.
Use the new Fragment and FragmentManager APIs instead; these are also available on older platforms through the Android compatibility package.

Helper class for managing multiple running embedded activities in the same process. This class is not normally used directly, but rather created for you as part of the ActivityGroup implementation.

See also:

Summary

Public constructors

LocalActivityManager(Activity parent, boolean singleMode)

Create a new LocalActivityManager for holding activities running within the given parent.

Public methods

Window destroyActivity(String id, boolean finish)

Destroy the activity associated with a particular id.

void dispatchCreate(Bundle state)

Restore a state that was previously returned by saveInstanceState().

void dispatchDestroy(boolean finishing)

Called by the container activity in its onDestroy() so that LocalActivityManager can perform the corresponding action on the activities it holds.

void dispatchPause(boolean finishing)

Called by the container activity in its onPause() so that LocalActivityManager can perform the corresponding action on the activities it holds.

void dispatchResume()

Called by the container activity in its onResume() so that LocalActivityManager can perform the corresponding action on the activities it holds.

void dispatchStop()

Called by the container activity in its onStop() so that LocalActivityManager can perform the corresponding action on the activities it holds.

Activity getActivity(String id)

Return the Activity object associated with a string ID.

Activity getCurrentActivity()

Retrieve the Activity that is currently running.

String getCurrentId()

Retrieve the ID of the activity that is currently running.

void removeAllActivities()

Remove all activities from this LocalActivityManager, performing an onDestroy() on any that are currently instantiated.

Bundle saveInstanceState()

Retrieve the state of all activities known by the group.

Window startActivity(String id, Intent intent)

Start a new activity running in the group.

Inherited methods

From class java.lang.Object

Public constructors

LocalActivityManager

Added in API level 1
LocalActivityManager (Activity parent, 
                boolean singleMode)

Create a new LocalActivityManager for holding activities running within the given parent.

Parameters
parent Activity: the host of the embedded activities
singleMode boolean: True if the LocalActivityManger should keep a maximum of one activity resumed

Public methods

destroyActivity

Added in API level 1
Window destroyActivity (String id, 
                boolean finish)

Destroy the activity associated with a particular id. This activity will go through the normal lifecycle events and fine onDestroy(), and then the id removed from the group.

Parameters
id String: Unique identifier of the activity to be destroyed
finish boolean: If true, this activity will be finished, so its id and all state are removed from the group.
Returns
Window Returns the window that was used to display the activity, or null if there was none.

dispatchCreate

Added in API level 1
void dispatchCreate (Bundle state)

Restore a state that was previously returned by saveInstanceState(). This adds to the activity group information about all activity IDs that had previously been saved, even if they have not been started yet, so if the user later navigates to them the correct state will be restored.

Note: This does not change the current running activity, or start whatever activity was previously running when the state was saved. That is up to the client to do, in whatever way it thinks is best.

Parameters
state Bundle: a previously saved state; does nothing if this is null

See also:

dispatchDestroy

Added in API level 1
void dispatchDestroy (boolean finishing)

Called by the container activity in its onDestroy() so that LocalActivityManager can perform the corresponding action on the activities it holds.

Parameters
finishing boolean

See also:

dispatchPause

Added in API level 1
void dispatchPause (boolean finishing)

Called by the container activity in its onPause() so that LocalActivityManager can perform the corresponding action on the activities it holds.

Parameters
finishing boolean: set to true if the parent activity has been finished; this can be determined by calling Activity.isFinishing()

See also:

dispatchResume

Added in API level 1
void dispatchResume ()

Called by the container activity in its onResume() so that LocalActivityManager can perform the corresponding action on the activities it holds.

See also:

dispatchStop

Added in API level 1
void dispatchStop ()

Called by the container activity in its onStop() so that LocalActivityManager can perform the corresponding action on the activities it holds.

See also:

getActivity

Added in API level 1
Activity getActivity (String id)

Return the Activity object associated with a string ID.

Parameters
id String
Returns
Activity the associated Activity object, or null if the id is unknown or its activity is not currently instantiated

See also:

getCurrentActivity

Added in API level 1
Activity getCurrentActivity ()

Retrieve the Activity that is currently running.

Returns
Activity the currently running (resumed) Activity, or null if there is not one

See also:

getCurrentId

Added in API level 1
String getCurrentId ()

Retrieve the ID of the activity that is currently running.

Returns
String the ID of the currently running (resumed) Activity, or null if there is not one

See also:

removeAllActivities

Added in API level 1
void removeAllActivities ()

Remove all activities from this LocalActivityManager, performing an onDestroy() on any that are currently instantiated.

saveInstanceState

Added in API level 1
Bundle saveInstanceState ()

Retrieve the state of all activities known by the group. For activities that have previously run and are now stopped or finished, the last saved state is used. For the current running activity, its onSaveInstanceState(Bundle) is called to retrieve its current state.

Returns
Bundle a Bundle holding the newly created state of all known activities

See also:

startActivity

Added in API level 1
Window startActivity (String id, 
                Intent intent)

Start a new activity running in the group. Every activity you start must have a unique string ID associated with it -- this is used to keep track of the activity, so that if you later call startActivity() again on it the same activity object will be retained.

When there had previously been an activity started under this id, it may either be destroyed and a new one started, or the current one re-used, based on these conditions, in order:

  • If the Intent maps to a different activity component than is currently running, the current activity is finished and a new one started.
  • If the current activity uses a non-multiple launch mode (such as singleTop), or the Intent has the FLAG_ACTIVITY_SINGLE_TOP flag set, then the current activity will remain running and its Activity.onNewIntent() method called.
  • If the new Intent is the same (excluding extras) as the previous one, and the new Intent does not have the FLAG_ACTIVITY_CLEAR_TOP set, then the current activity will remain running as-is.
  • Otherwise, the current activity will be finished and a new one started.

If the given Intent can not be resolved to an available Activity, this method throws ActivityNotFoundException.

Warning: There is an issue where, if the Intent does not include an explicit component, we can restore the state for a different activity class than was previously running when the state was saved (if the set of available activities changes between those points).

Parameters
id String: Unique identifier of the activity to be started
intent Intent: The Intent describing the activity to be started
Returns
Window Returns the window of the activity. The caller needs to take care of adding this window to a view hierarchy, and likewise dealing with removing the old window if the activity has changed.
Throws
ActivityNotFoundException
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a one-minute survey?
Help us improve Android tools and documentation.